@elizaos/plugin-agent-orchestrator 2.0.0-alpha.8 → 2.0.0-beta.1

package/dist/node/src/services/coordinator-event-normalizer.d.ts

@@ -0,0 +1,50 @@
+import type { SessionEventName } from "./pty-types.js";
+export type CoordinatorEventSource = "pty_manager" | "adapter_fast_path" | "session_ready_forward" | "hook" | "unknown";
+export interface CoordinatorSessionSnapshot {
+    id: string;
+    type?: string;
+    status?: string;
+}
+interface CoordinatorEventBase<TName extends SessionEventName> {
+    sessionId: string;
+    name: TName;
+    source: CoordinatorEventSource;
+    timestamp: number;
+    rawData: unknown;
+    session?: CoordinatorSessionSnapshot;
+}
+export interface CoordinatorReadyEvent extends CoordinatorEventBase<"ready"> {
+}
+export interface CoordinatorBlockedEvent extends CoordinatorEventBase<"blocked"> {
+    promptText: string;
+    promptType?: string;
+    promptInfo?: Record<string, unknown>;
+    autoResponded: boolean;
+}
+export interface CoordinatorLoginRequiredEvent extends CoordinatorEventBase<"login_required"> {
+    instructions?: string;
+    url?: string;
+    deviceCode?: string;
+    method?: string;
+    promptSnippet?: string;
+}
+export interface CoordinatorTaskCompleteEvent extends CoordinatorEventBase<"task_complete"> {
+    response: string;
+}
+export interface CoordinatorToolRunningEvent extends CoordinatorEventBase<"tool_running"> {
+    toolName?: string;
+    description?: string;
+}
+export interface CoordinatorStoppedEvent extends CoordinatorEventBase<"stopped"> {
+    reason?: string;
+}
+export interface CoordinatorErrorEvent extends CoordinatorEventBase<"error"> {
+    message: string;
+}
+export interface CoordinatorMessageEvent extends CoordinatorEventBase<"message"> {
+    content?: string;
+}
+export type CoordinatorNormalizedEvent = CoordinatorReadyEvent | CoordinatorBlockedEvent | CoordinatorLoginRequiredEvent | CoordinatorTaskCompleteEvent | CoordinatorToolRunningEvent | CoordinatorStoppedEvent | CoordinatorErrorEvent | CoordinatorMessageEvent;
+export declare function normalizeCoordinatorEvent(sessionId: string, event: string, data: unknown): CoordinatorNormalizedEvent | null;
+export {};
+//# sourceMappingURL=coordinator-event-normalizer.d.ts.map

package/dist/node/src/services/coordinator-event-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-event-normalizer.d.ts","sourceRoot":"","sources":["../../../../src/services/coordinator-event-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,mBAAmB,GACnB,uBAAuB,GACvB,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,oBAAoB,CAAC,KAAK,SAAS,gBAAgB;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAED,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB,CAAC,OAAO,CAAC;CAAG;AAE/E,MAAM,WAAW,uBACf,SAAQ,oBAAoB,CAAC,SAAS,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,6BACf,SAAQ,oBAAoB,CAAC,gBAAgB,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BACf,SAAQ,oBAAoB,CAAC,eAAe,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BACf,SAAQ,oBAAoB,CAAC,cAAc,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBACf,SAAQ,oBAAoB,CAAC,SAAS,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB,CAAC,OAAO,CAAC;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBACf,SAAQ,oBAAoB,CAAC,SAAS,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,0BAA0B,GAClC,qBAAqB,GACrB,uBAAuB,GACvB,6BAA6B,GAC7B,4BAA4B,GAC5B,2BAA2B,GAC3B,uBAAuB,GACvB,qBAAqB,GACrB,uBAAuB,CAAC;AAmC5B,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GACZ,0BAA0B,GAAG,IAAI,CAiKnC"}

