@wowok/agent-mcp 2.7.7 → 2.7.8

package/dist/schemas/onchain_table_data.schema.json

@@ -330,6 +330,164 @@
           "additionalProperties": false,
           "description": "Query which customer-service Contacts an entity is a member of, from the global EntityContact reverse index (0xaa9). Use to check an address's Contact memberships. Returns: TableItem_EntityContact | undefined"
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_table_item_entity_order"
+            },
+            "address": {
+              "anyOf": [
+                {
+                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "name_or_address": {
+                      "type": "string",
+                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                    },
+                    "local_mark_first": {
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
+                    }
+                  },
+                  "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": "User address whose orders to look up. Supports string (name/address) or object form. LocalMark names are resolved automatically."
+            },
+            "no_cache": {
+              "description": "Set to true to bypass cache and fetch fresh on-chain data",
+              "type": "boolean"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "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."
+            }
+          },
+          "required": [
+            "query_type",
+            "address"
+          ],
+          "additionalProperties": false,
+          "description": "Query the orders a user participates in, from the global EntityOrder reverse index (0xaa8) — returns order addresses with role bitmask (1=owner, 2=agent) and last role-update time. Use to list a user's orders (raw index, without full order objects). Returns: TableItem_EntityOrder | undefined"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_orders_of_user"
+            },
+            "address": {
+              "anyOf": [
+                {
+                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "name_or_address": {
+                      "type": "string",
+                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                    },
+                    "local_mark_first": {
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
+                    }
+                  },
+                  "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": "User address whose orders to query. Supports string (name/address) or object form. LocalMark names are resolved automatically."
+            },
+            "no_cache": {
+              "description": "Set to true to bypass cache and fetch fresh on-chain data",
+              "type": "boolean"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "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."
+            }
+          },
+          "required": [
+            "query_type",
+            "address"
+          ],
+          "additionalProperties": false,
+          "description": "Query every order a user participates in (as owner and/or agent) via the global EntityOrder reverse index (0xaa8), resolving each to its full on-chain Order object. Each result includes role info: role bitmask (1=owner, 2=agent), is_owner, is_agent, role update time, and the full order. Use to get a user's complete order list with role attributes. Returns: UserOrderView[]"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_orders_of_users"
+            },
+            "addresses": {
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "anyOf": [
+                  {
+                    "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "name_or_address": {
+                        "type": "string",
+                        "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                      },
+                      "local_mark_first": {
+                        "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                        "type": "boolean"
+                      }
+                    },
+                    "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. Can be a simple string (recommended for AI) or full object with explicit local_mark_first control. String form auto-converts to { name_or_address: <string>, local_mark_first: true }."
+              },
+              "description": "Account addresses to query (typically ALL local accounts). Each address supports LocalMark name resolution."
+            },
+            "no_cache": {
+              "description": "Set to true to bypass cache and fetch fresh on-chain data",
+              "type": "boolean"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "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."
+            }
+          },
+          "required": [
+            "query_type",
+            "addresses"
+          ],
+          "additionalProperties": false,
+          "description": "Query every order that ANY of the given accounts participates in (owner and/or agent), merged into ONE enriched list — the cross-account backbone of the Business order list. Rows are deduped by order address with per-account roles merged, and each row is SERVER-ENRICHED exactly like the Service panorama Orders tab: amount + purchased-item prices resolved to human token display, progress_next/progress_since from the order's Progress, allocation_state from the Allocation balance, updated_ms (last on-chain touch) per order. Per-account failures are non-blocking (account_errors). Returns: EnrichedOrderRow[]"
+        },
         {
           "type": "object",
           "properties": {
@@ -432,6 +590,159 @@
           "additionalProperties": false,
           "description": "Query which operational objects (Order/Progress/Payment/Allocation/Guard/Permission) bind to a target, from the ObjectLinkerTx reverse index (0xaaf). Lossy FIFO (recent only). Use for order/progress/operational reverse lookups. Returns: TableItem_ObjectLinkerTx | undefined"
         },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "onchain_affiliations_of_object"
+            },
+            "address": {
+              "anyOf": [
+                {
+                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "name_or_address": {
+                      "type": "string",
+                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                    },
+                    "local_mark_first": {
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
+                    }
+                  },
+                  "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": "Object or account address whose global-table records to aggregate. Supports string (name/address) or object form. LocalMark names are resolved automatically."
+            },
+            "no_cache": {
+              "description": "Set to true to bypass cache and fetch fresh on-chain data",
+              "type": "boolean"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "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."
+            }
+          },
+          "required": [
+            "query_type",
+            "address"
+          ],
+          "additionalProperties": false,
+          "description": "Aggregate EVERY global reverse index (0xaae core / 0xaaf tx / 0xaa8 orders / 0xaad permissions / 0xaa9 contacts / 0xaaa registrar / 0xaab entity) where this address can be recorded as a key, driven by the exhaustive type→tables static map (one targeted dynamic-field read per relevant table, NEVER a full-table scan). Forward field-stored references are excluded — they need no global query. Use for complete 'what records exist about this object across global tables' answers. Returns: AffiliationAnswer"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "address_profile"
+            },
+            "address": {
+              "anyOf": [
+                {
+                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "name_or_address": {
+                      "type": "string",
+                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                    },
+                    "local_mark_first": {
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
+                    }
+                  },
+                  "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": "Address to profile. Supports string (name/address) or object form. LocalMark names are resolved automatically."
+            },
+            "no_cache": {
+              "description": "Set to true to bypass cache and fetch fresh on-chain data",
+              "type": "boolean"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "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."
+            }
+          },
+          "required": [
+            "query_type",
+            "address"
+          ],
+          "additionalProperties": false,
+          "description": "Unified address profile (K3 22 §P0-1): classifies the address (user / business-object type / system singleton), then batches identity + reputation (like/dislike/favor) + order membership + contact membership + permission membership + core/tx reverse bindings + the object itself into a single result. The one-stop entry for 'who/what is this address'. Returns: AddressProfile"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "query_type": {
+              "type": "string",
+              "const": "service_supply_chain"
+            },
+            "address": {
+              "anyOf": [
+                {
+                  "description": "Account name, address (0x...), or mark name. When using string format, local marks are searched first. EXAMPLE: 'alice' - searches local marks first, then global; EXAMPLE: '0x2...' (64 hex chars) - uses address directly; EXAMPLE: '' - uses the default local account"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "name_or_address": {
+                      "type": "string",
+                      "description": "Account/Object name or ID. If specifying an account, use empty string '' for the default account. If it starts with '0x', it will be treated as an ID. Otherwise, it will be treated as a name (max 64 bcs characters)."
+                    },
+                    "local_mark_first": {
+                      "description": "Whether to prioritize local marks, if true, prioritize local marks, otherwise prioritize global marks",
+                      "type": "boolean"
+                    }
+                  },
+                  "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": "Service address whose transparent sub-order purchasing graph to resolve. Supports string (name/address) or object form. LocalMark names are resolved automatically."
+            },
+            "no_cache": {
+              "description": "Set to true to bypass cache and fetch fresh on-chain data",
+              "type": "boolean"
+            },
+            "network": {
+              "type": "string",
+              "enum": [
+                "localnet",
+                "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."
+            }
+          },
+          "required": [
+            "query_type",
+            "address"
+          ],
+          "additionalProperties": false,
+          "description": "Resolve a Service's transparent sub-order purchasing graph (K3 23 §3.6): reads the bound Machine's frozen forwards, finds purchasing-commitment Guards, and returns each forward's purchased sub-services (fixed address fields) + required sub-order proof fields (b_submission fields). Standalone capability for buyer due-diligence / compose_service / anti_cheat / merchant self-check; reused by Watch. Returns: SupplyChainGraph"
+        },
         {
           "type": "object",
           "properties": {

package/dist/schemas/permission_operation.output.json

@@ -21,6 +21,10 @@
                 "type": "string",
                 "description": "Permission object address"
               },
+              "permission_name": {
+                "description": "Local name for the Permission object (account name / LocalMark / Project object name), if resolvable",
+                "type": "string"
+              },
               "description": {
                 "type": "string",
                 "description": "Permission description"
@@ -29,6 +33,10 @@
                 "type": "string",
                 "description": "Owner address"
               },
+              "owner_name": {
+                "description": "Local name for the owner address, if resolvable",
+                "type": "string"
+              },
               "updated_timestamp_ms": {
                 "description": "Unix ms of the latest transaction touching this Permission (via previousTransaction)",
                 "type": "string"
@@ -123,6 +131,23 @@
                         "type": "string"
                       },
                       "description": "Object addresses of this type"
+                    },
+                    "object_names": {
+                      "description": "Local names for each object address (parallel to `objects`), empty string when no local name is resolvable",
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "object_tags": {
+                      "description": "LocalMark tags for each object address (parallel to `objects`), empty array when none",
+                      "type": "array",
+                      "items": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
                     }
                   },
                   "required": [
@@ -138,6 +163,13 @@
               "related_object_count": {
                 "type": "number",
                 "description": "Total related object count"
+              },
+              "tags": {
+                "description": "LocalMark tags for the Permission object (labels shown like Project items)",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
               }
             },
             "required": [

package/dist/schemas/project_operation.schema.json

@@ -52,7 +52,10 @@
         "aggregate_risks",
         "trace_substeps",
         "merchant_guide",
-        "participation_radar"
+        "participation_radar",
+        "service_panorama",
+        "machine_panorama",
+        "object_panorama"
       ],
       "description": "Action to perform. Two categories:\n1. Project Entity + Evaluation (15, GLM6): list_projects, create_project, create_project_from_onchain, update_project, get_project_detail, add_object, remove_object, create_version, build_graph, get_graph, evaluate_project, save_evaluation, compare_projects, refresh_objects, get_object_diff. Projects are first-class entities with SQLite persistence, rigid project-object relationships, three-pathway graph construction, and a dual rule-based + LLM-assisted evaluation engine.\n2. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events).\n2b. Reverse Mapping (1): reverse_map (deterministic L4→L1 business report — queries the on-chain objects, classifies them into business semantics, and emits a fixed-rule BusinessReport with merchant profile, user risk assessment, and game-theory analysis. Same objects ALWAYS yield the same report — no LLM involved). Required input: context_objects (include the Service; add Machine/Allocation for refund-path detection). Optional: context_network, order_amount.\n3. Cross-Network Migration (FIX-012): clone_project_to_network (or its alias migrate_network) copies a source project's object metadata to a new project bound to target_network. The 5-step migration workflow: 1) call clone_project_to_network (or migrate_network) with target_network to copy metadata, 2) re-run onchain_operations with env.network=target_network to deploy objects on-chain, 3) re-register LocalMark names with the SAME names on the target network (FIX-011 cross-network consistency), 4) update_project to set service_address on the new project, 5) build_graph to construct the new project's relationship graph."
     },
