@elizaos/plugin-agent-orchestrator 2.0.0-alpha.5 → 2.0.0-alpha.537

package/dist/services/pty-service.d.ts

@@ -0,0 +1,206 @@
+/** @module services/pty-service */
+import { type IAgentRuntime } from "@elizaos/core";
+import { type AdapterType, type AgentFileDescriptor, type ApprovalConfig, type ApprovalPreset, type PreflightResult, type WriteMemoryOptions } from "coding-agent-adapters";
+import { PTYConsoleBridge } from "pty-console";
+import type { SessionFilter, SessionMessage } from "pty-manager";
+import type { AgentSelectionStrategy } from "./agent-selection.js";
+import { type CoordinatorNormalizedEvent } from "./coordinator-event-normalizer.js";
+import type { CodingAgentType, PTYServiceConfig, SessionEventCallback, SessionInfo, SpawnSessionOptions } from "./pty-types.js";
+import { SwarmCoordinator } from "./swarm-coordinator.js";
+import { type TaskAgentAuthLaunchResult, type TaskAgentAuthStatus } from "./task-agent-auth.js";
+import { type SupportedTaskAgentAdapter, type TaskAgentFrameworkState, type TaskAgentTaskProfileInput } from "./task-agent-frameworks.js";
+export type { CodingAgentType, PTYServiceConfig, SessionEventName, SessionInfo, SpawnSessionOptions, } from "./pty-types.js";
+export { normalizeAgentType } from "./pty-types.js";
+/**
+ * Pre-accept Claude Code's one-time trust dialog for a workdir by writing
+ * `hasTrustDialogAccepted: true` into `~/.claude.json`'s `projects` map.
+ *
+ * Why: Claude Code shows a Bypass Permissions / Trust dialog the first time
+ * it runs in any unrecognised directory. On a fresh scratch workdir that
+ * dialog is blocking: the auto-response path ends up pressing Enter, which
+ * defaults to "No, exit" and kills the subagent with exit code 1 before any
+ * work happens. Seeding the trust entry upfront skips the dialog entirely.
+ *
+ * Idempotent and best-effort: returns without throwing if the config file
+ * does not yet exist, is unreadable, or is not valid JSON. In those cases
+ * claude will show the dialog the normal way, which is no worse than before.
+ *
+ * Concurrency: serialized per config path via `claudeConfigWriteQueue` so
+ * parallel swarm spawns don't clobber each other's trust entries.
+ */
+declare function seedClaudeTrustForWorkdir(workdir: string, overrideConfigPath?: string): Promise<void>;
+export declare const seedClaudeTrustForWorkdirForTesting: typeof seedClaudeTrustForWorkdir;
+/**
+ * Retrieve the SwarmCoordinator from the PTYService registered on the runtime.
+ * Returns undefined if PTYService or coordinator is not available.
+ */
+export declare function getCoordinator(runtime: IAgentRuntime): SwarmCoordinator | undefined;
+export declare class PTYService {
+    static serviceType: string;
+    capabilityDescription: string;
+    private runtime;
+    private manager;
+    private usingBunWorker;
+    private serviceConfig;
+    private sessionNames;
+    private sessionMetadata;
+    private sessionWorkdirs;
+    private eventCallbacks;
+    private normalizedEventCallbacks;
+    private outputUnsubscribers;
+    private transcriptUnsubscribers;
+    private sessionOutputBuffers;
+    private completionReconcileTimers;
+    private completionSignalSince;
+    private terminalSessionStates;
+    private adapterCache;
+    /** Tracks the buffer index when a task was sent, so we can capture the response on completion */
+    private taskResponseMarkers;
+    /** Captures "Task completion trace" log entries from worker stderr (rolling, capped at 200) */
+    private traceEntries;
+    private static readonly MAX_TRACE_ENTRIES;
+    /** Lightweight per-agent-type metrics for observability */
+    private metricsTracker;
+    /** Active provider auth helper processes keyed by agent type. */
+    private activeAuthFlows;
+    private pendingBunList;
+    private coalescedBunList;
+    /** Pending task_complete → auto-stop timers, cancellable by the coordinator. */
+    private taskCompleteAutoStopTimers;
+    /** Background auth-recovery watchers keyed by blocked session id. */
+    private authRecoveryTimers;
+    /** Console bridge for terminal output streaming and buffered hydration */
+    consoleBridge: PTYConsoleBridge | null;
+    /** Swarm coordinator instance (if active). Accessed via getCoordinator(runtime). */
+    coordinator: SwarmCoordinator | null;
+    constructor(runtime: IAgentRuntime, config?: PTYServiceConfig);
+    static start(runtime: IAgentRuntime): Promise<PTYService>;
+    static stopRuntime(runtime: IAgentRuntime): Promise<void>;
+    private initialize;
+    stop(): Promise<void>;
+    private generateSessionId;
+    /** Build a SessionIOContext from current instance state. */
+    private ioContext;
+    /**
+     * Spawn a new PTY session for a coding agent
+     */
+    spawnSession(options: SpawnSessionOptions): Promise<SessionInfo>;
+    private autoResponseContext;
+    private pushDefaultRules;
+    private handleGeminiAuth;
+    sendToSession(sessionId: string, input: string): Promise<SessionMessage | undefined>;
+    sendKeysToSession(sessionId: string, keys: string | string[]): Promise<void>;
+    /**
+     * Cancel a pending task_complete auto-stop for this session. Returns true
+     * if a timer was cancelled, false if none was pending. Safe to call any
+     * number of times. Intended for the swarm coordinator's task_complete
+     * handler so the assessment LLM has time to decide whether to keep the
+     * session alive (respond) or stop it (complete/escalate/ignore).
+     */
+    cancelTaskCompleteAutoStop(sessionId: string): boolean;
+    stopSession(sessionId: string, force?: boolean): Promise<void>;
+    /** Default approval preset. Runtime env var takes precedence over config. */
+    get defaultApprovalPreset(): ApprovalPreset;
+    /** Agent selection strategy. Env var takes precedence. */
+    get agentSelectionStrategy(): AgentSelectionStrategy;
+    /**
+     * Default agent type when strategy is "fixed".
+     * Precedence: config file (`eliza.json` env section, written by the UI)
+     * > runtime/env setting > "claude" fallback.
+     */
+    get defaultAgentType(): AdapterType;
+    private get explicitDefaultAgentType();
+    /**
+     * Resolve which agent type to use when the caller didn't specify one.
+     *
+     * When the caller explicitly configured a fixed default agent type, fixed
+     * mode returns that pinned framework. Otherwise the resolver scores the
+     * available frameworks from task shape, auth/install state, and recent
+     * metrics so dynamic routing still works on unconfigured installs.
+     */
+    resolveAgentType(selection?: TaskAgentTaskProfileInput): Promise<string>;
+    getFrameworkState(selection?: TaskAgentTaskProfileInput): Promise<TaskAgentFrameworkState>;
+    getSession(sessionId: string): SessionInfo | undefined;
+    listSessions(filter?: SessionFilter): Promise<SessionInfo[]>;
+    subscribeToOutput(sessionId: string, callback: (data: string) => void): () => void;
+    getSessionOutput(sessionId: string, lines?: number): Promise<string>;
+    /**
+     * Whether the adapter currently classifies the session as actively
+     * processing work (e.g. Codex's "esc to interrupt" status row).
+     *
+     * The swarm idle watchdog consults this before assuming a session is
+     * idle based on output byte diffs, which are fooled by TUIs that
+     * redraw the same status row in place via cursor positioning.
+     *
+     * Returns `false` for unknown sessions or adapters that don't
+     * implement `detectLoading`. For Bun-compat mode this round-trips to
+     * the worker; for in-process mode it reads the session directly.
+     */
+    isSessionLoading(sessionId: string): Promise<boolean>;
+    private clearTranscriptCapture;
+    private resolveTaskThreadId;
+    private persistTranscript;
+    private wireTranscriptCapture;
+    isSessionBlocked(sessionId: string): boolean;
+    /**
+     * Find a PTY session ID by its working directory.
+     * Used by the HTTP hooks endpoint to correlate Claude's cwd with our session.
+     */
+    findSessionIdByCwd(cwd: string): string | undefined;
+    /**
+     * Handle an incoming hook event from Claude Code's HTTP hooks.
+     * Translates hook events into PTY service events.
+     */
+    handleHookEvent(sessionId: string, event: string, data: Record<string, unknown>): void;
+    checkAvailableAgents(types?: AdapterType[]): Promise<PreflightResult[]>;
+    getAgentAuthStatus(agentType: SupportedTaskAgentAdapter): Promise<TaskAgentAuthStatus>;
+    triggerAgentAuth(agentType: SupportedTaskAgentAdapter): Promise<TaskAgentAuthLaunchResult>;
+    startSessionAuthRecovery(sessionId: string, agentType: SupportedTaskAgentAdapter, login: {
+        instructions?: string;
+        url?: string;
+        deviceCode?: string;
+        method?: string;
+        promptSnippet?: string;
+    }): Promise<TaskAgentAuthLaunchResult & {
+        recoveryStarted: boolean;
+        status: "recovered" | "recovering" | "failed";
+    }>;
+    private monitorSessionAuthRecovery;
+    private resumeSessionAfterRecoveredAuth;
+    getSupportedAgentTypes(): CodingAgentType[];
+    private classifyStall;
+    private getAdapter;
+    getWorkspaceFiles(agentType: AdapterType): AgentFileDescriptor[];
+    getMemoryFilePath(agentType: AdapterType): string;
+    getApprovalConfig(agentType: AdapterType, preset: ApprovalPreset): ApprovalConfig;
+    writeMemoryFile(agentType: AdapterType, workspacePath: string, content: string, options?: WriteMemoryOptions): Promise<string>;
+    /** Marker comment used to detect orchestrator-managed gitignore entries. */
+    private static readonly GITIGNORE_MARKER;
+    /** Per-path lock to serialize concurrent gitignore updates for the same workdir. */
+    private static gitignoreLocks;
+    /**
+     * Ensure that orchestrator-injected files (CLAUDE.md, .claude/, GEMINI.md, etc.)
+     * are listed in the workspace .gitignore so agents don't commit them.
+     * Appends to an existing .gitignore or creates one. Idempotent: skips if
+     * the marker comment is already present. Serialized per-path to prevent
+     * duplicate entries from concurrent spawns.
+     */
+    private ensureOrchestratorGitignore;
+    private doEnsureGitignore;
+    onSessionEvent(callback: SessionEventCallback): () => void;
+    onNormalizedSessionEvent(callback: (event: CoordinatorNormalizedEvent) => void): () => void;
+    registerAdapter(adapter: unknown): void;
+    private toSessionInfo;
+    private toTerminalSessionInfo;
+    private emitEvent;
+    getAgentMetrics(): Record<string, Omit<import("./agent-metrics.js").AgentMetrics, "totalCompletionMs">>;
+    private log;
+    private handleWorkerExit;
+    private clearCompletionReconcile;
+    private scheduleCompletionReconcile;
+    private isAdapterBackedAgentType;
+    private shouldSuppressBlockedEvent;
+    private responseLooksMeaningful;
+    private reconcileBusySessionFromOutput;
+}
+//# sourceMappingURL=pty-service.d.ts.map