package/dist/node/src/services/custom-validator-runner.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Custom validator runner — sibling to `task-validation.ts`.
+ *
+ * The default validator (`validateTaskCompletion`) runs an LLM-based pass
+ * over the agent's turn output and workspace evidence. That works for the
+ * generic case, but specialized task types (APP.create, PLUGIN.create, etc.)
+ * own their own verification surface — disk layout, manifest shape, lint
+ * results, test exit codes — and the orchestrator should defer to that
+ * verification rather than reasoning over it through an LLM.
+ *
+ * `runCustomValidator` resolves a runtime service by name, calls the named
+ * method with the supplied params (plus the structured-proof claim, if any),
+ * and returns a normalized `{ verdict, retryablePromptForChild }` result the
+ * decision loop can act on. Every failure path returns `verdict: "fail"`
+ * with a concrete `retryablePromptForChild` so the loop never crashes on a
+ * misconfigured spec.
+ *
+ * @module services/custom-validator-runner
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export interface CustomValidatorSpec {
+    /** Runtime service name passed to `runtime.getService(...)`. */
+    service: string;
+    /** Method name to invoke on the resolved service. */
+    method: string;
+    /**
+     * Free-form params object the orchestrator passes through to the
+     * validator. Validators are responsible for typing this on their side.
+     */
+    params: Record<string, unknown>;
+}
+export type CustomValidatorVerdict = "pass" | "fail";
+export interface CustomValidatorResult {
+    verdict: CustomValidatorVerdict;
+    /**
+     * Concrete next-turn prompt the orchestrator will send back to the child
+     * when the verdict is "fail". When the verdict is "pass" this field is
+     * still populated for trace/log purposes but the orchestrator ignores it.
+     */
+    retryablePromptForChild: string;
+    /**
+     * Pass-through structured details from the validator service. Persisted
+     * on the validation report and surfaced on escalation events.
+     */
+    details?: unknown;
+}
+/**
+ * Resolve `ELIZA_APP_VERIFICATION_MAX_RETRIES`. Per-task `maxRetries`
+ * override wins; otherwise the env var; otherwise the documented default
+ * of 3. A negative value falls through to the next source.
+ */
+export declare function getMaxRetries(taskOverride?: number): number;
+/**
+ * Invoke a custom validator service+method and normalize the result. Never
+ * throws — every failure path collapses into `verdict: "fail"` with a
+ * descriptive `retryablePromptForChild` so the decision loop can stay on
+ * the happy path.
+ *
+ * @param runtime          Eliza runtime for `getService`.
+ * @param spec             `{ service, method, params }` from the task metadata.
+ * @param structuredProof  Optional claim recorded by the structured-proof
+ *                         bridge. Validators that want to cross-check claims
+ *                         against disk receive this under `params.structuredProof`.
+ */
+export declare function runCustomValidator(runtime: IAgentRuntime, spec: CustomValidatorSpec, structuredProof?: unknown): Promise<CustomValidatorResult>;
+//# sourceMappingURL=custom-validator-runner.d.ts.map

package/dist/node/src/services/custom-validator-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-validator-runner.d.ts","sourceRoot":"","sources":["../../../../src/services/custom-validator-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,sBAAsB,CAAC;IAChC;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3D;AA0CD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,mBAAmB,EACzB,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,qBAAqB,CAAC,CA4DhC"}

