@wowok/agent-mcp 3.2.6 → 3.2.7

package/dist/schemas/query_toolkit.output.json

@@ -2489,7 +2489,7 @@
                                   },
                                   {}
                                 ],
-                                "description": "Lock duration for critical operations. Anchored to the 'paused_time' timestamp. After Service is published, only the following operations are gated by this lock: (1) compensation_fund_withdraw, (2) rewards remove/clear, (3) arbitrations remove/clear. All require the Service to be paused AND paused_time + setting_lock_duration <= current clock. Adding rewards/arbitrations, modifying sales/description/location/buy_guard/customer_required/um, and depositing to compensation_fund are NOT gated by this lock. order_allocators and machine are permanently immutable after publish (not related to this lock)."
+                                "description": "Lock duration for critical operations. Anchored to the 'paused_time' timestamp. After Service is published, only the following operations are gated by this lock: (1) compensation_fund_withdraw, (2) rewards remove/clear, (3) arbitrations remove/clear. All require the Service to be paused AND paused_time + setting_lock_duration <= current clock. Adding rewards/arbitrations, modifying sales/description/location/buy_guard/customer_required/um, and depositing to compensation_fund are NOT gated by this lock. Rationale (deliberate design): the lock only gates REVOKING buyer-facing guarantees that placed orders rely on, protecting buyer expectations — it is not a restriction on daily operations. order_allocators and machine are permanently immutable after publish (not related to this lock)."
                               },
                               "order_allocators": {
                                 "anyOf": [
@@ -9275,7 +9275,7 @@
                                     "type": "null"
                                   }
                                 ],
-                                "description": "Minimum order total for the discount to apply (smallest units) — when set, the discount applies only if the PRE-discount order total is greater than or equal to this value. null (or 0) means NO threshold, so the discount applies UNCONDITIONALLY. Sharp edge: an order below a set threshold is NOT rejected — it completes at FULL price and the one-time coupon object is still consumed and destroyed."
+                                "description": "Minimum order total for the discount to apply (smallest units) — when set, the discount applies only if the PRE-discount order total is greater than or equal to this value. null (or 0) means NO threshold, so the discount applies UNCONDITIONALLY. Sharp edge: an order below a set threshold cannot use this coupon — buy aborts with the coupon attached (error 38, full rollback, coupon preserved); dropping the coupon completes the order at FULL price and the coupon is retained."
                               },
                               "off": {
                                 "anyOf": [
@@ -16316,7 +16316,7 @@
                     },
                     "note": {
                       "type": "string",
-                      "description": "order_new.buy.total_pay.balance must equal this exactly — the on-chain buy aborts on any drift."
+                      "description": "order_new.buy.total_pay.balance must equal this exactly when passed explicitly — the on-chain buy aborts on any drift. Without a discount you may omit total_pay entirely: the buy auto-derives this exact total (M-K17)."
                     }
                   },
                   "required": [
@@ -16466,6 +16466,167 @@
                     }
                   ],
                   "description": "FIRST allocator's sharing rows — the normal payout path. null when no allocators are configured."
