@sajou/mcp-server 0.6.0

package/dist/tools/describe-scene.d.ts

@@ -0,0 +1,22 @@
+/**
+ * describe_scene tool — comprehensive human/AI-readable scene description.
+ *
+ * This is the first tool an AI agent should call to understand the current
+ * scene. It reads all state from the store and produces a structured text
+ * summary of entities, choreographies, signal sources, bindings, and wiring.
+ */
+import { z } from "zod";
+/** Tool name. */
+export declare const name = "describe_scene";
+/** 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 — reads all state from the store and builds a text description. */
+export declare function handler(): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=describe-scene.d.ts.map

package/dist/tools/describe-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-scene.d.ts","sourceRoot":"","sources":["../../src/tools/describe-scene.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,iBAAiB;AACjB,eAAO,MAAM,IAAI,mBAAmB,CAAC;AAErC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAIwC,CAAC;AAEjE,2CAA2C;AAC3C,eAAO,MAAM,WAAW,gDAAe,CAAC;AAyDxC,mFAAmF;AACnF,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,CA0ID"}

package/dist/tools/describe-scene.js

@@ -0,0 +1,194 @@
+/**
+ * describe_scene tool — comprehensive human/AI-readable scene description.
+ *
+ * This is the first tool an AI agent should call to understand the current
+ * scene. It reads all state from the store and produces a structured text
+ * summary of entities, choreographies, signal sources, bindings, and wiring.
+ */
+import { z } from "zod";
+import { getSceneSnapshot, getChoreographies, getBindings, getSignalSources, getWiring, getEditor, } from "../state/store.js";
+/** Tool name. */
+export const name = "describe_scene";
+/** Tool description shown to the AI agent. */
+export const description = "Get a comprehensive, human-readable description of the current sajou scene. " +
+    "Returns a structured summary of all placed entities, choreographies, signal " +
+    "sources, bindings, and wiring. This is the best first tool to call to " +
+    "understand what the scene contains and how it is configured.";
+/** Input schema — no parameters needed. */
+export const inputSchema = z.object({});
+/** Format an entity for the description. */
+function describeEntity(e) {
+    const label = e["semanticId"] ? `"${e["semanticId"]}" (${e["entityId"]})` : e["entityId"];
+    const pos = `at (${Math.round(e["x"])}, ${Math.round(e["y"])})`;
+    const vis = e["visible"] ? "" : " [hidden]";
+    const lock = e["locked"] ? " [locked]" : "";
+    const topology = e["topology"];
+    const topo = topology
+        ? `, topology: home=${topology["home"] ?? "none"}, waypoints=[${(topology["waypoints"] ?? []).join(", ")}]`
+        : "";
+    return `  - ${label} ${pos}${vis}${lock}, layer=${e["layerId"]}, state=${e["activeState"]}${topo}`;
+}
+/** Format a choreography for the description. */
+function describeChoreography(c) {
+    const wiredSignalTypes = (c["wiredSignalTypes"] ?? []);
+    const trigger = wiredSignalTypes.length > 0
+        ? `wired to: [${wiredSignalTypes.join(", ")}]`
+        : `on: "${c["on"]}"`;
+    const when = c["when"] ? `, when: ${JSON.stringify(c["when"])}` : "";
+    const target = c["defaultTargetEntityId"] ? `, default target: "${c["defaultTargetEntityId"]}"` : "";
+    const stepCount = c["stepCount"];
+    const stepTypes = (c["stepTypes"] ?? []);
+    const steps = stepCount > 0
+        ? `, ${stepCount} steps: [${stepTypes.join(" → ")}]`
+        : ", no steps";
+    const sources = (c["sources"] ?? []);
+    const sourcesStr = sources.length > 0
+        ? `\n    sources: ${sources.map((s) => `${s["sourceId"]} via "${s["signalType"]}"`).join(", ")}`
+        : "";
+    return `  - ${c["id"]}: ${trigger}${when}${target}${steps}${sourcesStr}`;
+}
+/** Format a binding for the description. */
+function describeBinding(b) {
+    const mapping = b["mapping"] ? `, mapping: ${JSON.stringify(b["mapping"])}` : "";
+    const action = b["action"] ? `, action: ${JSON.stringify(b["action"])}` : "";
+    const field = b["sourceField"] ? `, field: "${b["sourceField"]}"` : "";
+    const transition = b["transition"] ? `, transition: ${JSON.stringify(b["transition"])}` : "";
+    return `  - "${b["targetEntityId"]}".${b["property"]} ← choreo "${b["sourceChoreographyId"]}" (${b["sourceType"]})${field}${mapping}${transition}${action}`;
+}
+/** Format a signal source for the description. */
+function describeSource(s) {
+    const statusStr = s["status"];
+    const status = statusStr === "connected" ? "CONNECTED" : statusStr.toUpperCase();
+    const err = s["error"] ? ` (error: ${s["error"]})` : "";
+    return `  - ${s["name"]} [${s["protocol"]}] ${status}${err} — ${s["category"]}`;
+}
+/** Format a wire for the description. */
+function describeWire(w) {
+    return `  - ${w["fromZone"]}:${w["fromId"]} → ${w["toZone"]}:${w["toId"]}`;
+}
+/** Tool handler — reads all state from the store and builds a text description. */
+export async function handler() {
+    // Read all state synchronously from the store
+    const sceneState = getSceneSnapshot();
+    const choreosState = getChoreographies();
+    const bindingsState = getBindings();
+    const sourcesState = getSignalSources();
+    const wiringState = getWiring();
+    const editor = getEditor();
+    const entities = (sceneState["entities"] ?? []);
+    const positions = (sceneState["positions"] ?? []);
+    const routes = (sceneState["routes"] ?? []);
+    const rawChoreos = (choreosState["choreographies"] ?? []);
+    const bindings = (bindingsState["bindings"] ?? []);
+    const sources = (sourcesState["sources"] ?? []);
+    const wires = (wiringState["wires"] ?? []);
+    // Enrich choreographies with wiring info
+    const enrichedChoreos = rawChoreos.map((c) => {
+        const id = c["id"];
+        const steps = (c["steps"] ?? []);
+        const incomingWires = wires.filter((w) => w["toZone"] === "choreographer" && w["toId"] === id);
+        const wiredSignalTypes = incomingWires
+            .filter((w) => w["fromZone"] === "signal-type")
+            .map((w) => w["fromId"]);
+        const choreoSources = [];
+        for (const signalType of wiredSignalTypes) {
+            const sourceWires = wires.filter((w) => w["fromZone"] === "signal" && w["toZone"] === "signal-type" && w["toId"] === signalType);
+            for (const sw of sourceWires) {
+                choreoSources.push({
+                    sourceId: sw["fromId"],
+                    signalType,
+                });
+            }
+        }
+        return {
+            ...c,
+            stepCount: steps.length,
+            stepTypes: steps.map((s) => s["action"]),
+            wiredSignalTypes,
+            sources: choreoSources,
+        };
+    });
+    // Build the description
+    const lines = [];
+    // Scene overview
+    lines.push("# Scene Description");
+    lines.push("");
+    const d = sceneState["dimensions"];
+    lines.push(`## Canvas: ${d?.["width"] ?? "?"}×${d?.["height"] ?? "?"} px, mode: ${editor["mode"] ?? "unknown"}, view: ${editor["viewMode"] ?? "unknown"}`);
+    lines.push("");
+    // Entities
+    if (entities.length > 0) {
+        lines.push(`## Entities (${entities.length})`);
+        for (const e of entities) {
+            lines.push(describeEntity(e));
+        }
+    }
+    else {
+        lines.push("## Entities: none placed");
+    }
+    lines.push("");
+    // Positions
+    if (positions.length > 0) {
+        lines.push(`## Positions (${positions.length})`);
+        for (const p of positions) {
+            lines.push(`  - "${p["name"]}" at (${Math.round(p["x"])}, ${Math.round(p["y"])}), type=${p["typeHint"]}${p["entityBinding"] ? `, bound to "${p["entityBinding"]}"` : ""}`);
+        }
+        lines.push("");
+    }
+    // Routes
+    if (routes.length > 0) {
+        lines.push(`## Routes (${routes.length})`);
+        for (const r of routes) {
+            const points = (r["points"] ?? []);
+            lines.push(`  - "${r["name"]}" (${points.length} points, ${r["style"]}, ${r["bidirectional"] ? "bidirectional" : "one-way"})`);
+        }
+        lines.push("");
+    }
+    // Choreographies
+    if (enrichedChoreos.length > 0) {
+        lines.push(`## Choreographies (${enrichedChoreos.length})`);
+        for (const c of enrichedChoreos) {
+            lines.push(describeChoreography(c));
+        }
+    }
+    else {
+        lines.push("## Choreographies: none defined");
+    }
+    lines.push("");
+    // Signal sources
+    if (sources.length > 0) {
+        lines.push(`## Signal Sources (${sources.length})`);
+        for (const s of sources) {
+            lines.push(describeSource(s));
+        }
+    }
+    else {
+        lines.push("## Signal Sources: none configured");
+    }
+    lines.push("");
+    // Bindings
+    if (bindings.length > 0) {
+        lines.push(`## Bindings (${bindings.length})`);
+        for (const b of bindings) {
+            lines.push(describeBinding(b));
+        }
+    }
+    else {
+        lines.push("## Bindings: none");
+    }
+    lines.push("");
+    // Wiring
+    if (wires.length > 0) {
+        lines.push(`## Wiring (${wires.length} connections)`);
+        for (const w of wires) {
+            lines.push(describeWire(w));
+        }
+    }
+    else {
+        lines.push("## Wiring: no connections");
+    }
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+}
+//# sourceMappingURL=describe-scene.js.map

