@sajou/mcp-server 0.6.0

package/dist/tools/set-uniform.js

@@ -0,0 +1,49 @@
+/**
+ * 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";
+import { setUniform } from "../state/mutations.js";
+export const name = "set_uniform";
+export const description = "Set a uniform value on a GLSL shader in real-time. This is the primary way an AI agent " +
+    "controls shader visuals — tweak a float slider, change a color, toggle an effect, or move " +
+    "a 2D position.\n\n" +
+    "The value type must match the uniform's GLSL 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 make a shader pulse faster, set_uniform({ shaderId: '...', uniformName: 'uSpeed', value: 3.0 }).\n\n" +
+    "Use get_shaders first to discover available uniforms and their value ranges.";
+export const inputSchema = z.object({
+    shaderId: z
+        .string()
+        .describe("ID of the shader containing the uniform."),
+    uniformName: z
+        .string()
+        .describe("Name of the uniform to set (e.g. 'uSpeed', 'uColor', 'uInvert')."),
+    value: z
+        .union([z.number(), z.boolean(), z.array(z.number())])
+        .describe("New value for the uniform. Must match the GLSL type: " +
+        "number for float/int, boolean for bool, number[] for vec2/vec3/vec4."),
+});
+export async function handler(params) {
+    setUniform(params.shaderId, params.uniformName, params.value);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    shaderId: params.shaderId,
+                    uniformName: params.uniformName,
+                    value: params.value,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=set-uniform.js.map

package/dist/tools/set-uniform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-uniform.js","sourceRoot":"","sources":["../../src/tools/set-uniform.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,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GACtB,yFAAyF;IACzF,4FAA4F;IAC5F,oBAAoB;IACpB,sDAAsD;IACtD,mCAAmC;IACnC,iCAAiC;IACjC,mBAAmB;IACnB,mCAAmC;IACnC,2BAA2B;IAC3B,kHAAkH;IAClH,8EAA8E,CAAC;AAEjF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,0CAA0C,CAAC;IACvD,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,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,uDAAuD;QACvD,sEAAsE,CACvE;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9D,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,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,119 @@
+/**
+ * MCP tool: update_shader
+ *
+ * Updates an existing shader's code, uniforms, name, or pass count.
+ */
+import { z } from "zod";
+export declare const name = "update_shader";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    shaderId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    fragmentSource: z.ZodOptional<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, {
+    shaderId: string;
+    name?: string | undefined;
+    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;
+    fragmentSource?: string | undefined;
+    passes?: number | undefined;
+}, {
+    shaderId: string;
+    name?: string | undefined;
+    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;
+    fragmentSource?: string | undefined;
+    passes?: number | undefined;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=update-shader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-shader.d.ts","sourceRoot":"","sources":["../../src/tools/update-shader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC,eAAO,MAAM,WAAW,QAGmD,CAAC;AAsB5E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,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,CAqC7D"}

package/dist/tools/update-shader.js

@@ -0,0 +1,81 @@
+/**
+ * MCP tool: update_shader
+ *
+ * Updates an existing shader's code, uniforms, name, or pass count.
+ */
+import { z } from "zod";
+import { updateShader } from "../state/mutations.js";
+export const name = "update_shader";
+export const description = "Update an existing GLSL shader. You can change the fragment/vertex source code, " +
+    "uniforms, name, or pass count. Only provided fields are updated — omitted fields " +
+    "keep their current values. Use get_shaders first to find the shader ID.";
+const uniformSchema = z.object({
+    name: z.string().describe("Uniform name as declared in GLSL."),
+    type: z.enum(["float", "int", "bool", "vec2", "vec3", "vec4"]).describe("GLSL type."),
+    control: z.enum(["slider", "color", "toggle", "xy"]).describe("UI control widget."),
+    value: z.union([z.number(), z.boolean(), z.array(z.number())]).describe("Current 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."),
+    objectId: z.string().optional().describe("Virtual object ID for grouping."),
+    bind: z
+        .object({ semantic: z.string() })
+        .optional()
+        .describe("Choreographer binding hint."),
+});
+const objectSchema = z.object({
+    id: z.string().describe("Object identifier."),
+    label: z.string().describe("Display label."),
+});
+export const inputSchema = z.object({
+    shaderId: z
+        .string()
+        .describe("ID of the shader to update (from create_shader or get_shaders)."),
+    name: z.string().optional().describe("New display name."),
+    fragmentSource: z.string().optional().describe("New fragment shader GLSL source."),
+    vertexSource: z.string().optional().describe("New vertex shader GLSL source."),
+    uniforms: z.array(uniformSchema).optional().describe("Replace the full uniforms list."),
+    objects: z.array(objectSchema).optional().describe("Replace the full objects list."),
+    passes: z.number().optional().describe("New pass count."),
+});
+export async function handler(params) {
+    const { shaderId, ...fields } = params;
+    const data = {};
+    if (fields.name !== undefined)
+        data["name"] = fields.name;
+    if (fields.fragmentSource !== undefined)
+        data["fragmentSource"] = fields.fragmentSource;
+    if (fields.vertexSource !== undefined)
+        data["vertexSource"] = fields.vertexSource;
+    if (fields.passes !== undefined)
+        data["passes"] = fields.passes;
+    if (fields.uniforms !== undefined) {
+        data["uniforms"] = fields.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,
+        }));
+    }
+    if (fields.objects !== undefined)
+        data["objects"] = fields.objects;
+    updateShader(shaderId, data);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    shaderId,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=update-shader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-shader.js","sourceRoot":"","sources":["../../src/tools/update-shader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GACtB,kFAAkF;IAClF,mFAAmF;IACnF,yEAAyE,CAAC;AAE5E,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IACrF,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACnF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACzF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC3E,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACzD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAClF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACvF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IAEvC,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1D,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;QAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;IACxF,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;QAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;IAClF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAChE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,YAAY,EAAE,CAAC,CAAC,KAAK;YACrB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;YACf,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;YACf,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;IACN,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IAEnE,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE7B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,QAAQ;iBACT,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,99 @@
+/**
+ * MCP tool: update_sketch
+ *
+ * Updates an existing sketch's code, params, name, mode, or dimensions.
+ */
+import { z } from "zod";
+export declare const name = "update_sketch";
+export declare const description: string;
+export declare const inputSchema: z.ZodObject<{
+    sketchId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<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, {
+    sketchId: string;
+    name?: string | undefined;
+    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;
+    code?: string | undefined;
+}, {
+    sketchId: string;
+    name?: string | undefined;
+    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;
+    code?: string | undefined;
+}>;
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=update-sketch.d.ts.map

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

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

package/dist/tools/update-sketch.js

@@ -0,0 +1,75 @@
+/**
+ * MCP tool: update_sketch
+ *
+ * Updates an existing sketch's code, params, name, mode, or dimensions.
+ */
+import { z } from "zod";
+import { updateP5Sketch } from "../state/mutations.js";
+export const name = "update_sketch";
+export const description = "Update an existing sketch. You can change the source code, parameters, name, mode, " +
+    "or dimensions. Only provided fields are updated — omitted fields keep their current values. " +
+    "Use get_sketches first to find the sketch ID.";
+const paramSchema = z.object({
+    name: z.string().describe("Parameter name."),
+    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("Current 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() })
+        .optional()
+        .describe("Choreographer binding hint."),
+});
+export const inputSchema = z.object({
+    sketchId: z
+        .string()
+        .describe("ID of the sketch to update (from create_sketch or get_sketches)."),
+    name: z.string().optional().describe("New display name."),
+    code: z.string().optional().describe("New JavaScript source code."),
+    mode: z.enum(["p5", "threejs"]).optional().describe("New runtime mode."),
+    params: z.array(paramSchema).optional().describe("Replace the full params list."),
+    width: z.number().optional().describe("New canvas width. 0 = fit container."),
+    height: z.number().optional().describe("New canvas height. 0 = fit container."),
+});
+export async function handler(params) {
+    const { sketchId, ...fields } = params;
+    const data = {};
+    if (fields.name !== undefined)
+        data["name"] = fields.name;
+    if (fields.code !== undefined)
+        data["source"] = fields.code;
+    if (fields.mode !== undefined)
+        data["mode"] = fields.mode;
+    if (fields.width !== undefined)
+        data["width"] = fields.width;
+    if (fields.height !== undefined)
+        data["height"] = fields.height;
+    if (fields.params !== undefined) {
+        data["params"] = fields.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,
+        }));
+    }
+    updateP5Sketch(sketchId, data);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    sketchId,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=update-sketch.js.map

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

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@sajou/mcp-server",
+  "version": "0.6.0",
+  "description": "MCP server for sajou — lets AI agents interact with the visual choreographer via Model Context Protocol",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "sajou-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/sajou-mcp.cjs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sajou-dev/sajou",
+    "directory": "packages/mcp-server"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai-agents",
+    "sajou"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "express": "^5.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "typecheck": "tsc --noEmit",
+    "start": "tsx src/index.ts"
+  }
+}