@@ -77,11 +80,12 @@
       "type": "boolean"
     },
     "context_network": {
-      "description": "Network for assemble_context / reverse_map queries. Defaults to 'testnet' if omitted.",
+      "description": "Network for assemble_context / reverse_map / service_panorama queries. Defaults to 'testnet' if omitted. 'localnet' is for internal test use against a local fullnode.",
       "type": "string",
       "enum": [
         "testnet",
-        "mainnet"
+        "mainnet",
+        "localnet"
       ]
     },
     "reverse_order_amount": {
@@ -121,11 +125,12 @@
       ]
     },
     "filter_network": {
-      "description": "Filter list_projects by network.",
+      "description": "Filter list_projects by network. Networks are peers with fully independent data: switching the UI network MUST re-query with this filter so localnet/testnet/mainnet drafts never mix in one list.",
       "type": "string",
       "enum": [
         "testnet",
-        "mainnet"
+        "mainnet",
+        "localnet"
       ]
     },
     "project_name": {
@@ -172,15 +177,16 @@
       }
     },
     "service_address": {
-      "description": "On-chain Service object address. Required for create_project_from_onchain. Optional for create_project (links the project to its core Service).",
+      "description": "On-chain Service object address (or LocalMark name). Required for create_project_from_onchain and service_panorama. Optional for create_project (links the project to its core Service).",
       "type": "string"
     },
     "project_network": {
-      "description": "Network the project is bound to. A Service deployed to different networks are different projects. Defaults to 'testnet'.",
+      "description": "Network the project is bound to. A Service deployed to different networks are different projects. Defaults to 'testnet'. 'localnet' is for internal test use against a local fullnode.",
       "type": "string",
       "enum": [
         "testnet",
-        "mainnet"
+        "mainnet",
+        "localnet"
       ]
     },
     "skip_templates": {