@theprototype/agent 1.48.0 → 1.50.0

package/catalog.json

@@ -0,0 +1,1224 @@
+{
+	"$comment": "GENERATED by core scripts/agent-tool-catalog.cjs (npm run catalog:agent) - never edit by hand.",
+	"format": 2,
+	"generator": {
+		"source": "tpAgent.tools() via core scripts/agent-tool-catalog.cjs, mapped by tools/agent/src/catalog.js",
+		"hostTools": 20,
+		"dropped": []
+	},
+	"instructions": "You are building in the person's own open theprototype.app tab: a live, shared 3D scene. Every change shows for everyone in the session and can be undone.\nThis may be a VOICE conversation: answer in one or two short spoken sentences and say what changed in plain words (\"Added three trees by the fire\"). Never read out uuids, lists of numbers or JSON.\nIf a tool says the tab is closed or not connected, tell the person to open theprototype.app and press Connect Claude, then wait; do not retry in a loop.\nCall status first: it says whether you may edit (a viewer can only look).\nCall list_scene before editing so you use real uuids; batch many objects into one call.\nMotion and interaction are flow nodes (create_flow_nodes); call describe_node_types before wiring edges.\nUse screenshot to check a result when it matters, not after every step.\nWhen asked what you can do here, call what_can_you_do and say its \"say\" line.",
+	"tools": [
+		{
+			"name": "list_scene",
+			"title": "Read the scene",
+			"description": "List every object currently in the scene with its uuid, name, type, parent, transform, material, color and (for a primitive) its shape — geometry {type, sizes such as the thickness of a wall}. Call this before editing so you use real uuids. On a big scene narrow it: brief (uuids + names only), name (a glob), type, near {position, radius}. A big flow graph shows its first page and says how to read the rest: pass {flow: \"scene\" | object uuid, page} to read one page of one graph.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"flow": {
+						"type": "string",
+						"description": "optional: read one flow graph (\"scene\" or an object uuid) page by page instead of the scene summary"
+					},
+					"page": {
+						"type": "number",
+						"description": "with flow: which page (1-based)"
+					},
+					"brief": {
+						"type": "boolean",
+						"description": "optional: only uuid, name, type, parentUuid per object (cheap on a big scene)"
+					},
+					"name": {
+						"type": "string",
+						"description": "optional: only objects whose name matches — a glob (\"Wall*\", \"*door*\"), or plain text = contains; case-insensitive"
+					},
+					"type": {
+						"type": "string",
+						"description": "optional: only objects of this type — Mesh, Group, PointLight… or a primitive shape (Box, Wall, Sphere…)"
+					},
+					"near": {
+						"type": "object",
+						"description": "optional: only objects within radius of a WORLD position",
+						"properties": {
+							"position": {
+								"type": "array",
+								"items": {
+									"type": "number"
+								},
+								"description": "[x, y, z]"
+							},
+							"radius": {
+								"type": "number"
+							}
+						},
+						"required": [
+							"position",
+							"radius"
+						]
+					}
+				}
+			},
+			"annotations": {
+				"title": "Read the scene",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "create_objects",
+			"title": "Add objects",
+			"description": "Create one or more primitives, lights or empty groups in a single call. Ground is the y=0 plane; place objects so they rest ON it (a box of height h sits at y=h/2). Returns the new uuids.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"objects": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"kind": {
+									"type": "string",
+									"enum": [
+										"primitive",
+										"light",
+										"group"
+									]
+								},
+								"primitive": {
+									"type": "string",
+									"enum": [
+										"Box",
+										"Sphere",
+										"Cylinder",
+										"Cone",
+										"Capsule",
+										"Torus",
+										"TorusKnot",
+										"Ring",
+										"Circle",
+										"Plane",
+										"Dodecahedron",
+										"Icosahedron",
+										"Octahedron",
+										"Tetrahedron",
+										"Tube",
+										"Lathe",
+										"Wedge",
+										"Stairs",
+										"Arch",
+										"Corner"
+									],
+									"description": "required when kind=primitive"
+								},
+								"light": {
+									"type": "string",
+									"enum": [
+										"ambient",
+										"directional",
+										"hemisphere",
+										"point",
+										"spot",
+										"rectarea"
+									],
+									"description": "required when kind=light"
+								},
+								"params": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "up to 4 constructor args. Box=[w,h,d], Sphere=[radius], Cylinder=[rTop,rBottom,height], Cone=[radius,height], Plane=[w,h], Torus=[radius,tube]. Omit for sensible defaults."
+								},
+								"name": {
+									"type": "string"
+								},
+								"position": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "[x,y,z]"
+								},
+								"rotation": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "Euler radians [x,y,z]"
+								},
+								"scale": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "[x,y,z]"
+								},
+								"color": {
+									"type": "string",
+									"description": "hex like #ff8800 (a mesh, or a light's colour)"
+								},
+								"intensity": {
+									"type": "number",
+									"description": "lights: brightness (point/spot also fall off with distance)"
+								},
+								"distance": {
+									"type": "number",
+									"description": "point/spot: range in metres (0 = unlimited)"
+								},
+								"decay": {
+									"type": "number",
+									"description": "point/spot: falloff (2 = physical)"
+								},
+								"angle": {
+									"type": "number",
+									"description": "spot: cone half-angle in radians (0.02-1.57)"
+								},
+								"penumbra": {
+									"type": "number",
+									"description": "spot: soft edge 0-1"
+								},
+								"width": {
+									"type": "number",
+									"description": "rectarea: width in metres"
+								},
+								"height": {
+									"type": "number",
+									"description": "rectarea: height in metres"
+								},
+								"groundColor": {
+									"type": "string",
+									"description": "hemisphere: the ground colour, hex"
+								},
+								"castShadow": {
+									"type": "boolean",
+									"description": "directional/spot/point: cast shadows"
+								},
+								"aim": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "directional/spot: a world point [x,y,z] to point at"
+								},
+								"parentUuid": {
+									"type": "string",
+									"description": "uuid of an existing group to nest under — position/rotation/scale are then LOCAL to that group"
+								},
+								"physics": {
+									"type": "string",
+									"enum": [
+										"static",
+										"dynamic"
+									],
+									"description": "default static (it stays put in Play). dynamic = it falls, collides and can be thrown — only when asked for"
+								},
+								"mass": {
+									"type": "number",
+									"description": "kg; implies physics dynamic"
+								}
+							},
+							"required": [
+								"kind"
+							]
+						}
+					}
+				},
+				"required": [
+					"objects"
+				]
+			},
+			"annotations": {
+				"title": "Add objects",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "update_objects",
+			"title": "Change objects",
+			"description": "Modify existing objects by uuid: move/rotate/scale, recolor, change material, rename, show/hide, or reparent. Batch many in one call.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"updates": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"uuid": {
+									"type": "string"
+								},
+								"name": {
+									"type": "string"
+								},
+								"position": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									}
+								},
+								"rotation": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									}
+								},
+								"scale": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									}
+								},
+								"color": {
+									"type": "string",
+									"description": "hex #rrggbb"
+								},
+								"materialType": {
+									"type": "string",
+									"enum": [
+										"MeshBasicMaterial",
+										"MeshStandardMaterial",
+										"MeshPhysicalMaterial",
+										"MeshPhongMaterial",
+										"MeshLambertMaterial",
+										"MeshToonMaterial"
+									],
+									"description": "swap the material class"
+								},
+								"materialParams": {
+									"type": "object",
+									"description": "meshes: numbers (roughness, metalness, opacity, emissiveIntensity, clearcoat, transmission, ior, shininess…, clamped), true/false (wireframe, transparent, flatShading), hex colours (emissive, specular), side (front|back|double), and map = a library image hash (null clears). Each bad key comes back in errors."
+								},
+								"intensity": {
+									"type": "number",
+									"description": "lights: brightness (point/spot also fall off with distance)"
+								},
+								"distance": {
+									"type": "number",
+									"description": "point/spot: range in metres (0 = unlimited)"
+								},
+								"decay": {
+									"type": "number",
+									"description": "point/spot: falloff (2 = physical)"
+								},
+								"angle": {
+									"type": "number",
+									"description": "spot: cone half-angle in radians (0.02-1.57)"
+								},
+								"penumbra": {
+									"type": "number",
+									"description": "spot: soft edge 0-1"
+								},
+								"width": {
+									"type": "number",
+									"description": "rectarea: width in metres"
+								},
+								"height": {
+									"type": "number",
+									"description": "rectarea: height in metres"
+								},
+								"groundColor": {
+									"type": "string",
+									"description": "hemisphere: the ground colour, hex"
+								},
+								"castShadow": {
+									"type": "boolean",
+									"description": "directional/spot/point: cast shadows"
+								},
+								"aim": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "directional/spot: a world point [x,y,z] to point at"
+								},
+								"visible": {
+									"type": "boolean"
+								},
+								"parentUuid": {
+									"type": "string",
+									"description": "group uuid to nest under, or \"root\" to un-nest. The object keeps its world pose; a position given in the same update is LOCAL to the new parent"
+								}
+							},
+							"required": [
+								"uuid"
+							]
+						}
+					}
+				},
+				"required": [
+					"updates"
+				]
+			},
+			"annotations": {
+				"title": "Change objects",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "delete_objects",
+			"title": "Delete objects",
+			"description": "Delete objects by uuid.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"uuids": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
+					}
+				},
+				"required": [
+					"uuids"
+				]
+			},
+			"annotations": {
+				"title": "Delete objects",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "group_objects",
+			"title": "Group objects",
+			"description": "Create a new group and move the given member objects into it. Returns the group uuid.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"name": {
+						"type": "string"
+					},
+					"memberUuids": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
+					}
+				},
+				"required": [
+					"name",
+					"memberUuids"
+				]
+			},
+			"annotations": {
+				"title": "Group objects",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "clear_scene",
+			"title": "Clear the scene",
+			"description": "Delete ALL objects in the scene. Requires confirm:true. Use only when the user clearly asks to start over.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"confirm": {
+						"type": "boolean"
+					}
+				},
+				"required": [
+					"confirm"
+				]
+			},
+			"annotations": {
+				"title": "Clear the scene",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "create_flow_nodes",
+			"title": "Add behaviour (flow) nodes",
+			"description": "Add behavior (flow) nodes to a node graph — this is how objects get MOTION and interactivity: spin, bounce, patrol a path, pulse, blink, react to clicks. graph is \"scene\" or an object uuid (ONE graph per call). KEY RULE: a behavior node placed in an OBJECT's graph with no edges automatically drives that object — most behaviors are one node, zero edges, so usually OMIT edges. Describe nodes EITHER as text (graph lines, see the system prompt) OR as nodes/edges arrays. A call with some bad nodes still creates the good ones and returns partial:true + errors[] — resend only what errors[] names.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"graph": {
+						"type": "string",
+						"description": "\"scene\" or an existing object uuid (nodes in an object's graph drive that object)"
+					},
+					"text": {
+						"type": "string",
+						"description": "graph lines: `ref = type \"label\" {params}` per new node (omitted params = defaults), `ref.out -> other.in` per wire (refs or existing node ids). e.g. \"c = onclick\\nl = latch {initial: false}\\nc -> l.set\""
+					},
+					"nodes": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"ref": {
+									"type": "string",
+									"description": "local key so edges in THIS call can reference the new node"
+								},
+								"type": {
+									"type": "string",
+									"description": "a node type from the system prompt's Node types"
+								},
+								"data": {
+									"type": "object",
+									"description": "node params, e.g. spin {axis:\"y\",speed:2}; bounce {amplitude:0.5,speed:2}; pathpatrol {points:[[x,y,z],…] (>=2 world waypoints), speed:1, mode:\"loop\"|\"pingpong\"}; setcolor {color:\"#ff0000\"}; latch {initial:false}; delay {seconds:3}; sequence {delay1:0,delay2:0.5,delay3:0.5,delay4:0.5} (delays are CUMULATIVE). Omit for defaults."
+								}
+							},
+							"required": [
+								"type"
+							]
+						}
+					},
+					"edges": {
+						"type": "array",
+						"description": "optional wires between nodes (by ref or existing node id). Usually OMIT — unwired behavior nodes already drive their graph's object.",
+						"items": {
+							"type": "object",
+							"properties": {
+								"from": {
+									"type": "string"
+								},
+								"to": {
+									"type": "string"
+								},
+								"fromHandle": {
+									"type": "string"
+								},
+								"toHandle": {
+									"type": "string"
+								}
+							},
+							"required": [
+								"from",
+								"to"
+							]
+						}
+					}
+				},
+				"required": [
+					"graph"
+				]
+			},
+			"annotations": {
+				"title": "Add behaviour (flow) nodes",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "update_flow_nodes",
+			"title": "Change or remove flow nodes",
+			"description": "Tune or remove existing behavior nodes in one graph. Node ids and current data are in the scene summary under each object's \"flow\" (and \"sceneFlow\").",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"graph": {
+						"type": "string",
+						"description": "\"scene\" or an object uuid"
+					},
+					"updates": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"id": {
+									"type": "string"
+								},
+								"data": {
+									"type": "object",
+									"description": "data keys to change, e.g. {speed: 3}"
+								}
+							},
+							"required": [
+								"id",
+								"data"
+							]
+						}
+					},
+					"remove": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						},
+						"description": "node ids to delete"
+					}
+				},
+				"required": [
+					"graph"
+				]
+			},
+			"annotations": {
+				"title": "Change or remove flow nodes",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "describe_node_types",
+			"title": "Look up flow node types",
+			"description": "Look up flow node types before wiring them: per type its inputs (toHandle names + socket types), its output type and named outputs (fromHandle), its params with types and defaults, and one line on what it does. No arguments = every type name by group; group = that group with one-line docs; types = full details (up to 12). Changes nothing.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"types": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						},
+						"description": "node types to describe, e.g. [\"latch\",\"spin\",\"onclick\"]"
+					},
+					"group": {
+						"type": "string",
+						"description": "a palette group, e.g. \"Logic\" or \"Triggers\""
+					}
+				}
+			},
+			"annotations": {
+				"title": "Look up flow node types",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "create_behaviour",
+			"title": "Add a code behaviour",
+			"description": "Create a code behaviour: game logic (rules, waves, scoring, timers, win/lose) as ONE JavaScript module, run on the session authority and replicated. Prefer it over large node graphs for game rules. Linted before it is applied; problems come back with line numbers. The result names the node id and its sockets — wire them with create_flow_nodes (an On Click / On Enter into an input; an output into HUD Text, Visibility, Announce…).\nBEHAVIOURS (create_behaviour / edit_behaviour): game logic as ONE JavaScript module, run on ONE peer (the session authority); `state` replicates to everyone.\nexport default behaviour({ name, params: {k: literal | {value, min, max, step, unit}}, state: {plain JSON}, inputs: [names], outputs: [names], on: {event(payload) {...}}, ...methods });\ninputs: a trigger wired into input \"x\" runs on.x. outputs: a state field = a value output, any other name = an event fired by this.emit(\"name\").\nA behaviour does NOT move, rotate, recolour or hide objects (no such this.*): it drives effect nodes (spin, visibility, setcolor…) via its outputs. NO per-frame hook (no onTick/update): repeat with this.after(seconds, \"method\").\nthis: params, state, kit (also bare `kit`), after(seconds, \"method\", ...args) (survives the host leaving), cancel(key), rand(), randInt(a,b), pick(list), now(), find(glob) / findAll(glob) -> {uuid, name, pos, tags}, object, log() — always as this.find(…) etc. (only `kit` and the helpers are bare). Helpers: dist(a,b), clamp, lerp.\nevents: load (runs on EVERY peer when the behaviour loads — local, state read-only: register things there), start (once, on the authority); grabRequest({piece, distance, hand, refuse}) (runs on the grabbing peer, read-only: call refuse(reason)); any kit event as \"piece.event\" or roundStart, go, won, lost, paused, resumed, menu, levelSelected, scored, collected, allCollected, spawned, despawned, emptied, damaged, healed, died, revived, stuck, grabRefused. Entity payloads have entity.is(glob), entity.hasTag(t).\nkit calls: kit.round.start/win(reason)/lose(reason), kit.score.add(n), kit.spawner.spawn({kind, template: uuid, at, count, hp, mover: {speed}}), kit.health.damage(id, n), kit.mover.chase(kind, \"nearestPlayer\"), kit.rules.set({reach, jump}), kit.pickups.register({id, score, respawn, radius}) — register pickups in on.load (every peer must know them, or touching one does nothing), never in start.\nForbidden (the load is refused): Math.random, Date / Date.now, performance.now, localStorage, document/window/globalThis, fetch, eval, setTimeout/setInterval, import. Unknown this.* members, unknown events and hook-named methods nothing calls are refused too.\nEXAMPLE (passes the lint; wire a trigger into input gemTouched, output left into a HUD Text, timeUp into a Visibility or Announce):\nexport default behaviour({\n  name: 'Countdown',\n  params: { seconds: 30 },\n  state: { left: 30, found: 0 },\n  inputs: ['gemTouched'],\n  outputs: ['left', 'found', 'timeUp'],\n  on: {\n    start() { this.state.left = this.params.seconds; this.after(1, 'tick'); },\n    gemTouched() { this.state.found += 1; }\n  },\n  tick() {\n    this.state.left -= 1;\n    if (this.state.left > 0) this.after(1, 'tick');\n    else this.emit('timeUp');\n  }\n});",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"name": {
+						"type": "string",
+						"description": "a short unique name, letters/digits/_/-"
+					},
+					"target": {
+						"type": "string",
+						"description": "\"scene\" (default) or an object uuid the behaviour belongs to"
+					},
+					"source": {
+						"type": "string",
+						"description": "the whole behaviour module source (plain JavaScript, the format in create_behaviour's description). Must be deterministic: no Math.random (use rand()), no Date.now/new Date (use the session clock), no DOM, no localStorage, no timers (use this.after), no loop without an exit."
+					}
+				},
+				"required": [
+					"name",
+					"source"
+				]
+			},
+			"annotations": {
+				"title": "Add a code behaviour",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "edit_behaviour",
+			"title": "Edit a code behaviour",
+			"description": "Replace an existing behaviour's source (the scene summary lists them; read the current source with the name). Linted before it is applied. Same format as create_behaviour (see its description).",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"name": {
+						"type": "string"
+					},
+					"source": {
+						"type": "string",
+						"description": "the whole behaviour module source (plain JavaScript, the format in create_behaviour's description). Must be deterministic: no Math.random (use rand()), no Date.now/new Date (use the session clock), no DOM, no localStorage, no timers (use this.after), no loop without an exit."
+					}
+				},
+				"required": [
+					"name",
+					"source"
+				]
+			},
+			"annotations": {
+				"title": "Edit a code behaviour",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "set_physics",
+			"title": "Set physics",
+			"description": "Set physics body params on objects (batch). NOTE: objects made with create_objects are STATIC unless created with physics \"dynamic\" or a mass — use this to make existing objects dynamic, to TUNE bodies, or to pin scenery (mode \"static\"). mode \"auto\" reverts to scenery defaults.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"updates": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"uuid": {
+									"type": "string"
+								},
+								"mode": {
+									"type": "string",
+									"enum": [
+										"auto",
+										"static",
+										"dynamic"
+									]
+								},
+								"mass": {
+									"type": "number",
+									"description": "kg; implies mode dynamic"
+								},
+								"restitution": {
+									"type": "number",
+									"description": "bounciness 0..1"
+								},
+								"friction": {
+									"type": "number",
+									"description": "0..2"
+								},
+								"collider": {
+									"type": "string",
+									"enum": [
+										"box",
+										"sphere",
+										"capsule",
+										"cylinder",
+										"hull",
+										"trimesh"
+									],
+									"description": "trimesh = the exact mesh, for static scenery (tunnels, pools, arches); a dynamic body gets its hull"
+								},
+								"sensor": {
+									"type": "boolean",
+									"description": "true = a trigger volume: no collision response, fires On Enter/On Exit nodes"
+								},
+								"group": {
+									"type": "string",
+									"enum": [
+										"default",
+										"a",
+										"b",
+										"c",
+										"d",
+										"water"
+									],
+									"description": "collision group; water = a pass-through trigger volume"
+								},
+								"collidesWith": {
+									"type": "array",
+									"items": {
+										"type": "string",
+										"enum": [
+											"default",
+											"a",
+											"b",
+											"c",
+											"d",
+											"water",
+											"player"
+										]
+									},
+									"description": "groups this object collides with (omit = all); leave out player for a ghost wall the player walks through"
+								}
+							},
+							"required": [
+								"uuid"
+							]
+						}
+					}
+				},
+				"required": [
+					"updates"
+				]
+			},
+			"annotations": {
+				"title": "Set physics",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "create_joints",
+			"title": "Add physics joints",
+			"description": "Attach object pairs with physics joints: \"fixed\" welds them rigidly, \"revolute\" hinges around an axis (optional motor spins it). Move parts to their final pose WORLD-ALIGNED (no rotation) before jointing. Without anchor a hinge sits at b's origin (its centre) and a weld midway: pass anchor [x,y,z] (world) for the real pivot, e.g. the top of a pendulum rod or a door's edge. Jointed bodies that touch (a door in its frame, a wheel in its arch) also need contacts:false, or the solver pushes them apart.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"joints": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"kind": {
+									"type": "string",
+									"enum": [
+										"fixed",
+										"revolute"
+									]
+								},
+								"a": {
+									"type": "string",
+									"description": "uuid of the base object"
+								},
+								"b": {
+									"type": "string",
+									"description": "uuid of the attached object (hinge anchors at its origin)"
+								},
+								"axis": {
+									"type": "string",
+									"enum": [
+										"x",
+										"y",
+										"z"
+									],
+									"description": "hinge axis (revolute only, default y)"
+								},
+								"anchor": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "world [x,y,z] of the pivot/weld point (default: b's origin for a hinge, midway for a weld)"
+								},
+								"contacts": {
+									"type": "boolean",
+									"description": "false = the two bodies stop colliding with each other (default true)"
+								},
+								"limits": {
+									"type": "array",
+									"items": {
+										"type": "number"
+									},
+									"description": "revolute only: [min, max] radians the hinge may turn"
+								},
+								"motor": {
+									"type": "object",
+									"description": "revolute only: {vel: rad/s, maxForce}",
+									"properties": {
+										"vel": {
+											"type": "number"
+										},
+										"maxForce": {
+											"type": "number"
+										}
+									}
+								}
+							},
+							"required": [
+								"kind",
+								"a",
+								"b"
+							]
+						}
+					}
+				},
+				"required": [
+					"joints"
+				]
+			},
+			"annotations": {
+				"title": "Add physics joints",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "control_simulation",
+			"title": "Run or stop the simulation",
+			"description": "Start, stop, pause, resume or reset the physics simulation. After building a physics assembly, start the simulation so the user sees it move.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"action": {
+						"type": "string",
+						"enum": [
+							"start",
+							"stop",
+							"pause",
+							"resume",
+							"reset"
+						]
+					}
+				},
+				"required": [
+					"action"
+				]
+			},
+			"annotations": {
+				"title": "Run or stop the simulation",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "import_model",
+			"title": "Import model",
+			"description": "Import a self-contained GLB (binary glTF 2.0, everything embedded, ≤ 25 MB) into the scene through the app's own import pipeline (auto-optimize, LOD, budget check). Named nodes are kept as a hierarchy and returned with uuids. One undo step; syncs to every peer; provenance is recorded. Use for models built outside the app (e.g. an img2threejs rebuild exported with named pivots). Materials: standard PBR only — custom shaders do not survive glTF.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"path": {
+						"type": "string",
+						"description": "a local .glb path on the agent's machine (the bridge reads it)"
+					},
+					"data": {
+						"type": "string",
+						"description": "the GLB as base64 (alternative to path/url)"
+					},
+					"url": {
+						"type": "string",
+						"description": "an http(s) URL of a .glb (the host may block other origins)"
+					},
+					"name": {
+						"type": "string"
+					},
+					"position": {
+						"type": "array",
+						"items": {
+							"type": "number"
+						},
+						"description": "[x,y,z] metres (local to parent when given)"
+					},
+					"rotation": {
+						"type": "array",
+						"items": {
+							"type": "number"
+						},
+						"description": "[x,y,z] degrees, XYZ order"
+					},
+					"scale": {
+						"description": "a number or [x,y,z]"
+					},
+					"parent": {
+						"type": "string",
+						"description": "uuid (or exact name) of the object to parent under"
+					},
+					"source": {
+						"type": "string",
+						"description": "where the model came from, e.g. \"img2threejs from photo campfire.jpg\""
+					},
+					"licence": {
+						"type": "string",
+						"description": "its licence, e.g. CC0, CC-BY-4.0, \"own work\""
+					},
+					"prompt": {
+						"type": "string",
+						"description": "the request it was made for"
+					}
+				}
+			},
+			"annotations": {
+				"title": "Import model",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "import_file",
+			"title": "Import file",
+			"description": "Bring a file made on your machine into the session: PNG / WebP images (≤ 16 MB, metadata stripped), JSON (≤ 2 MB) or a .tpanim clip. The type is read from the bytes. It lands in the Explorer (folder \"Generated\" unless `folder`), shared with every peer. Pass the generator's input as `spec` and it is saved beside the file as <name>.<generator>.json (e.g. knight.png + knight.pixling.json) so it can be regenerated. An image is also placed in the scene as a card (a plane; `place: false` to skip): `filter: \"nearest\"` keeps pixel art crisp (default when a spec is given), `frame: {w, h, col, row}` shows one frame of a sprite sheet, `facing: \"camera-y\"` turns it to face each viewer. One undo step; editors and admins only. Large files: send base64 parts with `chunk: {id, index, total}` (the bridge does this for you with `path`).",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"path": {
+						"type": "string",
+						"description": "a local file on the agent's machine (the bridge reads it)"
+					},
+					"data": {
+						"type": "string",
+						"description": "the file as base64 (or this chunk's part of it)"
+					},
+					"chunk": {
+						"type": "object",
+						"description": "a chunked upload: every part has the same id; the import runs when the last part arrives",
+						"properties": {
+							"id": {
+								"type": "string"
+							},
+							"index": {
+								"type": "number"
+							},
+							"total": {
+								"type": "number"
+							}
+						}
+					},
+					"name": {
+						"type": "string",
+						"description": "the file name in the Explorer (its extension comes from the bytes)"
+					},
+					"folder": {
+						"type": "string",
+						"description": "Explorer folder, \"A/B\" for nested (default \"Generated\")"
+					},
+					"spec": {
+						"description": "the generator input (JSON object or string), saved beside the file"
+					},
+					"spec_path": {
+						"type": "string",
+						"description": "the spec as a local .json file (the bridge reads it)"
+					},
+					"generator": {
+						"type": "string",
+						"description": "names the spec file, default \"pixling\""
+					},
+					"place": {
+						"type": "boolean",
+						"description": "images: place a card in the scene (default true)"
+					},
+					"position": {
+						"type": "array",
+						"items": {
+							"type": "number"
+						},
+						"description": "[x,y,z] metres (default: standing on the ground at the origin)"
+					},
+					"rotation": {
+						"type": "array",
+						"items": {
+							"type": "number"
+						},
+						"description": "[x,y,z] degrees"
+					},
+					"height": {
+						"type": "number",
+						"description": "card height in metres (default 1; width follows the aspect)"
+					},
+					"width": {
+						"type": "number",
+						"description": "card width in metres (instead of height)"
+					},
+					"frame": {
+						"type": "object",
+						"description": "show one frame of a sheet: w/h in pixels, col/row from 0 (row 0 = top)",
+						"properties": {
+							"w": {
+								"type": "number"
+							},
+							"h": {
+								"type": "number"
+							},
+							"col": {
+								"type": "number"
+							},
+							"row": {
+								"type": "number"
+							}
+						}
+					},
+					"filter": {
+						"type": "string",
+						"enum": [
+							"auto",
+							"nearest",
+							"linear"
+						],
+						"description": "texture filtering (auto = nearest for pixel art)"
+					},
+					"facing": {
+						"type": "string",
+						"enum": [
+							"none",
+							"camera",
+							"camera-y"
+						],
+						"description": "billboard: face each viewer (camera-y = turn about Y only)"
+					},
+					"lit": {
+						"type": "boolean",
+						"description": "shade the card with the scene lights (default unlit, like a sprite)"
+					},
+					"source": {
+						"type": "string",
+						"description": "where it came from, e.g. \"pixling 0.3.1 build specs/knight.json\""
+					},
+					"licence": {
+						"type": "string",
+						"description": "its licence, e.g. CC0, \"own work\""
+					},
+					"prompt": {
+						"type": "string",
+						"description": "the request it was made for"
+					}
+				}
+			},
+			"annotations": {
+				"title": "Import file",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "install_modules",
+			"title": "Install modules",
+			"description": "Install the modules the other peers in this session run and this page lacks (status().missingModules), from the module gallery. Local to this page; omit ids to install every missing one.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"ids": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						},
+						"description": "module ids; omit for all missing"
+					}
+				}
+			},
+			"annotations": {
+				"title": "Install modules",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": true
+			}
+		},
+		{
+			"name": "pending_offers",
+			"title": "List questions the app is asking",
+			"description": "List the questions the app is asking this page (an admin-role offer, \"share or stash your scene\"…), each with its buttons. Answer one with accept_offer.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {}
+			},
+			"annotations": {
+				"title": "List questions the app is asking",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "accept_offer",
+			"title": "Answer a question the app asks",
+			"description": "Press a button on a pending offer (see pending_offers). action = the button label; omit for the first button.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string"
+					},
+					"action": {
+						"type": "string"
+					}
+				},
+				"required": [
+					"id"
+				]
+			},
+			"annotations": {
+				"title": "Answer a question the app asks",
+				"readOnlyHint": false,
+				"destructiveHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "what_can_you_do",
+			"title": "What can you do here",
+			"description": "Answer \"what can you do here?\": a short spoken summary of what you can build in this tab, what you cannot do, and example requests. Changes nothing.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {}
+			},
+			"annotations": {
+				"title": "What can you do here",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "connect",
+			"title": "Join a session",
+			"description": "Join a theprototype.app session. Pass the link the host shared (https://theprototype.app/#F0FD3, possibly with &invite=…) or the bare session id. An invite link joins at once; a plain link asks the host to Approve. The scene tools appear once the agent page is up; call status to see whether you are in.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"link": {
+						"type": "string",
+						"description": "session link or id"
+					},
+					"peer_id": {
+						"type": "string",
+						"description": "older name for link"
+					}
+				}
+			},
+			"annotations": {
+				"title": "Join a session",
+				"readOnlyHint": false,
+				"destructiveHint": false,
+				"openWorldHint": true
+			}
+		},
+		{
+			"name": "status",
+			"title": "Session status",
+			"description": "Where the agent is: connection state, whether the host has let it in, its role (viewer edits stay local), the app version, and why any tool is missing.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {}
+			},
+			"annotations": {
+				"title": "Session status",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "screenshot",
+			"title": "Take a picture of the scene",
+			"description": "See the scene: a PNG of a clean frame (no gizmos) from a temporary camera, never moving anyone's view. view: current | top | front | iso | focus (focus needs uuid).",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"view": {
+						"type": "string",
+						"enum": [
+							"current",
+							"top",
+							"front",
+							"iso",
+							"focus"
+						]
+					},
+					"uuid": {
+						"type": "string",
+						"description": "object to frame (view focus)"
+					},
+					"size": {
+						"type": "number",
+						"description": "longest side in pixels"
+					}
+				}
+			},
+			"annotations": {
+				"title": "Take a picture of the scene",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		},
+		{
+			"name": "wait_for_edit",
+			"title": "Wait for someone to edit",
+			"description": "Wait until someone in the session changes the scene (or the timeout passes), so you can react to the humans.",
+			"inputSchema": {
+				"type": "object",
+				"properties": {
+					"timeout_ms": {
+						"type": "number",
+						"description": "default 30000, at most 120000"
+					}
+				}
+			},
+			"annotations": {
+				"title": "Wait for someone to edit",
+				"readOnlyHint": true,
+				"openWorldHint": false
+			}
+		}
+	]
+}