@wowok/agent-mcp 3.3.9 → 3.4.1

package/dist/schemas/evaluation_operation.schema.json

@@ -924,6 +924,139 @@
       ],
       "additionalProperties": false
     },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "compose_generation"
+        },
+        "intent": {
+          "type": "string",
+          "minLength": 1,
+          "description": "K3-GA2 (G-A generator): the merchant's free-text business intent. Capability adoption is EVIDENCE-GATED — a module is adopted only by an intentSignals match on this text or an explicit `selections` entry; an intent that matches nothing is a blocker (COMPOSE-NO-CAPABILITY-EVIDENCE), never a silent default build."
+        },
+        "selections": {
+          "description": "Merchant-confirmed capability ids (adopted regardless of signal match). List registered ids via industry_pack_operation action='capability_list'.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "supply_chain": {
+          "description": "Cross-object/cross-Service procurement promises — compiled into money-gate steps on the generated plan and disclosed back under `supply_chain`.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "sub_service": {
+                "type": "string",
+                "description": "The procured sub-Service: an on-chain address or a resolvable name."
+              },
+              "axis": {
+                "type": "string",
+                "enum": [
+                  "merchant_procured",
+                  "user_procured"
+                ],
+                "description": "Who owns the fulfilment order — decides which money-gate ties are expressible."
+              },
+              "service_name": {
+                "description": "The host Service's own name (the money gate's host binding); omit = the generated plan's service step name.",
+                "type": "string"
+              },
+              "done_node": {
+                "type": "string",
+                "description": "The node whose arrival makes the order settle-eligible (e.g. 'completed')."
+              },
+              "done_node_alt": {
+                "description": "A further settle-eligible node.",
+                "type": "string"
+              },
+              "done_node_alt2": {
+                "description": "A further settle-eligible node.",
+                "type": "string"
+              },
+              "form": {
+                "description": "How the fulfilment fact reaches the host order's money gate (default 'rendezvous' — the only form that proves the pairing).",
+                "type": "string",
+                "enum": [
+                  "rendezvous",
+                  "submission"
+                ]
+              },
+              "fact_key": {
+                "description": "Policy key of the forward fulfilment row (default 'fulfilment').",
+                "type": "string"
+              },
+              "ack_key": {
+                "description": "Policy key of the buyer acknowledgement (default '<fact_key>_ack').",
+                "type": "string"
+              },
+              "ack_window_days": {
+                "description": "merchant_procured only: after this many days the buyer's silence counts as acknowledgement.",
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "payout_to": {
+                "description": "The fulfilment party's payout address. Absent = no third-party rail.",
+                "type": "string"
+              },
+              "payout_rate": {
+                "description": "Basis points of the settlement rail paid to payout_to (default 10000).",
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 10000
+              },
+              "repository": {
+                "description": "An existing rendezvous Repository name; one is created when omitted.",
+                "type": "string"
+              },
+              "repository_name": {
+                "description": "The name a CREATED rendezvous Repository takes (default '<host>_<sub>_ledger').",
+                "type": "string"
+              },
+              "service_step_id": {
+                "description": "Step id of the host Service in the plan being built (default 'service').",
+                "type": "string"
+              },
+              "id_prefix": {
+                "description": "Step-id prefix for the emitted objects (default 'sc').",
+                "type": "string"
+              }
+            },
+            "required": [
+              "sub_service",
+              "axis",
+              "done_node"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "inputs": {
+          "description": "Compile inputs; omitted = the carrier template's own defaults. Minimal honest sellable surface for the pilot carriers: { sales: [{ price: <smallest-unit integer> }] } (+ reward_funding when the carrier pays a review reward) — a plan without a sellable SKU fails reflux audit (PLAN-SALES-01) and comes back infeasible.",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        "name_base": {
+          "description": "Object name base; omit = the carrier template id ('/' -> '_').",
+          "type": "string"
+        },
+        "preferred_chain": {
+          "description": "Preferred pilot chain when the adopted set maps onto BOTH pilot chains (e.g. 'chain.data_subscription'); otherwise the first matching chain wins.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "intent"
+      ],
+      "additionalProperties": false
+    },
     {
       "type": "object",
       "properties": {
@@ -1182,6 +1315,32 @@
               },
               "owner": {
                 "type": "string"
+              },
+              "order_allocators": {},
+              "buyer_feedback": {
+                "type": "object",
+                "properties": {
+                  "total": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "likes": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "completed_orders": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  }
+                },
+                "required": [
+                  "total",
+                  "likes"
+                ],
+                "additionalProperties": false
               }
             },
             "required": [
@@ -1192,6 +1351,10 @@
             "additionalProperties": false
           }
         },