package/dist/tools/describe-scene.js.map

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

package/dist/tools/emit-signal.d.ts

@@ -0,0 +1,36 @@
+/**
+ * emit_signal tool — sends a signal to the scene-builder via the bridge.
+ *
+ * This is the primary runtime tool: the agent emits signals and sajou
+ * translates them into choreographed animations.
+ */
+import { z } from "zod";
+/** Tool name. */
+export declare const name = "emit_signal";
+/** Tool description shown to the AI agent. */
+export declare const description: string;
+/** Input schema validated by the MCP SDK via Zod. */
+export declare const inputSchema: z.ZodObject<{
+    type: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodOptional<z.ZodString>;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    from: string;
+    payload?: Record<string, unknown> | undefined;
+    to?: string | undefined;
+}, {
+    type: string;
+    from: string;
+    payload?: Record<string, unknown> | undefined;
+    to?: string | undefined;
+}>;
+/** Tool handler — called when the agent invokes emit_signal. */
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=emit-signal.d.ts.map

package/dist/tools/emit-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-signal.d.ts","sourceRoot":"","sources":["../../src/tools/emit-signal.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,QAGC,CAAC;AAE1B,qDAAqD;AACrD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAiBtB,CAAC;AAEH,gEAAgE;AAChE,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,CA2B7D"}

