@elizaos/plugin-agent-orchestrator 2.0.0-beta.1 → 2.0.3-beta.3

package/dist/node/src/actions/common.d.ts

@@ -12,8 +12,14 @@ export interface AcpActionService {
     sendKeysToSession(sessionId: string, keys?: string): Promise<void>;
     stopSession(sessionId: string, force?: boolean): Promise<void>;
     cancelSession?(sessionId: string): Promise<void>;
+    getSessionOutput?(sessionId: string, lines?: number): Promise<string>;
     listSessions(): SessionInfo[] | Promise<SessionInfo[]>;
     getSession(sessionId: string): SessionInfo | undefined | Promise<SessionInfo | null | undefined>;
+    findResumableSessionByLabel?(label: string, workdir: string): Promise<SessionInfo | undefined>;
+    resumeOrphanedBusySessions?(): Promise<{
+        resumed: number;
+        skipped: number;
+    }>;
     resolveAgentType?(selection?: Record<string, unknown>): Promise<string> | string;
     checkAvailableAgents?(types?: string[]): Promise<AvailableAgentInfo[]>;
     getAvailableAgents?(): Promise<AvailableAgentInfo[]>;
@@ -25,20 +31,72 @@ export type HandlerOptionsLike = {
     parameters?: Record<string, unknown>;
 } | Record<string, unknown>;
 export declare function getAcpService(runtime: IAgentRuntime): AcpActionService | undefined;
-export declare function logger(runtime: IAgentRuntime): import("@elizaos/core").Logger;
+export declare function logger(runtime: IAgentRuntime): IAgentRuntime["logger"];
 export declare function contentRecord(message: Memory): Record<string, unknown>;
 export declare function paramsRecord(options?: HandlerOptionsLike): Record<string, unknown>;
 export declare function pickString(params: Record<string, unknown>, content: Record<string, unknown>, name: string): string | undefined;
 export declare function pickBoolean(params: Record<string, unknown>, content: Record<string, unknown>, name: string): boolean | undefined;
-export declare function pickNumber(params: Record<string, unknown>, content: Record<string, unknown>, name: string): number | undefined;
 export declare function messageText(message: Memory): string;
+/**
+ * Resolve the genuine originating user request for workdir-route matching.
+ *
+ * Workdir routes (`TASK_AGENT_WORKDIR_ROUTES`) match keyword phrases like
+ * "web page" against `${userRequest}\n${task}`. Feeding only the planner's
+ * `task` argument is unreliable: with a verbose planner (gpt-oss /
+ * TASKS_CREATE) the user's wording survives, but with a terser planner
+ * (claude / TASKS_SPAWN_AGENT) the action arrives with the planner's
+ * rephrasing — and the orchestrator's `messageText()` only reads
+ * `content.text`, which may be envelope-wrapped or empty — dropping the route
+ * keyword and silently falling the spawn back to the default ACP workspace.
+ * Builds then land in the wrong directory and never get hosted.
+ *
+ * The fix is planner-independent and reads only sources that are guaranteed
+ * populated synchronously at action time (no DB round-trip, no persistence
+ * race — the failure mode of the earlier `getMemories`-first attempt):
+ *   1. the message's own `content.currentMessageText` (the raw human request
+ *      the connector stamped), via `userRequestFromMessage`;
+ *   2. the newest non-agent message in the state-composed conversation window
+ *      (`state.data.providers.RECENT_MESSAGES.data.recentMessages`) — covers
+ *      the case where the action message is a synthetic re-plan trigger but
+ *      the user's original request is still in the dialogue;
+ *   3. a bounded `getMemories` read, kept ONLY as a last resort.
+ *
+ * Fail-open: every source is optional and the result is unioned with the
+ * action's own text, so routing never regresses below today's behavior.
+ */
+export declare function resolveOriginatingRequestText(runtime: IAgentRuntime, message: Memory, state?: State, opts?: {
+    timeoutMs?: number;
+    scanLimit?: number;
+}): Promise<string>;
 export declare function hasExplicitPayload(message: Memory, fields: string[]): boolean;
-export declare function looksLikeTaskAgentRequest(text: string): boolean;
 export declare function shortId(id: string): string;
 export declare function labelFor(session: Pick<SessionInfo, "id" | "name" | "metadata">): string;
 export declare function newestSession(sessions: SessionInfo[]): SessionInfo | undefined;
 export declare function listSessionsWithin(service: AcpActionService, timeoutMs?: number): Promise<SessionInfo[]>;
-export declare function validateHasSessions(runtime: IAgentRuntime): Promise<boolean>;
+/**
+ * Block until the number of in-flight sub-agent sessions drops below the
+ * configured ceiling, so concurrent spawns don't stampede the model
+ * provider.
+ *
+ * Why this exists: coding sub-agents (opencode + gpt-oss-class models on
+ * Cerebras / other OpenAI-compatible providers) degrade hard under
+ * concurrent load — the provider rate-limits, and the model responds by
+ * silently skipping its Write/tool calls and "completing" with a text-only
+ * answer. One build at a time succeeds; four at once produces one good
+ * build and three empty workdirs. Serialising spawns past a small ceiling
+ * trades a little latency for builds that actually land.
+ *
+ * Bounded and self-correcting: it polls real session state (no permits to
+ * leak), and gives up waiting after `maxWaitMs` so a wedged session can
+ * never deadlock the queue — the spawn just proceeds.
+ *
+ * Tunable via `ELIZA_MAX_CONCURRENT_SPAWNS` (default 2). Set to 0 or a
+ * negative value to disable the gate entirely.
+ */
+export declare function waitForSpawnSlot(runtime: IAgentRuntime, service: AcpActionService, opts?: {
+    maxWaitMs?: number;
+    pollMs?: number;
+}): Promise<void>;
 export declare function callbackText(callback: HandlerCallback | undefined, text: string): Promise<void>;
 export declare function errorResult(error: string, text?: string): ActionResult;
 export declare function resolveSession(service: AcpActionService, sessionId: string | undefined, state?: State): Promise<{

package/dist/node/src/actions/common.d.ts.map

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

package/dist/node/src/actions/elizaos-capability.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "@elizaos/core";
+export declare const elizaOsCapabilityAction: Action;
+//# sourceMappingURL=elizaos-capability.d.ts.map

package/dist/node/src/actions/elizaos-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elizaos-capability.d.ts","sourceRoot":"","sources":["../../../../src/actions/elizaos-capability.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AA4HvB,eAAO,MAAM,uBAAuB,EAAE,MA2ErC,CAAC"}

package/dist/node/src/actions/sandbox-stub.d.ts

@@ -1,21 +1,25 @@
 /**
- * Sandbox-build stub for the TASKS coding-agent surface.
+ * Sandbox-build fallback for the TASKS coding-agent surface.
  *
  * Store-distributed builds (Mac App Store, Microsoft Store, Flathub) run in
  * an OS sandbox that forbids forking arbitrary user-installed binaries. The
- * orchestrator's spawn paths (claude / codex / opencode CLIs via PTY) are
+ * orchestrator's spawn paths (claude / codex / opencode CLIs via ACP) are
  * therefore not viable in those builds, so we replace the TASKS action with
- * a single stub that explains the limitation and points the user at the
+ * a single unavailable action that explains the limitation and points the user at the
  * direct-download artifact.
  *
  * Behavior:
- *   - validate(): always true — we want this stub to win whenever the
+ *   - validate(): always true — we want this action to win whenever the
  *     planner reaches for any coding-agent simile under sandbox.
  *   - handler(): returns a single user-facing error result; no spawn
- *     attempt, no workspace allocation, no PTY.
+ *     attempt, no workspace allocation, no subprocess session.
  */
 import type { Action } from "@elizaos/core";
+import type { OrchestratorTerminalSupport } from "../services/terminal-capabilities.js";
 export declare const tasksSandboxStubAction: Action & {
     suppressPostActionContinuation: true;
 };
+export declare function createTerminalUnsupportedTasksAction(support: OrchestratorTerminalSupport): Action & {
+    suppressPostActionContinuation: true;
+};
 //# sourceMappingURL=sandbox-stub.d.ts.map

package/dist/node/src/actions/sandbox-stub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox-stub.d.ts","sourceRoot":"","sources":["../../../../src/actions/sandbox-stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,eAAe,CAAC;AAKvB,eAAO,MAAM,sBAAsB,EAAE,MAAM,GAAG;IAC5C,8BAA8B,EAAE,IAAI,CAAC;CAwEtC,CAAC"}
+{"version":3,"file":"sandbox-stub.d.ts","sourceRoot":"","sources":["../../../../src/actions/sandbox-stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAoGxF,eAAO,MAAM,sBAAsB,EAAE,MAAM,GAAG;IAC5C,8BAA8B,EAAE,IAAI,CAAC;CAMrC,CAAC;AAEH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,2BAA2B,GACnC,MAAM,GAAG;IAAE,8BAA8B,EAAE,IAAI,CAAA;CAAE,CAenD"}

package/dist/node/src/actions/tasks.d.ts

@@ -3,10 +3,10 @@
  * task-agent lifecycle, workspace lifecycle, GitHub issue management, and
  * coding-task archive/reopen surface.
  *
- * Old leaf actions live as similes; their handlers were folded into per-op
+ * Old leaf actions live as similes; their handlers were folded into per-action
  * runners on this file.
  *
- * Ops:
+ * Actions:
  *   create               — CREATE_AGENT_TASK / START_CODING_TASK
  *   spawn_agent          — SPAWN_AGENT
  *   send                 — SEND_TO_AGENT
@@ -27,62 +27,82 @@
 import type { Action } from "@elizaos/core";
 export declare const tasksAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const createTaskAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const startCodingTaskAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const spawnAgentAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const spawnTaskAgentAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const sendToAgentAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const sendToTaskAgentAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const stopAgentAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const stopTaskAgentAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const listAgentsAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const listTaskAgentsAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const cancelTaskAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const taskHistoryAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const taskControlAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const taskShareAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const provisionWorkspaceAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const finalizeWorkspaceAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const manageIssuesAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const archiveCodingTaskAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 export declare const reopenCodingTaskAction: Action & {
     suppressPostActionContinuation: true;
+    suppressEarlyReply: true;
 };
 //# sourceMappingURL=tasks.d.ts.map

package/dist/node/src/actions/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../src/actions/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAg+DvB,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IAAE,8BAA8B,EAAE,IAAI,CAAA;CAwlBxE,CAAC;AAGF,eAAO,MAAM,gBAAgB;oCA3lBwC,IAAI;CA2lB9B,CAAC;AAC5C,eAAO,MAAM,qBAAqB;oCA5lBmC,IAAI;CA4lBzB,CAAC;AACjD,eAAO,MAAM,gBAAgB;oCA7lBwC,IAAI;CA6lB9B,CAAC;AAC5C,eAAO,MAAM,oBAAoB;oCA9lBoC,IAAI;CA8lB1B,CAAC;AAChD,eAAO,MAAM,iBAAiB;oCA/lBuC,IAAI;CA+lB7B,CAAC;AAC7C,eAAO,MAAM,qBAAqB;oCAhmBmC,IAAI;CAgmBzB,CAAC;AACjD,eAAO,MAAM,eAAe;oCAjmByC,IAAI;CAimB/B,CAAC;AAC3C,eAAO,MAAM,mBAAmB;oCAlmBqC,IAAI;CAkmB3B,CAAC;AAC/C,eAAO,MAAM,gBAAgB;oCAnmBwC,IAAI;CAmmB9B,CAAC;AAC5C,eAAO,MAAM,oBAAoB;oCApmBoC,IAAI;CAomB1B,CAAC;AAChD,eAAO,MAAM,gBAAgB;oCArmBwC,IAAI;CAqmB9B,CAAC;AAC5C,eAAO,MAAM,iBAAiB;oCAtmBuC,IAAI;CAsmB7B,CAAC;AAC7C,eAAO,MAAM,iBAAiB;oCAvmBuC,IAAI;CAumB7B,CAAC;AAC7C,eAAO,MAAM,eAAe;oCAxmByC,IAAI;CAwmB/B,CAAC;AAC3C,eAAO,MAAM,wBAAwB;oCAzmBgC,IAAI;CAymBtB,CAAC;AACpD,eAAO,MAAM,uBAAuB;oCA1mBiC,IAAI;CA0mBvB,CAAC;AACnD,eAAO,MAAM,kBAAkB;oCA3mBsC,IAAI;CA2mB5B,CAAC;AAC9C,eAAO,MAAM,uBAAuB;oCA5mBiC,IAAI;CA4mBvB,CAAC;AACnD,eAAO,MAAM,sBAAsB;oCA7mBkC,IAAI;CA6mBxB,CAAC"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../../src/actions/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AA29EvB,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IACjC,8BAA8B,EAAE,IAAI,CAAC;IACrC,kBAAkB,EAAE,IAAI,CAAC;CA2zB1B,CAAC;AAGF,eAAO,MAAM,gBAAgB;oCA/zBK,IAAI;wBAChB,IAAI;CA8zBiB,CAAC;AAC5C,eAAO,MAAM,qBAAqB;oCAh0BA,IAAI;wBAChB,IAAI;CA+zBsB,CAAC;AACjD,eAAO,MAAM,gBAAgB;oCAj0BK,IAAI;wBAChB,IAAI;CAg0BiB,CAAC;AAC5C,eAAO,MAAM,oBAAoB;oCAl0BC,IAAI;wBAChB,IAAI;CAi0BqB,CAAC;AAChD,eAAO,MAAM,iBAAiB;oCAn0BI,IAAI;wBAChB,IAAI;CAk0BkB,CAAC;AAC7C,eAAO,MAAM,qBAAqB;oCAp0BA,IAAI;wBAChB,IAAI;CAm0BsB,CAAC;AACjD,eAAO,MAAM,eAAe;oCAr0BM,IAAI;wBAChB,IAAI;CAo0BgB,CAAC;AAC3C,eAAO,MAAM,mBAAmB;oCAt0BE,IAAI;wBAChB,IAAI;CAq0BoB,CAAC;AAC/C,eAAO,MAAM,gBAAgB;oCAv0BK,IAAI;wBAChB,IAAI;CAs0BiB,CAAC;AAC5C,eAAO,MAAM,oBAAoB;oCAx0BC,IAAI;wBAChB,IAAI;CAu0BqB,CAAC;AAChD,eAAO,MAAM,gBAAgB;oCAz0BK,IAAI;wBAChB,IAAI;CAw0BiB,CAAC;AAC5C,eAAO,MAAM,iBAAiB;oCA10BI,IAAI;wBAChB,IAAI;CAy0BkB,CAAC;AAC7C,eAAO,MAAM,iBAAiB;oCA30BI,IAAI;wBAChB,IAAI;CA00BkB,CAAC;AAC7C,eAAO,MAAM,eAAe;oCA50BM,IAAI;wBAChB,IAAI;CA20BgB,CAAC;AAC3C,eAAO,MAAM,wBAAwB;oCA70BH,IAAI;wBAChB,IAAI;CA40ByB,CAAC;AACpD,eAAO,MAAM,uBAAuB;oCA90BF,IAAI;wBAChB,IAAI;CA60BwB,CAAC;AACnD,eAAO,MAAM,kBAAkB;oCA/0BG,IAAI;wBAChB,IAAI;CA80BmB,CAAC;AAC9C,eAAO,MAAM,uBAAuB;oCAh1BF,IAAI;wBAChB,IAAI;CA+0BwB,CAAC;AACnD,eAAO,MAAM,sBAAsB;oCAj1BD,IAAI;wBAChB,IAAI;CAg1BuB,CAAC"}

package/dist/node/src/api/agent-routes.d.ts

@@ -1,7 +1,7 @@
 /**
  * Task Agent Route Handlers
  *
- * Handles routes for PTY-based task-agent management:
+ * Handles routes for ACP-based task-agent management:
  * - Preflight checks, metrics, workspace files
  * - Approval presets and config
  * - Agent CRUD: list, spawn, get, send, stop, output

package/dist/node/src/api/agent-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/agent-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAiBjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiMrD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CA2mBlB"}
+{"version":3,"file":"agent-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/agent-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAcjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkNrD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAwkBlB"}

package/dist/node/src/api/bridge-routes.d.ts

@@ -1,32 +1,70 @@
 /**
- * Sub-agent bridge routes — read-only HTTP endpoints exposing parent state.
+ * Sub-agent credential bridge — additive credential endpoints.
  *
- * Spawned coding sub-agents (Claude Code, Codex) live in sealed PTY workspaces
- * with no direct access to the parent Eliza runtime's memory, character, or
- * room context. These routes give them a constrained read channel so they can
- * resolve pronouns ("the user's dad") and align with parent context the
- * orchestrator's task brief didn't surface.
+ * These routes complement the existing read-only parent-context bridge
+ * (`parent-context-routes.ts`) by giving a spawned coding sub-agent a way
+ * to *request* a missing credential from the parent. The parent collects
+ * the value from the owner via the standard REQUEST_SECRET sensitive-request
+ * flow (owner-only actor policy, DM or owner-app-inline target), encrypts
+ * it under a one-time symmetric key, and the child long-polls the GET
+ * endpoint with the bearer token it received at scope declaration.
  *
- * Endpoints (loopback-only, agentId-authed via the path):
+ * Endpoints (loopback-only):
  *
- *   GET /api/coding-agents/:sessionId/parent-context
- *   GET /api/coding-agents/:sessionId/memory?q=<query>&limit=<N>
- *   GET /api/coding-agents/:sessionId/active-workspaces
+ *   POST /api/coding-agents/:sessionId/credentials/request
+ *     body: { credentialKeys: string[] }
+ *     → { credentialScopeId, scopedToken, expiresAt, sensitiveRequestIds }
  *
- * All responses are read-only. Mutations stay with the orchestrator —
- * sub-agents can't write parent state through the bridge.
+ *   GET  /api/coding-agents/:sessionId/credentials/:key?token=<scopedToken>
+ *     long-poll up to 5 minutes for the encrypted value, one-shot redemption.
+ *     → { key, value, retrievedAt }  // value plaintext, recovered by the
+ *                                   //  service's decrypt-on-retrieve
  *
- * Validation: every request's :sessionId is checked against the coordinator's
- * `tasks` map. Unknown / stale sessions get 404. Tasks in stopped/error/completed
- * status get 410 (so the sub-agent can fall back to no-parent-context mode
- * cleanly).
- *
- * @module api/bridge-routes
+ * The orchestrator wires this module via `routes.ts`. The implementation is
+ * decoupled from the credential-tunnel service: callers pass a small
+ * `BridgeCredentialAdapter` so the same routes can be wired against a
+ * test-time mock or the production `CredentialTunnelService`.
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./route-utils.js";
 /**
- * Entry point — dispatches to the right handler based on parsed path.
+ * Adapter surface the bridge routes need from the parent runtime. The
+ * concrete implementation lives in app-core (`CredentialTunnelService`) and
+ * is registered into the parent runtime out-of-band; the route layer never
+ * imports it directly.
+ */
+export interface BridgeCredentialAdapter {
+    requestCredentials(input: {
+        childSessionId: string;
+        credentialKeys: readonly string[];
+    }): Promise<{
+        credentialScopeId: string;
+        scopedToken: string;
+        expiresAt: number;
+        sensitiveRequestIds: readonly string[];
+    }>;
+    tryRetrieveCredential(input: {
+        childSessionId: string;
+        key: string;
+        scopedToken: string;
+    }): Promise<{
+        status: "pending";
+    } | {
+        status: "ready";
+        value: string;
+    } | {
+        status: "expired";
+    } | {
+        status: "rejected";
+        reason: string;
+    }>;
+}
+/**
+ * Dispatcher for the credential bridge routes. Returns true when the path
+ * matches one of our patterns (whether or not the response is a success).
+ *
+ * `routes.ts` calls this after parent-context routes and before generic
+ * `:agentId` routes.
  */
 export declare function handleBridgeRoutes(req: IncomingMessage, res: ServerResponse, pathname: string, ctx: RouteContext): Promise<boolean>;
 //# sourceMappingURL=bridge-routes.d.ts.map

package/dist/node/src/api/bridge-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/bridge-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsMrD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAkClB"}
+{"version":3,"file":"bridge-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/bridge-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,CAAC,KAAK,EAAE;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;KACnC,GAAG,OAAO,CAAC;QACV,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;KACxC,CAAC,CAAC;IACH,qBAAqB,CAAC,KAAK,EAAE;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CACP;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,GACrB;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAClC;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,GACrB;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CACzC,CAAC;CACH;AAwOD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CA0DlB"}

package/dist/node/src/api/credential-prompt.d.ts

@@ -0,0 +1,38 @@
+/**
+ * In-chat surfacing of a sub-agent credential request (#8907).
+ *
+ * The credential bridge (`bridge-routes.ts`) already fires the sensitive-request
+ * flow (REQUEST_SECRET → owner DM / owner-app), but nothing told the user *in
+ * the originating task thread* that a sub-agent is blocked waiting on a secret —
+ * on Telegram (no side panels) that is the blocking gap. This module posts a
+ * compact prompt to the origin room when a request opens, and a status
+ * follow-up when the long-poll resolves, so the user can act without leaving
+ * chat.
+ *
+ * Kept decoupled from the route layer: it only needs the runtime's optional
+ * `sendMessageToTarget` and the origin keys the orchestrator stamps on
+ * `session.metadata` at spawn time (`roomId`, `source`).
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Post a chat prompt to the origin room announcing the pending credential
+ * request. Returns true when a message was dispatched. Best-effort: a runtime
+ * without `sendMessageToTarget`, or a session with no origin room, is a no-op.
+ */
+export declare function emitCredentialPrompt(input: {
+    runtime: IAgentRuntime;
+    metadata: Record<string, unknown> | undefined;
+    credentialKeys: readonly string[];
+    label?: string;
+}): Promise<boolean>;
+/**
+ * Post a follow-up once a requested credential has been delivered, so the user
+ * sees the task is unblocked. Best-effort, same no-op conditions as above.
+ */
+export declare function emitCredentialResolved(input: {
+    runtime: IAgentRuntime;
+    metadata: Record<string, unknown> | undefined;
+    key: string;
+    label?: string;
+}): Promise<boolean>;
+//# sourceMappingURL=credential-prompt.d.ts.map

package/dist/node/src/api/credential-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-prompt.d.ts","sourceRoot":"","sources":["../../../../src/api/credential-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAW,aAAa,EAAQ,MAAM,eAAe,CAAC;AA4ClE;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCnB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBnB"}

package/dist/node/src/api/orchestrator-routes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Orchestrator Task Route Handlers
+ *
+ * Mounts the durable task surface under `/api/orchestrator/*`:
+ * aggregate status, task CRUD, lifecycle (pause/resume/archive/reopen/fork/
+ * validate/delete), room messages, event log, usage rollup, and sub-agent
+ * add/stop. All orchestration logic lives in {@link OrchestratorTaskService};
+ * these handlers validate input at the boundary and forward to the service.
+ *
+ * @module api/orchestrator-routes
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { RouteContext } from "./route-utils.js";
+/**
+ * Handle `/api/orchestrator/*` routes. Returns true when the path was matched
+ * (whether it succeeded or errored), false to let the dispatcher continue.
+ */
+/**
+ * Single error boundary for every orchestrator endpoint. A thrown service call
+ * (DB / file / session failure) becomes a 500 instead of an unhandled promise
+ * rejection that leaves the request hanging forever. Paths outside the
+ * orchestrator prefix return false (not handled) untouched.
+ */
+export declare function handleOrchestratorRoutes(req: IncomingMessage, res: ServerResponse, pathname: string, ctx: RouteContext): Promise<boolean>;
+//# sourceMappingURL=orchestrator-routes.d.ts.map

package/dist/node/src/api/orchestrator-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/orchestrator-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAkBjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqHrD;;;GAGG;AACH;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAalB"}

package/dist/node/src/api/parent-context-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parent-context-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/parent-context-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA+UrD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAiGlB"}
+{"version":3,"file":"parent-context-routes.d.ts","sourceRoot":"","sources":["../../../../src/api/parent-context-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA+TrD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CA8FlB"}

package/dist/node/src/api/route-utils.d.ts

@@ -1,18 +1,34 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { IAgentRuntime } from "@elizaos/core";
-import type { PTYService } from "../services/pty-service.js";
-import type { SwarmCoordinator } from "../services/swarm-coordinator.js";
+import type { AcpActionService } from "../actions/common.js";
 import type { CodingWorkspaceService } from "../services/workspace-service.js";
-export type JsonValue = string | number | boolean | null | JsonValue[] | {
-    [key: string]: JsonValue;
-};
 export interface RouteContext {
     runtime: IAgentRuntime;
-    ptyService: PTYService | null;
+    acpService: AcpActionService | null;
     workspaceService: CodingWorkspaceService | null;
-    coordinator?: SwarmCoordinator;
 }
+/**
+ * Parse the JSON request body.
+ *
+ * The elizaOS runtime route dispatcher parses JSON bodies and attaches the
+ * result to `req.body` before invoking `rawPath` handlers (see
+ * `@elizaos/core` `readJsonBody`), draining the request stream in the process.
+ * Re-reading that already-ended stream would hang forever, so we return the
+ * pre-parsed body when present and only fall back to reading the stream for
+ * direct callers (e.g. unit tests) that pass an unconsumed request.
+ */
 export declare function parseBody(req: IncomingMessage): Promise<Record<string, unknown>>;
 export declare function sendJson(res: ServerResponse, data: unknown, status?: number): void;
 export declare function sendError(res: ServerResponse, message: string, status?: number): void;
+/**
+ * Send a 503 that honestly reports the backing service is still initializing,
+ * with a quiet-backoff signal for polling clients. This is NOT an empty-data
+ * fallback — the request genuinely cannot be served yet, so the status stays
+ * 503/unavailable. The `Retry-After` header (HTTP spec: integer seconds) plus
+ * the machine-readable `{ status: "initializing", retryAfterMs }` body let the
+ * dashboard back off instead of hammering the endpoint during the startup
+ * window. Callers pass the same human-readable message they would give
+ * `sendError(..., 503)`.
+ */
+export declare function sendServiceUnavailable(res: ServerResponse, message: string, retryAfterMs?: number): void;
 //# sourceMappingURL=route-utils.d.ts.map

package/dist/node/src/api/route-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-utils.d.ts","sourceRoot":"","sources":["../../../../src/api/route-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE/E,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAMD,wBAAsB,SAAS,CAC7B,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlC;AAGD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,OAAO,EACb,MAAM,SAAM,GACX,IAAI,CAGN;AAGD,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,SAAM,GACX,IAAI,CAEN"}
+{"version":3,"file":"route-utils.d.ts","sourceRoot":"","sources":["../../../../src/api/route-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACjD;AAKD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BlC;AAGD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,OAAO,EACb,MAAM,SAAM,GACX,IAAI,CAGN;AAGD,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,SAAM,GACX,IAAI,CAEN;AAYD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,YAAY,SAAsC,GACjD,IAAI,CASN"}

package/dist/node/src/api/routes.d.ts

@@ -8,7 +8,6 @@
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { IAgentRuntime } from "@elizaos/core";
-import type { SwarmCoordinator } from "../services/swarm-coordinator.js";
 import type { RouteContext } from "./route-utils.js";
 /**
  * Handle task-agent routes
@@ -18,6 +17,6 @@ export declare function handleCodingAgentRoutes(req: IncomingMessage, res: Serve
 /**
  * Create route handler with services from runtime
  */
-export declare function createCodingAgentRouteHandler(runtime: IAgentRuntime, coordinator?: SwarmCoordinator): (req: IncomingMessage, res: ServerResponse, pathname: string) => Promise<boolean>;
+export declare function createCodingAgentRouteHandler(runtime: IAgentRuntime): (req: IncomingMessage, res: ServerResponse, pathname: string) => Promise<boolean>;
 export declare const createTaskAgentRouteHandler: typeof createCodingAgentRouteHandler;
 //# sourceMappingURL=routes.d.ts.map

package/dist/node/src/api/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/api/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAQzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CA4ClB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,aAAa,EACtB,WAAW,CAAC,EAAE,gBAAgB,IAEtB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,UAAU,MAAM,sBASpE;AAED,eAAO,MAAM,2BAA2B,sCAAgC,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/api/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,IAC1D,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,UAAU,MAAM,sBAQpE;AAED,eAAO,MAAM,2BAA2B,sCAAgC,CAAC"}

package/dist/node/src/evaluators/sub-agent-completion.d.ts

@@ -0,0 +1,3 @@
+import { type ResponseHandlerEvaluator } from "@elizaos/core";
+export declare const subAgentCompletionResponseEvaluator: ResponseHandlerEvaluator;
+//# sourceMappingURL=sub-agent-completion.d.ts.map

package/dist/node/src/evaluators/sub-agent-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-completion.d.ts","sourceRoot":"","sources":["../../../../src/evaluators/sub-agent-completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,wBAAwB,EAE9B,MAAM,eAAe,CAAC;AAmevB,eAAO,MAAM,mCAAmC,EAAE,wBAsOjD,CAAC"}

package/dist/node/src/index.d.ts

@@ -7,25 +7,50 @@
  *
  * @module @elizaos/plugin-agent-orchestrator
  */
-import type { Plugin } from "@elizaos/core";
-import "./register-routes.js";
+import type { IAgentRuntime, Plugin } from "@elizaos/core";
+export { codingAgentRouteRegistration } from "./register-routes.js";
+export declare function createAgentOrchestratorPlugin(): Plugin;
+export declare function stripProgressLabelPrefix(text: string): string;
+type SubAgentProgressMode = "compact" | "threaded" | "silent" | "ack";
+interface SubAgentProgressPolicy {
+    mode: SubAgentProgressMode;
+    reactions: boolean;
+    delayMs: number;
+}
+export declare function resolveSubAgentProgressPolicy(runtime: IAgentRuntime): SubAgentProgressPolicy;
+export declare function compactProgressText(text: string): string;
+/**
+ * Decide whether the planner already acknowledged a spawn turn, so the
+ * orchestrator's spawn ACK can be suppressed (avoiding two back-to-back acks:
+ * planner "On it." + orchestrator "working on it now."). True iff the planner
+ * sent a user-facing message to the room within the spawn turn — i.e. at/after
+ * the session's createdAt minus a small lookback (REPLY and the TASKS spawn
+ * action run in the same turn, in either order). A planner reply older than
+ * that belongs to an earlier turn (e.g. a previous task's completion summary)
+ * and must NOT suppress this spawn's ack. Pure + deterministic so it is unit
+ * tested directly instead of relying on a flaky live "On it." case.
+ */
+export declare function plannerAlreadyAckedSpawn(plannerReplyAtMs: number | undefined, sessionCreatedAtMs: number | undefined, lookbackMs: number): boolean;
+export declare function sanitizePlannerText(text: string): string;
+export declare function extractCompletionSummary(raw: string): string;
 export declare const agentOrchestratorPlugin: Plugin;
 export default agentOrchestratorPlugin;
 export type { AdapterType, AgentCredentials, AgentFileDescriptor, ApprovalConfig, ApprovalPreset as AdapterApprovalPreset, PreflightResult, PresetDefinition, RiskLevel, ToolCategory, WriteMemoryOptions, } from "coding-agent-adapters";
+export { getAcpService } from "./actions/common.js";
 export { archiveCodingTaskAction, cancelTaskAction, createTaskAction, finalizeWorkspaceAction, listAgentsAction, listTaskAgentsAction, manageIssuesAction, provisionWorkspaceAction, reopenCodingTaskAction, sendToAgentAction, sendToTaskAgentAction, spawnAgentAction, spawnTaskAgentAction, startCodingTaskAction, stopAgentAction, stopTaskAgentAction, taskControlAction, taskHistoryAction, taskShareAction, tasksAction, } from "./actions/tasks.js";
 export { createCodingAgentRouteHandler, createTaskAgentRouteHandler, handleCodingAgentRoutes, } from "./api/routes.js";
+export { subAgentCompletionResponseEvaluator } from "./evaluators/sub-agent-completion.js";
 export { activeSubAgentsProvider } from "./providers/active-sub-agents.js";
 export { acpAvailableAgentsProvider, availableAgentsProvider, } from "./providers/available-agents.js";
 export { AcpService } from "./services/acp-service.js";
 export { cleanForChat } from "./services/ansi-utils.js";
-export type { CodingAgentType, PTYServiceConfig, SessionEventName as PTYSessionEventName, SessionInfo as PTYSessionInfo, SpawnSessionOptions as PTYSpawnSessionOptions, } from "./services/pty-service.js";
-export { getCoordinator, PTYService } from "./services/pty-service.js";
+export { COMPLETION_ENVELOPE_INSTRUCTION, type CompletionEnvelope, envelopeCorrection, parseCompletionEnvelope, summarizeEnvelope, } from "./services/completion-envelope.js";
+export { buildIndependentVerifierPrompt, type IndependentVerifierVerdict, runIndependentVerification, shouldRunIndependentVerify, verifierVerdict, } from "./services/independent-verifier.js";
+export { collectScreenshotPaths, deliverScreenshots, screenshotsToAttachments, } from "./services/screenshot-delivery.js";
 export { AcpSessionStore, FileSessionStore, InMemorySessionStore, RuntimeDbSessionStore, } from "./services/session-store.js";
 export { SubAgentRouter } from "./services/sub-agent-router.js";
-export type { AgentDecisionCallback, ChatMessageCallback, CoordinationDecision, PendingDecision, SupervisionLevel, SwarmCompleteCallback, SwarmEvent, TaskCompletionSummary, TaskContext, WsBroadcastCallback, } from "./services/swarm-coordinator.js";
-export { SwarmCoordinator } from "./services/swarm-coordinator.js";
-export type { CoordinationLLMResponse, SharedDecision, } from "./services/swarm-coordinator-prompts.js";
-export { buildBlockedEventMessage, buildTurnCompleteEventMessage, } from "./services/swarm-coordinator-prompts.js";
+export { composeRoomDigest, runSupervisorTick, type SupervisorTaskView, statusEmoji, TASK_SUPERVISOR_SERVICE_TYPE, TaskSupervisorService, } from "./services/task-supervisor-service.js";
+export { detectStalledSessions, STALL_GRILL_PROMPT, TASK_WATCHDOG_SERVICE_TYPE, TaskWatchdogService, type WatchdogSessionView, } from "./services/task-watchdog-service.js";
 export type { AcpEventCallback, AcpJsonRpcMessage, AgentType, ApprovalPreset, AvailableAgentInfo, PromptResult, SendOptions, SessionEventCallback, SessionEventName, SessionInfo, SessionStatus, SpawnOptions, SpawnResult, } from "./services/types.js";
 export type { AuthPromptCallback, CodingWorkspaceConfig, CommitOptions, ProvisionWorkspaceOptions, PushOptions, WorkspaceResult, } from "./services/workspace-service.js";
 export { CodingWorkspaceService } from "./services/workspace-service.js";