@wowok/agent-mcp 2.3.14 → 2.3.18

package/dist/schemas/onchain_events.output.json

@@ -503,6 +503,724 @@
           "description": "Event query result containing list of events and pagination info, or null if no data found"
         },
         "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/onchain_events/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."
+            },
+            "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": [
+            "intent",
+            "status",
+            "summary"
+          ],
+          "additionalProperties": false,
           "description": "Business semantic summary for the event query"
         }
       },