+                },
+                "reward_terms": {
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "note": {
+                          "type": "string"
+                        },
+                        "rewards": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "reward": {
+                                "type": "string",
+                                "description": "Reward object address (hung on the Service, bound at build time)."
+                              },
+                              "description": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
+                              "pool_balance": {
+                                "type": "string",
+                                "description": "Raw smallest units currently in the Reward pool."
+                              },
+                              "pool_balance_display": {
+                                "type": "string"
+                              },
+                              "record_count": {
+                                "type": "integer",
+                                "minimum": -9007199254740991,
+                                "maximum": 9007199254740991,
+                                "description": "Claims recorded in the per-address ledger so far."
+                              },
+                              "claims": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "guard": {
+                                      "type": "string",
+                                      "description": "Claim guard address — the buyer must pass this guard's conditions to claim."
+                                    },
+                                    "amount_type": {
+                                      "type": "string",
+                                      "enum": [
+                                        "fixed",
+                                        "guard_submission"
+                                      ],
+                                      "description": "'fixed' = constant smallest-units amount; 'guard_submission' = the amount comes from the guard passport submission (not predictable at quote time)."
+                                    },
+                                    "amount": {
+                                      "type": "string",
+                                      "description": "Fixed: raw smallest units. guard_submission: the submission identifier."
+                                    },
+                                    "amount_display": {
+                                      "anyOf": [
+                                        {
+                                          "type": "string"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ]
+                                    },
+                                    "expiration_time": {
+                                      "anyOf": [
+                                        {
+                                          "type": "number"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ],
+                                      "description": "Claim deadline, ms epoch; null = no window (claimable until the guard is removed/expires)."
+                                    },
+                                    "expiration_display": {
+                                      "anyOf": [
+                                        {
+                                          "type": "string"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ]
+                                    },
+                                    "expired": {
+                                      "anyOf": [
+                                        {
+                                          "type": "boolean"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ],
+                                      "description": "True when the claim window had already passed at quote time; null when no window is set."
+                                    }
+                                  },
+                                  "required": [
+                                    "guard",
+                                    "amount_type",
+                                    "amount",
+                                    "amount_display",
+                                    "expiration_time",
+                                    "expiration_display",
+                                    "expired"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              },
+                              "coverage": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "description": "How many further claims the pool can fund at the largest fixed per-claim amount (empty-pool warning when 0); null when amounts are guard-decided."
+                              }
+                            },
+                            "required": [
+                              "reward",
+                              "description",
+                              "pool_balance",
+                              "pool_balance_display",
+                              "record_count",
+                              "claims",
+                              "coverage"
+                            ],
+                            "additionalProperties": false
+                          }
+                        },
+                        "data_gaps": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          },
+                          "description": "Rewards that could not be read — their terms are unknown, do not rely on them."
+                        }
+                      },
+                      "required": [
+                        "note",
+                        "rewards",
+                        "data_gaps"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Pre-order reward terms (review component, INV-4 buyer side): every Reward hung on the Service (bound at build time) with pool balance, per-claim amount and claim window — a claim aborts after its window (E_GUARD_EXPIRED) or against an empty pool (E_INSUFFICIENT_BALANCE), so never budget on an expired or empty reward. null when the Service carries no rewards. Read-only."
                 }
               },
               "required": [
@@ -16476,10 +16637,11 @@
                 "items",
                 "total_pay",
                 "discount",
-                "allocation_preview"
+                "allocation_preview",
+                "reward_terms"
               ],
               "additionalProperties": false,
-              "description": "ServiceQuote (basket prices, total_pay and the allocator fee-split preview)."
+              "description": "ServiceQuote (basket prices, total_pay, the allocator fee-split preview and reward terms)."
             }
           },
           "required": [
@@ -17053,7 +17215,8 @@
                                 "reward",
                                 "discount",
                                 "compensation",
-                                "rating"
+                                "rating",
+                                "review"
                               ]
                             },
                             "label": {
@@ -17499,7 +17662,8 @@
                                 "reward",
                                 "discount",
                                 "compensation",
-                                "rating"
+                                "rating",
+                                "review"
                               ]
                             },
                             "label": {
@@ -17739,7 +17903,8 @@
                           "reward",
                           "discount",
                           "compensation",
-                          "rating"
+                          "rating",
+                          "review"
                         ]
                       },
                       "label": {
@@ -22376,6 +22541,50 @@
             "current_node"
           ],
           "additionalProperties": false
+        },
+        "review_steps": {
+          "description": "Composite review submission report: the structured-reputation repository write (+ optional reward claim) chained after a successful progress forward via the data.review block, each reusing the forward's passport submission. Fail-isolated — a failed step never rolled back the forward. Relay failed steps to the user with the retry path (dedicated repository/reward tools).",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step": {
+                "type": "string",
+                "enum": [
+                  "repository_write",
+                  "reward_claim"
+                ],
+                "description": "Which chained review step this report describes. repository_write = structured reputation record (rating/tags) into the caller-named Repository; reward_claim = incentive claim on the caller-named Reward."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "success",
+                  "failed"
+                ],
+                "description": "Step outcome. Steps are fail-isolated: a failed step never affects the forward or the other step (on-chain has no rollback)."
+              },
+              "detail": {
+                "type": "string",
+                "description": "On success: what was written/claimed (payload summary). On failure: what the step attempted."
+              },
+              "digest": {
+                "description": "Transaction digest when the step succeeded.",
+                "type": "string"
+              },
+              "error": {
+                "description": "Error message when the step failed. Retry via the dedicated repository/reward tools with the same submission values.",
+                "type": "string"
+              }
+            },
+            "required": [
+              "step",
+              "status",
+              "detail"
+            ],
+            "additionalProperties": false,
+            "description": "One fail-isolated chained step of the progress composite review submission (REVIEW component, data.review block)."
+          }
         }
       },
       "required": [
@@ -22889,7 +23098,7 @@
                       "type": "string"
                     }
                   ],
