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

package/dist/providers/action-examples.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Provider that injects structured task-agent action examples into the prompt context.
+ *
+ * ElizaOS core only shows exampleCalls from its static action-docs registry,
+ * which doesn't include custom plugin actions. This provider bridges the gap
+ * by formatting our task-agent action examples in the same structured format
+ * the model sees for core actions.
+ *
+ * @module providers/action-examples
+ */
+import type { Provider } from "@elizaos/core";
+export declare const codingAgentExamplesProvider: Provider;
+export declare const taskAgentExamplesProvider: Provider;
+//# sourceMappingURL=action-examples.d.ts.map

package/dist/providers/action-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-examples.d.ts","sourceRoot":"","sources":["../../src/providers/action-examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAyB,QAAQ,EAAS,MAAM,eAAe,CAAC;AAS5E,eAAO,MAAM,2BAA2B,EAAE,QA0JzC,CAAC;AAEF,eAAO,MAAM,yBAAyB,UAA8B,CAAC"}

package/dist/providers/active-workspace-context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider that injects active workspace and task-agent context into every prompt.
+ *
+ * Eliza needs to know what workspaces exist, which agents are running, and
+ * their current status without having to call LIST_AGENTS every message. This
+ * provider reads from the workspace service, PTY service, and coordinator to
+ * build a live context summary that's always available in the prompt.
+ *
+ * @module providers/active-workspace-context
+ */
+import type { Provider } from "@elizaos/core";
+export declare const activeWorkspaceContextProvider: Provider;
+//# sourceMappingURL=active-workspace-context.d.ts.map

package/dist/providers/active-workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-workspace-context.d.ts","sourceRoot":"","sources":["../../src/providers/active-workspace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAyB,QAAQ,EAAS,MAAM,eAAe,CAAC;AAgD5E,eAAO,MAAM,8BAA8B,EAAE,QA6L5C,CAAC"}

package/dist/services/agent-credentials.d.ts

@@ -0,0 +1,23 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { AgentCredentials } from "coding-agent-adapters";
+export declare function isAnthropicOAuthToken(value: string | undefined): value is string;
+export declare function sanitizeCustomCredentials(customCredentials: Record<string, string> | undefined, blockedValues?: string[]): Record<string, string> | undefined;
+export declare function buildAgentCredentials(runtime: IAgentRuntime): AgentCredentials;
+export interface OpencodeSpawnConfig {
+    configContent: string;
+    providerLabel: string;
+    providerId: string;
+    model: string;
+    smallModel?: string;
+}
+/**
+ * Build the per-spawn OpenCode config (fed via OPENCODE_CONFIG_CONTENT).
+ * Three modes — verified live against ollama serving qwen2.5-coder:0.5b:
+ *   1. Cloud: PARALLAX_LLM_PROVIDER=cloud + paired Eliza Cloud key.
+ *   2. Local: PARALLAX_OPENCODE_LOCAL=1 (and/or PARALLAX_OPENCODE_BASE_URL).
+ *   3. User-config: PARALLAX_OPENCODE_MODEL_POWERFUL alone — defers to
+ *      whatever providers the user has in ~/.config/opencode/opencode.json.
+ * Returns null when no mode can produce a usable config.
+ */
+export declare function buildOpencodeSpawnConfig(runtime: IAgentRuntime): OpencodeSpawnConfig | null;
+//# sourceMappingURL=agent-credentials.d.ts.map

package/dist/services/agent-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-credentials.d.ts","sourceRoot":"","sources":["../../src/services/agent-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA4D9D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,KAAK,IAAI,MAAM,CAEjB;AAED,wBAAgB,yBAAyB,CACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,aAAa,GAAE,MAAM,EAAO,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAUpC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAgDlB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,GACrB,mBAAmB,GAAG,IAAI,CAiG5B"}

package/dist/services/agent-metrics.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Lightweight per-agent-type metrics for observability.
+ *
+ * Self-contained tracker — no dependencies on PTYService state.
+ *
+ * @module services/agent-metrics
+ */
+export interface AgentMetrics {
+    spawned: number;
+    completed: number;
+    completedViaFastPath: number;
+    completedViaClassifier: number;
+    completedViaOutputReconcile: number;
+    stallCount: number;
+    avgCompletionMs: number;
+    totalCompletionMs: number;
+}
+export type CompletionMethod = "fast-path" | "classifier" | "output-reconcile";
+export declare class AgentMetricsTracker {
+    private metrics;
+    /** Get (or lazily initialize) metrics for a given agent type. */
+    get(agentType: string): AgentMetrics;
+    /** Record a task completion and update rolling average duration. */
+    recordCompletion(agentType: string, method: CompletionMethod, durationMs: number): void;
+    /** Increment the stall counter for an agent type. */
+    incrementStalls(agentType: string): void;
+    /** Return a serializable copy of all metrics (for API endpoints). */
+    getAll(): Record<string, Omit<AgentMetrics, "totalCompletionMs">>;
+}
+//# sourceMappingURL=agent-metrics.d.ts.map

