@wowok/agent-mcp 2.4.3 → 2.5.1

package/dist/schema/project/index.js

@@ -1,4 +1,65 @@
 import { z } from "zod";
+const IndustryEnum = z.enum([
+    "general",
+    "retail",
+    "service",
+    "rental",
+    "freelance",
+    "education",
+    "travel",
+    "subscription",
+    "custom",
+]);
+export const ProjectObjectTypeEnum = z.enum([
+    "service",
+    "machine",
+    "guard",
+    "permission",
+    "reward",
+    "arb",
+    "progress",
+    "treasury",
+    "demand",
+    "repository",
+    "contact",
+    "order",
+    "allocation",
+    "personal",
+    "payment",
+    "proof",
+]);
+export const EdgeKindEnum = z.enum([
+    "machine",
+    "order_allocators",
+    "arbitrations",
+    "compensation_fund",
+    "rewards",
+    "buy_guard",
+    "permission",
+    "guard",
+    "prev",
+    "next",
+    "forward",
+    "parent",
+    "service",
+    "progress",
+    "arbitration",
+    "sub_order",
+    "references",
+]);
+const PuzzleEntrySchema = z
+    .object({
+    puzzle: z
+        .record(z.unknown())
+        .describe("Per-object puzzle snapshot. Shape varies per object_type — see knowledge/<obj>-puzzle.ts."),
+    completeness: z
+        .record(z.unknown())
+        .describe("Completeness assessment from checkPuzzleCompleteness(). Shape varies per object."),
+    missing_dimensions: z
+        .array(z.string())
+        .describe("Dimensions still missing for this object (e.g. ['A','B'])."),
+})
+    .strict();
 export const ProjectOperationInputSchema = z
     .object({
     action: z
@@ -13,20 +74,397 @@ export const ProjectOperationInputSchema = z
         "graph_stats",
         "save_graph",
         "load_graph",
+        "analyze_intent",
+        "aggregate_risks",
+        "generate_deployment_doc",
+        "trace_substeps",
     ])
-        .describe("Query/action to perform"),
+        .describe("Action to perform. Two categories:\n" +
+        "1. Graph Query (10): list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.\n" +
+        "2. Project-Based Deployment 5-Stage (4): Call IN ORDER — analyze_intent (Stage 2) → aggregate_risks (Stage 3) → generate_deployment_doc (Stage 4) → trace_substeps (Stage 5). Each action's output includes `next_action` telling you which action to call next. Stage 1 (Project Naming) uses the `project` + `version` params."),
     project: z
         .string()
         .optional()
-        .describe("Project prefix (for list_objects)"),
+        .describe("Project prefix (for list_objects and C1-C4 actions)"),
+    version: z
+        .string()
+        .regex(/^v\d+$/)
+        .optional()
+        .describe("Project version (e.g. 'v1'). Required for C1-C4 actions."),
     object: z
         .string()
         .optional()
         .describe("Object name or address (for dependencies / referenced_by / pre_publish_check)"),
