@wowok/agent-mcp 2.6.3 → 2.6.4

package/dist/schemas/project_operation.schema.json

@@ -40,7 +40,21 @@
             "plan_object_edit",
             "apply_object_edit",
             "patch_machine_nodes",
-            "patch_guard_tree"
+            "patch_guard_tree",
+            "recommend_industry",
+            "list_modes",
+            "derive_user_mode",
+            "evolve_user_mode",
+            "register_user_mode",
+            "unregister_user_mode",
+            "register_custom_metric",
+            "register_custom_constraint",
+            "list_metrics_constraints",
+            "analyze_intent",
+            "aggregate_risks",
+            "trace_substeps",
+            "merchant_guide",
+            "participation_radar"
           ],
           "description": "Action to perform. Two categories:\n1. Project Entity + Evaluation (15, GLM6): list_projects, create_project, create_project_from_onchain, update_project, get_project_detail, add_object, remove_object, create_version, build_graph, get_graph, evaluate_project, save_evaluation, compare_projects, refresh_objects, get_object_diff. Projects are first-class entities with SQLite persistence, rigid project-object relationships, three-pathway graph construction, and a dual rule-based + LLM-assisted evaluation engine.\n2. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events).\n3. Cross-Network Migration (FIX-012): clone_project_to_network (or its alias migrate_network) copies a source project's object metadata to a new project bound to target_network. The 5-step migration workflow: 1) call clone_project_to_network (or migrate_network) with target_network to copy metadata, 2) re-run onchain_operations with env.network=target_network to deploy objects on-chain, 3) re-register LocalMark names with the SAME names on the target network (FIX-011 cross-network consistency), 4) update_project to set service_address on the new project, 5) build_graph to construct the new project's relationship graph."
         },
@@ -397,6 +411,674 @@
             "type": "string"
           },
           "description": "Patch operations for patch_machine_nodes / patch_guard_tree. Each string is a single patch operation.\nMachine operations (13 total):\n  'add node <name>' | 'remove node <name>' | 'set description <node_name> <text...>'\n  'add edge <from> <to>' | 'remove edge <from> <to>' | 'set threshold <edge_from> <edge_to> <value>'\n  'add forward <edge_from> <edge_to> <forward_name>' | 'remove forward <edge_from> <edge_to> <forward_name>'\n  'set guard <edge_from> <edge_to> <forward_name> <guard_addr_or_name|none>'\n  'set permission <edge_from> <edge_to> <forward_name> <perm_index>'\n  'set operator <edge_from> <edge_to> <forward_name> <named_operator|none>'\n  'set weight <edge_from> <edge_to> <forward_name> <weight>'\n  'set retained_submission <edge_from> <edge_to> <forward_name> <comma_separated_indices|none>'\nGuard operations (8 total — see patch_guard_tree):\n  'add table <identifier> <name|none> <value_type> <b_submission> [json_value]'\n  'remove table <identifier>' | 'set table_value <identifier> [json_value|none]'\n  'set table_name <identifier> <name|none>' | 'set table_submission <identifier> <true|false>'\n  'set root <json_node>' | 'set rely <comma_separated_guard_addresses|none>'\nOperations are applied in order. Both patches are validated (validateMachine/validateGuard) before execution."
