@wowok/agent-mcp 2.3.14 → 2.3.16

package/dist/schemas/local_mark_operation.schema.json

@@ -39,11 +39,11 @@
                       "value"
                     ],
                     "additionalProperties": false,
-                    "description": "Mark naming configuration"
+                    "description": "Mark naming configuration. MUST be an object {value: string, replaceExistName?: boolean}, NOT a plain string. Example: {name: {value: 'my-account', replaceExistName: true}}"
                   },
                   "address": {
                     "type": "string",
-                    "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, @0xaaa, @0xaab, @0x403, @0xacc, @0xc)"
+                    "description": "Valid ID: 0x prefix + 64 hex characters, or builtin ID (0x5-0x9, 0xa, 0xc, 0xd, 0x403, 0xaaa, 0xaab, 0xacc)"
                   },
                   "tags": {
                     "type": "array",
@@ -59,7 +59,7 @@
                   "address"
                 ],
                 "additionalProperties": false,
-                "description": "LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. For public on-chain marks, use the 'personal' tool instead."
+                "description": "LOCAL ONLY: Parameters for creating or updating a LOCAL mark. This data is stored privately on your device and will NEVER be published to the blockchain. For public on-chain marks, use the 'personal' tool instead. IMPORTANT: 'name' field is an OBJECT {value, replaceExistName?}, not a string."
               },
               "minItems": 1,
               "description": "Array of mark data to add (at least 1 item)"
@@ -113,7 +113,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Local mark operations. Exactly one operation type (add/remove/clear) must be specified."
+      "description": "Local mark operations. Exactly one operation type (add/remove/clear) must be specified as a NESTED field. Example: {add: {op:'add', data:[...]}} — NOT flat {op:'add', data:[...]}."
     }
   }
 }

package/dist/schemas/machineNode2file.schema.json

@@ -55,6 +55,21 @@
             "referrer": {
               "$ref": "#/definitions/machineNode2file/properties/env/properties/account",
               "description": "Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded."
+            },
+            "confirmed": {
+              "type": "boolean",
+              "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."
+            },
+            "user_intent_phrases": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Phase 2 ConfirmGate: explicit user intent phrases collected from conversation context (e.g. 'use default account', 'force publish'). Used to bypass confirmation rules whose bypass_on_explicit_intent matches."
+            },
+            "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."
             }
           },
           "additionalProperties": false,

package/dist/schemas/messenger_operation.output.json

@@ -1074,9 +1074,537 @@
                 "result"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "operation": {
+                  "type": "string",
+                  "const": "error"
+                },
+                "error": {
+                  "type": "string",
+                  "description": "Error message"
+                },
+                "error_code": {
+                  "type": "string",
+                  "description": "Error code"
+                },
+                "retryable": {
+                  "type": "boolean",
+                  "description": "Whether the operation is retryable"
+                },
+                "recovery_hint": {
+                  "type": "string",
+                  "description": "Recovery hint"
+                }
+              },
+              "required": [
+                "operation",
+                "error"
+              ],
+              "additionalProperties": false,
+              "description": "Error response"
             }
           ],
           "description": "Messenger operation result discriminated union"
