@wowok/agent-mcp 3.3.9 → 3.4.1

package/dist/schemas/onchain_table_data.output.json

@@ -692,7 +692,7 @@
                                         }
                                       },
                                       "additionalProperties": false,
-                                      "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                      "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                     },
                                     {
                                       "type": "string"
@@ -717,6 +717,7 @@
                                       "type": "object",
                                       "properties": {
                                         "entities": {
+                                          "minItems": 1,
                                           "type": "array",
                                           "items": {
                                             "type": "object",
@@ -731,7 +732,7 @@
                                               }
                                             },
                                             "additionalProperties": false,
-                                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                           }
                                         },
                                         "check_all_founded": {
@@ -1681,7 +1682,7 @@
                                           }
                                         },
                                         "additionalProperties": false,
-                                        "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                        "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                       },
                                       {
                                         "type": "string"
@@ -1706,6 +1707,7 @@
                                         "type": "object",
                                         "properties": {
                                           "entities": {
+                                            "minItems": 1,
                                             "type": "array",
                                             "items": {
                                               "type": "object",
@@ -1720,7 +1722,7 @@
                                                 }
                                               },
                                               "additionalProperties": false,
-                                              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                              "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                             }
                                           },
                                           "check_all_founded": {
@@ -4298,7 +4300,7 @@
                                               }
                                             },
                                             "additionalProperties": false,
-                                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                           },
                                           {
                                             "type": "string"
@@ -4323,6 +4325,7 @@
                                             "type": "object",
                                             "properties": {
                                               "entities": {
+                                                "minItems": 1,
                                                 "type": "array",
                                                 "items": {
                                                   "type": "object",
@@ -4337,7 +4340,7 @@
                                                     }
                                                   },
                                                   "additionalProperties": false,
-                                                  "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                                  "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                                 }
                                               },
                                               "check_all_founded": {
@@ -6398,11 +6401,111 @@
                         "additionalProperties": false
                       },
                       "description": "Directed supply-chain edges: each forward's purchased sub-services + required proofs."
+                    },
+                    "rails": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "guard": {
+                            "type": "string",
+                            "description": "The allocator-bound Guard that gates this Service's money."
+                          },
+                          "purchased_services": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "identifier": {
+                                  "type": "integer",
+                                  "minimum": 0,
+                                  "maximum": 255,
+                                  "description": "Guard table identifier."
+                                },
+                                "name": {
+                                  "type": "string",
+                                  "description": "Guard table item name (the emitter's catalog slot name)."
+                                },
+                                "address": {
+                                  "type": "string",
+                                  "description": "The procured sub-Service address (or LocalMark name if not resolvable)."
+                                }
+                              },
+                              "required": [
+                                "identifier",
+                                "name",
+                                "address"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "description": "Foreign-Service commitments carried as constant Address rows (self-pins and the ledger row excluded)."
+                          },
+                          "required_submissions": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "identifier": {
+                                  "type": "integer",
+                                  "minimum": 0,
+                                  "maximum": 255,
+                                  "description": "Guard table identifier."
+                                },
+                                "name": {
+                                  "type": "string",
+                                  "description": "Guard table item name (human-readable field name)."
+                                },
+                                "value_type": {
+                                  "type": "string",
+                                  "description": "Expected value type name (e.g. Address, U64, String)."
+                                }
+                              },
+                              "required": [
+                                "identifier",
+                                "name",
+                                "value_type"
+                              ],
+                              "additionalProperties": false
+                            },
+                            "description": "Order-slot rows the gate expects the caller to submit."
+                          },
+                          "ledger": {
+                            "description": "The rendezvous Repository the gate reads rows from (present when the gate reads a ledger bound to this Service).",
+                            "type": "string"
+                          },
+                          "once_slot": {
+                            "type": "boolean",
+                            "description": "A protocol 255 once row is present — the submission form's single-use key."
+                          },
+                          "axis": {
+                            "description": "Who owns the fulfilment order, as stated by the gate's own description.",
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "const": "merchant_procured"
+                              },
+                              {
+                                "type": "string",
+                                "const": "user_procured"
+                              }
+                            ]
+                          }
+                        },
+                        "required": [
+                          "guard",
+                          "purchased_services",
+                          "required_submissions",
+                          "once_slot"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "Settlement rails gated on a FOREIGN order (order_allocators binding). Empty when this Service has no composition. The on-chain Guard stores no logic tree, so these facts come from the guard's table slot names and description — the emitter's own vocabulary."
                     }
                   },
                   "required": [
                     "service",
-                    "edges"
+                    "edges",
+                    "rails"
                   ],
                   "additionalProperties": false
                 },