+        },
+        "intent": {
+          "type": "string",
+          "maxLength": 2000,
+          "description": "Business intent text for recommend_industry (e.g. 'I rent cameras to photographers with deposit and damage inspection'). Falls back to project_description / project_name when omitted."
+        },
+        "mode_source": {
+          "type": "string",
+          "description": "Source builtin mode name for derive_user_mode (e.g. 'freelance'). Call list_modes to see available modes."
+        },
+        "mode_name": {
+          "type": "string",
+          "maxLength": 100,
+          "description": "Mode name for derive_user_mode (new mode name), evolve_user_mode / unregister_user_mode (existing custom mode), register_user_mode (new mode name). Must NOT conflict with builtin mode names."
+        },
+        "mode_display_name": {
+          "type": "string",
+          "maxLength": 200,
+          "description": "Display name for derive_user_mode / register_user_mode. Defaults to mode_name."
+        },
+        "mode_changes": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Mode field overrides for derive_user_mode / evolve_user_mode / register_user_mode. For register_user_mode, REQUIRED fields: machine_shape (non-empty array of {name, role}) and key_risk (string). Common overrides: machine_shape (array of {name:string, role:string}), config_overrides (per-object config), allocator, guards, build_notes, risk_appetite. R-M1-11 ENFORCED: machine_shape node names must NOT contain dispute/refund/arb terms — disputes flow through Service.arbitrations independently of the Machine."
+        },
+        "mode_change_description": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Change description for evolve_user_mode (recorded in evolution history)."
+        },
+        "mode_bump_version": {
+          "type": "boolean",
+          "description": "Whether evolve_user_mode bumps the patch version (default true: v1.0 → v1.1)."
+        },
+        "metric_id": {
+          "type": "string",
+          "maxLength": 100,
+          "description": "Unique metric ID for register_custom_metric (e.g. 'seasonality_risk')."
+        },
+        "metric_display_name": {
+          "type": "string",
+          "maxLength": 200,
+          "description": "Display name for register_custom_metric."
+        },
+        "metric_description": {
+          "type": "string",
+          "maxLength": 1000,
+          "description": "Description for register_custom_metric."
+        },
+        "metric_type": {
+          "type": "string",
+          "enum": [
+            "risk",
+            "benefit"
+          ],
+          "description": "Metric type for register_custom_metric: 'risk' (negative) or 'benefit' (positive)."
+        },
+        "metric_scale": {
+          "type": "string",
+          "enum": [
+            "level",
+            "numeric",
+            "percentage"
+          ],
+          "description": "Metric scale for register_custom_metric: 'level' (high/medium/low), 'numeric', or 'percentage'."
+        },
+        "metric_weight": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 10,
+          "description": "Metric weight for register_custom_metric (default 1.0)."
+        },
+        "constraint_id": {
+          "type": "string",
+          "maxLength": 100,
+          "description": "Unique constraint ID for register_custom_constraint."
+        },
+        "constraint_display_name": {
+          "type": "string",
+          "maxLength": 200,
+          "description": "Display name for register_custom_constraint."
+        },
+        "constraint_description": {
+          "type": "string",
+          "maxLength": 1000,
+          "description": "Description for register_custom_constraint."
+        },
+        "constraint_rule": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "const": "capability_required"
+                },
+                "capability_id": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "capability_id"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "const": "capability_forbidden"
+                },
+                "capability_id": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "capability_id"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "const": "numeric_limit"
+                },
+                "field": {
+                  "type": "string"
+                },
+                "max": {
+                  "type": "number"
+                },
+                "min": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "type",
+                "field"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "const": "condition_required"
+                },
+                "condition": {
+                  "type": "string"
+                },
+                "ai_evaluated": {
+                  "type": "boolean",
+                  "const": true
+                }
+              },
+              "required": [
+                "type",
+                "condition",
+                "ai_evaluated"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "description": "Constraint rule for register_custom_constraint. 4 types: capability_required/capability_forbidden (capability_id), numeric_limit (field + max/min), condition_required (natural-language condition, AI-evaluated)."
+        },
+        "constraint_severity": {
+          "type": "string",
+          "enum": [
+            "hard",
+            "soft"
+          ],
+          "description": "Constraint severity for register_custom_constraint: 'hard' blocks applyTemplate on violation; 'soft' only warns (default 'soft')."
+        },
+        "constraint_on_violation": {
+          "type": "string",
+          "enum": [
+            "block",
+            "warn",
+            "log"
+          ],
+          "description": "Violation action for register_custom_constraint (default 'warn')."
+        },
+        "metric_type_filter": {
+          "type": "string",
+          "enum": [
+            "risk",
+            "benefit"
+          ],
+          "description": "Filter list_metrics_constraints by metric type."
+        },
+        "scope_filter": {
+          "type": "string",
+          "enum": [
+            "builtin",
+            "custom"
+          ],
+          "description": "Filter list_metrics_constraints by scope (builtin or custom)."
+        },
+        "target_objects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Optional explicit target objects for analyze_intent (entry_ids or object_type names). When provided, puzzle snapshots are restricted to these objects."
+        },
+        "puzzles": {
+          "type": "object",
+          "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": [
+              "missing_dimensions"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Per-object puzzle snapshots for aggregate_risks, 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)."
+        },
+        "severity_threshold": {
+          "type": "string",
+          "enum": [
+            "CRITICAL",
+            "HIGH",
+            "MEDIUM",
+            "LOW",
+            "INFO"
+          ],
+          "description": "Severity threshold for aggregate_risks (default 'HIGH'). Risks at or above this level block deployment (status RISK_BLOCKED)."
+        },
+        "user_confirmed_high_risks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "IDs of HIGH risks the user has already confirmed in a prior round (aggregate_risks). Confirmed HIGH risks no longer trigger RISK_PENDING_CONFIRM."
+        },
+        "planned_objects": {
+          "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": {
+                "type": "string",
+                "description": "Planned object name (for readable messages)."
+              }
+            },
+            "required": [
+              "object_type",
+              "is_new"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Planned objects for aggregate_risks OBJECT_REUSE check (safety-rules). Flags NEW objects whose type carries an always/strongly-recommended reuse rule."
+        },
+        "planned_operations": {
+          "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": {
+                "type": "string",
+                "description": "Object name (for readable messages)."
+              }
+            },
+            "required": [
+              "object_type",
+              "trigger"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Planned create/publish operations for aggregate_risks IMMUTABILITY check (safety-rules). Warns which fields become permanently locked after each operation."
+        },
+        "substeps": {
+          "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",
+                    "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": {
+                "type": "object",
+                "properties": {
+                  "object_id": {
+                    "type": "string"
+                  },
+                  "tx_digest": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": {},
+                "description": "Output data (filled after execution)."
+              },
+              "timestamp": {
+                "type": "number",
+                "description": "Execution timestamp (ms)."
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "PENDING",
+                  "SUCCESS",
+                  "FAILED",
+                  "SKIPPED"
+                ],
+                "description": "Execution status."
+              },
+              "failure_reason": {
+                "type": "string",
+                "description": "Failure reason (when status='FAILED')."
+              },
+              "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": {
+                "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,
+                "description": "Retry info (when this substep is a retry of an earlier one)."
+              }
+            },
+            "required": [
+              "step_id",
+              "parent_step",
+              "object_type",
+              "entry_id",
+              "operation_type",
+              "network",
+              "input",
+              "timestamp",
+              "status",
+              "dependencies"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Substep execution records for trace_substeps (63-spec §2.1). Required when action='trace_substeps'. Construct from your deployment execution trace."
+        },
+        "substep_edges": {
+          "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
+          },
+          "description": "Explicit DAG edges for trace_substeps. When omitted, edges are derived from each substep's input_refs."
+        },
+        "guide_state": {
+          "type": "object",
+          "properties": {
+            "intent_text": {
+              "type": "string",
+              "description": "Step 1: raw merchant business description."
+            },
+            "confirmed_industry": {
+              "type": "string",
+              "description": "Step 2: merchant-confirmed industry id."
+            },
+            "currency": {
+              "type": "string",
+              "description": "Step 5: payment currency (default WOW)."
+            },
+            "deliverables": {
+              "type": "array",
+              "items": {},
+              "description": "Step 4: merchant-defined deliverables (opaque passthrough)."
+            },
+            "payment_override": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Step 5: payment structure overrides (opaque passthrough)."
+            },
+            "trust_override": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Step 6: trust mechanism overrides (opaque passthrough)."
+            },
+            "adopted_module_ids": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Step 6: merchant-confirmed business module ids."
+            }
+          },
+          "required": [
+            "intent_text"
+          ],
+          "additionalProperties": false,
+          "description": "Wizard state from a prior merchant_guide result. Pass back UNCHANGED on every subsequent call (same pattern as C1→C2 puzzles). The handler re-runs the pipeline deterministically and advances to the furthest reachable step."
+        },
+        "guide_confirm": {
+          "type": "object",
+          "properties": {
+            "industry": {
+              "type": "string",
+              "description": "Step 2 confirmation: industry id (e.g. 'freelance')."
+            },
+            "currency": {
+              "type": "string",
+              "description": "Step 5 confirmation: payment currency."
+            },
+            "deliverables": {
+              "type": "array",
+              "items": {},
+              "description": "Step 4 confirmation: deliverable definitions."
+            },
+            "payment": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Step 5 confirmation: { model, triggers, allocation } overrides."
+            },
+            "trust": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Step 6 confirmation: { refundPolicy, arbitration, escrow } overrides."
+            },
+            "adopted_module_ids": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Step 6 confirmation: business module ids to adopt (overrides recommendation)."
+            }
+          },
+          "additionalProperties": false,
+          "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)."
+        },
+        "radar_account": {
+          "type": "string",
+          "description": "Account to analyze — address (0x...) or LocalMark name (resolved to an address). Required when action='participation_radar'. The perspective (customer/operator/observer) is DERIVED from on-chain data (Order.builder + PermissionPerm grants) — never asserted by this field."
+        },
+        "radar_targets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "progress": {
+                "type": "string",
+                "description": "Progress object address (0x...) or LocalMark name. The Progress carries the current node + bound Machine."
+              },
+              "order": {
+                "type": "string",
+                "description": "Order object address or LocalMark name (optional but recommended — enables order-holder detection, service-level compensation/reward claims, and dispute context)."
+              }
+            },
+            "required": [
+              "progress"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1,
+          "maxItems": 20,
+          "description": "In-flight orders to analyze (1-20). Required when action='participation_radar'. Each target is analyzed independently; results are aggregated into one account dashboard."
+        },
+        "radar_include_alerts": {
+          "type": "boolean",
+          "description": "Attach order-monitor alerts (progress stall / compensation fund / review & arbitration windows) to each per-order result. Default true."
+        },
+        "radar_monitor_thresholds": {
+          "type": "object",
+          "properties": {
+            "progress_stall_hours": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Progress stall alert threshold in HOURS. Default 0 = auto (expected_node_duration × 2)."
+            },
+            "compensation_drop_ratio": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "description": "Compensation fund drop alert ratio (0-1). Default 0.3 = alert on ≥30% drop."
+            },
+            "compensation_coverage_min": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "description": "Minimum compensation coverage ratio vs order amount (0-1). Default 1.0 = must fully cover."
+            },
+            "messenger_timeout_hours": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Messenger no-reply timeout in HOURS. Default 24."
+            },
+            "review_window_closing_days": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Review window near-closing alert threshold in DAYS. Default 3."
+            },
+            "arb_window_closing_days": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Arbitration window near-closing alert threshold in DAYS. Default 3."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Optional per-call overrides for order-monitor alert thresholds (only used when radar_include_alerts is on). All fields optional; omitted fields keep defaults. Units: hours/days as marked per field."
         }
       },
       "required": [