@wowok/agent-mcp 3.3.8 → 3.4.0

package/dist/schemas/industry_pack_operation.output.json

@@ -409,7 +409,9 @@
                 "supply",
                 "rules",
                 "playbook",
-                "template"
+                "template",
+                "params",
+                "components"
               ]
             },
             "kind": {
@@ -511,6 +513,153 @@
               ],
               "additionalProperties": false
             },
+            "query": {
+              "description": "Echoes the 'query' used to rank parameters.",
+              "type": "string"
+            },
+            "param_summary": {
+              "description": "Counts over the returned param plane (absent unless layer='params').",
+              "type": "object",
+              "properties": {
+                "total": {
+                  "type": "number",
+                  "description": "Declared parameters of this template."
+                },
+                "editable": {
+                  "type": "number",
+                  "description": "Parameters the front stage may render as an editable control."
+                },
+                "live": {
+                  "type": "number",
+                  "description": "Parameters proven to change the compiled plan."
+                },
+                "inert": {
+                  "type": "number",
+                  "description": "Parameters that compile to the same plan (shown, not offered)."
+                },
+                "not_flippable": {
+                  "type": "number",
+                  "description": "Parameters with no numeric probe (free-text)."
+                },
+                "hidden": {
+                  "type": "number",
+                  "description": "Prose directives: listed for completeness, never offered."
+                },
+                "undescribed": {
+                  "type": "number",
+                  "description": "Rows whose meaning is not curated yet (honest fallback)."
+                }
+              },
+              "required": [
+                "total",
+                "editable",
+                "live",
+                "inert",
+                "not_flippable",
+                "hidden",
+                "undescribed"
+              ],
+              "additionalProperties": false
+            },
+            "params": {
+              "description": "Full param plane in business order: key, tier/tier_name, tags, kind (money/ratio/duration/count/enum/flag/text/list), unit/unit_hint, meaning, bounds (enterable range: rates 0..10000, amounts/counts non-negative), default, allowed values (enums), disclosure, selector, status, effect, landing, landing_line, editable, inert_reason (why a row cannot be set).",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {}
+              }
+            },
+            "param_matches": {
+              "description": "Ranked parameter hits for 'query' — each carries score + explainable reasons (key / key-word / tag / alias / meaning / facet). Empty means the phrase names no setting. A query made only of tag names ('pricing', 'risk') is a facet request: it returns that slice in tier order.",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {}
+              }
+            },
+            "component_summary": {
+              "description": "Counts over the returned component plane (absent unless layer='components').",
+              "type": "object",
+              "properties": {
+                "total": {
+                  "type": "number",
+                  "description": "Components on the plane for this template."
+                },
+                "configurable": {
+                  "type": "number",
+                  "description": "Components the merchant can configure."
+                },
+                "fixed": {
+                  "type": "number",
+                  "description": "Components that cannot be configured (each carries why_not)."
+                },
+                "hardcoded_splits": {
+                  "type": "number",
+                  "description": "Allocator rows whose money split is a genuine literal in the template body (rail/unset/surplus rows excluded — they are not splits)."
+                },
+                "structural_rails": {
+                  "type": "number",
+                  "description": "Allocator rows that pay the entire escrow (100%): the payout rail itself, not a rate."
+                },
+                "unset_legs": {
+                  "type": "number",
+                  "description": "Allocator rows at 0 bps: declared placeholder legs (usually the order-side residual of a two-leg group)."
+                },
+                "surplus_rows": {
+                  "type": "number",
+                  "description": "Allocator rows whose size is the remainder of the other rows."
+                },
+                "by_family": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "number"
+                  },
+                  "description": "Component counts by family (service/sales/allocator/allocation/machine/guard/repository/reward/arbitration/permission/treasury)."
+                }
+              },
+              "required": [
+                "total",
+                "configurable",
+                "fixed",
+                "hardcoded_splits",
+                "structural_rails",
+                "unset_legs",
+                "surplus_rows",
+                "by_family"
+              ],
+              "additionalProperties": false
+            },
+            "components": {
+              "description": "Full component plane: id, family, what (business meaning), how (surface: create / pre-publish / append-only / post-publish / immutable, and via: the MCP field path), effect (what changes on chain once it takes effect), related (bound objects / guard / fee_param / node), configurable, freeze (allocator rows only: rail = full-escrow payout rail, unset = 0 bps placeholder leg, split = genuine split frozen in the template body, surplus = remainder row), why_not (present on every non-configurable component).",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {}
+              }
+            },
+            "component_matches": {
+              "description": "Ranked component hits for 'query' (per-template), each headed by its template id. Empty means the phrase names no component — nothing is guessed.",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {}
+              }
+            },
             "dispute": {
               "description": "Registered dispute rules (if any)."
             },

