@cuylabs/agent-core 4.8.1 → 4.10.0

package/dist/team/index.d.ts

@@ -1,546 +1,24 @@
-import { aI as CoordinatorNotification, d3 as TaskCompletion, du as TokenUsage, A as AgentEvent, e4 as CoordinatorCtx, C as Agent, bF as MemberRuntime, d0 as TaskBoard, bB as Mailbox, d7 as TaskDispatchMode, c2 as PermissionHandler, dh as TeamCoordinatorConfig, d8 as TaskExecutor, di as TeamEvent, dj as TeamMember, cf as QueueTaskInput, dr as TeamTask, dk as TeamMessage, dm as TeamPlan, cY as SynthesisResult, dn as TeamSnapshot, db as TaskListFilter, bO as MessageListFilter, ca as PreparedExternalTask, dc as TaskResult, de as TaskTransition, bG as MemberStats, bH as MemberStatus, N as AgentMiddleware, dv as ToolCallDecision } from '../instance-Bg61WSyz.js';
-export { aJ as CoordinatorNotificationKind, aK as CoordinatorRoundEvent, be as ExternalTaskControl, bg as GuidancePayload, bt as IdleNotificationPayload, bu as InMemoryMailboxStore, bv as InMemoryTaskBoardStore, bC as MailboxStore, bD as MailboxSubscriber, bE as MemberRegisteredEvent, bI as MemberStatusChangedEvent, bM as MessageInput, bN as MessageKind, bP as MessagePayload, bR as MessageSentEvent, bX as NotificationPriority, c1 as PermissionForwardedEvent, c3 as PermissionRequestPayload, c4 as PermissionResolvedEvent, c5 as PermissionResponsePayload, c6 as PlanCreatedEvent, c7 as PlannedTask, cz as ShutdownRequestPayload, cA as ShutdownRequestedEvent, cB as ShutdownResolvedEvent, cC as ShutdownResponsePayload, cX as SynthesisCompleteEvent, c_ as TERMINAL_STATUSES, c$ as TaskAbortedEvent, d1 as TaskBoardStore, d2 as TaskCompletedEvent, d4 as TaskConflictError, d5 as TaskCreateInput, d6 as TaskCreatedEvent, d9 as TaskExecutorInput, da as TaskFailedEvent, dd as TaskStatus, df as TaskTransitionEvent, dg as TaskTransitionReason, dl as TeamNotificationEvent, dp as TeamStartedEvent, dq as TeamStoppedEvent, dJ as WorkerReportPayload, dN as buildCoordinatorNotificationEvent } from '../instance-Bg61WSyz.js';
-import { R as ReasoningLevel } from '../types-CQaXbRsS.js';
-import '../types-C_LCeYNg.js';
-import 'ai';
-import '../types-RSCv7nQ4.js';
-import 'zod';
-import '../types-DMjoFKKv.js';
-import '@modelcontextprotocol/sdk/client/auth.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '@ai-sdk/provider-utils';
-import '../sandbox/index.js';
-import '../llm-error-D93FNNLY.js';
-
-interface CoordinatorInboxItem {
-    id: string;
-    kind: "user-message" | "notification";
-    createdAt: string;
-    body: string;
-    notification?: CoordinatorNotification;
-}
-interface CoordinatorRuntimeStatus {
-    phase: "ready" | "running" | "waiting" | "error";
-    message: string;
-    pendingInboxCount: number;
-    activeTaskCount: number;
-}
-interface CoordinatorStatus {
-    phase: "thinking" | "waiting" | "done";
-    round: number;
-    message: string;
-}
-interface WorkerReport {
-    messageId: string;
-    memberId: string;
-    taskId?: string;
-    createdAt?: string;
-    message: string;
-}
-interface CoordinatorRound {
-    number: number;
-    assigned: Array<{
-        taskId: string;
-        memberId: string;
-        title: string;
-    }>;
-    messaged: Array<{
-        memberId: string;
-    }>;
-    stopped: string[];
-    completions: TaskCompletion[];
-    reports: WorkerReport[];
-    response: string;
-    usage: TokenUsage;
-}
-interface CoordinatorLoopOptions {
-    maxRounds?: number;
-    waitTimeoutMs?: number;
-    onRound?: (round: CoordinatorRound) => void | Promise<void>;
-    onStatus?: (status: CoordinatorStatus) => void;
-    onCoordinatorEvent?: (event: AgentEvent) => void;
-    onLog?: (message: string) => void;
-    coordinatorReasoningLevel?: ReasoningLevel;
-}
-interface CoordinatorLoopResult {
-    response: string;
-    rounds: CoordinatorRound[];
-    usage: TokenUsage;
-}
-
 /**
- * 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
- */
-
-/**
- * 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();
- * ```
- */
-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),
- * });
- * ```
- */
-declare function createTeamCoordinator(config: TeamCoordinatorConfig): TeamCoordinator;
-
-/**
- * Team Permission Policy
- *
- * Extends the existing approval middleware to support team-wide
- * permission delegation. When a coordinator creates team members,
- * it can install a `teamPermissionPolicy` middleware that:
- *
- * 1. Applies team-wide allow/deny rules to all member tool calls
- * 2. Forwards unresolved approvals to the coordinator (lead agent)
- * 3. Propagates "remember" decisions to all team members
- *
- * This is layered ON TOP of the existing `approvalMiddleware` —
- * it doesn't replace it. Members inherit the lead's approval rules
- * via fork(), and the team policy adds team-specific delegation.
- *
- * Design choices vs ccsource:
- * - No filesystem polling for permission responses — uses callbacks
- * - No separate sandbox permission path — uses standard approval pipeline
- * - Team rules are typed objects, not mailbox message payloads
- * - Integrates with existing `beforeToolCall` middleware contract
- */
-
-/**
- * A team-wide permission rule.
- *
- * Rules are evaluated in order — first match wins.
- */
-interface TeamPermissionRule {
-    /** Tool name to match (exact or glob-style with `*`) */
-    tool: string;
-    /** Optional approval pattern to match against the tool input */
-    pattern?: string;
-    /** Member IDs this rule applies to (undefined = all members) */
-    members?: string[];
-    /** Whether to allow or deny */
-    action: "allow" | "deny";
-    /** Optional reason (shown to model on deny) */
-    reason?: string;
-}
-/**
- * Callback for forwarding approval requests to the coordinator.
- * Returns the coordinator's decision.
- */
-type ApprovalForwarder = (memberId: string, tool: string, args: unknown, ctx: Parameters<NonNullable<AgentMiddleware["beforeToolCall"]>>[2]) => Promise<ToolCallDecision>;
-/**
- * Configuration for the team permission policy middleware.
- */
-interface TeamPermissionPolicyConfig {
-    /** The member ID this middleware is installed on */
-    memberId: string;
-    /** Team-wide rules (evaluated first, before forwarding) */
-    rules?: TeamPermissionRule[];
-    /**
-     * Forward unresolved approvals to this callback.
-     * If not provided, unresolved tools are allowed (fall through
-     * to the member's own approval middleware).
-     */
-    forwardApproval?: ApprovalForwarder;
-    /**
-     * Callback when a "remember" decision is made — the coordinator
-     * can propagate it to all members by updating their rule sets.
-     */
-    onRemember?: (rule: TeamPermissionRule) => void | Promise<void>;
-}
-/**
- * Create a team permission policy middleware.
- *
- * Install this on forked member agents to enforce team-wide
- * permission rules and optionally forward approvals to the
- * coordinator.
- *
- * ```typescript
- * const memberAgent = lead.fork({
- *   name: "explorer",
- *   additionalMiddleware: [
- *     teamPermissionPolicy({
- *       memberId: "explorer",
- *       rules: [
- *         { tool: "read_*", action: "allow" },
- *         { tool: "write_*", action: "deny", reason: "Explorer is read-only" },
- *       ],
- *     }),
- *   ],
- * });
- * ```
- */
-declare function teamPermissionPolicy(config: TeamPermissionPolicyConfig): AgentMiddleware;
-
-interface CoordinatorRosterMember {
-    id: string;
-    role: string;
-    description?: string;
-}
-interface CoordinatorTaskNotificationLike {
-    taskId: string;
-    memberId: string;
-    title: string;
-    status: string;
-    result?: TaskResult;
-    error?: string;
-}
-interface CoordinatorWorkerReportLike {
-    messageId?: string;
-    memberId: string;
-    taskId?: string;
-    createdAt?: string;
-    message: string;
-}
-declare const coordinatorToolDescriptions: {
-    readonly assignTask: (memberList: string) => string;
-    readonly sendMessage: string;
-    readonly abortTask: string;
-};
-declare function buildCoordinatorSystemPrompt(members: CoordinatorRosterMember[]): string;
-declare function formatCoordinatorTaskNotifications(notifications: CoordinatorTaskNotificationLike[]): string;
-declare function formatCoordinatorWorkerReports(reports: CoordinatorWorkerReportLike[]): string;
-declare function formatCoordinatorRoundMessage(notifications: CoordinatorTaskNotificationLike[], reports: CoordinatorWorkerReportLike[]): string;
-
-interface CoordinatorRoundTransitionInput {
-    reasonAssignmentsCount: number;
-    activeTaskCount: number;
-    terminalAfterEvent: boolean;
-    notifications: CoordinatorTaskNotificationLike[];
-    reports: CoordinatorWorkerReportLike[];
-    reasonResponse: string;
-    roundResponse: string;
-    blockedMessage: string;
-}
-type CoordinatorRoundTransition = {
-    kind: "done";
-    finalResponse: string;
-} | {
-    kind: "wait";
-    nextMessage: string;
-} | {
-    kind: "continue";
-    nextMessage: string;
-};
-declare function addTokenUsage(total: TokenUsage, usage?: TokenUsage): TokenUsage;
-declare function evaluateCoordinatorRoundTransition(input: CoordinatorRoundTransitionInput): CoordinatorRoundTransition;
-
-export { type ApprovalForwarder, type CoordinatorInboxItem, type CoordinatorLoopOptions, type CoordinatorLoopResult, CoordinatorNotification, type CoordinatorRosterMember, type CoordinatorRound, type CoordinatorRoundTransition, type CoordinatorRoundTransitionInput, type CoordinatorRuntimeStatus, type CoordinatorStatus, type CoordinatorTaskNotificationLike, type CoordinatorWorkerReportLike, Mailbox, MemberRuntime, MemberStats, MemberStatus, MessageListFilter, PermissionHandler, PreparedExternalTask, QueueTaskInput, SynthesisResult, TaskBoard, TaskCompletion, TaskDispatchMode, TaskExecutor, TaskListFilter, TaskResult, TaskTransition, TeamCoordinator, TeamCoordinatorConfig, TeamEvent, TeamMember, TeamMessage, type TeamPermissionPolicyConfig, type TeamPermissionRule, TeamPlan, TeamSnapshot, TeamTask, type WorkerReport, addTokenUsage, buildCoordinatorSystemPrompt, coordinatorToolDescriptions, createTeamCoordinator, evaluateCoordinatorRoundTransition, formatCoordinatorRoundMessage, formatCoordinatorTaskNotifications, formatCoordinatorWorkerReports, teamPermissionPolicy };
+ * Team — Multi-agent coordination for @cuylabs/agent-core
+ *
+ * Available via:
+ *   import { createTeamCoordinator, TaskBoard, Mailbox } from "@cuylabs/agent-core";
+ *   import { ... } from "@cuylabs/agent-core/team";
+ *
+ * @module
+ */
+export type { MemberStatus, MessageKind, MessagePayload, ShutdownRequestPayload, ShutdownResponsePayload, PermissionRequestPayload, PermissionResponsePayload, IdleNotificationPayload, GuidancePayload, WorkerReportPayload, TaskResult, TaskStatus, TaskTransition, TaskTransitionReason, TeamMember, TeamMessage, TeamSnapshot, TeamTask, } from "./types.js";
+export { TERMINAL_STATUSES } from "./types.js";
+export { TaskBoard, InMemoryTaskBoardStore, TaskConflictError, type TaskBoardStore, type TaskCreateInput, type TaskListFilter, } from "./task-board.js";
+export { Mailbox, InMemoryMailboxStore, type MailboxStore, type MailboxSubscriber, type MessageInput, type MessageListFilter, } from "./mailbox.js";
+export { TeamCoordinator, createTeamCoordinator, } from "./coordinator/coordinator.js";
+export type { TeamCoordinatorConfig, QueueTaskInput, TaskCompletion, SynthesisResult, PlannedTask, TeamPlan, MemberRuntime, MemberStats, PermissionHandler, TaskExecutor, TaskDispatchMode, ExternalTaskControl, PreparedExternalTask, TaskExecutorInput, } from "./coordinator/types.js";
+export type { CoordinatorLoopOptions, CoordinatorLoopResult, CoordinatorRound, CoordinatorStatus, WorkerReport, } from "./coordinator/turn.js";
+export { teamPermissionPolicy, type TeamPermissionPolicyConfig, type TeamPermissionRule, type ApprovalForwarder, } from "./permissions.js";
+export type { TeamEvent, TeamStartedEvent, TeamStoppedEvent, MemberRegisteredEvent, MemberStatusChangedEvent, PlanCreatedEvent, CoordinatorRoundEvent, TaskCreatedEvent, TaskTransitionEvent, TaskCompletedEvent, TaskFailedEvent, TaskAbortedEvent, MessageSentEvent, SynthesisCompleteEvent, ShutdownRequestedEvent, ShutdownResolvedEvent, PermissionForwardedEvent, PermissionResolvedEvent, TeamNotificationEvent, } from "./events.js";
+export type { NotificationPriority, CoordinatorNotificationKind, CoordinatorNotification, } from "./notifications.js";
+export { buildCoordinatorNotificationEvent } from "./notifications.js";
+export type { CoordinatorInboxItem, CoordinatorRuntimeStatus, } from "./coordinator/turn.js";
+export { buildCoordinatorSystemPrompt, coordinatorToolDescriptions, formatCoordinatorTaskNotifications, formatCoordinatorWorkerReports, formatCoordinatorRoundMessage, type CoordinatorRosterMember, type CoordinatorTaskNotificationLike, type CoordinatorWorkerReportLike, } from "./coordinator/policy.js";
+export { addTokenUsage, evaluateCoordinatorRoundTransition, type CoordinatorRoundTransitionInput, type CoordinatorRoundTransition, } from "./coordinator/round-engine.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/team/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EACV,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EAClC,8BAA8B,EAC9B,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,kCAAkC,EAClC,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,GAChC,MAAM,+BAA+B,CAAC"}

package/dist/team/index.js

@@ -16,9 +16,9 @@ import {
   formatCoordinatorTaskNotifications,
   formatCoordinatorWorkerReports,
   teamPermissionPolicy
-} from "../chunk-QJV5XPPS.js";
+} from "../chunk-UEEHZ4QH.js";
 import "../chunk-SZ2XBPTW.js";
-import "../chunk-Q742PSH3.js";
+import "../chunk-MJML3A2F.js";
 import "../chunk-FII65CN7.js";
 export {
   InMemoryMailboxStore,

package/dist/team/mailbox.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Team Mailbox
+ *
+ * Typed message bus for intra-team communication.
+ *
+ * `MailboxStore` is the persistence contract. `Mailbox` wraps it with
+ * input normalization, auto-derived kind, subscriber fan-out, and
+ * defensive cloning. Hosts swap in whatever store fits their deployment
+ * (in-memory for single-process, Redis/DB for distributed teams).
+ *
+ * Design choices:
+ * - Messages are immutable once sent — no edits, no deletes
+ * - Subscribers are notified via Promise.allSettled (one failure ≠ all fail)
+ * - `from` / `to` instead of `senderId` / `recipientId` (more readable)
+ * - `teamId` scoped filters so one store can serve multiple teams
+ */
+import type { MessageKind, MessagePayload, TeamMessage } from "./types.js";
+/**
+ * Filter options for listing messages.
+ */
+export interface MessageListFilter {
+    teamId?: string;
+    from?: string;
+    to?: string;
+    taskId?: string;
+    kind?: MessageKind | MessageKind[];
+    limit?: number;
+}
+/**
+ * Input for sending a new message.
+ */
+export interface MessageInput {
+    /** Optional ID (auto-generated if omitted) */
+    id?: string;
+    teamId: string;
+    from: string;
+    to?: string;
+    kind?: MessageKind;
+    body: string;
+    payload?: MessagePayload;
+    taskId?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Subscriber callback — invoked when a new message is sent.
+ */
+export type MailboxSubscriber = (message: TeamMessage) => void | Promise<void>;
+/**
+ * Persistence contract for team messages.
+ */
+export interface MailboxStore {
+    start?(): Promise<void>;
+    stop?(): Promise<void>;
+    append(message: TeamMessage): Promise<TeamMessage>;
+    list(filter?: MessageListFilter): Promise<TeamMessage[]>;
+}
+/**
+ * Simple in-memory store — suitable for single-process teams.
+ */
+export declare class InMemoryMailboxStore implements MailboxStore {
+    private readonly messages;
+    append(message: TeamMessage): Promise<TeamMessage>;
+    list(filter?: MessageListFilter): Promise<TeamMessage[]>;
+}
+/**
+ * Team mailbox — typed message bus with subscriber notifications.
+ */
+export declare class Mailbox {
+    private readonly store;
+    private readonly subscribers;
+    private readonly createId;
+    constructor(options?: {
+        store?: MailboxStore;
+        createId?: () => string;
+    });
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Send a message. Notifies subscribers after persistence.
+     */
+    send(input: MessageInput): Promise<TeamMessage>;
+    /**
+     * List messages matching the filter.
+     */
+    list(filter?: MessageListFilter): Promise<TeamMessage[]>;
+    /**
+     * Subscribe to new messages. Returns an unsubscribe function.
+     */
+    subscribe(subscriber: MailboxSubscriber): () => void;
+}
+//# sourceMappingURL=mailbox.d.ts.map