@wowok/agent-mcp 2.7.6 → 2.7.8

package/dist/schemas/watch_operation.schema.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/watch_operation.json",
+  "title": "Watch - Identity-Centric On-chain Console",
+  "description": "Identity-centric on-chain console (K3 23). Read-only. Resolves the active account's identity against a focus object, then layers base data, relation expansion, actionable operations, and four-stage reasoning. Actions: focus / expand / actions / reason.",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "focus"
+        },
+        "focus": {
+          "type": "string",
+          "description": "Object address or LocalMark name to focus on."
+        },
+        "account": {
+          "description": "Active account address; its on-chain role + persona are resolved against the focus.",
+          "type": "string"
+        },
+        "scenario": {
+          "description": "Optional scenario hint to guide identity assembly.",
+          "type": "string",
+          "enum": [
+            "order",
+            "service",
+            "demand",
+            "arbitration",
+            "progress",
+            "permission",
+            "account",
+            "generic"
+          ]
+        },
+        "network": {
+          "description": "Network (default testnet).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "focus"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "expand"
+        },
+        "focus": {
+          "type": "string",
+          "description": "Object address or LocalMark name to expand relations from."
+        },
+        "account": {
+          "description": "Active account address (for identity-aware relation semantics).",
+          "type": "string"
+        },
+        "relation": {
+          "description": "Filter to a single relation kind (e.g. machine, permission, arbitration, sub_service).",
+          "type": "string"
+        },
+        "network": {
+          "description": "Network (default testnet).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "focus"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "actions"
+        },
+        "focus": {
+          "type": "string",
+          "description": "Object address or LocalMark name to enumerate actionable operations for."
+        },
+        "account": {
+          "type": "string",
+          "description": "Active account address — operations are judged against THIS account."
+        },
+        "network": {
+          "description": "Network (default testnet).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "focus",
+        "account"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "reason"
+        },
+        "focus": {
+          "type": "string",
+          "description": "Object address or LocalMark name to reason about."
+        },
+        "account": {
+          "description": "Active account address — identity drives the reasoning direction (objective vs game).",
+          "type": "string"
+        },
+        "scenario": {
+          "description": "Optional scenario hint to guide identity assembly.",
+          "type": "string",
+          "enum": [
+            "order",
+            "service",
+            "demand",
+            "arbitration",
+            "progress",
+            "permission",
+            "account",
+            "generic"
+          ]
+        },
+        "network": {
+          "description": "Network (default testnet).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "focus"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}

package/dist/schemas/workflow_operation.output.json

@@ -12,11 +12,13 @@
           "type": "string",
           "enum": [
             "list",
-            "operate"
+            "task",
+            "operate",
+            "history"
           ]
         },
         "tasks": {
-          "description": "Present for action='list'",
+          "description": "Present for action='list' and action='task' (a one-element array — the same snapshot shape as a list item, built for the requested progress regardless of local-account relation; executable_accounts may be empty when no local account is authorized)",
           "type": "array",
           "items": {
             "type": "object",
@@ -25,6 +27,10 @@
                 "type": "string",
                 "description": "Progress object address"
               },
+              "progress_name": {
+                "description": "Display name for the progress (local account/mark name, when resolved)",
+                "type": "string"
+              },
               "current": {
                 "type": "string",
                 "description": "Current node of the Progress ('' = initial)"
@@ -33,6 +39,10 @@
                 "type": "string",
                 "description": "Machine object address"
               },
+              "machine_name": {
+                "description": "Display name for the machine object (when resolved)",
+                "type": "string"
+              },
               "task": {
                 "anyOf": [
                   {
@@ -44,10 +54,39 @@
                 ],
                 "description": "Bound task (Order) address, or null"
               },
+              "task_name": {
+                "description": "Display name for the bound Order (when resolved)",
+                "type": "string"
+              },
               "service": {
                 "description": "Service address (resolved via the bound Order, if any)",
                 "type": "string"
               },
+              "service_name": {
+                "description": "Display name for the Service object (when resolved)",
+                "type": "string"
+              },
+              "context_repositories": {
+                "description": "Context repositories bound to the Progress (zero or more)",
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "address": {
+                      "type": "string",
+                      "description": "Context repository address"
+                    },
+                    "name": {
+                      "description": "Display name for the repository (when resolved)",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "address"
+                  ],
+                  "additionalProperties": false
+                }
+              },
               "options": {
                 "type": "array",
                 "items": {
@@ -73,6 +112,36 @@
                       "description": "Guard bound to this forward — must be verified (passport) before the transition",
                       "type": "string"
                     },
+                    "guard_submissions": {
+                      "description": "Guard submission fields the user must fill to advance this forward (from the guard's b_submission table items)",
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "identifier": {
+                            "type": "number"
+                          },
+                          "name": {
+                            "type": "string",
+                            "description": "Human-readable field name"
+                          },
+                          "value_type": {
+                            "type": "string",
+                            "description": "Expected value type (Address, U64, String, VecAddress, ...)"
+                          },
+                          "object_type": {
+                            "description": "When value_type is an object address — the expected object type (e.g. Order)",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "identifier",
+                          "name",
+                          "value_type"
+                        ],
+                        "additionalProperties": false
+                      }
+                    },
                     "operator_kind": {
                       "type": "string",
                       "enum": [
@@ -124,11 +193,23 @@
                   "additionalProperties": false,
                   "description": "A reachable forward with its permission + guard + executable local accounts"
                 },
-                "description": "ALL reachable next-node forwards with permission + guard + executable accounts"
+                "description": "ALL reachable next-node forwards with permission + guard + executable accounts (may be empty for a completed/terminal progress)"
               },
               "terminal": {
                 "type": "boolean",
                 "description": "True when the current node has no outgoing forwards (workflow is stuck or finished)"
+              },
+              "actionable": {
+                "type": "boolean",
+                "description": "True when at least one LOCAL account can execute a forward right now; false for progress that is merely related (e.g. already completed)"
+              },
+              "history_count": {
+                "description": "On-chain Progress.history length (append-only) — 0 when no migrations yet",
+                "type": "number"
+              },
+              "current_time": {
+                "description": "Chain clock (ms) when the current node was entered (Progress.current_time) — for elapsed-dwell display",
+                "type": "number"
               }
             },
             "required": [
@@ -137,15 +218,192 @@
               "machine",
               "task",
               "options",
-              "terminal"
+              "terminal",
+              "actionable"
             ],
             "additionalProperties": false,
