@elizaos/plugin-coding-agent 0.1.0-next.0

package/dist/src/services/pty-init.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PTY manager initialization — extracted from PTYService.initialize().
+ *
+ * Creates either a BunCompatiblePTYManager (for Bun runtime) or PTYManager
+ * (for Node), wires up event handlers, and returns the configured manager.
+ *
+ * @module services/pty-init
+ */
+import { BunCompatiblePTYManager, PTYManager, type StallClassification } from "pty-manager";
+import type { PTYServiceConfig } from "./pty-types.js";
+/**
+ * All callbacks and state that the initialization logic needs
+ * from the surrounding PTYService instance.
+ */
+export interface InitContext {
+    serviceConfig: PTYServiceConfig;
+    classifyStall: (sessionId: string, recentOutput: string) => Promise<StallClassification | null>;
+    emitEvent: (sessionId: string, event: string, data: unknown) => void;
+    handleGeminiAuth: (sessionId: string) => void;
+    sessionOutputBuffers: Map<string, string[]>;
+    taskResponseMarkers: Map<string, number>;
+    metricsTracker: {
+        recordCompletion(type: string, method: string, durationMs: number): void;
+    };
+    traceEntries: Array<string | Record<string, unknown>>;
+    maxTraceEntries: number;
+    log: (msg: string) => void;
+}
+/** Value returned by {@link initializePTYManager}. */
+export interface InitResult {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+}
+/**
+ * Create and configure a PTY manager for the current runtime.
+ *
+ * - **Bun**: instantiates a {@link BunCompatiblePTYManager} that spawns a
+ *   Node worker process and communicates via JSON-RPC over stdio.
+ * - **Node**: instantiates a {@link PTYManager} directly and registers
+ *   all built-in adapters in-process.
+ */
+export declare function initializePTYManager(ctx: InitContext): Promise<InitResult>;
+//# sourceMappingURL=pty-init.d.ts.map

package/dist/src/services/pty-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-init.d.ts","sourceRoot":"","sources":["../../../src/services/pty-init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,uBAAuB,EAEvB,UAAU,EAKV,KAAK,mBAAmB,EAGzB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAcvD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,gBAAgB,CAAC;IAChC,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACrE,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,cAAc,EAAE;QACd,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1E,CAAC;IACF,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAgPrB"}

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

@@ -0,0 +1,92 @@
+/** @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 { CodingAgentType, PTYServiceConfig, SessionEventCallback, SessionInfo, SpawnSessionOptions } from "./pty-types.js";
+import { SwarmCoordinator } from "./swarm-coordinator.js";
+export type { CodingAgentType, PTYServiceConfig, SessionEventName, SessionInfo, SpawnSessionOptions, } from "./pty-types.js";
+export { normalizeAgentType } from "./pty-types.js";
+/**
+ * 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 sessionMetadata;
+    private sessionWorkdirs;
+    private eventCallbacks;
+    private outputUnsubscribers;
+    private sessionOutputBuffers;
+    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;
+    /** 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>;
+    stopSession(sessionId: string): 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" — env var takes precedence. */
+    get defaultAgentType(): AdapterType;
+    /**
+     * Resolve which agent type to use when the caller didn't specify one.
+     *
+     * - **fixed**: returns `defaultAgentType` immediately
+     * - **ranked**: fetches preflight data, scores installed agents via
+     *   metrics, and returns the highest scorer
+     */
+    resolveAgentType(): Promise<string>;
+    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>;
+    isSessionBlocked(sessionId: string): boolean;
+    checkAvailableAgents(types?: AdapterType[]): Promise<PreflightResult[]>;
+    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>;
+    onSessionEvent(callback: SessionEventCallback): () => void;
+    registerAdapter(adapter: unknown): void;
+    private toSessionInfo;
+    private emitEvent;
+    getAgentMetrics(): Record<string, Omit<import("./agent-metrics.js").AgentMetrics, "totalCompletionMs">>;
+    private log;
+}
+//# sourceMappingURL=pty-service.d.ts.map

package/dist/src/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/src/services/pty-session-io.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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.
+ */
+export declare function stopSession(ctx: SessionIOContext, sessionId: string, sessionMetadata: Map<string, Record<string, unknown>>, sessionWorkdirs: Map<string, string>, log: (msg: string) => void): 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/src/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;AAEH,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;;GAEG;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,GACzB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;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/src/services/pty-spawn.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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";
+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>;
+    pushDefaultRules: (sessionId: string, agentType: string) => Promise<void>;
+    toSessionInfo: (session: SessionHandle | WorkerSessionHandle, workdir?: string) => SessionInfo;
+    log: (msg: 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;
+};
+//# sourceMappingURL=pty-spawn.d.ts.map