-                  "description": "When specified, the query retrieves data from the associated (witness) object instead of the queried object itself. This enables cross-object queries within Guard validation logic. Can be a numeric ID (100-108) or a string name (case-insensitive, with or without the 'Type' prefix). String format is recommended for readability.\n\nAvailable WitnessTypes:\n- OrderProgress / TypeOrderProgress (100): Query an Order's associated Progress object. Use case: Check if order has reached a specific workflow node (e.g., 'complete') before allowing reward claims.\n- OrderMachine / TypeOrderMachine (101): Query an Order's associated Machine (workflow definition). Use case: Verify the workflow structure or check node configurations.\n- OrderService / TypeOrderService (102): Query an Order's parent Service object. Use case: Validate the service offering details or check service-level configurations.\n- ProgressMachine / TypeProgressMachine (103): Query a Progress's associated Machine. Use case: Access workflow definition from a Progress context.\n- ArbOrder / TypeArbOrder (104): Query an Arb's associated Order. Use case: In arbitration voting guards, verify order details like payment amount or service ID.\n- ArbArbitration / TypeArbArbitration (105): Query an Arb's parent Arbitration service. Use case: Access arbitration configuration or fee settings from within an Arb case.\n- ArbProgress / TypeArbProgress (106): Query an Arb's associated Progress. Use case: Check order workflow state during arbitration validation.\n- ArbMachine / TypeArbMachine (107): Query an Arb's associated Machine. Use case: Access workflow definition for dispute context analysis.\n- ArbService / TypeArbService (108): Query an Arb's associated Service. Use case: Verify service terms or compensation fund status during arbitration.\n\nExample: To validate that an order has reached the 'complete' node, query the Order with convert_witness='OrderProgress' and check the Progress's current_node field."
+                  "description": "When specified, the query retrieves data from the associated (witness) object instead of the queried object itself. This enables cross-object queries within Guard validation logic. Can be a numeric ID (100-109) or a string name (case-insensitive, with or without the 'Type' prefix). String format is recommended for readability.\n\nAvailable WitnessTypes:\n- OrderProgress / TypeOrderProgress (100): Query an Order's associated Progress object. Use case: Check if order has reached a specific workflow node (e.g., 'complete') before allowing reward claims.\n- OrderMachine / TypeOrderMachine (101): Query an Order's associated Machine (workflow definition). Use case: Verify the workflow structure or check node configurations.\n- OrderService / TypeOrderService (102): Query an Order's parent Service object. Use case: Validate the service offering details or check service-level configurations.\n- ProgressMachine / TypeProgressMachine (103): Query a Progress's associated Machine. Use case: Access workflow definition from a Progress context.\n- ArbOrder / TypeArbOrder (104): Query an Arb's associated Order. Use case: In arbitration voting guards, verify order details like payment amount or service ID.\n- ArbArbitration / TypeArbArbitration (105): Query an Arb's parent Arbitration service. Use case: Access arbitration configuration or fee settings from within an Arb case.\n- ArbProgress / TypeArbProgress (106): Query an Arb's associated Progress. Use case: Check order workflow state during arbitration validation.\n- ArbMachine / TypeArbMachine (107): Query an Arb's associated Machine. Use case: Access workflow definition for dispute context analysis.\n- ArbService / TypeArbService (108): Query an Arb's associated Service. Use case: Verify service terms or compensation fund status during arbitration.\n- OrderAllocation / TypeOrderAllocation (109): Query an Order's escrow Allocation. Use case: Fund gates — combine with the allocation.balance query (1051) to require balance >= a threshold before a forward advances (e.g., renewal loops).\n\nExample: To validate that an order has reached the 'complete' node, query the Order with convert_witness='OrderProgress' and check the Progress's current_node field."
                 }
               },
               "required": [

package/dist/schemas/query_toolkit.schema.json

@@ -289,7 +289,7 @@
           "type": "string"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -342,7 +342,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -377,7 +377,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -465,7 +465,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -497,7 +497,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -525,7 +525,7 @@
           "description": "Checkpoint sequence number (e.g. \"12345\") or checkpoint digest. A checkpoint (block) is the chain's unit of finalization — use it to answer 'what happened at block N', look up block time/transaction count, or place a transaction in the global order (checkpoint sequences appear in onchain_transaction/onchain_object_history results)."
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -592,7 +592,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -628,7 +628,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -722,7 +722,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -772,7 +772,7 @@
           ]
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -823,7 +823,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -880,7 +880,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -931,7 +931,7 @@
           "type": "boolean"
         },
         "network": {
-          "description": "Network to query: 'mainnet' or 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
+          "description": "Network to query: 'localnet' | 'mainnet' | 'testnet'. If omitted, the SDK's current default network is used (check via wowok_buildin_info info='current network'); the response echoes the resolved network so results can never be misattributed.",
           "type": "string",
           "enum": [
             "localnet",
@@ -965,7 +965,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1028,7 +1028,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1036,7 +1036,7 @@
         "service_address"
       ],
       "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). 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."
+      "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."
     },
     {
       "type": "object",
@@ -1056,7 +1056,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1091,7 +1091,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1118,7 +1118,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1152,7 +1152,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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."
         },
         "context_depth": {
           "description": "BFS recursion depth for dependency expansion in assemble_context (default 0 = no expansion). When >0, the assembly recursively queries objects referenced by the center objects (permission, guard, machine, service, repositories, etc.) up to the given depth, using the same address-field extraction rules as extractAddressFields. Each level issues one batched query_objects call (≤50 IDs per batch). Cycles are detected and skipped via a visited set. Discovered dependencies are returned in `dependencies` (edge metadata) and `dependency_objects` (full object states). Recommended: 1–2 for most use cases; 3+ may pull large subgraphs (use context_include to constrain).",
@@ -1195,7 +1195,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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."
         },
         "reverse_order_amount": {
           "description": "Escrowed order amount (smallest-unit string) for reverse_map — included in the report summary as the concrete escrow mention.",
@@ -1246,6 +1246,30 @@
           "description": "Attach order-monitor alerts (progress stall / compensation fund / review & arbitration windows) to each per-order result. Default true.",
           "type": "boolean"
         },
