@wowok/agent-mcp 2.7.2 → 2.7.4

package/dist/schemas/local_mark_operation.schema.json

@@ -2,118 +2,113 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/local_mark_operation.json",
   "title": "Local Mark Operations",
-  "description": "Manage ID names and tags stored locally",
-  "$ref": "#/definitions/local_mark_operation",
-  "definitions": {
-    "local_mark_operation": {
+  "description": "Local mark operations. Exactly one operation type (add/remove/clear) must be specified as a NESTED field. Example: {add: {op:'add', data:[...]}} — NOT flat {op:'add', data:[...]}.",
+  "type": "object",
+  "properties": {
+    "add": {
+      "description": "Add one or more marks",
       "type": "object",
       "properties": {
-        "add": {
-          "type": "object",
-          "properties": {
-            "op": {
-              "type": "string",
-              "const": "add",
-              "description": "Operation type: add marks"
-            },
-            "data": {
-              "type": "array",
-              "items": {
+        "op": {
+          "type": "string",
+          "const": "add",
+          "description": "Operation type: add marks"
+        },
+        "data": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "description": "Mark naming configuration. MUST be an object {value: string, replaceExistName?: boolean}, NOT a plain string. Example: {name: {value: 'my-account', replaceExistName: true}}",
                 "type": "object",
                 "properties": {
-                  "name": {
-                    "type": "object",
-                    "properties": {
-                      "value": {
-                        "type": "string",
-                        "maxLength": 64,
-                        "description": "Mark name value (max 64 bcs characters)"
-                      },
-                      "replaceExistName": {
-                        "type": "boolean",
-                        "default": false,
-                        "description": "If true, replace existing mark with same name; if false (default), throw error when name exists"
-                      }
-                    },
-                    "required": [
-                      "value"
-                    ],
-                    "additionalProperties": false,
-                    "description": "Mark naming configuration. MUST be an object {value: string, replaceExistName?: boolean}, NOT a plain string. Example: {name: {value: 'my-account', replaceExistName: true}}"
-                  },
-                  "address": {
+                  "value": {
                     "type": "string",
-                    "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
+                    "maxLength": 64,
+                    "description": "Mark name value (max 64 bcs characters)"
                   },
-                  "tags": {
-                    "type": "array",
-                    "items": {
-                      "type": "string",
-                      "maxLength": 64
-                    },
-                    "maxItems": 50,
-                    "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)"
+                  "replaceExistName": {
+                    "default": false,
+                    "description": "If true, replace existing mark with same name; if false (default), throw error when name exists",
+                    "type": "boolean"
                   }
                 },
                 "required": [
-                  "address"
+                  "value",
+                  "replaceExistName"
                 ],
-                "additionalProperties": false,
-                "description": "LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. For public on-chain marks, use the 'personal' tool instead. IMPORTANT: 'name' field is an OBJECT {value, replaceExistName?}, not a string. FIX-011 cross-network consistency: LocalMark names are scoped per network. When creating marks for the same logical object on different networks (e.g. testnet and mainnet), use the SAME name value to keep name-based references portable. Before creating a mark on mainnet, check if a mark with the same name already exists on testnet (via query_local with network='testnet') and replicate the same name on mainnet for consistency."
+                "additionalProperties": false
               },
-              "minItems": 1,
-              "description": "Array of mark data to add (at least 1 item)"
-            }
-          },
-          "required": [
-            "op",
-            "data"
-          ],
-          "additionalProperties": false,
-          "description": "Add one or more marks"
-        },
-        "remove": {
-          "type": "object",
-          "properties": {
-            "op": {
-              "type": "string",
-              "const": "remove",
-              "description": "Operation type: remove marks"
-            },
-            "names": {
-              "type": "array",
-              "items": {
-                "type": "string"
+              "address": {
+                "type": "string",
+                "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
               },
-              "minItems": 1,
-              "description": "Array of mark names or addresses to remove"
-            }
+              "tags": {
+                "description": "Tags for categorization (max 50 tags, each max 64 bcs characters)",
+                "maxItems": 50,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "maxLength": 64
+                }
+              }
+            },
+            "required": [
+              "address"
+            ],
+            "additionalProperties": false,
+            "description": "LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. For public on-chain marks, use the 'personal' tool instead. IMPORTANT: 'name' field is an OBJECT {value, replaceExistName?}, not a string. FIX-011 cross-network consistency: LocalMark names are scoped per network. When creating marks for the same logical object on different networks (e.g. testnet and mainnet), use the SAME name value to keep name-based references portable. Before creating a mark on mainnet, check if a mark with the same name already exists on testnet (via query_local with network='testnet') and replicate the same name on mainnet for consistency."
           },
-          "required": [
-            "op",
-            "names"
-          ],
-          "additionalProperties": false,
-          "description": "Remove marks by name or address"
+          "description": "Array of mark data to add (at least 1 item)"
+        }
+      },
+      "required": [
+        "op",
+        "data"
+      ],
+      "additionalProperties": false
+    },
+    "remove": {
+      "description": "Remove marks by name or address",
+      "type": "object",
+      "properties": {
+        "op": {
+          "type": "string",
+          "const": "remove",
+          "description": "Operation type: remove marks"
         },
-        "clear": {
-          "type": "object",
-          "properties": {
-            "op": {
-              "type": "string",
-              "const": "clear",
-              "description": "Operation type: clear all marks"
-            }
+        "names": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string"
           },
-          "required": [
-            "op"
-          ],
-          "additionalProperties": false,
-          "description": "Remove all marks"
+          "description": "Array of mark names or addresses to remove"
+        }
+      },
+      "required": [
+        "op",
+        "names"
+      ],
+      "additionalProperties": false
+    },
+    "clear": {
+      "description": "Remove all marks",
+      "type": "object",
+      "properties": {
+        "op": {
+          "type": "string",
+          "const": "clear",
+          "description": "Operation type: clear all marks"
         }
       },
-      "additionalProperties": false,
-      "description": "Local mark operations. Exactly one operation type (add/remove/clear) must be specified as a NESTED field. Example: {add: {op:'add', data:[...]}} — NOT flat {op:'add', data:[...]}."
+      "required": [
+        "op"
+      ],
+      "additionalProperties": false
     }
-  }
+  },
+  "additionalProperties": false
 }

package/dist/schemas/machineNode2file.output.json

@@ -1,89 +1,83 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/machineNode2file.json",
+  "$id": "https://wowok.net/schemas/machineNode2file.output.json",
   "title": "Machine Node to File",
-  "description": "Export Machine node definition to JSON/Markdown file",
-  "$ref": "#/definitions/machineNode2file",
-  "definitions": {
-    "machineNode2file": {
-      "type": "object",
-      "properties": {
-        "result": {
-          "anyOf": [
-            {
+  "description": "MachineNode2File operation output wrapped schema",
+  "type": "object",
+  "properties": {
+    "result": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "success"
+            },
+            "data": {
               "type": "object",
               "properties": {
-                "status": {
+                "file_path": {
                   "type": "string",
-                  "const": "success"
+                  "description": "Absolute path of the exported file"
                 },
-                "data": {
-                  "type": "object",
-                  "properties": {
-                    "file_path": {
-                      "type": "string",
-                      "description": "Absolute path of the exported file"
-                    },
-                    "format": {
-                      "type": "string",
-                      "enum": [
-                        "json",
-                        "markdown"
-                      ],
-                      "description": "Export format"
-                    },
-                    "machine_object": {
-                      "type": "string",
-                      "description": "Machine object ID"
-                    },
-                    "node_count": {
-                      "type": "number",
-                      "description": "Number of nodes exported"
-                    }
-                  },
-                  "required": [
-                    "file_path",
-                    "format",
-                    "machine_object",
-                    "node_count"
-                  ],
-                  "additionalProperties": false,
-                  "description": "Success result data"
-                }
-              },
-              "required": [
-                "status",
-                "data"
-              ],
-              "additionalProperties": false
-            },
-            {
-              "type": "object",
-              "properties": {
-                "status": {
+                "format": {
                   "type": "string",
-                  "const": "error"
+                  "enum": [
+                    "json",
+                    "markdown"
+                  ],
+                  "description": "Export format"
                 },
-                "error": {
+                "machine_object": {
                   "type": "string",
-                  "description": "Error message"
+                  "description": "Machine object ID"
+                },
+                "node_count": {
+                  "type": "number",
+                  "description": "Number of nodes exported"
                 }
               },
               "required": [
-                "status",
-                "error"
+                "file_path",
+                "format",
+                "machine_object",
+                "node_count"
               ],
-              "additionalProperties": false
+              "additionalProperties": false,
+              "description": "Success result data"
+            }
+          },
+          "required": [
+            "status",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "const": "error"
+            },
+            "error": {
+              "type": "string",
+              "description": "Error message"
             }
+          },
+          "required": [
+            "status",
+            "error"
           ],
-          "description": "MachineNode2File operation output"
+          "additionalProperties": false
         }
-      },
-      "required": [
-        "result"
       ],
-      "additionalProperties": false,
-      "description": "MachineNode2File operation output wrapped schema"
+      "description": "MachineNode2File operation output"
     }
-  }
+  },
+  "required": [
+    "result"
+  ],
+  "additionalProperties": false
 }

package/dist/schemas/machineNode2file.schema.json

@@ -2,100 +2,98 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/machineNode2file.json",
   "title": "Machine Node to File",
-  "description": "Export Machine node definition to JSON/Markdown file",
-  "$ref": "#/definitions/machineNode2file",
-  "definitions": {
-    "machineNode2file": {
+  "description": "Query a Machine object from the blockchain and export its node definition to a JSON or Markdown file. The exported file can be edited and used to create new Machine objects.",
+  "type": "object",
+  "properties": {
+    "machine": {
+      "type": "string",
+      "description": "Machine object ID or name to export"
+    },
+    "file_path": {
+      "description": "Output file path (absolute or relative). Defaults to the workspace directory when omitted.",
+      "type": "string"
+    },
+    "format": {
+      "default": "json",
+      "description": "Output format: 'json' (default) or 'markdown'",
+      "type": "string",
+      "enum": [
+        "json",
+        "markdown"
+      ]
+    },
+    "env": {
       "type": "object",
       "properties": {
-        "machine": {
+        "account": {
+          "default": "",
           "type": "string",
-          "description": "Machine object ID or name to export"
+          "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
         },
-        "file_path": {
-          "type": "string",
-          "description": "Output file path (absolute or relative)"
+        "permission_guard": {
+          "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object).",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "no_cache": {
+          "description": "Whether to disable caching.",
+          "type": "boolean"
         },
-        "format": {
+        "network": {
           "type": "string",
           "enum": [
-            "json",
-            "markdown"
+            "localnet",
+            "testnet",
+            "mainnet"
           ],
-          "default": "json",
-          "description": "Output format: 'json' (default) or 'markdown'"
+          "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."
+        },
+        "referrer": {
+          "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
+          "type": "string"
+        },
+        "confirmed": {
+          "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
+          "type": "boolean"
+        },
+        "user_intent_phrases": {
+          "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "project": {
+          "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
+          "type": "string"
+        },
+        "client_schema_version": {
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched.",
+          "type": "string"
+        },
+        "schema_strict_mode": {
+          "default": false,
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode).",
+          "type": "boolean"
         },
-        "env": {
-          "type": "object",
-          "properties": {
-            "account": {
-              "$ref": "#/definitions/machineNode2file/properties/machine",
-              "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters).",
-              "default": ""
-            },
-            "permission_guard": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "List of permission guard IDs. Used to extend additional operation permissions (requires verification and configuration in the Permission object)."
-            },
-            "no_cache": {
-              "type": "boolean",
-              "description": "Whether to disable caching."
-            },
-            "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."
-            },
-            "referrer": {
-              "$ref": "#/definitions/machineNode2file/properties/env/properties/account",
-              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded."
-            },
-            "confirmed": {
-              "type": "boolean",
-              "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent."
-            },
-            "user_intent_phrases": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              },
-              "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches."
-            },
-            "project": {
-              "type": "string",
-              "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects."
-            },
-            "client_schema_version": {
-              "type": "string",
-              "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
-            },
-            "schema_strict_mode": {
-              "type": "boolean",
-              "default": false,
-              "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
-            },
-            "dry_run": {
-              "type": "boolean",
-              "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only)."
-            }
-          },
-          "additionalProperties": false,
-          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
+        "dry_run": {
+          "description": "Phase 1 dry_run: when true, SIMULATE the transaction without signing or submitting. Returns effects + events showing what WOULD happen — no on-chain state is modified, no gas is charged. Use this to verify an operation will succeed before committing. Essential for the 5-step loop's Plan step. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
+          "type": "boolean"
         }
       },
       "required": [
-        "machine",
-        "file_path"
+        "account",
+        "schema_strict_mode"
       ],
       "additionalProperties": false,
-      "description": "Query a Machine object from the blockchain and export its node definition to a JSON or Markdown file. The exported file can be edited and used to create new Machine objects."
+      "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
     }
-  }
+  },
+  "required": [
+    "machine",
+    "format"
+  ],
+  "additionalProperties": false
 }