@@ -8336,7 +8439,7 @@
                                                       }
                                                     },
                                                     "additionalProperties": false,
-                                                    "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                                    "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                                   },
                                                   {
                                                     "type": "string"
@@ -8361,6 +8464,7 @@
                                                     "type": "object",
                                                     "properties": {
                                                       "entities": {
+                                                        "minItems": 1,
                                                         "type": "array",
                                                         "items": {
                                                           "type": "object",
@@ -8375,7 +8479,7 @@
                                                             }
                                                           },
                                                           "additionalProperties": false,
-                                                          "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                                                          "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                                                         }
                                                       },
                                                       "check_all_founded": {
@@ -9042,8 +9146,12 @@
               "type": "string",
               "const": "service_panorama"
             },
+            "object_address": {
+              "description": "On-chain Service object address (or LocalMark name). Required when query_type='service_panorama'. PREFERRED field name — the panorama family (service/machine/object) is unified on `object_address` (a Service IS an on-chain object); `service_address` remains accepted as a deprecated alias.",
+              "type": "string"
+            },
             "service_address": {
-              "description": "On-chain Service object address (or LocalMark name). Required when query_type='service_panorama'.",
+              "description": "DEPRECATED alias of object_address (accepted for call compatibility). Prefer object_address. Example: {\"query_type\": \"service_panorama\", \"object_address\": \"0xabc...\"}.",
               "type": "string"
             },
             "context_network": {
@@ -9069,9 +9177,13 @@
               "type": "string",
               "const": "service_quote"
             },
+            "object_address": {
+              "description": "On-chain Service object address (or LocalMark name). Required when query_type='service_quote'. PREFERRED field name — unified with the panorama family on `object_address`; `service_address` remains accepted as a deprecated alias.",
+              "type": "string"
+            },
             "service_address": {
-              "type": "string",
-              "description": "On-chain Service object address (or LocalMark name). Required when query_type='service_quote'."
+              "description": "DEPRECATED alias of object_address (accepted for call compatibility). Prefer object_address. Example: {\"query_type\": \"service_quote\", \"object_address\": \"0xabc...\"}.",
+              "type": "string"
             },
             "items": {
               "description": "Basket to quote. Omit to quote EVERY sale with quantity 1 (the floor basket — order quantity is chosen at buy time, so per-unit prices are the authoritative input).",
@@ -9120,8 +9232,7 @@
             }
           },
           "required": [
-            "query_type",
-            "service_address"
+            "query_type"
           ],
           "additionalProperties": false,
           "description": "READ-ONLY pre-purchase quote of a Service (finding 3.6 — order_new total_pay pre-check): per-item unit price × quantity, the basket total that order_new.buy.total_pay.balance must exactly equal (the on-chain buy aborts on any drift), and the order_allocators fee-split preview (sharing rows of the FIRST allocator — the normal payout path; guards select per-case allocators such as refund/damage, so the live split depends on which guard passes). Also previews the reward terms of every Reward hung on the Service (pool balance, per-claim amount, claim window) so a buyer never budgets on an expired or unfunded reward. Mirrors the on-chain price×quantity semantics WITHOUT calling quote on-chain and NEVER submits a transaction. Amounts are payment-token smallest units plus a human display when the token precision resolves."