package/dist/tools/emit-signal.js

@@ -0,0 +1,60 @@
+/**
+ * emit_signal tool — sends a signal to the scene-builder via the bridge.
+ *
+ * This is the primary runtime tool: the agent emits signals and sajou
+ * translates them into choreographed animations.
+ */
+import { z } from "zod";
+import { broadcastSignal, getSignalClientCount } from "../routes/signals.js";
+/** Tool name. */
+export const name = "emit_signal";
+/** Tool description shown to the AI agent. */
+export const description = "Emit a signal to the sajou scene. Signals trigger choreographies that animate entities. " +
+    "Use well-known types (task_dispatch, tool_call, tool_result, agent_state_change, error, completion) " +
+    "or any custom string.";
+/** Input schema validated by the MCP SDK via Zod. */
+export const inputSchema = z.object({
+    type: z
+        .string()
+        .describe("Signal type. Well-known: task_dispatch, tool_call, tool_result, token_usage, agent_state_change, error, completion, text_delta, thinking. Custom types are also accepted."),
+    from: z
+        .string()
+        .describe("Entity ID of the signal sender (e.g. 'orchestrator', 'agent-1')."),
+    to: z
+        .string()
+        .optional()
+        .describe("Entity ID of the signal receiver, if applicable."),
+    payload: z
+        .record(z.unknown())
+        .optional()
+        .describe("Additional payload data for the signal."),
+});
+/** Tool handler — called when the agent invokes emit_signal. */
+export async function handler(params) {
+    const payload = { ...params.payload };
+    if (params.from)
+        payload["from"] = params.from;
+    if (params.to)
+        payload["to"] = params.to;
+    const envelope = {
+        id: crypto.randomUUID(),
+        type: params.type,
+        source: "mcp",
+        timestamp: Date.now(),
+        payload,
+    };
+    broadcastSignal(JSON.stringify(envelope));
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    signal_id: envelope.id,
+                    ok: true,
+                    clients: getSignalClientCount(),
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=emit-signal.js.map

package/dist/tools/emit-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-signal.js","sourceRoot":"","sources":["../../src/tools/emit-signal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,iBAAiB;AACjB,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GACtB,0FAA0F;IAC1F,sGAAsG;IACtG,uBAAuB,CAAC;AAE1B,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,2KAA2K,CAC5K;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;CACvD,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,MAAM,OAAO,GAA4B,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/D,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/C,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IAEzC,MAAM,QAAQ,GAAG;QACf,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,OAAO;KACR,CAAC;IAEF,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,SAAS,EAAE,QAAQ,CAAC,EAAE;oBACtB,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,oBAAoB,EAAE;iBAChC,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * get_catalog tool — returns entity catalog for a theme.
+ *
+ * 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 = "get_catalog";
+/** Tool description shown to the AI agent. */
+export declare const description: string;
+/** Input schema. */
+export declare const inputSchema: z.ZodObject<{
+    theme: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    theme: string;
+}, {
+    theme: string;
+}>;
+/** Tool handler — returns stub until theme catalog is implemented. */
+export declare function handler(params: z.infer<typeof inputSchema>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=get-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/get-catalog.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,QAG2B,CAAC;AAEpD,oBAAoB;AACpB,eAAO,MAAM,WAAW;;;;;;EAItB,CAAC;AAEH,sEAAsE;AACtE,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/get-catalog.js

@@ -0,0 +1,37 @@
+/**
+ * get_catalog tool — returns entity catalog for a theme.
+ *
+ * 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 = "get_catalog";
+/** Tool description shown to the AI agent. */
+export const description = "Get the entity catalog for a theme. " +
+    "NOTE: Theme catalog is under development. Use get_scene_state to see " +
+    "entities in the currently loaded scene instead.";
+/** Input schema. */
+export const inputSchema = z.object({
+    theme: z
+        .string()
+        .describe("Theme ID to get the catalog for."),
+});
+/** Tool handler — returns stub until theme catalog is implemented. */
+export async function handler(params) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    status: "not_yet_available",
+                    theme: params.theme,
+                    message: "Theme catalog is under development. Use get_scene_state to see " +
+                        "entities in the currently loaded scene.",
+                    catalog: {},
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-catalog.js","sourceRoot":"","sources":["../../src/tools/get-catalog.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,sCAAsC;IACtC,uEAAuE;IACvE,iDAAiD,CAAC;AAEpD,oBAAoB;AACpB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,kCAAkC,CAAC;CAChD,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAmC;IAEnC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,MAAM,EAAE,mBAAmB;oBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,OAAO,EACL,iEAAiE;wBACjE,yCAAyC;oBAC3C,OAAO,EAAE,EAAE;iBACZ,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * get_choreographies tool — lists choreographies defined in the current scene.
+ *
+ * Reads the server-authoritative state directly. Returns all
+ * choreography definitions with their signal triggers, steps, and wiring info.
+ */
+import { z } from "zod";
+/** Tool name. */
+export declare const name = "get_choreographies";
+/** 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 — reads choreographies from the store and enriches with wiring. */
+export declare function handler(): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=get-choreographies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-choreographies.d.ts","sourceRoot":"","sources":["../../src/tools/get-choreographies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iBAAiB;AACjB,eAAO,MAAM,IAAI,uBAAuB,CAAC;AAEzC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAI6B,CAAC;AAEtD,2CAA2C;AAC3C,eAAO,MAAM,WAAW,gDAAe,CAAC;AAExC,mFAAmF;AACnF,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,CA6DD"}

package/dist/tools/get-choreographies.js

@@ -0,0 +1,70 @@
+/**
+ * get_choreographies tool — lists choreographies defined in the current scene.
+ *
+ * Reads the server-authoritative state directly. Returns all
+ * choreography definitions with their signal triggers, steps, and wiring info.
+ */
+import { z } from "zod";
+import { getChoreographies, getWiring } from "../state/store.js";
+/** Tool name. */
+export const name = "get_choreographies";
+/** Tool description shown to the AI agent. */
+export const description = "List all choreographies in the current scene. Returns each choreography's " +
+    "trigger signal type, when-conditions, step count, step types, and wiring " +
+    "info (which signal sources feed into it). Use this to understand what " +
+    "animations are available before emitting signals.";
+/** Input schema — no parameters needed. */
+export const inputSchema = z.object({});
+/** Tool handler — reads choreographies from the store and enriches with wiring. */
+export async function handler() {
+    const choreosState = getChoreographies();
+    const wiringState = getWiring();
+    const rawChoreos = (choreosState["choreographies"] ?? []);
+    const wires = (wiringState["wires"] ?? []);
+    // Enrich choreographies with wiring info
+    const choreographies = rawChoreos.map((c) => {
+        const id = c["id"];
+        const steps = (c["steps"] ?? []);
+        // Find wires targeting this choreography
+        const incomingWires = wires.filter((w) => w["toZone"] === "choreographer" && w["toId"] === id);
+        // Signal types wired to this choreography
+        const wiredSignalTypes = incomingWires
+            .filter((w) => w["fromZone"] === "signal-type")
+            .map((w) => w["fromId"]);
+        // Sources feeding into this choreography (via signal-type wires)
+        const sources = [];
+        for (const signalType of wiredSignalTypes) {
+            const sourceWires = wires.filter((w) => w["fromZone"] === "signal" && w["toZone"] === "signal-type" && w["toId"] === signalType);
+            for (const sw of sourceWires) {
+                sources.push({
+                    sourceId: sw["fromId"],
+                    signalType,
+                });
+            }
+        }
+        return {
+            id,
+            on: c["on"],
+            when: c["when"] ?? null,
+            interrupts: c["interrupts"] ?? false,
+            defaultTargetEntityId: c["defaultTargetEntityId"] ?? null,
+            stepCount: steps.length,
+            stepTypes: steps.map((s) => s["action"]),
+            wiredSignalTypes,
+            sources,
+        };
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    choreographies,
+                    count: choreographies.length,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-choreographies.js.map

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

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

package/dist/tools/get-scene-state.d.ts

@@ -0,0 +1,21 @@
+/**
+ * get_scene_state tool — returns the current scene state from the store.
+ *
+ * Reads the server-authoritative state directly. Returns all placed
+ * entities with their positions, topology, and scene metadata.
+ */
+import { z } from "zod";
+/** Tool name. */
+export declare const name = "get_scene_state";
+/** 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 — reads scene state from the store. */
+export declare function handler(): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=get-scene-state.d.ts.map

package/dist/tools/get-scene-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-scene-state.d.ts","sourceRoot":"","sources":["../../src/tools/get-scene-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,iBAAiB;AACjB,eAAO,MAAM,IAAI,oBAAoB,CAAC;AAEtC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAIkC,CAAC;AAE3D,2CAA2C;AAC3C,eAAO,MAAM,WAAW,gDAAe,CAAC;AAExC,uDAAuD;AACvD,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,CA8BD"}

package/dist/tools/get-scene-state.js

@@ -0,0 +1,48 @@
+/**
+ * get_scene_state tool — returns the current scene state from the store.
+ *
+ * Reads the server-authoritative state directly. Returns all placed
+ * entities with their positions, topology, and scene metadata.
+ */
+import { z } from "zod";
+import { getSceneSnapshot, getEditor } from "../state/store.js";
+/** Tool name. */
+export const name = "get_scene_state";
+/** Tool description shown to the AI agent. */
+export const description = "Get the current state of the sajou scene. Returns all placed entities with " +
+    "their id, semanticId, asset type, position, visibility, and topology. Also " +
+    "includes scene dimensions, positions, routes, layers, and current editor mode. " +
+    "Use this to inspect the scene before emitting signals.";
+/** Input schema — no parameters needed. */
+export const inputSchema = z.object({});
+/** Tool handler — reads scene state from the store. */
+export async function handler() {
+    const sceneState = getSceneSnapshot();
+    const editor = getEditor();
+    const entities = (sceneState["entities"] ?? []);
+    const positions = (sceneState["positions"] ?? []);
+    const routes = (sceneState["routes"] ?? []);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: true,
+                    dimensions: sceneState["dimensions"],
+                    background: sceneState["background"],
+                    layers: sceneState["layers"],
+                    entities,
+                    positions,
+                    routes,
+                    zoneTypes: sceneState["zoneTypes"],
+                    mode: editor["mode"] ?? null,
+                    viewMode: editor["viewMode"] ?? null,
+                    entityCount: entities.length,
+                    positionCount: positions.length,
+                    routeCount: routes.length,
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-scene-state.js.map

package/dist/tools/get-scene-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-scene-state.js","sourceRoot":"","sources":["../../src/tools/get-scene-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhE,iBAAiB;AACjB,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAEtC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GACtB,6EAA6E;IAC7E,6EAA6E;IAC7E,iFAAiF;IACjF,wDAAwD,CAAC;AAE3D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAExC,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,OAAO;IAG3B,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAmC,CAAC;IAClF,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAmC,CAAC;IACpF,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;IAE9E,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,EAAE,EAAE,IAAI;oBACR,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC;oBACpC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC;oBACpC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;oBAC5B,QAAQ;oBACR,SAAS;oBACT,MAAM;oBACN,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC;oBAClC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI;oBAC5B,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI;oBACpC,WAAW,EAAE,QAAQ,CAAC,MAAM;oBAC5B,aAAa,EAAE,SAAS,CAAC,MAAM;oBAC/B,UAAU,EAAE,MAAM,CAAC,MAAM;iBAC1B,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * MCP tool: get_shaders
+ *
+ * Lists all shader definitions with full details (code, uniforms, objects).
+ */
+import { z } from "zod";
+export declare const name = "get_shaders";
+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-shaders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-shaders.d.ts","sourceRoot":"","sources":["../../src/tools/get-shaders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAG2D,CAAC;AAEpF,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,CAyBD"}