@sajou/mcp-server 0.6.0

package/dist/tools/get-shaders.js

@@ -0,0 +1,38 @@
+/**
+ * MCP tool: get_shaders
+ *
+ * Lists all shader definitions with full details (code, uniforms, objects).
+ */
+import { z } from "zod";
+import { getShaders } from "../state/store.js";
+export const name = "get_shaders";
+export const description = "List all GLSL shaders in the current scene with full details: source code, " +
+    "uniforms (names, types, values, ranges, bindings), virtual objects, and pass count. " +
+    "Use this to inspect existing shaders before modifying them or setting uniforms.";
+export const inputSchema = z.object({});
+export async function handler() {
+    const shadersState = getShaders();
+    const shaders = (shadersState["shaders"] ?? []);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    shaderCount: shaders.length,
+                    shaders: shaders.map((s) => ({
+                        id: s["id"],
+                        name: s["name"],
+                        mode: s["mode"],
+                        passes: s["passes"],
+                        fragmentSource: s["fragmentSource"],
+                        vertexSource: s["vertexSource"],
+                        uniforms: s["uniforms"],
+                        objects: s["objects"],
+                    })),
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-shaders.js.map

package/dist/tools/get-shaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-shaders.js","sourceRoot":"","sources":["../../src/tools/get-shaders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GACtB,6EAA6E;IAC7E,sFAAsF;IACtF,iFAAiF,CAAC;AAEpF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,OAAO;IAG3B,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAmC,CAAC;IAElF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,WAAW,EAAE,OAAO,CAAC,MAAM;oBAC3B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC3B,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;wBACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;wBACf,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;wBACnB,cAAc,EAAE,CAAC,CAAC,gBAAgB,CAAC;wBACnC,YAAY,EAAE,CAAC,CAAC,cAAc,CAAC;wBAC/B,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC;wBACvB,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;qBACtB,CAAC,CAAC;iBACJ,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-sketches.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP tool: get_sketches
+ *
+ * Lists all sketch definitions with full details (code, params, mode).
+ */
+import { z } from "zod";
+export declare const name = "get_sketches";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare function handler(): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=get-sketches.d.ts.map

package/dist/tools/get-sketches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sketches.d.ts","sourceRoot":"","sources":["../../src/tools/get-sketches.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,iBAAiB,CAAC;AAEnC,eAAO,MAAM,WAAW,QAG8D,CAAC;AAEvF,eAAO,MAAM,WAAW,gDAAe,CAAC;AAExC,wBAAsB,OAAO,IAAI,OAAO,CAAC;IACvC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC,CAwBD"}

package/dist/tools/get-sketches.js

@@ -0,0 +1,37 @@
+/**
+ * MCP tool: get_sketches
+ *
+ * Lists all sketch definitions with full details (code, params, mode).
+ */
+import { z } from "zod";
+import { getP5 } from "../state/store.js";
+export const name = "get_sketches";
+export const description = "List all sketches in the current scene with full details: source code, parameters " +
+    "(names, types, values, ranges, bindings), runtime mode (p5 or threejs), and dimensions. " +
+    "Use this to inspect existing sketches before modifying them or setting parameters.";
+export const inputSchema = z.object({});
+export async function handler() {
+    const p5State = getP5();
+    const sketches = (p5State["sketches"] ?? []);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    sketchCount: sketches.length,
+                    sketches: sketches.map((s) => ({
+                        id: s["id"],
+                        name: s["name"],
+                        mode: s["mode"],
+                        source: s["source"],
+                        params: s["params"],
+                        width: s["width"],
+                        height: s["height"],
+                    })),
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-sketches.js.map

package/dist/tools/get-sketches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sketches.js","sourceRoot":"","sources":["../../src/tools/get-sketches.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,CAAC,MAAM,IAAI,GAAG,cAAc,CAAC;AAEnC,MAAM,CAAC,MAAM,WAAW,GACtB,oFAAoF;IACpF,0FAA0F;IAC1F,oFAAoF,CAAC;AAEvF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,OAAO;IAG3B,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAmC,CAAC;IAE/E,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,WAAW,EAAE,QAAQ,CAAC,MAAM;oBAC5B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC7B,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;wBACf,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;wBACf,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;wBACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;wBACnB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;wBACjB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC;qBACpB,CAAC,CAAC;iBACJ,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-themes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * list_themes tool — returns available sajou themes.
+ *
+ * Theme catalog system is not yet implemented. Returns a stub response
+ * directing agents to use scene-level tools instead.
+ */
+import { z } from "zod";
+/** Tool name. */
+export declare const name = "list_themes";
+/** Tool description shown to the AI agent. */
+export declare const description: string;
+/** Input schema — no parameters needed. */
+export declare const inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+/** Tool handler — returns stub until theme catalog is implemented. */
+export declare function handler(): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=list-themes.d.ts.map

package/dist/tools/list-themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-themes.d.ts","sourceRoot":"","sources":["../../src/tools/list-themes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iBAAiB;AACjB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAGmD,CAAC;AAE5E,2CAA2C;AAC3C,eAAO,MAAM,WAAW,gDAAe,CAAC;AAExC,sEAAsE;AACtE,wBAAsB,OAAO,IAAI,OAAO,CAAC;IACvC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC,CAeD"}

package/dist/tools/list-themes.js

@@ -0,0 +1,32 @@
+/**
+ * list_themes tool — returns available sajou themes.
+ *
+ * Theme catalog system is not yet implemented. Returns a stub response
+ * directing agents to use scene-level tools instead.
+ */
+import { z } from "zod";
+/** Tool name. */
+export const name = "list_themes";
+/** Tool description shown to the AI agent. */
+export const description = "List available sajou themes. " +
+    "NOTE: Theme catalog is under development. Use get_scene_state and " +
+    "get_choreographies to interact with the currently loaded scene instead.";
+/** Input schema — no parameters needed. */
+export const inputSchema = z.object({});
+/** Tool handler — returns stub until theme catalog is implemented. */
+export async function handler() {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    status: "not_yet_available",
+                    message: "Theme catalog is under development. Use get_scene_state and " +
+                        "get_choreographies to interact with the currently loaded scene.",
+                    themes: [],
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-themes.js.map

package/dist/tools/list-themes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-themes.js","sourceRoot":"","sources":["../../src/tools/list-themes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iBAAiB;AACjB,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GACtB,+BAA+B;IAC/B,oEAAoE;IACpE,yEAAyE,CAAC;AAE5E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAExC,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,OAAO;IAG3B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,MAAM,EAAE,mBAAmB;oBAC3B,OAAO,EACL,8DAA8D;wBAC9D,iEAAiE;oBACnE,MAAM,EAAE,EAAE;iBACX,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/map-signals.d.ts

@@ -0,0 +1,30 @@
+/**
+ * map_signals tool — convenience wrapper around create_wire for signal→choreography mapping.
+ *
+ * This is a simpler interface than create_wire for the common case:
+ * "when signal X arrives, trigger choreography Y".
+ */
+import { z } from "zod";
+/** Tool name. */
+export declare const name = "map_signals";
+/** Tool description shown to the AI agent. */
+export declare const description: string;
+/** Input schema. */
+export declare const inputSchema: z.ZodObject<{
+    signal_type: z.ZodString;
+    choreography_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    signal_type: string;
+    choreography_id: string;
+}, {
+    signal_type: string;
+    choreography_id: string;
+}>;
+/** Tool handler — creates the wire. */
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=map-signals.d.ts.map

package/dist/tools/map-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-signals.d.ts","sourceRoot":"","sources":["../../src/tools/map-signals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iBAAiB;AACjB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAG8E,CAAC;AAEvG,oBAAoB;AACpB,eAAO,MAAM,WAAW;;;;;;;;;EAOtB,CAAC;AAEH,uCAAuC;AACvC,wBAAsB,OAAO,CAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAmB7D"}

package/dist/tools/map-signals.js

@@ -0,0 +1,44 @@
+/**
+ * map_signals tool — convenience wrapper around create_wire for signal→choreography mapping.
+ *
+ * This is a simpler interface than create_wire for the common case:
+ * "when signal X arrives, trigger choreography Y".
+ */
+import { z } from "zod";
+import { addWire } from "../state/mutations.js";
+/** Tool name. */
+export const name = "map_signals";
+/** Tool description shown to the AI agent. */
+export const description = "Map a signal type to a choreography — when this signal arrives, that choreography plays. " +
+    "This is a convenience shortcut. Under the hood it creates a wire from signal-type → choreographer zone. " +
+    "For more complex wiring (e.g. connecting a specific signal source first), use create_wire instead.";
+/** Input schema. */
+export const inputSchema = z.object({
+    signal_type: z
+        .string()
+        .describe("The signal type to listen for (e.g. 'task_dispatch', 'tool_call', 'error')."),
+    choreography_id: z
+        .string()
+        .describe("The choreography ID to trigger when the signal arrives."),
+});
+/** Tool handler — creates the wire. */
+export async function handler(params) {
+    addWire({
+        fromZone: "signal-type",
+        fromId: params.signal_type,
+        toZone: "choreographer",
+        toId: params.choreography_id,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    message: `Mapped signal "${params.signal_type}" → choreography "${params.choreography_id}"`,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=map-signals.js.map

package/dist/tools/map-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-signals.js","sourceRoot":"","sources":["../../src/tools/map-signals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,iBAAiB;AACjB,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GACtB,2FAA2F;IAC3F,0GAA0G;IAC1G,oGAAoG,CAAC;AAEvG,oBAAoB;AACpB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC;AAEH,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,OAAO,CAAC;QACN,QAAQ,EAAE,aAAa;QACvB,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,MAAM,CAAC,eAAe;KAC7B,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,kBAAkB,MAAM,CAAC,WAAW,qBAAqB,MAAM,CAAC,eAAe,GAAG;iBAC5F,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/place-entity.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MCP tool: place_entity
+ *
+ * Places an entity instance on the scene at a given position.
+ * Entities are visual objects from the theme's catalog (e.g. 'peon', 'tree', 'building').
+ */
+import { z } from "zod";
+export declare const name = "place_entity";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    entityId: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    semanticId: z.ZodOptional<z.ZodString>;
+    layerId: z.ZodOptional<z.ZodString>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    rotation: z.ZodOptional<z.ZodNumber>;
+    zIndex: z.ZodOptional<z.ZodNumber>;
+    activeState: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    x: number;
+    y: number;
+    semanticId?: string | undefined;
+    scale?: number | undefined;
+    rotation?: number | undefined;
+    layerId?: string | undefined;
+    zIndex?: number | undefined;
+    activeState?: string | undefined;
+}, {
+    entityId: string;
+    x: number;
+    y: number;
+    semanticId?: string | undefined;
+    scale?: number | undefined;
+    rotation?: number | undefined;
+    layerId?: string | undefined;
+    zIndex?: number | undefined;
+    activeState?: string | undefined;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=place-entity.d.ts.map

package/dist/tools/place-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-entity.d.ts","sourceRoot":"","sources":["../../src/tools/place-entity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,iBAAiB,CAAC;AAEnC,eAAO,MAAM,WAAW,QAMiD,CAAC;AAE1E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CtB,CAAC;AAEH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8B7D"}

package/dist/tools/place-entity.js

@@ -0,0 +1,85 @@
+/**
+ * MCP tool: place_entity
+ *
+ * Places an entity instance on the scene at a given position.
+ * Entities are visual objects from the theme's catalog (e.g. 'peon', 'tree', 'building').
+ */
+import { z } from "zod";
+import { addEntity } from "../state/mutations.js";
+export const name = "place_entity";
+export const description = "Place an entity on the scene. Entities are visual objects defined in the theme's catalog. " +
+    "Use get_catalog to see available entity types for the current theme. " +
+    "Each placed entity gets a unique instance ID and can optionally have a semanticId " +
+    "to make it an 'actor' that choreographies can target. " +
+    "Example: place a 'peon' entity at (200, 300) with semanticId 'agent-1' — " +
+    "then choreographies can animate 'agent-1' to move, change state, etc.";
+export const inputSchema = z.object({
+    entityId: z
+        .string()
+        .describe("The entity type ID from the theme catalog (e.g. 'peon', 'tree', 'building-townhall'). " +
+        "Use get_catalog to list available entity types."),
+    x: z
+        .number()
+        .describe("X position on the scene (pixels from left). Scene is typically 960px wide."),
+    y: z
+        .number()
+        .describe("Y position on the scene (pixels from top). Scene is typically 640px tall."),
+    semanticId: z
+        .string()
+        .optional()
+        .describe("Optional actor name for this entity (e.g. 'agent-1', 'door-kitchen', 'indicator-status'). " +
+        "When set, choreographies can target this entity by name. " +
+        "Must be unique across all placed entities. " +
+        "Omit for passive decoration entities."),
+    layerId: z
+        .string()
+        .optional()
+        .describe("Scene layer: 'background' (behind), 'midground' (default), 'foreground' (in front). " +
+        "Defaults to 'midground'."),
+    scale: z
+        .number()
+        .optional()
+        .describe("Uniform scale factor. 1 = normal size, 0.5 = half, 2 = double. Defaults to 1."),
+    rotation: z
+        .number()
+        .optional()
+        .describe("Rotation in degrees. Defaults to 0."),
+    zIndex: z
+        .number()
+        .optional()
+        .describe("Z-order within the layer. Higher values render on top. Defaults to 0."),
+    activeState: z
+        .string()
+        .optional()
+        .describe("Initial animation state (e.g. 'idle', 'walk', 'attack'). Defaults to 'idle'."),
+});
+export async function handler(params) {
+    const instanceId = crypto.randomUUID();
+    addEntity({
+        id: instanceId,
+        entityId: params.entityId,
+        x: params.x,
+        y: params.y,
+        semanticId: params.semanticId,
+        layerId: params.layerId,
+        scale: params.scale,
+        rotation: params.rotation,
+        zIndex: params.zIndex,
+        activeState: params.activeState,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    instanceId,
+                    hint: params.semanticId
+                        ? `Entity placed with semanticId '${params.semanticId}'. Use this name in choreography steps and bindings.`
+                        : undefined,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=place-entity.js.map

package/dist/tools/place-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-entity.js","sourceRoot":"","sources":["../../src/tools/place-entity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,CAAC,MAAM,IAAI,GAAG,cAAc,CAAC;AAEnC,MAAM,CAAC,MAAM,WAAW,GACtB,4FAA4F;IAC5F,uEAAuE;IACvE,oFAAoF;IACpF,wDAAwD;IACxD,2EAA2E;IAC3E,uEAAuE,CAAC;AAE1E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CACP,wFAAwF;QACxF,iDAAiD,CAClD;IACH,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,CAAC,4EAA4E,CAAC;IACzF,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,CAAC,2EAA2E,CAAC;IACxF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F;QAC5F,2DAA2D;QAC3D,6CAA6C;QAC7C,uCAAuC,CACxC;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sFAAsF;QACtF,0BAA0B,CAC3B;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEvC,SAAS,CAAC;QACR,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,UAAU;oBACV,IAAI,EAAE,MAAM,CAAC,UAAU;wBACrB,CAAC,CAAC,kCAAkC,MAAM,CAAC,UAAU,sDAAsD;wBAC3G,CAAC,CAAC,SAAS;iBACd,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/remove-item.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP tool: remove_item
+ *
+ * Generic removal tool — removes an entity, choreography, binding, or wire from the scene.
+ */
+import { z } from "zod";
+export declare const name = "remove_item";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    type: z.ZodEnum<["entity", "choreography", "binding", "wire", "source"]>;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "entity" | "choreography" | "binding" | "wire" | "source";
+    id: string;
+}, {
+    type: "entity" | "choreography" | "binding" | "wire" | "source";
+    id: string;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=remove-item.d.ts.map

package/dist/tools/remove-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-item.d.ts","sourceRoot":"","sources":["../../src/tools/remove-item.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAI8B,CAAC;AAEvD,eAAO,MAAM,WAAW;;;;;;;;;EActB,CAAC;AAEH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6B7D"}

package/dist/tools/remove-item.js

@@ -0,0 +1,55 @@
+/**
+ * MCP tool: remove_item
+ *
+ * Generic removal tool — removes an entity, choreography, binding, or wire from the scene.
+ */
+import { z } from "zod";
+import { removeEntity, removeChoreography, removeBinding, removeWire, removeSignalSource, } from "../state/mutations.js";
+export const name = "remove_item";
+export const description = "Remove an item from the scene. Supports removing entities, choreographies, bindings, wires, and signal sources. " +
+    "Use get_scene_state, get_choreographies, or describe_scene to find item IDs. " +
+    "Removing a choreography also cleans up its connected wires. " +
+    "Removing a signal source also cleans up its wires.";
+export const inputSchema = z.object({
+    type: z
+        .enum(["entity", "choreography", "binding", "wire", "source"])
+        .describe("What type of item to remove. " +
+        "'entity' — a placed entity instance (use the instance ID, not the entity type). " +
+        "'choreography' — a choreography definition (also removes connected wires). " +
+        "'binding' — an entity binding. " +
+        "'wire' — a wire connection. " +
+        "'source' — a signal source (local sources cannot be removed)."),
+    id: z
+        .string()
+        .describe("The ID of the item to remove."),
+});
+export async function handler(params) {
+    switch (params.type) {
+        case "entity":
+            removeEntity(params.id);
+            break;
+        case "choreography":
+            removeChoreography(params.id);
+            break;
+        case "binding":
+            removeBinding(params.id);
+            break;
+        case "wire":
+            removeWire(params.id);
+            break;
+        case "source":
+            removeSignalSource(params.id);
+            break;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=remove-item.js.map

package/dist/tools/remove-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-item.js","sourceRoot":"","sources":["../../src/tools/remove-item.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GACtB,kHAAkH;IAClH,+EAA+E;IAC/E,8DAA8D;IAC9D,oDAAoD,CAAC;AAEvD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SAC7D,QAAQ,CACP,+BAA+B;QAC/B,kFAAkF;QAClF,6EAA6E;QAC7E,iCAAiC;QACjC,8BAA8B;QAC9B,+DAA+D,CAChE;IACH,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,cAAc;YACjB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM;QACR,KAAK,SAAS;YACZ,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,MAAM;YACT,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtB,MAAM;QACR,KAAK,QAAQ;YACX,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM;IACV,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;iBACT,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/set-sketch-param.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MCP tool: set_sketch_param
+ *
+ * Sets a parameter value on a sketch in real-time. This is the key runtime
+ * tool — an AI agent tweaks sketch parameters as events flow through.
+ */
+import { z } from "zod";
+export declare const name = "set_sketch_param";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    sketchId: z.ZodString;
+    paramName: z.ZodString;
+    value: z.ZodUnion<[z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodNumber, "many">]>;
+}, "strip", z.ZodTypeAny, {
+    value: number | boolean | number[];
+    paramName: string;
+    sketchId: string;
+}, {
+    value: number | boolean | number[];
+    paramName: string;
+    sketchId: string;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=set-sketch-param.d.ts.map

package/dist/tools/set-sketch-param.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-sketch-param.d.ts","sourceRoot":"","sources":["../../src/tools/set-sketch-param.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,qBAAqB,CAAC;AAEvC,eAAO,MAAM,WAAW,QAW2D,CAAC;AAEpF,eAAO,MAAM,WAAW;;;;;;;;;;;;EAatB,CAAC;AAEH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgB7D"}

package/dist/tools/set-sketch-param.js

@@ -0,0 +1,49 @@
+/**
+ * MCP tool: set_sketch_param
+ *
+ * Sets a parameter value on a sketch in real-time. This is the key runtime
+ * tool — an AI agent tweaks sketch parameters as events flow through.
+ */
+import { z } from "zod";
+import { setP5Param } from "../state/mutations.js";
+export const name = "set_sketch_param";
+export const description = "Set a parameter value on a sketch in real-time. This is the primary way an AI agent " +
+    "controls sketch visuals — tweak a float slider, change a color, toggle an effect, or move " +
+    "a 2D position.\n\n" +
+    "The value type must match the parameter's type:\n" +
+    "- float/int → number (e.g. 0.5)\n" +
+    "- bool → boolean (true/false)\n" +
+    "- vec2 → [x, y]\n" +
+    "- vec3 → [r, g, b] or [x, y, z]\n" +
+    "- vec4 → [r, g, b, a]\n\n" +
+    "Example: to speed up a particle effect, set_sketch_param({ sketchId: '...', paramName: 'speed', value: 3.0 }).\n\n" +
+    "Use get_sketches first to discover available parameters and their value ranges.";
+export const inputSchema = z.object({
+    sketchId: z
+        .string()
+        .describe("ID of the sketch containing the parameter."),
+    paramName: z
+        .string()
+        .describe("Name of the parameter to set (e.g. 'speed', 'radius', 'color')."),
+    value: z
+        .union([z.number(), z.boolean(), z.array(z.number())])
+        .describe("New value for the parameter. Must match the declared type: " +
+        "number for float/int, boolean for bool, number[] for vec2/vec3/vec4."),
+});
+export async function handler(params) {
+    setP5Param(params.sketchId, params.paramName, params.value);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    sketchId: params.sketchId,
+                    paramName: params.paramName,
+                    value: params.value,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=set-sketch-param.js.map

package/dist/tools/set-sketch-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-sketch-param.js","sourceRoot":"","sources":["../../src/tools/set-sketch-param.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GACtB,sFAAsF;IACtF,4FAA4F;IAC5F,oBAAoB;IACpB,mDAAmD;IACnD,mCAAmC;IACnC,iCAAiC;IACjC,mBAAmB;IACnB,mCAAmC;IACnC,2BAA2B;IAC3B,oHAAoH;IACpH,iFAAiF,CAAC;AAEpF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,4CAA4C,CAAC;IACzD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACrD,QAAQ,CACP,6DAA6D;QAC7D,sEAAsE,CACvE;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5D,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/set-uniform.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MCP tool: set_uniform
+ *
+ * Sets a uniform value on a shader in real-time. This is the key runtime
+ * tool — an AI agent tweaks shader parameters as events flow through.
+ */
+import { z } from "zod";
+export declare const name = "set_uniform";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    shaderId: z.ZodString;
+    uniformName: z.ZodString;
+    value: z.ZodUnion<[z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodNumber, "many">]>;
+}, "strip", z.ZodTypeAny, {
+    value: number | boolean | number[];
+    uniformName: string;
+    shaderId: string;
+}, {
+    value: number | boolean | number[];
+    uniformName: string;
+    shaderId: string;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=set-uniform.d.ts.map

package/dist/tools/set-uniform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-uniform.d.ts","sourceRoot":"","sources":["../../src/tools/set-uniform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAWwD,CAAC;AAEjF,eAAO,MAAM,WAAW;;;;;;;;;;;;EAatB,CAAC;AAEH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgB7D"}