package/dist/node/src/services/debug-capture.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Debug PTY Capture — optional session recording for offline analysis.
+ *
+ * Activated by setting `PARALLAX_DEBUG_CAPTURE=1`. When enabled, all PTY
+ * output and stdin are recorded per-session using `pty-state-capture`.
+ * Capture files persist in `.parallax/pty-captures/<sessionId>/` after
+ * the agent session is killed, enabling post-mortem analysis of state
+ * transitions, stall classifications, and coordinator timing.
+ *
+ * The `pty-state-capture` package is dynamically imported — if not
+ * installed, capture is silently disabled. This means it can stay out
+ * of production dependencies entirely.
+ *
+ * @module services/debug-capture
+ */
+/**
+ * Returns true if debug capture is enabled via environment variable.
+ */
+export declare function isDebugCaptureEnabled(): boolean;
+/**
+ * Open a capture session for a PTY session. Call this when spawning.
+ */
+export declare function captureSessionOpen(sessionId: string, agentType: string): Promise<void>;
+/**
+ * Feed PTY output data to the capture. Call this on every data chunk.
+ */
+export declare function captureFeed(sessionId: string, chunk: string, direction?: "stdout" | "stderr" | "stdin"): Promise<void>;
+/**
+ * Record a lifecycle event (session_ready, session_stopped, etc.).
+ */
+export declare function captureLifecycle(sessionId: string, event: "session_started" | "session_ready" | "session_stopped" | "session_error", detail?: string): Promise<void>;
+/**
+ * Get a snapshot of a capture session's current state.
+ */
+export declare function captureSnapshot(sessionId: string): unknown | null;
+/** @internal Reset module state for testing only. */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=debug-capture.d.ts.map

package/dist/node/src/services/debug-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-capture.d.ts","sourceRoot":"","sources":["../../../../src/services/debug-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsBH;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAmCD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,QAAQ,GAAG,QAAQ,GAAG,OAAkB,GAClD,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EACD,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,eAAe,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQjE;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/node/src/services/json-model-output.d.ts

@@ -0,0 +1,2 @@
+export declare function parseJsonObjectResponse<T = Record<string, unknown>>(raw: string): T | null;
+//# sourceMappingURL=json-model-output.d.ts.map

package/dist/node/src/services/json-model-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-model-output.d.ts","sourceRoot":"","sources":["../../../../src/services/json-model-output.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,IAAI,CAgBV"}

package/dist/node/src/services/parent-agent-broker.d.ts

@@ -0,0 +1,21 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { SessionInfo } from "./pty-types.js";
+export declare const PARENT_AGENT_BROKER_SLUG = "parent-agent";
+export declare const PARENT_AGENT_BROKER_MANIFEST_ENTRY: {
+    readonly slug: "parent-agent";
+    readonly name: "Parent Eliza Agent";
+    readonly description: "Task-scoped bridge for asking the running parent Eliza agent to use its loaded capabilities, actions, providers, connectors, and confirmation flow.";
+    readonly guidance: "Use when workspace context is not enough and the parent agent should do something with its own capabilities. Examples: `USE_SKILL parent-agent {\"request\":\"Find the next free 30 minute slot on my calendar\"}`, `USE_SKILL parent-agent {\"mode\":\"list-actions\",\"query\":\"github\"}`, `USE_SKILL parent-agent {\"mode\":\"list-cloud-commands\"}`, or `USE_SKILL parent-agent {\"mode\":\"cloud-command\",\"command\":\"apps.list\"}`. Mutating, paid, or destructive Cloud commands require explicit `confirmed:true` after parent/user approval.";
+};
+export interface ParentAgentBrokerRequest {
+    runtime: IAgentRuntime;
+    sessionId: string;
+    session?: SessionInfo;
+    args: unknown;
+}
+export declare function runParentAgentBroker(request: ParentAgentBrokerRequest): Promise<{
+    success: boolean;
+    text: string;
+    data?: Record<string, unknown>;
+}>;
+//# sourceMappingURL=parent-agent-broker.d.ts.map

package/dist/node/src/services/parent-agent-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-agent-broker.d.ts","sourceRoot":"","sources":["../../../../src/services/parent-agent-broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AASlD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAEvD,eAAO,MAAM,kCAAkC;;;;;CAOrC,CAAC;AAwiBX,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACf;AAwiBD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CA4H7E"}