package/dist/services/pty-service.d.ts.map

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

package/dist/services/pty-session-io.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Session I/O helpers — extracted from PTYService for maintainability.
+ *
+ * Standalone functions for sending input/keys to sessions and stopping
+ * sessions. Each function takes a {@link SessionIOContext} that provides
+ * the manager instance and shared state maps.
+ *
+ * @module services/pty-session-io
+ */
+import type { BunCompatiblePTYManager, PTYManager, SessionMessage } from "pty-manager";
+/**
+ * Shared context required by all session I/O functions.
+ * Built inline from PTYService instance fields.
+ */
+export interface SessionIOContext {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+    sessionOutputBuffers: Map<string, string[]>;
+    taskResponseMarkers: Map<string, number>;
+    outputUnsubscribers: Map<string, () => void>;
+}
+/**
+ * Send text input to a session.
+ *
+ * Marks the buffer position for task response capture, then writes the
+ * input via the appropriate manager API.
+ */
+export declare function sendToSession(ctx: SessionIOContext, sessionId: string, input: string): Promise<SessionMessage | undefined>;
+/**
+ * Send key sequences to a session (for special keys like arrows, enter, etc.).
+ */
+export declare function sendKeysToSession(ctx: SessionIOContext, sessionId: string, keys: string | string[]): Promise<void>;
+/**
+ * Stop a PTY session and clean up all associated state.
+ *
+ * @param force - When true, sends SIGKILL immediately instead of SIGTERM.
+ *   Use for sessions whose task is already complete — there's nothing to save.
+ */
+export declare function stopSession(ctx: SessionIOContext, sessionId: string, sessionMetadata: Map<string, Record<string, unknown>>, sessionWorkdirs: Map<string, string>, log: (msg: string) => void, force?: boolean): Promise<void>;
+/**
+ * Subscribe to live output from a session.
+ * Returns an unsubscribe function.
+ */
+export declare function subscribeToOutput(ctx: SessionIOContext, sessionId: string, callback: (data: string) => void): () => void;
+/**
+ * Get buffered or logged output from a session.
+ */
+export declare function getSessionOutput(ctx: SessionIOContext, sessionId: string, lines?: number): Promise<string>;
+//# sourceMappingURL=pty-session-io.d.ts.map