+    user_intent: z
+        .string()
+        .min(1)
+        .max(2000)
+        .optional()
+        .describe("Natural-language business intent for analyze_intent (stage 2). Required when action='analyze_intent'."),
+    industry: IndustryEnum.optional().describe("Industry hint — drives template defaults. Used by analyze_intent and aggregate_risks."),
+    target_objects: z
+        .array(z.string())
+        .optional()
+        .describe("Optional explicit target objects (entry_ids or object_type names) for analyze_intent."),
+    puzzles: z
+        .record(z.string(), PuzzleEntrySchema)
+        .optional()
+        .describe("Per-object puzzle snapshots keyed by object_type. Required for aggregate_risks and generate_deployment_doc."),
+    severity_threshold: z
+        .enum(["CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO"])
+        .optional()
+        .describe("Severity threshold for aggregate_risks. Risks at or above this level are flagged."),
+    user_confirmed_high_risks: z
+        .array(z.string())
+        .optional()
+        .describe("IDs of HIGH risks the user has already confirmed (suppressed in subsequent aggregate_risks)."),
+    business_intent: z
+        .string()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe("One-line business intent description for the deployment doc. Required when action='generate_deployment_doc'."),
+    author: z
+        .string()
+        .optional()
+        .describe("Optional author name for the deployment doc meta section."),
+    objects: z
+        .array(z
+        .object({
+        entry_id: z.string().describe("Stable id '<object_type>:<name>'"),
+        object_type: ProjectObjectTypeEnum,
+        name: z.string(),
+        reused_from: z
+            .string()
+            .optional()
+            .describe("Existing on-chain address or local name if reused"),
+        publish_required: z
+            .boolean()
+            .describe("Whether publish is required (only Service/Machine)"),
+        description: z.string().optional(),
+    })
+        .strict())
+        .optional()
+        .describe("Deployment objects for generate_deployment_doc."),
+    edges: z
+        .array(z
+        .object({
+        from: z.string(),
+        to: z.string(),
+        edge_kind: EdgeKindEnum,
+        field_path: z.string(),
+        required_at_publish: z.boolean(),
+    })
+        .strict())
+        .optional()
+        .describe("Dependency graph edges for generate_deployment_doc."),
+    steps: z
+        .array(z
+        .object({
+        step: z.number().int().positive(),
+        object_type: ProjectObjectTypeEnum,
+        operation: z.string(),
+        substep_count: z.number().int().nonnegative(),
+        depends_on: z.array(z.number().int()),
+        entry_id: z.string(),
+        network_phase: z.enum(["testnet", "mainnet", "both"]),
+    })
+        .strict())
+        .optional()
+        .describe("Topological execution plan for generate_deployment_doc."),
+    scenarios: z
+        .array(z
+        .object({
+        scenario_id: z.string(),
+        description: z.string(),
+        primary_object: z.string(),
+        supporting_objects: z.array(z.string()),
+        test_step_refs: z.array(z.string()).optional(),
+    })
+        .strict())
+        .optional()
+        .describe("Business scenarios for generate_deployment_doc §7."),
+    risk_status: z
+        .enum(["RISK_PASSED", "RISK_BLOCKED", "RISK_PENDING_CONFIRM", "RISK_CANCELLED"])
+        .optional()
+        .describe("Risk status from aggregate_risks (for D-16 check)."),
+    risk_critical_count: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("CRITICAL risk count from aggregate_risks."),
+    risk_high_count: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("HIGH risk count from aggregate_risks."),
+    run_scanner: z
+        .boolean()
+        .optional()
+        .describe("Whether to run deployment-scanner validation after generating the doc. Defaults to true."),
+    network: z
+        .enum(["testnet", "mainnet"])
+        .optional()
+        .describe("Target network for trace_substeps."),
+    substeps: z
+        .array(z
+        .object({
+        step_id: z.string().regex(/^T\d+\.\d+$/),
+        parent_step: z.string().regex(/^T\d+$/),
+        object_type: ProjectObjectTypeEnum,
+        entry_id: z.string(),
+        operation_type: z.string(),
+        network: z.enum(["testnet", "mainnet"]),
+        input: z.object({
+            data: z.record(z.unknown()),
+            input_refs: z.array(z.string()),
+        }),
+        output: z
+            .object({
+            object_id: z.string().optional(),
+            tx_digest: z.string().optional(),
+        })
+            .partial()
+            .optional(),
+        timestamp: z.number().int(),
+        status: z.enum(["PENDING", "SUCCESS", "FAILED", "SKIPPED"]),
+        failure_reason: z.string().optional(),
+        dependencies: z.object({
+            input_refs: z.array(z.string()),
+            output_refs: z.array(z.object({
+                substep_id: z.string(),
+                field_path: z.string(),
+            })),
+        }),
+        retry_info: z
+            .object({
+            original_step_id: z.string(),
+            retry_count: z.number().int().nonnegative(),
+            retry_reason: z.string(),
+        })
+            .optional(),
+    })
+        .strict())
+        .optional()
+        .describe("Substep records for trace_substeps."),
+})
+    .strict();
+const ItemsResult = (action) => z.object({
+    action: z.literal(action),
+    items: z
+        .array(z.record(z.unknown()))
+        .describe("List of result items. Each item is an untyped record — shape varies per query."),
+});
+const AnalyzeIntentResultSchema = z
+    .object({
+    action: z.literal("analyze_intent"),
+    intent_parsed: z.object({
+        primary_object: z.string(),
+        secondary_objects: z.array(z.string()),
+        detected_scenes: z.array(z.object({
+            object: z.string(),
+            scene_id: z.string(),
+        })),
+        industry: z.string(),
+        keyword_matches: z.array(z.object({
+            keyword: z.string(),
+            category: z.string(),
+            matched_objects: z.array(z.string()),
+            required_level: z.enum(["R", "C", "OPTIONAL"]),
+            match_count: z.number().int(),
+        })),
+    }),
+    puzzles: z.record(z.string(), PuzzleEntrySchema),
+    overall_completeness: z.enum(["complete", "partial", "empty"]),
+    next_step: z.string(),
+    next_action: z
+        .enum(["aggregate_risks", "none"])
+        .describe("Next project_operation action to call. 'aggregate_risks' when puzzles are complete enough; 'none' if user must fill missing fields first."),
+    warnings: z.array(z.string()),
+})
+    .strict();
+const AggregateRisksResultSchema = z
+    .object({
+    action: z.literal("aggregate_risks"),
+    namespace: z.object({
+        prefix: z.string(),
+        version: z.string(),
+        industry: z.string().optional(),
+    }),
+    findings: z.array(z.object({
+        risk_rule_id: z.string(),
+        object_type: z.string(),
+        entry_id: z.string(),
+        severity: z.enum(["CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO"]),
+        message: z.string(),
+        fix_suggestion: z.string(),
+        details: z
+            .object({
+            field_path: z.string().optional(),
+            rule_source: z.string().optional(),
+        })
+            .partial()
+            .optional(),
+    })),
+    severity_summary: z.object({
+        CRITICAL: z.number().int(),
+        HIGH: z.number().int(),
+        MEDIUM: z.number().int(),
+        LOW: z.number().int(),
+        INFO: z.number().int(),
+    }),
+    status: z.enum([
+        "RISK_PASSED",
+        "RISK_BLOCKED",
+        "RISK_PENDING_CONFIRM",
+        "RISK_CANCELLED",
+    ]),
+    pending_confirmations: z
+        .array(z.object({
+        risk_rule_id: z.string(),
+        description: z.string(),
+        fix_suggestion: z.string(),
+        object_type: z.string(),
+        entry_id: z.string(),
+    }))
+        .optional(),
+    calibrated_at: z.number().int(),
+    warnings: z.array(z.string()),
+    can_proceed: z
+        .boolean()
+        .describe("Whether the user can proceed to the next stage. False only when CRITICAL risks exist."),
+    next_action: z
+        .enum(["generate_deployment_doc", "fix_risks", "none"])
+        .describe("Next project_operation action. 'generate_deployment_doc' when can_proceed=true; 'fix_risks' when CRITICAL risks exist; 'none' for other cases."),
+    user_action_required: z
+        .string()
+        .describe("Human-readable next-step guidance."),
+})
+    .strict();
+const GenerateDeploymentDocResultSchema = z
+    .object({
+    action: z.literal("generate_deployment_doc"),
+    markdown: z.string().describe("Complete deployment MD document (§0-§7)"),
+    meta: z.object({
+        project_prefix: z.string(),
+        version: z.string(),
+        generated_at: z.string().describe("ISO timestamp"),
+        object_count: z.number().int(),
+        step_count: z.number().int(),
+    }),
+    validation: z
+        .object({
+        valid: z.boolean(),
+        checks: z.array(z.object({
+            check_id: z.string(),
+            description: z.string(),
+            status: z.enum(["PASS", "FAIL", "WARN"]),
+            notes: z.string().optional(),
+        })),
+        errors: z.array(z.string()),
+    })
+        .optional()
+        .describe("Scanner validation result. Present when run_scanner=true."),
+    can_proceed: z
+        .boolean()
+        .describe("Whether the user can proceed to stage 5. False when D-errors exist."),
+    next_action: z
+        .enum(["trace_substeps", "fix_doc_errors", "none"])
+        .describe("Next project_operation action. 'trace_substeps' when can_proceed=true; 'fix_doc_errors' when D-errors exist; 'none' for other cases."),
+    user_action_required: z.string(),
+})
+    .strict();
+const TraceSubstepsResultSchema = z
+    .object({
+    action: z.literal("trace_substeps"),
+    namespace: z.object({
+        prefix: z.string(),
+        version: z.string(),
+    }),
+    network: z.enum(["testnet", "mainnet"]),
+    coherent: z
+        .boolean()
+        .describe("True when no dangling/circular/missing/cross-step issues."),
+    dangling_inputs: z.array(z.object({
+        substep_id: z.string(),
+        missing_ref: z.string(),
+        field_path: z.string(),
+    })),
+    circular_refs: z.array(z.object({
+        cycle: z.array(z.string()),
+    })),
+    missing_outputs: z.array(z.object({
+        substep_id: z.string(),
+        expected_field: z.string(),
+        dependent_substeps: z.array(z.string()),
+    })),
+    cross_step_breaks: z.array(z.object({
+        source_step: z.string(),
+        target_step: z.string(),
+        missing_field: z.string(),
+    })),
+    step_details: z.array(z.object({
+        parent_step: z.string(),
+        total_substeps: z.number().int(),
+        successful: z.number().int(),
+        failed: z.number().int(),
+        pending: z.number().int(),
+        skipped: z.number().int(),
+        substep_ids: z.array(z.string()),
+    })),
+    topological_order: z.array(z.string()),
+    d10_check: z.object({
+        check_id: z.literal("D-10"),
+        description: z.string(),
+        status: z.enum(["PASS", "FAIL", "WARN"]),
+    }),
+    can_proceed: z
+        .boolean()
+        .describe("Whether deployment can complete. False when D-10 fails or substeps FAILED."),
+    next_action: z
+        .enum(["deploy", "fix_substeps", "none"])
+        .describe("Next action. 'deploy' when can_proceed=true (execute substeps via onchain_operations); 'fix_substeps' when issues exist; 'none' when done."),
+    user_action_required: z.string(),
 })
     .strict();
 export const ProjectOperationOutputSchema = z
     .object({
-    result: z.any().describe("Query result — shape depends on action"),
+    result: z.discriminatedUnion("action", [
+        ItemsResult("list_projects"),
+        ItemsResult("list_objects"),
+        ItemsResult("shareable"),
+        ItemsResult("dependencies"),
+        ItemsResult("referenced_by"),
+        z.object({
+            action: z.literal("pre_publish_check"),
+            warnings: z
+                .array(z.string())
+                .describe("Pre-publish warnings. Empty array means no issues detected."),
+        }),
+        ItemsResult("cross_project_refs"),
+        z.object({
+            action: z.literal("graph_stats"),
+            stats: z
+                .record(z.unknown())
+                .describe("Object dependency graph statistics (counts, depth, etc.)."),
+        }),
+        z.object({
+            action: z.literal("save_graph"),
+            saved: z.literal(true).describe("Always true — confirms the graph was saved."),
+            path: z.string().describe("Filesystem path where the graph was saved."),
+        }),
+        z.object({
+            action: z.literal("load_graph"),
+            loaded: z
+                .boolean()
+                .describe("Whether the graph was successfully loaded from disk."),
+        }),
+        AnalyzeIntentResultSchema,
+        AggregateRisksResultSchema,
+        GenerateDeploymentDocResultSchema,
+        TraceSubstepsResultSchema,
+    ]).describe("Query result — shape depends on action"),
 })
     .strict();