@wowok/agent-mcp 2.7.7 → 2.7.10

package/dist/schemas/account_operation.schema.json

@@ -142,7 +142,7 @@
             "testnet",
             "mainnet"
           ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
         }
       },
       "required": [
@@ -180,7 +180,7 @@
             "testnet",
             "mainnet"
           ],
-          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+          "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
         }
       },
       "required": [

package/dist/schemas/bridge_operation.output.json

@@ -369,11 +369,13 @@
                   "lifecycle",
                   "state_change",
                   "fund_flow",
+                  "market_opportunity",
+                  "reputation",
                   "permission",
                   "guard",
                   "other"
                 ],
-                "description": "Business category. Constraint: enum of 6 values. Example: 'lifecycle'"
+                "description": "Business category. Constraint: enum of 8 values. 'market_opportunity' = supply/demand discovery signal (ServiceEvent/DemandChangedEvent/DemandPresentEvent, K3 13 §6.7); 'reputation' = trust-affecting signal (DemandFeedbackEvent). Example: 'fund_flow'"
               },
               "related_object": {
                 "description": "Object ID the event relates to, if extractable. Example: '0x123...'",
@@ -478,10 +480,10 @@
               "items": {
                 "type": "string"
               },
-              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"
+              "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','experience_layer']"
             },
             "inactive": {
-              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']",
+              "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness']",
               "type": "array",
               "items": {
                 "type": "string"
@@ -654,7 +656,7 @@
               ]
             },
             "role_advice": {
-              "description": "Phase 4 P4-6.C: Role-targeted advice strings (merchant/customer/prospect/supplier/collaborator/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']",
+              "description": "Phase 4 P4-6.C: Role-targeted advice strings (merchant/customer/demander/prospect/supplier/collaborator/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']",
               "type": "array",
               "items": {
                 "type": "string"
@@ -666,6 +668,7 @@
               "enum": [
                 "merchant",
                 "customer",
+                "demander",
                 "prospect",
                 "supplier",
                 "collaborator",

package/dist/schemas/bridge_operation.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/bridge_operation.json",
   "title": "Bridge - Cross-Chain Operations",
-  "description": "Simplified cross-chain bridge between WOW and EVM (Ethereum mainnet). Operations: cross_chain_wow_to_evm, cross_chain_evm_to_wow, withdraw, query_active_evm_account, query_supported_evm_chains, query_supported_tokens, query_transfer_list, query_transfer_status, manage_evm_rpc. Global single activeEvmAccount auto-generated on first use. Use schema_query (name='bridge_operation') for exact field structures.",
+  "description": "Simplified cross-chain bridge between WOW and EVM (Ethereum mainnet). WOW→EVM is TWO steps: step1 cross_chain_wow_to_evm (deposit/lock, returns transferId) → poll query_transfer_status until latestState.step='signatures_ready' (~1-5 min) → step2 claim_wow_to_evm (claim on EVM, needs EVM gas). Assets arrive ONLY after step2. EVM→WOW is ONE step (auto-claim on WOW, ~10-20 min). Operations: cross_chain_wow_to_evm, claim_wow_to_evm, cross_chain_evm_to_wow, resume_transfer, withdraw, query_active_evm_account, query_supported_evm_chains, query_supported_tokens, query_transfer_list, query_transfer_status, manage_evm_rpc. Global single activeEvmAccount auto-generated on first use. Use schema_query (name='bridge_operation') for exact field structures.",
   "oneOf": [
     {
       "type": "object",
@@ -78,12 +78,16 @@
                 "testnet",
                 "mainnet"
               ],
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
             },
             "referrer": {
-              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
+              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded (also applied when the SDK auto-registers the sender in the global Entity table).",
               "type": "string"
             },
+            "no_auto_register": {
+              "description": "Opt-out of SDK-level Entity auto-registration. By default, a business transaction whose sender has no entry in the global Entity table automatically appends entity_register: the sender gets registered and receives an owned Resource object (their on-chain mark book) in the wallet. Set true ONLY when the user explicitly cancelled their entity registration (entity_cancel) or demands that the transaction not touch the Entity table.",
+              "type": "boolean"
+            },
             "confirmed": {
               "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
               "type": "boolean"
@@ -95,8 +99,8 @@
                 "type": "string"
               }
             },
-            "project": {
-              "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
+            "plan_approval": {
+              "description": "K3 24 PlanApproval: id of a goal whose plan was approved via goal_operation action='approve'. When set: 1) the ConfirmGate treats fail-open rules (standard/none levels) as pre-approved for operations under this goal's plan; 2) after successful CREATION operations, the created objects are auto-registered into the goal (GoalRecord.objects + its TaskProcess manifest — ACT station 'execution registers'). Fail-closed levels (irreversible/publish/amount) still require per-operation confirmation with env.confirmed=true.",
               "type": "string"
             },
             "client_schema_version": {
@@ -118,7 +122,7 @@
             "schema_strict_mode"
           ],
           "additionalProperties": false,
-          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
+          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used. NOTE: by default the SDK auto-registers the sender in the global Entity table when absent (first business transaction; the account receives an owned Resource object). Set no_auto_register=true only on explicit user request."
         }
       },
       "required": [
@@ -201,12 +205,16 @@
                 "testnet",
                 "mainnet"
               ],
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
             },
             "referrer": {
-              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
+              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded (also applied when the SDK auto-registers the sender in the global Entity table).",
               "type": "string"
             },