package/dist/schemas/industry_pack_operation.schema.json

@@ -45,7 +45,7 @@
       "type": "string"
     },
     "layer": {
-      "description": "Optional single-layer selector for action='get'. Non-template values return ONLY that registered pack layer and refuse with a named error when the pack does not register it (stub packs carry only mode/match). 'template' reads the builtin catalog: with 'template' set, one full template projection; without it, the industry's template summaries.",
+      "description": "Optional single-layer selector for action='get'. Non-template values return ONLY that registered pack layer and refuse with a named error when the pack does not register it (stub packs carry only mode/match). 'template' reads the builtin catalog: with 'template' set, one full template projection; without it, the industry's template summaries. 'params' is the merchant-facing settings surface: with 'template' set, every declared parameter of that template in business order (meaning, unit, default, accepted values, proven status, landing, editable); without a template id it requires 'query' and searches the catalog for the business facet. 'components' is the companion object surface: every Service/Sale/allocator/allocation/machine/guard/repository component with what it is, HOW to configure it (surface + field path) and WHEN, the effect once it takes effect, and the objects it is bound to — a component that cannot be configured states why (e.g. a money split hard-coded in the template body).",
       "type": "string",
       "enum": [
         "mode",
@@ -55,11 +55,17 @@
         "supply",
         "rules",
         "playbook",
-        "template"
+        "template",
+        "params",
+        "components"
       ]
     },
+    "query": {
+      "description": "Free-text business phrase (e.g. 'settlement window', 'take rate', 'cancel fee', 'allocator split', 'repository policy') used with action='get' + layer='params' or layer='components' to RANK that plane. A phrase that names nothing returns an empty match list — never the least-bad row.",
+      "type": "string"
+    },
     "template": {
-      "description": "Builtin template id '<industry>/<variant>' (e.g. 'rental/p2p-shortstay'); used with action='get' + layer='template'.",
+      "description": "Builtin template id '<industry>/<variant>' (e.g. 'rental/p2p-shortstay'); used with action='get' + layer='template' / 'params' / 'components'.",
       "type": "string"
     },
     "path": {

package/dist/schemas/keeper_operation.output.json

@@ -990,7 +990,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": {
@@ -1237,7 +1237,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": {

package/dist/schemas/local_cache_operation.output.json

@@ -273,6 +273,8 @@
                 "delivery_unknown",
                 "capability_unavailable",
                 "transport_unavailable",
+                "peer_not_registered",
+                "submission_too_large",
                 "unknown"
               ]
             },
@@ -1265,7 +1267,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": {
@@ -1512,7 +1514,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": {

package/dist/schemas/local_history_operation.output.json

@@ -199,6 +199,8 @@
                 "delivery_unknown",
                 "capability_unavailable",
                 "transport_unavailable",
+                "peer_not_registered",
+                "submission_too_large",
                 "unknown"
               ]
             },
@@ -1191,7 +1193,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": {
@@ -1438,7 +1440,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": {

package/dist/schemas/local_info_operation.output.json

@@ -85,6 +85,8 @@
                 "delivery_unknown",
                 "capability_unavailable",
                 "transport_unavailable",
+                "peer_not_registered",
+                "submission_too_large",
                 "unknown"
               ]
             },
@@ -1077,7 +1079,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": {
@@ -1324,7 +1326,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": {

package/dist/schemas/local_mark_operation.output.json

@@ -177,6 +177,8 @@
                 "delivery_unknown",
                 "capability_unavailable",
                 "transport_unavailable",
+                "peer_not_registered",
+                "submission_too_large",
                 "unknown"
               ]
             },
@@ -1169,7 +1171,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": {
@@ -1416,7 +1418,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": {

package/dist/schemas/machineNode2file.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/messenger_operation.output.json

@@ -751,6 +751,17 @@
                     "type": "string"
                   },
                   "description": "LocalInfo field names that were assembled and sent"
+                },
+                "fields_ignored": {
+                  "description": "When explicit content was supplied alongside `fields`: the requested fields that were NOT sent (content takes precedence). Empty/absent means every assembled field was delivered",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "note": {
+                  "description": "Mechanism disclosure attached when fields were ignored due to content precedence",
+                  "type": "string"
                 }
               },
               "required": [
@@ -4230,7 +4241,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": {
@@ -4477,7 +4488,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": {