@sajou/mcp-server 0.6.0

package/dist/tools/create-shader.d.ts

@@ -0,0 +1,117 @@
+/**
+ * MCP tool: create_shader
+ *
+ * Creates a GLSL shader in the scene-builder with uniforms that the
+ * choreographer can tween at runtime.
+ */
+import { z } from "zod";
+export declare const name = "create_shader";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    fragmentSource: z.ZodString;
+    vertexSource: z.ZodOptional<z.ZodString>;
+    uniforms: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["float", "int", "bool", "vec2", "vec3", "vec4"]>;
+        control: z.ZodEnum<["slider", "color", "toggle", "xy"]>;
+        value: z.ZodUnion<[z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodNumber, "many">]>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        objectId: z.ZodOptional<z.ZodString>;
+        bind: z.ZodOptional<z.ZodObject<{
+            semantic: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            semantic: string;
+        }, {
+            semantic: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4";
+        control: "slider" | "color" | "toggle" | "xy";
+        value: number | boolean | number[];
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        objectId?: string | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }, {
+        name: string;
+        type: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4";
+        control: "slider" | "color" | "toggle" | "xy";
+        value: number | boolean | number[];
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        objectId?: string | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }>, "many">>;
+    objects: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+    }, {
+        id: string;
+        label: string;
+    }>, "many">>;
+    passes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    fragmentSource: string;
+    uniforms?: {
+        name: string;
+        type: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4";
+        control: "slider" | "color" | "toggle" | "xy";
+        value: number | boolean | number[];
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        objectId?: string | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }[] | undefined;
+    objects?: {
+        id: string;
+        label: string;
+    }[] | undefined;
+    vertexSource?: string | undefined;
+    passes?: number | undefined;
+}, {
+    name: string;
+    fragmentSource: string;
+    uniforms?: {
+        name: string;
+        type: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4";
+        control: "slider" | "color" | "toggle" | "xy";
+        value: number | boolean | number[];
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        objectId?: string | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }[] | undefined;
+    objects?: {
+        id: string;
+        label: string;
+    }[] | undefined;
+    vertexSource?: string | undefined;
+    passes?: number | undefined;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=create-shader.d.ts.map

package/dist/tools/create-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-shader.d.ts","sourceRoot":"","sources":["../../src/tools/create-shader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,eAAO,MAAM,WAAW,QAgCuD,CAAC;AAoChF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BtB,CAAC;AAiBH,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,CAuC7D"}

package/dist/tools/create-shader.js

@@ -0,0 +1,150 @@
+/**
+ * MCP tool: create_shader
+ *
+ * Creates a GLSL shader in the scene-builder with uniforms that the
+ * choreographer can tween at runtime.
+ */
+import { z } from "zod";
+import { addShader } from "../state/mutations.js";
+export const name = "create_shader";
+export const description = "Create a GLSL shader — a visual layer that renders custom fragment/vertex shaders on the sajou scene. " +
+    "Shaders are the most expressive visual primitive: they run per-pixel GPU code every frame.\n\n" +
+    "**Uniforms** are the knobs the choreographer can tween. Declare them in the GLSL source and in the " +
+    "`uniforms` array so the UI and choreographer know about them. Each uniform has a control type " +
+    "(slider, color, toggle, xy) and value range.\n\n" +
+    "**@object grouping**: Use the `objects` array to declare virtual objects (e.g. 'sphere', 'camera'). " +
+    "Then set `objectId` on uniforms to group them under that object in the UI. This is purely organizational.\n\n" +
+    "**@bind semantic**: Set `bind: { semantic: 'intensity' }` on a uniform to connect it to choreographer signals. " +
+    "The choreographer can then tween that uniform in response to agent events.\n\n" +
+    "**Multi-pass**: Set `passes: 2` (or more) for ping-pong feedback effects (e.g. reaction-diffusion, fluid sim). " +
+    "The previous frame is available as `iChannel0`.\n\n" +
+    "**Auto-injected uniforms** (do NOT declare these — they are always available):\n" +
+    "- `iTime` (float) — elapsed time in seconds\n" +
+    "- `iTimeDelta` (float) — time since last frame\n" +
+    "- `iResolution` (vec3) — canvas width, height, pixel ratio\n" +
+    "- `iMouse` (vec4) — mouse position\n" +
+    "- `iFrame` (int) — frame counter\n" +
+    "- `iChannel0` (sampler2D) — previous frame (multi-pass only)\n\n" +
+    "**Minimal example** — animated gradient:\n" +
+    "```glsl\n" +
+    "#version 300 es\n" +
+    "precision highp float;\n" +
+    "in vec2 vUv;\n" +
+    "out vec4 fragColor;\n" +
+    "uniform float uSpeed; // @ui: slider\n" +
+    "void main() {\n" +
+    "  vec3 col = 0.5 + 0.5 * cos(iTime * uSpeed + vUv.xyx + vec3(0,2,4));\n" +
+    "  fragColor = vec4(col, 1.0);\n" +
+    "}\n" +
+    "```\n\n" +
+    "After creating a shader, use `set_uniform` to tweak parameters in real-time, " +
+    "or wire it to the choreographer via `create_wire` (choreographer → shader).";
+const uniformSchema = z.object({
+    name: z
+        .string()
+        .describe("Uniform name as declared in GLSL (e.g. 'uSpeed', 'uColor')."),
+    type: z
+        .enum(["float", "int", "bool", "vec2", "vec3", "vec4"])
+        .describe("GLSL type of the uniform."),
+    control: z
+        .enum(["slider", "color", "toggle", "xy"])
+        .describe("UI control widget. 'slider' for numeric, 'color' for vec3 RGB, " +
+        "'toggle' for bool, 'xy' for vec2 position."),
+    value: z
+        .union([z.number(), z.boolean(), z.array(z.number())])
+        .describe("Initial value. number for float/int, boolean for bool, number[] for vecN."),
+    min: z.number().optional().describe("Minimum value for slider controls. Default: 0."),
+    max: z.number().optional().describe("Maximum value for slider controls. Default: 1."),
+    step: z.number().optional().describe("Step increment for slider controls. Default: 0.01."),
+    objectId: z
+        .string()
+        .optional()
+        .describe("Virtual object ID this uniform belongs to (matches an entry in the objects array)."),
+    bind: z
+        .object({ semantic: z.string().describe("Semantic role: 'intensity', 'position', 'scale', 'rotation', etc.") })
+        .optional()
+        .describe("Choreographer binding hint — connects this uniform to a signal semantic."),
+});
+const objectSchema = z.object({
+    id: z.string().describe("Object identifier (e.g. 'sphere', 'camera')."),
+    label: z.string().describe("Display label in the UI panel."),
+});
+export const inputSchema = z.object({
+    name: z
+        .string()
+        .describe("Display name for the shader (e.g. 'Plasma Background', 'Agent Glow')."),
+    fragmentSource: z
+        .string()
+        .describe("GLSL fragment shader source code (ES 3.0). Must include #version 300 es, " +
+        "precision qualifier, and output to fragColor. Auto-injected uniforms (iTime, etc.) " +
+        "are available without declaring them."),
+    vertexSource: z
+        .string()
+        .optional()
+        .describe("GLSL vertex shader source. If omitted, a default passthrough vertex shader is used " +
+        "that passes UVs to the fragment shader via vUv."),
+    uniforms: z
+        .array(uniformSchema)
+        .optional()
+        .describe("User-defined uniforms exposed in the editor and available to the choreographer."),
+    objects: z
+        .array(objectSchema)
+        .optional()
+        .describe("Virtual objects for grouping related uniforms in the UI."),
+    passes: z
+        .number()
+        .optional()
+        .describe("Number of render passes. 1 = single-pass (default), 2+ = ping-pong feedback."),
+});
+/** Default passthrough vertex shader. */
+const DEFAULT_VERTEX = `#version 300 es
+precision highp float;
+
+in vec3 position;
+in vec2 uv;
+
+out vec2 vUv;
+
+void main() {
+  vUv = uv;
+  gl_Position = vec4(position, 1.0);
+}
+`;
+export async function handler(params) {
+    const shaderId = crypto.randomUUID();
+    const uniformsPayload = (params.uniforms ?? []).map((u) => ({
+        name: u.name,
+        type: u.type,
+        control: u.control,
+        value: u.value,
+        defaultValue: u.value,
+        min: u.min ?? 0,
+        max: u.max ?? 1,
+        step: u.step ?? 0.01,
+        objectId: u.objectId,
+        bind: u.bind,
+    }));
+    addShader({
+        id: shaderId,
+        name: params.name,
+        fragmentSource: params.fragmentSource,
+        vertexSource: params.vertexSource ?? DEFAULT_VERTEX,
+        uniforms: uniformsPayload,
+        objects: params.objects ?? [],
+        passes: params.passes ?? 1,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    shaderId,
+                    hint: `Shader '${params.name}' created with ID ${shaderId}. ` +
+                        `Use set_uniform to tweak parameters, or create_wire to connect it to the choreographer.`,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=create-shader.js.map

package/dist/tools/create-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-shader.js","sourceRoot":"","sources":["../../src/tools/create-shader.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-sketch.d.ts

@@ -0,0 +1,96 @@
+/**
+ * MCP tool: create_sketch
+ *
+ * Creates a p5.js or Three.js sketch in the scene-builder.
+ */
+import { z } from "zod";
+export declare const name = "create_sketch";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    code: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<["p5", "threejs"]>>;
+    params: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<["float", "int", "bool", "vec2", "vec3", "vec4"]>>;
+        control: z.ZodOptional<z.ZodEnum<["slider", "color", "toggle", "xy"]>>;
+        value: z.ZodUnion<[z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodNumber, "many">]>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        bind: z.ZodOptional<z.ZodObject<{
+            semantic: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            semantic: string;
+        }, {
+            semantic: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        value: number | boolean | number[];
+        type?: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4" | undefined;
+        control?: "slider" | "color" | "toggle" | "xy" | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }, {
+        name: string;
+        value: number | boolean | number[];
+        type?: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4" | undefined;
+        control?: "slider" | "color" | "toggle" | "xy" | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }>, "many">>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    code: string;
+    params?: {
+        name: string;
+        value: number | boolean | number[];
+        type?: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4" | undefined;
+        control?: "slider" | "color" | "toggle" | "xy" | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }[] | undefined;
+    mode?: "p5" | "threejs" | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+}, {
+    name: string;
+    code: string;
+    params?: {
+        name: string;
+        value: number | boolean | number[];
+        type?: "float" | "bool" | "int" | "vec2" | "vec3" | "vec4" | undefined;
+        control?: "slider" | "color" | "toggle" | "xy" | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        step?: number | undefined;
+        bind?: {
+            semantic: string;
+        } | undefined;
+    }[] | undefined;
+    mode?: "p5" | "threejs" | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=create-sketch.d.ts.map

package/dist/tools/create-sketch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sketch.d.ts","sourceRoot":"","sources":["../../src/tools/create-sketch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,eAAO,MAAM,WAAW,QAoC8B,CAAC;AA0BvD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BtB,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,CAsC7D"}

package/dist/tools/create-sketch.js

@@ -0,0 +1,130 @@
+/**
+ * MCP tool: create_sketch
+ *
+ * Creates a p5.js or Three.js sketch in the scene-builder.
+ */
+import { z } from "zod";
+import { addP5Sketch } from "../state/mutations.js";
+export const name = "create_sketch";
+export const description = "Create a live-coded sketch — a visual layer that runs JavaScript every frame inside the sajou scene. " +
+    "Sketches support two runtime modes:\n\n" +
+    "**p5.js mode** (`mode: \"p5\"`, default) — instance-mode p5 sketch.\n" +
+    "- The sketch receives a `p` object (p5 instance) with `p.sajou.*` for parameters.\n" +
+    "- Auto-injected params: `_width`, `_height`, `_time`, `_mouse`.\n" +
+    "- Example:\n" +
+    "```js\n" +
+    "// @param: speed, slider, 1.0, 0.1, 5.0\n" +
+    "p.setup = () => p.createCanvas(p.sajou._width, p.sajou._height);\n" +
+    "p.draw = () => {\n" +
+    "  p.background(20);\n" +
+    "  p.circle(p.width/2, p.height/2, 100 * Math.sin(p.sajou._time * p.sajou.speed));\n" +
+    "};\n" +
+    "```\n\n" +
+    "**Three.js mode** (`mode: \"threejs\"`) — `setup(ctx)` / `draw(ctx, state)` API.\n" +
+    "- `ctx.scene`, `ctx.camera`, `ctx.renderer`, `ctx.THREE` — full Three.js access.\n" +
+    "- `ctx.sajou.*` for parameters. Auto-injected: `_width`, `_height`, `_time`, `_deltaTime`, `_mouse`.\n" +
+    "- Example:\n" +
+    "```js\n" +
+    "// @param: radius, slider, 1.0, 0.1, 5.0\n" +
+    "function setup(ctx) {\n" +
+    "  const geo = new ctx.THREE.BoxGeometry(1, 1, 1);\n" +
+    "  const mat = new ctx.THREE.MeshNormalMaterial();\n" +
+    "  ctx.mesh = new ctx.THREE.Mesh(geo, mat);\n" +
+    "  ctx.scene.add(ctx.mesh);\n" +
+    "}\n" +
+    "function draw(ctx, state) {\n" +
+    "  ctx.mesh.rotation.y = ctx.sajou._time;\n" +
+    "  ctx.mesh.scale.setScalar(ctx.sajou.radius);\n" +
+    "}\n" +
+    "```\n\n" +
+    "**Annotations** (parsed from code comments):\n" +
+    "- `// @param: name, control, value, min?, max?, step?` — declare a tweakable parameter.\n" +
+    "- `// @bind: name, semantic` — connect a parameter to choreographer signals.\n\n" +
+    "After creating a sketch, use `set_sketch_param` to tweak parameters in real-time, " +
+    "or wire it to the choreographer via `create_wire`.";
+const paramSchema = z.object({
+    name: z
+        .string()
+        .describe("Parameter name (e.g. 'speed', 'radius')."),
+    type: z
+        .enum(["float", "int", "bool", "vec2", "vec3", "vec4"])
+        .optional()
+        .describe("Parameter type. Default: 'float'."),
+    control: z
+        .enum(["slider", "color", "toggle", "xy"])
+        .optional()
+        .describe("UI control widget. Default: 'slider'."),
+    value: z
+        .union([z.number(), z.boolean(), z.array(z.number())])
+        .describe("Initial value."),
+    min: z.number().optional().describe("Minimum for slider. Default: 0."),
+    max: z.number().optional().describe("Maximum for slider. Default: 1."),
+    step: z.number().optional().describe("Step for slider. Default: 0.01."),
+    bind: z
+        .object({ semantic: z.string().describe("Semantic role: 'intensity', 'position', etc.") })
+        .optional()
+        .describe("Choreographer binding hint."),
+});
+export const inputSchema = z.object({
+    name: z
+        .string()
+        .describe("Display name for the sketch (e.g. 'Particle Field', 'Rotating Cube')."),
+    code: z
+        .string()
+        .describe("JavaScript source code for the sketch. " +
+        "In p5 mode: instance-mode sketch using `p` object. " +
+        "In Three.js mode: must export `setup(ctx)` and/or `draw(ctx, state)` functions."),
+    mode: z
+        .enum(["p5", "threejs"])
+        .optional()
+        .describe("Runtime mode. 'p5' for p5.js instance mode (default), 'threejs' for Three.js setup/draw API."),
+    params: z
+        .array(paramSchema)
+        .optional()
+        .describe("Pre-declared parameters exposed in the editor and available to the choreographer."),
+    width: z
+        .number()
+        .optional()
+        .describe("Canvas width in pixels. 0 = fit container (default)."),
+    height: z
+        .number()
+        .optional()
+        .describe("Canvas height in pixels. 0 = fit container (default)."),
+});
+export async function handler(params) {
+    const sketchId = crypto.randomUUID();
+    const paramsPayload = (params.params ?? []).map((p) => ({
+        name: p.name,
+        type: p.type ?? "float",
+        control: p.control ?? "slider",
+        value: p.value,
+        defaultValue: p.value,
+        min: p.min ?? 0,
+        max: p.max ?? 1,
+        step: p.step ?? 0.01,
+        bind: p.bind,
+    }));
+    addP5Sketch({
+        id: sketchId,
+        name: params.name,
+        source: params.code,
+        mode: params.mode ?? "p5",
+        params: paramsPayload,
+        width: params.width ?? 0,
+        height: params.height ?? 0,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    sketchId,
+                    hint: `Sketch '${params.name}' created with ID ${sketchId}. ` +
+                        `Use set_sketch_param to tweak parameters, or create_wire to connect it to the choreographer.`,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=create-sketch.js.map

package/dist/tools/create-sketch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sketch.js","sourceRoot":"","sources":["../../src/tools/create-sketch.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-wire.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MCP tool: create_wire
+ *
+ * Creates a wire connection between two zones in the sajou patch bay.
+ * Wires define the data flow: signal sources → signal types → choreographies → theme.
+ */
+import { z } from "zod";
+export declare const name = "create_wire";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    fromZone: z.ZodEnum<["signal", "signal-type", "choreographer"]>;
+    fromId: z.ZodString;
+    toZone: z.ZodEnum<["signal-type", "choreographer", "theme", "shader"]>;
+    toId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    toZone: "shader" | "choreographer" | "signal-type" | "theme";
+    toId: string;
+    fromZone: "choreographer" | "signal" | "signal-type";
+    fromId: string;
+}, {
+    toZone: "shader" | "choreographer" | "signal-type" | "theme";
+    toId: string;
+    fromZone: "choreographer" | "signal" | "signal-type";
+    fromId: string;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=create-wire.d.ts.map

package/dist/tools/create-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-wire.d.ts","sourceRoot":"","sources":["../../src/tools/create-wire.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAO4D,CAAC;AAErF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAmCtB,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,CAyC7D"}

package/dist/tools/create-wire.js

@@ -0,0 +1,84 @@
+/**
+ * MCP tool: create_wire
+ *
+ * Creates a wire connection between two zones in the sajou patch bay.
+ * Wires define the data flow: signal sources → signal types → choreographies → theme.
+ */
+import { z } from "zod";
+import { addWire } from "../state/mutations.js";
+export const name = "create_wire";
+export const description = "Create a wire connection in the sajou patch bay. " +
+    "Wires define data flow through 3 layers: " +
+    "(1) signal → signal-type: connects a signal source to a signal channel, " +
+    "(2) signal-type → choreographer: triggers a choreography when that signal type arrives, " +
+    "(3) choreographer → theme: sends choreography output to the theme renderer. " +
+    "Example flow: wire 'local:claude-code' (signal source) → 'tool_call' (signal type) → choreography-id (choreographer). " +
+    "This means: when Claude Code emits a tool_call signal, trigger the choreography.";
+export const inputSchema = z.object({
+    fromZone: z
+        .enum(["signal", "signal-type", "choreographer"])
+        .describe("Source zone. " +
+        "'signal' — a signal source (e.g. 'local:claude-code', a WebSocket source ID). " +
+        "'signal-type' — a signal type channel (e.g. 'tool_call', 'agent_state_change'). " +
+        "'choreographer' — a choreography node (use its ID)."),
+    fromId: z
+        .string()
+        .describe("ID of the source endpoint. " +
+        "For 'signal' zone: the signal source ID (e.g. 'local:claude-code'). " +
+        "For 'signal-type' zone: the signal type name (e.g. 'tool_call'). " +
+        "For 'choreographer' zone: the choreography ID."),
+    toZone: z
+        .enum(["signal-type", "choreographer", "theme", "shader"])
+        .describe("Destination zone. " +
+        "'signal-type' — route a source to a signal type channel. " +
+        "'choreographer' — trigger a choreography from a signal type. " +
+        "'theme' — send choreography output to the theme renderer. " +
+        "'shader' — connect to a shader uniform (format: '{shaderId}:{uniformName}')."),
+    toId: z
+        .string()
+        .describe("ID of the destination endpoint. " +
+        "For 'signal-type' zone: the signal type name. " +
+        "For 'choreographer' zone: the choreography ID. " +
+        "For 'theme' zone: the theme slot name. " +
+        "For 'shader' zone: '{shaderId}:{uniformName}'."),
+});
+export async function handler(params) {
+    // Validate zone flow direction
+    const validFlows = {
+        signal: ["signal-type"],
+        "signal-type": ["choreographer"],
+        choreographer: ["theme", "shader"],
+    };
+    const allowed = validFlows[params.fromZone];
+    if (!allowed?.includes(params.toZone)) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: false,
+                        error: `Invalid wire direction: ${params.fromZone} → ${params.toZone}. ` +
+                            `Valid flows: signal → signal-type, signal-type → choreographer, choreographer → theme/shader.`,
+                    }),
+                },
+            ],
+        };
+    }
+    addWire({
+        fromZone: params.fromZone,
+        fromId: params.fromId,
+        toZone: params.toZone,
+        toId: params.toId,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=create-wire.js.map

package/dist/tools/create-wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-wire.js","sourceRoot":"","sources":["../../src/tools/create-wire.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GACtB,mDAAmD;IACnD,2CAA2C;IAC3C,0EAA0E;IAC1E,0FAA0F;IAC1F,8EAA8E;IAC9E,wHAAwH;IACxH,kFAAkF,CAAC;AAErF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;SAChD,QAAQ,CACP,eAAe;QACf,gFAAgF;QAChF,kFAAkF;QAClF,qDAAqD,CACtD;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CACP,6BAA6B;QAC7B,sEAAsE;QACtE,mEAAmE;QACnE,gDAAgD,CACjD;IACH,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;SACzD,QAAQ,CACP,oBAAoB;QACpB,2DAA2D;QAC3D,+DAA+D;QAC/D,4DAA4D;QAC5D,8EAA8E,CAC/E;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,kCAAkC;QAClC,gDAAgD;QAChD,iDAAiD;QACjD,yCAAyC;QACzC,gDAAgD,CACjD;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,+BAA+B;IAC/B,MAAM,UAAU,GAA6B;QAC3C,MAAM,EAAE,CAAC,aAAa,CAAC;QACvB,aAAa,EAAE,CAAC,eAAe,CAAC;QAChC,aAAa,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;KACnC,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,2BAA2B,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,MAAM,IAAI;4BACtE,+FAA+F;qBAClG,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO,CAAC;QACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,CAAC;IAEH,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"}