package/dist/services/pty-session-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-session-io.d.ts","sourceRoot":"","sources":["../../src/services/pty-session-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoBrC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC1B,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAqDf;AAkCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B,MAAM,IAAI,CAiBZ;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/services/pty-spawn.d.ts

@@ -0,0 +1,113 @@
+/**
+ * PTY session spawning logic — extracted from PTYService for maintainability.
+ *
+ * Contains the deferred task delivery, retry logic, per-agent settle delays,
+ * and session buffer setup that runs during spawnSession().
+ *
+ * @module services/pty-spawn
+ */
+import type { AdapterType, BaseCodingAdapter } from "coding-agent-adapters";
+import type { BunCompatiblePTYManager, PTYManager, SessionHandle, SpawnConfig, WorkerSessionHandle } from "pty-manager";
+import type { PTYServiceConfig, SessionInfo, SpawnSessionOptions } from "./pty-types.js";
+interface OrchestratorPoolShim {
+    pickAnthropicTokenForSpawn(opts: {
+        sessionKey: string;
+    }): Promise<{
+        accessToken: string;
+        accountId: string;
+    } | null>;
+    markRateLimited(accountId: string, untilMs: number, detail?: string): void;
+    markInvalid(accountId: string, detail?: string): void;
+    markNeedsReauth(accountId: string, detail?: string): void;
+}
+export declare function getOrchestratorAccountPoolShim(): OrchestratorPoolShim | undefined;
+/**
+ * Inspect a chunk of session output for auth-related failure signatures.
+ * Returns the kind of failure detected (or null) so the caller can mark
+ * the supplied `accountId` via the pool. Pattern matching is best-effort
+ * and intentionally narrow: we only flag accounts when we're confident
+ * the subprocess saw a real auth error.
+ */
+export declare function detectAuthFailureKind(data: string): "rate-limited" | "invalid" | "needs-reauth" | null;
+/**
+ * Build a sanitized base environment from process.env, keeping only
+ * safe system variables. Agent-specific credentials are injected
+ * separately by the adapter's getEnv().
+ *
+ * On Windows, the sanitized env may have lost the per-package-manager bin
+ * directories that hold `claude.cmd` / `codex.cmd` (npm global, Codex
+ * managed install, scoop shims, chocolatey bin). Route through
+ * `appendWindowsPathFallbacks` to add those back after the allowlist copy.
+ */
+export declare function buildSanitizedBaseEnv(): Record<string, string>;
+/**
+ * Directories that Windows package managers drop `claude.cmd` / `codex.cmd`
+ * / `codex.exe` into. We append these to the sanitized PATH so `cmd.exe`
+ * (via the `shell: true` flag on execFile/spawn for win32) can resolve the
+ * CLI binaries even when the user's PATH has been stripped down by the
+ * ENV_ALLOWLIST-then-systemd-unit chain or otherwise missing the install
+ * location. Each entry is a no-op on non-Windows and a no-op when the
+ * parent env var the path depends on is unset.
+ *
+ * Coverage, in order of popularity for claude/codex installs:
+ *   - npm global (%APPDATA%\npm) — the official CLAUDE_CODE install path
+ *   - Codex managed install (%LOCALAPPDATA%\OpenAI\Codex\bin)
+ *   - Scoop (%USERPROFILE%\scoop\shims)
+ *   - Chocolatey (%ProgramData%\chocolatey\bin)
+ *   - Bun global (%USERPROFILE%\.bun\bin)
+ */
+export declare function getWindowsPathFallbacks(): string[];
+/**
+ * Append each fallback path to `currentPath` if it isn't already present.
+ * Windows PATH matching is case-insensitive, so dedupe on the lowercased
+ * form but preserve the original casing in the output. Returns `undefined`
+ * when the resulting PATH would be empty (neither argument had content), so
+ * callers can skip assigning an empty string.
+ */
+export declare function appendWindowsPathFallbacks(currentPath: string | undefined): string | undefined;
+/**
+ * Pure PATH-merge helper: dedupe existing + extras, preserve insertion
+ * order and casing. Exported for unit tests so we can exercise the merge
+ * logic without stubbing `process.platform`.
+ */
+export declare function mergePathEntries(currentPath: string | undefined, extras: readonly string[], opts: {
+    delimiter: string;
+    caseInsensitive: boolean;
+}): string | undefined;
+export interface SpawnContext {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+    serviceConfig: PTYServiceConfig;
+    sessionMetadata: Map<string, Record<string, unknown>>;
+    sessionWorkdirs: Map<string, string>;
+    sessionOutputBuffers: Map<string, string[]>;
+    outputUnsubscribers: Map<string, () => void>;
+    taskResponseMarkers: Map<string, number>;
+    getAdapter: (agentType: AdapterType) => BaseCodingAdapter;
+    sendToSession: (sessionId: string, input: string) => Promise<unknown>;
+    sendKeysToSession: (sessionId: string, keys: string | string[]) => Promise<void>;
+    writeRawToSession: (sessionId: string, data: string) => Promise<void>;
+    pushDefaultRules: (sessionId: string, agentType: string) => Promise<void>;
+    toSessionInfo: (session: SessionHandle | WorkerSessionHandle, workdir?: string) => SessionInfo;
+    log: (msg: string) => void;
+    /** Mark a session's task as delivered in the coordinator. */
+    markTaskDelivered: (sessionId: string) => void;
+}
+/**
+ * Set up session output buffering for Bun worker path.
+ */
+export declare function setupOutputBuffer(ctx: SpawnContext, sessionId: string): void;
+/**
+ * Set up deferred task delivery with retry logic.
+ * IMPORTANT: Must be called BEFORE pushDefaultRules (which has a 1500ms sleep),
+ * otherwise session_ready fires during pushDefaultRules and the listener misses it.
+ */
+export declare function setupDeferredTaskDelivery(ctx: SpawnContext, session: SessionHandle | WorkerSessionHandle, task: string, agentType: string): void;
+/**
+ * Build the SpawnConfig and env vars from SpawnSessionOptions.
+ */
+export declare function buildSpawnConfig(sessionId: string, options: SpawnSessionOptions, workdir: string): SpawnConfig & {
+    id: string;
+};
+export {};
+//# sourceMappingURL=pty-spawn.d.ts.map

