pmx-canvas 0.10.0 → 0.12.0

package/.github/extensions/pmx-canvas/tools.json

@@ -105,6 +105,16 @@
           "reason": {
             "description": "Why these nodes matter; kept with newly pinned nodes and shown to the human on hover.",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -292,6 +302,16 @@
               "sdk",
               "system"
             ]
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -455,7 +475,7 @@
     },
     {
       "name": "canvas_batch",
-      "description": "Run a non-atomic batch of canvas operations with optional assigned references. Use assign to name a result, then reference it later as \"$name\" for the created node id or \"$name.id\" for a specific result field. On failure, earlier successful operations remain applied and the response includes ok:false, failedIndex, error, results, and refs. Supports node.add, node.update, node.remove, graph.add, edge.add, edge.remove, group.create, group.add, group.remove, pin.set/add/remove, snapshot.save, and arrange.",
+      "description": "Run a non-atomic batch of canvas operations with optional assigned references. Use assign to name a result, then reference it later as \"$name\" for the created node id or \"$name.id\" for a specific result field. On failure, earlier successful operations remain applied and the response includes ok:false, failedIndex, error, results, and refs. Supports node.add, node.update, node.remove, graph.add, edge.add, edge.remove, group.create, group.add, group.remove, annotation.add, annotation.remove, pin.set/add/remove, snapshot.save, and arrange.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -487,6 +507,11 @@
             },
             "description": "Ordered array of batch operations"
           },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
