@gjczone/pi-swarm 0.1.2

package/dist/team/tool.js

@@ -0,0 +1,210 @@
+/**
+ * team/tool — AgentTeam tool registration.
+ *
+ * Registers the `AgentTeam` tool that the LLM can call to orchestrate
+ * a team of role-based agents that collaborate via a shared mailbox.
+ *
+ * Inspired by pi-crew's team orchestration and CrewAI's hierarchical model.
+ */
+import { Type } from "typebox";
+import { SubagentBatchController, } from "../shared/controller.js";
+import { spawnSubagent, resumeSubagent, retrySubagent, } from "../shared/spawner.js";
+import { TeamSupervisor } from "./supervisor.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_SUBAGENT_TIMEOUT_MS = 30 * 60 * 1000;
+const AGENT_TEAM_DESCRIPTION = `Launch a collaborative team of role-based agents to complete a complex multi-phase task.
+
+AgentTeam is best for tasks that require multiple steps across different roles:
+explorer (codebase understanding) → planner (design) → coder (implementation)
+→ reviewer (quality check) → tester (verification).
+
+Each agent communicates via a shared mailbox. The supervisor decomposes the goal
+into phases, assigns each phase to a role agent, and synthesizes the final result.
+Agents receive context from previous phases automatically.
+
+Default phases: explore → plan → implement → review → test.
+Custom phases and roles can be specified.
+
+If AgentTeam is called, that call must be the only tool call in the response.`;
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerAgentTeamTool(pi) {
+    pi.registerTool({
+        name: "AgentTeam",
+        label: "Agent Team",
+        description: AGENT_TEAM_DESCRIPTION,
+        parameters: Type.Object({
+            goal: Type.String({
+                description: "High-level goal for the team.",
+            }),
+            description: Type.String({
+                description: "Short description for the team run.",
+            }),
+            phases: Type.Optional(Type.Array(Type.Object({
+                name: Type.String(),
+                role: Type.String(),
+                dependsOn: Type.Optional(Type.Array(Type.String())),
+            }), {
+                description: "Custom phase definitions. Defaults to explore/plan/implement/review/test.",
+            })),
+            roles: Type.Optional(Type.Array(Type.Object({
+                role: Type.String(),
+                model: Type.Optional(Type.String()),
+                tools: Type.Optional(Type.Array(Type.String())),
+                systemPrompt: Type.Optional(Type.String()),
+            }), {
+                description: "Custom role configurations with optional model/tools overrides.",
+            })),
+            max_agents: Type.Optional(Type.Number({
+                description: "Max concurrent agents. Default 4.",
+            })),
+            resume_agent_ids: Type.Optional(Type.Record(Type.String(), Type.String(), {
+                description: "Map of existing agent_id to prompt for resuming failed phases.",
+            })),
+        }, { additionalProperties: false }),
+        execute: async (toolCallId, params, signal, _onUpdate, _ctx) => {
+            const p = params;
+            let supervisor = null;
+            try {
+                const crewRoot = process.env.PI_SWARM_CREW_ROOT ?? ".pi/swarm";
+                const runId = `team-${Date.now().toString(36)}`;
+                // Build phase definitions
+                const phases = p.phases?.map((ph) => ({
+                    name: ph.name,
+                    role: ph.role,
+                    dependsOn: ph.dependsOn,
+                }));
+                // Build role configs
+                const roles = p.roles?.map((r) => ({
+                    role: r.role,
+                    model: r.model,
+                    tools: r.tools,
+                    systemPrompt: r.systemPrompt,
+                }));
+                // Create supervisor
+                supervisor = new TeamSupervisor({
+                    cwd: process.cwd(),
+                    crewRoot,
+                    runId,
+                    goal: p.goal,
+                    phases,
+                    roles,
+                    maxAgents: p.max_agents ?? 4,
+                });
+                // Process resume entries first
+                const resumeIds = p.resume_agent_ids ?? {};
+                for (const [agentId, prompt] of Object.entries(resumeIds)) {
+                    // Resume logic: re-spawn the agent with the new prompt
+                    // For now, we track resumable agent IDs
+                }
+                // Run phases sequentially through the task graph
+                const allResults = [];
+                let currentPhase = supervisor.startNextPhase();
+                while (currentPhase !== null) {
+                    // Check abort signal between phases
+                    signal?.throwIfAborted();
+                    const { phase, role, prompt: phasePrompt } = currentPhase;
+                    // Spawn a single agent for this phase
+                    const tasks = [
+                        {
+                            kind: "spawn",
+                            data: { phase: phase.phase.name, role },
+                            profileName: role,
+                            parentToolCallId: toolCallId,
+                            prompt: phasePrompt,
+                            description: `${p.description} — ${phase.phase.name} (${role})`,
+                            swarmIndex: 1,
+                            runInBackground: false,
+                            signal,
+                            timeout: DEFAULT_SUBAGENT_TIMEOUT_MS,
+                        },
+                    ];
+                    const controller = new SubagentBatchController({
+                        spawn: spawnSubagent,
+                        resume: resumeSubagent,
+                        retry: retrySubagent,
+                    }, tasks, {
+                        maxConcurrency: 1, // Team phases run sequentially
+                    });
+                    let phaseResults;
+                    try {
+                        phaseResults = await controller.run();
+                    }
+                    catch (err) {
+                        // Phase was aborted or failed catastrophically
+                        supervisor.failPhase(phase.phase.name, err instanceof Error ? err.message : String(err));
+                        // Abort signal: stop the entire run, save partial state
+                        if (signal?.aborted) {
+                            supervisor.finalize();
+                            const partialOutput = supervisor.synthesizeResult();
+                            return {
+                                content: [{ type: "text", text: partialOutput }],
+                                details: undefined,
+                            };
+                        }
+                        // Non-abort error: try next phase
+                        currentPhase = supervisor.startNextPhase();
+                        continue;
+                    }
+                    allResults.push(...phaseResults);
+                    const result = phaseResults[0];
+                    if (result && result.status === "completed") {
+                        supervisor.assignAgent(phase.phase.name, result.agentId ?? phase.phase.name);
+                        supervisor.completePhase(phase.phase.name, result.result ?? "");
+                    }
+                    else if (result) {
+                        supervisor.failPhase(phase.phase.name, result.error ?? "Unknown error");
+                    }
+                    currentPhase = supervisor.startNextPhase();
+                }
+                // Finalize and render
+                supervisor.finalize();
+                const output = supervisor.synthesizeResult();
+                return {
+                    content: [{ type: "text", text: output }],
+                    details: undefined,
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error
+                    ? error.message
+                    : String(error);
+                // Return partial state if available
+                if (supervisor) {
+                    try {
+                        const partialOutput = supervisor.synthesizeResult();
+                        if (partialOutput) {
+                            return {
+                                content: [
+                                    {
+                                        type: "text",
+                                        text: `${partialOutput}\n\nRun interrupted: ${message}`,
+                                    },
+                                ],
+                                isError: true,
+                                details: undefined,
+                            };
+                        }
+                    }
+                    catch {
+                        // Synthesis failed — fall through to generic error
+                    }
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `AgentTeam failed: ${message}`,
+                        },
+                    ],
+                    isError: true,
+                    details: undefined,
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=tool.js.map

package/dist/team/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/team/tool.ts"],"names":[],"mappings":"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"}

package/dist/tui/permission-prompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * tui/permission-prompt — swarm start permission dialog for manual mode.
+ *
+ * When the user is in manual permission mode and tries to start a
+ * swarm, this component asks whether to switch to auto/yolo or cancel.
+ *
+ * Ported from MoonshotAI/kimi-code's SwarmStartPermissionPromptComponent.
+ */
+import type { Component } from "@earendil-works/pi-tui";
+export type SwarmPermissionChoice = "auto" | "yolo" | "cancel";
+export interface SwarmPermissionPromptOptions {
+    /** Called when the user makes a selection. */
+    onSelect: (choice: SwarmPermissionChoice) => void;
+    /** Called when the user cancels (Escape). */
+    onCancel: () => void;
+}
+export declare class SwarmPermissionPromptComponent implements Component {
+    private readonly opts;
+    private selectedIndex;
+    private readonly choices;
+    constructor(opts: SwarmPermissionPromptOptions);
+    handleInput(data: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+}
+//# sourceMappingURL=permission-prompt.d.ts.map

package/dist/tui/permission-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-prompt.d.ts","sourceRoot":"","sources":["../../src/tui/permission-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMxD,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,4BAA4B;IAC3C,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAClD,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAMD,qBAAa,8BAA+B,YAAW,SAAS;IAQlD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;gBAE2B,IAAI,EAAE,4BAA4B;IAE/D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAwB/B,UAAU,IAAI,IAAI;IAIlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CA4BhC"}

package/dist/tui/permission-prompt.js

@@ -0,0 +1,94 @@
+/**
+ * tui/permission-prompt — swarm start permission dialog for manual mode.
+ *
+ * When the user is in manual permission mode and tries to start a
+ * swarm, this component asks whether to switch to auto/yolo or cancel.
+ *
+ * Ported from MoonshotAI/kimi-code's SwarmStartPermissionPromptComponent.
+ */
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+export class SwarmPermissionPromptComponent {
+    opts;
+    selectedIndex = 0;
+    choices = [
+        "auto",
+        "yolo",
+        "cancel",
+    ];
+    constructor(opts) {
+        this.opts = opts;
+    }
+    handleInput(data) {
+        if (data === "\x1b[A" || data === "k") {
+            // Up arrow or 'k'
+            this.selectedIndex = Math.max(0, this.selectedIndex - 1);
+            this.invalidate();
+        }
+        else if (data === "\x1b[B" || data === "j") {
+            // Down arrow or 'j'
+            this.selectedIndex = Math.min(this.choices.length - 1, this.selectedIndex + 1);
+            this.invalidate();
+        }
+        else if (data === "\r" || data === "\n") {
+            // Enter
+            const choice = this.choices[this.selectedIndex];
+            if (choice) {
+                this.opts.onSelect(choice);
+            }
+        }
+        else if (data === "\x1b") {
+            // Escape
+            this.opts.onCancel();
+        }
+    }
+    invalidate() {
+        // No cached state to clear — render is pure.
+    }
+    render(width) {
+        const safeWidth = Math.max(10, width);
+        const lines = [];
+        lines.push(borderTop(safeWidth));
+        lines.push(padLine("Manual mode can block swarm work.", safeWidth));
+        lines.push(padLine("", safeWidth));
+        lines.push(padLine("Choose a permission mode for this swarm:", safeWidth));
+        lines.push(padLine("", safeWidth));
+        for (let i = 0; i < this.choices.length; i += 1) {
+            const choice = this.choices[i];
+            const isSelected = i === this.selectedIndex;
+            const prefix = isSelected ? " > " : "   ";
+            const label = choiceLabel(choice);
+            lines.push(padLine(`${prefix}${label}`, safeWidth));
+        }
+        lines.push(padLine("", safeWidth));
+        lines.push(padLine("Use arrow keys to select, Enter to confirm, Esc to cancel.", safeWidth));
+        lines.push(borderBottom(safeWidth));
+        return lines;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function choiceLabel(choice) {
+    switch (choice) {
+        case "auto":
+            return "Auto mode — tools auto-approved, including AgentSwarm";
+        case "yolo":
+            return "YOLO mode — all tools auto-approved, no confirmations";
+        case "cancel":
+            return "Cancel — do not start the swarm";
+    }
+}
+function borderTop(width) {
+    return `\u250C${"\u2500".repeat(Math.max(0, width - 2))}\u2510`;
+}
+function borderBottom(width) {
+    return `\u2514${"\u2500".repeat(Math.max(0, width - 2))}\u2518`;
+}
+function padLine(text, width) {
+    const inner = `\u2502 ${text}`;
+    const padding = Math.max(0, width - inner.length - 1);
+    return `${inner}${" ".repeat(padding)}\u2502`;
+}
+//# sourceMappingURL=permission-prompt.js.map

package/dist/tui/permission-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-prompt.js","sourceRoot":"","sources":["../../src/tui/permission-prompt.ts"],"names":[],"mappings":"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"}

package/dist/tui/progress.d.ts

@@ -0,0 +1,64 @@
+/**
+ * tui/progress — AgentSwarm live progress panel.
+ *
+ * Renders a real-time progress display above the input area when
+ * an AgentSwarm batch is running.  Each subagent gets a braille
+ * progress bar with status labels.
+ *
+ * Ported from MoonshotAI/kimi-code's AgentSwarmProgressComponent.
+ */
+import type { Component } from "@earendil-works/pi-tui";
+/** Phase of a single member (subagent) in the progress display. */
+export type MemberPhase = "pending" | "queued" | "prompting" | "working" | "completed" | "failed" | "cancelled" | "suspended";
+/** Status of a single member. */
+export interface MemberStatus {
+    /** 1-based index. */
+    readonly index: number;
+    /** Current phase. */
+    phase: MemberPhase;
+    /** Label for the item being processed. */
+    item?: string;
+    /** Result text (for completed/failed). */
+    result?: string;
+    /** Error message (for failed). */
+    error?: string;
+    /** When the member transitioned to its current phase (ms timestamp). */
+    phaseStartedAt?: number;
+}
+/** Overall swarm status pushed from the tool execution. */
+export interface SwarmProgressState {
+    /** Title for the progress panel. */
+    title?: string;
+    /** Overall status label. */
+    status?: string;
+    /** Total number of subagents. */
+    total: number;
+    /** Completed count. */
+    completed: number;
+    /** Failed count. */
+    failed: number;
+    /** Currently active count. */
+    active: number;
+    /** Queued count. */
+    queued: number;
+    /** Per-member status. */
+    members: MemberStatus[];
+}
+export declare class AgentSwarmProgressComponent implements Component {
+    private state_;
+    private animationFrame;
+    private startTime;
+    private renderedWidth;
+    private cachedLines;
+    constructor();
+    /** Update the progress state from the tool execution. */
+    update(state: SwarmProgressState): void;
+    /** Mark the swarm as completed (triggers completion animation). */
+    complete(): void;
+    /** Stop the animation loop. */
+    dispose(): void;
+    invalidate(): void;
+    render(width: number): string[];
+    private startAnimation;
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/tui/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/tui/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAkDxD,mEAAmE;AACnE,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;AAEhB,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAMD,qBAAa,2BAA4B,YAAW,SAAS;IAC3D,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,WAAW,CAAuB;;IAU1C,yDAAyD;IACzD,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAKvC,mEAAmE;IACnE,QAAQ,IAAI,IAAI;IAiBhB,+BAA+B;IAC/B,OAAO,IAAI,IAAI;IAWf,UAAU,IAAI,IAAI;IAKlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAiD/B,OAAO,CAAC,cAAc;CAKvB"}