@wowok/agent-mcp 3.3.9 → 3.4.1

package/dist/schemas/benchmark_migration_operation.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/benchmark_migration_operation.json",
   "title": "Template Migration - Industry Templates & Competitor Migration",
-  "description": "MD industry-archetype templates (hot-loaded from .wowok/templates/, 12 built-ins: 6 industries x leader + challenger), pre-deploy risk scan, and one-click competitor migration. Actions: template_list (list loaded templates, optional industry filter), template_get (full template by template_id), template_generate (creation plan from a template via the merchant-guide pipeline; scan-first, CRITICAL blocks; never on-chain), template_scan (pre-deploy risk scan of one template; CRITICAL blocks generation/apply), migration_import (competitor URL/description -> MigrationLog with mapped/unmapped/manual_review entries), migration_review (surface the MigrationLog for user confirmation), migration_apply (run the approved template through the merchant-guide pipeline; scan-first, CRITICAL blocks; default network testnet).",
+  "description": "MD industry-archetype templates (hot-loaded from .wowok/templates/, 30 built-in archetypes across 10 industries), pre-deploy risk scan, and one-click competitor migration. Actions: template_list (list loaded templates, optional industry filter), template_get (full template by template_id), template_generate (creation plan from a template via the merchant-guide pipeline; scan-first, CRITICAL blocks; never on-chain), template_scan (pre-deploy risk scan of one template; CRITICAL blocks generation/apply), plan_execute (one-click deployment: materialize the plan returned by template_generate — plan required; resumes a failed run with completed_steps/previous_outputs instead of re-running from scratch), migration_import (competitor URL/description -> MigrationLog with mapped/unmapped/manual_review entries), migration_review (surface the MigrationLog for user confirmation), migration_apply (run the approved template through the merchant-guide pipeline; scan-first, CRITICAL blocks; default network testnet).",
   "type": "object",
   "properties": {
     "action": {
@@ -24,7 +24,7 @@
       "type": "string"
     },
     "industry": {
-      "description": "Industry filter for template_list; industry hint for migration_import. Any registered industry is accepted (builtin: freelance, rental, education, travel, subscription, retail; plus custom industries registered via industry packs). Aliases are resolved (e.g. 'ecommerce' → 'retail').",
+      "description": "Industry filter for template_list; industry hint for migration_import. Any registered industry is accepted (builtin: crowdfunding, delivery, education, freelance, group_buy, licensing, rental, retail, subscription, travel; plus custom industries registered via industry packs). Aliases are resolved (e.g. 'ecommerce' → 'retail').",
       "type": "string"
     },
     "description": {
@@ -523,7 +523,7 @@
       "additionalProperties": {}
     },
     "completed_steps": {
-      "description": "plan_execute resume (AR-5): step ids already EXECUTED in a prior run (from the failed response's steps[].stepId where status='executed'). Those steps are adopted, not re-executed.",
+      "description": "plan_execute resume (AR-5): step ids already EXECUTED in a prior run. Those steps are adopted, not re-executed. A run that did not complete returns a ready-to-pass `resume` payload (completed_steps/previous_outputs) — pass it back verbatim instead of deriving the lists by hand.",
       "type": "array",
       "items": {
         "type": "string"
@@ -539,6 +539,31 @@
         "type": "string"
       }
     },
+    "resume_from_step": {
+      "description": "plan_execute resume (W5-08): the FIRST step to (re-)execute — every step BEFORE it in plan order is adopted from previous_outputs. Lighter than enumerating completed_steps: pass the first step whose status is NOT 'executed' in the failed response, plus previous_outputs. Unknown ids are refused — the resume channel binds to the COMPLETE plan, never to one slice's step list.",
+      "type": "string"
+    },
+    "retry_override": {
+      "description": "plan_execute (W5-08): authorizes ONE more round for a step that failed with the IDENTICAL error in 2+ consecutive rounds (a further unchanged re-run is refused pre-execution). The note is mandatory and audit-trailed.",
+      "type": "object",
+      "properties": {
+        "step_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The step named in the RETRY_LOCKED refusal (the repeated-failure guard's lock)."
+        },
+        "note": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Why one more round is justified — mandatory, echoed into the response as retry_override_applied for audit."
+        }
+      },
+      "required": [
+        "step_id",
+        "note"
+      ],
+      "additionalProperties": false
+    },
     "env": {
       "description": "Environment for on-chain execution (plan_execute): forwarded to the executor (e.g. { network: 'testnet' }).",
       "type": "object",
@@ -546,6 +571,20 @@
         "type": "string"
       },
       "additionalProperties": {}