+            "no_auto_register": {
+              "description": "Opt-out of SDK-level Entity auto-registration. By default, a business transaction whose sender has no entry in the global Entity table automatically appends entity_register: the sender gets registered and receives an owned Resource object (their on-chain mark book) in the wallet. Set true ONLY when the user explicitly cancelled their entity registration (entity_cancel) or demands that the transaction not touch the Entity table.",
+              "type": "boolean"
+            },
             "confirmed": {
               "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
               "type": "boolean"
@@ -218,8 +226,8 @@
                 "type": "string"
               }
             },
-            "project": {
-              "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
+            "plan_approval": {
+              "description": "K3 24 PlanApproval: id of a goal whose plan was approved via goal_operation action='approve'. When set: 1) the ConfirmGate treats fail-open rules (standard/none levels) as pre-approved for operations under this goal's plan; 2) after successful CREATION operations, the created objects are auto-registered into the goal (GoalRecord.objects + its TaskProcess manifest — ACT station 'execution registers'). Fail-closed levels (irreversible/publish/amount) still require per-operation confirmation with env.confirmed=true.",
               "type": "string"
             },
             "client_schema_version": {
@@ -241,7 +249,7 @@
             "schema_strict_mode"
           ],
           "additionalProperties": false,
-          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
+          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used. NOTE: by default the SDK auto-registers the sender in the global Entity table when absent (first business transaction; the account receives an owned Resource object). Set no_auto_register=true only on explicit user request."
         }
       },
       "required": [
@@ -298,12 +306,16 @@
                 "testnet",
                 "mainnet"
               ],
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
             },
             "referrer": {
-              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
+              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded (also applied when the SDK auto-registers the sender in the global Entity table).",
               "type": "string"
             },
+            "no_auto_register": {
+              "description": "Opt-out of SDK-level Entity auto-registration. By default, a business transaction whose sender has no entry in the global Entity table automatically appends entity_register: the sender gets registered and receives an owned Resource object (their on-chain mark book) in the wallet. Set true ONLY when the user explicitly cancelled their entity registration (entity_cancel) or demands that the transaction not touch the Entity table.",
+              "type": "boolean"
+            },
             "confirmed": {
               "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
               "type": "boolean"
@@ -315,8 +327,8 @@
                 "type": "string"
               }
             },
-            "project": {
-              "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
+            "plan_approval": {
+              "description": "K3 24 PlanApproval: id of a goal whose plan was approved via goal_operation action='approve'. When set: 1) the ConfirmGate treats fail-open rules (standard/none levels) as pre-approved for operations under this goal's plan; 2) after successful CREATION operations, the created objects are auto-registered into the goal (GoalRecord.objects + its TaskProcess manifest — ACT station 'execution registers'). Fail-closed levels (irreversible/publish/amount) still require per-operation confirmation with env.confirmed=true.",
               "type": "string"
             },
             "client_schema_version": {
@@ -338,7 +350,7 @@
             "schema_strict_mode"
           ],
           "additionalProperties": false,
-          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
+          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used. NOTE: by default the SDK auto-registers the sender in the global Entity table when absent (first business transaction; the account receives an owned Resource object). Set no_auto_register=true only on explicit user request."
         }
       },
       "required": [
@@ -395,12 +407,16 @@
                 "testnet",
                 "mainnet"
               ],