+        "radar_review_summary": {
+          "description": "Merchant-side review coverage summary (REVIEW-COMPONENT-PLAN batch 4): completed orders vs orders with a structured review record. Review rows live in a caller-named Repository — gather both counts via onchain_table_data (repository rows under the 'review' key, id_from=Signer → one row per buyer) and pass them in; the radar derives the merchant-side review-rate hint (high missing rate with a reward attached → reward lapsed or window too short). Omit when no review repository is bound.",
+          "type": "object",
+          "properties": {
+            "orders_completed": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "reviews_written": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "reward_bound": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "orders_completed",
+            "reviews_written"
+          ],
+          "additionalProperties": false
+        },
         "radar_monitor_thresholds": {
           "description": "Optional per-call overrides for order-monitor alert thresholds (only used when radar_include_alerts is on). All fields optional; omitted fields keep defaults. Units: hours/days as marked per field.",
           "type": "object",
@@ -1292,7 +1316,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1337,7 +1361,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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": [
@@ -1382,7 +1406,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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."
         },
         "account": {
           "description": "Scope the aggregation to ONE account address (the client's current account). Omit to aggregate across ALL local accounts.",
@@ -1417,7 +1441,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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."
         },
         "account": {
           "description": "Scope to ONE account address (the client's current account). Omit to merge across ALL local accounts.",
@@ -1493,7 +1517,7 @@
             "mainnet",
             "localnet"
           ],
-          "description": "Network for the query — equivalent to the `network` parameter (prefer `network`). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+          "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."
         },
         "intent": {
           "description": "SEMANTIC exploration strategy (G3) — what this topology call is trying to establish. Deterministically shapes the edge whitelist, per-family depth caps and budget: full_map=complete structural map; order_health=order lifecycle+completion+disputes; fund_flow=payments+allocation waterfall+guard-gated splits; workflow=Machine node graphs+transitions+progress; counterparty=who is on the other side (buyer/seller/agents/operators); reputation=votes+arbitration record+contacts; permission=permission groups+bindings+entity tables; supply_chain=multi-leg allocation/sub-order settlement; arbitration=dispute cases+voters; demand_match=demand presenters+guards+rewards. When omitted, defaults come from the persona system (role default intents < account persona preference), then industry templates; every applied layer is reported in result.strategy.trace.",