@wowok/agent-mcp 3.0.3 → 3.0.5

package/dist/schemas/ask_user.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/ask_user.json",
+  "title": "Ask User - Structured Choice Elicitation",
+  "description": "Ask the user to choose between concrete options before continuing.",
+  "type": "object",
+  "properties": {
+    "question": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000,
+      "description": "The single decision you need from the user. Phrase as a complete question; use the user's language. Do NOT stack multiple questions into one call."
+    },
+    "options": {
+      "minItems": 2,
+      "maxItems": 8,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 40,
+            "pattern": "^[a-z0-9][a-z0-9_]{0,39}$",
+            "description": "Stable machine id returned in the result when chosen (e.g. 'strict_binding')."
+          },
+          "label": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120,
+            "description": "Short user-visible label (a few words)."
+          },
+          "description": {
+            "description": "Optional one-line explanation of what choosing this means.",
+            "type": "string",
+            "maxLength": 500
+          }
+        },
+        "required": [
+          "id",
+          "label"
+        ],
+        "additionalProperties": false
+      },
+      "description": "Concrete mutually-exclusive choices (or combinable choices with multi_select=true). Each MUST be self-contained — the user decides from these labels alone."
+    },
+    "recommended_id": {
+      "description": "id of the option you recommend (marked as suggested). Must match one of options[].id. Omit only when you genuinely have no recommendation.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 40,
+      "pattern": "^[a-z0-9][a-z0-9_]{0,39}$"
+    },
+    "multi_select": {
+      "default": false,
+      "description": "true when several options may be combined (the result returns an id array).",
+      "type": "boolean"
+    },
+    "allow_freeform": {
+      "default": false,
+      "description": "true to additionally allow a free-text answer not covered by the options.",
+      "type": "boolean"
+    },
+    "context": {
+      "description": "Optional short explanation of WHY this decision is needed and what each path changes — shown under the question, never instead of it.",
+      "type": "string",
+      "maxLength": 800
+    }
+  },
+  "required": [
+    "question",
+    "options",
+    "multi_select",
+    "allow_freeform"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/bridge_operation.schema.json

@@ -113,8 +113,17 @@
               "type": "boolean"
             },
             "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).",
+              "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
               "type": "boolean"
+            },
+            "confirm_mode": {
+              "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+              "type": "string",
+              "enum": [
+                "full",
+                "streamlined",
+                "quiet"
+              ]
             }
           },
           "required": [
@@ -240,8 +249,17 @@
               "type": "boolean"
             },
             "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).",
+              "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
               "type": "boolean"
+            },
+            "confirm_mode": {
+              "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+              "type": "string",
+              "enum": [
+                "full",
+                "streamlined",
+                "quiet"
+              ]
             }
           },
           "required": [
@@ -341,8 +359,17 @@
               "type": "boolean"
             },
             "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).",
+              "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
               "type": "boolean"
+            },
+            "confirm_mode": {
+              "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+              "type": "string",
+              "enum": [
+                "full",
+                "streamlined",
+                "quiet"
+              ]
             }
           },
           "required": [
@@ -442,8 +469,17 @@
               "type": "boolean"
             },
             "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).",
+              "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
               "type": "boolean"
+            },
+            "confirm_mode": {
+              "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+              "type": "string",
+              "enum": [
+                "full",
+                "streamlined",
+                "quiet"
+              ]
             }
           },
           "required": [
@@ -575,8 +611,17 @@
               "type": "boolean"
             },
             "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).",
+              "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
               "type": "boolean"
+            },
+            "confirm_mode": {
+              "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+              "type": "string",
+              "enum": [
+                "full",
+                "streamlined",
+                "quiet"
+              ]
             }
           },
           "required": [

package/dist/schemas/evaluation_operation.output.json

@@ -2166,6 +2166,22 @@
                       "reputation_trade"
                     ]
                   },