-            "description": "An active progress object that at least one local account can act on"
+            "description": "A progress object related to a local account: actionable (a local account can act on it) or related (order holder / named operator / session operator involvement — viewable history)"
           }
         },
         "operate": {
           "description": "Present for action='operate' (the underlying progress operation result)"
         },
+        "history": {
+          "description": "Present for action='history'",
+          "type": "object",
+          "properties": {
+            "progress": {
+              "type": "string",
+              "description": "Progress object address"
+            },
+            "current": {
+              "description": "Current node as of this sync",
+              "type": "string"
+            },
+            "records": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "index": {
+                    "type": "number",
+                    "description": "On-chain history index (0-based, append-only)"
+                  },
+                  "node": {
+                    "type": "string",
+                    "description": "Node migrated FROM"
+                  },
+                  "next_node": {
+                    "type": "string",
+                    "description": "Node migrated TO"
+                  },
+                  "time": {
+                    "type": "number",
+                    "description": "Migration time (on-chain clock ms)"
+                  },
+                  "session": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "next_node": {
+                          "type": "string",
+                          "description": "Session target node (the not-yet-migrated direction)"
+                        },
+                        "weights": {
+                          "type": "number",
+                          "description": "Accumulated forward weight at migration time"
+                        },
+                        "threshold": {
+                          "type": "number",
+                          "description": "Threshold required to complete the pair"
+                        },
+                        "forwards": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "forward": {
+                                "type": "string",
+                                "description": "Forward (operation) name"
+                              },
+                              "who": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "description": "Operator address that performed the forward (null = not yet held)"
+                              },
+                              "who_name": {
+                                "description": "Display name for the operator (account name, else LocalMark)",
+                                "type": "string"
+                              },
+                              "msg": {
+                                "type": "string",
+                                "description": "Message recorded with the forward"
+                              },
+                              "accomplished": {
+                                "type": "boolean",
+                                "description": "Whether the forward was accomplished"
+                              },
+                              "weight": {
+                                "description": "Forward weight (from the machine config; the chain Holder snapshot stores no per-forward weight)",
+                                "type": "number"
+                              },
+                              "time": {
+                                "type": "number",
+                                "description": "Last operation time (on-chain clock ms)"
+                              },
+                              "retained_submission": {
+                                "description": "Retained Guard submission entries",
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "identifier": {
+                                      "type": "number"
+                                    },
+                                    "value_type": {
+                                      "type": "number"
+                                    },
+                                    "value": {},
+                                    "display_name": {
+                                      "description": "Display name for the first address-typed value (when resolved)",
+                                      "type": "string"
+                                    }
+                                  },
+                                  "required": [
+                                    "identifier",
+                                    "value_type",
+                                    "value"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              }
+                            },
+                            "required": [
+                              "forward",
+                              "who",
+                              "msg",
+                              "accomplished",
+                              "time"
+                            ],
+                            "additionalProperties": false,
+                            "description": "One forward execution inside a session snapshot"
+                          },
+                          "description": "Forward executions in this session"
+                        }
+                      },
+                      "required": [
+                        "next_node",
+                        "weights",
+                        "threshold",
+                        "forwards"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Session snapshot captured at migration time"
+                    },
+                    "description": "Full session snapshot at migration"
+                  }
+                },
+                "required": [
+                  "index",
+                  "node",
+                  "next_node",
+                  "time",
+                  "session"
+                ],
+                "additionalProperties": false,
+                "description": "One on-chain Progress history record (a completed migration)"
+              },
+              "description": "History records, newest first"
+            },
+            "synced": {
+              "type": "number",
+              "description": "Number of records newly synced in this call"
+            },
+            "cursor": {
+              "type": "number",
+              "description": "Last synced history index (0-based; -1 = none yet)"
+            },
+            "pruned": {
+              "type": "number",
+              "description": "Progress entries cleaned by the 90-day retention in this call"
+            }
+          },
+          "required": [
+            "progress",
+            "records",
+            "synced",
+            "cursor",
+            "pruned"
+          ],
+          "additionalProperties": false
+        },
         "note": {
           "type": "string"
         }