@walkeros/mcp 4.7.2 → 4.8.0-next-1791496487198

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkeros/mcp",
-  "version": "4.7.2",
+  "version": "4.8.0-next-1791496487198",
   "description": "MCP server for walkerOS flow development - discover packages, scaffold configs, validate, bundle, simulate, and test event pipelines",
   "license": "MIT",
   "type": "module",
@@ -37,15 +37,15 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@walkeros/cli": "4.7.2",
-    "@walkeros/core": "4.7.2"
+    "@walkeros/cli": "4.8.0-next-1791496487198",
+    "@walkeros/core": "4.8.0-next-1791496487198"
   },
   "peerDependencies": {
     "zod": "^4.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
-    "@walkeros/config": "4.7.2",
+    "@walkeros/config": "4.8.0-next-1791496487198",
     "msw": "^2.12.10"
   },
   "repository": {

package/src/surface.json

@@ -312,7 +312,7 @@
   "frameManage": {
     "name": "frame_manage",
     "title": "Frames",
-    "description": "Read the frames of a measurement plan: named rectangles with marks inside them, drawn in Tag Mode or in the app. Actions: list (every frame of the project, without marks), page (the frames of one page at any depth, with marks), get (one frame with its marks). Read-only: frames are drawn and edited in Tag Mode or the app, never here. A frame name is documentation; the marks inside it carry the meaning. A frame that extends another stores only what it adds, so its tags may carry only the fields they change. Marks are { tags, note }: tags is one flat list of tags, each with an id, a kind such as entity, property or action, a name, and a parentId naming the tag it sits under; note is the frame’s own description and thread. Use hub_manage action \"knowledge\" with a frameId or markId to read what people wrote on a frame. A markId is a tag id: a tag’s id, parentId and threadRef come back literal when they have the shape the app mints, so they can be passed straight back; every other string value in the marks is wrapped as data, and so is an object key that is not a plain identifier.",
+    "description": "Read the frames of a measurement plan: named rectangles with marks inside them, drawn in Tag Mode or in the app. Frames belong to a flow: every action takes the flowId of the flow they live in; use flow_manage action \"list\" to find one. Actions: list (every frame of the flow, without marks), page (the flow’s frames on one page at any depth, with marks), get (one frame with its marks). Read-only: frames are drawn and edited in Tag Mode or the app, never here. A frame name is documentation; the marks inside it carry the meaning. A frame that extends another stores only what it adds, so its tags may carry only the fields they change. Marks are { tags, note }: tags is one flat list of tags, each with an id, a kind such as entity, property or action, a name, and a parentId naming the tag it sits under; note is the frame’s own description and thread. Use hub_manage action \"knowledge\" with a frameId or markId to read what people wrote on a frame. A markId is a tag id: a tag’s id, parentId and threadRef come back literal when they have the shape the app mints, so they can be passed straight back; every other string value in the marks is wrapped as data, and so is an object key that is not a plain identifier.",
     "annotations": {
       "readOnlyHint": true,
       "destructiveHint": false,
@@ -326,12 +326,16 @@
         "action": {
           "type": "string",
           "enum": ["list", "page", "get"],
-          "description": "list the project’s frames, read one page with marks, or read one frame"
+          "description": "list the flow’s frames, read one page with marks, or read one frame"
         },
         "projectId": {
           "description": "Project ID. Optional: falls back to the default project when omitted.",
           "type": "string"
         },
+        "flowId": {
+          "description": "Flow ID (flow_...). Required for list, page and get: frames belong to a flow. Use flow_manage action \"list\" to find one.",
+          "type": "string"
+        },
         "pageKey": {
           "description": "The page as its frames address it (the `source.key` of a page frame, usually the page URL without query). Required for page.",
           "type": "string",
@@ -349,12 +353,13 @@
     },
     "denialHint": "The \"frames\" feature is not enabled for this project. Tell the person that \"frames\" needs a plan or project entitlement that unlocks it, which is changed in the app, not through this tool.",
     "notFoundHint": "Use action \"list\" or \"page\" to find frame ids.",
+    "flowNotFoundHint": "Use flow_manage action \"list\" to find a live flow of the project.",
     "hints": {
       "EXTENDS_BASE": "This frame extends another and stores only what it adds; read the base frame (extends) for the rest.",
       "MARK_SPACE": "Tag geometry is fractional: a rect is 0..1 of its frame, and an at is 0..1 of its parent tag’s box, or of the frame for a root tag; a child frame sits inside its parent through placements[].rect.",
       "NAMES_ARE_DOCUMENTATION": "Frame names are documentation; the marks inside a frame carry the meaning.",
       "NONE_ON_PAGE": "No frames on this page. Check the pageKey against the source.key values from action \"list\".",
-      "NONE_YET": "This project has no frames yet. Frames are drawn in Tag Mode or the app, not through this tool.",
+      "NONE_YET": "This flow has no frames yet. Frames are drawn in Tag Mode or the app, not through this tool.",
       "OPEN_PAGE_OR_GET": "Use action \"page\" with a pageKey (a frame’s source.key) to read a page with marks, or action \"get\" with a frameId.",
       "READ_KNOWLEDGE": "Use hub_manage action \"knowledge\" with frameId (and markId) to read what people wrote here. A markId is a tag id from these marks, and a tag’s threadRef is the id of its thread entry there."
     },