@wowok/agent-mcp 3.3.9 → 3.4.0

package/dist/schemas/query_toolkit.output.json

@@ -985,7 +985,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"
@@ -1010,6 +1010,7 @@
                                             "type": "object",
                                             "properties": {
                                               "entities": {
+                                                "minItems": 1,
                                                 "type": "array",
                                                 "items": {
                                                   "type": "object",
@@ -1024,7 +1025,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": {
@@ -2470,7 +2471,7 @@
                                     "type": "string"
                                   }
                                 ],
-                                "description": "Compensation fund BALANCE (NOT a Treasury address). This field reports the total amount of funds currently held in the Service's compensation pool. To ADD funds, use `service.compensation_fund_add`. To RECEIVE funds (as order owner after arbitration), use `service.compensation_fund_receive`. P2-03 clarification: this is a balance value (e.g. {balance: '1000000000', token_type: '0x2::wow::WOW'}), NOT the Treasury object address. The Treasury address (if bound) is queried separately via the Service's `repositories` or `order_allocators` configuration."
+                                "description": "Compensation fund BALANCE (NOT a Treasury address). This field reports the total amount of funds currently held in the Service's compensation pool. To ADD funds, use `service.compensation_fund_add`. To CLAIM a compensated award (as the ORDER OWNER, after an arbitration ruling won), use the ORDER op `order.arb_claim_compensation` — the service-side compensation claim pays the order owner and needs no special permission; `service.compensation_fund_receive` is the MERCHANT-side receive op, it will NOT deliver a buyer's award. P2-03 clarification: this is a balance value (e.g. {balance: '1000000000', token_type: '0x2::wow::WOW'}), NOT the Treasury object address. The Treasury address (if bound) is queried separately via the Service's `repositories` or `order_allocators` configuration."
                               },
                               "paused_time": {
                                 "anyOf": [
@@ -2523,7 +2524,7 @@
                                           "properties": {
                                             "guard": {
                                               "type": "string",
-                                              "description": "Guard object ID or name. A distribution call submits ONE guard; EVERY Allocator bound to that guard fires — in vector order, each against the balance left by the previous (allocation.move:366-368: the loop matches the submitted guard address, it does NOT evaluate guards competitively). NOT first-match-wins: Allocators with different guards are alternative distribution paths selected by the caller's choice of guard (e.g., a refund guard vs a damage guard), and mutual exclusion must be expressed inside the Guard conditions themselves, never assumed from ordering."
+                                              "description": "Guard object ID or name. A distribution call submits ONE guard; EVERY Allocator bound to that guard fires — in vector order, each against the balance left by the previous (the distribution loop matches the submitted guard address, it does NOT evaluate guards competitively). NOT first-match-wins: Allocators with different guards are alternative distribution paths selected by the caller's choice of guard (e.g., a refund guard vs a damage guard), and mutual exclusion must be expressed inside the Guard conditions themselves, never assumed from ordering."
                                             },
                                             "sharing": {
                                               "type": "array",
@@ -2564,7 +2565,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."
                                                           }
                                                         },
                                                         "required": [
@@ -3749,7 +3750,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"
@@ -3774,6 +3775,7 @@
                                                               "type": "object",
                                                               "properties": {
                                                                 "entities": {
+                                                                  "minItems": 1,
                                                                   "type": "array",
                                                                   "items": {
                                                                     "type": "object",
@@ -3788,7 +3790,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": {
@@ -4799,7 +4801,7 @@
                                   "properties": {
                                     "guard": {
                                       "type": "string",
-                                      "description": "Guard object ID or name. A distribution call submits ONE guard; EVERY Allocator bound to that guard fires — in vector order, each against the balance left by the previous (allocation.move:366-368: the loop matches the submitted guard address, it does NOT evaluate guards competitively). NOT first-match-wins: Allocators with different guards are alternative distribution paths selected by the caller's choice of guard (e.g., a refund guard vs a damage guard), and mutual exclusion must be expressed inside the Guard conditions themselves, never assumed from ordering."
+                                      "description": "Guard object ID or name. A distribution call submits ONE guard; EVERY Allocator bound to that guard fires — in vector order, each against the balance left by the previous (the distribution loop matches the submitted guard address, it does NOT evaluate guards competitively). NOT first-match-wins: Allocators with different guards are alternative distribution paths selected by the caller's choice of guard (e.g., a refund guard vs a damage guard), and mutual exclusion must be expressed inside the Guard conditions themselves, never assumed from ordering."
                                     },
                                     "sharing": {
                                       "type": "array",
@@ -4840,7 +4842,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."
                                                   }
                                                 },
                                                 "required": [
@@ -5279,7 +5281,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."
                                             }
                                           },
                                           "required": [
@@ -6683,7 +6685,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"
@@ -6708,6 +6710,7 @@
                                               "type": "object",
                                               "properties": {
                                                 "entities": {
+                                                  "minItems": 1,
                                                   "type": "array",
                                                   "items": {
                                                     "type": "object",
@@ -6722,7 +6725,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": {
@@ -7134,7 +7137,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."
                                             }
                                           },
                                           "required": [
@@ -7856,7 +7859,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"
@@ -7881,6 +7884,7 @@
                                                       "type": "object",
                                                       "properties": {
                                                         "entities": {
+                                                          "minItems": 1,
                                                           "type": "array",
                                                           "items": {
                                                             "type": "object",
@@ -7895,7 +7899,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": {
@@ -10211,7 +10215,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"
@@ -10236,6 +10240,7 @@
                                                   "type": "object",
                                                   "properties": {
                                                     "entities": {
+                                                      "minItems": 1,
                                                       "type": "array",
                                                       "items": {
                                                         "type": "object",
@@ -10250,7 +10255,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": {
@@ -11633,7 +11638,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"
@@ -11658,6 +11663,7 @@
                                           "type": "object",
                                           "properties": {
                                             "entities": {
+                                              "minItems": 1,
                                               "type": "array",
                                               "items": {
                                                 "type": "object",
@@ -11672,7 +11678,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": {
@@ -12622,7 +12628,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"
@@ -12647,6 +12653,7 @@
                                             "type": "object",
                                             "properties": {
                                               "entities": {
+                                                "minItems": 1,
                                                 "type": "array",
                                                 "items": {
                                                   "type": "object",
@@ -12661,7 +12668,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": {
@@ -14979,7 +14986,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"
@@ -15004,6 +15011,7 @@
                                                         "type": "object",
                                                         "properties": {
                                                           "entities": {
+                                                            "minItems": 1,
                                                             "type": "array",
                                                             "items": {
                                                               "type": "object",
@@ -15018,7 +15026,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": {
@@ -16343,6 +16351,28 @@
                       "suspended": {
                         "type": "boolean",
                         "description": "True when the sale is suspended — a suspended item cannot be bought."
+                      },
+                      "stock": {
+                        "anyOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "S4-03 (F-20): remaining units on the shelf for this sale — the EXACT value the chain checks against the requested quantity at buy (service:16 E_STOCK_NOT_ENOUGH). null when the chain read could not decode it (unknown, NOT zero)."
+                      },
+                      "stock_ok": {
+                        "anyOf": [
+                          {
+                            "type": "boolean"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "S4-03 (F-20): true when stock >= this line's quantity (the basket line is purchasable); false = the buy WILL abort stock_exhausted at the requested quantity; null = stock unreadable (verify before checkout)."
                       }
                     },
                     "required": [
@@ -16351,7 +16381,9 @@
                       "unit_price",
                       "unit_price_display",
                       "line_total",
-                      "suspended"
+                      "suspended",
+                      "stock",
+                      "stock_ok"
                     ],
                     "additionalProperties": false
                   }
@@ -16368,7 +16400,7 @@
                     },
                     "note": {
                       "type": "string",
-                      "description": "FLOOR semantics (bs29 R-17, service.move:480-481): total_pay is a MINIMUM — an under-funded total aborts (E_COIN_NOT_ENOUGH); an over-funded one succeeds but the ORDER still escrows exactly Σ(unit_price × quantity) − discount (the excess is split back, never escrowed). Pass exactly this balance; without a discount you may omit total_pay entirely (the buy auto-derives this exact total, M-K17). Prefixed with the paused warning when the Service is paused (R-16)."
+                      "description": "FLOOR semantics (bs29 R-17, the published buy contract): total_pay is a MINIMUM — an under-funded total aborts (E_COIN_NOT_ENOUGH); an over-funded one succeeds but the ORDER still escrows exactly Σ(unit_price × quantity) − discount (the excess is split back, never escrowed). Pass exactly this balance; without a discount you may omit total_pay entirely (the buy auto-derives this exact total, M-K17). Prefixed with the paused warning when the Service is paused (R-16)."
                     }
                   },
                   "required": [
@@ -16433,7 +16465,7 @@
                         },
                         "benchmark_met": {
                           "type": "boolean",
-                          "description": "False when the list total is below benchmark — the chain quote is then issued at FULL price WITHOUT stamping the coupon (service.move:436-442), so attaching the coupon at buy aborts (E_DISCOUNT_COUPON_UNEXPECTED, full rollback, nothing paid, coupon PRESERVED). Drop the coupon to buy at full price and keep it; raise the basket to actually use it."
+                          "description": "False when the list total is below benchmark — the on-chain quote is then issued at FULL price WITHOUT stamping the coupon, so attaching the coupon at buy aborts (E_DISCOUNT_COUPON_UNEXPECTED, full rollback, nothing paid, coupon PRESERVED). Drop the coupon to buy at full price and keep it; raise the basket to actually use it."
                         },
                         "applied": {
                           "type": "boolean",
@@ -16739,6 +16771,17 @@
                                       ],
                                       "description": "Rating condition detected in the claim guard (F-AOF-4): 'like' or 'dislike' = the claim ONLY pays for that rating (any other rating aborts the claim); '>= N' / '> N' / '== N' = a numeric rating floor decoded from the claim guard's structured root (F-AOF-4 v2, bkg15 F17 / klk15 C-05 — the claim only pays at or above N stars); 'unknown' = a rating condition EXISTS but its shape could not be parsed — check the guard before promising the incentive; null = no rating condition detected."
                                     },
+                                    "min_rows": {
+                                      "anyOf": [
+                                        {
+                                          "type": "number"
+                                        },
+                                        {
+                                          "type": "null"
+                                        }
+                                      ],
+                                      "description": "AGGREGATE rating-gate row threshold (ddmc2 F-09): when the floor gate is count_where(rating >= N) >= M, min_rating carries the INNER star floor (N) and THIS field carries the OUTER row-count threshold (M) — kept separate so the row count is never mistaken for the star floor. null = the gate is not an aggregate form (or no threshold decoded)."
+                                    },
                                     "claim_window": {
                                       "anyOf": [
                                         {
@@ -16783,6 +16826,22 @@
                                         }
                                       ],
                                       "description": "R-09 (bs29): the claim window decoded from the claim guard's time constants — the object-level expiration_time above is usually null, the REAL '60–600s after grant'-style window lives HERE. null = the guard's raw payload was unreadable or carries no Clock comparison (fail-honest: window NOT decoded; check the claim guard before promising a timing to the buyer)."
+                                    },
+                                    "claim_state": {
+                                      "type": "string",
+                                      "enum": [
+                                        "delayed_window",
+                                        "delayed_open_ended",
+                                        "open_window",
+                                        "open_ended",
+                                        "expired",
+                                        "unknown"
+                                      ],
+                                      "description": "bsw4 F-11 readable claimable state, derived from claim_window + the pool-level expiry: 'delayed_window' = opens after a delay AND closes (a real bounded window); 'delayed_open_ended' = opens after a delay and NEVER closes (the v76 archetype defect — any 'N days to claim' wording is fictional); 'open_window' = claimable at the anchor event until the close; 'open_ended' = claimable at the anchor event and never closes; 'expired' = the pool-level entry had already expired at quote time; 'unknown' = the guard's window was not decoded."
+                                    },
+                                    "claim_state_note": {
+                                      "type": "string",
+                                      "description": "bsw4 F-11: the window in buyer language — when it opens, how long it stays claimable, and the hard deadline (or its explicit absence). Populated from the decoded claim_window; the 'unknown' state explains what could not be decoded."
                                     }
                                   },
                                   "required": [
@@ -16794,7 +16853,10 @@
                                     "expiration_display",
                                     "expired",
                                     "min_rating",
-                                    "claim_window"
+                                    "min_rows",
+                                    "claim_window",
+                                    "claim_state",
+                                    "claim_state_note"
                                   ],
                                   "additionalProperties": false
                                 }
@@ -17245,6 +17307,10 @@
                   "type": "string",
                   "description": "Resolved account address."
                 },
+                "now_ms": {
+                  "type": "number",
+                  "description": "S12-④(b): local wall-clock at read time (ms epoch) — the chain exposes no clock query face, so diff this against time_window boundaries / deadlines to answer 'is the window still open?'."
+                },
                 "orders_analyzed": {
                   "type": "number"
                 },
@@ -17675,6 +17741,106 @@
                           ],
                           "additionalProperties": false
                         }
+                      },
+                      "time_window": {
+                        "description": "S12-④(b) derived time window of the order's CURRENT state (ksk4 F-33 family, mtw3 F-09): resolvable epoch-ms boundaries read from the guards on the current node's outgoing transitions. earliest_allowed_ms = first instant an outgoing action opens (opening gate); deadline_ms = last instant the state still allows acting (closing window). Absolute and current-node-anchored windows resolve; boundaries anchored at OTHER nodes are listed with an unresolved_note (their historical entry time is not carried by progress.current_time). null fields = no resolvable boundary of that direction; the block is absent when the current node has no guarded outgoing transition.",
+                        "type": "object",
+                        "properties": {
+                          "earliest_allowed_ms": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "deadline_ms": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "boundaries": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "direction": {
+                                  "type": "string",
+                                  "enum": [
+                                    "opens",
+                                    "closes"
+                                  ]
+                                },
+                                "boundary_ms": {
+                                  "type": "number"
+                                },
+                                "anchor": {
+                                  "type": "string",
+                                  "enum": [
+                                    "absolute",
+                                    "node_entry"
+                                  ]
+                                },
+                                "anchor_node": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "guard": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "forward": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "unresolved_note": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "direction",
+                                "boundary_ms",
+                                "anchor"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "note": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "earliest_allowed_ms",
+                          "deadline_ms",
+                          "boundaries",
+                          "note"
+                        ],
+                        "additionalProperties": false
                       }
                     },
                     "required": [
@@ -18121,6 +18287,106 @@
                           ],
                           "additionalProperties": false
                         }
+                      },
+                      "time_window": {
+                        "description": "S12-④(b) derived time window of the order's CURRENT state (ksk4 F-33 family, mtw3 F-09): resolvable epoch-ms boundaries read from the guards on the current node's outgoing transitions. earliest_allowed_ms = first instant an outgoing action opens (opening gate); deadline_ms = last instant the state still allows acting (closing window). Absolute and current-node-anchored windows resolve; boundaries anchored at OTHER nodes are listed with an unresolved_note (their historical entry time is not carried by progress.current_time). null fields = no resolvable boundary of that direction; the block is absent when the current node has no guarded outgoing transition.",
+                        "type": "object",
+                        "properties": {
+                          "earliest_allowed_ms": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "deadline_ms": {
+                            "anyOf": [
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "boundaries": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "direction": {
+                                  "type": "string",
+                                  "enum": [
+                                    "opens",
+                                    "closes"
+                                  ]
+                                },
+                                "boundary_ms": {
+                                  "type": "number"
+                                },
+                                "anchor": {
+                                  "type": "string",
+                                  "enum": [
+                                    "absolute",
+                                    "node_entry"
+                                  ]
+                                },
+                                "anchor_node": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "guard": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "forward": {
+                                  "anyOf": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "unresolved_note": {
+                                  "type": "string"
+                                }
+                              },
+                              "required": [
+                                "direction",
+                                "boundary_ms",
+                                "anchor"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "note": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "earliest_allowed_ms",
+                          "deadline_ms",
+                          "boundaries",
+                          "note"
+                        ],
+                        "additionalProperties": false
                       }
                     },
                     "required": [
@@ -18195,6 +18461,7 @@
               "required": [
                 "action",
                 "account",
+                "now_ms",
                 "orders_analyzed",
                 "actionable",
                 "waiting",
@@ -20877,7 +21144,7 @@
                             "type": "string"
                           },
                           "threshold": {
-                            "description": "Card-highlight hint from the persona/request lens — never an engine gate.",
+                            "description": "Card-highlight hint from the persona and request lens — never an engine gate.",
                             "type": "number"
                           }
                         },
@@ -22503,7 +22770,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": {
@@ -22750,7 +23017,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": {
@@ -23191,7 +23458,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"
@@ -23216,6 +23483,7 @@
                       "type": "object",
                       "properties": {
                         "entities": {
+                          "minItems": 1,
                           "type": "array",
                           "items": {
                             "type": "object",
@@ -23230,7 +23498,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": {
@@ -25095,7 +25363,7 @@
                   "type": "string"
                 },
                 "nextNode": {
-                  "description": "Optional filter: next node name string to match — the canonical time anchor is where:{nextNode:'<node>'}, find:'last', which returns the IMMUTABLE moment that node was entered (1280 history.time is written once on entry and never rewritten, unlike the 1272 current-time read which refreshes on re-entry). An empty where {} with find:'last' returns the entry time of the CURRENT node — safe for node-SET gates.",
+                  "description": "Optional filter: next node name string to match — the canonical time anchor is where:{nextNode:'<node>'}, find:'last' for SINGLE-ENTRY states, which returns the IMMUTABLE moment that node was entered (1280 history.time is written once on entry and never rewritten, unlike the 1272 current-time read which refreshes on re-entry). For a RE-ENTERABLE closing-window state (withdrawal/return request nodes the buyer can re-enter) the anchor MUST be find:'first' — find:'last' lets every re-entry re-arm the window (tbs7 O16/O17 live reset exploit). An empty where {} with find:'last' returns the entry time of the CURRENT node — safe for node-SET gates.",
                   "type": "string"
                 },
                 "timeMin": {