@@ -9417,6 +9528,57 @@
           "additionalProperties": false,
           "description": "In-flight order participation analysis for ONE account (GLM6/94): customer / operator / observer perspective derived from on-chain permission matching (never caller-asserted) — per-order operable forwards (branch choices), waiting_on roles, pending claims (reward/discount/compensation/rating), perspective-specific interest hints, aggregated account dashboard. Read-only."
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "order_aggregate"
+            },
+            "group": {
+              "description": "Grouping dimension, read from each Order's own fields: 'service' (default — the crowd/group-buy pool per service), 'machine' (per workflow) or 'owner' (per ordering account).",
+              "type": "string",
+              "enum": [
+                "service",
+                "machine",
+                "owner"
+              ]
+            },
+            "group_id": {
+              "description": "Restrict the aggregation to ONE group value (exact address match — e.g. the Service address running a crowd-funding campaign). The funding-target verdict then reads a single row.",
+              "type": "string"
+            },
+            "metric": {
+              "description": "Numeric field to sum (default 'amount' — the Order's escrowed payment in smallest units).",
+              "type": "string",
+              "const": "amount"
+            },
+            "exclude_claimed": {
+              "description": "Exclude orders whose compensation has been claimed (claimed_by set). Default false — pass true so refund/compensation payouts are not double-counted toward a target.",
+              "type": "boolean"
+            },
+            "limit": {
+              "description": "Max group rows returned (default 50, max 1000). truncated flags rows beyond the limit; totals ALWAYS cover the full set regardless of the limit.",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000
+            },
+            "context_network": {
+              "type": "string",
+              "enum": [
+                "testnet",
+                "mainnet",
+                "localnet"
+              ],
+              "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+            }
+          },
+          "required": [
+            "query_type"
+          ],
+          "additionalProperties": false,
+          "description": "CROSS-ORDER aggregate over Order objects from the MCP index projection (S17-C / F-RQD2-06): count + exact amount sums per group, with the projection's reconciliation coverage attached. Read-side stand-in for the missing on-chain cross-order primitive — crowd/group-buy targets like '3 x 6 WOW >= 18 WOW before funding' are checked HERE until the protocol grows a native aggregate. A STALE projection refuses to answer loudly (INDEX_STALE_PROJECTION — no legacy fallback can aggregate) instead of serving a funding verdict on old data. Read-only."
+        },
         {
           "type": "object",
           "properties": {
@@ -9664,7 +9826,7 @@
               ]
             },
             "facets": {
-              "description": "Per-call facet overrides keyed by the ten facet ids (fund_safety/reputation/arbitration/fulfillment/offering_price/workflow/fund_flow/supply_chain/permission/my_stakes). Highest-precedence lens over role/industry/persona defaults; unknown facet ids are ignored.",
+              "description": "Per-call facet overrides keyed by the ten facet ids (fund_safety/reputation/arbitration/fulfillment/offering_price/workflow/fund_flow/supply_chain/permission/my_stakes). Highest-precedence lens over the role, industry and persona defaults; unknown facet ids are ignored.",
               "type": "object",
               "propertyNames": {
                 "type": "string"
@@ -10660,6 +10822,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
@@ -10776,7 +11024,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": {
@@ -11023,7 +11271,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": {
@@ -11055,6 +11303,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": [
@@ -11464,7 +11720,7 @@
                         }
                       },
                       "additionalProperties": false,
-                      "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                      "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                     },
                     {
                       "type": "string"
@@ -11489,6 +11745,7 @@
                       "type": "object",
                       "properties": {
                         "entities": {
+                          "minItems": 1,
                           "type": "array",
                           "items": {
                             "type": "object",
@@ -11503,7 +11760,7 @@
                               }
                             },
                             "additionalProperties": false,
-                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account."
+                            "description": "Account or address lookup object. Use this to specify which account to use for an operation. EXAMPLE: { name_or_address: 'testor2' } - looks up account by name; EXAMPLE: { name_or_address: '0x1234...' } - uses address directly; If name_or_address is empty string '', uses the default local account. name_or_address is REQUIRED — {} resolves to nothing useful and is rejected."
                           }
                         },
                         "check_all_founded": {