@telora/daemon 0.16.8 → 0.16.16

package/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commitSha": "c0d1657c",
-  "builtAt": "2026-05-25T21:17:18.912Z",
+  "commitSha": "f1330817",
+  "builtAt": "2026-05-26T14:53:55.053Z",
   "expectedMigrations": [
     "20250829113330_create_org_nodes_table.sql",
     "20250829113402_fix_function_security_search_path.sql",
@@ -591,6 +591,7 @@
     "20260525092825_focus_lineage_session_ids.sql",
     "20260525094853_focus_directive_lineage_continuity.sql",
     "20260525095445_review_lineage_resume.sql",
-    "20260525124226_coding_stage_delivery_index.sql"
+    "20260525124226_coding_stage_delivery_index.sql",
+    "20260526025901_engine_selection_columns.sql"
   ]
 }

package/dist/backends/agent-backend.d.ts

@@ -0,0 +1,63 @@
+/**
+ * AgentBackend interface -- the engine-agnostic seam for spawning coding agents.
+ *
+ * The daemon's focus-execution path used to be welded to Claude Code (the
+ * `claude` binary, stream-json I/O, `--resume` session ids). An `AgentBackend`
+ * abstracts the four engine-specific concerns behind one interface so the daemon
+ * can run a focus on any registered engine:
+ *
+ *   1. spawn-arg / resume-arg construction (CLI invocation per engine)
+ *   2. input encoding (how a prompt/message is written to the process)
+ *   3. an event-parser factory (engine stream -> neutral AgentEvent stream)
+ *   4. an availability probe (is this engine installed + authenticated here?)
+ *
+ * Session-id capture rides on the parser (`AgentEventParser.sessionId`, set from
+ * the engine's neutral `session_started` event). Backends are looked up by id
+ * from the registry (./registry.ts); `claude` is the only one registered in D1.
+ */
+import type { AgentEventParser } from '@telora/daemon-core';
+import type { DaemonConfig } from '../types.js';
+/** Inputs that vary per fresh spawn. */
+export interface AgentSpawnContext {
+    /** Daemon config -- backends read what they need (paths, tracker id, URL). */
+    config: DaemonConfig;
+    /** Worktree the agent runs in. Claude uses the spawn cwd; Codex needs `--cd`. */
+    worktreePath: string;
+    /** Model override (e.g. from pipeline config or a stage directive). */
+    model?: string | null;
+}
+/** Inputs for resuming a prior session. */
+export interface AgentResumeContext extends AgentSpawnContext {
+    /** The engine session id to resume (captured from a prior session_started). */
+    resumeSessionId: string;
+}
+/** Result of probing whether a backend is usable on the current daemon host. */
+export interface BackendAvailability {
+    /** True when the engine CLI is present (and, where checkable, authenticated). */
+    available: boolean;
+    /** Human-readable reason when unavailable (drives picker help text in D4). */
+    detail?: string;
+}
+/**
+ * One coding-agent engine (Claude Code, Codex, ...). Implementations are
+ * registered in the backend registry and resolved by `id`.
+ */
+export interface AgentBackend {
+    /** Stable engine id used as the registry key (e.g. "claude", "codex"). */
+    readonly id: string;
+    /** Human-friendly name for UI/logs (e.g. "Claude Code"). */
+    readonly displayName: string;
+    /** Resolve the executable command for this engine from daemon config. */
+    resolveCommand(config: DaemonConfig): string;
+    /** Build CLI args for a fresh (non-resume) spawn. */
+    buildSpawnArgs(ctx: AgentSpawnContext): string[];
+    /** Build CLI args for resuming a prior session. */
+    buildResumeArgs(ctx: AgentResumeContext): string[];
+    /** Encode a prompt/message into the exact bytes to write to the process stdin. */
+    encodeInput(content: string): string;
+    /** Create a fresh parser that maps this engine's stream to AgentEvents. */
+    createParser(): AgentEventParser;
+    /** Probe whether this engine is available on the current daemon host. */
+    probeAvailability(config: DaemonConfig): Promise<BackendAvailability>;
+}
+//# sourceMappingURL=agent-backend.d.ts.map

