@miadi/stateloom-mcp 0.4.0 → 0.4.1

package/dist/server.js

@@ -83,8 +83,11 @@ const BRIDGE_TOKEN = envAlias("BRIDGE_TOKEN");
 // The canvas address for a document (chart_1785683055671): when the agent
 // re-points the loom, the human gets a link to LOOK at the same document —
 // the `?doc=` parameter is resolved and allowlist-guarded by the web side.
+// With the system that lists it, the link opens the drawing as its member, so
+// the system strip leads back to the map. The canvas looks the system up when
+// the link has none, but only near the drawing; the link names one it would miss.
 const CANVAS_URL = envAlias("CANVAS_URL") ?? `http://127.0.0.1:${envAlias("WEB_PORT") ?? "4598"}`;
-const canvasLink = (path) => `${CANVAS_URL}/?doc=${encodeURIComponent(path)}`;
+const canvasLink = (path, system) => `${CANVAS_URL}/?doc=${encodeURIComponent(path)}${system ? `&system=${encodeURIComponent(system)}` : ""}`;
 // ─── File-backed shared store ────────────────────────────────────────
 // Both web/ and mcp/ resolve the same path from STATELOOM_PROJECT_FILE
 // (legacy twin SMCRAFT_PROJECT_FILE still honored).
@@ -1254,7 +1257,7 @@ function buildServer() {
             return { id: name.toLowerCase().replace(/[^a-z0-9._-]+/g, "-"), name, role: "agent" };
         },
         lastSystem: () => LAST_SYSTEM,
-        canvasUrl: (doc) => canvasLink(doc),
+        canvasUrl: (doc, system) => canvasLink(doc, system),
     };
     registerStageTools(server, stageHost);
     // Notes — the same two tools for either document type.

package/dist/stage.d.ts

@@ -38,7 +38,7 @@ export interface StageHost {
     agent(): MarkAuthor;
     /** The system this server last created, set or checked. */
     lastSystem(): string | undefined;
-    /** A canvas link for a drawing, for the person. */
-    canvasUrl(doc: string): string;
+    /** A canvas link for a drawing, for the person; inside `system` when given. */
+    canvasUrl(doc: string, system?: string): string;
 }
 export declare function registerStageTools(server: McpServer, host: StageHost): void;

package/dist/stage.js

@@ -154,7 +154,7 @@ export function registerStageTools(server, host) {
             .filter(Boolean)
             .join(" · ");
         return sent.ok
-            ? ok(`On stage '${st}': ${what}${missing}. ${sent.text}. The person sees it at ${host.canvasUrl(doc)}.`)
+            ? ok(`On stage '${st}': ${what}${missing}. ${sent.text}. The person sees it at ${host.canvasUrl(doc, step.system)}.`)
             : fail(`Could not show ${what} on stage '${st}': ${sent.text}.`);
     });
     server.tool("write_tour", "Write a walkthrough as a file (<name>.tour.json, Spec 83): an ordered list of steps — each a drawing, what to light in it, and what to say — that the canvas plays back with its own controls, like slides over the real drawings. Prepare one when the work needs explaining in an order, when the person will review it later, or when an unfinished session hands its design on. Step `doc` paths are given absolute or relative to the active document's folder, and stored relative to the tour file; a step without `doc` stays on the previous step's drawing. Without `path` the tour lands beside the active document. Checked T001–T009; play it with play_tour.", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/stateloom-mcp",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "MCP server for miadi-stateloom (formerly smcraft-mcp) — lets LLM agents design state machines through conversation",
   "repository": {
     "type": "git",
@@ -38,9 +38,9 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@miadi/stateloom-cli": "^0.1.5",
+    "@miadi/stateloom-cli": "^0.1.7",
     "@miadi/stateloom-client": "^0.1.4",
-    "@miadi/stateloom-protocol": "^0.1.15",
+    "@miadi/stateloom-protocol": "^0.1.16",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^4.3.6"
   },