+    },
+    "accounts": {
+      "description": "Per-step signing accounts (BSW-F04): named envs for steps that declare an `account` (currently 'arb_controller' — the independent third-party Arbitration controller, E_ARBITRATION_PERMISSION_CONFLICT=33). e.g. { arb_controller: { network: 'testnet' } }. A step declaring an account missing from this map FAILS — the default signer is never silently reused for an account-bound step.",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    },
+    "timeout_ms": {
+      "description": "plan_execute wall-clock budget for the WHOLE run (ktt4 RT-08): set it BELOW your transport timeout when the plan is too big for one window (~50 steps x ~6s each). The budget is checked BEFORE each step — a step is never interrupted mid-flight — and an exhausted budget stops the run CLEANLY, returning the partial steps/outputs that resume directly (re-send with completed_steps = every stepId whose status is 'executed', previous_outputs = outputs). Omit to run to completion (subject to your transport timeout).",
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
     }
   },
   "required": [

package/dist/schemas/bridge_operation.output.json

@@ -79,6 +79,8 @@
                 "delivery_unknown",
                 "capability_unavailable",
                 "transport_unavailable",
+                "peer_not_registered",
+                "submission_too_large",
                 "unknown"
               ]
             },
@@ -979,6 +981,92 @@
                 "top_risks"
               ],
               "additionalProperties": false
+            },
+            "blueprint_verdict": {
+              "description": "Creation-time blueprint verdict: business intent + host rich semantics + logic tree composed and run through the full per-host verification battery BEFORE the guard create tx. Present when binding_hint maps to a catalog host; absent when no host is known (add binding_hint to enable).",
+              "type": "object",
+              "properties": {
+                "host": {
+                  "type": "string",
+                  "description": "Catalog host id this guard was verified against (guard-host-context)."
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "blocked",
+                    "proceed_with_warnings",
+                    "proceed"
+                  ],
+                  "description": "Single authority over create readiness. blocked = structural defect, fix BEFORE create (guards are immutable after create)."
+                },
+                "statement": {
+                  "type": "string",
+                  "description": "One authoritative verdict statement naming the finding codes."
+                },
+                "findings": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "description": "Which verifier produced the finding (verifyGuardBinding / auditGuardRelies / auditQuoteGuardCandidate / blueprint)."
+                      },
+                      "code": {
+                        "type": "string",
+                        "description": "Stable finding id (e.g. MF_SLOT_IDENTITY_ANCHOR, RC_NO_ORDER_ANCHOR)."
+                      },
+                      "level": {
+                        "type": "string",
+                        "enum": [
+                          "critical",
+                          "warning",
+                          "info"
+                        ]
+                      },
+                      "detail": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "code",
+                      "level",
+                      "detail"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "All findings from the composed verification battery."
+                },
+                "host_context": {
+                  "description": "The host rich semantics this guard inherits — inlined so the design dialogue argues from facts, not memory.",
+                  "type": "object",
+                  "properties": {
+                    "signer_subject": {
+                      "type": "string"
+                    },
+                    "order_anchor": {
+                      "type": "string"
+                    },
+                    "identity_obligation": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "signer_subject",
+                    "order_anchor",
+                    "identity_obligation"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "required": [
+                "host",
+                "status",
+                "statement",
+                "findings"
+              ],
+              "additionalProperties": false
             }
           },
           "additionalProperties": false
