@wowok/agent-mcp 2.3.16 → 2.3.18

package/dist/schema/trust/index.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { NameOrAddressSchema } from "../common/index.js";
+export const TrustScoreInputSchema = z
+    .object({
+    service: NameOrAddressSchema.describe("Service object ID or local_mark name to evaluate. " +
+        "Must reference an existing Service object on-chain."),
+    order_amount: z
+        .union([z.string(), z.number()])
+        .optional()
+        .describe("Optional order amount (in smallest token unit, e.g. 2000000000 for 2 WOW). " +
+        "Used for fund-safety dimension risk assessment. " +
+        "If omitted, the first active sale price of the service is used."),
+    depth: z
+        .enum(["browse", "evaluate", "preorder"])
+        .optional()
+        .describe("InfoPuzzle collection depth. " +
+        "browse: only Service basics + trust score; " +
+        "evaluate (default): + workflow/fund/trust dimensions risk assessment; " +
+        "preorder: + merchant behavior + market context (most thorough)."),
+    network: z
+        .string()
+        .optional()
+        .describe("Network override (e.g. 'mainnet', 'testnet'). If omitted, uses default."),
+    no_cache: z
+        .boolean()
+        .optional()
+        .describe("Skip object cache and force a fresh on-chain query."),
+})
+    .strict();
+export const TrustScoreOutputSchema = z
+    .object({
+    result: z
+        .object({
+        service_id: z.string().describe("The Service object ID or local_mark that was evaluated."),
+        service_name: z.string().describe("Service display name (falls back to service_id if unnamed)."),
+        service_basics: z
+            .object({
+            bPublished: z.boolean().describe("Whether the Service is published (open for orders)."),
+            bPaused: z.boolean().describe("Whether the Service is temporarily paused."),
+            sales_count: z.number().int().nonnegative().describe("Number of active (non-suspended) sale entries."),
+            has_machine: z.boolean().describe("Whether a Machine workflow is attached."),
+            has_buy_guard: z.boolean().describe("Whether a buy-side Guard is configured."),
+            has_um_contact: z.boolean().describe("Whether a Messenger (um) contact is configured."),
+            arbitrations_count: z.number().int().nonnegative().describe("Number of arbitration entries attached to the Service."),
+        })
+            .describe("Service snapshot — basic on-chain state."),
+        trust_score: z
+            .object({
+            score: z.number().min(0).max(100).describe("Overall trust score (0-100, higher = more trustworthy)."),
+            level: z
+                .enum(["high_risk", "caution", "moderate", "trusted"])
+                .describe("Trust level label derived from the score."),
+            summary: z.string().describe("One-line human-readable trust summary."),
+            warnings: z.array(z.string()).describe("Trust warnings (e.g. low arbitration dimension score)."),
+            breakdown: z
+                .array(z.object({
+                score: z.number().describe("Dimension score achieved."),
+                maxScore: z.number().describe("Dimension max possible score."),
+                description: z.string().describe("Dimension name / description."),
+                humanReadable: z.string().describe("Human-readable dimension explanation."),
+            }))
+                .describe("5-dimension breakdown: arbitration / reviews / fulfillment / fund_safety / transparency."),
+        })
+            .describe("ServiceTrustScore — 0-100 score across 5 trust dimensions."),
+        order_amount: z
+            .string()
+            .describe("Order amount used for fund-safety assessment, in smallest token unit (bigint as string)."),
+        depth: z
+            .enum(["browse", "evaluate", "preorder"])
+            .describe("Actual InfoPuzzle collection depth used (defaults to 'evaluate')."),
+        risk_score: z
+            .object({
+            total: z.number().min(0).max(100).describe("Overall risk score (0-100, higher = riskier)."),
+            level: z
+                .enum(["low", "medium_low", "medium_high", "high"])
+                .describe("Risk level label derived from the total score."),
+            red_flags: z.array(z.string()).describe("Critical risk red flags detected."),
+            advice: z.array(z.string()).describe("Risk mitigation advice."),
+            dimensions: z
+                .array(z.object({
+                name: z
+                    .enum(["workflow", "fund", "trust", "behavior"])
+                    .describe("Risk dimension name."),
+                score: z.number().describe("Dimension score achieved."),
+                max_score: z.number().describe("Dimension max possible score."),
+                checks: z.array(z.object({
+                    id: z.string().describe("Check identifier."),
+                    dimension: z
+                        .enum(["workflow", "fund", "trust", "behavior"])
+                        .describe("Dimension this check belongs to."),
+                    description: z.string().describe("Check description."),
+                    weight: z.number().describe("Check weight within its dimension (percentage)."),
+                    passed: z.boolean().describe("Whether the check passed."),
+                    advice: z.string().optional().describe("Advice when the check failed."),
+                })).describe("Individual risk checks within this dimension."),
+            }))
+                .describe("4-dimension breakdown: workflow / fund / trust / behavior."),
+        })
+            .optional()
+            .describe("RiskScore — present only when depth >= 'evaluate'."),
+        info_puzzle: z
+            .object({
+            completeness: z.number().min(0).max(1).describe("InfoPuzzle completeness ratio (0-1)."),
+            gaps: z.array(z.string()).describe("Missing key puzzle pieces."),
+            assembled_at: z.number().describe("Assembly timestamp (ms since epoch)."),
+        })
+            .optional()
+            .describe("InfoPuzzle summary — present only when depth >= 'evaluate'."),
+    })
+        .describe("Trust score result. Contains: trust_score (ServiceTrustScore), " +
+        "risk_score (RiskScore, when depth >= evaluate), info_puzzle summary, " +
+        "and service_basics snapshot."),
+});

