@wowok/agent-mcp 2.7.2 → 2.7.4

package/dist/schemas/workflow_operation.output.json

@@ -0,0 +1,164 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/workflow_operation.output.json",
+  "title": "Workflow - Local-Account Progress Tasks",
+  "description": "workflow_operation output envelope",
+  "type": "object",
+  "properties": {
+    "result": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "list",
+            "operate"
+          ]
+        },
+        "tasks": {
+          "description": "Present for action='list'",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "progress": {
+                "type": "string",
+                "description": "Progress object address"
+              },
+              "current": {
+                "type": "string",
+                "description": "Current node of the Progress ('' = initial)"
+              },
+              "machine": {
+                "type": "string",
+                "description": "Machine object address"
+              },
+              "task": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Bound task (Order) address, or null"
+              },
+              "service": {
+                "description": "Service address (resolved via the bound Order, if any)",
+                "type": "string"
+              },
+              "options": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "next_node": {
+                      "type": "string",
+                      "description": "Target node this forward advances INTO"
+                    },
+                    "forward": {
+                      "type": "string",
+                      "description": "Forward (operation) name"
+                    },
+                    "weight": {
+                      "type": "number",
+                      "description": "Forward weight contributed toward the pair threshold"
+                    },
+                    "threshold": {
+                      "type": "number",
+                      "description": "Pair threshold the forward contributes to"
+                    },
+                    "guard": {
+                      "description": "Guard bound to this forward — must be verified (passport) before the transition",
+                      "type": "string"
+                    },
+                    "operator_kind": {
+                      "type": "string",
+                      "enum": [
+                        "order_holder",
+                        "named_operator",
+                        "permission_index"
+                      ],
+                      "description": "How this forward's operator is resolved"
+                    },
+                    "permission_index": {
+                      "description": "Permission index when operator_kind is 'permission_index'",
+                      "type": "number"
+                    },
+                    "named_operator": {
+                      "description": "NamedOperator namespace when operator_kind is 'named_operator'",
+                      "type": "string"
+                    },
+                    "executable_accounts": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "address": {
+                            "type": "string",
+                            "description": "Local account address"
+                          },
+                          "name": {
+                            "description": "Local account name (if any)",
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "address"
+                        ],
+                        "additionalProperties": false,
+                        "description": "A local account that can execute a forward"
+                      },
+                      "description": "LOCAL accounts that can execute this forward (may be empty — then no local account is authorized)"
+                    }
+                  },
+                  "required": [
+                    "next_node",
+                    "forward",
+                    "weight",
+                    "threshold",
+                    "operator_kind",
+                    "executable_accounts"
+                  ],
+                  "additionalProperties": false,
+                  "description": "A reachable forward with its permission + guard + executable local accounts"
+                },
+                "description": "ALL reachable next-node forwards with permission + guard + executable accounts"
+              },
+              "terminal": {
+                "type": "boolean",
+                "description": "True when the current node has no outgoing forwards (workflow is stuck or finished)"
+              }
+            },
+            "required": [
+              "progress",
+              "current",
+              "machine",
+              "task",
+              "options",
+              "terminal"
+            ],
+            "additionalProperties": false,
+            "description": "An active progress object that at least one local account can act on"
+          }
+        },
+        "operate": {
+          "description": "Present for action='operate' (the underlying progress operation result)"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "workflow_operation result"
+    }
+  },
+  "required": [
+    "result"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/workflow_operation.schema.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/workflow_operation.json",
+  "title": "Workflow - Local-Account Progress Tasks",
+  "description": "workflow_operation input. action='list' enumerates local-account actionable progress; action='operate' advances/holds/unholds a forward as a chosen local account.",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "list"
+        },
+        "limit": {
+          "description": "Max number of active progress tasks to return (default 50)",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        },
+        "no_cache": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "operate"
+        },
+        "progress": {
+          "type": "string",
+          "description": "Progress object (name or address) to operate on"
+        },
+        "account": {
+          "description": "Signing account (name or address). Defaults to the first executable local account.",
+          "type": "string"
+        },
+        "operate": {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "object",
+              "properties": {
+                "next_node_name": {
+                  "type": "string",
+                  "description": "Target node name"
+                },
+                "forward": {
+                  "type": "string",
+                  "description": "Forward name"
+                }
+              },
+              "required": [
+                "next_node_name",
+                "forward"
+              ],
+              "additionalProperties": false
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "next",
+                "hold",
+                "unhold",
+                "adminUnhold"
+              ],
+              "description": "Forward operation: 'next' = accomplish the forward; 'hold' = block the forward; 'unhold' = release own hold; 'adminUnhold' = force-release via permission 224."
+            },
+            "message": {
+              "description": "Optional human-readable message recorded on-chain",
+              "type": "string"
+            }
+          },
+          "required": [
+            "operation",
+            "op"
+          ],
+          "additionalProperties": false
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "localnet",
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+        },
+        "no_cache": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "action",
+        "progress",
+        "operate"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}

