@wowok/agent-mcp 2.7.7 → 2.7.10

package/dist/schemas/goal_operation.schema.json

@@ -0,0 +1,1016 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/goal_operation.json",
+  "title": "Goal - Goal-Driven Lifecycle (GoalEngine)",
+  "description": "GoalEngine Agent portal (K3 24) — record a user goal and track it through the nine-station lifecycle RECOGNIZE → CONFIRM → BIND → PLAN → APPROVE → ACT → MONITOR → COMPLETE. Actions: create (classify + dedupe-adopt; goal types with a dedicated playbook automatically attach a TaskProcess — the long-task carrier with named stages + events/problems/feedback/decisions streams; create_process=true forces one for generic goal types), list, get (goals with a process also return process_summary: current stage, per-stage progress, open problems, last events, feedback count — the interrupted-task resume surface; resume by continuing advance), approve (plan approval for the confirm gate), advance (stage move + ACT object registration, written back into the process manifest), pause, complete (chain-state verification or force; pass feedback {sentiment, comment} to record it on the process; the outcome is distilled into the experience layer), abandon.",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "create"
+        },
+        "intent_text": {
+          "type": "string",
+          "description": "Raw user intent text. goal_type is classified deterministically unless overridden."
+        },
+        "title": {
+          "description": "Short goal title; defaults to the first line of intent_text.",
+          "type": "string"
+        },
+        "goal_type": {
+          "description": "Explicit goal_type override (publish_service | fulfill_order | capture_demand | purchase_service | collaborate_flow | supply_suborder | publish_demand | run_arbitration | dispute_resolution | manage_assets).",
+          "type": "string",
+          "enum": [
+            "publish_service",
+            "fulfill_order",
+            "capture_demand",
+            "purchase_service",
+            "collaborate_flow",
+            "supply_suborder",
+            "publish_demand",
+            "run_arbitration",
+            "dispute_resolution",
+            "manage_assets"
+          ]
+        },
+        "account": {
+          "description": "BIND station: local account name or address the goal operates with. When given, the goal starts at stage 'bound' (with a local-account preflight).",
+          "type": "string"
+        },
+        "persona": {
+          "description": "Persona id/name recorded on the binding.",
+          "type": "string"
+        },
+        "conversation_id": {
+          "description": "Originating chat conversation id (the client injects this automatically; links the goal back to its conversation).",
+          "type": "string"
+        },
+        "create_process": {
+          "description": "TaskProcess creation override. Processes are created BY DEFAULT for goal types with a dedicated playbook (publish_service, fulfill_order, capture_demand, publish_demand, purchase_service); pass true to also attach one to a generic-playbook goal type.",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "intent_text"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "list"
+        },
+        "stage": {
+          "description": "Filter by stage.",
+          "type": "string",
+          "enum": [
+            "recognized",
+            "confirmed",
+            "bound",
+            "planned",
+            "approved",
+            "acting",
+            "monitoring",
+            "completed",
+            "paused",
+            "abandoned"
+          ]
+        },
+        "account": {
+          "description": "Filter by bound account.",
+          "type": "string"
+        },
+        "conversation_id": {
+          "description": "Filter by originating conversation id (the conversation↔goal link).",
+          "type": "string"
+        },
+        "include_finished": {
+          "description": "Include terminal goals (completed/abandoned). Default false.",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "get"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "approve"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "note": {
+          "description": "Human note recorded on the approval audit entry.",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "bind"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "account": {
+          "type": "string",
+          "description": "Local account name or address to bind (BIND station; runs a local-account preflight)."
+        },
+        "persona": {
+          "description": "Persona id/name recorded on the binding.",
+          "type": "string"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id",
+        "account"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "advance"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "stage": {
+          "description": "Target stage (forward-only along recognized→confirmed→bound→planned→approved→acting→monitoring; 'paused' holds from anywhere; from 'paused' resume anywhere). Entering 'monitoring' auto-binds monitor focus for the goal's objects.",
+          "type": "string",
+          "enum": [
+            "recognized",
+            "confirmed",
+            "bound",
+            "planned",
+            "approved",
+            "acting",
+            "monitoring",
+            "paused"
+          ]
+        },
+        "objects": {
+          "description": "ACT station: objects created/adopted by this goal (deduped by type+address).",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "description": "Object type name (e.g. 'Service', 'Order', 'Demand', 'Progress')."
+              },
+              "object": {
+                "type": "string",
+                "description": "On-chain object address (0x…)."
+              }
+            },
+            "required": [
+              "type",
+              "object"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "pause"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "complete"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "force": {
+          "description": "Skip on-chain completion-condition verification (audited as outcome.forced).",
+          "type": "boolean"
+        },
+        "feedback": {
+          "description": "User feedback recorded on the goal's TaskProcess (feedback.jsonl) and used as outcome evidence for the experience layer (REFLECT).",
+          "type": "object",
+          "properties": {
+            "sentiment": {
+              "type": "string",
+              "enum": [
+                "positive",
+                "negative",
+                "neutral"
+              ],
+              "description": "Overall sentiment about how the goal went."
+            },
+            "comment": {
+              "type": "string",
+              "description": "Free-form feedback comment."
+            }
+          },
+          "required": [
+            "sentiment",
+            "comment"
+          ],
+          "additionalProperties": false
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "abandon"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "reason": {
+          "type": "string",
+          "description": "Why the goal is given up (required, recorded on the outcome)."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id",
+        "reason"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "delete"
+        },
+        "id": {
+          "type": "string",
+          "description": "Goal id (goal_…)."
+        },
+        "force": {
+          "description": "Allow deleting a NON-terminal goal. The goal's monitor focus, radar intents and plan approval are torn down first so no bindings are orphaned. Terminal goals (completed/abandoned) never need force.",
+          "type": "boolean"
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "analyze_intent"
+        },
+        "intent": {
+          "description": "Business intent text (e.g. 'I rent cameras to photographers with deposit and damage inspection'). Used as the primary input; falls back to project_description / project_name when omitted.",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "project_name": {
+          "description": "Optional business name — used as an intent fallback when 'intent' is omitted.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "project_description": {
+          "description": "Optional business description — used as an intent fallback when 'intent' is omitted.",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "project_industry": {
+          "description": "Industry tag. Drives industry-specific risk calibration (e.g. 'freelance' does NOT require compensation_fund, while 'rental'/'travel' do). Supported industries: 'general' (no preset), 'retail', 'retail_d2c', 'service', 'rental', 'freelance', 'education', 'travel', 'subscription', 'custom'.",
+          "type": "string",
+          "enum": [
+            "general",
+            "retail",
+            "retail_d2c",
+            "service",
+            "rental",
+            "freelance",
+            "education",
+            "travel",
+            "subscription",
+            "custom"
+          ]
+        },
+        "target_objects": {
+          "description": "Optional explicit target objects (entry_ids or object_type names). When provided, puzzle snapshots are restricted to these objects.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "C1: natural-language business intent → parsed intent (primary/secondary objects, detected scenes, industry) + per-object puzzle snapshots + recommended creation order."
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "aggregate_risks"
+        },
+        "project": {
+          "description": "Project prefix (human-readable unique identifier, e.g. 'myshop'). Used to key the service-build stage cache.",
+          "type": "string"
+        },
+        "version": {
+          "description": "Project version (e.g. 'v1') for the service-build stage cache. Defaults to 'v1'.",
+          "type": "string",
+          "pattern": "^v\\d+$"
+        },
+        "puzzles": {
+          "description": "Per-object puzzle snapshots, keyed by object_type. Pass the 'puzzles' field from a prior analyze_intent result UNCHANGED. When omitted but 'intent' is present, the handler runs analyze_intent first (C1→C2 in one call).",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "puzzle": {
+                "description": "Puzzle snapshot (opaque — pass through from analyze_intent output unchanged)."
+              },
+              "completeness": {
+                "description": "Completeness snapshot (opaque — pass through unchanged)."
+              },
+              "missing_dimensions": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Dimensions still missing for this object."
+              }
+            },
+            "required": [
+              "puzzle",
+              "completeness",
+              "missing_dimensions"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "intent": {
+          "description": "Business intent text (e.g. 'I rent cameras to photographers with deposit and damage inspection'). Used as the primary input; falls back to project_description / project_name when omitted.",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "project_name": {
+          "description": "Optional business name — used as an intent fallback when 'intent' is omitted.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "project_description": {
+          "description": "Optional business description — used as an intent fallback when 'intent' is omitted.",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "project_industry": {
+          "description": "Industry tag. Drives industry-specific risk calibration (e.g. 'freelance' does NOT require compensation_fund, while 'rental'/'travel' do). Supported industries: 'general' (no preset), 'retail', 'retail_d2c', 'service', 'rental', 'freelance', 'education', 'travel', 'subscription', 'custom'.",
+          "type": "string",
+          "enum": [
+            "general",
+            "retail",
+            "retail_d2c",
+            "service",
+            "rental",
+            "freelance",
+            "education",
+            "travel",
+            "subscription",
+            "custom"
+          ]
+        },
+        "severity_threshold": {
+          "description": "Severity threshold (default 'HIGH'). Risks at or above this level block deployment (status RISK_BLOCKED).",
+          "type": "string",
+          "enum": [
+            "CRITICAL",
+            "HIGH",
+            "MEDIUM",
+            "LOW",
+            "INFO"
+          ]
+        },
+        "user_confirmed_high_risks": {
+          "description": "IDs of HIGH risks already confirmed in a prior round. Confirmed HIGH risks no longer trigger RISK_PENDING_CONFIRM.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "planned_objects": {
+          "description": "Planned objects for the OBJECT_REUSE check (safety-rules). Flags NEW objects whose type carries an always/strongly-recommended reuse rule.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object_type": {
+                "type": "string",
+                "description": "Wowok object type (e.g. 'service', 'guard', 'machine')."
+              },
+              "is_new": {
+                "type": "boolean",
+                "description": "true when creating a NEW object; false when reusing an existing one."
+              },
+              "name": {
+                "description": "Planned object name (for readable messages).",
+                "type": "string"
+              }
+            },
+            "required": [
+              "object_type",
+              "is_new"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "planned_operations": {
+          "description": "Planned create/publish operations for the IMMUTABILITY check (safety-rules). Warns which fields become permanently locked after each operation.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "object_type": {
+                "type": "string",
+                "description": "Wowok object type (e.g. 'service', 'arbitration')."
+              },
+              "trigger": {
+                "type": "string",
+                "enum": [
+                  "create",
+                  "publish"
+                ],
+                "description": "Lifecycle trigger that locks fields."
+              },
+              "name": {
+                "description": "Object name (for readable messages).",
+                "type": "string"
+              }
+            },
+            "required": [
+              "object_type",
+              "trigger"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "C2: puzzle snapshots → cross-object risk calibration (CRITICAL/HIGH/MEDIUM/LOW/INFO) with blocking status. DX sugar: when 'puzzles' is omitted but 'intent' is present, the handler runs analyze_intent first."
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "trace_substeps"
+        },
+        "project": {
+          "description": "Project prefix (human-readable unique identifier, e.g. 'myshop'). Used to key the service-build stage cache.",
+          "type": "string"
+        },
+        "version": {
+          "description": "Project version (e.g. 'v1') for the service-build stage cache. Defaults to 'v1'.",
+          "type": "string",
+          "pattern": "^v\\d+$"
+        },
+        "substeps": {
+          "description": "Substep execution records (63-spec §2.1). Required when action='trace_substeps'. Construct from your deployment execution trace.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step_id": {
+                "type": "string",
+                "description": "Substep id, format 'T<step>.<substep>' e.g. 'T1.1'."
+              },
+              "parent_step": {
+                "type": "string",
+                "description": "Parent step id, format 'T<step>' e.g. 'T1'."
+              },
+              "object_type": {
+                "type": "string",
+                "enum": [
+                  "service",
+                  "machine",
+                  "guard",
+                  "permission",
+                  "reward",
+                  "arb",
+                  "progress",
+                  "treasury",
+                  "demand",
+                  "repository",
+                  "contact",
+                  "order",
+                  "allocation",
+                  "personal",
+                  "payment",
+                  "proof"
+                ],
+                "description": "Wowok object type this substep operates on."
+              },
+              "entry_id": {
+                "type": "string",
+                "description": "Puzzle entry_id this substep corresponds to."
+              },
+              "operation_type": {
+                "type": "string",
+                "description": "operation_type for onchain_operations."
+              },
+              "network": {
+                "type": "string",
+                "enum": [
+                  "testnet",
+                  "mainnet"
+                ],
+                "description": "Target network."
+              },
+              "input": {
+                "type": "object",
+                "properties": {
+                  "data": {
+                    "type": "object",
+                    "propertyNames": {
+                      "type": "string"
+                    },
+                    "additionalProperties": {},
+                    "description": "Input data payload."
+                  },
+                  "input_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Upstream substep_ids this substep consumes."
+                  }
+                },
+                "required": [
+                  "data",
+                  "input_refs"
+                ],
+                "additionalProperties": false
+              },
+              "output": {
+                "description": "Output data (filled after execution).",
+                "type": "object",
+                "properties": {
+                  "object_id": {
+                    "type": "string"
+                  },
+                  "tx_digest": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": {}
+              },
+              "timestamp": {
+                "type": "number",
+                "description": "Execution timestamp (ms)."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "PENDING",
+                  "SUCCESS",
+                  "FAILED",
+                  "SKIPPED"
+                ],
+                "description": "Execution status."
+              },
+              "failure_reason": {
+                "description": "Failure reason (when status='FAILED').",
+                "type": "string"
+              },
+              "dependencies": {
+                "type": "object",
+                "properties": {
+                  "input_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "output_refs": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "substep_id": {
+                          "type": "string",
+                          "description": "Downstream substep that consumes this output."
+                        },
+                        "field_path": {
+                          "type": "string",
+                          "description": "Field path produced by this substep (e.g. 'permission_address')."
+                        }
+                      },
+                      "required": [
+                        "substep_id",
+                        "field_path"
+                      ],
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "required": [
+                  "input_refs",
+                  "output_refs"
+                ],
+                "additionalProperties": false,
+                "description": "Dependencies (input_refs + output_refs)."
+              },
+              "retry_info": {
+                "description": "Retry info (when this substep is a retry of an earlier one).",
+                "type": "object",
+                "properties": {
+                  "original_step_id": {
+                    "type": "string"
+                  },
+                  "retry_count": {
+                    "type": "number"
+                  },
+                  "retry_reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "original_step_id",
+                  "retry_count",
+                  "retry_reason"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "required": [
+              "step_id",
+              "parent_step",
+              "object_type",
+              "entry_id",
+              "operation_type",
+              "network",
+              "input",
+              "timestamp",
+              "status",
+              "dependencies"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "substep_edges": {
+          "description": "Explicit DAG edges. When omitted, edges are derived from each substep's input_refs.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "source": {
+                "type": "string",
+                "description": "Source substep id."
+              },
+              "target": {
+                "type": "string",
+                "description": "Target substep id (depends on source)."
+              },
+              "field_path": {
+                "type": "string",
+                "description": "Field path flowing along this edge."
+              }
+            },
+            "required": [
+              "source",
+              "target",
+              "field_path"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "C3: substep execution records → DAG coherence analysis (dangling inputs, circular refs, missing outputs, cross-step breaks, topological order, D-10 verdict)."
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "merchant_guide"
+        },
+        "intent": {
+          "description": "Business intent text (e.g. 'I rent cameras to photographers with deposit and damage inspection'). Used as the primary input; falls back to project_description / project_name when omitted.",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "project_name": {
+          "description": "Optional business name — used as an intent fallback when 'intent' is omitted.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "project_description": {
+          "description": "Optional business description — used as an intent fallback when 'intent' is omitted.",
+          "type": "string",
+          "maxLength": 2000
+        },
+        "project_industry": {
+          "description": "Industry tag. Drives industry-specific risk calibration (e.g. 'freelance' does NOT require compensation_fund, while 'rental'/'travel' do). Supported industries: 'general' (no preset), 'retail', 'retail_d2c', 'service', 'rental', 'freelance', 'education', 'travel', 'subscription', 'custom'.",
+          "type": "string",
+          "enum": [
+            "general",
+            "retail",
+            "retail_d2c",
+            "service",
+            "rental",
+            "freelance",
+            "education",
+            "travel",
+            "subscription",
+            "custom"
+          ]
+        },
+        "guide_state": {
+          "description": "Wizard state from a prior merchant_guide result. Pass back UNCHANGED on every subsequent call. The handler re-runs the pipeline deterministically and advances to the furthest reachable step.",
+          "type": "object",
+          "properties": {
+            "intent_text": {
+              "type": "string",
+              "description": "Step 1: raw merchant business description."
+            },
+            "confirmed_industry": {
+              "description": "Step 2: merchant-confirmed industry id.",
+              "type": "string"
+            },
+            "currency": {
+              "description": "Step 5: payment currency (default WOW).",
+              "type": "string"
+            },
+            "deliverables": {
+              "description": "Step 4: merchant-defined deliverables (opaque passthrough).",
+              "type": "array",
+              "items": {}
+            },
+            "payment_override": {
+              "description": "Step 5: payment structure overrides (opaque passthrough).",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            },
+            "trust_override": {
+              "description": "Step 6: trust mechanism overrides (opaque passthrough).",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            },
+            "adopted_module_ids": {
+              "description": "Step 6: merchant-confirmed business module ids.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "intent_text"
+          ],
+          "additionalProperties": false
+        },
+        "guide_confirm": {
+          "description": "Merchant decisions for the current wizard step. Merged over guide_state. Typical flow: call 1 with intent only → receive step-2 industry options → call 2 with guide_state + guide_confirm={industry} → receive full blueprint plan (steps 7-10).",
+          "type": "object",
+          "properties": {
+            "industry": {
+              "description": "Step 2 confirmation: industry id (e.g. 'freelance').",
+              "type": "string"
+            },
+            "currency": {
+              "description": "Step 5 confirmation: payment currency.",
+              "type": "string"
+            },
+            "deliverables": {
+              "description": "Step 4 confirmation: deliverable definitions.",
+              "type": "array",
+              "items": {}
+            },
+            "payment": {
+              "description": "Step 5 confirmation: { model, triggers, allocation } overrides.",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            },
+            "trust": {
+              "description": "Step 6 confirmation: { refundPolicy, arbitration, escrow } overrides.",
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            },
+            "adopted_module_ids": {
+              "description": "Step 6 confirmation: business module ids to adopt (overrides recommendation).",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        }
+      },
+      "required": [
+        "action"
+      ],
+      "additionalProperties": false,
+      "description": "10-step merchant onboarding wizard: intent text → BusinessIntent → industry confirmation → module adoption → SemanticObjectGraph blueprint → evaluation preview → harness check → creation plan. NEVER executes on-chain operations. Stateless: pass guide_state/guide_confirm to advance."
+    }
+  ]
+}