@cuylabs/agent-core 4.8.1 → 4.10.0

package/dist/team/coordinator/coordinator.d.ts

@@ -0,0 +1,342 @@
+/**
+ * Team Coordinator
+ *
+ * Orchestrates a team of forked agents working toward a shared goal.
+ *
+ * Responsibilities:
+ * - Register members by forking agents from roles
+ * - Queue and dispatch tasks with dependency-aware scheduling
+ * - Route messages between coordinator and members
+ * - Track task execution and cascade status transitions
+ * - Synthesize results from completed tasks
+ * - Emit team events for observability
+ *
+ * The coordinator is deliberately host-agnostic. It uses:
+ * - `TaskBoard` + `TaskBoardStore` for task/member persistence
+ * - `Mailbox` + `MailboxStore` for messaging persistence
+ * - `Agent.fork()` + `Agent.run()` for member execution
+ *
+ * Hosts (CLI, HTTP server, chatbot) provide concrete stores
+ * and wire the coordinator to their UI/transport layer.
+ *
+ * Design choices vs CLI CliTeamController:
+ * - No dependency on agent-runtime's orchestrator — uses Agent.run() directly
+ * - Explicit "claimed" state between pending and running
+ * - Event-driven via TeamEvent emitter instead of mailbox system messages
+ * - Members tracked as `{ agent, member, role }` tuples
+ * - `guide()` method for mid-task interventions via InterventionController
+ * - Configurable `onEvent` callback instead of coupling to a specific event bus
+ *
+ * Execution, work-loop, and shutdown logic are extracted into
+ * focused modules to keep this file manageable:
+ * - `execution.ts` — task dispatch and Agent.run() lifecycle
+ * - `work-loop.ts` — persistent idle loop and auto-claim
+ * - `shutdown.ts` — two-phase graceful shutdown protocol
+ */
+import type { Agent } from "../../agent/instance/index.js";
+import type { MemberStatus, TaskResult, TaskTransition, TeamMember, TeamMessage, TeamSnapshot, TeamTask } from "../types.js";
+import { TaskBoard, type TaskListFilter } from "../task-board.js";
+import { Mailbox, type MessageListFilter } from "../mailbox.js";
+import type { TeamEvent } from "../events.js";
+import type { AgentEvent } from "../../types/events.js";
+import type { MemberRuntime, MemberStats, PermissionHandler, TaskExecutor, TaskDispatchMode, PreparedExternalTask, TeamCoordinatorConfig, QueueTaskInput, TaskCompletion, SynthesisResult, TeamPlan, CoordinatorCtx } from "./types.js";
+import { type CoordinatorLoopOptions, type CoordinatorLoopResult } from "./turn.js";
+import { type CoordinatorInboxItem, type CoordinatorRuntimeStatus } from "./turn.js";
+/**
+ * Team coordinator — manages a team of agents working in parallel.
+ *
+ * ```typescript
+ * const team = createTeamCoordinator({
+ *   lead: agent,
+ *   leadSessionId: "main",
+ *   roles: [explorerRole, coderRole, reviewerRole],
+ * });
+ *
+ * await team.start();
+ * await team.registerAll();
+ * await team.queue({ title: "Explore codebase", prompt: "...", memberId: "explorer" });
+ * await team.queue({ title: "Implement feature", prompt: "...", dependsOn: [task1.id] });
+ * await team.waitForAll();
+ * const result = await team.synthesize("Build a REST API");
+ * await team.stop();
+ * ```
+ */
+export declare class TeamCoordinator implements CoordinatorCtx {
+    readonly teamId: string;
+    /** @internal */ readonly lead: Agent;
+    /** @internal */ readonly leadSessionId: string;
+    /** @internal */ readonly createId: () => string;
+    private readonly roles;
+    /** @internal */ readonly members: Map<string, MemberRuntime>;
+    /** @internal */ readonly taskBoard: TaskBoard;
+    /** @internal */ readonly mailbox: Mailbox;
+    private readonly onEvent?;
+    private readonly eventListeners;
+    private readonly signal?;
+    /** @internal */ readonly workLoopEnabled: boolean;
+    /** @internal */ readonly taskDispatchMode: TaskDispatchMode;
+    /** @internal */ readonly pollIntervalMs: number;
+    /** @internal */ readonly onPermissionRequest?: PermissionHandler;
+    /** @internal */ readonly beforeIteration?: TeamCoordinatorConfig["beforeIteration"];
+    /** @internal */ readonly sharedPermissions?: TeamCoordinatorConfig["sharedPermissions"];
+    /** @internal */ readonly taskExecutor?: TaskExecutor;
+    private readonly externalTaskControl?;
+    /** @internal */ started: boolean;
+    private readonly onLog?;
+    private readonly logger?;
+    private activeCoordinatorTurn?;
+    private mailboxUnsubscribe?;
+    private coordinatorAgent?;
+    private coordinatorSessionId?;
+    /** @internal */ coordinatorInbox: CoordinatorInboxItem[];
+    /** @internal */ coordinatorProcessing: boolean;
+    /** @internal */ coordinatorReschedule: boolean;
+    private coordinatorStatus;
+    private readonly coordinatorEventListeners;
+    private readonly coordinatorStatusListeners;
+    private coordinatorIdleResolvers;
+    /** @internal */ coordinatorRoundNumber: number;
+    private coordinatorRunSequence;
+    private coordinatorTurnState;
+    /** @internal Structured log output — writes to both logger and onLog when provided. */
+    log(msg: string): void;
+    private dispatchEvent;
+    subscribeTeamEvents(listener: (event: TeamEvent) => void | Promise<void>): () => void;
+    /** @internal */
+    publishCoordinatorEvent(event: AgentEvent): void;
+    /** @internal */
+    publishCoordinatorStatus(status: Partial<CoordinatorRuntimeStatus>): void;
+    /** @internal */
+    resolveCoordinatorIdleWaiters(): void;
+    constructor(config: TeamCoordinatorConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Register a team member from a role.
+     * Forks the lead agent with the role's specialization.
+     */
+    register(roleName: string, memberId?: string): Promise<TeamMember>;
+    /**
+     * Register all roles (or a subset) as team members.
+     */
+    registerAll(roleNames?: string[]): Promise<TeamMember[]>;
+    /**
+     * List available role names.
+     */
+    listRoles(): string[];
+    /**
+     * Queue a task. If dependencies are met and a member is idle,
+     * the task is dispatched immediately.
+     */
+    queue(input: QueueTaskInput): Promise<TeamTask>;
+    /**
+     * Dispatch all pending tasks to idle members.
+     * Called automatically after queue/complete/fail/cancel.
+     */
+    dispatchReady(): Promise<TeamTask[]>;
+    /**
+     * Wait for a specific task to reach a terminal state.
+     */
+    waitForTask(taskId: string, timeoutMs?: number): Promise<TaskCompletion>;
+    /**
+     * Wait for all tasks to reach terminal states.
+     */
+    waitForAll(timeoutMs?: number): Promise<TaskCompletion[]>;
+    /**
+     * Cancel a task. If it's running, the task's AbortController fires.
+     * Cascades to dependent tasks.
+     */
+    cancel(taskId: string, reason?: string): Promise<TeamTask>;
+    /**
+     * Abort a running task. The member returns to idle and can pick up
+     * new work. Unlike `cancel()`, abort preserves downstream tasks by
+     * leaving them blocked on the aborted prerequisite.
+     */
+    abort(taskId: string, reason?: string): Promise<void>;
+    /**
+     * Send a guidance message to a running member via intervention.
+     * If the member is idle, queues a direct-message task instead.
+     */
+    guide(memberId: string, message: string): Promise<void>;
+    /**
+     * Broadcast a message to all members. Active members receive it
+     * as an intervention; idle members see it on their next task.
+     */
+    broadcast(message: string): Promise<TeamMessage>;
+    /**
+     * Request graceful shutdown of a specific member.
+     *
+     * - If member is idle, auto-accepts and goes offline immediately
+     * - If member is busy, marks as shutting-down and waits for current
+     *   task to finish before going offline
+     * - Returns true if shutdown succeeded within the timeout
+     */
+    requestShutdown(memberId: string, reason?: string, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Gracefully shut down all members.
+     */
+    shutdown(reason?: string, timeoutMs?: number): Promise<void>;
+    /**
+     * Handle a permission request forwarded from a team member.
+     * Called by the `teamPermissionPolicy` middleware when it has
+     * a `forwardApproval` callback pointing at the coordinator.
+     */
+    handlePermissionRequest(memberId: string, tool: string, args: unknown): Promise<{
+        decision: "allow" | "deny";
+        reason?: string;
+    }>;
+    /**
+     * Create a `forwardApproval` callback for `teamPermissionPolicy`
+     * that routes through this coordinator's permission handler.
+     */
+    createPermissionForwarder(memberId: string): (_memberId: string, tool: string, args: unknown, _ctx?: unknown) => Promise<{
+        action: "allow" | "deny";
+        reason?: string;
+    }>;
+    /** @internal */
+    beginCoordinatorTurnState(): {
+        actions: {
+            assigned: Array<{
+                taskId: string;
+                memberId: string;
+                title: string;
+            }>;
+            sentMessages: Array<{
+                memberId: string;
+            }>;
+            abortedTaskIds: string[];
+        };
+    };
+    /** @internal */
+    getActiveCoordinatorTurnState(): {
+        actions: {
+            assigned: Array<{
+                taskId: string;
+                memberId: string;
+                title: string;
+            }>;
+            sentMessages: Array<{
+                memberId: string;
+            }>;
+            abortedTaskIds: string[];
+        };
+    };
+    /** @internal */
+    endCoordinatorTurnState(): void;
+    /** @internal */
+    getCoordinatorInboxSize(): number;
+    /** @internal */
+    getActiveTaskCount(): Promise<number>;
+    /** @internal */
+    ensureCoordinatorAgent(): Agent;
+    /** @internal */
+    getCoordinatorSessionId(): string;
+    private resetCoordinatorRunSession;
+    private enqueueCoordinatorInboxItem;
+    private enqueueCoordinatorNotification;
+    /** @internal */
+    scheduleCoordinatorProcessing(): void;
+    /** @internal */ autonomousTurnCount: number;
+    waitForCoordinatorIdle(): Promise<void>;
+    submitToCoordinator(message: string): string;
+    subscribeCoordinatorEvents(listener: (event: AgentEvent) => void): () => void;
+    subscribeCoordinatorStatus(listener: (status: CoordinatorRuntimeStatus) => void): () => void;
+    getCoordinatorStatus(): CoordinatorRuntimeStatus;
+    /** @internal */
+    attachCoordinatorTurn(agent: Agent, sessionId: string): void;
+    /** @internal */
+    setCoordinatorTurnOpen(open: boolean): void;
+    /** @internal */
+    detachCoordinatorTurn(agent?: Agent): void;
+    /**
+     * Run the coordinator in an iterative loop.
+     *
+     * The lead agent is forked with delegation tools and a coordinator
+     * system prompt. It reasons about the request, assigns tasks to
+     * teammates, receives results, and continues until all work is done.
+     *
+     * This replaces the plan → fan-out → synthesize pipeline with a
+     * dynamic multi-round conversation where the coordinator decides
+     * what to delegate, how to react to results, and when it's done.
+     *
+     * Members must be registered before calling this method.
+     *
+     * @param prompt  - The user's request
+     * @param options - Loop configuration (max rounds, timeouts, progress callback)
+     */
+    run(prompt: string, options?: CoordinatorLoopOptions): Promise<CoordinatorLoopResult>;
+    plan(prompt: string, memberIds?: string[]): Promise<TeamPlan>;
+    planAndExecute(prompt: string, memberIds?: string[]): Promise<{
+        plan: TeamPlan;
+        tasks: TeamTask[];
+    }>;
+    /**
+     * Use the lead agent to synthesize all completed task results
+     * into a single coherent response.
+     *
+     * @param originalPrompt - The original task/prompt
+     * @param taskIds - Optional subset of task IDs to synthesize (defaults to all terminal tasks)
+     */
+    synthesize(originalPrompt: string, taskIds?: string[]): Promise<SynthesisResult>;
+    snapshot(): Promise<TeamSnapshot>;
+    listMembers(): Promise<TeamMember[]>;
+    listTasks(filter?: TaskListFilter): Promise<TeamTask[]>;
+    listMessages(filter?: Omit<MessageListFilter, "teamId">): Promise<TeamMessage[]>;
+    getMemberSessionId(memberId: string): string;
+    getMemberRole(memberId: string): string;
+    prepareTaskForExternalExecution(taskId: string, runId: string): Promise<PreparedExternalTask | undefined>;
+    completeExternalTask(taskId: string, result: TaskResult): Promise<{
+        task: TeamTask;
+        transitions: TaskTransition[];
+    } | undefined>;
+    failExternalTask(taskId: string, error: string): Promise<{
+        task: TeamTask;
+        transitions: TaskTransition[];
+    } | undefined>;
+    abortExternalTask(taskId: string, reason: string): Promise<{
+        task: TeamTask;
+        transitions: TaskTransition[];
+    } | undefined>;
+    getTask(taskId: string): Promise<TeamTask | undefined>;
+    /**
+     * Get aggregate stats for a member.
+     * Returns undefined if the member is not registered.
+     */
+    getMemberStats(memberId: string): MemberStats | undefined;
+    /**
+     * Subscribe to a member's agent events (text-delta, tool-start, etc.).
+     * Returns an unsubscribe function. Throws if the member is not registered.
+     */
+    onMemberEvent(memberId: string, handler: (event: AgentEvent) => void): () => void;
+    /**
+     * Serialize the coordinator state for persistence / resume.
+     * Returns snapshot + member stats, enough to reconstruct state.
+     */
+    toJSON(): Promise<{
+        teamId: string;
+        snapshot: TeamSnapshot;
+        memberStats: Record<string, MemberStats>;
+    }>;
+    /** @internal */
+    updateMemberStatus(memberId: string, status: MemberStatus, activeTaskId: string | undefined): Promise<void>;
+    private requireMember;
+    /** @internal */
+    emit(event: TeamEvent): Promise<void>;
+    /** @internal */
+    emitTransitions(transitions: TaskTransition[]): Promise<void>;
+    private finalizeExternallyTerminatedTask;
+}
+/**
+ * Create a team coordinator.
+ *
+ * ```typescript
+ * const team = createTeamCoordinator({
+ *   lead: agent,
+ *   leadSessionId: "main",
+ *   roles: [explorerRole, reviewerRole],
+ *   onEvent: (event) => console.log(event.type),
+ * });
+ * ```
+ */
+export declare function createTeamCoordinator(config: TeamCoordinatorConfig): TeamCoordinator;
+//# sourceMappingURL=coordinator.d.ts.map

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

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

package/dist/team/coordinator/inbox.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Coordinator Inbox Processor
+ *
+ * Manages the coordinator's priority inbox — the central mechanism
+ * through which task notifications, worker reports, and user messages
+ * reach the coordinator agent.
+ *
+ * Design decisions (learned from ccsource's command queue):
+ * - **User-message priority**: when a batch contains both user
+ *   messages and notifications, only user messages are processed
+ *   in the current turn. Notifications are deferred. This prevents
+ *   the model from swallowing user input by focusing on task results.
+ * - **Autonomous turn limit**: consecutive notification-only turns
+ *   (no user message) are capped to prevent infinite delegation
+ *   loops. The coordinator yields to "ready" and waits for user
+ *   guidance. Sending any message resets the counter.
+ * - **No mid-stream intervention**: user messages always go through
+ *   the inbox (never injected via `agent.intervene()`). The 3s
+ *   delegation timer made intervention fragile — messages were lost
+ *   when the stream aborted.
+ *
+ * @module
+ */
+import type { Agent } from "../../agent/instance/index.js";
+import type { AgentEvent } from "../../types/events.js";
+import type { CoordinatorNotification } from "../notifications.js";
+import { type CoordinatorInboxItem, type CoordinatorRuntimeStatus } from "./turn.js";
+/**
+ * Maximum consecutive turns before the inbox processor yields.
+ * Prevents runaway loops when rapid task completions keep feeding
+ * the inbox faster than the coordinator can drain it. The scheduler
+ * will re-enter on the next microtask if there is still pending work.
+ */
+export declare const MAX_CONSECUTIVE_TURNS = 20;
+/**
+ * Maximum coordinator turns driven purely by task notifications (no user
+ * message) before the coordinator yields and waits for user guidance.
+ * This persists across invocations — reset only when the coordinator
+ * processes a batch containing a user message.
+ */
+export declare const MAX_AUTONOMOUS_TURNS = 30;
+/**
+ * Narrow context interface that the inbox processor requires from
+ * the coordinator. Keeps the inbox module decoupled from the full
+ * TeamCoordinator class.
+ */
+export interface InboxContext {
+    /** Whether the coordinator has been started. */
+    readonly started: boolean;
+    /** Team identifier. */
+    readonly teamId: string;
+    /** Structured logging. */
+    log(msg: string): void;
+    /** Current inbox queue — mutable. */
+    coordinatorInbox: CoordinatorInboxItem[];
+    /** Whether the inbox processor is currently running. */
+    coordinatorProcessing: boolean;
+    /** Whether a reschedule was requested while processing. */
+    coordinatorReschedule: boolean;
+    /** Tracks consecutive notification-only turns across invocations. */
+    autonomousTurnCount: number;
+    /** Monotonically increasing round counter. */
+    coordinatorRoundNumber: number;
+    ensureCoordinatorAgent(): Agent;
+    getCoordinatorSessionId(): string;
+    publishCoordinatorStatus(partial: Partial<CoordinatorRuntimeStatus>): void;
+    publishCoordinatorEvent(event: AgentEvent): void;
+    resolveCoordinatorIdleWaiters(): void;
+    getActiveTaskCount(): Promise<number>;
+    getTask(taskId: string): Promise<import("../types.js").TeamTask | undefined>;
+    emit(event: import("../events.js").TeamEvent): Promise<void>;
+    scheduleCoordinatorProcessing(): void;
+}
+/**
+ * Push an item onto the coordinator inbox and update the status listener
+ * with the new pending count.
+ */
+export declare function enqueueInboxItem(ctx: InboxContext, item: CoordinatorInboxItem): void;
+/**
+ * Convert a `CoordinatorNotification` into an inbox item and enqueue it.
+ * Only notification kinds that the coordinator should act on are accepted;
+ * others are silently dropped.
+ */
+export declare function enqueueNotification(ctx: InboxContext, notification: CoordinatorNotification): void;
+/**
+ * Request a drain of the coordinator inbox. If processing is already
+ * in progress, sets a reschedule flag so the processor loops.
+ */
+export declare function scheduleProcessing(ctx: InboxContext): void;
+/**
+ * Drain the coordinator inbox in a loop, running one coordinator turn
+ * per batch. Handles user-message priority, autonomous turn limiting,
+ * and reschedule logic.
+ *
+ * This function is the async equivalent of ccsource's
+ * `drainCommandQueue` + the between-turn wait loop in `print.ts`.
+ */
+export declare function processInbox(ctx: InboxContext): Promise<void>;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/team/coordinator/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../../src/team/coordinator/inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAE9B,MAAM,WAAW,CAAC;AAMnB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAMvC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,wDAAwD;IACxD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,sBAAsB,EAAE,MAAM,CAAC;IAG/B,sBAAsB,IAAI,KAAK,CAAC;IAChC,uBAAuB,IAAI,MAAM,CAAC;IAGlC,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;IAC3E,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjD,6BAA6B,IAAI,IAAI,CAAC;IAGtC,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAG7E,IAAI,CAAC,KAAK,EAAE,OAAO,cAAc,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7D,6BAA6B,IAAI,IAAI,CAAC;CACvC;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,oBAAoB,GACzB,IAAI,CAKN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,EACjB,YAAY,EAAE,uBAAuB,GACpC,IAAI,CAgBN;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAuB1D;AAMD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiOnE"}

package/dist/team/coordinator/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Coordinator — barrel re-exports
+ *
+ * All coordinator-related modules are organized under this folder.
+ * External consumers import from the team barrel (`../index.ts`),
+ * which re-exports the public surface from here.
+ *
+ * @module
+ */
+export { TeamCoordinator, createTeamCoordinator } from "./coordinator.js";
+export type { TeamCoordinatorConfig, QueueTaskInput, TaskCompletion, SynthesisResult, PlannedTask, TeamPlan, MemberRuntime, MemberStats, PermissionHandler, TaskExecutor, TaskExecutorInput, TaskDispatchMode, ExternalTaskControl, PreparedExternalTask, CoordinatorCtx, } from "./types.js";
+export { sleep } from "./types.js";
+export type { CoordinatorInboxItem, CoordinatorRuntimeStatus, CoordinatorLoopOptions, CoordinatorLoopResult, CoordinatorRound, CoordinatorStatus, WorkerReport, } from "./turn.js";
+export { MAX_CONSECUTIVE_TURNS, MAX_AUTONOMOUS_TURNS, enqueueInboxItem, enqueueNotification, scheduleProcessing, processInbox, type InboxContext, } from "./inbox.js";
+export { buildCoordinatorSystemPrompt, coordinatorToolDescriptions, formatCoordinatorTaskNotifications, formatCoordinatorWorkerReports, formatCoordinatorRoundMessage, type CoordinatorRosterMember, type CoordinatorTaskNotificationLike, type CoordinatorWorkerReportLike, } from "./policy.js";
+export { addTokenUsage, evaluateCoordinatorRoundTransition, type CoordinatorRoundTransitionInput, type CoordinatorRoundTransition, } from "./round-engine.js";
+export { planTasks, planAndExecuteTasks, parsePlanResponse, } from "./planning.js";
+export { synthesizeResults } from "./synthesis.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/team/coordinator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/team/coordinator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG1E,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EAClC,8BAA8B,EAC9B,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,kCAAkC,EAClC,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,GAChC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/team/coordinator/planning.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Coordinator Planning
+ *
+ * Uses the lead agent to decompose a user prompt into targeted
+ * per-member task assignments. Each member receives a self-contained
+ * prompt tailored to their role.
+ *
+ * @module
+ */
+import type { TeamCoordinator } from "./coordinator.js";
+import type { MemberRuntime, PlannedTask, TeamPlan } from "./types.js";
+import type { TeamTask } from "../types.js";
+/**
+ * Use the lead agent to decompose a user prompt into targeted
+ * per-member task assignments.
+ */
+export declare function planTasks(coordinator: TeamCoordinator, prompt: string, memberIds?: string[]): Promise<TeamPlan>;
+/**
+ * Plan + queue + dispatch in one call.
+ *
+ * Calls `planTasks()` to decompose the prompt, queues each planned task,
+ * then dispatches ready tasks. Returns the plan and queued task objects.
+ */
+export declare function planAndExecuteTasks(coordinator: TeamCoordinator, prompt: string, memberIds?: string[]): Promise<{
+    plan: TeamPlan;
+    tasks: TeamTask[];
+}>;
+/**
+ * Parse the lead agent's planning response into PlannedTask[].
+ * Falls back to assigning the original prompt to all targets on parse failure.
+ */
+export declare function parsePlanResponse(response: string, originalPrompt: string, targets: MemberRuntime[]): PlannedTask[];
+//# sourceMappingURL=planning.d.ts.map

package/dist/team/coordinator/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../src/team/coordinator/planning.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,QAAQ,CAAC,CAmDnB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAuChD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,aAAa,EAAE,GACvB,WAAW,EAAE,CA+Df"}

package/dist/team/coordinator/policy.d.ts

@@ -0,0 +1,31 @@
+import type { TaskResult } from "../types.js";
+export interface CoordinatorRosterMember {
+    id: string;
+    role: string;
+    description?: string;
+}
+export interface CoordinatorTaskNotificationLike {
+    taskId: string;
+    memberId: string;
+    title: string;
+    status: string;
+    result?: TaskResult;
+    error?: string;
+}
+export interface CoordinatorWorkerReportLike {
+    messageId?: string;
+    memberId: string;
+    taskId?: string;
+    createdAt?: string;
+    message: string;
+}
+export declare const coordinatorToolDescriptions: {
+    readonly assignTask: (memberList: string) => string;
+    readonly sendMessage: string;
+    readonly abortTask: string;
+};
+export declare function buildCoordinatorSystemPrompt(members: CoordinatorRosterMember[]): string;
+export declare function formatCoordinatorTaskNotifications(notifications: CoordinatorTaskNotificationLike[]): string;
+export declare function formatCoordinatorWorkerReports(reports: CoordinatorWorkerReportLike[]): string;
+export declare function formatCoordinatorRoundMessage(notifications: CoordinatorTaskNotificationLike[], reports: CoordinatorWorkerReportLike[]): string;
+//# sourceMappingURL=policy.d.ts.map

package/dist/team/coordinator/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/team/coordinator/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,2BAA2B;sCACf,MAAM,KAAG,MAAM;;;CAc9B,CAAC;AAEX,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,uBAAuB,EAAE,GACjC,MAAM,CA2CR;AAED,wBAAgB,kCAAkC,CAChD,aAAa,EAAE,+BAA+B,EAAE,GAC/C,MAAM,CA4BR;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,2BAA2B,EAAE,GACrC,MAAM,CAYR;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,+BAA+B,EAAE,EAChD,OAAO,EAAE,2BAA2B,EAAE,GACrC,MAAM,CAOR"}

package/dist/team/coordinator/round-engine.d.ts

@@ -0,0 +1,25 @@
+import type { TokenUsage } from "../../types/messages.js";
+import type { CoordinatorTaskNotificationLike, CoordinatorWorkerReportLike } from "./policy.js";
+export interface CoordinatorRoundTransitionInput {
+    reasonAssignmentsCount: number;
+    activeTaskCount: number;
+    terminalAfterEvent: boolean;
+    notifications: CoordinatorTaskNotificationLike[];
+    reports: CoordinatorWorkerReportLike[];
+    reasonResponse: string;
+    roundResponse: string;
+    blockedMessage: string;
+}
+export type CoordinatorRoundTransition = {
+    kind: "done";
+    finalResponse: string;
+} | {
+    kind: "wait";
+    nextMessage: string;
+} | {
+    kind: "continue";
+    nextMessage: string;
+};
+export declare function addTokenUsage(total: TokenUsage, usage?: TokenUsage): TokenUsage;
+export declare function evaluateCoordinatorRoundTransition(input: CoordinatorRoundTransitionInput): CoordinatorRoundTransition;
+//# sourceMappingURL=round-engine.d.ts.map

package/dist/team/coordinator/round-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-engine.d.ts","sourceRoot":"","sources":["../../../src/team/coordinator/round-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EACV,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,+BAA+B;IAC9C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,+BAA+B,EAAE,CAAC;IACjD,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,0BAA0B,GAClC;IACE,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,UAAU,GACjB,UAAU,CAMZ;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,+BAA+B,GACrC,0BAA0B,CAmD5B"}

package/dist/team/coordinator/synthesis.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Coordinator Synthesis
+ *
+ * Uses the lead agent to synthesize all completed task results
+ * into a single coherent response.
+ *
+ * @module
+ */
+import type { TeamCoordinator } from "./coordinator.js";
+import type { SynthesisResult } from "./types.js";
+/**
+ * Use the lead agent to synthesize all completed task results
+ * into a single coherent response.
+ *
+ * @param coordinator     - Team coordinator instance
+ * @param originalPrompt  - The original task/prompt
+ * @param taskIds         - Optional subset of task IDs to synthesize (defaults to all terminal tasks)
+ */
+export declare function synthesizeResults(coordinator: TeamCoordinator, originalPrompt: string, taskIds?: string[]): Promise<SynthesisResult>;
+//# sourceMappingURL=synthesis.d.ts.map

package/dist/team/coordinator/synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.d.ts","sourceRoot":"","sources":["../../../src/team/coordinator/synthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,eAAe,EAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,eAAe,CAAC,CA4C1B"}