package/dist/node/src/services/pty-auto-response.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Auto-response rule management for PTY sessions (bypass-fix).
+ *
+ * Contains logic for pushing default auto-response rules per agent type
+ * and handling Gemini authentication flow.
+ *
+ * @module services/pty-auto-response
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { BunCompatiblePTYManager, PTYManager } from "pty-manager";
+export interface AutoResponseContext {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+    runtime: IAgentRuntime;
+    log: (msg: string) => void;
+}
+/**
+ * Push session-specific auto-response rules that depend on runtime config.
+ * Trust prompts, update notices, and other static rules are handled by
+ * adapter built-in rules (coding-agent-adapters). This only pushes rules
+ * that need runtime values (e.g. API keys).
+ */
+export declare function pushDefaultRules(ctx: AutoResponseContext, sessionId: string, agentType: string): Promise<void>;
+/**
+ * Handle Gemini authentication when login_required fires.
+ * Sends /auth to start the auth flow; auto-response rules
+ * then handle menu selection and API key input.
+ */
+export declare function handleGeminiAuth(ctx: AutoResponseContext, sessionId: string, sendKeysToSession: (sessionId: string, keys: string | string[]) => Promise<void>): Promise<void>;
+//# sourceMappingURL=pty-auto-response.d.ts.map

package/dist/node/src/services/pty-auto-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-auto-response.d.ts","sourceRoot":"","sources":["../../../../src/services/pty-auto-response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAEV,uBAAuB,EACvB,UAAU,EACX,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AASD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAmLf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

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

@@ -0,0 +1,55 @@
+/**
+ * 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 type { BunCompatiblePTYManager as BunCompatiblePTYManagerType, PTYManager as PTYManagerType, StallClassification } from "pty-manager";
+import type { CompletionMethod } from "./agent-metrics.js";
+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;
+    sessionMetadata: Map<string, Record<string, unknown>>;
+    sessionOutputBuffers: Map<string, string[]>;
+    taskResponseMarkers: Map<string, number>;
+    metricsTracker: {
+        recordCompletion(type: string, method: CompletionMethod, durationMs: number): void;
+    };
+    traceEntries: Array<string | Record<string, unknown>>;
+    maxTraceEntries: number;
+    log: (msg: string) => void;
+    handleWorkerExit?: (info: {
+        code: number | null;
+        signal: string | null;
+    }) => void;
+    /** Check if a session has an active task in the coordinator. */
+    hasActiveTask?: (sessionId: string) => boolean;
+    /** Check if a session's task has started work (task delivered or decisions made). */
+    hasTaskActivity?: (sessionId: string) => boolean;
+    /** Mark a session's task as delivered (initial ready event processed). */
+    markTaskDelivered?: (sessionId: string) => void;
+}
+/** Value returned by {@link initializePTYManager}. */
+export interface InitResult {
+    manager: PTYManagerType | BunCompatiblePTYManagerType;
+    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/node/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;AAQH,OAAO,KAAK,EAEV,uBAAuB,IAAI,2BAA2B,EAEtD,UAAU,IAAI,cAAc,EAG5B,mBAAmB,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA8EvD;;;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,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,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,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAAC;KACT,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;IAC3B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,KAAK,IAAI,CAAC;IACX,gEAAgE;IAChE,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,qFAAqF;IACrF,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAoED,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,GAAG,2BAA2B,CAAC;IACtD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA4arB"}

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

@@ -0,0 +1,218 @@
+/** @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 declare function shouldSuppressCodexExecPtyManagerEvent(options: {
+    codexExecMode: boolean;
+    event: string;
+    data: unknown;
+}): boolean;
+export declare function shouldSuppressCodexExecHookEvent(options: {
+    codexExecMode: boolean;
+    event: string;
+}): boolean;
+export type { CodingAgentType, PTYServiceConfig, SessionEventName, SessionInfo, SpawnSessionOptions, } 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 getPtyService(runtime: IAgentRuntime): PTYService | null;
+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 preflightCache;
+    private preflightInFlight;
+    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 spawnSessionInternal;
+    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/node/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/node/src/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/node/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;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,CAiEf;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"}