+        },
+        "semantic": {
+          "type": "object",
+          "properties": {
+            "intent": {
+              "type": "string",
+              "description": "Inferred user intent / operation goal. Constraint: snake_case string. Relation: derived from operation_type + data signals. Example: 'publish_service'"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "success",
+                "partial",
+                "failed",
+                "pending_input"
+              ],
+              "description": "Business-level status (not raw tx status). 'pending_input' = needs Guard submission. Example: 'success'"
+            },
+            "summary": {
+              "type": "string",
+              "description": "One-sentence human-readable summary of what happened. AI should read this first. Example: 'Successfully published Service my-shop with Machine bound'"
+            },
+            "created": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Object ID (64-hex with 0x prefix). Identifies the on-chain object. Example: '0xa1d4...'"
+                  },
+                  "name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "Local mark name if assigned, else null. Relation: resolved via local_mark_operation. Example: 'my-shop' or null"
+                  },
+                  "role": {
+                    "type": "string",
+                    "enum": [
+                      "Permission",
+                      "Guard",
+                      "Machine",
+                      "Progress",
+                      "Service",
+                      "Order",
+                      "Allocation",
+                      "Arbitration",
+                      "ArbCase",
+                      "Messenger",
+                      "Contact",
+                      "Demand",
+                      "Reward",
+                      "Personal",
+                      "Repository",
+                      "Treasury",
+                      "Discount",
+                      "Other"
+                    ],
+                    "description": "Business role of the object in the dependency graph. Constraint: enum of 18 values. Relation: derived from objectType last segment; drives Plan/Verify Loop positioning. Example: 'Service'"
+                  },
+                  "relation": {
+                    "type": "object",
+                    "properties": {
+                      "parent": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "description": "Parent object ID, if this object belongs to another (e.g. Machine belongs to Service). Example: '0x123...' or null"
+                      },
+                      "relation_type": {
+                        "type": "string",
+                        "enum": [
+                          "machine_of",
+                          "guard_of",
+                          "allocator_of",
+                          "permission_of",
+                          "progress_of",
+                          "allocation_of",
+                          "arb_of",
+                          "other"
+                        ],
+                        "description": "How this object relates to its parent. Example: 'machine_of'"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "Relationship to another object in the dependency graph"
+                  },
+                  "immutable": {
+                    "type": "boolean",
+                    "description": "Whether the object has entered an immutable state (e.g. Service published). Constraint: true after publish. Example: true"
+                  }
+                },
+                "required": [
+                  "id",
+                  "role"
+                ],
+                "additionalProperties": false,
+                "description": "An object tagged with its business role and relationship within the object dependency graph"
+              },
+              "description": "Objects newly created in this operation, tagged with roles"
+            },
+            "modified": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/messenger_operation/properties/semantic/properties/created/items"
+              },
+              "description": "Objects mutated in this operation, tagged with roles"
+            },
+            "released": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "amount": {
+                    "type": "string",
+                    "description": "Amount change as stringified integer (smallest unit). Negative=spend, positive=receive. Example: '-10000000000'"
+                  },
+                  "coinType": {
+                    "type": "string",
+                    "description": "Coin type tag (format: {address}::{module}::{struct}). Example: '0x2::wow::WOW'"
+                  },
+                  "role": {
+                    "type": "string",
+                    "enum": [
+                      "payment",
+                      "refund",
+                      "change",
+                      "compensation",
+                      "reward",
+                      "gas",
+                      "deposit",
+                      "release",
+                      "other"
+                    ],
+                    "description": "Business role of this fund movement. Constraint: enum of 9 values. Relation: derived from operation context. Example: 'payment'"
+                  },
+                  "from": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "Sender address if known. Example: '0xabc...' or null"
+                  },
+                  "to": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "Recipient address if known. Example: '0xdef...' or null"
+                  }
+                },
+                "required": [
+                  "amount",
+                  "coinType",
+                  "role"
+                ],
+                "additionalProperties": false,
+                "description": "A fund movement tagged with its business role"
+              },
+              "description": "Fund movements in this operation, tagged with roles"
+            },
+            "events": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "event_type": {
+                    "type": "string",
+                    "description": "Raw on-chain event type tag. Example: '0x2::service::ServicePublishedEvent'"
+                  },
+                  "business_meaning": {
+                    "type": "string",
+                    "description": "Human-readable business meaning. Example: 'Service has been published and is now immutable'"
+                  },
+                  "category": {
+                    "type": "string",
+                    "enum": [
+                      "lifecycle",
+                      "state_change",
+                      "fund_flow",
+                      "permission",
+                      "guard",
+                      "other"
+                    ],
+                    "description": "Business category. Constraint: enum of 6 values. Example: 'lifecycle'"
+                  },
+                  "related_object": {
+                    "type": "string",
+                    "description": "Object ID the event relates to, if extractable. Example: '0x123...'"
+                  },
+                  "side_effect": {
+                    "type": "string",
+                    "description": "Side effect description for AI. Example: 'Customers can now place orders against this Service'"
+                  }
+                },
+                "required": [
+                  "event_type",
+                  "business_meaning",
+                  "category"
+                ],
+                "additionalProperties": false,
+                "description": "An on-chain event annotated with business semantics"
+              },
+              "description": "On-chain events annotated with business semantics (S-8)"
+            },
+            "next_actions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "description": "Recommended next action. Example: 'add sales products'"
+                  },
+                  "reason": {
+                    "type": "string",
+                    "description": "Why this action is recommended. Example: 'Service has no products; customers cannot order'"
+                  },
+                  "tool": {
+                    "type": "string",
+                    "description": "MCP tool to use, if applicable. Example: 'onchain_operations'"
+                  },
+                  "prerequisite": {
+                    "type": "string",
+                    "description": "Condition that must hold before this action. Example: 'Service must be created first'"
+                  },
+                  "priority": {
+                    "type": "string",
+                    "enum": [
+                      "required",
+                      "recommended",
+                      "optional"
+                    ],
+                    "description": "Priority. Constraint: enum. Example: 'required'"
+                  }
+                },
+                "required": [
+                  "action",
+                  "reason",
+                  "priority"
+                ],
+                "additionalProperties": false,
+                "description": "A recommended next action with priority and rationale"
+              },
+              "description": "Recommended next actions to drive the workflow forward"
+            },
+            "warnings": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Business-level warnings. Example: 'order_allocators not configured; order funds cannot be distributed'"
+            },
+            "experience": {
+              "type": "object",
+              "properties": {
+                "advice": {
+                  "type": "string",
+                  "description": "Advice from past experience. Example: 'Last time you forgot to set buy_guard; add it before publishing'"
+                },
+                "avoid": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Pitfalls to avoid based on history. Example: ['Guard rejection on delivery_proof']"
+                },
+                "relevance": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Relevance score 0-1 of the matched experience. Example: 0.85"
+                },
+                "matched_scenario": {
+                  "type": "string",
+                  "description": "Matched historical scenario. Example: 'publish_service_freelance'"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Experience layer feedback from past operations (Phase 2 议题 2)"
+            },
+            "service_status": {
+              "type": "object",
+              "properties": {
+                "active": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"
+                },
+                "inactive": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']"
+                }
+              },
+              "required": [
+                "active"
+              ],
+              "additionalProperties": false,
+              "description": "Phase 2 runtime service status (populated when semantic_rich is enabled). Lets AI see active services in each response."
+            },
+            "customer_advice": {
+              "type": "object",
+              "properties": {
+                "risk_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "description": "Composite risk score 0-100 (higher = safer). Relation: from risk-assessment.ts 4-dimension scoring. Example: 75"
+                },
+                "risk_level": {
+                  "type": "string",
+                  "enum": [
+                    "low",
+                    "medium_low",
+                    "medium_high",
+                    "high"
+                  ],
+                  "description": "Risk level bucket. 'high' = strongly discourage purchase. Example: 'medium_high'"
+                },
+                "recommendations": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Actionable recommendations for the buyer. Example: ['要求商家配置仲裁','通过 Messenger 协商退款条款']"
+                },
+                "reminders": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string",
+                        "description": "Reminder rule id. Example: 'high_risk_score'"
+                      },
+                      "stage": {
+                        "type": "string",
+                        "enum": [
+                          "browse",
+                          "evaluate",
+                          "preorder",
+                          "in_progress",
+                          "complete",
+                          "after_sale"
+                        ],
+                        "description": "Order lifecycle stage when this reminder fires. Example: 'evaluate'"
+                      },
+                      "priority": {
+                        "type": "string",
+                        "enum": [
+                          "required",
+                          "recommended",
+                          "info",
+                          "reminder"
+                        ],
+                        "description": "Priority. 'required' = blocks purchase; 'recommended' = strong caution. Example: 'required'"
+                      },
+                      "message": {
+                        "type": "string",
+                        "description": "Human-readable reminder message. Example: '🔴 综合风险分 25/100，强烈建议不购买'"
+                      },
+                      "action": {
+                        "type": "string",
+                        "description": "Suggested next action. Example: 'require merchant to bind Arbitration before ordering'"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "stage",
+                      "priority",
+                      "message"
+                    ],
+                    "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 必须人工审查'}]"
+                },
+                "preference_match": {
+                  "type": "object",
+                  "properties": {
+                    "score": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 100,
+                      "description": "Match score 0-100 (higher = better fit). Example: 75"
+                    },
+                    "matches": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Aspects that match user preferences. Example: ['价格低于均价 10%','有仲裁']"
+                    },
+                    "mismatches": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Aspects that mismatch user preferences. Example: ['交付周期超出期望']"
+                    }
+                  },
+                  "required": [
+                    "score",
+                    "matches",
+                    "mismatches"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Service-to-preference match (populated when user preferences exist). Example: {score:75, matches:[...], mismatches:[...]}"
+                }
+              },
+              "required": [
+                "recommendations",
+                "reminders"
+              ],
+              "additionalProperties": false,
+              "description": "Buyer-side advice (Phase 3 C-3.3). Populated when customer_intelligence service is enabled AND operation is order/query on a Service. Contains risk_score, recommendations, reminders, and preference_match."
+            },
+            "evolution_context": {
+              "type": "object",
+              "properties": {
+                "industry_signal": {
+                  "type": "string",
+                  "description": "Industry evolution signal summary. Example: '行业健康度 82/100（healthy）；累积 25 个行业信号'"
+                },
+                "evolution_advice": {
+                  "type": "string",
+                  "description": "Evolution advice for the current operation. Example: '建议强制配置仲裁 + 赔偿金 + 交付 Guard'"
+                },
+                "confidence": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "description": "Confidence of the evolution context 0-1. <0.5 means no data yet. Example: 0.75"
+                },
+                "health_score": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "description": "Industry health score 0-100 if available. Example: 82"
+                },
+                "pending_suggestions": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Count of pending industry update suggestions (filtered by role if role is set). Example: 3"
+                },
+                "intent": {
+                  "type": "string",
+                  "enum": [
+                    "default",
+                    "growth",
+                    "retention",
+                    "compliance",
+                    "efficiency",
+                    "trust_building",
+                    "custom"
+                  ],
+                  "description": "Phase 4 P4-6.C: Current business intent driving the scoring model. Absent = 'default'. Example: 'growth'"
+                },
+                "role_advice": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Phase 4 P4-6.C: Role-targeted advice strings (user/merchant/arbitrator). Example: ['强化忠诚度飞轮','优化首单转化']"
+                },
+                "role": {
+                  "type": "string",
+                  "enum": [
+                    "user",
+                    "merchant",
+                    "arbitrator"
+                  ],
+                  "description": "Phase 4 P4-6.C: Role used for advice routing. Example: 'merchant'"
+                }
+              },
+              "required": [
+                "confidence"
+              ],
+              "additionalProperties": false,
+              "description": "Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry health signals and evolution advice."
+            }
+          },
+          "required": [
+            "intent",
+            "status",
+            "summary"
+          ],
+          "additionalProperties": false,
+          "description": "Business semantic summary for messenger operation"
         }
       },
       "required": [