@gjczone/pi-swarm 0.1.2

package/dist/swarm/tool.js

@@ -0,0 +1,190 @@
+/**
+ * swarm/tool — AgentSwarm tool registration.
+ *
+ * Registers the `AgentSwarm` tool that the LLM can call to launch
+ * multiple subagents from a shared prompt template.
+ *
+ * Ported from MoonshotAI/kimi-code's AgentSwarmTool.
+ */
+import { Type } from "typebox";
+import { SubagentBatchController, resolveSwarmMaxConcurrency, } from "../shared/controller.js";
+import { renderSwarmResults, toSwarmRunResults } from "../shared/render.js";
+import { spawnSubagent, resumeSubagent, retrySubagent, } from "../shared/spawner.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_SUBAGENT_TYPE = "coder";
+const PROMPT_TEMPLATE_PLACEHOLDER = "{{item}}";
+const MAX_AGENT_SWARM_SUBAGENTS = 128;
+const DEFAULT_SUBAGENT_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+const AGENT_SWARM_DESCRIPTION = `Launch multiple subagents from one prompt template, existing agent resumes, or both.
+
+Use AgentSwarm when many subagents should run the same kind of task over different inputs. The placeholder is exactly \`{{item}}\`. For example, with \`prompt_template\` set to \`Review {{item}} for likely regressions.\` and \`items\` set to \`["src/a.ts", "src/b.ts"]\`, AgentSwarm launches two new subagents with those two concrete prompts.
+
+Use \`resume_agent_ids\` to continue subagents that already exist from earlier work, such as ones that failed or timed out: map each agent id to the prompt for that resumed subagent (usually \`continue\` if no extra information is needed). You may combine \`resume_agent_ids\` with \`items\` in the same call to resume existing subagents and launch new ones. Do not duplicate resumed work in \`items\`.
+
+Use enough subagents to keep the work focused and parallel. AgentSwarm supports up to 128 subagents, and launches are queued automatically, so it is safe to split large tasks into many clear, independent items.
+
+If \`AgentSwarm\` is called, that call must be the only tool call in the response.`;
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerAgentSwarmTool(pi) {
+    pi.registerTool({
+        name: "AgentSwarm",
+        label: "Agent Swarm",
+        description: AGENT_SWARM_DESCRIPTION,
+        parameters: Type.Object({
+            description: Type.String({
+                description: "Short description for the whole swarm.",
+            }),
+            subagent_type: Type.Optional(Type.String({
+                description: "Subagent type used for every spawned subagent. Defaults to coder when omitted.",
+            })),
+            prompt_template: Type.Optional(Type.String({
+                description: `Prompt template for each subagent. The ${PROMPT_TEMPLATE_PLACEHOLDER} placeholder is replaced with each item value.`,
+            })),
+            items: Type.Optional(Type.Array(Type.String(), {
+                maxItems: MAX_AGENT_SWARM_SUBAGENTS,
+                description: "Values used to fill the {{item}} placeholder. Each item launches one new subagent.",
+            })),
+            resume_agent_ids: Type.Optional(Type.Record(Type.String(), Type.String(), {
+                description: "Map of existing subagent agent_id to the prompt used to resume that subagent. Resumed subagents launch before new item-based subagents.",
+            })),
+        }, { additionalProperties: false }),
+        execute: async (toolCallId, params, signal, _onUpdate, _ctx) => {
+            const { description, subagent_type, prompt_template, items, resume_agent_ids } = params;
+            try {
+                const profileName = normalizeOptionalString(subagent_type) ??
+                    DEFAULT_SUBAGENT_TYPE;
+                // Build specs
+                const specs = createAgentSwarmSpecs({
+                    items,
+                    resume_agent_ids,
+                    prompt_template,
+                });
+                // Convert to queued tasks
+                const tasks = specs.map((spec) => {
+                    const descriptionName = spec.kind === "resume" ? "resume" : profileName;
+                    const common = {
+                        data: spec,
+                        profileName: spec.kind === "resume" ? "subagent" : profileName,
+                        parentToolCallId: toolCallId,
+                        prompt: spec.prompt,
+                        description: childDescription(description, spec.index, descriptionName),
+                        swarmIndex: spec.index,
+                        runInBackground: false,
+                        swarmItem: spec.item,
+                        signal,
+                        timeout: DEFAULT_SUBAGENT_TIMEOUT_MS,
+                    };
+                    if (spec.kind === "resume") {
+                        return {
+                            ...common,
+                            kind: "resume",
+                            resumeAgentId: spec.agentId,
+                        };
+                    }
+                    return {
+                        ...common,
+                        kind: "spawn",
+                    };
+                });
+                // Run with controller
+                const maxConcurrency = resolveSwarmMaxConcurrency(process.cwd());
+                const controller = new SubagentBatchController({ spawn: spawnSubagent, resume: resumeSubagent, retry: retrySubagent }, tasks, { maxConcurrency });
+                const results = await controller.run();
+                // Render output
+                const swarmResults = toSwarmRunResults(results);
+                const output = renderSwarmResults(swarmResults);
+                return {
+                    content: [{ type: "text", text: output }],
+                    details: undefined,
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [{ type: "text", text: `AgentSwarm failed: ${message}` }],
+                    isError: true,
+                    details: undefined,
+                };
+            }
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Spec creation (from kimi-code)
+// ---------------------------------------------------------------------------
+function createAgentSwarmSpecs(args) {
+    const resumeEntries = Object.entries(args.resume_agent_ids ?? {}).map(([agentId, prompt]) => ({
+        agentId: agentId.trim(),
+        prompt: prompt.trim(),
+    }));
+    const items = (args.items ?? []).map((item) => item.trim());
+    const itemCount = items.length;
+    const resumeCount = resumeEntries.length;
+    const totalCount = resumeCount + itemCount;
+    if (!hasMinimumAgentSwarmInputs(itemCount, resumeCount)) {
+        throw new Error("AgentSwarm requires at least 2 items unless resume_agent_ids is provided.");
+    }
+    if (totalCount > MAX_AGENT_SWARM_SUBAGENTS) {
+        throw new Error(`AgentSwarm supports at most ${String(MAX_AGENT_SWARM_SUBAGENTS)} subagents.`);
+    }
+    const promptTemplate = normalizeOptionalString(args.prompt_template);
+    if (items.length > 0 && promptTemplate === undefined) {
+        throw new Error("prompt_template is required when items are provided.");
+    }
+    if (promptTemplate !== undefined &&
+        !promptTemplate.includes(PROMPT_TEMPLATE_PLACEHOLDER)) {
+        throw new Error(`prompt_template must include the ${PROMPT_TEMPLATE_PLACEHOLDER} placeholder.`);
+    }
+    const seenPrompts = new Map();
+    const specs = [];
+    // Resume entries first
+    for (const entry of resumeEntries) {
+        specs.push({
+            kind: "resume",
+            index: specs.length + 1,
+            agentId: entry.agentId,
+            prompt: entry.prompt,
+        });
+    }
+    // Item-based spawns
+    if (items.length > 0) {
+        const itemPromptTemplate = promptTemplate;
+        items.forEach((item, index) => {
+            const prompt = itemPromptTemplate
+                .split(PROMPT_TEMPLATE_PLACEHOLDER)
+                .join(item);
+            const previousIndex = seenPrompts.get(prompt);
+            if (previousIndex !== undefined) {
+                throw new Error(`Duplicate subagent prompts from items ${String(previousIndex)} and ${String(index + 1)}. AgentSwarm requires distinct subagents.`);
+            }
+            seenPrompts.set(prompt, index + 1);
+            specs.push({
+                kind: "spawn",
+                index: specs.length + 1,
+                item,
+                prompt,
+            });
+        });
+    }
+    return specs;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function hasMinimumAgentSwarmInputs(itemCount, resumeCount) {
+    return resumeCount > 0 || itemCount >= 2;
+}
+function childDescription(swarmDescription, index, profileName) {
+    return `${swarmDescription} #${String(index)} (${profileName})`;
+}
+function normalizeOptionalString(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=tool.js.map

package/dist/swarm/tool.js.map

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

package/dist/team/command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * team/command — /swarm-team slash command handler.
+ *
+ * Supports:
+ *   /swarm-team <goal>   — launch a team run for the given goal
+ *
+ * The command delegates to the AgentTeam tool internally.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare function registerTeamCommand(pi: ExtensionAPI): void;
+//# sourceMappingURL=command.d.ts.map

package/dist/team/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/team/command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,iCAAiC,CAAC;AAM7F,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,GACf,IAAI,CAyBN"}

package/dist/team/command.js

@@ -0,0 +1,32 @@
+/**
+ * team/command — /swarm-team slash command handler.
+ *
+ * Supports:
+ *   /swarm-team <goal>   — launch a team run for the given goal
+ *
+ * The command delegates to the AgentTeam tool internally.
+ */
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerTeamCommand(pi) {
+    pi.registerCommand("swarm-team", {
+        description: "Launch a collaborative team of role-based agents to complete a complex task. " +
+            "Usage: /swarm-team <goal>",
+        async handler(args, ctx) {
+            const prompt = args.trim();
+            if (prompt.length === 0) {
+                ctx.ui?.notify?.("Usage: /swarm-team <goal>", "warning");
+                return;
+            }
+            // Send the goal as a user prompt — the LLM can then decide
+            // whether to call AgentTeam or handle it differently.
+            pi.sendMessage({
+                customType: "swarm_team:prompt",
+                content: `Launch a team to: ${prompt}`,
+                display: true,
+            });
+        },
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/team/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/team/command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB,CACjC,EAAgB;IAEhB,EAAE,CAAC,eAAe,CAAC,YAAY,EAAE;QAC/B,WAAW,EACT,+EAA+E;YAC/E,2BAA2B;QAC7B,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,GAA4B;YACtD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAE3B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CACd,2BAA2B,EAC3B,SAAS,CACV,CAAC;gBACF,OAAO;YACT,CAAC;YAED,2DAA2D;YAC3D,sDAAsD;YACtD,EAAE,CAAC,WAAW,CAAC;gBACb,UAAU,EAAE,mBAAmB;gBAC/B,OAAO,EAAE,qBAAqB,MAAM,EAAE;gBACtC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/team/mailbox.d.ts

@@ -0,0 +1,61 @@
+/**
+ * team/mailbox — JSONL-based mailbox for inter-agent communication.
+ *
+ * Each team run has a shared mailbox directory under .pi/swarm/mailbox/
+ * where agents write messages (outbox) and read messages (inbox).
+ *
+ * Inspired by pi-crew's mailbox system.
+ */
+import type { MailboxMessage } from "../shared/types.js";
+/**
+ * Resolve mailbox paths for a team run.
+ *
+ *   {crewRoot}/state/runs/{runId}/mailbox/
+ *     inbox.jsonl       — team-level inbox
+ *     outbox.jsonl      — team-level outbox
+ *     delivery.json     — delivery state
+ *     tasks/{taskId}/
+ *       inbox.jsonl     — per-task inbox
+ *       outbox.jsonl    — per-task outbox
+ */
+export interface MailboxPaths {
+    readonly root: string;
+    readonly inbox: string;
+    readonly outbox: string;
+    readonly delivery: string;
+    readonly taskDir: string;
+}
+export declare function resolveMailboxPaths(crewRoot: string, runId: string): MailboxPaths;
+export declare function resolveTaskMailboxPaths(crewRoot: string, runId: string, taskId: string): {
+    inbox: string;
+    outbox: string;
+};
+/**
+ * Ensure the mailbox directory structure exists.
+ */
+export declare function ensureMailbox(paths: MailboxPaths): void;
+/**
+ * Send a message to the team outbox and the recipient's per-task inbox.
+ */
+export declare function sendMessage(paths: MailboxPaths, message: MailboxMessage): void;
+/**
+ * Read unacknowledged messages from the team inbox.
+ */
+export declare function readInbox(paths: MailboxPaths): MailboxMessage[];
+/**
+ * Read messages from a task-specific inbox.
+ */
+export declare function readTaskInbox(paths: MailboxPaths, taskId: string): MailboxMessage[];
+/**
+ * Acknowledge (delete) messages from the team inbox.
+ */
+export declare function ackMessages(paths: MailboxPaths, messageIds: string[]): void;
+/**
+ * Get delivery state (which messages have been delivered/read).
+ */
+export declare function getDeliveryState(paths: MailboxPaths): Record<string, string>;
+/**
+ * Update delivery state for a message.
+ */
+export declare function updateDeliveryState(paths: MailboxPaths, messageId: string, status: string): void;
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/team/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../src/team/mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,YAAY,CAed;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAcnC;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CASvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,GACtB,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,GACb,cAAc,EAAE,CAOlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,EAAE,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,IAAI,CAQN"}

package/dist/team/mailbox.js

@@ -0,0 +1,160 @@
+/**
+ * team/mailbox — JSONL-based mailbox for inter-agent communication.
+ *
+ * Each team run has a shared mailbox directory under .pi/swarm/mailbox/
+ * where agents write messages (outbox) and read messages (inbox).
+ *
+ * Inspired by pi-crew's mailbox system.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function resolveMailboxPaths(crewRoot, runId) {
+    const root = path.join(crewRoot, "state", "runs", runId, "mailbox");
+    return {
+        root,
+        inbox: path.join(root, "inbox.jsonl"),
+        outbox: path.join(root, "outbox.jsonl"),
+        delivery: path.join(root, "delivery.json"),
+        taskDir: path.join(root, "tasks"),
+    };
+}
+export function resolveTaskMailboxPaths(crewRoot, runId, taskId) {
+    const base = path.join(crewRoot, "state", "runs", runId, "mailbox", "tasks", taskId);
+    return {
+        inbox: path.join(base, "inbox.jsonl"),
+        outbox: path.join(base, "outbox.jsonl"),
+    };
+}
+// ---------------------------------------------------------------------------
+// Mailbox operations
+// ---------------------------------------------------------------------------
+/**
+ * Ensure the mailbox directory structure exists.
+ */
+export function ensureMailbox(paths) {
+    fs.mkdirSync(paths.root, { recursive: true });
+    fs.mkdirSync(paths.taskDir, { recursive: true });
+    // Create files if they don't exist
+    for (const file of [paths.inbox, paths.outbox, paths.delivery]) {
+        if (!fs.existsSync(file)) {
+            fs.writeFileSync(file, "", "utf-8");
+        }
+    }
+}
+/**
+ * Send a message to the team outbox and the recipient's per-task inbox.
+ */
+export function sendMessage(paths, message) {
+    ensureMailbox(paths);
+    // Append to team outbox
+    appendJsonLine(paths.outbox, message);
+    // If addressed to a specific agent, also put in their task inbox
+    if (message.to && message.to !== "broadcast") {
+        const taskPaths = resolveTaskMailboxPaths(paths.root.replace(/\/state\/runs\/[^/]+\/mailbox$/, ""), // extract crewRoot
+        extractRunId(paths.root), message.to);
+        // Actually, we need proper path derivation. Let's use a simpler approach:
+        // The task inbox is under the taskDir.
+        const taskInbox = path.join(paths.taskDir, message.to, "inbox.jsonl");
+        fs.mkdirSync(path.dirname(taskInbox), { recursive: true });
+        appendJsonLine(taskInbox, message);
+    }
+}
+/**
+ * Read unacknowledged messages from the team inbox.
+ */
+export function readInbox(paths) {
+    return readJsonLines(paths.inbox);
+}
+/**
+ * Read messages from a task-specific inbox.
+ */
+export function readTaskInbox(paths, taskId) {
+    const taskPaths = resolveTaskMailboxPaths(extractCrewRoot(paths.root), extractRunId(paths.root), taskId);
+    return readJsonLines(taskPaths.inbox);
+}
+/**
+ * Acknowledge (delete) messages from the team inbox.
+ */
+export function ackMessages(paths, messageIds) {
+    const messages = readJsonLines(paths.inbox);
+    const idSet = new Set(messageIds);
+    const remaining = messages.filter((m) => !idSet.has(m.messageId));
+    writeJsonLines(paths.inbox, remaining);
+}
+/**
+ * Get delivery state (which messages have been delivered/read).
+ */
+export function getDeliveryState(paths) {
+    try {
+        const raw = fs.readFileSync(paths.delivery, "utf-8");
+        if (!raw.trim())
+            return {};
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Update delivery state for a message.
+ */
+export function updateDeliveryState(paths, messageId, status) {
+    const state = getDeliveryState(paths);
+    state[messageId] = status;
+    fs.writeFileSync(paths.delivery, JSON.stringify(state, null, 2), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function appendJsonLine(filePath, data) {
+    const line = JSON.stringify(data) + "\n";
+    fs.appendFileSync(filePath, line, "utf-8");
+}
+function readJsonLines(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        if (!raw.trim())
+            return [];
+        return raw
+            .trim()
+            .split("\n")
+            .filter((line) => line.trim())
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((m) => m !== null);
+    }
+    catch {
+        return [];
+    }
+}
+function writeJsonLines(filePath, messages) {
+    const content = messages
+        .map((m) => JSON.stringify(m))
+        .join("\n");
+    fs.writeFileSync(filePath, content + (content ? "\n" : ""), "utf-8");
+}
+function extractRunId(mailboxRoot) {
+    // mailboxRoot = .../state/runs/{runId}/mailbox
+    const parts = mailboxRoot.split(path.sep);
+    const mailboxIdx = parts.lastIndexOf("mailbox");
+    if (mailboxIdx >= 2 && parts[mailboxIdx - 2] === "runs") {
+        return parts[mailboxIdx - 1];
+    }
+    return "unknown";
+}
+function extractCrewRoot(mailboxRoot) {
+    // mailboxRoot = {crewRoot}/state/runs/{runId}/mailbox
+    const parts = mailboxRoot.split(path.sep);
+    const stateIdx = parts.lastIndexOf("state");
+    if (stateIdx >= 0) {
+        return parts.slice(0, stateIdx).join(path.sep);
+    }
+    return mailboxRoot;
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/team/mailbox.js.map

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

package/dist/team/supervisor.d.ts

@@ -0,0 +1,77 @@
+/**
+ * team/supervisor — team supervisor agent.
+ *
+ * The supervisor decomposes a high-level goal into phases, assigns
+ * each phase to a role agent, monitors progress via the mailbox,
+ * and synthesizes the final result.
+ */
+import type { AgentRole, TeamPhase, AgentRoleConfig } from "../shared/types.js";
+import { TaskGraph, type PhaseState } from "./task-graph.js";
+import { type MailboxPaths } from "./mailbox.js";
+export interface TeamSupervisorConfig {
+    /** Working directory for the team run. */
+    readonly cwd: string;
+    /** Crew root for state persistence. */
+    readonly crewRoot: string;
+    /** Unique run identifier. */
+    readonly runId: string;
+    /** High-level goal. */
+    readonly goal: string;
+    /** Custom phases (defaults to explore/plan/implement/review/test). */
+    readonly phases?: readonly TeamPhase[];
+    /** Custom role configs. */
+    readonly roles?: readonly AgentRoleConfig[];
+    /** Max concurrent agents. */
+    readonly maxAgents?: number;
+}
+export interface TeamRunState {
+    readonly runId: string;
+    readonly goal: string;
+    status: "running" | "completed" | "failed";
+    taskGraph: TaskGraph;
+    agentIds: Map<string, string>;
+    startedAt: number;
+    completedAt?: number;
+}
+export declare class TeamSupervisor {
+    readonly config: TeamSupervisorConfig;
+    readonly state: TeamRunState;
+    readonly mailboxPaths: MailboxPaths;
+    constructor(config: TeamSupervisorConfig);
+    /**
+     * Get the next phase that is ready to execute (dependencies satisfied,
+     * not yet started or assigned).
+     */
+    getNextReadyPhase(): PhaseState | undefined;
+    /**
+     * Start the next ready phase and return the role + prompt for the agent.
+     */
+    startNextPhase(): {
+        phase: PhaseState;
+        role: AgentRole;
+        prompt: string;
+    } | null;
+    /**
+     * Mark a phase as completed with its result.
+     */
+    completePhase(name: string, result: string): void;
+    /**
+     * Mark a phase as failed.
+     */
+    failPhase(name: string, error: string): void;
+    /**
+     * Assign an agent to a phase.
+     */
+    assignAgent(phaseName: string, agentId: string): void;
+    /** Check if the entire run is complete. */
+    isComplete(): boolean;
+    /** Finalize the run with an overall status. */
+    finalize(): void;
+    /**
+     * Synthesize the final team result from all completed phases.
+     */
+    synthesizeResult(): string;
+    private buildPhasePrompt;
+    private buildSummary;
+}
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/team/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/team/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EAET,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAMtB,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;gBAExB,MAAM,EAAE,oBAAoB;IAwBxC;;;OAGG;IACH,iBAAiB,IAAI,UAAU,GAAG,SAAS;IAmB3C;;OAEG;IACH,cAAc,IAAI;QAChB,KAAK,EAAE,UAAU,CAAC;QAClB,IAAI,EAAE,SAAS,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI;IAeR;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMjD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAc5C;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASrD,2CAA2C;IAC3C,UAAU,IAAI,OAAO;IAIrB,+CAA+C;IAC/C,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAkC1B,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,YAAY;CAkBrB"}