-              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Use project_operation action='clone_project_to_network' to clone the project blueprint to the target network, then re-run onchain_operations with env.network=target_network to deploy."
+              "description": "Network entrypoint: Specifies which network the operation occurs on. FIX-010 cross-network note: LocalMark names are scoped per network (testnet marks are invisible on mainnet and vice versa). When migrating from testnet to mainnet, recreate all objects on mainnet and re-register LocalMark names with the SAME names to keep name-based references working across networks. Recreate all objects on the target network via onchain_operations with env.network=target_network, then re-register the LocalMark names."
             },
             "referrer": {
-              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded.",
+              "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded (also applied when the SDK auto-registers the sender in the global Entity table).",
               "type": "string"
             },
+            "no_auto_register": {
+              "description": "Opt-out of SDK-level Entity auto-registration. By default, a business transaction whose sender has no entry in the global Entity table automatically appends entity_register: the sender gets registered and receives an owned Resource object (their on-chain mark book) in the wallet. Set true ONLY when the user explicitly cancelled their entity registration (entity_cancel) or demands that the transaction not touch the Entity table.",
+              "type": "boolean"
+            },
             "confirmed": {
               "description": "Phase 2 ConfirmGate: set to true to proceed after a 'pending_confirmation' result. The operation is NOT executed until you re-call with confirmed=true after user consent.",
               "type": "boolean"
@@ -412,8 +428,8 @@
                 "type": "string"
               }
             },