package/dist/services/agent-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-metrics.d.ts","sourceRoot":"","sources":["../../src/services/agent-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2BAA2B,EAAE,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,kBAAkB,CAAC;AAE/E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAwC;IAEvD,iEAAiE;IACjE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAkBpC,oEAAoE;IACpE,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI;IAUP,qDAAqD;IACrD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIxC,qEAAqE;IACrE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;CAQlE"}

package/dist/services/agent-selection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Dynamic agent selection strategy.
+ *
+ * Chooses which coding-agent CLI to spawn when the caller does not
+ * specify an explicit `agentType`.
+ *
+ *   - **fixed**  — always returns `config.fixedAgentType`
+ *   - **ranked** — scores each installed agent on success rate,
+ *                  stall frequency, and completion speed, then
+ *                  returns the highest-scoring one
+ *
+ * @module services/agent-selection
+ */
+import type { AdapterType, PreflightResult } from "coding-agent-adapters";
+export type AgentSelectionStrategy = "fixed" | "ranked";
+/** Subset of AgentMetrics fields used for scoring. */
+export interface AgentScoreInput {
+    spawned: number;
+    completed: number;
+    stallCount: number;
+    avgCompletionMs: number;
+}
+export interface AgentSelectionConfig {
+    strategy: AgentSelectionStrategy;
+    fixedAgentType: AdapterType;
+}
+export interface AgentSelectionContext {
+    config: AgentSelectionConfig;
+    /** Per-agent-type metrics snapshot (may be empty). */
+    metrics: Record<string, AgentScoreInput>;
+    /** Preflight results — only the `installed` ones are candidates. */
+    installedAgents: PreflightResult[];
+}
+/**
+ * Compute a 0–1 score for a single agent based on its metrics.
+ *
+ * - `successRate`  = completed / spawned  (0.5 neutral prior when no data)
+ * - `volumeWeight` = min(1, spawned / 5)  — blends toward neutral at low N
+ * - `stallPenalty`  = (stallCount / spawned) * 0.3
+ * - `speedPenalty`  = min(avgCompletionMs / 300_000, 1) * 0.1  — weak tiebreaker
+ *
+ * Cold-start (no spawns): returns 0.5 so all agents are equal.
+ */
+export declare function computeAgentScore(metrics: AgentScoreInput | undefined): number;
+/**
+ * Select the best agent type given the current strategy, metrics, and
+ * installed agents.
+ *
+ * Explicit user choice (`params.agentType`) should be resolved by the
+ * caller *before* reaching this function.
+ */
+export declare function selectAgentType(ctx: AgentSelectionContext): AdapterType;
+//# sourceMappingURL=agent-selection.d.ts.map

package/dist/services/agent-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-selection.d.ts","sourceRoot":"","sources":["../../src/services/agent-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG1E,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,cAAc,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,oEAAoE;IACpE,eAAe,EAAE,eAAe,EAAE,CAAC;CACpC;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,MAAM,CAaR;AAOD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,WAAW,CA8BvE"}

package/dist/services/ansi-utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ANSI/terminal utility functions for processing PTY output.
+ *
+ * Pure functions — no state, no dependencies beyond the standard library.
+ *
+ * @module services/ansi-utils
+ */
+/**
+ * Strip ANSI escape sequences from raw terminal output for readable text.
+ * Replaces cursor-forward codes with spaces (TUI uses these instead of actual spaces).
+ */
+export declare function stripAnsi(raw: string): string;
+/**
+ * Clean terminal output for display in chat messages.
+ *
+ * Goes beyond {@link stripAnsi} by also removing:
+ * - Unicode spinner/box-drawing/decorative characters from CLI TUIs
+ * - Lines that are only loading/thinking status text
+ * - Spinner status bar metadata (token counts, timing)
+ * - Consecutive blank lines (collapsed to one)
+ */
+export declare function cleanForChat(raw: string): string;
+/**
+ * Failover prompts need stricter transcript sanitization than chat messages.
+ * The replacement agent already gets the workspace path and failure reason
+ * separately, so Claude/Codex trust screens, onboarding banners, and echoed
+ * workspace selectors should be dropped here instead of being forwarded.
+ */
+export declare function cleanForFailoverContext(raw: string, workdir?: string): string;
+/**
+ * Extract meaningful artifacts (PR URLs, commit hashes, key results) from raw
+ * terminal output.  Returns a compact summary suitable for chat messages,
+ * without dumping raw TUI output.
+ */
+export declare function extractCompletionSummary(raw: string): string;
+/**
+ * Extract a dev server URL from recent terminal output, if present.
+ *
+ * Looks for common patterns like:
+ *   - http://localhost:3000
+ *   - http://127.0.0.1:8080
+ *   - http://0.0.0.0:5173
+ *   - https://localhost:4200
+ *
+ * Returns the first match, or null if no dev server URL is found.
+ */
+export declare function extractDevServerUrl(raw: string): string | null;
+/**
+ * Capture the agent's output since the last task was sent, cleaned for chat display.
+ * Returns readable text with TUI noise removed, or empty string if no marker exists.
+ *
+ * Mutates `markers` by deleting the entry for `sessionId` after capture.
+ */
+export declare function captureTaskResponse(sessionId: string, buffers: Map<string, string[]>, markers: Map<string, number>): string;
+/**
+ * Peek at the current task response without consuming the marker.
+ * Useful for state reconciliation paths that need to inspect a response
+ * before deciding whether to emit a synthetic completion event.
+ */
+export declare function peekTaskResponse(sessionId: string, buffers: Map<string, string[]>, markers: Map<string, number>): string;
+//# sourceMappingURL=ansi-utils.d.ts.map