package/dist/services/pty-spawn.d.ts.map

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

package/dist/services/pty-types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared types and helpers for the PTY service layer.
+ *
+ * Extracted from pty-service.ts to keep that module lean and allow
+ * other modules (pty-spawn, pty-init, actions) to import lightweight
+ * type-only dependencies without pulling in the full PTYService class.
+ *
+ * @module services/pty-types
+ */
+import type { AdapterType, AgentCredentials, ApprovalPreset } from "coding-agent-adapters";
+import type { SessionHandle } from "pty-manager";
+export interface PTYServiceConfig {
+    /** Maximum output lines to keep per session (default: 1000) */
+    maxLogLines?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Auto-register task-agent adapters (default: true) */
+    registerCodingAdapters?: boolean;
+    /** Maximum concurrent PTY sessions (default: 8) */
+    maxConcurrentSessions?: number;
+    /**
+     * Default approval preset for task agents when not specified per-spawn.
+     * Controls what tools the agent can use without asking for permission.
+     *   - "readonly"   — Read-only tools only
+     *   - "standard"   — Read + write, asks for shell/network
+     *   - "permissive" — Most tools auto-approved, asks for destructive ops
+     *   - "autonomous" — All tools auto-approved (yolo mode)
+     * Default: "autonomous"
+     */
+    defaultApprovalPreset?: ApprovalPreset;
+}
+/** Available task-agent types */
+export type CodingAgentType = "shell" | "pi" | "opencode" | AdapterType;
+/** True when the user requested the Pi coding agent. */
+export declare const isPiAgentType: (input: string | undefined | null) => boolean;
+/** True when the user requested the OpenCode agent. */
+export declare const isOpencodeAgentType: (input: string | undefined | null) => boolean;
+/** Normalize user-provided agent type string to a valid CodingAgentType */
+export declare const normalizeAgentType: (input: string) => CodingAgentType;
+/** Build the initial shell command for Pi agent sessions. */
+export declare const toPiCommand: (task: string | undefined) => string;
+/**
+ * Build the initial shell command for OpenCode agent sessions.
+ *
+ * `--dangerously-skip-permissions` is a flag of the `run` subcommand
+ * (NOT the top-level opencode command), so it must come AFTER `run` —
+ * verified live with opencode 1.14.33 + ollama qwen2.5-coder:0.5b.
+ *
+ * Model + provider selection comes from the OPENCODE_CONFIG_CONTENT env
+ * var that the spawn pipeline injects — see buildOpencodeSpawnConfig in
+ * `agent-credentials.ts`.
+ */
+export declare const toOpencodeCommand: (task: string | undefined) => string;
+export interface SpawnSessionOptions {
+    /** Human-readable session name */
+    name: string;
+    /** Adapter type: "shell" | "pi" | "opencode" | "claude" | "gemini" | "codex" | "aider" */
+    agentType: CodingAgentType;
+    /** Working directory for the session */
+    workdir?: string;
+    /** Initial command/task to send */
+    initialTask?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Session metadata for tracking */
+    metadata?: Record<string, unknown>;
+    /** Credentials for coding agents (API keys, tokens) */
+    credentials?: AgentCredentials;
+    /** Memory/instructions content to write to the agent's memory file before spawning */
+    memoryContent?: string;
+    /** Approval preset controlling tool permissions (readonly, standard, permissive, autonomous) */
+    approvalPreset?: ApprovalPreset;
+    /** Custom credentials for MCP servers or other integrations */
+    customCredentials?: Record<string, string>;
+    /** When true, adapter-level blocking prompts (tool permissions, file access)
+     *  are emitted with autoResponded=false instead of being auto-handled.
+     *  Used by the swarm coordinator to route decisions through its LLM loop. */
+    skipAdapterAutoResponse?: boolean;
+}
+export interface SessionInfo {
+    id: string;
+    name: string;
+    agentType: string;
+    workdir: string;
+    status: SessionHandle["status"];
+    createdAt: Date;
+    lastActivityAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/** Known event names emitted by the PTY layer. */
+export type SessionEventName = "ready" | "blocked" | "login_required" | "task_complete" | "tool_running" | "stopped" | "error" | "message";
+type SessionEventCallback = (sessionId: string, event: string, data: unknown) => void;
+export type { SessionEventCallback };
+//# sourceMappingURL=pty-types.d.ts.map

package/dist/services/pty-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-types.d.ts","sourceRoot":"","sources":["../../src/services/pty-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC;AASxE,wDAAwD;AACxD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAGhE,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAC/B,OAGF,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,eAwBlD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAKtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAK5D,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,SAAS,EAAE,eAAe,CAAC;IAC3B,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uDAAuD;IACvD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C;;iFAE6E;IAC7E,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,SAAS,GACT,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAEd,KAAK,oBAAoB,GAAG,CAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,KACV,IAAI,CAAC;AAEV,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/services/repo-input.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Repository input normalization for coding task workspaces.
+ *
+ * Accepts canonical clone URLs plus common shorthand forms such as:
+ * - owner/repo
+ * - github.com/owner/repo
+ * - https://github.com/owner/repo
+ *
+ * Bare owner/repo inputs default to GitHub because the coding workspace
+ * flows in this plugin are GitHub-centric.
+ *
+ * @module services/repo-input
+ */
+export declare function normalizeRepositoryInput(repo: string): string;
+export declare function diagnoseWorkspaceBootstrapFailure(repo: string, errorMessage: string): string;
+//# sourceMappingURL=repo-input.d.ts.map

package/dist/services/repo-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-input.d.ts","sourceRoot":"","sources":["../../src/services/repo-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqD7D;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,MAAM,CAmDR"}

package/dist/services/session-event-queue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Per-session async serialization queue.
+ * Ensures only one event is processed at a time per session.
+ */
+export interface QueuedEvent {
+    sessionId: string;
+    type: "blocked" | "turn_complete";
+    data: unknown;
+    enqueuedAt: number;
+}
+export declare class SessionEventQueue {
+    private queues;
+    private processing;
+    private handler;
+    private logger;
+    constructor(handler: (event: QueuedEvent) => Promise<void>, logger?: {
+        warn: (msg: string) => void;
+    });
+    enqueue(event: QueuedEvent): void;
+    isProcessing(sessionId: string): boolean;
+    clear(sessionId?: string): void;
+    pendingCount(sessionId: string): number;
+    private processLoop;
+}
+//# sourceMappingURL=session-event-queue.d.ts.map

package/dist/services/session-event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-queue.d.ts","sourceRoot":"","sources":["../../src/services/session-event-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,eAAe,CAAC;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAAkC;gBAG9C,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,EAC9C,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE;IAM1C,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAajC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ/B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;YAIzB,WAAW;CA6B1B"}

package/dist/services/skill-callback-bridge.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Skill callback bridge — child→parent USE_SKILL routing.
+ *
+ * Spawned task agents (Claude Code, Codex, Gemini CLI, etc.) cannot directly
+ * invoke parent skills. The bridge listens to PTY session output and, when
+ * the child emits a directive of the form
+ *
+ *   USE_SKILL <slug> <json_args>
+ *
+ * dispatches to the parent's USE_SKILL action and pipes the result back into
+ * the same session via `ptyService.sendToSession`.
+ *
+ * Default-on per the Hermes-style project direction. Disable by setting
+ * `ELIZA_ENABLE_CHILD_SKILL_CALLBACK=0`.
+ *
+ * @module services/skill-callback-bridge
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { PTYService } from "./pty-service.js";
+interface SkillCallbackInvocation {
+    slug: string;
+    args: unknown;
+}
+/**
+ * Parse the first USE_SKILL directive in a chunk of agent output, if any.
+ * The directive must be on its own line (after optional whitespace).
+ */
+export declare function parseUseSkillDirective(text: string): SkillCallbackInvocation | null;
+interface BridgeDeps {
+    runtime: IAgentRuntime;
+    ptyService: PTYService;
+    /**
+     * Optional: per-session allow-list of skill slugs. The bridge consults the
+     * registry below when dispatching a child USE_SKILL directive. A directive
+     * whose slug is not on the session's allow-list is rejected back into the
+     * child with an error message listing the recommended slugs.
+     *
+     * If omitted (or no entry is registered for the session), the bridge falls
+     * back to permissive behavior — any enabled skill may be invoked. This
+     * preserves backwards-compatible behavior for callers that do not yet wire
+     * per-spawn recommendations.
+     */
+    sessionAllowList?: SkillSessionAllowList;
+}
+/**
+ * Session-scoped allow-list registry. Callers register a session's allow-list
+ * at spawn time (see `coding-task-handlers.ts` after
+ * `recommendSkillsForTask`). The bridge reads the entry when a USE_SKILL
+ * directive arrives.
+ *
+ * Using a plain Map instead of a WeakMap — the key is the PTY sessionId
+ * string assigned at spawn time, which we must explicitly clear on session
+ * teardown to avoid leaks.
+ */
+export interface SkillSessionAllowList {
+    register: (sessionId: string, slugs: readonly string[]) => void;
+    clear: (sessionId: string) => void;
+    get: (sessionId: string) => readonly string[] | undefined;
+}
+export declare function createSkillSessionAllowList(): SkillSessionAllowList;
+/**
+ * Ensure the bridge is installed exactly once for this runtime+PTY pair.
+ * Safe to call from every task spawn — subsequent calls are no-ops. The
+ * session allow-list registry, when supplied, is attached on the first
+ * install and reused thereafter; callers can look up the registry they
+ * passed in to register per-session slugs.
+ */
+export declare function ensureSkillCallbackBridge(deps: BridgeDeps): void;
+/**
+ * Install the child→parent USE_SKILL bridge for the given PTY service. Safe
+ * to call multiple times — duplicate listeners are idempotent because the
+ * unsubscribe handle is returned to the caller.
+ *
+ * Returns a teardown function. Call it on shutdown to remove the listener.
+ */
+export declare function installSkillCallbackBridge(deps: BridgeDeps): () => void;
+export {};
+//# sourceMappingURL=skill-callback-bridge.d.ts.map

package/dist/services/skill-callback-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-callback-bridge.d.ts","sourceRoot":"","sources":["../../src/services/skill-callback-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAU,aAAa,EAAU,MAAM,eAAe,CAAC;AAKnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiBnD,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAsBD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,uBAAuB,GAAG,IAAI,CAmBhC;AAkCD,UAAU,UAAU;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAWnE;AASD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CA0JvE"}

package/dist/services/skill-essentials.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Auto-injected subset of `assets/claude-code-skills/eliza-runtime/SKILL.md`
+ * that ships verbatim in the workspace-lock brief for claude sub-agents.
+ *
+ * Why a separate constant (and not just a Read of SKILL.md at runtime):
+ * sub-agents on the Claude.ai consumer-tier OAuth do not have the `Skill`
+ * tool, so the skill auto-load mechanism is unavailable to them. Inlining
+ * the must-have sections into the spawn brief gives them the operating
+ * manual upfront with zero file I/O.
+ *
+ * Keep this in sync with SKILL.md: when you edit one, edit both. SKILL.md
+ * remains the canonical / extended manual (spawn-variants table, helper
+ * scripts, references). This constant is the always-injected minimum.
+ */
+export declare const CLAUDE_SKILL_ESSENTIALS = "Tool availability varies by Claude Code build and account tier \u2014 enumerate your actual tools (read `.claude/settings.json`'s `permissions.allow`, or use `ToolSearch` if present) before deciding you can't do a thing.\n\n# DECISION protocol\n\nThe orchestrator greps your stdout for lines starting with `DECISION:`. Use them when you make an architectural choice not covered by the brief, or when reporting a hard limitation. Examples:\n\n```\nDECISION: chose /api/v1/messages/ over /messages/ to match existing eliza-cloud route prefix.\nDECISION: cannot run shell commands \u2014 this session has Read/Grep/Glob but no Bash, Monitor, or run_shell_command. Reported what I could find statically.\n```\n\nALWAYS-on, no shell tool required \u2014 just print the line.\n\n# What you should NEVER do\n\n- Refuse a task as \"no shell available\" without first enumerating your actual tool list (settings.json + ToolSearch). Different tiers ship different shell tools \u2014 `Bash`, `Monitor`, `run_shell_command` \u2014 at least one is usually present.\n- Say \"use the `!` prefix\" or \"run this in your terminal\" \u2014 there is no terminal in your face.\n- Ask the human to clarify or provide input \u2014 there is no human in your session.\n- Push to remotes, write outside workdir, print env tokens.\n- Treat partial information as a blocker \u2014 produce the best output you can with what you have.\n\n# Bridge endpoints (parent state, read-only)\n\nWhen HTTP hooks are wired (variants `swarm` and `repo`), GET these to query parent state:\n- `http://localhost:${ELIZA_HOOK_PORT:-2138}/api/coding-agents/$PARALLAX_SESSION_ID/parent-context` \u2014 agent character, originating room, original task\n- `.../memory?q=<query>&limit=<N>` \u2014 recent messages from the originating room\n- `.../active-workspaces` \u2014 sibling sub-agents (swarm only)\n\nAuth is the path-embedded session id. Loopback-only, GET-only, read-only.\n\n# Constraints\n\n- Sealed env: only an allowlist of vars is forwarded (PATH, HOME, USER, SHELL, ANTHROPIC_MODEL, GITHUB_TOKEN, PARALLAX_SESSION_ID, ELIZA_HOOK_PORT, etc.).\n- Workspace-only writes: write only inside your workdir.\n- Don't push to git remotes \u2014 Eliza handles git push, PR creation, cross-repo coordination.\n- Don't print secrets \u2014 PTY output is captured. Reference secrets by env-var name.\n\nFor deeper context (spawn-variants table, helper scripts, references) see `~/.claude/skills/eliza-runtime/SKILL.md`.";
+//# sourceMappingURL=skill-essentials.d.ts.map