@elizaos/plugin-agent-orchestrator 2.0.3-beta.2 → 2.0.3-beta.4

package/dist/node/src/services/ssrf-guard.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SSRF guard for the completion-URL verifier.
+ *
+ * The verifier in `sub-agent-router.ts` GET-probes every http(s) URL it
+ * extracts from *sub-agent narration* — model-controlled, untrusted text. A
+ * prompt-injected or compromised sub-agent can therefore steer the parent
+ * orchestrator into fetching arbitrary hosts: cloud metadata endpoints
+ * (169.254.169.254), RFC1918 internal services, link-local addresses, etc.
+ * That is server-side request forgery.
+ *
+ * This module rejects fetches whose target resolves to a non-public address,
+ * with one deliberate carve-out: *loopback* (127.0.0.0/8, ::1, `localhost`) is
+ * allowed. The verifier exists precisely to confirm a sub-agent's local build
+ * is reachable, and those builds are served on loopback — blocking it would
+ * break the feature. Everything else off the public Internet (private,
+ * link-local, ULA, carrier-grade NAT, multicast, the cloud-metadata IP) is
+ * blocked.
+ *
+ * Two attack vectors are closed:
+ *   1. Direct fetch of an internal host — `assertUrlAllowed` resolves the
+ *      hostname and rejects if *any* resolved address is in a blocked range
+ *      (so DNS rebinding to an internal IP cannot slip through).
+ *   2. Redirect-based bypass — `safeFetch` uses `redirect: "manual"` and
+ *      re-validates each hop's Location host before following it, so a public
+ *      page cannot 302 the verifier into an internal/metadata endpoint.
+ */
+/**
+ * Resolves a hostname to its addresses. Injectable so tests (which probe
+ * unresolvable reserved hostnames like `*.test` against an injected `fetch`) can
+ * supply a deterministic resolver without real DNS. Defaults to the system
+ * resolver. Production code never overrides this.
+ */
+export type HostResolver = (host: string) => Promise<{
+    address: string;
+}[]>;
+/** Override the DNS resolver (test seam). Pass no argument to reset. */
+export declare function setHostResolver(resolver?: HostResolver): void;
+/** Reason a URL was rejected; surfaced as the probe "status" string. */
+export declare class SsrfBlockedError extends Error {
+    readonly host: string;
+    constructor(host: string, detail: string);
+}
+/** Classify an IP literal. Returns "loopback", "blocked", or "allowed". */
+export declare function classifyIpLiteral(addr: string): "loopback" | "blocked" | "allowed";
+/**
+ * Resolve `hostname` and assert every resolved address is fetch-safe
+ * (loopback or public). Throws `SsrfBlockedError` if the host is, or resolves
+ * to, a blocked (non-public, non-loopback) address. Checking *all* resolved
+ * addresses defeats DNS rebinding to an internal IP.
+ */
+export declare function assertHostAllowed(hostname: string): Promise<void>;
+/** Assert the full URL's host is fetch-safe. */
+export declare function assertUrlAllowed(url: string | URL): Promise<void>;
+/**
+ * SSRF-safe replacement for `fetch(url, { redirect: "follow" })`.
+ *
+ * Validates the host before the initial request, then follows redirects
+ * *manually* — re-validating each hop's Location host with `assertUrlAllowed`
+ * before fetching it — so a public page cannot redirect the verifier into an
+ * internal or cloud-metadata endpoint. Caps redirects at `MAX_REDIRECTS`.
+ *
+ * Throws `SsrfBlockedError` if any hop targets a blocked host; otherwise
+ * behaves like `fetch` and returns the final `Response`.
+ */
+export declare function safeFetch(url: string, init?: Omit<RequestInit, "redirect">): Promise<Response>;
+//# sourceMappingURL=ssrf-guard.d.ts.map

package/dist/node/src/services/ssrf-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssrf-guard.d.ts","sourceRoot":"","sources":["../../../../src/services/ssrf-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAAC;AAI5E,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAE7D;AAED,wEAAwE;AACxE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAKzC;AAyHD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,SAAS,GAAG,SAAS,CAapC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCvE;AAED,gDAAgD;AAChD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAM,GACvC,OAAO,CAAC,QAAQ,CAAC,CA2BnB"}