package/dist/backends/agent-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-backend.d.ts","sourceRoot":"","sources":["../../src/backends/agent-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,MAAM,EAAE,YAAY,CAAC;IACrB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,yEAAyE;IACzE,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;IAE7C,qDAAqD;IACrD,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAAC;IAEjD,mDAAmD;IACnD,eAAe,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAAC;IAEnD,kFAAkF;IAClF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAErC,2EAA2E;IAC3E,YAAY,IAAI,gBAAgB,CAAC;IAEjC,yEAAyE;IACzE,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACvE"}

package/dist/backends/agent-backend.js

@@ -0,0 +1,19 @@
+/**
+ * AgentBackend interface -- the engine-agnostic seam for spawning coding agents.
+ *
+ * The daemon's focus-execution path used to be welded to Claude Code (the
+ * `claude` binary, stream-json I/O, `--resume` session ids). An `AgentBackend`
+ * abstracts the four engine-specific concerns behind one interface so the daemon
+ * can run a focus on any registered engine:
+ *
+ *   1. spawn-arg / resume-arg construction (CLI invocation per engine)
+ *   2. input encoding (how a prompt/message is written to the process)
+ *   3. an event-parser factory (engine stream -> neutral AgentEvent stream)
+ *   4. an availability probe (is this engine installed + authenticated here?)
+ *
+ * Session-id capture rides on the parser (`AgentEventParser.sessionId`, set from
+ * the engine's neutral `session_started` event). Backends are looked up by id
+ * from the registry (./registry.ts); `claude` is the only one registered in D1.
+ */
+export {};
+//# sourceMappingURL=agent-backend.js.map

package/dist/backends/agent-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-backend.js","sourceRoot":"","sources":["../../src/backends/agent-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/backends/availability.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Engine availability probing for the daemon host.
+ *
+ * On connect (via the heartbeat metadata), the daemon publishes which
+ * registered engines are usable on its host so the app's engine picker can
+ * grey out the rest. The probe runs once per daemon process and is cached:
+ * installed CLIs don't change during a run, and a restart re-probes.
+ */
+import type { DaemonConfig } from '../types.js';
+/** One engine's availability on this host, as published to the app. */
+export interface BackendAvailabilityReport {
+    /** Registry id (e.g. 'claude', 'codex'). */
+    id: string;
+    /** Human-friendly name. */
+    displayName: string;
+    /** True when the engine CLI is present (and, where checkable, authenticated). */
+    available: boolean;
+    /** Why unavailable (host + fix command); drives the picker's help text. */
+    detail?: string;
+}
+/**
+ * Probe every registered backend's availability on this host. Cached after the
+ * first call (the result is stable for the life of the daemon process).
+ */
+export declare function probeAllBackends(config: DaemonConfig): Promise<BackendAvailabilityReport[]>;
+/** Test-only: clear the cached probe so the next call re-probes. */
+export declare function _resetAvailabilityCache(): void;
+//# sourceMappingURL=availability.d.ts.map

package/dist/backends/availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../src/backends/availability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAK3F;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/backends/availability.js