@@ -1095,7 +1183,7 @@
               "description": "ALL reachable next-node directions (every operator/permission/guard disclosed)."
             },
             "recommendation": {
-              "description": "Recommended option with rationale (K3 Game intent/game/interests).",
+              "description": "Recommended option with rationale (K3 Game intent and interests).",
               "type": "object",
               "properties": {
                 "best": {
@@ -1342,7 +1430,7 @@
                   "description": "ALL reachable next-node directions (every operator/permission/guard disclosed)."
                 },
                 "recommendation": {
-                  "description": "Recommended option with rationale (K3 Game intent/game/interests).",
+                  "description": "Recommended option with rationale (K3 Game intent and interests).",
                   "type": "object",
                   "properties": {
                     "best": {
@@ -1374,6 +1462,14 @@
             "note": {
               "description": "Additional note.",
               "type": "string"
+            },
+            "digest": {
+              "description": "REAL transaction digest of this operation (ddmc4 B-37) — paste into onchain_transaction or a block explorer to audit. Absent under dry-run/simulation.",
+              "type": "string"
+            },
+            "signer": {
+              "description": "Signing account's on-chain address — a SEPARATE field from digest ({signer, digest}), never occupying the digest slot.",
+              "type": "string"
             }
           },
           "required": [

package/dist/schemas/bridge_operation.schema.json

@@ -68,7 +68,7 @@
               "type": "boolean"
             },
             "network": {
-              "description": "Omit in client/chat contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
+              "description": "Omit in chat-client contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
               "type": "string",
               "enum": [
                 "localnet",
@@ -208,7 +208,7 @@
               "type": "boolean"
             },
             "network": {
-              "description": "Omit in client/chat contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
+              "description": "Omit in chat-client contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
               "type": "string",
               "enum": [
                 "localnet",
@@ -326,7 +326,7 @@
               "type": "boolean"
             },
             "network": {
-              "description": "Omit in client/chat contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
+              "description": "Omit in chat-client contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
               "type": "string",
               "enum": [
                 "localnet",
@@ -444,7 +444,7 @@
               "type": "boolean"
             },
             "network": {
-              "description": "Omit in client/chat contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
+              "description": "Omit in chat-client contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
               "type": "string",
               "enum": [
                 "localnet",
@@ -594,7 +594,7 @@
               "type": "boolean"
             },
             "network": {
-              "description": "Omit in client/chat contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
+              "description": "Omit in chat-client contexts — the runtime stamps the user's CURRENT network (the client's UI selection). Standalone MCP/CLI: omit to use the current network; set ONLY when the user explicitly names a different network (a mismatch pauses for user confirmation). Never guess or hardcode a network.",
               "type": "string",
               "enum": [
                 "localnet",

package/dist/schemas/config_operation.output.json

@@ -438,6 +438,358 @@
           ],
           "additionalProperties": false
         },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "match_policy_read"
+            },
+            "path": {
+              "type": "string",
+              "description": "match-policy.json location (the file may not exist yet — the general config layer is opt-in)."
+            },
+            "exists": {
+              "type": "boolean",
+              "description": "Whether the config file currently exists. False → the layer is unused."
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Why the last read was rejected (null = healthy). The last good policies stay in force."
+            },
+            "demand_to_supply": {
+              "description": "The demand→supply matching policy from the general config file (absent when not configured)."
+            },
+            "supply_to_demand": {
+              "description": "The supply→demand matching policy from the general config file (absent when not configured)."
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "exists",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "match_policy_patch"
+            },
+            "applied": {
+              "type": "boolean",
+              "const": true,
+              "description": "Always true — a rejected patch throws instead of writing."
+            },
+            "path": {
+              "type": "string",
+              "description": "match-policy.json the patch was merged into."
+            },
+            "backup_path": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Backup of the previous file (null when no file existed before)."
+            },
+            "changed": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Dotted path of the changed value (arrays reported as one leaf)."
+                  },
+                  "old": {
+                    "description": "Previous value (null when the key is new)."
+                  },
+                  "new": {
+                    "description": "Value written to the config file."
+                  }
+                },
+                "required": [
+                  "path",
+                  "old",
+                  "new"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Leaf-level changes the patch made to the general match-strategy config."
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Post-write reload error (null = the new policies are in force)."
+            }
+          },
+          "required": [
+            "action",
+            "applied",
+            "path",
+            "backup_path",
+            "changed",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "match_policy_clear"
+            },
+            "cleared": {
+              "type": "boolean",
+              "description": "True when something was removed (the file or one direction's policy); false when there was nothing to clear."
+            },
+            "path": {
+              "type": "string",
+              "description": "match-policy.json location the clear applied to."
+            },
+            "scope": {
+              "type": "string",
+              "description": "What was cleared: 'file' (whole file), or the direction key that was removed."
+            },
+            "backup_path": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Backup of the previous file (null when no file existed before)."
+            }
+          },
+          "required": [
+            "action",
+            "cleared",
+            "path",
+            "scope",
+            "backup_path"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "template_params_read"
+            },
+            "path": {
+              "type": "string",
+              "description": "template-params.json location (the file may not exist yet — the standing business-parameter layer is opt-in)."
+            },
+            "exists": {
+              "type": "boolean",
+              "description": "Whether the config file currently exists. False → the layer is unused."
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Why the last read was rejected (null = healthy). Shipped template defaults stay in force."
+            },
+            "comment": {
+              "description": "Free-text comment carried through so the editor round-trips it.",
+              "type": "string"
+            },
+            "defaults": {
+              "description": "Standing fee-param defaults applied to EVERY template_generate (absent when not configured).",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              }
+            },
+            "templates": {
+              "description": "Per-template fee-param sections (absent when not configured).",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "string"
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "required": [
+            "action",
+            "path",
+            "exists",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "template_params_patch"
+            },
+            "applied": {
+              "type": "boolean",
+              "const": true,
+              "description": "Always true — a rejected patch throws instead of writing."
+            },
+            "path": {
+              "type": "string",
+              "description": "template-params.json the patch was merged into."
+            },
+            "backup_path": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Backup of the previous file (null when no file existed before)."
+            },
+            "changed": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Dotted path of the changed value ('defaults.x' / 'templates.<tpl-id>.y')."
+                  },
+                  "old": {
+                    "description": "Previous value (null when the key is new)."
+                  },
+                  "new": {
+                    "description": "Value written to the config file."
+                  }
+                },
+                "required": [
+                  "path",
+                  "old",
+                  "new"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Leaf-level changes the patch made to the standing business-parameter layer."
+            },
+            "error": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Post-write reload error (null = the new layer is in force)."
+            }
+          },
+          "required": [
+            "action",
+            "applied",
+            "path",
+            "backup_path",
+            "changed",
+            "error"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "template_params_clear"
+            },
+            "cleared": {
+              "type": "boolean",
+              "description": "True when something was removed (the file, the defaults section, or one template's section); false when there was nothing to clear."
+            },
+            "path": {
+              "type": "string",
+              "description": "template-params.json location the clear applied to."
+            },
+            "scope": {
+              "type": "string",
+              "description": "What was cleared: 'file' (whole file), 'defaults', or 'template'."
+            },
+            "template_id": {
+              "description": "Template id whose section was removed (scope 'template' only).",
+              "type": "string"
+            },
+            "backup_path": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Backup of the previous file (null when no file existed before)."
+            }
+          },
+          "required": [
+            "action",
+            "cleared",
+            "path",
+            "scope",
+            "backup_path"
+          ],
+          "additionalProperties": false
+        },
         {
           "type": "object",
           "properties": {

package/dist/schemas/config_operation.schema.json

@@ -19,6 +19,12 @@
         "judgment_reset",
         "judgment_doc_read",
         "judgment_doc_patch",
+        "match_policy_read",
+        "match_policy_patch",
+        "match_policy_clear",
+        "template_params_read",
+        "template_params_patch",
+        "template_params_clear",
         "store_dual_payout_get",
         "store_dual_payout_set",
         "store_dual_payout_clear"
@@ -34,7 +40,7 @@
       "type": "string"
     },
     "confirm": {
-      "description": "D-1 explicit human confirmation (required and MUST be true for store_dual_payout_set). Pass it ONLY after the human merchant reviewed and agreed that this store's rails may net arbitration compensation and escrow release on the same order. An automated agent must NOT set this — escalate to the human.",
+      "description": "D-1 explicit human confirmation (required and MUST be true for every PERSISTENT config write: store_dual_payout_set, judgment_doc_patch, match_policy_patch, match_policy_clear). Pass it ONLY after the human reviewed and approved the exact change. An automated agent must NOT set this — escalate to the human.",
       "type": "boolean"
     },
     "note": {
@@ -49,12 +55,24 @@
       "description": "New JSON value for judgment_set (type must match the existing entry at 'path')"
     },
     "patch": {
-      "description": "PARTIAL judgment document to deep-merge into the persistent user judgment document (required for judgment_doc_patch), e.g. {\"evaluation\": {\"weights\": {\"trust_reviews\": 45}}}. PERSISTENT write — validated in full before it touches the file; requires user confirmation.",
+      "description": "PARTIAL document to deep-merge into a persistent user config file (required for judgment_doc_patch and match_policy_patch). For judgment_doc_patch: a partial judgment document, e.g. {\"evaluation\": {\"weights\": {\"trust_reviews\": 45}}}. For match_policy_patch: {\"demand_to_supply\": {…}, \"supply_to_demand\": {…}} (either direction optional). PERSISTENT write — validated in full before it touches the file; requires user confirmation.",
       "type": "object",
       "propertyNames": {
         "type": "string"
       },
       "additionalProperties": {}
+    },
+    "direction": {
+      "description": "Match-policy direction (used by match_policy_clear: omit to clear the WHOLE match-policy.json file, pass to clear just that direction's policy)",
+      "type": "string",
+      "enum": [
+        "demand_to_supply",
+        "supply_to_demand"
+      ]
+    },
+    "template": {
+      "description": "Template id (template_params_clear): omit to clear the WHOLE template-params.json file, 'defaults' to clear only the defaults section, or '<industry>/<variant>' to clear only that template's section",
+      "type": "string"
     }
   },
   "required": [