@gjczone/pi-swarm 0.4.1 → 0.7.0

package/dist/team/supervisor.d.ts

@@ -1,171 +0,0 @@
-/**
- * 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, MailboxMessage, TeamProgressCallback, SubagentUsage } from "../shared/types.js";
-import { TaskGraph, type PhaseState } from "./task-graph.js";
-import { type MailboxPaths } from "./mailbox.js";
-/**
- * Get the mailbox root path for a given run.
- * Exposed so tool.ts can pass it to the controller for real-time mailbox access.
- */
-export declare function getMailboxRoot(swarmRoot: string, runId: string): string;
-export interface TeamSupervisorConfig {
-    /** Working directory for the team run. */
-    readonly cwd: string;
-    /** Swarm root for state persistence. */
-    readonly swarmRoot: 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[];
-    /** Model to use for lightweight/exploration roles (e.g. explorer). */
-    readonly smallModel?: string;
-    /** Max concurrent agents. */
-    readonly maxAgents?: number;
-    /** Progress callback for TUI dashboard updates. */
-    readonly onProgress?: TeamProgressCallback;
-}
-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;
-    private readonly onProgress?;
-    constructor(config: TeamSupervisorConfig);
-    /**
-     * Get ALL phases that are ready to execute (dependencies satisfied,
-     * not yet started or assigned).  Returns in definition order.
-     *
-     * 业务说明：返回所有依赖已满足、尚未开始的阶段，而非仅第一个。
-     * 这使得独立阶段可以并行执行。
-     */
-    getAllReadyPhases(): PhaseState[];
-    /**
-     * Start ALL currently ready phases and return their execution descriptors.
-     * Returns an empty array when no phases are ready.
-     *
-     * 业务说明：一次性启动所有就绪阶段，支持并行执行。
-     * 调用者应并发启动所有返回的阶段。
-     */
-    startReadyPhases(): Array<{
-        phase: PhaseState;
-        role: AgentRole;
-        prompt: string;
-    }>;
-    /**
-     * Parse agent output for mailbox_message blocks and separate them from the result.
-     */
-    parseAgentMessages(output: string): {
-        result: string;
-        messages: Array<{
-            to: string;
-            content: string;
-        }>;
-    };
-    /**
-     * Mark a phase as completed with its raw output.
-     * Parses messages from output, delivers them, and sends task_result broadcast.
-     */
-    completePhase(name: string, rawOutput: string, usage?: SubagentUsage): {
-        result: string;
-        deliveredMessages: number;
-    };
-    private generateMessageId;
-    /**
-     * Mark a phase as failed.
-     */
-    failPhase(name: string, error: string): void;
-    /** Assign an agent to a phase. */
-    assignAgent(phaseName: string, agentId: string): void;
-    /**
-     * Update token usage for a running phase (for real-time progress display).
-     *
-     * 业务说明：实时更新运行中阶段的 token 使用量，供 TUI 仪表盘显示。
-     * 由 controller 的 onUsage 回调在每次 usage 更新时调用。
-     */
-    updatePhaseUsage(phaseName: string, usage: SubagentUsage): void;
-    /**
-     * Handle a real-time message sent by an agent during execution (not just at completion).
-     * Delivers the message to the recipient's inbox immediately, enabling true live communication.
-     *
-     * 业务说明：处理 agent 运行期间实时发送的消息（而不是仅在完成时）。
-     * 消息立即投递到接收方的 inbox 文件，正在运行的 agent 可以读取到。
-     * 这实现了真正的实时 agent 间通信，无需等待阶段完成。
-     */
-    handleRealtimeMessage(fromRole: string, message: MailboxMessage): void;
-    /**
-     * Get the mailbox root path for passing to spawner/controller.
-     */
-    getMailboxPath(): string;
-    /**
-     * Resolve the model and tools configuration for a given phase.
-     *
-     * Resolution order (highest priority first):
-     * 1. Phase-level explicit model override (phase.model)
-     * 2. Phase-level modelTier (small => smallModel if configured)
-     * 3. Role-level model override from roles config
-     * 4. Auto-routing by role name: roles in SMALL_MODEL_ROLES => smallModel
-     * 5. Default model (undefined, inherits parent)
-     */
-    getPhaseExecutionConfig(phaseName: string): {
-        model?: string;
-        tools?: string[];
-        cwd: string;
-    };
-    /**
-     * Build and emit a TeamProgressSnapshot for the TUI dashboard.
-     *
-     * Reads current phase statuses from the task graph, counts mailbox
-     * messages, and calls the optional onProgress callback with the
-     * snapshot.
-     */
-    private emitProgress;
-    /** 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.
-     * Max characters of phase output to include inline; rest is truncated.
-     */
-    private static readonly MAX_PHASE_OUTPUT_CHARS;
-    synthesizeResult(): string;
-    /**
-     * Truncate a phase result to MAX_PHASE_OUTPUT_CHARS with a note.
-     */
-    private truncateForOutput;
-    /**
-     * Build a consolidated synthesis across all completed phases.
-     *
-     * Extracts the first non-empty line or heading from each phase to create
-     * an executive summary, then lists all phases with their key outcomes.
-     */
-    private buildSynthesis;
-    /**
-     * Extract the first meaningful line (not empty, not a mailbox tag).
-     */
-    private extractFirstMeaningfulLine;
-    /**
-     * Extract a short excerpt (first ~400 chars of meaningful content) from a phase result.
-     */
-    private extractExcerpt;
-    private buildPhasePrompt;
-    private buildSummary;
-}
-//# sourceMappingURL=supervisor.d.ts.map

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

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