opencode-swarm-plugin 0.22.0 → 0.23.1

package/dist/swarm-orchestrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-orchestrate.d.ts","sourceRoot":"","sources":["../src/swarm-orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgiBxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;CAuGrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAoFvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAoIzB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CA6E1B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ezB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJ/B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;CA6CjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;CAmClC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAmB9B,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;CAoJ9B,CAAC;AA4BH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyH3B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;CAgGxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgMtB,CAAC;AAMH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAc5B,CAAC"}

package/dist/swarm-prompts.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Swarm Prompts Module - Prompt templates and generation
+ *
+ * Provides all prompt templates used for swarm coordination:
+ * - Decomposition prompts (basic and strategy-specific)
+ * - Subtask agent prompts (V1 and V2)
+ * - Evaluation prompts
+ *
+ * Key responsibilities:
+ * - Prompt template definitions
+ * - Prompt formatting/generation tools
+ * - Template parameter substitution
+ */
+/**
+ * Prompt for decomposing a task into parallelizable subtasks.
+ *
+ * Used by swarm_decompose to instruct the agent on how to break down work.
+ * The agent responds with a BeadTree that gets validated.
+ */
+export declare const DECOMPOSITION_PROMPT = "You are decomposing a task into parallelizable subtasks for a swarm of agents.\n\n## Task\n{task}\n\n{context_section}\n\n## MANDATORY: Beads Issue Tracking\n\n**Every subtask MUST become a bead.** This is non-negotiable.\n\nAfter decomposition, the coordinator will:\n1. Create an epic bead for the overall task\n2. Create child beads for each subtask\n3. Track progress through bead status updates\n4. Close beads with summaries when complete\n\nAgents MUST update their bead status as they work. No silent progress.\n\n## Requirements\n\n1. **Break into 2-{max_subtasks} independent subtasks** that can run in parallel\n2. **Assign files** - each subtask must specify which files it will modify\n3. **No file overlap** - files cannot appear in multiple subtasks (they get exclusive locks)\n4. **Order by dependency** - if subtask B needs subtask A's output, A must come first in the array\n5. **Estimate complexity** - 1 (trivial) to 5 (complex)\n6. **Plan aggressively** - break down more than you think necessary, smaller is better\n\n## Response Format\n\nRespond with a JSON object matching this schema:\n\n```typescript\n{\n  epic: {\n    title: string,        // Epic title for the beads tracker\n    description?: string  // Brief description of the overall goal\n  },\n  subtasks: [\n    {\n      title: string,              // What this subtask accomplishes\n      description?: string,       // Detailed instructions for the agent\n      files: string[],            // Files this subtask will modify (globs allowed)\n      dependencies: number[],     // Indices of subtasks this depends on (0-indexed)\n      estimated_complexity: 1-5   // Effort estimate\n    },\n    // ... more subtasks\n  ]\n}\n```\n\n## Guidelines\n\n- **Plan aggressively** - when in doubt, split further. 3 small tasks > 1 medium task\n- **Prefer smaller, focused subtasks** over large complex ones\n- **Include test files** in the same subtask as the code they test\n- **Consider shared types** - if multiple files share types, handle that first\n- **Think about imports** - changes to exported APIs affect downstream files\n- **Explicit > implicit** - spell out what each subtask should do, don't assume\n\n## File Assignment Examples\n\n- Schema change: `[\"src/schemas/user.ts\", \"src/schemas/index.ts\"]`\n- Component + test: `[\"src/components/Button.tsx\", \"src/components/Button.test.tsx\"]`\n- API route: `[\"src/app/api/users/route.ts\"]`\n\nNow decompose the task:";
+/**
+ * Strategy-specific decomposition prompt template
+ */
+export declare const STRATEGY_DECOMPOSITION_PROMPT = "You are decomposing a task into parallelizable subtasks for a swarm of agents.\n\n## Task\n{task}\n\n{strategy_guidelines}\n\n{context_section}\n\n{cass_history}\n\n{skills_context}\n\n## MANDATORY: Beads Issue Tracking\n\n**Every subtask MUST become a bead.** This is non-negotiable.\n\nAfter decomposition, the coordinator will:\n1. Create an epic bead for the overall task\n2. Create child beads for each subtask\n3. Track progress through bead status updates\n4. Close beads with summaries when complete\n\nAgents MUST update their bead status as they work. No silent progress.\n\n## Requirements\n\n1. **Break into 2-{max_subtasks} independent subtasks** that can run in parallel\n2. **Assign files** - each subtask must specify which files it will modify\n3. **No file overlap** - files cannot appear in multiple subtasks (they get exclusive locks)\n4. **Order by dependency** - if subtask B needs subtask A's output, A must come first in the array\n5. **Estimate complexity** - 1 (trivial) to 5 (complex)\n6. **Plan aggressively** - break down more than you think necessary, smaller is better\n\n## Response Format\n\nRespond with a JSON object matching this schema:\n\n```typescript\n{\n  epic: {\n    title: string,        // Epic title for the beads tracker\n    description?: string  // Brief description of the overall goal\n  },\n  subtasks: [\n    {\n      title: string,              // What this subtask accomplishes\n      description?: string,       // Detailed instructions for the agent\n      files: string[],            // Files this subtask will modify (globs allowed)\n      dependencies: number[],     // Indices of subtasks this depends on (0-indexed)\n      estimated_complexity: 1-5   // Effort estimate\n    },\n    // ... more subtasks\n  ]\n}\n```\n\nNow decompose the task:";
+/**
+ * Prompt template for spawned subtask agents.
+ *
+ * Each agent receives this prompt with their specific subtask details filled in.
+ * The prompt establishes context, constraints, and expectations.
+ */
+export declare const SUBTASK_PROMPT = "You are a swarm agent working on a subtask of a larger epic.\n\n## Your Identity\n- **Agent Name**: {agent_name}\n- **Bead ID**: {bead_id}\n- **Epic ID**: {epic_id}\n\n## Your Subtask\n**Title**: {subtask_title}\n\n{subtask_description}\n\n## File Scope\nYou have exclusive reservations for these files:\n{file_list}\n\n**CRITICAL**: Only modify files in your reservation. If you need to modify other files, \nsend a message to the coordinator requesting the change.\n\n## Shared Context\n{shared_context}\n\n## MANDATORY: Beads Tracking\n\nYou MUST keep your bead updated as you work:\n\n1. **Your bead is already in_progress** - don't change this unless blocked\n2. **If blocked**: `bd update {bead_id} --status blocked` and message coordinator\n3. **When done**: Use `swarm_complete` - it closes your bead automatically\n4. **Discovered issues**: Create new beads with `bd create \"issue\" -t bug`\n\n**Never work silently.** Your bead status is how the swarm tracks progress.\n\n## MANDATORY: Swarm Mail Communication\n\nYou MUST communicate with other agents:\n\n1. **Report progress** every significant milestone (not just at the end)\n2. **Ask questions** if requirements are unclear - don't guess\n3. **Announce blockers** immediately - don't spin trying to fix alone\n4. **Coordinate on shared concerns** - if you see something affecting other agents, say so\n\nUse Swarm Mail for all communication:\n```\nswarmmail_send(\n  to: [\"coordinator\" or specific agent],\n  subject: \"Brief subject\",\n  body: \"Message content\",\n  thread_id: \"{epic_id}\"\n)\n```\n\n## Coordination Protocol\n\n1. **Start**: Your bead is already marked in_progress\n2. **Progress**: Use swarm_progress to report status updates\n3. **Blocked**: Report immediately via Swarm Mail - don't spin\n4. **Complete**: Use swarm_complete when done - it handles:\n   - Closing your bead with a summary\n   - Releasing file reservations\n   - Notifying the coordinator\n\n## Self-Evaluation\n\nBefore calling swarm_complete, evaluate your work:\n- Type safety: Does it compile without errors?\n- No obvious bugs: Did you handle edge cases?\n- Follows patterns: Does it match existing code style?\n- Readable: Would another developer understand it?\n\nIf evaluation fails, fix the issues before completing.\n\n## Planning Your Work\n\nBefore writing code:\n1. **Read the files** you're assigned to understand current state\n2. **Plan your approach** - what changes, in what order?\n3. **Identify risks** - what could go wrong? What dependencies?\n4. **Communicate your plan** via Swarm Mail if non-trivial\n\nBegin work on your subtask now.";
+/**
+ * Streamlined subtask prompt (V2) - uses Swarm Mail and beads
+ *
+ * This is a cleaner version of SUBTASK_PROMPT that's easier to parse.
+ * Agents MUST use Swarm Mail for communication and beads for tracking.
+ *
+ * Supports {error_context} placeholder for retry prompts.
+ */
+export declare const SUBTASK_PROMPT_V2 = "You are a swarm agent working on: **{subtask_title}**\n\n## [IDENTITY]\nAgent: (assigned at spawn)\nBead: {bead_id}\nEpic: {epic_id}\n\n## [TASK]\n{subtask_description}\n\n## [FILES]\nReserved (exclusive):\n{file_list}\n\nOnly modify these files. Need others? Message the coordinator.\n\n## [CONTEXT]\n{shared_context}\n\n{compressed_context}\n\n{error_context}\n\n## [MANDATORY: SWARM MAIL INITIALIZATION]\n\n**CRITICAL: YOU MUST INITIALIZE SWARM MAIL BEFORE DOING ANY WORK.**\n\nThis is your FIRST step - before reading files, before planning, before ANY other action.\n\n### Step 1: Initialize (REQUIRED - DO THIS FIRST)\n```\nswarmmail_init(project_path=\"{project_path}\", task_description=\"{bead_id}: {subtask_title}\")\n```\n\n**This registers you with the coordination system and enables:**\n- File reservation tracking\n- Inter-agent communication\n- Progress monitoring\n- Conflict detection\n\n**If you skip this step, your work will not be tracked and swarm_complete will fail.**\n\n## [SWARM MAIL USAGE]\n\nAfter initialization, use Swarm Mail for coordination:\n\n### Check Inbox Regularly\n```\nswarmmail_inbox()  # Check for coordinator messages\nswarmmail_read_message(message_id=N)  # Read specific message\n```\n\n### Report Progress (REQUIRED - don't work silently)\n```\nswarmmail_send(\n  to=[\"coordinator\"],\n  subject=\"Progress: {bead_id}\",\n  body=\"<what you did, blockers, questions>\",\n  thread_id=\"{epic_id}\"\n)\n```\n\n### When Blocked\n```\nswarmmail_send(\n  to=[\"coordinator\"],\n  subject=\"BLOCKED: {bead_id}\",\n  body=\"<blocker description, what you need>\",\n  importance=\"high\",\n  thread_id=\"{epic_id}\"\n)\nbeads_update(id=\"{bead_id}\", status=\"blocked\")\n```\n\n### Release Files When Done\n```\nswarmmail_release()  # Or let swarm_complete handle it\n```\n\n## [OTHER TOOLS]\n### Beads\n- beads_update(id, status) - Mark blocked if stuck\n- beads_create(title, type) - Log new bugs found\n\n### Skills (if available)\n- skills_list() - Discover available skills\n- skills_use(name) - Activate skill for specialized guidance\n\n### Completion (REQUIRED)\n- swarm_complete(project_key, agent_name, bead_id, summary, files_touched)\n\n## [LEARNING]\nAs you work, note reusable patterns, best practices, or domain insights:\n- If you discover something that would help future agents, consider creating a skill\n- Use skills_create to codify patterns for the project\n- Good skills have clear \"when to use\" descriptions with actionable instructions\n- Skills make swarms smarter over time\n\n## [WORKFLOW]\n1. **swarmmail_init** - Initialize session (MANDATORY FIRST STEP)\n2. Read assigned files\n3. Implement changes\n4. **swarmmail_send** - Report progress to coordinator\n5. Verify (typecheck)\n6. **swarm_complete** - Mark done, release reservations\n\n**CRITICAL REQUIREMENTS:**\n- Step 1 (swarmmail_init) is NON-NEGOTIABLE - do it before anything else\n- Never work silently - send progress updates via swarmmail_send every significant milestone\n- If you complete without initializing, swarm_complete will detect this and warn/fail\n\nBegin now.";
+/**
+ * Prompt for self-evaluation before completing a subtask.
+ *
+ * Agents use this to assess their work quality before marking complete.
+ */
+export declare const EVALUATION_PROMPT = "Evaluate the work completed for this subtask.\n\n## Subtask\n**Bead ID**: {bead_id}\n**Title**: {subtask_title}\n\n## Files Modified\n{files_touched}\n\n## Evaluation Criteria\n\nFor each criterion, assess passed/failed and provide brief feedback:\n\n1. **type_safe**: Code compiles without TypeScript errors\n2. **no_bugs**: No obvious bugs, edge cases handled\n3. **patterns**: Follows existing codebase patterns and conventions\n4. **readable**: Code is clear and maintainable\n\n## Response Format\n\n```json\n{\n  \"passed\": boolean,        // Overall pass/fail\n  \"criteria\": {\n    \"type_safe\": { \"passed\": boolean, \"feedback\": string },\n    \"no_bugs\": { \"passed\": boolean, \"feedback\": string },\n    \"patterns\": { \"passed\": boolean, \"feedback\": string },\n    \"readable\": { \"passed\": boolean, \"feedback\": string }\n  },\n  \"overall_feedback\": string,\n  \"retry_suggestion\": string | null  // If failed, what to fix\n}\n```\n\nIf any criterion fails, the overall evaluation fails and retry_suggestion \nshould describe what needs to be fixed.";
+/**
+ * Format the V2 subtask prompt for a specific agent
+ */
+export declare function formatSubtaskPromptV2(params: {
+    bead_id: string;
+    epic_id: string;
+    subtask_title: string;
+    subtask_description: string;
+    files: string[];
+    shared_context?: string;
+    compressed_context?: string;
+    error_context?: string;
+    project_path?: string;
+    recovery_context?: {
+        shared_context?: string;
+        skills_to_load?: string[];
+        coordinator_notes?: string;
+    };
+}): string;
+/**
+ * Format the subtask prompt for a specific agent
+ */
+export declare function formatSubtaskPrompt(params: {
+    agent_name: string;
+    bead_id: string;
+    epic_id: string;
+    subtask_title: string;
+    subtask_description: string;
+    files: string[];
+    shared_context?: string;
+}): string;
+/**
+ * Format the evaluation prompt
+ */
+export declare function formatEvaluationPrompt(params: {
+    bead_id: string;
+    subtask_title: string;
+    files_touched: string[];
+}): string;
+/**
+ * Generate subtask prompt for a spawned agent
+ */
+export declare const swarm_subtask_prompt: {
+    description: string;
+    args: {
+        agent_name: import("zod").ZodString;
+        bead_id: import("zod").ZodString;
+        epic_id: import("zod").ZodString;
+        subtask_title: import("zod").ZodString;
+        subtask_description: import("zod").ZodOptional<import("zod").ZodString>;
+        files: import("zod").ZodArray<import("zod").ZodString>;
+        shared_context: import("zod").ZodOptional<import("zod").ZodString>;
+        project_path: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        agent_name: string;
+        bead_id: string;
+        epic_id: string;
+        subtask_title: string;
+        files: string[];
+        subtask_description?: string | undefined;
+        shared_context?: string | undefined;
+        project_path?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Prepare a subtask for spawning with Task tool (V2 prompt)
+ *
+ * Generates a streamlined prompt that tells agents to USE Agent Mail and beads.
+ * Returns JSON that can be directly used with Task tool.
+ */
+export declare const swarm_spawn_subtask: {
+    description: string;
+    args: {
+        bead_id: import("zod").ZodString;
+        epic_id: import("zod").ZodString;
+        subtask_title: import("zod").ZodString;
+        subtask_description: import("zod").ZodOptional<import("zod").ZodString>;
+        files: import("zod").ZodArray<import("zod").ZodString>;
+        shared_context: import("zod").ZodOptional<import("zod").ZodString>;
+        project_path: import("zod").ZodOptional<import("zod").ZodString>;
+        recovery_context: import("zod").ZodOptional<import("zod").ZodObject<{
+            shared_context: import("zod").ZodOptional<import("zod").ZodString>;
+            skills_to_load: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            coordinator_notes: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    };
+    execute(args: {
+        bead_id: string;
+        epic_id: string;
+        subtask_title: string;
+        files: string[];
+        subtask_description?: string | undefined;
+        shared_context?: string | undefined;
+        project_path?: string | undefined;
+        recovery_context?: {
+            shared_context?: string | undefined;
+            skills_to_load?: string[] | undefined;
+            coordinator_notes?: string | undefined;
+        } | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Generate self-evaluation prompt
+ */
+export declare const swarm_evaluation_prompt: {
+    description: string;
+    args: {
+        bead_id: import("zod").ZodString;
+        subtask_title: import("zod").ZodString;
+        files_touched: import("zod").ZodArray<import("zod").ZodString>;
+    };
+    execute(args: {
+        bead_id: string;
+        subtask_title: string;
+        files_touched: string[];
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Generate a strategy-specific planning prompt
+ *
+ * Higher-level than swarm_decompose - includes strategy selection and guidelines.
+ * Use this when you want the full planning experience with strategy-specific advice.
+ */
+export declare const swarm_plan_prompt: {
+    description: string;
+    args: {
+        task: import("zod").ZodString;
+        strategy: import("zod").ZodOptional<import("zod").ZodEnum<{
+            "file-based": "file-based";
+            "feature-based": "feature-based";
+            "risk-based": "risk-based";
+            auto: "auto";
+        }>>;
+        max_subtasks: import("zod").ZodDefault<import("zod").ZodNumber>;
+        context: import("zod").ZodOptional<import("zod").ZodString>;
+        query_cass: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        cass_limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+        include_skills: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    execute(args: {
+        task: string;
+        max_subtasks: number;
+        strategy?: "file-based" | "feature-based" | "risk-based" | "auto" | undefined;
+        context?: string | undefined;
+        query_cass?: boolean | undefined;
+        cass_limit?: number | undefined;
+        include_skills?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const promptTools: {
+    swarm_subtask_prompt: {
+        description: string;
+        args: {
+            agent_name: import("zod").ZodString;
+            bead_id: import("zod").ZodString;
+            epic_id: import("zod").ZodString;
+            subtask_title: import("zod").ZodString;
+            subtask_description: import("zod").ZodOptional<import("zod").ZodString>;
+            files: import("zod").ZodArray<import("zod").ZodString>;
+            shared_context: import("zod").ZodOptional<import("zod").ZodString>;
+            project_path: import("zod").ZodOptional<import("zod").ZodString>;
+        };
+        execute(args: {
+            agent_name: string;
+            bead_id: string;
+            epic_id: string;
+            subtask_title: string;
+            files: string[];
+            subtask_description?: string | undefined;
+            shared_context?: string | undefined;
+            project_path?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    swarm_spawn_subtask: {
+        description: string;
+        args: {
+            bead_id: import("zod").ZodString;
+            epic_id: import("zod").ZodString;
+            subtask_title: import("zod").ZodString;
+            subtask_description: import("zod").ZodOptional<import("zod").ZodString>;
+            files: import("zod").ZodArray<import("zod").ZodString>;
+            shared_context: import("zod").ZodOptional<import("zod").ZodString>;
+            project_path: import("zod").ZodOptional<import("zod").ZodString>;
+            recovery_context: import("zod").ZodOptional<import("zod").ZodObject<{
+                shared_context: import("zod").ZodOptional<import("zod").ZodString>;
+                skills_to_load: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                coordinator_notes: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        };
+        execute(args: {
+            bead_id: string;
+            epic_id: string;
+            subtask_title: string;
+            files: string[];
+            subtask_description?: string | undefined;
+            shared_context?: string | undefined;
+            project_path?: string | undefined;
+            recovery_context?: {
+                shared_context?: string | undefined;
+                skills_to_load?: string[] | undefined;
+                coordinator_notes?: string | undefined;
+            } | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    swarm_evaluation_prompt: {
+        description: string;
+        args: {
+            bead_id: import("zod").ZodString;
+            subtask_title: import("zod").ZodString;
+            files_touched: import("zod").ZodArray<import("zod").ZodString>;
+        };
+        execute(args: {
+            bead_id: string;
+            subtask_title: string;
+            files_touched: string[];
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    swarm_plan_prompt: {
+        description: string;
+        args: {
+            task: import("zod").ZodString;
+            strategy: import("zod").ZodOptional<import("zod").ZodEnum<{
+                "file-based": "file-based";
+                "feature-based": "feature-based";
+                "risk-based": "risk-based";
+                auto: "auto";
+            }>>;
+            max_subtasks: import("zod").ZodDefault<import("zod").ZodNumber>;
+            context: import("zod").ZodOptional<import("zod").ZodString>;
+            query_cass: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            cass_limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+            include_skills: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        };
+        execute(args: {
+            task: string;
+            max_subtasks: number;
+            strategy?: "file-based" | "feature-based" | "risk-based" | "auto" | undefined;
+            context?: string | undefined;
+            query_cass?: boolean | undefined;
+            cass_limit?: number | undefined;
+            include_skills?: boolean | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=swarm-prompts.d.ts.map

package/dist/swarm-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-prompts.d.ts","sourceRoot":"","sources":["../src/swarm-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,q6EAkET,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,6BAA6B,kxDAyDlB,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,gkFAgFK,CAAC;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,0iGA+GnB,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,8jCAmCU,CAAC;AAMzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,GAAG,MAAM,CAuDT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAUT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,MAAM,CAMT;AAMD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CAoC/B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0D9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;CAoClC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CA0I5B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKvB,CAAC"}

package/dist/swarm-strategies.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Swarm Strategies Module - Strategy selection and guidelines
+ *
+ * Handles decomposition strategy selection (file-based, feature-based, risk-based, research-based)
+ * and provides strategy-specific guidelines for task decomposition.
+ *
+ * Key responsibilities:
+ * - Strategy keyword matching and selection
+ * - Strategy definition and description
+ * - Anti-pattern warnings
+ * - Guidelines formatting for prompts
+ */
+import { z } from "zod";
+/**
+ * Decomposition strategy types
+ */
+export type DecompositionStrategy = "file-based" | "feature-based" | "risk-based" | "research-based" | "auto";
+/**
+ * Zod schema for decomposition strategy validation
+ */
+export declare const DecompositionStrategySchema: z.ZodEnum<{
+    "file-based": "file-based";
+    "feature-based": "feature-based";
+    "risk-based": "risk-based";
+    auto: "auto";
+    "research-based": "research-based";
+}>;
+/**
+ * Marker words that indicate positive directives
+ */
+export declare const POSITIVE_MARKERS: string[];
+/**
+ * Marker words that indicate negative directives
+ */
+export declare const NEGATIVE_MARKERS: string[];
+/**
+ * Strategy definition with keywords, guidelines, and anti-patterns
+ */
+export interface StrategyDefinition {
+    name: DecompositionStrategy;
+    description: string;
+    keywords: string[];
+    guidelines: string[];
+    antiPatterns: string[];
+    examples: string[];
+}
+/**
+ * Strategy definitions for task decomposition
+ */
+export declare const STRATEGIES: Record<Exclude<DecompositionStrategy, "auto">, StrategyDefinition>;
+/**
+ * Analyze task description and select best decomposition strategy
+ *
+ * @param task - Task description
+ * @returns Selected strategy with reasoning
+ */
+export declare function selectStrategy(task: string): {
+    strategy: Exclude<DecompositionStrategy, "auto">;
+    confidence: number;
+    reasoning: string;
+    alternatives: Array<{
+        strategy: Exclude<DecompositionStrategy, "auto">;
+        score: number;
+    }>;
+};
+/**
+ * Format strategy-specific guidelines for the decomposition prompt
+ */
+export declare function formatStrategyGuidelines(strategy: Exclude<DecompositionStrategy, "auto">): string;
+/**
+ * Select the best decomposition strategy for a task
+ *
+ * Analyzes task description and recommends a strategy with reasoning.
+ * Use this before swarm_plan_prompt to understand the recommended approach.
+ */
+export declare const swarm_select_strategy: {
+    description: string;
+    args: {
+        task: z.ZodString;
+        codebase_context: z.ZodOptional<z.ZodString>;
+    };
+    execute(args: {
+        task: string;
+        codebase_context?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const strategyTools: {
+    swarm_select_strategy: {
+        description: string;
+        args: {
+            task: z.ZodString;
+            codebase_context: z.ZodOptional<z.ZodString>;
+        };
+        execute(args: {
+            task: string;
+            codebase_context?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=swarm-strategies.d.ts.map

package/dist/swarm-strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-strategies.d.ts","sourceRoot":"","sources":["../src/swarm-strategies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,MAAM,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;EAMtC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAO5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAQ5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,EACtC,kBAAkB,CAgKnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAC5C,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QACjD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ,CAoEA;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAC/C,MAAM,CAmBR;AAMD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;CAqChC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;CAEzB,CAAC"}