@@ -0,0 +1,49 @@
+/**
+ * Engine availability probing for the daemon host.
+ *
+ * On connect (via the heartbeat metadata), the daemon publishes which
+ * registered engines are usable on its host so the app's engine picker can
+ * grey out the rest. The probe runs once per daemon process and is cached:
+ * installed CLIs don't change during a run, and a restart re-probes.
+ */
+import { listBackends } from './registry.js';
+let cached = null;
+async function doProbe(config) {
+    const results = [];
+    for (const backend of listBackends()) {
+        try {
+            const availability = await backend.probeAvailability(config);
+            results.push({
+                id: backend.id,
+                displayName: backend.displayName,
+                available: availability.available,
+                detail: availability.detail,
+            });
+        }
+        catch (err) {
+            // A probe must never break the heartbeat -- report the engine unavailable.
+            results.push({
+                id: backend.id,
+                displayName: backend.displayName,
+                available: false,
+                detail: err instanceof Error ? err.message : 'availability probe failed',
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Probe every registered backend's availability on this host. Cached after the
+ * first call (the result is stable for the life of the daemon process).
+ */
+export function probeAllBackends(config) {
+    if (!cached) {
+        cached = doProbe(config);
+    }
+    return cached;
+}
+/** Test-only: clear the cached probe so the next call re-probes. */
+export function _resetAvailabilityCache() {
+    cached = null;
+}
+//# sourceMappingURL=availability.js.map

package/dist/backends/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/backends/availability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAe7C,IAAI,MAAM,GAAgD,IAAI,CAAC;AAE/D,KAAK,UAAU,OAAO,CAAC,MAAoB;IACzC,MAAM,OAAO,GAAgC,EAAE,CAAC;IAChD,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,SAAS,EAAE,YAAY,CAAC,SAAS;gBACjC,MAAM,EAAE,YAAY,CAAC,MAAM;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,2EAA2E;YAC3E,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;aACzE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/dist/backends/claude/claude-backend.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Claude Code backend -- the built-in `AgentBackend` implementation.
+ *
+ * Owns everything Claude-Code-specific that used to be inlined across the spawn
+ * paths: the `--teammate-mode in-process` + stream-json flag set, the `--resume`
+ * arg shape, the stream-json stdin encoding, and the StreamJsonParser-based
+ * event stream (via the `ClaudeAgentParser` adapter). The rest of the daemon
+ * now talks to this through the engine-agnostic interface.
+ */
+import type { AgentBackend } from '../agent-backend.js';
+export declare const claudeBackend: AgentBackend;
+//# sourceMappingURL=claude-backend.d.ts.map

package/dist/backends/claude/claude-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/claude/claude-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,qBAAqB,CAAC;AAoC7B,eAAO,MAAM,aAAa,EAAE,YA8C3B,CAAC"}

package/dist/backends/claude/claude-backend.js

@@ -0,0 +1,86 @@
+/**
+ * Claude Code backend -- the built-in `AgentBackend` implementation.
+ *
+ * Owns everything Claude-Code-specific that used to be inlined across the spawn
+ * paths: the `--teammate-mode in-process` + stream-json flag set, the `--resume`
+ * arg shape, the stream-json stdin encoding, and the StreamJsonParser-based
+ * event stream (via the `ClaudeAgentParser` adapter). The rest of the daemon
+ * now talks to this through the engine-agnostic interface.
+ */
+import { existsSync } from 'node:fs';
+import { join, isAbsolute } from 'node:path';
+import { homedir } from 'node:os';
+import { ClaudeAgentParser } from '@telora/daemon-core';
+/**
+ * Build the Claude Code stream-json flag set shared by fresh + resume spawns.
+ * Mirrors the previous `buildTeamLeadArgs` body (minus the leading `--resume`,
+ * which `buildResumeArgs` prepends): teammate mode + stream-json + the optional
+ * model override.
+ */
+function buildBaseArgs(ctx) {
+    const args = [];
+    args.push('--dangerously-skip-permissions');
+    args.push('--setting-sources', 'project,local');
+    args.push('--input-format', 'stream-json');
+    args.push('--output-format', 'stream-json');
+    args.push('--verbose');
+    // Enable in-process teammate mode for the team lead.
+    args.push('--teammate-mode', 'in-process');
+    if (ctx.model) {
+        args.push('--model', ctx.model);
+    }
+    return args;
+}
+/** Resolve whether an executable name/path exists on the host. */
+function commandExists(command) {
+    if (isAbsolute(command) || command.includes('/')) {
+        return existsSync(command);
+    }
+    const pathEnv = process.env.PATH ?? '';
+    return pathEnv
+        .split(':')
+        .filter(Boolean)
+        .some((dir) => existsSync(join(dir, command)));
+}
+export const claudeBackend = {
+    id: 'claude',
+    displayName: 'Claude Code',
+    resolveCommand(config) {
+        return config.claudeCodePath;
+    },
+    buildSpawnArgs(ctx) {
+        return buildBaseArgs(ctx);
+    },
+    buildResumeArgs(ctx) {
+        // --resume must come early, before --input-format stream-json.
+        return ['--resume', ctx.resumeSessionId, ...buildBaseArgs(ctx)];
+    },
+    encodeInput(content) {
+        // Identical wire format to daemon-core's `sendMessage`: a single
+        // stream-json user message line.
+        return JSON.stringify({ type: 'user', message: { role: 'user', content } }) + '\n';
+    },
+    createParser() {
+        return new ClaudeAgentParser();
+    },
+    async probeAvailability(config) {
+        const command = config.claudeCodePath;
+        if (!commandExists(command)) {
+            return {
+                available: false,
+                detail: `Claude Code CLI not found (looked for "${command}" on PATH). Install it and ensure it is on the daemon host's PATH.`,
+            };
+        }
+        if (process.env.ANTHROPIC_API_KEY) {
+            return { available: true };
+        }
+        if (existsSync(join(homedir(), '.claude.json'))) {
+            return { available: true };
+        }
+        return {
+            available: false,
+            detail: `Claude Code found at "${command}" but not authenticated. Run \`claude auth login\` or set ANTHROPIC_API_KEY on the daemon host.`,
+        };
+    },
+};
+//# sourceMappingURL=claude-backend.js.map

package/dist/backends/claude/claude-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-backend.js","sourceRoot":"","sources":["../../../src/backends/claude/claude-backend.ts"],"names":[],"mappings":"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"}

package/dist/backends/codex/codex-backend.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Codex CLI backend -- runs a focus on OpenAI Codex (`codex exec`).
+ *
+ * Recipe validated against Codex CLI 0.133.0 (spike: /tmp/codex-spike):
+ * - spawn:  `codex exec --json --dangerously-bypass-approvals-and-sandbox
+ *            --cd <worktree> -c mcp_servers.telora.* -` (prompt on stdin)
+ * - resume: `codex exec resume <sessionId> --json --dangerously-bypass-...`
+ *           NO `--cd` (the resume subcommand rejects it; workspace is recovered
+ *           from the session). NEVER `--ephemeral` (it skips session persistence
+ *           and breaks resume).
+ *
+ * Bypass mode matches the Claude `--dangerously-skip-permissions` posture (the
+ * daemon runs in isolated worktrees) and is also what makes headless MCP work
+ * without an approval prompt. The Telora MCP server is wired in as a config
+ * override so each Codex agent spawns its own MCP subprocess.
+ *
+ * Auth: Codex uses the host `~/.codex` OAuth login by default; a `CODEX_API_KEY`
+ * in the spawn environment overrides it (org-secret injection rides the spawn
+ * environment, not this backend).
+ */
+import type { AgentBackend } from '../agent-backend.js';
+export declare const codexBackend: AgentBackend;
+//# sourceMappingURL=codex-backend.d.ts.map

package/dist/backends/codex/codex-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/codex/codex-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,qBAAqB,CAAC;AAyC7B,eAAO,MAAM,YAAY,EAAE,YAwD1B,CAAC"}

package/dist/backends/codex/codex-backend.js

@@ -0,0 +1,116 @@
+/**
+ * Codex CLI backend -- runs a focus on OpenAI Codex (`codex exec`).
+ *
+ * Recipe validated against Codex CLI 0.133.0 (spike: /tmp/codex-spike):
+ * - spawn:  `codex exec --json --dangerously-bypass-approvals-and-sandbox
+ *            --cd <worktree> -c mcp_servers.telora.* -` (prompt on stdin)
+ * - resume: `codex exec resume <sessionId> --json --dangerously-bypass-...`
+ *           NO `--cd` (the resume subcommand rejects it; workspace is recovered
+ *           from the session). NEVER `--ephemeral` (it skips session persistence
+ *           and breaks resume).
+ *
+ * Bypass mode matches the Claude `--dangerously-skip-permissions` posture (the
+ * daemon runs in isolated worktrees) and is also what makes headless MCP work
+ * without an approval prompt. The Telora MCP server is wired in as a config
+ * override so each Codex agent spawns its own MCP subprocess.
+ *
+ * Auth: Codex uses the host `~/.codex` OAuth login by default; a `CODEX_API_KEY`
+ * in the spawn environment overrides it (org-secret injection rides the spawn
+ * environment, not this backend).
+ */
+import { existsSync } from 'node:fs';
+import { join, isAbsolute } from 'node:path';
+import { homedir } from 'node:os';
+import { CodexAgentParser, resolveMcpServerPath } from '@telora/daemon-core';
+/** Bypass approvals + sandbox -- matches Claude's --dangerously-skip-permissions. */
+const BYPASS_FLAG = '--dangerously-bypass-approvals-and-sandbox';
+function codexCommand(config) {
+    return config.codexPath ?? 'codex';
+}
+/**
+ * Build `-c mcp_servers.telora.*` config overrides wiring the Telora MCP server
+ * into the Codex run. Values are TOML literals, so strings are quoted.
+ * Best-effort: if the MCP package can't be resolved, MCP is omitted (the run
+ * still starts; the gap surfaces at runtime).
+ */
+function mcpConfigFlags(config) {
+    let mcpServerPath;
+    try {
+        mcpServerPath = resolveMcpServerPath(import.meta.url);
+    }
+    catch (err) {
+        console.warn('[codex-backend] Could not resolve Telora MCP server path; running without MCP:', err.message);
+        return [];
+    }
+    const flags = [
+        '-c', `mcp_servers.telora.command="node"`,
+        '-c', `mcp_servers.telora.args=[${JSON.stringify(mcpServerPath)}]`,
+        '-c', `mcp_servers.telora.env.TELORA_MCP_PROFILE="execution"`,
+        '-c', `mcp_servers.telora.required=true`,
+    ];
+    if (config.teloraUrl)
+        flags.push('-c', `mcp_servers.telora.env.TELORA_URL=${JSON.stringify(config.teloraUrl)}`);
+    if (config.trackerId)
+        flags.push('-c', `mcp_servers.telora.env.TELORA_TRACKER_ID=${JSON.stringify(config.trackerId)}`);
+    return flags;
+}
+function commandExists(command) {
+    if (isAbsolute(command) || command.includes('/'))
+        return existsSync(command);
+    const pathEnv = process.env.PATH ?? '';
+    return pathEnv.split(':').filter(Boolean).some((dir) => existsSync(join(dir, command)));
+}
+export const codexBackend = {
+    id: 'codex',
+    displayName: 'Codex CLI',
+    resolveCommand(config) {
+        return codexCommand(config);
+    },
+    buildSpawnArgs(ctx) {
+        const args = ['exec', '--json', BYPASS_FLAG, '--cd', ctx.worktreePath];
+        if (ctx.model)
+            args.push('--model', ctx.model);
+        args.push(...mcpConfigFlags(ctx.config));
+        // Trailing '-' tells codex exec to read the prompt from stdin.
+        args.push('-');
+        return args;
+    },
+    buildResumeArgs(ctx) {
+        // resume recovers the workspace from the session -- NO --cd, NEVER --ephemeral.
+        const args = ['exec', 'resume', ctx.resumeSessionId, '--json', BYPASS_FLAG];
+        if (ctx.model)
+            args.push('--model', ctx.model);
+        // MCP config overrides are global `-c` flags (accepted by the resume
+        // subcommand) so the resumed agent keeps Telora MCP access.
+        args.push(...mcpConfigFlags(ctx.config));
+        args.push('-');
+        return args;
+    },
+    encodeInput(content) {
+        // Codex reads the prompt as plain text on stdin (not stream-json).
+        return content.endsWith('\n') ? content : content + '\n';
+    },
+    createParser() {
+        return new CodexAgentParser();
+    },
+    async probeAvailability(config) {
+        const command = codexCommand(config);
+        if (!commandExists(command)) {
+            return {
+                available: false,
+                detail: `Codex CLI not found (looked for "${command}" on PATH). Install it (npm i -g @openai/codex) and run \`codex login\` on the daemon host.`,
+            };
+        }
+        if (process.env.CODEX_API_KEY) {
+            return { available: true };
+        }
+        if (existsSync(join(homedir(), '.codex', 'auth.json'))) {
+            return { available: true };
+        }
+        return {
+            available: false,
+            detail: `Codex CLI found at "${command}" but not authenticated. Run \`codex login\` or set CODEX_API_KEY on the daemon host.`,
+        };
+    },
+};
+//# sourceMappingURL=codex-backend.js.map

package/dist/backends/codex/codex-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-backend.js","sourceRoot":"","sources":["../../../src/backends/codex/codex-backend.ts"],"names":[],"mappings":"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"}

package/dist/backends/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent backend layer -- engine-agnostic spawn seam.
+ *
+ * Importing this barrel registers all built-in backends as a side effect, so
+ * any module that resolves a backend from the registry first imports from here.
+ */
+export { type AgentBackend, type AgentSpawnContext, type AgentResumeContext, type BackendAvailability, } from './agent-backend.js';
+export { DEFAULT_BACKEND_ID, registerBackend, getBackend, hasBackend, listBackends, _resetRegistry, } from './registry.js';
+export { claudeBackend } from './claude/claude-backend.js';
+export { codexBackend } from './codex/codex-backend.js';
+export { resolveBackend, type EnginePass, type EngineOverride, type EngineSource, type ResolvedEngine, type ResolveBackendArgs, } from './resolve.js';
+export { probeAllBackends, _resetAvailabilityCache, type BackendAvailabilityReport, } from './availability.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC"}

package/dist/backends/index.js

@@ -0,0 +1,20 @@
+/**
+ * Agent backend layer -- engine-agnostic spawn seam.
+ *
+ * Importing this barrel registers all built-in backends as a side effect, so
+ * any module that resolves a backend from the registry first imports from here.
+ */
+import { registerBackend } from './registry.js';
+import { claudeBackend } from './claude/claude-backend.js';
+import { codexBackend } from './codex/codex-backend.js';
+// Register built-in backends. `claude` is the default; `codex` is selectable
+// once per-spawn engine resolution (D3) lands -- registering it here makes it
+// resolvable and lets the availability probe (D4) report it.
+registerBackend(claudeBackend);
+registerBackend(codexBackend);
+export { DEFAULT_BACKEND_ID, registerBackend, getBackend, hasBackend, listBackends, _resetRegistry, } from './registry.js';
+export { claudeBackend } from './claude/claude-backend.js';
+export { codexBackend } from './codex/codex-backend.js';
+export { resolveBackend, } from './resolve.js';
+export { probeAllBackends, _resetAvailabilityCache, } from './availability.js';
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,6EAA6E;AAC7E,8EAA8E;AAC9E,6DAA6D;AAC7D,eAAe,CAAC,aAAa,CAAC,CAAC;AAC/B,eAAe,CAAC,YAAY,CAAC,CAAC;AAS9B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EACL,cAAc,GAMf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GAExB,MAAM,mBAAmB,CAAC"}

package/dist/backends/registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AgentBackend registry -- resolves an engine id to its implementation.
+ *
+ * Backends register themselves at module load (see ./index.ts, which imports
+ * and registers the built-in `claude` backend). Spawn paths resolve a backend
+ * by id; selection of WHICH id to use (org default + per-focus override) is a
+ * later delivery -- this registry only maps id -> implementation.
+ *
+ * Built N-backends-ready by design: adding Codex/Gemini later is a register
+ * call, not a rewrite.
+ */
+import type { AgentBackend } from './agent-backend.js';
+/** The default backend id used when no selection is provided. */
+export declare const DEFAULT_BACKEND_ID = "claude";
+/** Register (or replace) a backend implementation under its id. */
+export declare function registerBackend(backend: AgentBackend): void;
+/**
+ * Resolve a backend by id. Falls back to the default backend when the id is
+ * null/undefined. Throws when an explicitly requested id is not registered --
+ * a misconfigured engine should fail loudly, not silently run on the wrong one.
+ */
+export declare function getBackend(id?: string | null): AgentBackend;
+/** True when a backend is registered for the given id. */
+export declare function hasBackend(id: string): boolean;
+/** List all registered backends (for availability probing + the picker). */
+export declare function listBackends(): AgentBackend[];
+/** Test-only: clear the registry. */
+export declare function _resetRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/backends/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/backends/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAQ3D;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAE7C;AAED,qCAAqC;AACrC,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/backends/registry.js

@@ -0,0 +1,45 @@
+/**
+ * AgentBackend registry -- resolves an engine id to its implementation.
+ *
+ * Backends register themselves at module load (see ./index.ts, which imports
+ * and registers the built-in `claude` backend). Spawn paths resolve a backend
+ * by id; selection of WHICH id to use (org default + per-focus override) is a
+ * later delivery -- this registry only maps id -> implementation.
+ *
+ * Built N-backends-ready by design: adding Codex/Gemini later is a register
+ * call, not a rewrite.
+ */
+const registry = new Map();
+/** The default backend id used when no selection is provided. */
+export const DEFAULT_BACKEND_ID = 'claude';
+/** Register (or replace) a backend implementation under its id. */
+export function registerBackend(backend) {
+    registry.set(backend.id, backend);
+}
+/**
+ * Resolve a backend by id. Falls back to the default backend when the id is
+ * null/undefined. Throws when an explicitly requested id is not registered --
+ * a misconfigured engine should fail loudly, not silently run on the wrong one.
+ */
+export function getBackend(id) {
+    const resolvedId = id ?? DEFAULT_BACKEND_ID;
+    const backend = registry.get(resolvedId);
+    if (!backend) {
+        const known = Array.from(registry.keys()).join(', ') || '(none)';
+        throw new Error(`No agent backend registered for id "${resolvedId}". Registered: ${known}`);
+    }
+    return backend;
+}
+/** True when a backend is registered for the given id. */
+export function hasBackend(id) {
+    return registry.has(id);
+}
+/** List all registered backends (for availability probing + the picker). */
+export function listBackends() {
+    return Array.from(registry.values());
+}
+/** Test-only: clear the registry. */
+export function _resetRegistry() {
+    registry.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/backends/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/backends/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EAAkB;IAC3C,MAAM,UAAU,GAAG,EAAE,IAAI,kBAAkB,CAAC;IAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,uCAAuC,UAAU,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,cAAc;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/backends/resolve.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Per-spawn engine resolution -- the single place the daemon decides WHICH
+ * engine a spawn runs on.
+ *
+ * Selection is one knob (the engine) with a default + one override layer,
+ * most-specific wins, resolution always logged (the no-invisible-cascading
+ * principle). Mirrors the centralization of `shouldRunLoop()` in
+ * focus-engine.ts: one exported pure function, no side effects, easy to test.
+ *
+ * Resolution order for a pass (coding | review):
+ *   1. per-focus override for that pass   (focusOverride[pass], if a truthy id)
+ *   2. org-level default                  (orgDefault, if a truthy id)
+ *   3. the global default                 (DEFAULT_BACKEND_ID = 'claude')
+ *
+ * Guard: a resolved id that is not a registered backend (typo, or an engine the
+ * host lacks) falls back to the default rather than spawning on a bogus engine.
+ * With no override and no org default, this returns 'claude' -- behavior parity.
+ */
+/** A spawn "pass" -- the coding vs review lineage. */
+export type EnginePass = 'coding' | 'review';
+/** Per-focus engine override: an engine id per pass; absent/null = inherit. */
+export interface EngineOverride {
+    coding?: string | null;
+    review?: string | null;
+}
+/** Where the resolved engine came from (always logged). */
+export type EngineSource = 'focus-override' | 'org-default' | 'default' | 'fallback';
+export interface ResolvedEngine {
+    engineId: string;
+    source: EngineSource;
+}
+export interface ResolveBackendArgs {
+    /** Per-focus override map (null/absent = inherit the org default). */
+    focusOverride?: EngineOverride | null;
+    /** The pass being spawned. */
+    pass: EnginePass;
+    /** Org-level default engine id (null/absent = the global default). */
+    orgDefault?: string | null;
+}
+/**
+ * Resolve the engine id (and its source) for a spawn pass. Pure + deterministic.
+ */
+export declare function resolveBackend(args: ResolveBackendArgs): ResolvedEngine;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/backends/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/backends/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,8BAA8B;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA4BvE"}