+          },
           "full": {
             "description": "Return full batch operation results. Default false compacts node-like payloads.",
             "type": "boolean"
@@ -494,6 +519,11 @@
           "verbose": {
             "description": "Alias for full:true.",
             "type": "boolean"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -934,6 +964,16 @@
           },
           "reason": {
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -1323,6 +1363,16 @@
           "snapshot": {
             "type": "string",
             "description": "Snapshot name or ID to compare against"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -1736,7 +1786,7 @@
     },
     {
       "name": "canvas_board",
-      "description": "Knowledge data: knowledge-list reads categories/folders/shared relation presets; category-set replaces category (id/name/glyph/decayType/rate/triggers/revalidationMethod); category-remove deletes an unused category by id (explicit folder assignments, including empty folders, refuse deletion); relation-preset-set saves preset (id/name/vocabulary); relation-preset-remove deletes a template without changing existing board vocabularies; folder-set replaces path/categoryId/lifecycleOverride (null inherits). These workspace actions never open a board and are refused under agent scope fences. Boards in this workspace — the library of the human's and your working memory, filed in folders on Home. Your writes always go to the open board (activeBoardId); on Home (no board open) your first write opens the most recent board, or a new one when there are none. Action \"list\" returns every board (with its folder), most recently opened first; \"get\" reads one (default: the open board); \"create\" makes a new empty board WITHOUT opening it (optional folder); \"open\" explicitly switches the server active board to id (null or omitted opens Home), changing the subsequent write target. Humans browsing Map/Graph stay in the library until they explicitly open a board/card; do not infer activeBoardId from their visible library. After creating a board, open its returned id and verify activeBoardId before writing; another participant can switch the board later. \"update\" renames a board, files it under a folder (folder \"\" removes it), or designates its README via readmeNodeId. As part of normal board authoring, read the board metadata; if readmeNodeId is null, choose or create a concise markdown introduction explaining its purpose and key context, then designate that node with \"update\". Preserve an existing README unless the human asks to change it; humans can override the designation manually. \"pin\" adds a board to the working set (its README and pinned cards reach your brief whichever board is open; optional reason), \"unpin\" removes it; a pinned board is read-only context, never a write target. Only the human deletes boards.",
+      "description": "\"move-selection\" previews or atomically relocates selected cards and group descendants to a new board, preserves identity and leaves a portal. Supply sourceBoardId, nodeIds, name, expectedRevision and requestId; preview:true reports blockers and the Undo/snapshot boundary. Retry identical input with the same requestId. It never opens the destination. Knowledge data: knowledge-list reads categories/folders/shared relation presets; category-set replaces category (id/name/glyph/decayType/rate/triggers/revalidationMethod); category-remove deletes an unused category by id (explicit folder assignments, including empty folders, refuse deletion); relation-preset-set saves preset (id/name/vocabulary); relation-preset-remove deletes a template without changing existing board vocabularies; folder-set replaces path/categoryId/lifecycleOverride (null inherits). These workspace actions never open a board and are refused under agent scope fences. Boards in this workspace — the library of the human's and your working memory, filed in folders on Home. Your writes always go to the open board (activeBoardId); on Home (no board open) your first write opens the most recent board, or a new one when there are none. Action \"list\" returns every board (with its folder), most recently opened first; \"get\" reads one (default: the open board); \"create\" makes a new empty board WITHOUT opening it (optional folder); \"open\" explicitly switches the server active board to id (null or omitted opens Home), changing the subsequent write target. Humans browsing Map/Graph stay in the library until they explicitly open a board/card; do not infer activeBoardId from their visible library. After creating a board, open its returned id and verify activeBoardId before writing; another participant can switch the board later. \"update\" renames a board, files it under a folder (folder \"\" removes it), or designates its README via readmeNodeId. As part of normal board authoring, read the board metadata; if readmeNodeId is null, choose or create a concise markdown introduction explaining its purpose and key context, then designate that node with \"update\". Preserve an existing README unless the human asks to change it; humans can override the designation manually. \"pin\" adds a board to the working set (its README and pinned cards reach your brief whichever board is open; optional reason), \"unpin\" removes it; a pinned board is read-only context, never a write target. Only the human deletes boards.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1747,6 +1797,7 @@
               "get",
               "create",
               "create-from",
+              "move-selection",
               "open",
               "update",
               "knowledge-list",
@@ -1758,7 +1809,7 @@
               "pin",
               "unpin"
             ],
-            "description": "Operation to perform: list | get | create | create-from | open | update | pin | unpin | knowledge-list | category-set | category-remove | relation-preset-set | relation-preset-remove | folder-set."
+            "description": "Operation to perform: list | get | create | create-from | move-selection | open | update | pin | unpin | knowledge-list | category-set | category-remove | relation-preset-set | relation-preset-remove | folder-set."
           },
           "id": {
             "description": "Board id (default: the open board)"
@@ -1789,6 +1840,16 @@
             "description": "Return reusable cards and structure without creating",
             "type": "boolean"
           },
+          "expectedRevision": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "requestId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
           "relationVocabulary": {
             "description": "Board relation vocabulary: open kinds with a meaning ink and direction",
             "maxItems": 64,
@@ -2042,6 +2103,16 @@
           "reason": {
             "description": "Why this board matters; shown to the human on hover",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -2297,6 +2368,109 @@
                 ],
                 "additionalProperties": false
               },
+              {
+                "type": "object",
+                "properties": {
+                  "operation": {
+                    "type": "string",
+                    "const": "board.move-selection"
+                  },
+                  "outcome": {
+                    "type": "string",
+                    "const": "success"
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean"
+                          },
+                          "preview": {
+                            "type": "object",
+                            "properties": {
+                              "sourceBoardId": {
+                                "type": "string",
+                                "minLength": 1
+                              },
+                              "nodeIds": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string",
+                                  "minLength": 1
+                                }
+                              },
+                              "blockers": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            },
+                            "required": [
+                              "sourceBoardId",
+                              "nodeIds",
+                              "blockers"
+                            ],
+                            "additionalProperties": {}
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "preview"
+                        ],
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean"
+                          },
+                          "sourceBoardId": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "destinationBoardId": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "portalId": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "nodeIds": {
+                            "type": "array",
+                            "items": {
+                              "type": "string",
+                              "minLength": 1
+                            }
+                          },
+                          "replayed": {
+                            "type": "boolean"
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "sourceBoardId",
+                          "destinationBoardId",
+                          "portalId",
+                          "nodeIds",
+                          "replayed"
+                        ],
+                        "additionalProperties": {}
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "operation",
+                  "outcome",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
               {
                 "type": "object",
                 "properties": {
@@ -2577,6 +2751,7 @@
                       "board.get",
                       "board.create",
                       "board.create-from",
+                      "board.move-selection",
                       "board.open",
                       "board.update",
                       "knowledge.list",
@@ -3026,6 +3201,16 @@
                 }
               ]
             }
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -3752,6 +3937,16 @@
           "heightPx": {
             "description": "SDK alias for nodeHeight (node frame height)",
             "type": "number"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -4232,6 +4427,16 @@
           "edge_id": {
             "description": "Alias for id (legacy HTTP body field)",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -4544,6 +4749,16 @@
           "groupId": {
             "description": "The group node ID",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -4819,6 +5034,16 @@
               "redo"
             ],
             "description": "Operation to perform: undo | redo."
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -4984,7 +5209,7 @@
     },
     {
       "name": "canvas_view",
-      "description": "Canvas viewport and layout control. Action \"arrange\" auto-lays-out nodes (grid/columns/etc.); \"focus\" pans/zooms the viewport to a node; \"fit\" zooms to fit all nodes in view; \"clear\" removes every node and edge from the canvas; \"remove-annotation\" deletes a human-drawn annotation by id; \"get-tour\"/\"set-tour\" read or persist the presentation tour; \"tour-go\" presents a stop (stop index or step next/previous); \"tour-exit\" leaves presentation; \"move\" eases the camera to a nodeId, world rect or viewport over a duration. Camera actions never enter undo history.",
+      "description": "Canvas viewport and layout control. Action \"arrange\" auto-lays-out nodes (grid/columns/etc.); \"focus\" pans/zooms the viewport to a node; \"fit\" zooms to fit all nodes in view; \"clear\" removes every node and edge from the canvas; \"add-annotation\" draws freehand points or text in world coordinates; \"remove-annotation\" erases a whole mark by id; \"get-tour\"/\"set-tour\" read or persist the presentation tour; \"tour-go\" presents a stop (stop index or step next/previous); \"tour-exit\" leaves presentation; \"move\" eases the camera to a nodeId, world rect or viewport over a duration. Camera actions never enter undo history.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -5000,9 +5225,10 @@
               "focus",
               "fit",
               "clear",
+              "add-annotation",
               "remove-annotation"
             ],
-            "description": "Operation to perform: arrange | focus | fit | clear | remove-annotation | get-tour | set-tour | tour-go | tour-exit | move."
+            "description": "Operation to perform: arrange | focus | fit | clear | add-annotation | remove-annotation | get-tour | set-tour | tour-go | tour-exit | move."
           },
           "tour": {
             "anyOf": [
@@ -5148,6 +5374,38 @@
               "previous"
             ]
           },
