@gjczone/pi-swarm 0.1.2

package/dist/team/supervisor.js

@@ -0,0 +1,195 @@
+/**
+ * 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 { TaskGraph, DEFAULT_TEAM_PHASES, } from "./task-graph.js";
+import { resolveMailboxPaths, ensureMailbox, } from "./mailbox.js";
+// ---------------------------------------------------------------------------
+// Supervisor
+// ---------------------------------------------------------------------------
+export class TeamSupervisor {
+    config;
+    state;
+    mailboxPaths;
+    constructor(config) {
+        this.config = config;
+        this.mailboxPaths = resolveMailboxPaths(config.crewRoot, config.runId);
+        const phases = config.phases ?? DEFAULT_TEAM_PHASES;
+        this.state = {
+            runId: config.runId,
+            goal: config.goal,
+            status: "running",
+            taskGraph: new TaskGraph([...phases]),
+            agentIds: new Map(),
+            startedAt: Date.now(),
+        };
+        ensureMailbox(this.mailboxPaths);
+    }
+    // -------------------------------------------------------------------
+    // Phase management
+    // -------------------------------------------------------------------
+    /**
+     * Get the next phase that is ready to execute (dependencies satisfied,
+     * not yet started or assigned).
+     */
+    getNextReadyPhase() {
+        for (const name of this.state.taskGraph.getPhaseNames()) {
+            const phase = this.state.taskGraph.getPhase(name);
+            if (!phase || phase.status !== "queued")
+                continue;
+            // Check dependencies
+            const deps = phase.phase.dependsOn ?? [];
+            const depsSatisfied = deps.every((dep) => {
+                const depState = this.state.taskGraph.getPhase(dep);
+                return depState?.status === "completed";
+            });
+            if (depsSatisfied) {
+                return phase;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Start the next ready phase and return the role + prompt for the agent.
+     */
+    startNextPhase() {
+        const phase = this.getNextReadyPhase();
+        if (!phase)
+            return null;
+        const result = this.state.taskGraph.startPhase(phase.phase.name);
+        if (!result.ok)
+            return null;
+        const prompt = this.buildPhasePrompt(phase);
+        return {
+            phase,
+            role: phase.phase.role,
+            prompt,
+        };
+    }
+    /**
+     * Mark a phase as completed with its result.
+     */
+    completePhase(name, result) {
+        this.state.taskGraph.completePhase(name, result);
+        // Propagate failures: skip phases that depend on a failed phase
+        // (Not needed for completed phases)
+    }
+    /**
+     * Mark a phase as failed.
+     */
+    failPhase(name, error) {
+        this.state.taskGraph.failPhase(name, error);
+        // Skip downstream phases that depend on this one
+        for (const otherName of this.state.taskGraph.getPhaseNames()) {
+            const other = this.state.taskGraph.getPhase(otherName);
+            if (!other || other.status !== "queued")
+                continue;
+            const deps = other.phase.dependsOn ?? [];
+            if (deps.includes(name)) {
+                this.state.taskGraph.skipPhase(otherName);
+            }
+        }
+    }
+    /**
+     * Assign an agent to a phase.
+     */
+    assignAgent(phaseName, agentId) {
+        this.state.agentIds.set(phaseName, agentId);
+        this.state.taskGraph.assignAgent(phaseName, agentId);
+    }
+    // -------------------------------------------------------------------
+    // Completion
+    // -------------------------------------------------------------------
+    /** Check if the entire run is complete. */
+    isComplete() {
+        return this.state.taskGraph.isComplete();
+    }
+    /** Finalize the run with an overall status. */
+    finalize() {
+        this.state.status = this.state.taskGraph.overallStatus();
+        this.state.completedAt = Date.now();
+    }
+    /**
+     * Synthesize the final team result from all completed phases.
+     */
+    synthesizeResult() {
+        const lines = [
+            "<agent_team_result>",
+            `<summary>${this.buildSummary()}</summary>`,
+        ];
+        for (const phase of this.state.taskGraph.getAllPhases()) {
+            const name = phase.phase.name;
+            const role = phase.phase.role;
+            const status = phase.status;
+            const result = phase.result ?? "";
+            const error = phase.error ?? "";
+            lines.push(`<phase name="${escapeXml(name)}" role="${escapeXml(role)}" outcome="${escapeXml(status)}">`);
+            if (status === "completed" && result) {
+                lines.push(escapeXml(result));
+            }
+            else if (status === "failed" && error) {
+                lines.push(`<error>${escapeXml(error)}</error>`);
+            }
+            lines.push(`</phase>`);
+        }
+        lines.push("</agent_team_result>");
+        return lines.join("\n");
+    }
+    // -------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------
+    buildPhasePrompt(phase) {
+        const goal = this.config.goal;
+        const role = phase.phase.role;
+        const name = phase.phase.name;
+        // Gather context from completed dependency phases
+        const deps = phase.phase.dependsOn ?? [];
+        let contextBlock = "";
+        if (deps.length > 0) {
+            const depResults = deps
+                .map((dep) => {
+                const depState = this.state.taskGraph.getPhase(dep);
+                if (!depState || !depState.result)
+                    return null;
+                return `${dep} output:\n${depState.result}`;
+            })
+                .filter(Boolean)
+                .join("\n\n");
+            if (depResults) {
+                contextBlock = `\n\nContext from previous phases:\n${depResults}`;
+            }
+        }
+        return [
+            `You are the ${role} agent in a team working on: ${goal}`,
+            `Your current phase is: ${name}`,
+            contextBlock,
+            `Complete the ${name} phase and write your result.`,
+            `Output only the result — no conversation.`,
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }
+    buildSummary() {
+        const all = this.state.taskGraph.getAllPhases();
+        const completed = all.filter((p) => p.status === "completed").length;
+        const failed = all.filter((p) => p.status === "failed").length;
+        const skipped = all.filter((p) => p.status === "skipped").length;
+        const total = all.length;
+        return (`Phases completed: ${completed}/${total}. ` +
+            `Succeeded: ${completed}, Failed: ${failed}, Skipped: ${skipped}.`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;");
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/team/supervisor.js.map

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

package/dist/team/task-graph.d.ts

@@ -0,0 +1,61 @@
+/**
+ * team/task-graph — task dependency graph with phases.
+ *
+ * Models a team run as a directed acyclic graph of phases, where each
+ * phase has a role assignment and optional dependencies.  The supervisor
+ * advances phases as agents complete their tasks.
+ */
+import type { TeamPhase } from "../shared/types.js";
+/** Default team workflow: explore → plan → implement → review → test. */
+export declare const DEFAULT_TEAM_PHASES: readonly TeamPhase[];
+export type PhaseStatus = "queued" | "running" | "completed" | "failed" | "skipped";
+export interface PhaseState {
+    readonly phase: TeamPhase;
+    status: PhaseStatus;
+    agentId?: string;
+    result?: string;
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+}
+export declare class TaskGraph {
+    private readonly phases;
+    private readonly order;
+    constructor(phases: readonly TeamPhase[]);
+    /** Get all phases in definition order. */
+    getPhaseNames(): string[];
+    /** Get the state of a phase. */
+    getPhase(name: string): PhaseState | undefined;
+    /** Get all phase states. */
+    getAllPhases(): PhaseState[];
+    /** Get the current phase (first non-completed, non-failed, non-skipped). */
+    getCurrentPhase(): PhaseState | undefined;
+    /** Check if all phases are terminal (completed, failed, or skipped). */
+    isComplete(): boolean;
+    /** Get the overall run status. */
+    overallStatus(): "running" | "completed" | "failed";
+    /**
+     * Start a phase.  Fails if dependencies are not satisfied.
+     * Returns the phase state or an error.
+     */
+    startPhase(name: string): {
+        ok: true;
+        phase: PhaseState;
+    } | {
+        ok: false;
+        error: string;
+    };
+    /** Mark a phase as completed with a result. */
+    completePhase(name: string, result: string): void;
+    /** Mark a phase as failed with an error. */
+    failPhase(name: string, error: string): void;
+    /** Skip a phase (e.g., when a dependency failed). */
+    skipPhase(name: string): void;
+    /** Assign an agent ID to a phase. */
+    assignAgent(name: string, agentId: string): void;
+    /** Serialize to a plain object for persistence. */
+    toJSON(): Record<string, unknown>;
+    /** Deserialize from a plain object. */
+    static fromJSON(data: Record<string, unknown>, phaseDefs: readonly TeamPhase[]): TaskGraph;
+}
+//# sourceMappingURL=task-graph.d.ts.map

package/dist/team/task-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-graph.d.ts","sourceRoot":"","sources":["../../src/team/task-graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAM/D,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,EAAE,SAAS,SAAS,EAMnD,CAAC;AAMF,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;gBAErB,MAAM,EAAE,SAAS,SAAS,EAAE;IAqBxC,0CAA0C;IAC1C,aAAa,IAAI,MAAM,EAAE;IAIzB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,4BAA4B;IAC5B,YAAY,IAAI,UAAU,EAAE;IAI5B,4EAA4E;IAC5E,eAAe,IAAI,UAAU,GAAG,SAAS;IAazC,wEAAwE;IACxE,UAAU,IAAI,OAAO;IAWrB,kCAAkC;IAClC,aAAa,IAAI,SAAS,GAAG,WAAW,GAAG,QAAQ;IAenD;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IA8BxF,+CAA+C;IAC/C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQjD,4CAA4C;IAC5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ5C,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO7B,qCAAqC;IACrC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWhD,mDAAmD;IACnD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBjC,uCAAuC;IACvC,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,SAAS,SAAS,EAAE,GAC9B,SAAS;CAsBb"}

package/dist/team/task-graph.js

@@ -0,0 +1,193 @@
+/**
+ * team/task-graph — task dependency graph with phases.
+ *
+ * Models a team run as a directed acyclic graph of phases, where each
+ * phase has a role assignment and optional dependencies.  The supervisor
+ * advances phases as agents complete their tasks.
+ */
+// ---------------------------------------------------------------------------
+// Default phases
+// ---------------------------------------------------------------------------
+/** Default team workflow: explore → plan → implement → review → test. */
+export const DEFAULT_TEAM_PHASES = [
+    { name: "explore", role: "explorer" },
+    { name: "plan", role: "planner", dependsOn: ["explore"] },
+    { name: "implement", role: "coder", dependsOn: ["plan"] },
+    { name: "review", role: "reviewer", dependsOn: ["implement"] },
+    { name: "test", role: "tester", dependsOn: ["review"] },
+];
+// ---------------------------------------------------------------------------
+// Task graph
+// ---------------------------------------------------------------------------
+export class TaskGraph {
+    phases;
+    order;
+    constructor(phases) {
+        this.phases = new Map();
+        this.order = [];
+        for (const phase of phases) {
+            const name = phase.name;
+            if (this.phases.has(name)) {
+                throw new Error(`Duplicate phase name: ${name}`);
+            }
+            this.phases.set(name, {
+                phase,
+                status: "queued",
+            });
+            this.order.push(name);
+        }
+    }
+    // -------------------------------------------------------------------
+    // Queries
+    // -------------------------------------------------------------------
+    /** Get all phases in definition order. */
+    getPhaseNames() {
+        return [...this.order];
+    }
+    /** Get the state of a phase. */
+    getPhase(name) {
+        return this.phases.get(name);
+    }
+    /** Get all phase states. */
+    getAllPhases() {
+        return this.order.map((name) => this.phases.get(name));
+    }
+    /** Get the current phase (first non-completed, non-failed, non-skipped). */
+    getCurrentPhase() {
+        for (const name of this.order) {
+            const state = this.phases.get(name);
+            if (state.status === "queued" ||
+                state.status === "running") {
+                return state;
+            }
+        }
+        return undefined;
+    }
+    /** Check if all phases are terminal (completed, failed, or skipped). */
+    isComplete() {
+        return this.order.every((name) => {
+            const state = this.phases.get(name);
+            return (state.status === "completed" ||
+                state.status === "failed" ||
+                state.status === "skipped");
+        });
+    }
+    /** Get the overall run status. */
+    overallStatus() {
+        if (!this.isComplete())
+            return "running";
+        const allCompleted = this.order.every((name) => {
+            const state = this.phases.get(name);
+            return (state.status === "completed" || state.status === "skipped");
+        });
+        return allCompleted ? "completed" : "failed";
+    }
+    // -------------------------------------------------------------------
+    // Mutations
+    // -------------------------------------------------------------------
+    /**
+     * Start a phase.  Fails if dependencies are not satisfied.
+     * Returns the phase state or an error.
+     */
+    startPhase(name) {
+        const state = this.phases.get(name);
+        if (!state) {
+            return { ok: false, error: `Unknown phase: ${name}` };
+        }
+        if (state.status !== "queued") {
+            return {
+                ok: false,
+                error: `Phase ${name} is already ${state.status}`,
+            };
+        }
+        // Check dependencies
+        const deps = state.phase.dependsOn ?? [];
+        for (const dep of deps) {
+            const depState = this.phases.get(dep);
+            if (!depState || depState.status !== "completed") {
+                return {
+                    ok: false,
+                    error: `Dependency ${dep} is not completed (${depState?.status ?? "unknown"})`,
+                };
+            }
+        }
+        state.status = "running";
+        state.startedAt = Date.now();
+        return { ok: true, phase: state };
+    }
+    /** Mark a phase as completed with a result. */
+    completePhase(name, result) {
+        const state = this.phases.get(name);
+        if (!state)
+            return;
+        state.status = "completed";
+        state.result = result;
+        state.completedAt = Date.now();
+    }
+    /** Mark a phase as failed with an error. */
+    failPhase(name, error) {
+        const state = this.phases.get(name);
+        if (!state)
+            return;
+        state.status = "failed";
+        state.error = error;
+        state.completedAt = Date.now();
+    }
+    /** Skip a phase (e.g., when a dependency failed). */
+    skipPhase(name) {
+        const state = this.phases.get(name);
+        if (!state)
+            return;
+        state.status = "skipped";
+        state.completedAt = Date.now();
+    }
+    /** Assign an agent ID to a phase. */
+    assignAgent(name, agentId) {
+        const state = this.phases.get(name);
+        if (state) {
+            state.agentId = agentId;
+        }
+    }
+    // -------------------------------------------------------------------
+    // Serialization
+    // -------------------------------------------------------------------
+    /** Serialize to a plain object for persistence. */
+    toJSON() {
+        const phases = {};
+        for (const [name, state] of this.phases) {
+            phases[name] = {
+                name: state.phase.name,
+                role: state.phase.role,
+                status: state.status,
+                agentId: state.agentId,
+                result: state.result,
+                error: state.error,
+                startedAt: state.startedAt,
+                completedAt: state.completedAt,
+            };
+        }
+        return { phases };
+    }
+    /** Deserialize from a plain object. */
+    static fromJSON(data, phaseDefs) {
+        const graph = new TaskGraph(phaseDefs);
+        const phases = data.phases;
+        if (phases) {
+            for (const [name, stateData] of Object.entries(phases)) {
+                const state = graph.phases.get(name);
+                if (state && stateData) {
+                    state.status =
+                        stateData.status ?? "queued";
+                    state.agentId = stateData.agentId;
+                    state.result = stateData.result;
+                    state.error = stateData.error;
+                    state.startedAt = stateData.startedAt;
+                    state.completedAt =
+                        stateData.completedAt;
+                }
+            }
+        }
+        return graph;
+    }
+}
+//# sourceMappingURL=task-graph.js.map

package/dist/team/task-graph.js.map

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

package/dist/team/tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare function registerAgentTeamTool(pi: ExtensionAPI): void;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/team/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA+CpE,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,YAAY,GACf,IAAI,CA4PN"}