-            "project": {
-              "description": "Project prefix to assign this object to (e.g. 'myshop'). When set: 1) the object is tagged with 'project:<prefix>' on-chain automatically via ProjectService, 2) the newly created object is auto-associated to the SQLite project for local management, evaluation, and graph tracking. The project MUST exist (create via project_operation action='create_project' first). Use project_operation to manage projects.",
+            "plan_approval": {
+              "description": "K3 24 PlanApproval: id of a goal whose plan was approved via goal_operation action='approve'. When set: 1) the ConfirmGate treats fail-open rules (standard/none levels) as pre-approved for operations under this goal's plan; 2) after successful CREATION operations, the created objects are auto-registered into the goal (GoalRecord.objects + its TaskProcess manifest — ACT station 'execution registers'). Fail-closed levels (irreversible/publish/amount) still require per-operation confirmation with env.confirmed=true.",
               "type": "string"
             },
             "client_schema_version": {
@@ -435,7 +451,7 @@
             "schema_strict_mode"
           ],
           "additionalProperties": false,
-          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used."
+          "description": "IMPORTANT: Execution environment includes: account for signing operations, network selection ([object Object]), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account (\"\") will be used. NOTE: by default the SDK auto-registers the sender in the global Entity table when absent (first business transaction; the account receives an owned Resource object). Set no_auto_register=true only on explicit user request."
         }
       },
       "required": [

package/dist/schemas/config_operation.output.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/config_operation.output.json",
   "title": "Config - Runtime Service Toggles",
-  "description": "Runtime configuration — toggle Phase 2/3/4 services on/off at runtime WITHOUT restarting the MCP server. Actions: list, toggle, enable, disable, reset, info. Services (9 total): confirm_gate, project_service, harness, graph_persist, semantic_rich, experience_layer, customer_intelligence, order_monitor, industry_evolution.",
+  "description": "Runtime configuration — toggle Phase 2/3/4 services on/off at runtime WITHOUT restarting the MCP server. Actions: list, toggle, enable, disable, reset, info. Services (7 total): confirm_gate, harness, semantic_rich, experience_layer, customer_intelligence, order_monitor, industry_evolution.",
   "type": "object",
   "properties": {
     "result": {

package/dist/schemas/config_operation.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/config_operation.json",
   "title": "Config - Runtime Service Toggles",
-  "description": "Runtime configuration — toggle Phase 2/3/4 services on/off at runtime WITHOUT restarting the MCP server. Actions: list, toggle, enable, disable, reset, info. Services (9 total): confirm_gate, project_service, harness, graph_persist, semantic_rich, experience_layer, customer_intelligence, order_monitor, industry_evolution.",
+  "description": "Runtime configuration — toggle Phase 2/3/4 services on/off at runtime WITHOUT restarting the MCP server. Actions: list, toggle, enable, disable, reset, info. Services (7 total): confirm_gate, harness, semantic_rich, experience_layer, customer_intelligence, order_monitor, industry_evolution.",
   "type": "object",
   "properties": {
     "action": {

package/dist/schemas/evaluation_operation.output.json

@@ -1476,6 +1476,223 @@
           ],
           "additionalProperties": false
         },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "demand_present"
+            },
+            "matches": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "demand": {
+                    "type": "object",
+                    "properties": {
+                      "object": {
+                        "type": "string",
+                        "description": "Demand object address."
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "location": {
+                        "type": "string"
+                      },
+                      "rewards": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "um": {
+                        "anyOf": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "owner": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "object",
+                      "description",
+                      "location"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "result": {
+                    "type": "object",
+                    "properties": {
+                      "evaluation_id": {
+                        "type": "string"
+                      },
+                      "total": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 100
+                      },
+                      "level": {
+                        "type": "string",
+                        "enum": [
+                          "low",
+                          "medium_low",
+                          "medium_high",
+                          "high"
+                        ]
+                      },
+                      "breakdown": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "rule_id": {
+                              "type": "string"
+                            },
+                            "dimension": {
+                              "type": "string"
+                            },
+                            "score": {
+                              "type": "number"
+                            },
+                            "weight": {
+                              "type": "number"
+                            },
+                            "reason": {
+                              "type": "string"
+                            },
+                            "matched": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "mismatched": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "red_flag": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "rule_id",
+                            "dimension",
+                            "score",
+                            "weight"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "red_flags": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "blocked": {
+                        "type": "boolean"
+                      },
+                      "trace": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "kind": {
+                              "type": "string",
+                              "enum": [
+                                "data_source",
+                                "rule",
+                                "override"
+                              ]
+                            },
+                            "id": {
+                              "type": "string"
+                            },
+                            "detail": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "kind",
+                            "id",
+                            "detail"
+                          ],
+                          "additionalProperties": false
+                        }
+                      },
+                      "summary": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "evaluation_id",
+                      "total",
+                      "level",
+                      "breakdown",
+                      "red_flags",
+                      "blocked",
+                      "trace",
+                      "summary"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "present": {
+                    "type": "object",
+                    "properties": {
+                      "operation": {
+                        "type": "string",
+                        "description": "Move entry to present: demand.present_service (no guard) or demand.present_service_with_passport (guarded)."
+                      },
+                      "guard_required": {
+                        "type": "boolean",
+                        "description": "True = the demand has presentation guards; a verified passport is required."
+                      }
+                    },
+                    "required": [
+                      "operation",
+                      "guard_required"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "demand",
+                  "result",
+                  "present"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Demands matched to the service (score desc), each with its present path."
+            },
+            "total_enumerated": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "description": "Shared Demands enumerated on-chain before filtering."
+            },
+            "has_more": {
+              "type": "boolean",
+              "description": "True = enumeration truncated at max_objects (partial universe)."
+            }
+          },
+          "required": [
+            "action",
+            "matches",
+            "total_enumerated",
+            "has_more"
+          ],
+          "additionalProperties": false
+        },
         {
           "type": "object",
           "properties": {
@@ -1729,6 +1946,63 @@
             "computed_at": {
               "type": "number",
               "description": "Unix ms when computed."
+            },
+            "order_flow": {
+              "type": "object",
+              "properties": {
+                "order_count": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991,
+                  "description": "Recent order count (finite window)."
+                },
+                "gmv": {
+                  "type": "string",
+                  "description": "Recent GMV — sum of order amounts in smallest-unit (bigint as string)."
+                },
+                "top_services": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "service": {
+                        "type": "string",
+                        "description": "Service address."
+                      },
+                      "orders": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 9007199254740991,
+                        "description": "Order count for this service in the window."
+                      }
+                    },
+                    "required": [
+                      "service",
+                      "orders"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "description": "Per-service order count, top-N by volume."
+                },
+                "window": {
+                  "type": "string",
+                  "const": "recent",
+                  "description": "Honest window label: events are paged, not full-history."
+                },
+                "computed_at": {
+                  "type": "number",
+                  "description": "Unix ms when computed."
+                }
+              },
+              "required": [
+                "order_count",
+                "gmv",
+                "top_services",
+                "window",
+                "computed_at"
+              ],
+              "additionalProperties": false,
+              "description": "Recent order-flow scale metrics (finite window; full history requires indexer)."
             }
           },
           "required": [
@@ -1740,7 +2014,8 @@
             "total_arbs",
             "open_arbs",
             "supply_demand_ratio",
-            "computed_at"
+            "computed_at",
+            "order_flow"
           ],
           "additionalProperties": false
         },