+                  "code": {
+                    "type": "string",
+                    "enum": [
+                      "self_buy",
+                      "reciprocal_loop",
+                      "no_allocation",
+                      "reviews_unverified",
+                      "reviewer_duplicate",
+                      "review_time_burst",
+                      "shell_no_arbitration",
+                      "shell_funded_no_arbitration",
+                      "shell_no_machine",
+                      "reputation_bound"
+                    ],
+                    "description": "Stable machine-readable signal discriminator."
+                  },
                   "severity": {
                     "type": "string",
                     "enum": [
@@ -2176,10 +2192,18 @@
                   },
                   "description": {
                     "type": "string"
+                  },
+                  "refs": {
+                    "description": "Object addresses backing the signal (orders/services).",
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
                   "kind",
+                  "code",
                   "severity",
                   "description"
                 ],

package/dist/schemas/goal_operation.schema.json

@@ -475,6 +475,130 @@
       ],
       "additionalProperties": false
     },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "boundaries"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "boundaries_set"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "budget": {
+          "description": "Total spend ceiling, smallest on-chain unit (MIST), non-negative integer decimal string. Payment candidates above it are rejected (stalled), never asked.",
+          "type": "string"
+        },
+        "deadline": {
+          "description": "Hard deadline, ms epoch. Past it the pursue tick stalls every candidate.",
+          "type": "number"
+        },
+        "requirements": {
+          "description": "Hard acceptance red lines (e.g. 'service location must be London'). Commitment-level moves always wait until every requirement is verified.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "autonomy": {
+          "description": "Standing authorization for the pursue tick: confirm_all (every decision surfaces as a pending suggestion; default) | execute_low_risk (engine-local moves execute; on-chain ops ask) | execute_all (standard-gated on-chain moves also execute; irreversible/publish/amount ALWAYS ask).",
+          "type": "string",
+          "enum": [
+            "confirm_all",
+            "execute_low_risk",
+            "execute_all"
+          ]
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "pursue"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "next_steps"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
     {
       "type": "object",
       "properties": {

package/dist/schemas/guard2file.schema.json

@@ -83,8 +83,17 @@
           "type": "boolean"
         },
         "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).",
+          "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "WoWok MCP Schema Index",
   "description": "Index of all available JSON schemas for WoWok MCP tools",
-  "generatedAt": "2026-09-13T04:27:14.754Z",
+  "generatedAt": "2026-09-18T02:29:18.745Z",
   "tools": [
     {
       "name": "onchain_operations",
@@ -106,6 +106,12 @@
       "path": "./schema_query.schema.json",
       "outputPath": "./schema_query.output.json"
     },
+    {
+      "name": "ask_user",
+      "title": "Ask User - Structured Choice Elicitation",
+      "path": "./ask_user.schema.json",
+      "outputPath": "./ask_user.output.json"
+    },
     {
       "name": "bridge_operation",
       "title": "Bridge - Cross-Chain Operations",
@@ -165,6 +171,12 @@
       "path": "./industry_pack_operation.schema.json",
       "outputPath": "./industry_pack_operation.output.json"
     },
+    {
+      "name": "strategy_review_operation",
+      "title": "Strategy Review - Posture-Weighted Scorecard & Periodic Review",
+      "path": "./strategy_review_operation.schema.json",
+      "outputPath": "./strategy_review_operation.output.json"
+    },
     {
       "name": "workspace_operation",
       "title": "Workspace - File Generation & User Data",

package/dist/schemas/industry_pack_operation.output.json

@@ -260,6 +260,45 @@
               "type": "string",
               "description": "Industry name."
             },
+            "mode": {
+              "description": "Registered industry MODE data (key_risk/needs/analyze defaults), if any.",
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Mode name."
+                },
+                "display_name": {
+                  "type": "string",
+                  "description": "Mode display name."
+                },
+                "key_risk": {
+                  "type": "string",
+                  "description": "The industry's dominant risk."
+                },
+                "needs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Industry need descriptions (satisfaction requires the evaluation puzzle)."
+                },
+                "analyze_questions": {
+                  "description": "Industry-embedded Analyze key questions (max 2) — the fallback follow-ups when the user's persona has none embedded.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "name",
+                "display_name",
+                "key_risk",
+                "needs"
+              ],
+              "additionalProperties": false
+            },
             "dispute": {
               "description": "Registered dispute rules (if any)."
             },

package/dist/schemas/local_mark_operation.schema.json

@@ -21,7 +21,7 @@
             "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}}",
+                "description": "Mark naming configuration. Accepts a bare name string (shorthand normalized to {value: name, replaceExistName: false}) or the canonical object {value: string, replaceExistName?: boolean} when replacing an existing same-name mark. Examples: {name: 'my-account'} or {name: {value: 'my-account', replaceExistName: true}}",
                 "type": "object",
                 "properties": {
                   "value": {
@@ -59,7 +59,7 @@
               "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."
+            "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. The 'name' field accepts a bare name string (shorthand: {name:'my-account'}) or the canonical object form {value, replaceExistName?} when an existing same-name mark must be replaced. 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."
           },
           "description": "Array of mark data to add (at least 1 item)"
         }

package/dist/schemas/machineNode2file.schema.json

@@ -83,8 +83,17 @@
           "type": "boolean"
         },
         "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).",
+          "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 that an operation will succeed before committing. The returned digest will be 'dry_run:<timestamp>' and objectChanges will be empty (simulation only).",
           "type": "boolean"
+        },
+        "confirm_mode": {
+          "description": "Confirmation frequency for this call. 'full': confirm every matched gate rule. 'streamlined' (client default): skip fail-open 'standard' level prompts — fail-closed levels (irreversible/publish/amount) ALWAYS still confirm. 'quiet': same hard floor as streamlined, for clients that batch/suppress repeat low-risk prompts in their own UI. This field NEVER downgrades fail-closed levels.",
+          "type": "string",
+          "enum": [
+            "full",
+            "streamlined",
+            "quiet"
+          ]
         }
       },
       "required": [