package/dist/services/ansi-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi-utils.d.ts","sourceRoot":"","sources":["../../src/services/ansi-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwCH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAsDD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyBhD;AAgCD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAY7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmC5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CAKR"}

package/dist/services/claude-code-skill-installer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Install bundled Claude Code skills into the host's `~/.claude/skills/` so
+ * sub-agents Eliza spawns automatically have access to them.
+ *
+ * The orchestrator ships skill content under `assets/claude-code-skills/`
+ * inside this package. On PTY service init, the installer copies any
+ * directory tree under that path into the host's `~/.claude/skills/<id>/`
+ * if the destination does not already exist. Subsequent runs are no-ops
+ * unless the destination has been removed.
+ *
+ * Why "skip if exists" rather than "always overwrite":
+ * - Skills are user-modifiable. If a user customized eliza-runtime locally
+ *   (added their own scripts, edited a reference), the orchestrator should
+ *   not silently stomp their edits on every restart.
+ * - The cost of a stale skill is that new orchestrator features the skill
+ *   should advertise won't be available until the user refreshes manually.
+ *   That's the right trade-off for v1; future versions can use a version
+ *   marker file to detect "I have an older copy, please update."
+ *
+ * The installer is best-effort — failures (missing source dir, can't write
+ * to home, etc.) log a warning and return; they never block PTY start.
+ */
+import type { Logger } from "@elizaos/core";
+/**
+ * Copy each top-level directory under `assets/claude-code-skills/` into
+ * `~/.claude/skills/<dirname>/`, skipping any destination that already
+ * exists. Returns the list of skill ids that were freshly installed (empty
+ * array means everything was already present or the source was missing).
+ */
+export declare function ensureBundledClaudeCodeSkills(logger: Pick<Logger, "info" | "warn">, options?: {
+    home?: () => string;
+}): string[];
+//# sourceMappingURL=claude-code-skill-installer.d.ts.map

package/dist/services/claude-code-skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-skill-installer.d.ts","sourceRoot":"","sources":["../../src/services/claude-code-skill-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAqC5C;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACrC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACpC,MAAM,EAAE,CAmDV"}

package/dist/services/config-env.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Read settings from the eliza/eliza config file's env section.
+ *
+ * runtime.getSetting() checks character.settings but NOT the config's env
+ * section which is where the UI writes settings. This reads the config
+ * file directly so settings take effect without restart.
+ *
+ * @module services/config-env
+ */
+export declare function readConfigEnvKey(key: string): string | undefined;
+/** Read a key from the cloud section of the config (e.g. "apiKey"). */
+export declare function readConfigCloudKey(key: string): string | undefined;
+/**
+ * Read the `agents.defaults.orchestrator.codexSubscriptionRestrictedToCodexFramework`
+ * flag from Eliza's config. Returns false when the flag is unset or the
+ * config file is missing/malformed.
+ *
+ * When true, Codex (ChatGPT Plus/Pro) subscription tokens are only usable when
+ * the orchestrator targets the `codex` framework — other frameworks
+ * (claude/gemini/aider) must fall back to API keys instead.
+ */
+export declare function readConfigCodexSubscriptionRestrictedToCodexFramework(): boolean;
+//# sourceMappingURL=config-env.d.ts.map

package/dist/services/config-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-env.d.ts","sourceRoot":"","sources":["../../src/services/config-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIhE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qDAAqD,IAAI,OAAO,CAmB/E"}

package/dist/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/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/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/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/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/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/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/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;AAOD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyKf;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/services/pty-init.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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;
+    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/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;AAOH,OAAO,KAAK,EAEV,uBAAuB,IAAI,2BAA2B,EACtD,UAAU,IAAI,cAAc,EAI5B,mBAAmB,EAGpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAiEvD;;;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,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;AAkBD,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,CA2VrB"}