package/dist/src/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":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,gBAAgB,CAAC;IAChC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,iBAAiB,CAAC;IAC1D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,iBAAiB,EAAE,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,aAAa,EAAE,CACb,OAAO,EAAE,aAAa,GAAG,mBAAmB,EAC5C,OAAO,CAAC,EAAE,MAAM,KACb,WAAW,CAAC;IACjB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAc5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,aAAa,GAAG,mBAAmB,EAC5C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,IAAI,CAkFN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CA0C9B"}

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

@@ -0,0 +1,80 @@
+/**
+ * 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 coding agent adapters (default: true) */
+    registerCodingAdapters?: boolean;
+    /** Maximum concurrent PTY sessions (default: 8) */
+    maxConcurrentSessions?: number;
+    /**
+     * Default approval preset for coding 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: "permissive"
+     */
+    defaultApprovalPreset?: ApprovalPreset;
+}
+/** Available coding agent types */
+export type CodingAgentType = "shell" | "pi" | AdapterType;
+/** True when the user requested the Pi coding agent. */
+export declare const isPiAgentType: (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;
+export interface SpawnSessionOptions {
+    /** Human-readable session name */
+    name: string;
+    /** Adapter type: "shell" | "pi" | "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/src/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,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,CAAC;AAU3D,wDAAwD;AACxD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAGhE,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,eAoBlD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAKtD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,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/src/services/stall-classifier.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Stall classification subsystem — determines what a "stalled" coding agent
+ * session is doing (finished, waiting for input, still working, or errored).
+ *
+ * Extracted as standalone functions that receive dependencies as parameters,
+ * making them easy to test without coupling to PTYService.
+ *
+ * @module services/stall-classifier
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+import { type StallClassification } from "pty-manager";
+import type { AgentMetricsTracker } from "./agent-metrics.js";
+/** Everything the classifier needs, passed in from PTYService. */
+export interface StallClassifierContext {
+    sessionId: string;
+    recentOutput: string;
+    agentType: string;
+    buffers: Map<string, string[]>;
+    traceEntries: Array<string | Record<string, unknown>>;
+    runtime: IAgentRuntime;
+    manager: {
+        get(id: string): {
+            startedAt?: string | Date;
+        } | null | undefined;
+    } | null;
+    metricsTracker: AgentMetricsTracker;
+    /** Write debug snapshots to ~/.milaidy/debug/ on stall (default: false) */
+    debugSnapshots?: boolean;
+    log: (msg: string) => void;
+}
+/**
+ * Build the LLM system prompt used to classify stalled output.
+ */
+export declare function buildStallClassificationPrompt(agentType: string, sessionId: string, output: string): string;
+/**
+ * Write a debug snapshot to ~/.milaidy/debug/ for offline stall analysis.
+ */
+export declare function writeStallSnapshot(sessionId: string, agentType: string, recentOutput: string, effectiveOutput: string, buffers: Map<string, string[]>, traceEntries: Array<string | Record<string, unknown>>, log: (msg: string) => void): Promise<void>;
+/**
+ * Main stall classification logic. Determines what a stalled session is doing
+ * by checking the buffer, building a prompt, and asking the LLM.
+ */
+export declare function classifyStallOutput(ctx: StallClassifierContext): Promise<StallClassification | null>;
+//# sourceMappingURL=stall-classifier.d.ts.map

package/dist/src/services/stall-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-classifier.d.ts","sourceRoot":"","sources":["../../../src/services/stall-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG;YAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,GAAG,SAAS,CAAC;KACnE,GAAG,IAAI,CAAC;IACT,cAAc,EAAE,mBAAmB,CAAC;IACpC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAmCR;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAiGrC"}

package/dist/src/services/swarm-coordinator-prompts.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Prompt construction and response parsing for the Swarm Coordinator's
+ * LLM-driven coordination decisions.
+ *
+ * Pure functions — no side effects, easy to test.
+ * Pattern follows stall-classifier.ts:buildStallClassificationPrompt().
+ *
+ * @module services/swarm-coordinator-prompts
+ */
+/** Per-session task context provided to the LLM for decision-making. */
+export interface TaskContextSummary {
+    sessionId: string;
+    agentType: string;
+    label: string;
+    originalTask: string;
+    workdir: string;
+}
+/** A previous coordination decision, included for context continuity. */
+export interface DecisionHistoryEntry {
+    event: string;
+    promptText: string;
+    action: string;
+    response?: string;
+    reasoning: string;
+}
+/** Parsed LLM response for a coordination decision. */
+export interface CoordinationLLMResponse {
+    action: "respond" | "escalate" | "ignore" | "complete";
+    /** Text to send (for action=respond with plain text input). */
+    response?: string;
+    /** Whether to use sendKeysToSession instead of sendToSession. */
+    useKeys?: boolean;
+    /** Key sequence to send (for TUI interactions). e.g. ["enter"] or ["down","enter"]. */
+    keys?: string[];
+    /** LLM's reasoning for the decision. */
+    reasoning: string;
+}
+/**
+ * Build the LLM prompt for making a coordination decision about a blocked agent.
+ */
+export declare function buildCoordinationPrompt(taskCtx: TaskContextSummary, promptText: string, recentOutput: string, decisionHistory: DecisionHistoryEntry[]): string;
+/**
+ * Build the LLM prompt for checking on an idle session that hasn't
+ * produced any events for a while.
+ */
+export declare function buildIdleCheckPrompt(taskCtx: TaskContextSummary, recentOutput: string, idleMinutes: number, idleCheckNumber: number, maxIdleChecks: number, decisionHistory: DecisionHistoryEntry[]): string;
+/**
+ * Build the LLM prompt for assessing whether a completed turn means the
+ * overall task is done, or if the agent needs more turns.
+ *
+ * Called when the adapter detects "task_complete" (agent finished a turn and
+ * returned to the idle prompt). The LLM decides whether to stop the session
+ * or send a follow-up instruction.
+ */
+export declare function buildTurnCompletePrompt(taskCtx: TaskContextSummary, turnOutput: string, decisionHistory: DecisionHistoryEntry[]): string;
+/**
+ * Parse the LLM's coordination response from raw text output.
+ * Returns null if the response is invalid or unparseable.
+ */
+export declare function parseCoordinationResponse(llmOutput: string): CoordinationLLMResponse | null;
+//# sourceMappingURL=swarm-coordinator-prompts.d.ts.map

package/dist/src/services/swarm-coordinator-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-coordinator-prompts.d.ts","sourceRoot":"","sources":["../../../src/services/swarm-coordinator-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,oBAAoB,EAAE,GACtC,MAAM,CAmDR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,oBAAoB,EAAE,GACtC,MAAM,CA4CR;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,oBAAoB,EAAE,GACtC,MAAM,CAgER;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,uBAAuB,GAAG,IAAI,CA+BhC"}

package/dist/src/services/swarm-coordinator.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Swarm Coordinator — Event Bridge & Autonomous Coordination Loop
+ *
+ * Bridges PTY session events to:
+ * 1. SSE clients (frontend dashboard) for real-time status
+ * 2. LLM coordination decisions for unhandled blocking prompts
+ *
+ * The coordinator subscribes to PTYService session events and:
+ * - Skips events already handled by auto-response rules (autoResponded=true)
+ * - Routes unhandled blocking prompts through supervision levels:
+ *   - autonomous: LLM decides immediately
+ *   - confirm: queued for human approval
+ *   - notify: broadcast only (no action)
+ *
+ * Heavy logic is extracted into:
+ * - swarm-decision-loop.ts  (blocked, turn-complete, LLM decisions)
+ * - swarm-idle-watchdog.ts  (idle session scanning)
+ *
+ * @module services/swarm-coordinator
+ */
+import type { ServerResponse } from "node:http";
+import type { IAgentRuntime } from "@elizaos/core";
+import type { PTYService } from "./pty-service.js";
+import type { CodingAgentType } from "./pty-types.js";
+import type { CoordinationLLMResponse } from "./swarm-coordinator-prompts.js";
+/** Callback injected by server.ts to route chat messages to the user's conversation. */
+export type ChatMessageCallback = (text: string, source?: string) => Promise<void>;
+/** Callback injected by server.ts to relay coordinator events to WebSocket clients. */
+export type WsBroadcastCallback = (event: SwarmEvent) => void;
+export type SupervisionLevel = "autonomous" | "confirm" | "notify";
+export interface TaskContext {
+    sessionId: string;
+    agentType: CodingAgentType;
+    label: string;
+    originalTask: string;
+    workdir: string;
+    status: "active" | "completed" | "error" | "stopped";
+    decisions: CoordinationDecision[];
+    autoResolvedCount: number;
+    registeredAt: number;
+    /** Timestamp of the last session event (any type). Used by idle watchdog. */
+    lastActivityAt: number;
+    /** How many idle checks have been performed on this session. */
+    idleCheckCount: number;
+}
+export interface CoordinationDecision {
+    timestamp: number;
+    event: string;
+    promptText: string;
+    decision: "respond" | "escalate" | "ignore" | "complete" | "auto_resolved";
+    response?: string;
+    reasoning: string;
+}
+export interface SwarmEvent {
+    type: string;
+    sessionId: string;
+    timestamp: number;
+    data: unknown;
+}
+export interface PendingDecision {
+    sessionId: string;
+    promptText: string;
+    recentOutput: string;
+    llmDecision: CoordinationLLMResponse;
+    taskContext: TaskContext;
+    createdAt: number;
+}
+/**
+ * Context interface exposing internal state and helpers to extracted modules.
+ * Implemented by SwarmCoordinator — passed as `this` to module-level functions.
+ */
+export interface SwarmCoordinatorContext {
+    readonly runtime: IAgentRuntime;
+    readonly ptyService: PTYService | null;
+    readonly tasks: Map<string, TaskContext>;
+    readonly inFlightDecisions: Set<string>;
+    readonly pendingDecisions: Map<string, PendingDecision>;
+    /** Last-seen output snapshot per session — used by idle watchdog. */
+    readonly lastSeenOutput: Map<string, string>;
+    /** Timestamp of last tool_running chat notification per session — for throttling. */
+    readonly lastToolNotification: Map<string, number>;
+    broadcast(event: SwarmEvent): void;
+    sendChatMessage(text: string, source?: string): void;
+    log(message: string): void;
+    getSupervisionLevel(): SupervisionLevel;
+}
+export declare class SwarmCoordinator implements SwarmCoordinatorContext {
+    static serviceType: string;
+    readonly runtime: IAgentRuntime;
+    ptyService: PTYService | null;
+    private unsubscribeEvents;
+    /** Per-session task context. */
+    readonly tasks: Map<string, TaskContext>;
+    /** SSE clients receiving live events. */
+    private sseClients;
+    /** Supervision level (default: autonomous). */
+    private supervisionLevel;
+    /** Pending confirmations for "confirm" mode. */
+    readonly pendingDecisions: Map<string, PendingDecision>;
+    /** In-flight decision lock — prevents parallel LLM calls for same session. */
+    readonly inFlightDecisions: Set<string>;
+    /** Callback to send chat messages to the user's conversation UI. */
+    private chatCallback;
+    /** Callback to relay coordinator events to WebSocket clients. */
+    private wsBroadcast;
+    /** Buffer for events arriving before task registration. */
+    private unregisteredBuffer;
+    /** Idle watchdog timer handle. */
+    private idleWatchdogTimer;
+    /** Last-seen output snapshot per session — used by idle watchdog to detect data flow. */
+    readonly lastSeenOutput: Map<string, string>;
+    /** Timestamp of last tool_running chat notification per session — for throttling. */
+    readonly lastToolNotification: Map<string, number>;
+    constructor(runtime: IAgentRuntime);
+    /** Inject a callback (from server.ts) to route messages to the user's chat UI. */
+    setChatCallback(cb: ChatMessageCallback): void;
+    /** Inject a callback (from server.ts) to relay events to WebSocket clients. */
+    setWsBroadcast(cb: WsBroadcastCallback): void;
+    /** Null-safe wrapper — sends a message to the user's conversation if callback is set. */
+    sendChatMessage(text: string, source?: string): void;
+    /**
+     * Initialize the coordinator by subscribing to PTY session events.
+     * Called from plugin init after services are ready.
+     */
+    start(ptyService: PTYService): void;
+    stop(): void;
+    registerTask(sessionId: string, context: {
+        agentType: CodingAgentType;
+        label: string;
+        originalTask: string;
+        workdir: string;
+    }): void;
+    getTaskContext(sessionId: string): TaskContext | undefined;
+    getAllTaskContexts(): TaskContext[];
+    /**
+     * Register an SSE client. Returns an unsubscribe function.
+     * Sends a snapshot of current state on connect.
+     */
+    addSseClient(res: ServerResponse): () => void;
+    broadcast(event: SwarmEvent): void;
+    private writeSseEvent;
+    handleSessionEvent(sessionId: string, event: string, data: unknown): Promise<void>;
+    makeCoordinationDecision(taskCtx: TaskContext, promptText: string, recentOutput: string): Promise<CoordinationLLMResponse | null>;
+    executeDecision(sessionId: string, decision: CoordinationLLMResponse): Promise<void>;
+    setSupervisionLevel(level: SupervisionLevel): void;
+    getSupervisionLevel(): SupervisionLevel;
+    getPendingConfirmations(): PendingDecision[];
+    confirmDecision(sessionId: string, approved: boolean, override?: {
+        response?: string;
+        useKeys?: boolean;
+        keys?: string[];
+    }): Promise<void>;
+    log(message: string): void;
+}
+//# sourceMappingURL=swarm-coordinator.d.ts.map

package/dist/src/services/swarm-coordinator.d.ts.map

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