@wowok/agent-mcp 2.3.14 → 2.3.16

package/dist/schema/call/base.js

@@ -64,6 +64,9 @@ export const CallEnvSchema = z.object({
     no_cache: z.boolean().optional().describe("Whether to disable caching."),
     network: EntrypointSchema.optional(),
     referrer: NameOrAddressSchema.optional().describe("Referrer ID. If the user is using the network for the first time, the referrer ID will be recorded."),
+    confirmed: z.boolean().optional().describe("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: z.array(z.string()).optional().describe("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: z.string().optional().describe("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."),
 }).strict().describe(`IMPORTANT: Execution environment includes: account for signing operations, network selection (${ENTRYPOINT}), additional Guard permissions, and more. Used to specify context information during the call. If account is not specified, the default account ("") will be used.`);
 export const ObjectsOpSchema = z.union([
     z.object({
@@ -112,6 +115,45 @@ export const EventSemanticSchema = z.object({
     related_object: z.string().optional().describe("Object ID the event relates to, if extractable. Example: '0x123...'"),
     side_effect: z.string().optional().describe("Side effect description for AI. Example: 'Customers can now place orders against this Service'"),
 }).strict().describe("An on-chain event annotated with business semantics");
+export const ExperienceSchema = z.object({
+    advice: z.string().optional().describe("Advice from past experience. Example: 'Last time you forgot to set buy_guard; add it before publishing'"),
+    avoid: z.array(z.string()).optional().describe("Pitfalls to avoid based on history. Example: ['Guard rejection on delivery_proof']"),
+    relevance: z.number().min(0).max(1).optional().describe("Relevance score 0-1 of the matched experience. Example: 0.85"),
+    matched_scenario: z.string().optional().describe("Matched historical scenario. Example: 'publish_service_freelance'"),
+}).strict().describe("Experience layer feedback from past operations (Phase 2 议题 2). Provides advice and pitfalls based on historical patterns.");
+export const ServiceStatusSchema = z.object({
+    active: z.array(z.string()).describe("Phase 2 services currently active (enabled). Example: ['confirm_gate','project_service','experience_layer']"),
+    inactive: z.array(z.string()).optional().describe("Phase 2 services currently inactive (can be toggled via config_operation). Example: ['harness','graph_persist']"),
+}).strict().describe("Phase 2 runtime service status (populated when semantic_rich is enabled). Lets AI see which services are active in each response.");
+export const CustomerReminderSchema = z.object({
+    id: z.string().describe("Reminder rule id. Example: 'high_risk_score'"),
+    stage: z.enum(["browse", "evaluate", "preorder", "in_progress", "complete", "after_sale"]).describe("Order lifecycle stage when this reminder fires. Example: 'evaluate'"),
+    priority: z.enum(["required", "recommended", "info", "reminder"]).describe("Priority. 'required' = blocks purchase; 'recommended' = strong caution. Example: 'required'"),
+    message: z.string().describe("Human-readable reminder message. Example: '🔴 综合风险分 25/100，强烈建议不购买'"),
+    action: z.string().optional().describe("Suggested next action. Example: 'require merchant to bind Arbitration before ordering'"),
+}).strict().describe("A buyer-side reminder triggered at a specific order lifecycle stage (Phase 3 C-3).");
+export const PreferenceMatchSchema = z.object({
+    score: z.number().min(0).max(100).describe("Match score 0-100 (higher = better fit). Example: 75"),
+    matches: z.array(z.string()).describe("Aspects that match user preferences. Example: ['价格低于均价 10%','有仲裁']"),
+    mismatches: z.array(z.string()).describe("Aspects that mismatch user preferences. Example: ['交付周期超出期望']"),
+}).strict().describe("Service-to-preference match result (Phase 3 C-2). 7-dimension scoring: price/time/region/brand/bargain/emotion/risk.");
+export const CustomerAdviceSchema = z.object({
+    risk_score: z.number().min(0).max(100).optional().describe("Composite risk score 0-100 (higher = safer). Relation: from risk-assessment.ts 4-dimension scoring. Example: 75"),
+    risk_level: z.enum(["low", "medium_low", "medium_high", "high"]).optional().describe("Risk level bucket. 'high' = strongly discourage purchase. Example: 'medium_high'"),
+    recommendations: z.array(z.string()).describe("Actionable recommendations for the buyer. Example: ['要求商家配置仲裁','通过 Messenger 协商退款条款']"),
+    reminders: z.array(CustomerReminderSchema).describe("Stage-specific reminders (deduped, sorted by priority, capped to 3 high-risk). Example: [{priority:'required', message:'🔴 模糊 Guard 必须人工审查'}]"),
+    preference_match: PreferenceMatchSchema.optional().describe("Service-to-preference match (populated when user preferences exist). Example: {score:75, matches:[...], mismatches:[...]}"),
+}).strict().describe("Buyer-side advice (Phase 3 C-3.3). Populated in semantic.customer_advice for order/query operations when customer_intelligence service is enabled.");
+export const EvolutionContextSchema = z.object({
+    industry_signal: z.string().optional().describe("Industry evolution signal summary. Example: '行业健康度 82/100（healthy）；累积 25 个行业信号'"),
+    evolution_advice: z.string().optional().describe("Evolution advice for the current operation. Example: '建议强制配置仲裁 + 赔偿金 + 交付 Guard'"),
+    confidence: z.number().min(0).max(1).describe("Confidence of the evolution context 0-1. <0.5 means no data yet. Example: 0.75"),
+    health_score: z.number().min(0).max(100).optional().describe("Industry health score 0-100 if available. Example: 82"),
+    pending_suggestions: z.number().int().min(0).optional().describe("Count of pending industry update suggestions (filtered by role if role is set). Example: 3"),
+    intent: z.enum(["default", "growth", "retention", "compliance", "efficiency", "trust_building", "custom"]).optional().describe("Phase 4 P4-6.C: Current business intent driving the scoring model. Absent = 'default'. Example: 'growth'"),
+    role_advice: z.array(z.string()).optional().describe("Phase 4 P4-6.C: Role-targeted advice strings (user/merchant/arbitrator). Example: ['强化忠诚度飞轮','优化首单转化']"),
+    role: z.enum(["user", "merchant", "arbitrator"]).optional().describe("Phase 4 P4-6.C: Role used for advice routing. Example: 'merchant'"),
+}).strict().describe("Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry-level health signals, evolution advice, and role-targeted recommendations.");
 export const SemanticSummarySchema = z.object({
     intent: z.string().describe("Inferred user intent / operation goal. Constraint: snake_case string. Relation: derived from operation_type + data signals. Example: 'publish_service'"),
     status: z.enum(["success", "partial", "failed", "pending_input"]).describe("Business-level status (not raw tx status). 'pending_input' = needs Guard submission. Example: 'success'"),
@@ -122,6 +164,10 @@ export const SemanticSummarySchema = z.object({
     events: z.array(EventSemanticSchema).optional().describe("On-chain events annotated with business semantics (S-8)"),
     next_actions: z.array(NextActionSchema).optional().describe("Recommended next actions to drive the workflow forward"),
     warnings: z.array(z.string()).optional().describe("Business-level warnings. Example: 'order_allocators not configured; order funds cannot be distributed'"),
+    experience: ExperienceSchema.optional().describe("Experience layer feedback from past operations (Phase 2 议题 2)"),
+    service_status: ServiceStatusSchema.optional().describe("Phase 2 runtime service status (populated when semantic_rich is enabled). Lets AI see active services in each response."),
+    customer_advice: CustomerAdviceSchema.optional().describe("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: EvolutionContextSchema.optional().describe("Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry health signals and evolution advice."),
 }).strict().describe("Business semantic summary: translates the raw transaction response into AI-directly-understandable business meaning");
 export const CallResponseErrorSchema = z.object({
     type: z.literal("error").describe("Discriminator for this result variant. Constraint: always 'error'. Example: 'error'"),
@@ -131,6 +177,27 @@ export const CallResponseErrorSchema = z.object({
     recovery_hint: z.string().optional().describe("Recovery suggestion for AI or user. Relation: paired with error_code to guide Recover Loop. Example: 'Claim faucet tokens then retry'"),
     related_object: z.string().optional().describe("Object ID related to the error, if any. Example: '0x123...'"),
 }).describe("Error result. Contains the raw error message plus structured classification (error_code/retryable/recovery_hint) so AI can choose a recovery strategy without parsing the error string.");
+export const OperationPreviewSchema = z.object({
+    level: z.enum(["none", "standard", "amount", "publish", "irreversible"]).describe("Confirmation level. 'irreversible' = cannot be undone (arb verdict, payment). 'publish' = locks immutable fields. 'amount' = amount-sensitive. 'standard' = default-value warnings."),
+    operation: z.string().describe("operation_type that triggered the gate. Example: 'payment'"),
+    object: z.union([z.string(), z.record(z.any()), z.null()]).optional().describe("Object name/id involved (string for existing, object for new creation). Example: 'myshop_service' or {name: 'myshop_service'}"),
+    network: z.string().optional().describe("Network in use. Example: 'mainnet'"),
+    account: z.string().optional().describe("Signing account ('' = default). Example: '' or '0xabc...'"),
+    amount: z.object({
+        value: z.string().describe("Smallest-unit value as string. Example: '2500000000'"),
+        token: z.string().describe("Coin type tag. Example: '0x2::wow::WOW'"),
+        human_readable: z.string().describe("Human-readable amount. Example: '2.5 WOW'"),
+        recipient: z.string().optional().describe("Recipient address if known. Example: '0xdef...'"),
+    }).optional().describe("Amount info for amount-level confirmations."),
+    immutable_after: z.array(z.string()).optional().describe("Fields that become immutable after this op (for publish). Example: ['machine','order_allocators']"),
+    warnings: z.array(z.string()).optional().describe("Default-value warnings. Example: ['Using default account (env.account=\"\")']"),
+    irreversible: z.boolean().optional().describe("True when the operation cannot be reverted. Example: true"),
+}).strict().describe("Preview of an operation awaiting user confirmation (Phase 2 议题 4 ConfirmGate).");
+export const CallPendingConfirmationSchema = z.object({
+    type: z.literal("pending_confirmation").describe("Discriminator. The operation was NOT executed; it is blocked pending user confirmation. Re-call with env.confirmed=true to proceed, or modify/cancel."),
+    preview: OperationPreviewSchema.describe("Preview of the operation awaiting confirmation."),
+    rule_id: z.string().optional().describe("Id of the confirmation rule that matched. Example: 'publish_immutable'"),
+}).describe("Pending confirmation. The ConfirmGate blocked the operation. Read preview first; if user consents, re-invoke the SAME call with env.confirmed=true.");
 export const GuardSubmissionToFillSchema = z.object({
     guard: NameOrAddressSchema.describe("Guard object name or ID that requires submission data. Example: 'my-delivery-guard'"),
     submission: z.array(GuardTableItemSchema).describe("User-submitted data matching the Guard's required fields. Relation: structure must match the Guard table's column definitions. Example: [{field:'delivery_proof', value:'Qm...'}]"),
@@ -168,7 +235,8 @@ export const CallResultSchema = z.discriminatedUnion("type", [
     z.object({
         type: z.literal("null").describe("Discriminator for this result variant. Constraint: always 'null'. Example: 'null'"),
     }),
-]).describe("Discriminated union of 5 result types: 'transaction' (raw Sui response with digest/effects/objectChanges), 'submission' (Guard verification needed), 'error' (failed with error_code), 'data' (query result array), 'null' (no-op completed). AI should check result.type first to determine how to process the response.");
+    CallPendingConfirmationSchema,
+]).describe("Discriminated union of 6 result types: 'transaction' (raw Sui response), 'submission' (Guard verification needed), 'error' (failed with error_code), 'data' (query result array), 'null' (no-op completed), 'pending_confirmation' (ConfirmGate blocked — re-call with env.confirmed=true). AI should check result.type first to determine how to process the response.");
 export const ObjectsSchema = z.union([
     z.object({
         op: z.union([z.literal('add'), z.literal('set')]),