@wowok/agent-mcp 2.3.16 → 2.4.1

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/schema/utils/guard-parser.js

@@ -29,11 +29,11 @@ function parseMarkdownToGuardData(markdown) {
         return { data: jsonMatch.json, errors: [] };
     }
     const result = {};
-    const descriptionMatch = markdown.match(/(?:^|\n)#+\s*(?:Description|描述)[^\n]*\n+([^\n#]+)/i);
+    const descriptionMatch = markdown.match(/(?:^|\n)#+\s*Description[^\n]*\n+([^\n#]+)/i);
     if (descriptionMatch) {
         result.description = descriptionMatch[1].trim();
     }
-    const tableMatch = markdown.match(/(?:^|\n)#+\s*(?:Table|数据表)[^\n]*\n+[\s\S]*?(?=(?:\n#+|$))/i);
+    const tableMatch = markdown.match(/(?:^|\n)#+\s*Table[^\n]*\n+[\s\S]*?(?=(?:\n#+|$))/i);
     if (tableMatch) {
         const tableSection = tableMatch[0];
         const tableRows = tableSection.match(/\|[^\n]+\|/g);
@@ -72,7 +72,7 @@ function parseMarkdownToGuardData(markdown) {
     else {
         result.table = [];
     }
-    const rootMatch = markdown.match(/(?:^|\n)#+\s*(?:Root|根节点)[^\n]*\n+([\s\S]*?)(?=(?:\n#+|$))/i);
+    const rootMatch = markdown.match(/(?:^|\n)#+\s*Root[^\n]*\n+([\s\S]*?)(?=(?:\n#+|$))/i);
     if (rootMatch) {
         const rootSection = rootMatch[1];
         const rootJsonMatch = rootSection.match(/```(?:json)?\s*\n([\s\S]*?)```/);
@@ -88,7 +88,7 @@ function parseMarkdownToGuardData(markdown) {
             }
         }
     }
-    const relyMatch = markdown.match(/(?:^|\n)#+\s*(?:Rely|依赖)[^\n]*\n+([\s\S]*?)(?=(?:\n#+|$))/i);
+    const relyMatch = markdown.match(/(?:^|\n)#+\s*Rely[^\n]*\n+([\s\S]*?)(?=(?:\n#+|$))/i);
     if (relyMatch) {
         const relySection = relyMatch[1];
         const logicMatch = relySection.match(/\*\*Logic:\*\*\s*(AND|OR)/i);

package/dist/schema/utils/node-parser.js

@@ -40,26 +40,26 @@ function parseMarkdownToNodeData(markdown) {
     }
     const result = { op: 'add' };
     const nodes = [];
-    const opMatch = markdown.match(/(?:^|\n)#+\s*(?:Operation|操作类型)[^\n]*\n+[-*]\s*op\s*:\s*(\w+)/i);
+    const opMatch = markdown.match(/(?:^|\n)#+\s*Operation[^\n]*\n+[-*]\s*op\s*:\s*(\w+)/i);
     if (opMatch) {
         result.op = opMatch[1].toLowerCase();
     }
-    const replaceMatch = markdown.match(/(?:^|\n)#+\s*(?:Options|选项)[^\n]*\n+[-*]\s*bReplace\s*:\s*(true|false)/i);
+    const replaceMatch = markdown.match(/(?:^|\n)#+\s*Options[^\n]*\n+[-*]\s*bReplace\s*:\s*(true|false)/i);
     if (replaceMatch) {
         result.bReplace = replaceMatch[1].toLowerCase() === 'true';
     }
-    const nodeSections = markdown.split(/(?=^##\s*(?:Node|节点)[:\s])/m);
+    const nodeSections = markdown.split(/(?=^##\s*Node[:\s])/m);
     for (const section of nodeSections.slice(1)) {
-        const nodeNameMatch = section.match(/^##\s*(?:Node|节点)[:\s]+(.+?)(?:\n|$)/im);
+        const nodeNameMatch = section.match(/^##\s*Node[:\s]+(.+?)(?:\n|$)/im);
         if (!nodeNameMatch)
             continue;
         const nodeName = nodeNameMatch[1].trim();
         const node = { name: nodeName, pairs: [] };
-        const pairSections = section.split(/(?=^###\s*(?:Pair|节点对|Previous Node)[:\s])/m);
+        const pairSections = section.split(/(?=^###\s*(?:Pair|Previous Node)[:\s])/m);
         for (const pairSection of pairSections.slice(1)) {
-            const prevNodeMatch = pairSection.match(/(?:^|\n)[-*]\s*prev_node\s*[:：]\s*(.+?)(?:\n|$)/im) ||
-                pairSection.match(/^###\s*(?:Pair|节点对|Previous Node)[:\s]+(.+?)(?:\n|$)/im);
-            const thresholdMatch = pairSection.match(/(?:^|\n)[-*]\s*threshold\s*[:：]\s*(\d+)/i);
+            const prevNodeMatch = pairSection.match(/(?:^|\n)[-*]\s*prev_node\s*[:]\s*(.+?)(?:\n|$)/im) ||
+                pairSection.match(/^###\s*(?:Pair|Previous Node)[:\s]+(.+?)(?:\n|$)/im);
+            const thresholdMatch = pairSection.match(/(?:^|\n)[-*]\s*threshold\s*[:]\s*(\d+)/i);
             if (!prevNodeMatch)
                 continue;
             const pair = {
@@ -89,19 +89,19 @@ function parseMarkdownToNodeData(markdown) {
                     }
                 }
             }
-            const forwardMatches = pairSection.matchAll(/(?:^|\n)[-*]\s*(?:forward)?\s*[:：]?\s*\n?([\s\S]*?)(?=(?:\n[-*]\s*(?:forward|prev_node|threshold))|\n###|\n##|$)/gi);
+            const forwardMatches = pairSection.matchAll(/(?:^|\n)[-*]\s*(?:forward)?\s*[:]?\s*\n?([\s\S]*?)(?=(?:\n[-*]\s*(?:forward|prev_node|threshold))|\n###|\n##|$)/gi);
             for (const forwardMatch of forwardMatches) {
                 const forwardSection = forwardMatch[1];
-                const nameMatch = forwardSection.match(/\s*name\s*[:：]\s*(.+?)(?:\n|$)/im);
-                const weightMatch = forwardSection.match(/\s*weight\s*[:：]\s*(\d+)/i);
+                const nameMatch = forwardSection.match(/\s*name\s*[:]\s*(.+?)(?:\n|$)/im);
+                const weightMatch = forwardSection.match(/\s*weight\s*[:]\s*(\d+)/i);
                 if (nameMatch && weightMatch) {
                     const forward = {
                         name: nameMatch[1].trim(),
                         weight: parseInt(weightMatch[1], 10)
                     };
-                    const namedOperatorMatch = forwardSection.match(/\s*namedOperator\s*[:：]\s*(.+?)(?:\n|$)/im);
-                    const permissionIndexMatch = forwardSection.match(/\s*permissionIndex\s*[:：]\s*(\d+)/i);
-                    const guardMatch = forwardSection.match(/\s*guard\s*[:：]\s*(.+?)(?:\n|$)/im);
+                    const namedOperatorMatch = forwardSection.match(/\s*namedOperator\s*[:]\s*(.+?)(?:\n|$)/im);
+                    const permissionIndexMatch = forwardSection.match(/\s*permissionIndex\s*[:]\s*(\d+)/i);
+                    const guardMatch = forwardSection.match(/\s*guard\s*[:]\s*(.+?)(?:\n|$)/im);
                     if (namedOperatorMatch) {
                         forward.namedOperator = namedOperatorMatch[1].trim();
                     }

package/dist/schemas/bridge_operation.output.json

@@ -357,7 +357,7 @@
                 }
               },
               "additionalProperties": false,
-              "description": "Experience layer feedback from past operations (Phase 2 议题 2)"
+              "description": "Experience layer feedback from past operations (Phase 2 Topic 2)"
             },
             "service_status": {
               "type": "object",
@@ -407,7 +407,7 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Actionable recommendations for the buyer. Example: ['要求商家配置仲裁','通过 Messenger 协商退款条款']"
+                  "description": "Actionable recommendations for the buyer. Example: ['Require merchant to configure arbitration','Negotiate refund terms via Messenger']"
                 },
                 "reminders": {
                   "type": "array",
@@ -442,7 +442,7 @@
                       },
                       "message": {
                         "type": "string",
-                        "description": "Human-readable reminder message. Example: '🔴 综合风险分 25/100，强烈建议不购买'"
+                        "description": "Human-readable reminder message. Example: 'Composite risk score 25/100, strongly discourage purchase'"
                       },
                       "action": {
                         "type": "string",
@@ -458,7 +458,7 @@
                     "additionalProperties": false,
                     "description": "A buyer-side reminder triggered at a specific order lifecycle stage (Phase 3 C-3)."
                   },
-                  "description": "Stage-specific reminders (deduped, sorted by priority, capped to 3 high-risk). Example: [{priority:'required', message:'🔴 模糊 Guard 必须人工审查'}]"
+                  "description": "Stage-specific reminders (deduped, sorted by priority, capped to 3 high-risk). Example: [{priority:'required', message:'Ambiguous Guard must be human-reviewed'}]"
                 },
                 "preference_match": {
                   "type": "object",
@@ -474,14 +474,14 @@
                       "items": {
                         "type": "string"
                       },
-                      "description": "Aspects that match user preferences. Example: ['价格低于均价 10%','有仲裁']"
+                      "description": "Aspects that match user preferences. Example: ['Price 10% below average','Has arbitration']"
                     },
                     "mismatches": {
                       "type": "array",
                       "items": {
                         "type": "string"
                       },
-                      "description": "Aspects that mismatch user preferences. Example: ['交付周期超出期望']"
+                      "description": "Aspects that mismatch user preferences. Example: ['Delivery cycle exceeds expectation']"
                     }
                   },
                   "required": [
@@ -505,11 +505,11 @@
               "properties": {
                 "industry_signal": {
                   "type": "string",
-                  "description": "Industry evolution signal summary. Example: '行业健康度 82/100（healthy）；累积 25 个行业信号'"
+                  "description": "Industry evolution signal summary. Example: 'Industry health 82/100 (healthy); 25 cumulative industry signals'"
                 },
                 "evolution_advice": {
                   "type": "string",
-                  "description": "Evolution advice for the current operation. Example: '建议强制配置仲裁 + 赔偿金 + 交付 Guard'"
+                  "description": "Evolution advice for the current operation. Example: 'Recommend mandatory arbitration + compensation fund + delivery Guard'"
                 },
                 "confidence": {
                   "type": "number",
@@ -546,7 +546,7 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Phase 4 P4-6.C: Role-targeted advice strings (user/merchant/arbitrator). Example: ['强化忠诚度飞轮','优化首单转化']"
+                  "description": "Phase 4 P4-6.C: Role-targeted advice strings (user/merchant/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']"
                 },
                 "role": {
                   "type": "string",
@@ -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: 'Workflow node forward validation (Forward.guard)'"
+                },
+                "scene_constraints": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Special constraints for the matched scene. Example: ['Forward.guard cannot be modified after Machine is published']"
+                },
+                "suggested_patterns": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Suggested Guard patterns based on user intent. Example: ['time lock','progress status check']"
+                },
+                "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 cannot be modified after creation','Time lock test uses 1000ms']"
+                },
+                "pending_questions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Questions for the user to complete the puzzle. Example: ['Which Host Object will the Guard bind to?']"
+                },
+                "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": [