+          "presenter": {
+            "description": "Document intent order and expected board activation",
+            "type": "object",
+            "properties": {
+              "clientId": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128
+              },
+              "intent": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "catalogEpoch": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128
+              },
+              "boardGeneration": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "clientId",
+              "intent",
+              "catalogEpoch",
+              "boardGeneration"
+            ]
+          },
           "present": {
             "description": "Start presenting in viewers that are not presenting yet (default true; false only moves presenting viewers)",
             "type": "boolean"
@@ -5263,6 +5521,51 @@
             "items": {
               "type": "string"
             }
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "freehand",
+              "text"
+            ]
+          },
+          "points": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "x": {
+                  "type": "number"
+                },
+                "y": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "x",
+                "y"
+              ]
+            }
+          },
+          "color": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -5454,7 +5757,6 @@
                     "type": "string",
                     "enum": [
                       "tour.set",
-                      "tour.exit",
                       "annotation.remove"
                     ]
                   },
@@ -5494,142 +5796,249 @@
                     "const": "success"
                   },
                   "data": {
-                    "type": "object",
-                    "properties": {
-                      "ok": {
-                        "type": "boolean"
-                      },
-                      "index": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "total": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 9007199254740991
-                      },
-                      "stop": {
+                    "anyOf": [
+                      {
                         "type": "object",
                         "properties": {
-                          "target": {
-                            "anyOf": [
-                              {
-                                "type": "object",
-                                "properties": {
-                                  "nodeId": {
-                                    "type": "string",
-                                    "minLength": 1
-                                  }
-                                },
-                                "required": [
-                                  "nodeId"
-                                ],
-                                "additionalProperties": false
-                              },
-                              {
-                                "type": "object",
-                                "properties": {
-                                  "rect": {
-                                    "type": "object",
-                                    "properties": {
-                                      "x": {
-                                        "type": "number"
-                                      },
-                                      "y": {
-                                        "type": "number"
-                                      },
-                                      "width": {
-                                        "type": "number",
-                                        "exclusiveMinimum": 0
-                                      },
-                                      "height": {
-                                        "type": "number",
-                                        "exclusiveMinimum": 0
+                          "ok": {
+                            "type": "boolean"
+                          },
+                          "catalogEpoch": {
+                            "type": "string"
+                          },
+                          "boardGeneration": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "sequence": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "index": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "total": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "stop": {
+                            "type": "object",
+                            "properties": {
+                              "target": {
+                                "anyOf": [
+                                  {
+                                    "type": "object",
+                                    "properties": {
+                                      "nodeId": {
+                                        "type": "string",
+                                        "minLength": 1
                                       }
                                     },
                                     "required": [
-                                      "x",
-                                      "y",
-                                      "width",
-                                      "height"
+                                      "nodeId"
                                     ],
                                     "additionalProperties": false
-                                  }
-                                },
-                                "required": [
-                                  "rect"
-                                ],
-                                "additionalProperties": false
-                              },
-                              {
-                                "type": "object",
-                                "properties": {
-                                  "viewport": {
+                                  },
+                                  {
                                     "type": "object",
                                     "properties": {
-                                      "x": {
-                                        "type": "number"
-                                      },
-                                      "y": {
-                                        "type": "number"
-                                      },
-                                      "scale": {
-                                        "type": "number",
-                                        "exclusiveMinimum": 0
+                                      "rect": {
+                                        "type": "object",
+                                        "properties": {
+                                          "x": {
+                                            "type": "number"
+                                          },
+                                          "y": {
+                                            "type": "number"
+                                          },
+                                          "width": {
+                                            "type": "number",
+                                            "exclusiveMinimum": 0
+                                          },
+                                          "height": {
+                                            "type": "number",
+                                            "exclusiveMinimum": 0
+                                          }
+                                        },
+                                        "required": [
+                                          "x",
+                                          "y",
+                                          "width",
+                                          "height"
+                                        ],
+                                        "additionalProperties": false
                                       }
                                     },
                                     "required": [
-                                      "x",
-                                      "y",
-                                      "scale"
+                                      "rect"
+                                    ],
+                                    "additionalProperties": false
+                                  },
+                                  {
+                                    "type": "object",
+                                    "properties": {
+                                      "viewport": {
+                                        "type": "object",
+                                        "properties": {
+                                          "x": {
+                                            "type": "number"
+                                          },
+                                          "y": {
+                                            "type": "number"
+                                          },
+                                          "scale": {
+                                            "type": "number",
+                                            "exclusiveMinimum": 0
+                                          }
+                                        },
+                                        "required": [
+                                          "x",
+                                          "y",
+                                          "scale"
+                                        ],
+                                        "additionalProperties": false
+                                      }
+                                    },
+                                    "required": [
+                                      "viewport"
                                     ],
                                     "additionalProperties": false
                                   }
-                                },
-                                "required": [
-                                  "viewport"
-                                ],
-                                "additionalProperties": false
+                                ]
+                              },
+                              "duration": {
+                                "type": "number",
+                                "minimum": 0,
+                                "maximum": 3600
+                              },
+                              "easing": {
+                                "type": "string",
+                                "enum": [
+                                  "linear",
+                                  "ease-in-out",
+                                  "ease-out"
+                                ]
+                              },
+                              "padding": {
+                                "type": "number",
+                                "minimum": 0
+                              },
+                              "pullback": {
+                                "type": "number",
+                                "minimum": 0,
+                                "maximum": 4
                               }
-                            ]
+                            },
+                            "required": [
+                              "target"
+                            ],
+                            "additionalProperties": false
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "catalogEpoch",
+                          "boardGeneration",
+                          "sequence",
+                          "index",
+                          "total",
+                          "stop"
+                        ],
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean",
+                            "const": true
                           },
-                          "duration": {
-                            "type": "number",
-                            "minimum": 0,
-                            "maximum": 3600
+                          "superseded": {
+                            "type": "boolean",
+                            "const": true
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "superseded"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "operation",
+                  "outcome",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "operation": {
+                    "type": "string",
+                    "const": "tour.exit"
+                  },
+                  "outcome": {
+                    "type": "string",
+                    "const": "success"
+                  },
+                  "data": {
+                    "anyOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean"
                           },
-                          "easing": {
-                            "type": "string",
-                            "enum": [
-                              "linear",
-                              "ease-in-out",
-                              "ease-out"
-                            ]
+                          "catalogEpoch": {
+                            "type": "string"
                           },
-                          "padding": {
-                            "type": "number",
-                            "minimum": 0
+                          "boardGeneration": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
                           },
-                          "pullback": {
-                            "type": "number",
+                          "sequence": {
+                            "type": "integer",
                             "minimum": 0,
-                            "maximum": 4
+                            "maximum": 9007199254740991
                           }
                         },
                         "required": [
-                          "target"
+                          "ok",
+                          "catalogEpoch",
+                          "boardGeneration",
+                          "sequence"
+                        ],
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "ok": {
+                            "type": "boolean",
+                            "const": true
+                          },
+                          "superseded": {
+                            "type": "boolean",
+                            "const": true
+                          }
+                        },
+                        "required": [
+                          "ok",
+                          "superseded"
                         ],
                         "additionalProperties": false
                       }
-                    },
-                    "required": [
-                      "ok",
-                      "index",
-                      "total",
-                      "stop"
-                    ],
-                    "additionalProperties": {}
+                    ]
                   }
                 },
                 "required": [
@@ -5975,6 +6384,51 @@
                 ],
                 "additionalProperties": false
               },
+              {
+                "type": "object",
+                "properties": {
+                  "operation": {
+                    "type": "string",
+                    "const": "annotation.add"
+                  },
+                  "outcome": {
+                    "type": "string",
+                    "const": "success"
+                  },
+                  "data": {
+                    "type": "object",
+                    "properties": {
+                      "ok": {
+                        "type": "boolean"
+                      },
+                      "annotation": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": [
+                          "id"
+                        ],
+                        "additionalProperties": {}
+                      }
+                    },
+                    "required": [
+                      "ok",
+                      "annotation"
+                    ],
+                    "additionalProperties": {}
+                  }
+                },
+                "required": [
+                  "operation",
+                  "outcome",
+                  "data"
+                ],
+                "additionalProperties": false
+              },
               {
                 "type": "object",
                 "properties": {
@@ -5990,6 +6444,7 @@
                       "node.focus",
                       "view.fit",
                       "canvas.clear",
+                      "annotation.add",
                       "annotation.remove"
                     ]
                   },
@@ -6113,6 +6568,14 @@
           "budget": {
             "description": "Maximum response size in UTF-16 code units"
           },
+          "contextDelivery": {
+            "description": "False prepares a brief without recording delivery or advancing a cursor.",
+            "type": "boolean"
+          },
+          "includeSteering": {
+            "description": "False omits steering for hosts that deliver it separately.",
+            "type": "boolean"
+          },
           "projection": {
             "default": "full",
             "description": "Full board/card graph, or board-only Map summaries with qualified cross-board and missing relations",
@@ -6180,6 +6643,16 @@
           "verbose": {
             "description": "Alias for full:true.",
             "type": "boolean"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -6842,6 +7315,16 @@
           "bundleScriptPath": {
             "description": "Optional script path override for tests/debugging. Must resolve inside the workspace.",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -7187,6 +7670,16 @@
           "script": {
             "description": "Multi-statement JavaScript body. The MCP server wraps it in an async IIFE and evaluates the resolved return value.",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -7535,17 +8028,9 @@
             "additionalProperties": {}
           },
           "agentId": {
-            "description": "Stable identity for a genuinely separate agent, not a task name. Omit for the main agent when a host adapter already owns its session.",
-            "anyOf": [
-              {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 80
-              },
-              {
-                "type": "null"
-              }
-            ]
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           },
           "label": {
             "description": "Display name for this writer; use detail for the current task",
@@ -7638,6 +8123,11 @@
                 "type": "null"
               }
             ]
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -7875,7 +8365,9 @@
             "description": "Optional host/source label. Defaults to mcp."
           },
           "agentId": {
-            "description": "Optional per-agent identity within the host."
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           },
           "id": {
             "type": "string",
@@ -7937,6 +8429,11 @@
           "author": {
             "description": "Optional author label.",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -8279,6 +8776,16 @@
           },
           "reason": {
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -8941,7 +9448,9 @@
             "description": "Optional host/source label. Defaults to mcp."
           },
           "agentId": {
-            "description": "Optional per-agent identity within the host."
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           },
           "title": {
             "type": "string",
@@ -8972,6 +9481,11 @@
           "boards": {
             "description": "Comma-separated board ids: also return each one's latest agent read (pinned boards, in one request).",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -9326,6 +9840,12 @@
             "description": "Max steering messages to return.",
             "type": "number"
           },
+          "offset": {
+            "description": "Skip this many matching pending messages. Restart at zero after an empty page.",
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
           "order": {
             "description": "Order of returned steering: \"oldest\" (FIFO, default) for ordered processing, or \"newest\" first to see the latest browser action when limited.",
             "type": "string",
@@ -9334,6 +9854,10 @@
               "oldest"
             ]
           },
+          "addressedOnly": {
+            "description": "Only messages addressed to consumer, excluding broadcasts before applying the limit.",
+            "type": "boolean"
+          },
           "timeoutMs": {
             "description": "Max ms to block until steering arrives (0/omitted = immediate read).",
             "type": "number",
@@ -9343,6 +9867,16 @@
           "id": {
             "type": "string",
             "description": "The steering message id to mark delivered."
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -9654,6 +10188,16 @@
           "settledNodeId": {
             "description": "The real node this intent became — triggers the settle morph.",
             "type": "string"
+          },
+          "targetBoardId": {
+            "description": "Execute on this board without changing the shared workbench view. Nested operations retain this target.",
+            "type": "string",
+            "minLength": 1
+          },
+          "agentId": {
+            "description": "Stable agent/thread identity for attribution and scope fences.",
+            "type": "string",
+            "minLength": 1
           }
         },
         "required": [
@@ -9903,6 +10447,12 @@
       "inputSchema": {
         "type": "object",
         "properties": {
+          "targetBoardId": {
+            "type": "string"
+          },
+          "agentId": {
+            "type": "string"
+          },
           "type": {
             "type": "string",
             "enum": [
@@ -10025,6 +10575,12 @@
       "inputSchema": {
         "type": "object",
         "properties": {
+          "targetBoardId": {
+            "type": "string"
+          },
+          "agentId": {
+            "type": "string"
+          },
           "kind": {
             "type": "string",
             "enum": [
@@ -10312,6 +10868,10 @@
       "inputSchema": {
         "type": "object",
         "properties": {
+          "targetBoardId": {
+            "description": "Not supported: screenshots inspect the shared WebView.",
+            "type": "string"
+          },
           "format": {
             "description": "Screenshot format (default depends on Bun; png recommended)",
             "type": "string",