package/dist/schemas/workspace_operation.output.json

@@ -0,0 +1,277 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/workspace_operation.output.json",
+  "title": "Workspace - File Generation & User Data",
+  "description": "Manage the local workspace directory (.wowok/workspace): files generated for review (machine/guard/wts/wip JSON) and user-created documents. Actions: resolve (root dir), list, read (as AI context), write, delete.",
+  "type": "object",
+  "properties": {
+    "result": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "resolve"
+            },
+            "dir": {
+              "type": "string",
+              "description": "Absolute workspace root directory."
+            }
+          },
+          "required": [
+            "action",
+            "dir"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "list"
+            },
+            "dir": {
+              "type": "string",
+              "description": "Absolute workspace root directory."
+            },
+            "files": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Path relative to the workspace root."
+                  },
+                  "is_dir": {
+                    "type": "boolean"
+                  },
+                  "size": {
+                    "type": "number",
+                    "description": "File size in bytes (0 for directories)."
+                  },
+                  "mtime": {
+                    "type": "number",
+                    "description": "Last-modified time (epoch ms)."
+                  }
+                },
+                "required": [
+                  "path",
+                  "is_dir",
+                  "size",
+                  "mtime"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Files under the workspace root."
+            }
+          },
+          "required": [
+            "action",
+            "dir",
+            "files"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "read"
+            },
+            "path": {
+              "type": "string",
+              "description": "Absolute path of the read file."
+            },
+            "content": {
+              "type": "string",
+              "description": "File content (text)."
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "content"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "write"
+            },
+            "path": {
+              "type": "string",
+              "description": "Absolute path of the written file."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "ok"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "delete"
+            },
+            "path": {
+              "type": "string",
+              "description": "Absolute path of the deleted file."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "ok"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "create_file"
+            },
+            "path": {
+              "type": "string",
+              "description": "Absolute path of the created file."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "ok"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "create_dir"
+            },
+            "path": {
+              "type": "string",
+              "description": "Absolute path of the created directory."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "ok"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "copy"
+            },
+            "from": {
+              "type": "string",
+              "description": "Absolute source path."
+            },
+            "to": {
+              "type": "string",
+              "description": "Absolute destination path."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "from",
+            "to",
+            "ok"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "move"
+            },
+            "from": {
+              "type": "string",
+              "description": "Absolute source path."
+            },
+            "to": {
+              "type": "string",
+              "description": "Absolute destination path."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "from",
+            "to",
+            "ok"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "rename"
+            },
+            "from": {
+              "type": "string",
+              "description": "Absolute old path."
+            },
+            "to": {
+              "type": "string",
+              "description": "Absolute new path."
+            },
+            "ok": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "from",
+            "to",
+            "ok"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "required": [
+    "result"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/workspace_operation.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/workspace_operation.json",
+  "title": "Workspace - File Generation & User Data",
+  "description": "Manage the local workspace directory (.wowok/workspace): files generated for review (machine/guard/wts/wip JSON) and user-created documents. Actions: resolve (root dir), list, read (as AI context), write, delete.",
+  "type": "object",
+  "properties": {
+    "action": {
+      "type": "string",
+      "enum": [
+        "resolve",
+        "list",
+        "read",
+        "write",
+        "delete",
+        "create_file",
+        "create_dir",
+        "copy",
+        "move",
+        "rename"
+      ],
+      "description": "Action: 'resolve' = return the workspace root directory; 'list' = list files; 'read' = read a file (path required); 'write' = write/overwrite a file (path + content required); 'delete' = delete a file or directory (path required). 'create_file' = create an empty file (path required; content optional). 'create_dir' = create a directory recursively (path required). 'copy' = copy a file or directory (from + to required). 'move' / 'rename' = move or rename a file or directory (from + to required)."
+    },
+    "path": {
+      "description": "Path relative to the workspace root (required for read/write/delete/create_file/create_dir).",
+      "type": "string"
+    },
+    "content": {
+      "description": "File content (required for write; optional for create_file).",
+      "type": "string"
+    },
+    "from": {
+      "description": "Source path relative to root (required for copy/move/rename).",
+      "type": "string"
+    },
+    "to": {
+      "description": "Destination path relative to root (required for copy/move/rename).",
+      "type": "string"
+    }
+  },
+  "required": [
+    "action"
+  ],
+  "additionalProperties": false
+}