+        "demand_object": {
+          "description": "F-RQ-06 (prescription ⑫): YOUR on-chain Demand object ID (or mark name). When supplied, the handler reads the demand LIVE (presenters_count) at match time and derives `next` from real state — a published demand never gets demand.publish advice again; without it, `next` stays the static publish template with a verify-or-supply precondition.",
+          "type": "string"
+        },
         "presenter_history": {
           "type": "array",
           "items": {
@@ -1201,6 +1364,14 @@
                 "description": "Demand object that received the presentation.",
                 "type": "string"
               },
+              "presenter": {
+                "description": "F-RQ-10: the presenter (service object address) this record is about — records carrying it become that service's counterparty trust evidence (the on-chain writer is the demand OWNER, so the signal cannot be self-authored by the merchant); omit for legacy global-only acceptance scoring.",
+                "type": "string"
+              },
+              "presenter_service": {
+                "description": "tv8 F-28: the SERVICE object address the record is about (the value side of the on-chain DemandPresenter entry — the table key is the presenter ACCOUNT). Dual-domain matching accepts either this or `presenter`; chain-faithful readers fill BOTH.",
+                "type": "string"
+              },
               "acceptance_score": {
                 "anyOf": [
                   {
@@ -1545,6 +1716,14 @@
                 "description": "Demand object that received the presentation.",
                 "type": "string"
               },
+              "presenter": {
+                "description": "F-RQ-10: the presenter (service object address) this record is about — records carrying it become that service's counterparty trust evidence (the on-chain writer is the demand OWNER, so the signal cannot be self-authored by the merchant); omit for legacy global-only acceptance scoring.",
+                "type": "string"
+              },
+              "presenter_service": {
+                "description": "tv8 F-28: the SERVICE object address the record is about (the value side of the on-chain DemandPresenter entry — the table key is the presenter ACCOUNT). Dual-domain matching accepts either this or `presenter`; chain-faithful readers fill BOTH.",
+                "type": "string"
+              },
               "acceptance_score": {
                 "anyOf": [
                   {
@@ -1989,7 +2168,7 @@
           "type": "string"
         },
         "match_policy": {
-          "description": "R4 private policy (supply_to_demand direction, e.g. preset 'supplier_hunting'), resolved/applied entirely on-device. discover_demands applies gates+excludes only (no private scoring); weights/rerank are reported as not applicable in policy_effect.",
+          "description": "R4 private policy (supply_to_demand direction, e.g. preset 'supplier_hunting'), resolved/applied entirely on-device. discover_demands applies gates+excludes only (no private scoring); weights/rerank are reported as not applicable in policy_effect. Omitted: resolved from the stored chain — account persona match config → match-policy.json (general file) → system persona → engine defaults; policy_effect.policy_source reports the winning layer.",
           "anyOf": [
             {
               "type": "string"
@@ -2199,6 +2378,10 @@
         "no_cache": {
           "description": "Force fresh on-chain enumeration (bypass the configured local list cache).",
           "type": "boolean"
+        },
+        "account": {
+          "description": "The supplier's account address; its persona's supply_to_demand match config is auto-resolved when no match_policy is passed.",
+          "type": "string"
         }
       },
       "required": [
@@ -2384,7 +2567,7 @@
           "type": "string"
         },
         "match_policy": {
-          "description": "R4 private ranking policy (supply_to_demand direction, e.g. preset 'supplier_hunting'), resolved/applied entirely on-device; the policy and its hash never leave this device.",
+          "description": "R4 private ranking policy (supply_to_demand direction, e.g. preset 'supplier_hunting'), resolved/applied entirely on-device; the policy and its hash never leave this device. Omitted: resolved from the stored chain — account persona match config → match-policy.json (general file) → system persona → engine defaults; policy_effect.policy_source reports the winning layer.",
           "anyOf": [
             {
               "type": "string"
@@ -3093,6 +3276,14 @@
                 "description": "Demand object that received the presentation.",
                 "type": "string"
               },
+              "presenter": {
+                "description": "F-RQ-10: the presenter (service object address) this record is about — records carrying it become that service's counterparty trust evidence (the on-chain writer is the demand OWNER, so the signal cannot be self-authored by the merchant); omit for legacy global-only acceptance scoring.",
+                "type": "string"
+              },
+              "presenter_service": {
+                "description": "tv8 F-28: the SERVICE object address the record is about (the value side of the on-chain DemandPresenter entry — the table key is the presenter ACCOUNT). Dual-domain matching accepts either this or `presenter`; chain-faithful readers fill BOTH.",
+                "type": "string"
+              },
               "acceptance_score": {
                 "anyOf": [
                   {
@@ -3205,7 +3396,7 @@
           "type": "string"
         },
         "match_policy": {
-          "description": "R4 private ranking policy (K5-05 §4): a preset id (default, retail, life_service, trust_first, cross_border, cheap_and_fast, enterprise) or an inline policy object. Applied entirely on-device over the recalled candidates — gates/excludes/weights/rerank with honest `policy_effect` reporting; NEVER sent to the data service.",
+          "description": "R4 private ranking policy (K5-05 §4): a preset id (default, retail, life_service, trust_first, cross_border, cheap_and_fast, enterprise) or an inline policy object. Applied entirely on-device over the recalled candidates — gates/excludes/weights/rerank with honest `policy_effect` reporting; NEVER sent to the data service. Omitted: resolved from the stored chain — account persona match config → match-policy.json (general file) → system persona → engine defaults; policy_effect.policy_source reports the winning layer.",
           "anyOf": [
             {
               "type": "string"

package/dist/schemas/goal_operation.schema.json

@@ -1198,6 +1198,106 @@
                 "courier",
                 "pickup_point"
               ]
+            },
+            "supply_chain": {
+              "description": "Supply-chain composition (Goal 2/4): the Services this shop PROCURES fulfilment from. compile appends each promise's material (order_allocators-bound settlement gate, rendezvous ledger, optional third-party payout rail) BEFORE the Service publish and declares plan.inputs.fulfillment_axis. Incomplete or conflicting promises are compile blockers (SUPPLY_CHAIN_PROMISE_INCOMPLETE / _GATE_TEMPLATE / _ACK_WITHOUT_DEADLINE / _PAYOUT_RATE / _ID_CONFLICT). Absent = the shop fulfils everything itself.",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "sub_service": {
+                    "type": "string",
+                    "description": "The procured sub-Service: an on-chain address or a resolvable LocalMark/service name."
+                  },
+                  "axis": {
+                    "type": "string",
+                    "enum": [
+                      "merchant_procured",
+                      "user_procured"
+                    ],
+                    "description": "Who owns the fulfilment order. merchant_procured = this merchant buys it (the merchant-side rail pays payout_to and no cross-order owner tie is emitted); user_procured = the buyer buys it and presents the foreign order (the rail asserts order.owner(host) == order.owner(foreign))."
+                  },
+                  "service_name": {
+                    "description": "The host Service's own name (the money gate's host binding). Default: the plan's Service create name.",
+                    "type": "string"
+                  },
+                  "done_node": {
+                    "type": "string",
+                    "description": "The node whose arrival makes an order settle-eligible (e.g. 'completed' or 'delivered')."
+                  },
+                  "done_node_alt": {
+                    "description": "A further settle-eligible node — pass every optional post-settlement side action's node so the rail still fires after Praise moves progress.current.",
+                    "type": "string"
+                  },
+                  "done_node_alt2": {
+                    "description": "A third settle-eligible node.",
+                    "type": "string"
+                  },
+                  "form": {
+                    "description": "How the fulfilment fact reaches the money gate. rendezvous (default) proves the pairing through a shared ledger row; submission only records the caller-supplied foreign order address (P2 only, weaker).",
+                    "type": "string",
+                    "enum": [
+                      "rendezvous",
+                      "submission"
+                    ]
+                  },
+                  "fact_key": {
+                    "description": "Policy key of the forward fulfilment row. Default 'fulfilment'.",
+                    "type": "string"
+                  },
+                  "ack_key": {
+                    "description": "Policy key of the buyer acknowledgement. Default '<fact_key>_ack'.",
+                    "type": "string"
+                  },
+                  "ack_window_days": {
+                    "description": "merchant_procured only: days of buyer silence that count as acknowledgement, measured from the order's LAST entry into done_node. Default 3; 0 is refused (a costless veto).",
+                    "type": "number"
+                  },
+                  "payout_to": {
+                    "description": "The fulfilment party's payout address. Absent = no third-party rail (the host merchant settles the sub-service itself).",
+                    "type": "string"
+                  },
+                  "payout_rate": {
+                    "description": "Basis points (1..10000) of the settlement rail paid to payout_to. Default 10000.",
+                    "type": "number"
+                  },
+                  "repository": {
+                    "description": "An EXISTING rendezvous Repository name to reuse. Omit to create one (see repository_name).",
+                    "type": "string"
+                  },
+                  "repository_name": {
+                    "description": "The name a CREATED rendezvous Repository takes. Default '<service_name>_supply_chain'. Ignored when `repository` names an existing one.",
+                    "type": "string"
+                  },
+                  "id_prefix": {
+                    "description": "Step-id prefix for the emitted objects. Default 'sc' for the first promise, 'sc2', 'sc3'... for later ones. An explicit duplicate is refused (SUPPLY_CHAIN_ID_CONFLICT).",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "sub_service",
+                  "axis",
+                  "done_node"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "fee_overrides": {
+              "description": "P2-3: answers to the template's structured business questions (user_input_questions of the prior result), keyed by the fee_params name — e.g. { settlement_days: 20 }. Each entry is a compile input, so the answer overrides the template default; unanswered questions keep the default.",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              }
             }
           },
           "required": [
@@ -1413,6 +1513,89 @@
                 "courier",
                 "pickup_point"
               ]
+            },
+            "supply_chain": {
+              "description": "Step 6 confirmation: Supply-chain composition (Goal 2/4) — the Services this shop PROCURES fulfilment from. Emitted by compile as build material (rendezvous gate + ledger + optional third-party payout rail) before the Service publish.",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "sub_service": {
+                    "type": "string",
+                    "description": "The procured sub-Service: an on-chain address or a resolvable LocalMark/service name."
+                  },
+                  "axis": {
+                    "type": "string",
+                    "enum": [
+                      "merchant_procured",
+                      "user_procured"
+                    ],
+                    "description": "Who owns the fulfilment order. merchant_procured = this merchant buys it (the merchant-side rail pays payout_to and no cross-order owner tie is emitted); user_procured = the buyer buys it and presents the foreign order (the rail asserts order.owner(host) == order.owner(foreign))."
+                  },
+                  "service_name": {
+                    "description": "The host Service's own name (the money gate's host binding). Default: the plan's Service create name.",
+                    "type": "string"
+                  },
+                  "done_node": {
+                    "type": "string",
+                    "description": "The node whose arrival makes an order settle-eligible (e.g. 'completed' or 'delivered')."
+                  },
+                  "done_node_alt": {
+                    "description": "A further settle-eligible node — pass every optional post-settlement side action's node so the rail still fires after Praise moves progress.current.",
+                    "type": "string"
+                  },
+                  "done_node_alt2": {
+                    "description": "A third settle-eligible node.",
+                    "type": "string"
+                  },
+                  "form": {
+                    "description": "How the fulfilment fact reaches the money gate. rendezvous (default) proves the pairing through a shared ledger row; submission only records the caller-supplied foreign order address (P2 only, weaker).",
+                    "type": "string",
+                    "enum": [
+                      "rendezvous",
+                      "submission"
+                    ]
+                  },
+                  "fact_key": {
+                    "description": "Policy key of the forward fulfilment row. Default 'fulfilment'.",
+                    "type": "string"
+                  },
+                  "ack_key": {
+                    "description": "Policy key of the buyer acknowledgement. Default '<fact_key>_ack'.",
+                    "type": "string"
+                  },
+                  "ack_window_days": {
+                    "description": "merchant_procured only: days of buyer silence that count as acknowledgement, measured from the order's LAST entry into done_node. Default 3; 0 is refused (a costless veto).",
+                    "type": "number"
+                  },
+                  "payout_to": {
+                    "description": "The fulfilment party's payout address. Absent = no third-party rail (the host merchant settles the sub-service itself).",
+                    "type": "string"
+                  },
+                  "payout_rate": {
+                    "description": "Basis points (1..10000) of the settlement rail paid to payout_to. Default 10000.",
+                    "type": "number"
+                  },
+                  "repository": {
+                    "description": "An EXISTING rendezvous Repository name to reuse. Omit to create one (see repository_name).",
+                    "type": "string"
+                  },
+                  "repository_name": {
+                    "description": "The name a CREATED rendezvous Repository takes. Default '<service_name>_supply_chain'. Ignored when `repository` names an existing one.",
+                    "type": "string"
+                  },
+                  "id_prefix": {
+                    "description": "Step-id prefix for the emitted objects. Default 'sc' for the first promise, 'sc2', 'sc3'... for later ones. An explicit duplicate is refused (SUPPLY_CHAIN_ID_CONFLICT).",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "sub_service",
+                  "axis",
+                  "done_node"
+                ],
+                "additionalProperties": false
+              }
             }
           },
           "additionalProperties": false

package/dist/schemas/guard2file.schema.json

@@ -51,7 +51,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/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-10-27T23:37:53.947Z",
+  "generatedAt": "2026-11-02T06:06:26.283Z",
   "tools": [
     {
       "name": "onchain_operations",