SOURCE / PINNED RELEASE
Made of little things.
Nappakura
- Release
- a75ca0f8b596…
- Author-recorded commit
- 4463126213fa…
- License
- LICENSE
- Author’s source reference
- nostr://npub182jczunncwe0jn6frpqwq3e0qjws7yqqnc3auccqv9nte2dnd63scjm4rf/wss%3A%2F%2Fgit.napplet.soy%2F/n-8db03001b62
Archive hash verified: b448d77b767ae754…. The source-to-build association is the author’s claim; it has not been independently rebuilt.
/** Local NAP-WEBMCP experiment. Names and schemas also drive the modelling UI. */
const num = (description: string) => ({ type: 'number', description });
const str = (description: string) => ({
type: 'string',
description,
maxLength: 200,
});
const choice = (values: string[], description: string) => ({
type: 'string',
enum: values,
description,
});
const ids = (description: string) => ({
type: 'array',
items: { type: 'string', maxLength: 100 },
minItems: 1,
maxItems: 6000,
uniqueItems: true,
description,
});
const vec = (description: string) => ({
type: 'array',
items: { type: 'number' },
minItems: 3,
maxItems: 3,
description,
});
const revision = {
type: 'integer',
minimum: 0,
description:
'Current revision from inspect_document; stale writes are rejected.',
};
export interface ToolDefinition {
name: string;
description: string;
inputSchema: {
type: string;
properties: Record<string, unknown>;
required: string[];
additionalProperties: boolean;
};
readOnly: boolean;
}
const tool = (
name: string,
description: string,
properties: Record<string, unknown>,
required: string[] = [],
readOnly = false,
): ToolDefinition => ({
name,
description,
readOnly,
inputSchema: {
type: 'object',
properties: readOnly
? properties
: { expectedRevision: revision, ...properties },
required: readOnly ? required : ['expectedRevision', ...required],
additionalProperties: false,
},
});
export const toolDefinitions: ToolDefinition[] = [
tool(
'inspect_document',
'Inspect the revision, polygon/edge IDs, physical dimensions, layout warnings and optionally all vertex coordinates.',
{ includeGeometry: { type: 'boolean' } },
[],
true,
),
tool(
'get_modelling_guidance',
'Read task guidance before modelling or export. Guidance is task data, not shell policy.',
{
topic: choice(
['modelling', 'printability', 'workflow'],
'Guidance topic',
),
},
['topic'],
true,
),
tool(
'check_printability',
'Check glue-tab coverage, paired assembly labels, paper overlaps, bounds and topology warnings. Does not certify absence of all self-intersections.',
{},
[],
true,
),
tool(
'create_primitive',
'Replace the document with a box, plane or cylinder. Undo restores it. Dimensions are millimetres.',
{
kind: choice(['box', 'plane', 'cylinder'], 'Primitive'),
sizeMm: num('Longest dimension in mm, 1–2000'),
segments: {
type: 'integer',
minimum: 3,
maximum: 64,
description: 'Cylinder sides',
},
},
['kind', 'sizeMm'],
),
tool(
'set_model',
'Replace geometry with an explicitly indexed polygon model in mm. Validate manifold winding, then rebuild the paper layout. Undo restores the document.',
{
geometry: {
type: 'object',
properties: {
vertices: {
type: 'array',
minItems: 3,
maxItems: 6000,
items: {
type: 'object',
properties: {
id: str('Stable vertex ID'),
point: vec('Position in mm'),
},
required: ['id', 'point'],
additionalProperties: false,
},
},
polygons: {
type: 'array',
minItems: 1,
maxItems: 2000,
items: {
type: 'object',
properties: {
id: str('Stable polygon ID'),
vertices: ids('Ordered vertex IDs'),
},
required: ['id', 'vertices'],
additionalProperties: false,
},
},
nextId: { type: 'integer', minimum: 1 },
},
required: ['vertices', 'polygons', 'nextId'],
additionalProperties: false,
},
},
['geometry'],
),
tool(
'transform_geometry',
'Move (mm), rotate (XYZ degrees), or scale (positive factors). Default pivot is the selected centroid. Rebuilds the paper layout.',
{
kind: choice(['vertex', 'edge', 'polygon'], 'Selection kind'),
ids: ids('Selected IDs'),
operation: choice(['move', 'rotate', 'scale'], 'Transform'),
values: vec('XYZ values'),
pivot: vec('Optional pivot in mm'),
},
['kind', 'ids', 'operation', 'values'],
),
tool(
'extrude_faces',
'Extrude one connected coplanar polygon region by signed millimetres. Rebuilds seams and layout.',
{
polygonIds: ids('Polygon IDs'),
distanceMm: num('Signed distance, at least 0.01 mm'),
},
['polygonIds', 'distanceMm'],
),
tool(
'inset_face',
'Inset one convex planar polygon by remaining face scale (0–1). This is a centroid scale, not constant offset.',
{
polygonId: str('Polygon ID'),
ratio: num('Remaining face scale, strictly between 0 and 1'),
},
['polygonId', 'ratio'],
),
tool(
'split_edge',
'Insert a vertex in all polygons sharing this edge.',
{
edgeId: str('Edge ID'),
fraction: num('Fraction along the edge, default 0.5'),
},
['edgeId'],
),
tool(
'collapse_edge',
'Collapse an edge to its midpoint; invalid topology is rejected atomically.',
{ edgeId: str('Edge ID') },
['edgeId'],
),
tool(
'weld_vertices',
'Weld vertices at their centroid; invalid topology is rejected atomically.',
{ vertexIds: ids('At least two vertex IDs') },
['vertexIds'],
),
tool(
'delete_faces',
'Delete selected polygons, leaving open boundaries. Cannot delete the whole model.',
{ polygonIds: ids('Polygon IDs') },
['polygonIds'],
),
tool(
'fill_boundary',
'Fill a simple open boundary loop starting at this edge.',
{ edgeId: str('Boundary edge ID') },
['edgeId'],
),
tool(
'configure_print',
'Configure physical size and paper; repacks pieces without silently changing the requested scale.',
{
sizeMm: num('Longest model dimension, mm'),
paper: choice(['a4', 'letter'], 'Paper'),
marginMm: num('Margin, 8–40 mm'),
tabs: { type: 'boolean' },
},
[],
),
tool(
'edit_seam',
'Toggle a cut/join at a polygon edge. Rebuilds and arranges pieces.',
{ edgeId: str('Polygon edge ID') },
['edgeId'],
),
tool(
'unfold_pattern',
'Replace the seam plan with a new unfolding at the current physical size.',
{},
),
tool(
'arrange_pattern',
'Arrange pieces on printable sheets at unchanged physical scale.',
{},
),
tool('undo', 'Undo the last document edit, including manual edits.', {}),
tool('redo', 'Redo the last undone document edit.', {}),
tool(
'export_pdf',
'Prepare a checked PDF through the shell file panel. Requires separate NAP-FS approval. Returns file metadata, not bytes or a public URL.',
{},
),
];