package/dist/node/src/services/sub-agent-identity.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Self-contained operating manual scaffolded into a spawned sub-agent's
+ * workspace so every backend (claude reads CLAUDE.md, codex reads AGENTS.md,
+ * opencode reads both) receives the same eliza-context + non-interactive
+ * directive regardless of where the spawn cwd lands. The ACP spawn path injects
+ * nothing but the task string, so without this a sub-agent in a bare/scratch
+ * cwd gets zero orientation — codex in particular ("expected identity files are
+ * not present") starves because it only reads AGENTS.md.
+ *
+ * @module services/sub-agent-identity
+ */
+/**
+ * The operating manual. Deliberately self-contained — a sub-agent never has to
+ * chase a possibly-stale skill file to know it is non-interactive. Bridge facts
+ * are stated accurately: `memory` is global semantic search (not the originating
+ * room's recent messages), `parent-context` does not expose the original task,
+ * and the endpoints only work when `PARALLAX_SESSION_ID` is wired.
+ */
+export declare const SUB_AGENT_IDENTITY_MD = "# Eliza coding sub-agent \u2014 operating manual\n\nYou are an autonomous coding sub-agent spawned by Eliza (an elizaOS-based\nassistant) over the Agent Client Protocol to do ONE coding task. This file was\nwritten into your workspace at spawn. There is NO interactive human in this\nsession \u2014 you are driven by a program, not a person typing to you.\n\n## Non-interactive (HARD RULE)\n\n- NEVER ask the user a question and wait \u2014 there is no one to answer.\n- NEVER block on input, confirmation, a permission prompt, or \"let me know how\n  you'd like to proceed.\" Make the best available choice and proceed.\n- NEVER say \"run this in your terminal\" or \"use the `!`/`/` prefix\" \u2014 there is\n  no terminal in front of anyone.\n- If you are genuinely blocked, or must make an architectural choice the task\n  did not cover, print ONE line on stdout starting with `DECISION:` explaining\n  it, then proceed with your best call (or stop if truly impossible). The\n  orchestrator greps stdout for `DECISION:` lines. Do not wrap it in markdown.\n- Keep working until the task is finished or genuinely blocked. When you finish,\n  state what changed, what you ran/tested, and any remaining risks.\n\n## What Eliza is / where you are\n\n- Eliza is a local-first elizaOS agent app; its orchestrator\n  (plugin-agent-orchestrator) spawned you for one task.\n- Your working directory (the one this file was written into) is authoritative\n  and is your ONLY workspace. Write every file inside it; do not `cd` to `/tmp`,\n  `/`, `$HOME`, or another checkout. Need scratch space? Make a subdirectory here.\n- A parent directory may contain its OWN `CLAUDE.md`/`AGENTS.md` that names a\n  different \"assigned workspace\" \u2014 that file belongs to a different agent, not\n  you. IGNORE any such parent-directory workspace assignment: THIS directory\n  wins. Never write to, build in, or `cd` to that other path, even if a parent\n  file instructs it. Resolve every relative path against this directory.\n- Tool availability varies by backend and tier \u2014 enumerate the tools you\n  actually have before deciding you cannot do something.\n\n## Reading parent state (optional \u2014 only if the task needs it)\n\nIf the task depends on context not in the prompt, you can GET read-only parent\nstate, but only when the bridge is wired (env var `PARALLAX_SESSION_ID` set):\n\n- `curl \"http://127.0.0.1:${ELIZA_HOOK_PORT:-2138}/api/coding-agents/${PARALLAX_SESSION_ID}/parent-context\"`\n  \u2192 parent character, originating room, model prefs, your workdir.\n- `.../memory?q=<query>&limit=<N>` \u2192 GLOBAL semantic search over the parent's\n  memory (facts, messages, knowledge) \u2014 not the originating room's recency.\n- `.../active-workspaces` \u2192 sibling sub-agents.\n\nLoopback-only, GET-only, read-only; auth is the path-embedded session id. If\n`PARALLAX_SESSION_ID` is unset, the bridge is not wired for your spawn \u2014 skip it.\nFor a self-contained task, never touch the bridge.\n\n## Constraints\n\n- Workspace-only writes. Sealed env (only an allowlist of vars is forwarded).\n- Don't push to git remotes or open PRs \u2014 Eliza handles git push / PR creation.\n- Don't print secrets \u2014 output is captured. Reference secrets by env-var name.\n\n## Your final message \u2014 lead with the deliverable, not your process\n\nEliza relays your LAST message to the user, then a synthesis pass keeps the\nload-bearing facts and drops noise. Make that message the answer itself:\n\n- Lead with the DELIVERABLE \u2014 the value, the command output, the computed\n  result, the URL you built, or one line of what changed. Put it first and\n  verbatim. If the task said \"report only the number\", reply with only the\n  number.\n- If the task asks you to COMPUTE, RUN, or report the OUTPUT of something, you\n  must actually EXECUTE it (run the script/command) and report its REAL result.\n  A script you wrote but never ran is NOT the deliverable \u2014 it returns nothing,\n  the answer the user asked for is missing, and you force a wasteful re-spawn.\n  The value must come from a real execution, not from unexecuted code.\n- Do NOT narrate your process. No \"I'll load the workspace context first\",\n  \"checking the workspace shape\", \"rg is not installed so I'll use\u2026\", \"the file\n  already exists, reading it before editing\", no step-by-step play-by-play, no\n  \"Completed <restating the task>\" banner. That chatter leaks to the user as\n  noise and buries the answer.\n- A bare workspace has no `SOUL.md`/`USER.md`/memory/context files and that is\n  EXPECTED \u2014 do not go looking for them, and never mention their absence. Your\n  context is the task prompt (and the optional bridge above); nothing else is\n  missing.\n- Keep it short. No multi-paragraph monologue, no dumping a full file or\n  directory listing unless the task asked for it. If you hit a blocker, say so\n  in one plain line (or a `DECISION:` line) \u2014 don't narrate the failed attempts\n  that a retry recovered from.\n";
+/**
+ * Scaffold the operating manual into a freshly-created spawn workspace, but only
+ * when the workspace is "bare" (has neither AGENTS.md nor CLAUDE.md). A real
+ * project/repo workdir already carries its own instruction files and must NOT be
+ * clobbered — the prompt-level non-interactive directive covers that case.
+ */
+export declare function writeWorkspaceIdentity(workdir: string): Promise<void>;
+//# sourceMappingURL=sub-agent-identity.d.ts.map

package/dist/node/src/services/sub-agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-identity.d.ts","sourceRoot":"","sources":["../../../../src/services/sub-agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,w7JAoFjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3E"}

package/dist/node/src/services/sub-agent-inbox.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Per-session message inbox for the interruption decider.
+ *
+ * When a room message is QUEUEd (relevant but the sub-agent is mid-turn) or an
+ * INTERRUPT cancels the current turn, the text lands here and is flushed to the
+ * sub-agent the moment it returns to an idle state. This keeps a working
+ * sub-agent from being derailed mid-turn while guaranteeing the human's message
+ * is still delivered — the "continue without interruption unless required"
+ * contract.
+ */
+export declare class SubAgentInbox {
+    private readonly pending;
+    private readonly cap;
+    constructor(cap?: number);
+    /** Queue a message for a session. Oldest entries drop past the cap. */
+    enqueue(sessionId: string, text: string): void;
+    size(sessionId: string): number;
+    /**
+     * Remove and return the queued messages for a session as one combined
+     * string (newline-joined), or null when nothing is queued.
+     */
+    drain(sessionId: string): string | null;
+    clear(sessionId: string): void;
+    clearAll(): void;
+}
+//# sourceMappingURL=sub-agent-inbox.d.ts.map

package/dist/node/src/services/sub-agent-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-inbox.d.ts","sourceRoot":"","sources":["../../../../src/services/sub-agent-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,GAAE,MAAoB;IAIrC,uEAAuE;IACvE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAS9C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI/B;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/node/src/services/sub-agent-router.d.ts

@@ -0,0 +1,178 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import { Service } from "@elizaos/core";
+interface DeadUrl {
+    url: string;
+    status: string;
+    /** Set when this URL was discovered as a sub-resource of another page. */
+    via?: string;
+}
+export interface RouteUrlMapping {
+    urlPrefix: string;
+    localPath: string;
+    requireFresh?: boolean;
+}
+export interface RouteUrlVerification {
+    workdir: string;
+    sessionStartedAtMs: number;
+    mappings: RouteUrlMapping[];
+}
+export declare function redactLoopbackUrls(text: string): string;
+/**
+ * SubAgentRouter takes terminal-significant ACPX session events
+ * (`task_complete`, `error`, `blocked`) and posts them as synthetic inbound
+ * messages into the runtime so the main agent's normal action layer can
+ * decide whether to:
+ *   - REPLY to the user,
+ *   - SEND_TO_AGENT to push the sub-agent further,
+ *   - or both.
+ *
+ * Routing keys are read from `session.metadata` populated by TASKS op=create
+ * at spawn time: `roomId`, `worldId`, `userId`, `messageId`, `source`, `label`.
+ *
+ * Streaming chunks (`agent_message_chunk`, `tool_running`) are intentionally
+ * NOT injected — they would refire the planner constantly and burn cache.
+ * The provider is the channel for live status; this router is the channel for
+ * boundary events that warrant a decision.
+ */
+export declare class SubAgentRouter extends Service {
+    static serviceType: string;
+    static dependencies: string[];
+    capabilityDescription: string;
+    protected runtime: IAgentRuntime;
+    private acp;
+    private unsubscribe;
+    private readonly delivered;
+    private readonly roundTripCounts;
+    private readonly parentAgentBuffers;
+    private readonly parentAgentDispatchCounts;
+    private readonly capExceededSessions;
+    private readonly verifyRetryHandedOffSessions;
+    private readonly stateLostRespawnCounts;
+    private readonly stateLostCapNotified;
+    private readonly completionFirstPostedSession;
+    private tryClaimCompletion;
+    private readonly spawnCountsForOrigin;
+    private readonly bestResultForOrigin;
+    /** Spawns already issued for this root origin (for the per-origin cap). */
+    spawnCountForOrigin(originKey: string): number;
+    /** Record a spawn against a root origin (FIFO-bounded). */
+    noteSpawnForOrigin(originKey: string): void;
+    /** Best already-completed result for an origin, relayed instead of re-spawning. */
+    bestResultFor(originKey: string): {
+        text: string;
+        deliverable?: string;
+    } | undefined;
+    /** Keep the LONGEST non-empty result for an origin (full 479001600 wins over truncated 479). */
+    recordOriginResult(originKey: string, result: {
+        text: string;
+        deliverable?: string;
+    }): void;
+    private started;
+    private roundTripCap;
+    private stateLostRespawnCap;
+    private bindRetryTimer;
+    private stopped;
+    constructor(runtime: IAgentRuntime);
+    static start(runtime: IAgentRuntime): Promise<SubAgentRouter>;
+    start(): Promise<void>;
+    private tryBindSources;
+    stop(): Promise<void>;
+    private handleEvent;
+    private buildReplyCallback;
+    /**
+     * Recover a session that reported `session_state_lost` by deterministically
+     * spawning a fresh sub-agent inside the router — carrying the byte-identical
+     * origin metadata and the original task — instead of re-injecting the error
+     * and relying on the parent planner to spawn the replacement (which leaked a
+     * "the sub-agent crashed, let me try again" message to the user). Returns
+     * true when a replacement was spawned (the caller suppresses the dead
+     * session's events and posts nothing — the child's own task_complete is the
+     * only user-facing message). Returns false when the original task is
+     * unavailable or no spawn service is registered, in which case the caller
+     * falls through to an honest failure post.
+     *
+     * Lineage capping lives in handleEvent (stateLostRespawnCounts +
+     * stateLostRespawnCap), parallel to the verify-retry budget, so a flapping
+     * session can't respawn unbounded.
+     */
+    private respawnStateLost;
+    /**
+     * Re-dispatch a sub-agent when its claimed URLs verify as unreachable —
+     * an incomplete build (missing or empty files). Returns true if a retry
+     * was spawned (the caller suppresses the parent post and lets the
+     * retry's own task_complete report the outcome). Returns false when
+     * retries are disabled, the budget is exhausted, the original task is
+     * unavailable, or no spawn service is registered — in which case the
+     * caller posts the honest "build incomplete" report instead.
+     *
+     * Bounded by ELIZA_BUILD_VERIFY_MAX_RETRIES (default 2; 0 disables).
+     * The retry count rides on the spawned session's metadata so a whole
+     * lineage of retries shares one budget. Mirrors the APP-create
+     * verification-retry pattern.
+     */
+    private retryIncompleteBuild;
+    private hasNewerContinuation;
+    /**
+     * Accumulate streamed child text and, when a complete
+     * `USE_SKILL parent-agent <json>` directive appears, bridge it to the broker
+     * and stream the reply back into the session. Synchronous up to the point a
+     * complete directive is found (the buffer is trimmed before any await), so
+     * out-of-order `message` chunks cannot re-dispatch or corrupt the buffer.
+     */
+    private maybeDispatchParentAgent;
+    private log;
+}
+export declare function extractShortToolDeliverable(data: unknown): string | undefined;
+/**
+ * GET-check every http(s) URL a sub-agent claimed in its completion text —
+ * and, for any that return HTML, follow the page's own declared
+ * sub-resources (`<link href>` / `<script src>`) and check those too.
+ * The sub-agent's claim ("the app is live at X") is treated as a
+ * hypothesis, not a fact — the parent agent should see ground truth.
+ *
+ * Why follow sub-resources: a weak coding model routinely writes the
+ * entry `index.html` but drops the `style.css` / `app.js` it references.
+ * The index URL then returns 200 while the app is visibly broken — only
+ * probing the mentioned URL would pass it as "live". Following the page's
+ * declared dependencies catches the partial build.
+ *
+ * Conservative by design:
+ *  - only runs on `task_complete` text (not errors/blocked)
+ *  - caps at the first 5 distinct mentioned URLs + their sub-resources
+ *  - 4s per-request timeout, failures (DNS, timeout, refused) count as
+ *    unverified rather than throwing
+ *  - one short settle-retry before declaring a URL dead, covering a
+ *    transient network blip on the checker side
+ *  - never strips the original text — it only appends an annotation, so a
+ *    transient network blip on the checker side degrades to "couldn't
+ *    verify" rather than hiding a real success
+ *
+ * Callers should pass text that has already been through
+ * {@link normalizeUrlsInText} so Unicode-dash-corrupted URLs are probed in
+ * their intended form.
+ */
+export declare function annotateUnverifiedUrls(text: string, log?: (message: string) => void, referenceText?: string, ignoredUrls?: ReadonlySet<string>, runtime?: IAgentRuntime, routeVerification?: RouteUrlVerification): Promise<{
+    text: string;
+    dead: DeadUrl[];
+    verifiedUrls: string[];
+}>;
+/**
+ * Extract the sub-resource URLs an HTML document declares via common
+ * resource-bearing attributes, resolved absolute against the page URL.
+ * Mechanical extraction from a structured document — not intent
+ * classification. Skips in-page anchors and data:/mailto: refs, and caps
+ * the result so a pathological page can't fan out unbounded probes.
+ */
+export declare function extractSubResources(html: string, pageUrl: string): string[];
+/**
+ * Normalize http(s) URLs embedded in free text: replace Unicode look-alike
+ * dashes (non-breaking hyphen, en/em dash, …) with an ASCII hyphen. Weak
+ * coding models emit these inside URLs, which makes the link 404 even
+ * though the target exists under the ASCII-hyphen name — broken for both
+ * the verification probe and the user clicking it. Only dash characters
+ * inside a URL are touched; surrounding prose (where an em dash is
+ * legitimate punctuation) is left untouched.
+ */
+export declare function normalizeUrlsInText(text: string): string;
+export {};
+//# sourceMappingURL=sub-agent-router.d.ts.map

package/dist/node/src/services/sub-agent-router.d.ts.map

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

package/dist/node/src/services/task-agent-frameworks.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Task-agent framework discovery and preference resolution.
+ *
+ * Detects installed CLIs, available auth, and Eliza subscription preferences so
+ * the orchestrator can choose the best framework when the caller does not
+ * specify one explicitly.
+ *
+ * @module services/task-agent-frameworks
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+type AgentMetricsSummary = {
+    spawned: number;
+    completed: number;
+    stallCount: number;
+    avgCompletionMs: number;
+};
+type TaskAgentPreflightResult = {
+    adapter?: string;
+    agentType?: string;
+    installed?: boolean;
+    installCommand?: string;
+    docsUrl?: string;
+    auth?: {
+        status?: unknown;
+    };
+};
+export type SupportedTaskAgentAdapter = "elizaos" | "pi-agent" | "claude" | "codex" | "opencode";
+export type TaskAgentFrameworkId = SupportedTaskAgentAdapter;
+export interface TaskAgentModelPrefs {
+    powerful?: string;
+    fast?: string;
+}
+export interface TaskAgentFrameworkAvailability {
+    id: TaskAgentFrameworkId;
+    label: string;
+    installed: boolean;
+    authReady: boolean;
+    subscriptionReady: boolean;
+    temporarilyDisabled: boolean;
+    temporarilyDisabledUntil?: number;
+    temporarilyDisabledReason?: string;
+    recommended: boolean;
+    reason: string;
+    installCommand?: string;
+    docsUrl?: string;
+    selectionScore?: number;
+    selectionSignals?: Record<string, number>;
+}
+export interface PreferredTaskAgent {
+    id: TaskAgentFrameworkId;
+    reason: string;
+}
+export interface TaskAgentFrameworkState {
+    configuredSubscriptionProvider?: string;
+    frameworks: TaskAgentFrameworkAvailability[];
+    preferred: PreferredTaskAgent;
+}
+export interface TaskAgentFrameworkProbe {
+    checkAvailableAgents?: (types?: string[]) => Promise<TaskAgentPreflightResult[]>;
+    getAgentMetrics?: () => Record<string, AgentMetricsSummary>;
+}
+export type TaskAgentTaskKind = "coding" | "research" | "planning" | "ops" | "mixed";
+export interface TaskAgentTaskProfileInput {
+    task?: string;
+    repo?: string;
+    workdir?: string;
+    threadKind?: TaskAgentTaskKind;
+    subtaskCount?: number;
+    acceptanceCriteria?: string[];
+}
+export interface TaskAgentTaskProfile {
+    text: string;
+    kind: TaskAgentTaskKind;
+    subtaskCount: number;
+    repoPresent: boolean;
+    signals: {
+        implementation: number;
+        research: number;
+        planning: number;
+        ops: number;
+        verification: number;
+        coordination: number;
+        repoWork: number;
+        fastIteration: number;
+    };
+}
+declare const FRAMEWORK_LABELS: Record<TaskAgentFrameworkId, string>;
+export declare const TASK_AGENT_DEFAULT_MODEL_PREFS: Record<SupportedTaskAgentAdapter, TaskAgentModelPrefs>;
+export declare function readTaskAgentModelPrefs(value: unknown): TaskAgentModelPrefs | undefined;
+export declare function mergeTaskAgentModelPrefs(...prefs: Array<TaskAgentModelPrefs | undefined>): TaskAgentModelPrefs | undefined;
+export declare function getTaskAgentModelPrefs(runtime: IAgentRuntime | undefined, agentType: string | undefined, spawnPrefs?: TaskAgentModelPrefs): TaskAgentModelPrefs | undefined;
+export declare function getTaskAgentFrameworkState(runtime: IAgentRuntime, probe?: TaskAgentFrameworkProbe, profileInput?: TaskAgentTaskProfileInput): Promise<TaskAgentFrameworkState>;
+export declare function buildTaskAgentTaskProfile(input?: TaskAgentTaskProfileInput): TaskAgentTaskProfile;
+export declare function clearTaskAgentFrameworkStateCache(): void;
+export declare function isUsageExhaustedTaskAgentError(text: string): boolean;
+export declare function markTaskAgentFrameworkUnavailable(id: SupportedTaskAgentAdapter, reason: string, cooldownMs?: number): void;
+export declare function markTaskAgentFrameworkHealthy(id: SupportedTaskAgentAdapter): void;
+export declare function formatTaskAgentFrameworkLine(framework: TaskAgentFrameworkAvailability): string;
+export declare function formatTaskAgentStatus(status: string): string;
+export declare function truncateTaskAgentText(text: string, max?: number): string;
+export declare function rewriteTaskAgentText(text: string): string;
+export { FRAMEWORK_LABELS as TASK_AGENT_FRAMEWORK_LABELS };
+//# sourceMappingURL=task-agent-frameworks.d.ts.map

package/dist/node/src/services/task-agent-frameworks.d.ts.map

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

package/dist/node/src/services/task-agent-routing.d.ts

@@ -0,0 +1,33 @@
+import type { IAgentRuntime } from "@elizaos/core";
+export declare function normalizeTaskAgentAdapter(value: string | undefined): string | undefined;
+export interface WorkdirRoute {
+    id: string;
+    workdir: string;
+    matchAll?: string[];
+    matchAny?: string[];
+    excludeAny?: string[];
+    instructions?: string;
+    urlMappings?: WorkdirRouteUrlMapping[];
+}
+export interface WorkdirRouteUrlMapping {
+    urlPrefix: string;
+    localPath: string;
+    requireFresh?: boolean;
+}
+export interface ResolvedWorkdirRoute {
+    id: string;
+    workdir: string;
+    instructions?: string;
+    urlMappings?: WorkdirRouteUrlMapping[];
+}
+export declare function resolvePinnedAdapter(runtime: IAgentRuntime | undefined): string | undefined;
+export declare function resolveSpawnWorkdir(runtime: IAgentRuntime | undefined, task: string, userRequest: string, explicitWorkdir: string | undefined, opts?: {
+    lockWorkdir?: boolean;
+}): {
+    workdir: string;
+    route?: ResolvedWorkdirRoute;
+    isolate?: boolean;
+};
+export declare function resolveWorkdirByConvention(runtime: IAgentRuntime | undefined, task: string, userRequest: string): string | undefined;
+export declare function resolveWorkdirRoute(runtime: IAgentRuntime | undefined, task: string, userRequest: string): ResolvedWorkdirRoute | undefined;
+//# sourceMappingURL=task-agent-routing.d.ts.map

package/dist/node/src/services/task-agent-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-agent-routing.d.ts","sourceRoot":"","sources":["../../../../src/services/task-agent-routing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAYnD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CA4BpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACxC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,GAAG,SAAS,GACjC,MAAM,GAAG,SAAS,CAqBpB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAiCtE;AAkCD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAyDpB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,oBAAoB,GAAG,SAAS,CAgClC"}

package/dist/node/src/services/task-policy.d.ts

@@ -0,0 +1,17 @@
+import type { IAgentRuntime, Memory } from "@elizaos/core";
+type RoleName = "OWNER" | "ADMIN" | "USER" | "GUEST";
+type TaskAgentAbility = "create" | "interact";
+export declare function requireTaskAgentAccess(runtime: IAgentRuntime, message: Memory, ability: TaskAgentAbility): Promise<{
+    allowed: true;
+    connector: string | null;
+    requiredRole: RoleName;
+    actualRole: RoleName;
+} | {
+    allowed: false;
+    connector: string | null;
+    requiredRole: RoleName;
+    actualRole: RoleName;
+    reason: string;
+}>;
+export {};
+//# sourceMappingURL=task-policy.d.ts.map

package/dist/node/src/services/task-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-policy.d.ts","sourceRoot":"","sources":["../../../../src/services/task-policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3D,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AACrD,KAAK,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAC;AA2M9C,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CACN;IACE,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC;IACvB,UAAU,EAAE,QAAQ,CAAC;CACtB,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC;IACvB,UAAU,EAAE,QAAQ,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CACJ,CAyEA"}

package/dist/node/src/services/task-supervisor-service.d.ts

@@ -0,0 +1,65 @@
+/**
+ * TaskSupervisorService — the multi-task "juggler" (#8900, EPIC #8885).
+ *
+ * The orchestrator stores N tasks but nothing proactively tells the user how
+ * they're all doing — on Telegram (no side tabs) the user has to keep asking.
+ * This service ticks on an interval, scans the in-flight tasks per originating
+ * room, and posts a compact status digest back to that room — but only when the
+ * digest CHANGED since the last post, so a steady state never spams the chat.
+ *
+ * The tick logic is a pure function (`runSupervisorTick`) over injected views so
+ * it unit-tests without timers, services, or a runtime.
+ */
+import type { Content, IAgentRuntime, UUID } from "@elizaos/core";
+import { Service } from "@elizaos/core";
+import type { OrchestratorTaskStatus } from "./orchestrator-task-types.js";
+export declare const TASK_SUPERVISOR_SERVICE_TYPE = "ORCHESTRATOR_TASK_SUPERVISOR";
+export declare function statusEmoji(status: OrchestratorTaskStatus): string;
+/** A task reduced to just what a digest line needs. */
+export interface SupervisorTaskView {
+    id: string;
+    label: string;
+    status: OrchestratorTaskStatus;
+    /** Active (non-terminal) sub-agent sessions for this task. */
+    activeSessions: number;
+    /** Latest session label (often "agentType · account"), if any. */
+    sessionLabel?: string | null;
+    /** The originating chat target; null tasks (no chat origin) are skipped. */
+    origin: {
+        roomId: string;
+        source: string;
+    } | null;
+}
+/** Compose the digest body for one room's set of live tasks. Deterministic. */
+export declare function composeRoomDigest(views: SupervisorTaskView[]): string;
+export interface SupervisorTickResult {
+    /** Room ids a fresh digest was posted to this tick. */
+    posted: string[];
+    /** Room ids whose digest was unchanged (deduped, not posted). */
+    skipped: string[];
+}
+/**
+ * One supervisor tick: group live tasks by origin room, and post each room's
+ * digest only when it changed since `seen` last recorded it. Pure except for the
+ * injected `send`; mutates `seen` to remember what was posted (and prunes rooms
+ * that no longer have live tasks so a later re-activation re-posts).
+ */
+export declare function runSupervisorTick(views: SupervisorTaskView[], send: (target: {
+    source: string;
+    roomId: UUID;
+}, content: Content) => Promise<unknown>, seen: Map<string, string>): Promise<SupervisorTickResult>;
+export declare class TaskSupervisorService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private timer;
+    /** roomId → last-posted digest, for change-driven dedup. */
+    private readonly seen;
+    static start(runtime: IAgentRuntime): Promise<TaskSupervisorService>;
+    private enabled;
+    private intervalMs;
+    private startTimer;
+    /** Build views from the task service and run one dedup-aware tick. */
+    runOnce(): Promise<SupervisorTickResult>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=task-supervisor-service.d.ts.map

package/dist/node/src/services/task-supervisor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-supervisor-service.d.ts","sourceRoot":"","sources":["../../../../src/services/task-supervisor-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAsB3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAElE;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,sBAAsB,CAAC;IAC/B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAerE;AAED,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,IAAI,EAAE,CACJ,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAE,EACxC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,OAAO,CAAC,EACrB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,OAAO,CAAC,oBAAoB,CAAC,CA4C/B;AA2BD,qBAAa,qBAAsB,SAAQ,OAAO;IAChD,MAAM,CAAC,WAAW,SAAgC;IAClD,qBAAqB,SACwF;IAE7G,OAAO,CAAC,KAAK,CAA6C;IAC1D,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;WAErC,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM1E,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAQlB,sEAAsE;IAChE,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAiCxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/node/src/services/task-watchdog-service.d.ts

@@ -0,0 +1,50 @@
+/**
+ * TaskWatchdogService — stalled-sub-agent detection + auto-grill (#8901, EPIC #8885).
+ *
+ * No monitor today notices a sub-agent that has gone silent (no tool call / no
+ * snapshot update). This service ticks on an interval, finds active sessions
+ * whose last activity is older than a threshold, and prods each ONCE with a
+ * status-check prompt ("are you still working? what's blocking you?"). The
+ * stalled set is exposed so the ACTIVE_SUB_AGENTS provider can surface it.
+ *
+ * The detection is a pure function (`detectStalledSessions`) so it unit-tests
+ * without timers or a runtime.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { Service } from "@elizaos/core";
+export declare const TASK_WATCHDOG_SERVICE_TYPE = "ORCHESTRATOR_TASK_WATCHDOG";
+/** The prompt sent to a stalled sub-agent to prod it back to life. */
+export declare const STALL_GRILL_PROMPT = "Status check: you've gone quiet. Are you still working? Report your current status, what you've completed, and exactly what (if anything) is blocking you. If you're done, summarize the result.";
+/** Minimal session shape the detector needs. */
+export interface WatchdogSessionView {
+    id: string;
+    status: string;
+    /** Epoch ms of last activity (tool call / snapshot / event). */
+    lastActivityMs: number;
+}
+export interface StalledSession {
+    id: string;
+    idleMs: number;
+}
+/**
+ * Pure: which active (non-terminal) sessions have been idle longer than
+ * `stallMs` as of `nowMs`. Terminal sessions are never "stalled" — they're done.
+ */
+export declare function detectStalledSessions(sessions: WatchdogSessionView[], nowMs: number, stallMs: number): StalledSession[];
+export declare class TaskWatchdogService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private timer;
+    /** Session ids already prodded this stall, so we grill once (not every tick). */
+    private readonly prodded;
+    static start(runtime: IAgentRuntime): Promise<TaskWatchdogService>;
+    private enabled;
+    private stallMs;
+    private intervalMs;
+    private startTimer;
+    /** Session ids currently considered stalled (for the ACTIVE_SUB_AGENTS provider). */
+    getStalledSessionIds(): string[];
+    runOnce(nowMs?: number): Promise<StalledSession[]>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=task-watchdog-service.d.ts.map

package/dist/node/src/services/task-watchdog-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-watchdog-service.d.ts","sourceRoot":"","sources":["../../../../src/services/task-watchdog-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,qMACqK,CAAC;AAMrM,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CAQlB;AASD,qBAAa,mBAAoB,SAAQ,OAAO;IAC9C,MAAM,CAAC,WAAW,SAA8B;IAChD,qBAAqB,SACoE;IAEzF,OAAO,CAAC,KAAK,CAA6C;IAC1D,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;WAEhC,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMxE,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAOlB,qFAAqF;IACrF,oBAAoB,IAAI,MAAM,EAAE;IAI1B,OAAO,CAAC,KAAK,SAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA2CtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}