package/dist/schemas/bridge_operation.output.json

@@ -563,6 +563,230 @@
               ],
               "additionalProperties": false,
               "description": "Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry health signals and evolution advice."
+            },
+            "guard_advice": {
+              "type": "object",
+              "properties": {
+                "current_round": {
+                  "type": "string",
+                  "enum": [
+                    "R1",
+                    "R2",
+                    "R3",
+                    "R4",
+                    "R5",
+                    "R6",
+                    "R7",
+                    "R8",
+                    "R9",
+                    "R10"
+                  ],
+                  "description": "Current R1-R10 dialogue round. R1=intent, R2=table, R3=tree, R4=rely, R5=binding, R6=review, R7=CREATE, R8=test, R9=bind, R10=verify. Example: 'R3'"
+                },
+                "puzzle_status": {
+                  "type": "object",
+                  "properties": {
+                    "intent": {
+                      "type": "boolean",
+                      "description": "Intent dimension complete (action + rule + failure conditions)"
+                    },
+                    "binding": {
+                      "type": "boolean",
+                      "description": "Binding dimension complete (host object + field + circular ref)"
+                    },
+                    "data": {
+                      "type": "boolean",
+                      "description": "Data dimension complete (table entries + witnesses)"
+                    },
+                    "query": {
+                      "type": "boolean",
+                      "description": "Query dimension complete (query instructions if needed)"
+                    },
+                    "logic": {
+                      "type": "boolean",
+                      "description": "Logic dimension complete (root node returns Bool)"
+                    },
+                    "constraints": {
+                      "type": "boolean",
+                      "description": "Constraints dimension complete (10 Pitfalls checked)"
+                    }
+                  },
+                  "required": [
+                    "intent",
+                    "binding",
+                    "data",
+                    "query",
+                    "logic",
+                    "constraints"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Information puzzle completeness (6 dimensions). Missing dimensions need user input before CREATE."
+                },
+                "matched_scene": {
+                  "type": "string",
+                  "description": "Matched Guard scene id from the 8 binding scenarios ledger. Example: 'machine_forward_guard'"
+                },
+                "scene_description": {
+                  "type": "string",
+                  "description": "Human-readable scene description. Example: '工作流节点推进验证（Forward.guard）'"
+                },
+                "scene_constraints": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Special constraints for the matched scene. Example: ['Machine 发布后 Forward.guard 不可修改']"
+                },
+                "suggested_patterns": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Suggested Guard patterns based on user intent. Example: ['时间锁','进度状态检查']"
+                },
+                "available_queries": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "integer",
+                        "description": "Query instruction ID. Example: 1253"
+                      },
+                      "name": {
+                        "type": "string",
+                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                      },
+                      "objectType": {
+                        "type": "string",
+                        "description": "Target object type. Example: 'Progress'"
+                      },
+                      "returnType": {
+                        "type": "string",
+                        "description": "Return value type. Example: 'String'"
+                      },
+                      "description": {
+                        "type": "string",
+                        "description": "Query description"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "objectType",
+                      "returnType"
+                    ],
+                    "additionalProperties": false,
+                    "description": "A Guard query instruction available for the current context (subset of GUARDQUERY 375 entries)."
+                  },
+                  "description": "Available query instructions for the current context (subset of 375 GUARDQUERY entries)"
+                },
+                "risk_warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Risk warnings for the current Guard design. Example: ['Guard 创建后不可修改','时间锁测试用 1000ms']"
+                },
+                "pending_questions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Questions for the user to complete the puzzle. Example: ['Guard 将绑定到哪个 Host Object？']"
+                },
+                "confirmation_text": {
+                  "type": "string",
+                  "description": "Structured semantic confirmation text for user review (generated when puzzle is complete). User must explicitly confirm before CREATE."
+                },
+                "test_result": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "pass",
+                        "fail",
+                        "not_tested"
+                      ]
+                    },
+                    "failure_node": {
+                      "type": "string",
+                      "description": "Node that caused failure (if fail)"
+                    },
+                    "passport_id": {
+                      "type": "string",
+                      "description": "Generated Passport ID (if pass)"
+                    }
+                  },
+                  "required": [
+                    "status"
+                  ],
+                  "additionalProperties": false,
+                  "description": "gen_passport static test result. Must pass before CREATE."
+                },
+                "risk_assessment": {
+                  "type": "object",
+                  "properties": {
+                    "overall_risk": {
+                      "type": "string",
+                      "enum": [
+                        "critical",
+                        "high",
+                        "medium",
+                        "low",
+                        "info"
+                      ],
+                      "description": "Overall risk level (highest from all risks)"
+                    },
+                    "risk_count": {
+                      "type": "integer",
+                      "description": "Total number of detected risks"
+                    },
+                    "critical_count": {
+                      "type": "integer",
+                      "description": "Number of critical risks"
+                    },
+                    "high_count": {
+                      "type": "integer",
+                      "description": "Number of high risks"
+                    },
+                    "needs_human_review": {
+                      "type": "boolean",
+                      "description": "Whether human review is required (critical or 2+ high risks)"
+                    },
+                    "top_risks": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Top risk titles (critical and high, max 3)"
+                    },
+                    "stakeholder_advice": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "description": "Per-stakeholder advice. Key=stakeholder (customer/provider/arbitrator/claimant), value=advice list"
+                    }
+                  },
+                  "required": [
+                    "overall_risk",
+                    "risk_count",
+                    "critical_count",
+                    "high_count",
+                    "needs_human_review",
+                    "top_risks"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Business-layer risk assessment (game theory, data source trust, logic gaps). Populated during Guard design to warn about business risks beyond syntax."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Phase 5 Guard capability advice (populated when user intent involves Guard). Provides puzzle status, scene matching, suggested patterns, available queries, risk warnings, and confirmation text. AI uses this to guide Guard design dialogue (R1-R10)."
             }
           },
           "required": [

package/dist/schemas/bridge_operation.schema.json

@@ -36,6 +36,16 @@
                   "type": "string",
                   "pattern": "^0x[0-9a-fA-F]{40}$",
                   "description": "Final withdrawal EVM address; if omitted, assets remain in activeEvmAccount. When provided, the SDK uses the activeEvmAccount key to transfer to this address."
+                },
+                "idempotencyKey": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "description": "Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true)."
+                },
+                "idempotentByParams": {
+                  "type": "boolean",
+                  "description": "If true, auto-generates an idempotency key from token+amount+withdrawTo. Use when you want implicit idempotency without managing explicit keys."
                 }
               },
               "required": [
@@ -91,6 +101,14 @@
                 "project": {
                   "type": "string",
                   "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+                },
+                "client_schema_version": {
+                  "type": "string",
+                  "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+                },
+                "schema_strict_mode": {
+                  "type": "boolean",
+                  "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
                 }
               },
               "additionalProperties": false,
@@ -132,6 +150,14 @@
                 "recipientWowAddress": {
                   "type": "string",
                   "description": "WOW recipient address or account name; defaults to env.account if omitted"
+                },
+                "idempotencyKey": {
+                  "$ref": "#/definitions/bridge_operation/anyOf/0/properties/data/properties/idempotencyKey",
+                  "description": "Idempotency key to prevent duplicate deposits on retry. If a successful transfer with this key exists, returns it immediately (idempotentHit=true)."
+                },
+                "idempotentByParams": {
+                  "type": "boolean",
+                  "description": "If true, auto-generates an idempotency key from token+amount+recipientWowAddress. Use when you want implicit idempotency without managing explicit keys."
                 }
               },
               "required": [
@@ -186,6 +212,39 @@
           "additionalProperties": false,
           "description": "WOW→EVM claim (step 2): claim assets on EVM after bridge signed. Requires activeEvmAccount to have EVM gas. [Requires WOW mainnet env]"
         },
+        {
+          "type": "object",
+          "properties": {
+            "operation_type": {
+              "type": "string",
+              "const": "resume_transfer"
+            },
+            "data": {
+              "type": "object",
+              "properties": {
+                "transferId": {
+                  "type": "string",
+                  "description": "Transfer ID to resume (br_<timestamp>_<counter>)"
+                }
+              },
+              "required": [
+                "transferId"
+              ],
+              "additionalProperties": false,
+              "description": "Resume an interrupted transfer from its current step. Use this when a transfer was interrupted (e.g. MCP restart, network error) and you want to continue from where it left off. The SDK determines the current step and attempts to advance it: - If deposit step failed: retries the deposit - If deposit is pending/confirmed: waits for bridge signatures and proceeds to claim - If claim step is ready: executes the claim - If transfer is already complete: returns the existing record (idempotentHit=true) [Returns] The updated transfer record after attempting to advance it. [Requires env] WOW env is needed for WOW-side operations; EVM-side operations use activeEvmAccount."
+            },
+            "env": {
+              "$ref": "#/definitions/bridge_operation/anyOf/0/properties/env",
+              "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."
+            }
+          },
+          "required": [
+            "operation_type",
+            "data"
+          ],
+          "additionalProperties": false,
+          "description": "Resume an interrupted transfer from its current step. Safe to retry. [Requires WOW mainnet env for WOW-side operations]"
+        },
         {
           "type": "object",
           "properties": {
@@ -255,7 +314,7 @@
               "type": "object",
               "properties": {
                 "network": {
-                  "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                  "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                   "description": "Specific chain; if omitted, queries all supported chains"
                 },
                 "tokens": {
@@ -301,7 +360,7 @@
               "type": "object",
               "properties": {
                 "network": {
-                  "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                  "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                   "description": "Specific chain; if omitted, returns token lists for all supported chains"
                 }
               },
@@ -349,7 +408,7 @@
                   "description": "Filter by transfer direction"
                 },
                 "token": {
-                  "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/token",
+                  "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/token",
                   "description": "Filter by token type (ETH/WETH/WBTC/USDC/USDT)"
                 },
                 "limit": {
@@ -421,7 +480,7 @@
                       "description": "List all configured RPC endpoints with health status"
                     },
                     "network": {
-                      "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                      "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                       "description": "Target chain (defaults to Ethereum mainnet)"
                     }
                   },
@@ -440,7 +499,7 @@
                       "description": "Append one or more RPC endpoints"
                     },
                     "network": {
-                      "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                      "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                       "description": "Target chain (defaults to Ethereum mainnet)"
                     },
                     "rpcUrls": {
@@ -469,7 +528,7 @@
                       "description": "Remove one or more RPC endpoints"
                     },
                     "network": {
-                      "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                      "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                       "description": "Target chain (defaults to Ethereum mainnet)"
                     },
                     "rpcUrls": {
@@ -498,7 +557,7 @@
                       "description": "Full replace all RPC endpoints"
                     },
                     "network": {
-                      "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                      "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                       "description": "Target chain (defaults to Ethereum mainnet)"
                     },
                     "rpcUrls": {
@@ -527,7 +586,7 @@
                       "description": "Health check one or more RPC endpoints"
                     },
                     "network": {
-                      "$ref": "#/definitions/bridge_operation/anyOf/3/properties/data/properties/network",
+                      "$ref": "#/definitions/bridge_operation/anyOf/4/properties/data/properties/network",
                       "description": "Target chain (defaults to Ethereum mainnet)"
                     },
                     "rpcUrls": {

package/dist/schemas/config_operation.output.json

@@ -0,0 +1,18 @@
+{
+  "$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.",
+  "$ref": "#/definitions/config_operation",
+  "definitions": {
+    "config_operation": {
+      "type": "object",
+      "properties": {
+        "result": {
+          "description": "Config result — shape depends on action"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/dist/schemas/config_operation.schema.json

@@ -0,0 +1,34 @@
+{
+  "$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.",
+  "$ref": "#/definitions/config_operation",
+  "definitions": {
+    "config_operation": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "list",
+            "toggle",
+            "enable",
+            "disable",
+            "reset",
+            "info"
+          ],
+          "description": "Config action to perform"
+        },
+        "service": {
+          "type": "string",
+          "description": "Service name (required for toggle/enable/disable/reset/info)"
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    }
+  }
+}