@straiffi/archon 1.8.12 → 1.8.14

package/dist/server/lib/agent.js

@@ -2,56 +2,29 @@ import { spawn } from 'child_process';
 import { randomUUID } from 'crypto';
 import { readFileSync } from 'fs';
 import { extname, isAbsolute, join, relative, resolve, sep } from 'path';
-import Database from 'better-sqlite3';
 import db from '../db.js';
 import { getChatSession, updateChatSessionUsageSnapshot } from './chats.js';
 import { normalizeClaudeModelId, normalizeModelId } from './models.js';
 import { createOpencodeTaskSessionReader, parseOpencodeTaskEnvelope } from './opencodeTaskSessions.js';
+import { hostOpencodeSessionOperations } from './opencodeSessionOperations.js';
+import { hostExecutionEnvironment } from './hostExecutionEnvironment.js';
+import { claudeAgentProvider } from './claudeAgentProvider.js';
+import { buildOpencodeSpecReviewInvocation, createOpencodeExitError, createOpencodeRecoveryTracker, interpretOpencodeRecoveryEvent, isSuccessfulOpencodeExit, opencodeAgentProvider, } from './opencodeAgentProvider.js';
 import { appendClaudeHeadlessPlanPrompt, buildClaudeHeadlessPlanArgs } from './planModeQuestions.js';
 import { formatGenericToolCall } from './genericToolCall.js';
 import { getSpecSession, updateSpecSessionResumeId, updateSpecSessionStatus, updateSpecSessionTitle, updateSpecSessionUsageSnapshot } from './specs.js';
 import { updateSpecReviewRunStatus, updateSpecReviewRunStreaming, updateSpecReviewRunUsage } from './specReviews.js';
 import { createAgentRun, emitAgentRunsUpdated, finalizeAgentRun, getNextAgentRunIndex, listAgentRunsForExecutionRun, listAgentRunsForParent, updateAgentRunLabel, updateAgentRunSessionId, updateAgentRunStatus } from './agentRuns.js';
-import { resolveOpencodeDbPath } from './runtimePaths.js';
 import { markTicketDescriptionVisibleInBundle } from './ticketMessages.js';
 import { getTicket } from './tickets.js';
 import { createTranscriptRunSnapshots } from './transcriptRuns.js';
 import { createWorkspaceProcessEnvironment } from './workspaceProcessEnvironment.js';
+import { OpencodeModelResolutionError, parseOpencodeStderrModelResolutionError, } from './opencodeErrors.js';
+import { extractLeadingOpencodeJsonObjects } from './opencodePromptOutput.js';
 import { assertAgentSpawnPermit, AgentSpawnPermitRevokedError } from './agentSpawnPermits.js';
 const withTranscriptRuns = (value, transcriptRuns) => {
     return transcriptRuns ? { ...value, transcriptRuns } : value;
 };
-const createOpencodeRecoveryTracker = () => {
-    let sawError = false;
-    let latestEvent = null;
-    let recoveredFinalAnswerFragments = [];
-    return {
-        consume: events => {
-            let shouldResetResponse = false;
-            for (const event of events ?? []) {
-                latestEvent = event.type;
-                if (event.type === 'error') {
-                    sawError = true;
-                    recoveredFinalAnswerFragments = [];
-                    shouldResetResponse = true;
-                    continue;
-                }
-                if (sawError) {
-                    recoveredFinalAnswerFragments.push(event.text);
-                }
-            }
-            return shouldResetResponse;
-        },
-        hasRecoveredFinalAnswer: () => (sawError
-            && latestEvent === 'final_answer'
-            && recoveredFinalAnswerFragments.length > 0),
-        hasUnrecoveredError: () => latestEvent === 'error',
-        getRecoveredResponse: () => recoveredFinalAnswerFragments.join('\n\n'),
-    };
-};
-const isSuccessfulOpencodeExit = (code, modelError, recoveryTracker) => (!modelError
-    && !recoveryTracker.hasUnrecoveredError()
-    && (code === 0 || recoveryTracker.hasRecoveredFinalAnswer()));
 export class AgentContinuationRejectedError extends Error {
     constructor(message) {
         super(message);
@@ -74,7 +47,6 @@ export const getAgentErrorTranscriptRuns = (error) => {
     const transcriptRuns = error.transcriptRuns;
     return Array.isArray(transcriptRuns) && transcriptRuns.length > 0 ? transcriptRuns : null;
 };
-const OPENCODE_PLACEHOLDER_TITLE_PATTERN = /^New session\b/i;
 const OPENCODE_SESSION_METADATA_LOOKUP_DELAY_MS = 1500;
 const AGENT_PROGRESS_UPDATE_INTERVAL_MS = 100;
 const resolveAgentModel = (tool, model) => {
@@ -140,13 +112,6 @@ const buildClaudeArgs = (mode, model, resumeSessionId, sessionId) => {
         sessionId,
     ];
 };
-const OPENCODE_SESSION_BY_ID_QUERY = 'SELECT id, title FROM session WHERE id = ? LIMIT 1';
-const OPENCODE_SESSION_BY_CREATED_AT_QUERY = 'SELECT id, title FROM session WHERE time_created > ? ORDER BY time_created DESC LIMIT 1';
-const OPENCODE_COMPLETED_ASSISTANT_MESSAGE_USAGE_QUERY = "SELECT data FROM message WHERE session_id = ? AND json_extract(data, '$.role') = 'assistant' AND json_extract(data, '$.time.completed') IS NOT NULL ORDER BY time_created DESC LIMIT 1";
-const OPENCODE_COMPLETED_ASSISTANT_MESSAGE_USAGE_SINCE_QUERY = "SELECT data FROM message WHERE session_id = ? AND time_created >= ? AND json_extract(data, '$.role') = 'assistant' AND json_extract(data, '$.time.completed') IS NOT NULL ORDER BY time_created DESC LIMIT 1";
-const OPENCODE_STEP_FINISH_USAGE_QUERY = "SELECT data FROM part WHERE session_id = ? AND json_extract(data, '$.type') = 'step-finish' ORDER BY time_created DESC LIMIT 1";
-const OPENCODE_STEP_FINISH_USAGE_SINCE_QUERY = "SELECT data FROM part WHERE session_id = ? AND time_created >= ? AND json_extract(data, '$.type') = 'step-finish' ORDER BY time_created DESC LIMIT 1";
-const OPENCODE_SESSION_COST_QUERY = 'SELECT cost FROM session WHERE id = ?';
 const GET_PERSISTED_CHAT_STATE_QUERY = 'SELECT agent_log, streaming_response, opencode_session_id FROM chat_sessions WHERE id = ?';
 const GET_PERSISTED_SPEC_STATE_QUERY = 'SELECT agent_log, streaming_response, opencode_session_id FROM spec_sessions WHERE id = ?';
 export const EMPTY_CHAT_USAGE_SNAPSHOT = {
@@ -284,7 +249,7 @@ export const mergeUsageFromJsonLine = (current, line) => {
     if (!trimmedLine.startsWith('{')) {
         return current;
     }
-    const { jsonObjects } = extractLeadingJsonObjects(trimmedLine);
+    const { jsonObjects } = extractLeadingOpencodeJsonObjects(trimmedLine);
     let next = current;
     for (const jsonObject of jsonObjects) {
         try {
@@ -310,9 +275,6 @@ export const mergeUsageFromJsonLine = (current, line) => {
     }
     return next;
 };
-const hasUsageSnapshot = (value) => {
-    return Object.values(value).some(candidate => candidate !== null && candidate !== undefined);
-};
 const hasMatchingUsageSnapshot = (current, next) => {
     return current.usage_snapshot_context_window === next.usage_snapshot_context_window
         && current.usage_snapshot_max_output_tokens === next.usage_snapshot_max_output_tokens
@@ -483,67 +445,12 @@ const createThrottledProgressUpdater = (flushUpdate) => {
         },
     };
 };
-const openOpencodeDatabase = () => new Database(resolveOpencodeDbPath(), { readonly: true });
-const readOpencodeSession = (statement, value) => {
-    const opencodeDb = openOpencodeDatabase();
-    try {
-        const row = opencodeDb.prepare(statement).get(value);
-        if (!row?.id) {
-            return null;
-        }
-        const normalizedTitle = typeof row.title === 'string'
-            ? row.title.trim() || null
-            : null;
-        const title = normalizedTitle && !OPENCODE_PLACEHOLDER_TITLE_PATTERN.test(normalizedTitle)
-            ? normalizedTitle
-            : null;
-        return {
-            id: row.id,
-            title,
-        };
-    }
-    finally {
-        opencodeDb.close();
-    }
-};
 export const readOpencodeUsageSnapshot = ({ sessionId, spawnTimestamp = null, }) => {
-    const opencodeDb = openOpencodeDatabase();
-    try {
-        const costRow = opencodeDb.prepare(OPENCODE_SESSION_COST_QUERY).get(sessionId);
-        const sessionCost = typeof costRow?.cost === 'number' ? { usage_snapshot_cost: costRow.cost } : {};
-        const completedAssistantMessage = (spawnTimestamp === null
-            ? opencodeDb.prepare(OPENCODE_COMPLETED_ASSISTANT_MESSAGE_USAGE_QUERY).get(sessionId)
-            : opencodeDb.prepare(OPENCODE_COMPLETED_ASSISTANT_MESSAGE_USAGE_SINCE_QUERY).get(sessionId, spawnTimestamp));
-        if (typeof completedAssistantMessage?.data === 'string') {
-            try {
-                const parsedUsage = extractChatUsageSnapshot(JSON.parse(completedAssistantMessage.data));
-                if (hasUsageSnapshot(parsedUsage)) {
-                    return mergeChatUsageSnapshot(mergeChatUsageSnapshot(EMPTY_CHAT_USAGE_SNAPSHOT, parsedUsage), sessionCost);
-                }
-            }
-            catch {
-                // Fall through to the step-finish lookup below.
-            }
-        }
-        const latestStepFinish = (spawnTimestamp === null
-            ? opencodeDb.prepare(OPENCODE_STEP_FINISH_USAGE_QUERY).get(sessionId)
-            : opencodeDb.prepare(OPENCODE_STEP_FINISH_USAGE_SINCE_QUERY).get(sessionId, spawnTimestamp));
-        if (typeof latestStepFinish?.data === 'string') {
-            try {
-                const parsedUsage = extractChatUsageSnapshot(JSON.parse(latestStepFinish.data));
-                if (hasUsageSnapshot(parsedUsage)) {
-                    return mergeChatUsageSnapshot(mergeChatUsageSnapshot(EMPTY_CHAT_USAGE_SNAPSHOT, parsedUsage), sessionCost);
-                }
-            }
-            catch {
-                return mergeChatUsageSnapshot(EMPTY_CHAT_USAGE_SNAPSHOT, sessionCost);
-            }
-        }
-        return mergeChatUsageSnapshot(EMPTY_CHAT_USAGE_SNAPSHOT, sessionCost);
-    }
-    finally {
-        opencodeDb.close();
+    const snapshot = hostOpencodeSessionOperations.readUsageSnapshot(sessionId, spawnTimestamp);
+    if (!snapshot) {
+        throw new Error('OpenCode usage snapshot read failed');
     }
+    return snapshot;
 };
 const resolveOpencodeUsageSnapshot = ({ current, sessionId, spawnTimestamp = null, }) => {
     try {
@@ -638,12 +545,12 @@ const createOpencodeMetadataRefresher = ({ chatSessionId, io, spawnTimestamp, in
     };
     const readCurrentSession = () => {
         if (knownSessionId) {
-            return readOpencodeSession(OPENCODE_SESSION_BY_ID_QUERY, knownSessionId);
+            return hostOpencodeSessionOperations.findSessionById(knownSessionId);
         }
         if (spawnTimestamp === null) {
             return null;
         }
-        return readOpencodeSession(OPENCODE_SESSION_BY_CREATED_AT_QUERY, spawnTimestamp);
+        return hostOpencodeSessionOperations.findLatestSessionAfter(spawnTimestamp);
     };
     const refresh = () => {
         if (stopped) {
@@ -706,12 +613,12 @@ const createSpecOpencodeMetadataRefresher = ({ specSessionId, io, spawnTimestamp
     };
     const readCurrentSession = () => {
         if (knownSessionId) {
-            return readOpencodeSession(OPENCODE_SESSION_BY_ID_QUERY, knownSessionId);
+            return hostOpencodeSessionOperations.findSessionById(knownSessionId);
         }
         if (spawnTimestamp === null) {
             return null;
         }
-        return readOpencodeSession(OPENCODE_SESSION_BY_CREATED_AT_QUERY, spawnTimestamp);
+        return hostOpencodeSessionOperations.findLatestSessionAfter(spawnTimestamp);
     };
     const refresh = () => {
         if (stopped) {
@@ -956,6 +863,7 @@ const emptyParsedStreamLine = () => ({
     responseFragment: null,
     subagentEvents: [],
     providerSessionId: null,
+    modelResolutionError: false,
 });
 const isExecutionCapableParsedStreamLine = (parsed) => (parsed.logFragment !== null
     || parsed.responseFragment !== null
@@ -1067,62 +975,6 @@ const formatOpencodeStepTitle = (event) => {
     const title = event.part?.title?.trim();
     return title || null;
 };
-const extractLeadingJsonObject = (line) => {
-    if (!line.startsWith('{')) {
-        return null;
-    }
-    let depth = 0;
-    let inString = false;
-    let escaping = false;
-    for (let index = 0; index < line.length; index += 1) {
-        const char = line[index];
-        if (inString) {
-            if (escaping) {
-                escaping = false;
-                continue;
-            }
-            if (char === '\\') {
-                escaping = true;
-                continue;
-            }
-            if (char === '"') {
-                inString = false;
-            }
-            continue;
-        }
-        if (char === '"') {
-            inString = true;
-            continue;
-        }
-        if (char === '{') {
-            depth += 1;
-            continue;
-        }
-        if (char === '}') {
-            depth -= 1;
-            if (depth === 0) {
-                return line.slice(0, index + 1);
-            }
-        }
-    }
-    return null;
-};
-const extractLeadingJsonObjects = (line) => {
-    const jsonObjects = [];
-    let remaining = line.trim();
-    while (remaining.startsWith('{')) {
-        const jsonObject = extractLeadingJsonObject(remaining);
-        if (!jsonObject) {
-            break;
-        }
-        jsonObjects.push(jsonObject);
-        remaining = remaining.slice(jsonObject.length).trim();
-    }
-    return {
-        jsonObjects,
-        remainder: remaining,
-    };
-};
 const parseOpencodeJsonEvent = (event, cwd) => {
     const providerSessionId = event.sessionID?.trim()
         || event.sessionId?.trim()
@@ -1132,14 +984,14 @@ const parseOpencodeJsonEvent = (event, cwd) => {
     if (event.type === 'text' && event.part?.type === 'text' && event.part.text) {
         const text = event.part.text.trim();
         const phase = event.part.metadata?.openai?.phase;
+        const recoveryEvent = interpretOpencodeRecoveryEvent(event.type, event.error, text, phase);
         return {
             logFragment: text || null,
             responseFragment: text && (!phase || phase === 'final_answer') ? text : null,
             subagentEvents: [],
             providerSessionId,
-            recoveryEvents: text && phase === 'final_answer'
-                ? [{ type: 'final_answer', text }]
-                : [],
+            modelResolutionError: false,
+            recoveryEvents: recoveryEvent ? [recoveryEvent] : [],
         };
     }
     if (event.type === 'reasoning' && event.part?.type === 'reasoning') {
@@ -1149,6 +1001,7 @@ const parseOpencodeJsonEvent = (event, cwd) => {
             responseFragment: null,
             subagentEvents: [],
             providerSessionId,
+            modelResolutionError: false,
         };
     }
     if (event.type === 'tool' || event.type === 'tool_use' || event.type === 'tool_result') {
@@ -1188,6 +1041,7 @@ const parseOpencodeJsonEvent = (event, cwd) => {
                         : []),
                 ],
                 providerSessionId,
+                modelResolutionError: false,
             };
         }
         if (!isToolInvocation) {
@@ -1199,6 +1053,7 @@ const parseOpencodeJsonEvent = (event, cwd) => {
             responseFragment: null,
             subagentEvents: [],
             providerSessionId,
+            modelResolutionError: false,
         };
     }
     if (event.type === 'step_start') {
@@ -1207,6 +1062,7 @@ const parseOpencodeJsonEvent = (event, cwd) => {
             responseFragment: null,
             subagentEvents: [],
             providerSessionId,
+            modelResolutionError: false,
         };
     }
     if (event.type === 'step_finish') {
@@ -1215,23 +1071,19 @@ const parseOpencodeJsonEvent = (event, cwd) => {
             responseFragment: null,
             subagentEvents: [],
             providerSessionId,
+            modelResolutionError: false,
         };
     }
     if (event.type === 'error') {
-        const errorText = typeof event.error === 'string'
-            ? event.error.trim()
-            : event.error && typeof event.error === 'object'
-                ? (event.error.data?.message?.trim()
-                    || event.error.message?.trim()
-                    || JSON.stringify(event.error))
-                : '';
-        const text = event.part?.text?.trim() || errorText || '';
+        const recoveryEvent = interpretOpencodeRecoveryEvent(event.type, event.error, event.part?.text, undefined);
+        const parsedError = recoveryEvent?.type === 'error' ? recoveryEvent.error : null;
+        const text = parsedError?.message ?? '';
         return {
             logFragment: text ? `**Error:** ${text}` : null,
             responseFragment: null,
             subagentEvents: [],
             providerSessionId,
-            recoveryEvents: [{ type: 'error' }],
+            recoveryEvents: recoveryEvent ? [recoveryEvent] : [],
         };
     }
     return emptyParsedStreamLine();
@@ -1241,7 +1093,7 @@ const parseOpencodeJsonLine = (line, cwd) => {
     if (!trimmed) {
         return emptyParsedStreamLine();
     }
-    const { jsonObjects, remainder } = extractLeadingJsonObjects(trimmed);
+    const { jsonObjects, remainder } = extractLeadingOpencodeJsonObjects(trimmed);
     if (jsonObjects.length === 0) {
         if (trimmed.startsWith('{')) {
             return emptyParsedStreamLine();
@@ -1259,13 +1111,14 @@ const parseOpencodeJsonLine = (line, cwd) => {
                     }],
             };
         }
-        return { logFragment: trimmed, responseFragment: trimmed, subagentEvents: [], providerSessionId: null };
+        return { logFragment: trimmed, responseFragment: trimmed, subagentEvents: [], providerSessionId: null, modelResolutionError: false };
     }
     const logFragments = [];
     const responseFragments = [];
     const subagentEvents = [];
     const recoveryEvents = [];
     let providerSessionId = null;
+    let modelResolutionError = false;
     for (const jsonObject of jsonObjects) {
         let event;
         try {
@@ -1278,6 +1131,7 @@ const parseOpencodeJsonLine = (line, cwd) => {
         const { logFragment, responseFragment } = parsedEvent;
         subagentEvents.push(...parsedEvent.subagentEvents);
         recoveryEvents.push(...(parsedEvent.recoveryEvents ?? []));
+        modelResolutionError ||= Boolean(parsedEvent.modelResolutionError);
         providerSessionId = providerSessionId ?? parsedEvent.providerSessionId;
         if (logFragment !== null) {
             logFragments.push(logFragment);
@@ -1308,6 +1162,7 @@ const parseOpencodeJsonLine = (line, cwd) => {
             responseFragment: responseFragments.length > 0 ? responseFragments.join('\n\n') : null,
             subagentEvents,
             providerSessionId,
+            modelResolutionError,
             recoveryEvents,
         };
     }
@@ -1731,12 +1586,7 @@ const buildResponseTiming = ({ startTime, firstFinalAnswerTime, isStopped, }) =>
     const responseMs = Date.now() - firstFinalAnswerTime;
     return { totalMs, thinkingMs, responseMs };
 };
-const isModelResolutionError = (message) => {
-    if (typeof message !== 'string') {
-        return false;
-    }
-    return /ProviderModelNotFoundError|Model not found/i.test(message);
-};
+const isLegacyModelResolutionError = (message) => (typeof message === 'string' && /ProviderModelNotFoundError|Model not found/i.test(message));
 const isProcessAlive = (proc) => {
     if (!proc) {
         return false;
@@ -1764,6 +1614,16 @@ const killProcess = (proc, signal) => {
     catch {
     }
 };
+const interruptProcess = (state, signal) => {
+    if (!isProcessAlive(state.child)) {
+        return;
+    }
+    if (state.interrupt) {
+        state.interrupt(signal);
+        return;
+    }
+    killProcess(state.child, signal);
+};
 const waitForProcessExit = async (proc, timeoutMs) => {
     const deadline = Date.now() + timeoutMs;
     await new Promise(resolve => {
@@ -1797,6 +1657,7 @@ const untrackChatProcess = (chatSessionId, state) => {
 export const registerChatProcessPlaceholder = (chatSessionId) => {
     const state = {
         child: null,
+        interrupt: null,
         researchChildren: new Set(),
         stopRequested: false,
         metadataRefresher: null,
@@ -1805,7 +1666,7 @@ export const registerChatProcessPlaceholder = (chatSessionId) => {
     return state;
 };
 export const registerBuildProcessPlaceholder = (ticketId) => {
-    const state = { child: null, stopRequested: false, sessionLookupTimer: null };
+    const state = { child: null, interrupt: null, stopRequested: false, sessionLookupTimer: null };
     activeBuildProcesses.set(ticketId, state);
     return state;
 };
@@ -1836,6 +1697,7 @@ const untrackSpecProcess = (specSessionId, state) => {
 export const registerSpecProcessPlaceholder = (specSessionId) => {
     const state = {
         child: null,
+        interrupt: null,
         researchChildren: new Set(),
         stopRequested: false,
         metadataRefresher: null,
@@ -1859,6 +1721,7 @@ const untrackSpecReviewProcess = (specReviewRunId, state) => {
 export const registerSpecReviewProcessPlaceholder = (specReviewRunId) => {
     const state = {
         child: null,
+        interrupt: null,
         researchChildren: new Set(),
         stopRequested: false,
         metadataRefresher: null,
@@ -1904,10 +1767,20 @@ export const stopBuildAgent = async (ticketId) => {
     if (!state.child) {
         return true;
     }
-    killProcess(state.child, 'SIGTERM');
+    if (state.interrupt) {
+        state.interrupt('SIGTERM');
+    }
+    else {
+        killProcess(state.child, 'SIGTERM');
+    }
     await waitForProcessExit(state.child, 5000);
     if (isProcessAlive(state.child)) {
-        killProcess(state.child, 'SIGKILL');
+        if (state.interrupt) {
+            state.interrupt('SIGKILL');
+        }
+        else {
+            killProcess(state.child, 'SIGKILL');
+        }
         await waitForProcessExit(state.child, 1000);
     }
     return true;
@@ -1983,15 +1856,15 @@ export const stopSpecReviewAgent = async (specReviewRunId) => {
     if (!state.child) {
         return true;
     }
-    killProcess(state.child, 'SIGTERM');
+    interruptProcess(state, 'SIGTERM');
     await waitForProcessExit(state.child, 5000);
     if (isProcessAlive(state.child)) {
-        killProcess(state.child, 'SIGKILL');
+        interruptProcess(state, 'SIGKILL');
         await waitForProcessExit(state.child, 1000);
     }
     return true;
 };
-export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = null, resumeSessionId = null, sessionField = 'session_id', trackBuildProcess = false, reviewProcessState, emitSuccessUpdate = true, opencodeAgentMode, runStream, executionContext, persistSessionIdToTicket = false, spawnPermitId, }) => {
+export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = null, resumeSessionId = null, sessionField = 'session_id', trackBuildProcess = false, reviewProcessState, emitSuccessUpdate = true, opencodeAgentMode, runStream, executionContext, persistSessionIdToTicket = false, spawnPermitId, executionProvider = hostExecutionEnvironment, }) => {
     const resolvedModel = resolveAgentModel(tool, model);
     const subagentTracker = createSubagentRunTracker({
         parentType: 'ticket',
@@ -2089,7 +1962,7 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
                 return hasResolvedOpencodeSessionId;
             }
             try {
-                const session = readOpencodeSession(OPENCODE_SESSION_BY_CREATED_AT_QUERY, spawnTimestamp);
+                const session = hostOpencodeSessionOperations.findLatestSessionAfter(spawnTimestamp);
                 if (session?.id) {
                     bindResolvedOpencodeSession(session.id);
                 }
@@ -2099,15 +1972,19 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
             }
             return hasResolvedOpencodeSessionId;
         };
-        const [cmd, args] = tool === 'claude'
-            ? (() => {
-                sessionId = resumeSessionId || randomUUID();
-                return [
-                    'claude',
-                    buildClaudeArgs(opencodeAgentMode, resolvedModel, resumeSessionId, sessionId),
-                ];
-            })()
-            : ['opencode', ['run', ...(opencodeAgentMode === 'plan' ? ['--agent', 'plan'] : []), '--format', 'json', '--thinking', ...(resumeSessionId ? ['--session', resumeSessionId] : []), ...(resolvedModel ? ['--model', resolvedModel] : []), ...(variant ? ['--variant', variant] : []), prompt]];
+        const agentProvider = tool === 'claude'
+            ? claudeAgentProvider
+            : opencodeAgentProvider;
+        const invocation = agentProvider.buildStreamingInvocation({
+            cwd,
+            prompt,
+            model: resolvedModel,
+            variant,
+            mode: opencodeAgentMode,
+            resumeSessionId,
+            sessionId: randomUUID(),
+        });
+        sessionId = invocation.sessionId;
         writeRunStatus('running', null);
         if (tool === 'claude' && sessionId) {
             writeRunSessionId(sessionId);
@@ -2116,6 +1993,8 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
             spawnTimestamp = Date.now();
         }
         let child;
+        let interrupt;
+        let placementFailure;
         try {
             if (buildState?.stopRequested) {
                 throw new AgentSpawnPermitRevokedError();
@@ -2123,28 +2002,37 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
             if (spawnPermitId && executionContext) {
                 assertAgentSpawnPermit(spawnPermitId, executionContext.runId);
             }
-            child = spawn(cmd, args, {
+            const handle = executionProvider.execute({
+                target: {
+                    kind: 'worktree',
+                    id: ticketId,
+                    workspacePath: cwd,
+                    revision: 'working-tree',
+                },
+                command: invocation.command,
+                args: invocation.args,
                 cwd,
-                stdio: tool === 'claude' ? ['pipe', 'pipe', 'pipe'] : ['ignore', 'pipe', 'pipe'],
+                stdio: invocation.stdio,
                 env: createWorkspaceProcessEnvironment(cwd, { PWD: cwd }),
                 detached: process.platform !== 'win32',
             });
+            child = handle.child;
+            interrupt = handle.interrupt;
+            placementFailure = handle.placementFailure;
         }
         catch (error) {
-            const resolvedError = error instanceof Error ? error : new Error(String(error));
+            const resolvedError = agentProvider.classifyExecutionFailure(error);
             const transcriptRuns = subagentTracker.finalize('error', resolvedError.message, null);
             rejectOnce(attachTranscriptRunsToError(resolvedError, transcriptRuns));
             return;
         }
         reviewChild = child;
-        if (tool === 'claude') {
-            const claudePrompt = opencodeAgentMode === 'plan'
-                ? appendClaudeHeadlessPlanPrompt(prompt)
-                : prompt;
-            writeClaudeStdin(child, buildClaudeStdinMessage(claudePrompt, [], cwd));
+        if (invocation.stdin !== null) {
+            writeClaudeStdin(child, invocation.stdin);
         }
         if (trackBuildProcess && buildState) {
             buildState.child = child;
+            buildState.interrupt = interrupt;
             activeBuildProcesses.set(ticketId, buildState);
         }
         if (reviewProcessState) {
@@ -2153,6 +2041,14 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
                 killProcess(child, 'SIGTERM');
             }
         }
+        void placementFailure.then(failure => {
+            if (!failure || settled) {
+                return;
+            }
+            const resolvedError = agentProvider.classifyExecutionFailure(failure);
+            const transcriptRuns = finalizeRun('error', getErrorMessage(resolvedError), null);
+            rejectOnce(attachTranscriptRunsToError(resolvedError, transcriptRuns));
+        });
         startTime = Date.now();
         if (tool === 'opencode' && spawnTimestamp !== null) {
             opencodeSubagentMonitor = createOpencodeSubagentMonitor({
@@ -2221,7 +2117,7 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
                 const errOutput = Buffer.concat(stderrChunks).toString();
                 const finalLog = logLines.join('\n\n') || errOutput;
                 const finalResponse = responseLines.join('\n\n') || errOutput;
-                const modelError = isModelResolutionError(finalLog);
+                const modelError = isLegacyModelResolutionError(errOutput);
                 const timing = startTime ? { totalMs: Date.now() - startTime } : null;
                 if (buildState?.stopRequested || reviewProcessState?.stopRequested) {
                     const transcriptRuns = finalizeRun('stopped', finalLog, finalResponse);
@@ -2247,8 +2143,9 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
                     resolveOnce(withTranscriptRuns({ response: null, responseTiming: null, usageSnapshot }, transcriptRuns));
                     return;
                 }
-                const transcriptRuns = finalizeRun('error', getErrorMessage(err), null);
-                rejectOnce(attachTranscriptRunsToError(err, transcriptRuns));
+                const resolvedError = agentProvider.classifyExecutionFailure(err);
+                const transcriptRuns = finalizeRun('error', getErrorMessage(resolvedError), null);
+                rejectOnce(attachTranscriptRunsToError(resolvedError, transcriptRuns));
             });
             return;
         }
@@ -2331,14 +2228,14 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
             const finalResponse = recoveryTracker.hasRecoveredFinalAnswer()
                 ? recoveredResponse
                 : responseLines.join('\n\n') || stderrOutput;
-            const modelError = isModelResolutionError(log);
+            const stderrModelError = parseOpencodeStderrModelResolutionError(stderrOutput);
             const timing = buildResponseTiming({ startTime, firstFinalAnswerTime, isStopped: Boolean(buildState?.stopRequested || reviewProcessState?.stopRequested) });
             if (buildState?.stopRequested || reviewProcessState?.stopRequested) {
                 const transcriptRuns = finalizeRun('stopped', log, finalResponse);
                 resolveOnce(withTranscriptRuns({ response: finalResponse, responseTiming: timing }, transcriptRuns));
                 return;
             }
-            if (isSuccessfulOpencodeExit(code, modelError, recoveryTracker)) {
+            if (isSuccessfulOpencodeExit(code, stderrModelError, recoveryTracker)) {
                 const transcriptRuns = finalizeRun('done', log, finalResponse, { emit: emitSuccessUpdate });
                 resolveOnce(withTranscriptRuns({ response: finalResponse, responseTiming: timing }, transcriptRuns));
                 return;
@@ -2346,7 +2243,7 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
             const failureMessage = `Agent exited with code ${code ?? 'null'}\n${log}${stderrOutput !== log && stderrOutput ? '\n\n' + stderrOutput : ''}`;
             const error = resumeSessionId && !executionCapableEventObserved && isTypedPreExecutionContinuationRejection(failureMessage)
                 ? new AgentContinuationRejectedError(failureMessage)
-                : new Error(failureMessage);
+                : createOpencodeExitError(failureMessage, stderrModelError, recoveryTracker);
             const transcriptRuns = finalizeRun('error', log, finalResponse);
             rejectOnce(attachTranscriptRunsToError(error, transcriptRuns));
         });
@@ -2361,8 +2258,9 @@ export const runAgent = ({ ticketId, tool, prompt, cwd, io, model, variant = nul
                 resolveOnce(withTranscriptRuns({ response: null, responseTiming: null }, transcriptRuns));
                 return;
             }
-            const transcriptRuns = finalizeRun('error', getErrorMessage(err), null);
-            rejectOnce(attachTranscriptRunsToError(err, transcriptRuns));
+            const resolvedError = agentProvider.classifyExecutionFailure(err);
+            const transcriptRuns = finalizeRun('error', getErrorMessage(resolvedError), null);
+            rejectOnce(attachTranscriptRunsToError(resolvedError, transcriptRuns));
         });
     });
 };
@@ -2555,7 +2453,7 @@ export const runChatAgent = ({ chatSessionId, tool, prompt, files = [], cwd, io,
                     }, transcriptRuns));
                     return;
                 }
-                const modelError = isModelResolutionError(finalLog);
+                const modelError = isLegacyModelResolutionError(errOutput);
                 if (code === 0 && !modelError) {
                     const finalOutput = getPreservedChatOutput({
                         chatSessionId,
@@ -2709,8 +2607,8 @@ export const runChatAgent = ({ chatSessionId, tool, prompt, files = [], cwd, io,
                 }, transcriptRuns));
                 return;
             }
-            const modelError = isModelResolutionError(log);
-            if (isSuccessfulOpencodeExit(code, modelError, recoveryTracker)) {
+            const stderrModelError = parseOpencodeStderrModelResolutionError(stderrOutput);
+            if (isSuccessfulOpencodeExit(code, stderrModelError, recoveryTracker)) {
                 const finalOutput = getPreservedChatOutput({
                     chatSessionId,
                     log,
@@ -2737,7 +2635,7 @@ export const runChatAgent = ({ chatSessionId, tool, prompt, files = [], cwd, io,
             const failureMessage = `Agent exited with code ${code ?? 'null'}\n${log}${stderrOutput !== log && stderrOutput ? '\n\n' + stderrOutput : ''}`;
             const error = resumeSessionId && !executionCapableEventObserved && isTypedPreExecutionContinuationRejection(failureMessage)
                 ? new AgentContinuationRejectedError(failureMessage)
-                : new Error(failureMessage);
+                : createOpencodeExitError(failureMessage, stderrModelError, recoveryTracker);
             const transcriptRuns = subagentTracker.finalize('error', log, finalResponse);
             rejectOnce(attachTranscriptRunsToError(error, transcriptRuns));
         });
@@ -2938,7 +2836,7 @@ export const runSpecAgent = ({ specSessionId, tool, prompt, files = [], cwd, io,
                     }, transcriptRuns));
                     return;
                 }
-                const modelError = isModelResolutionError(finalLog);
+                const modelError = isLegacyModelResolutionError(errOutput);
                 if (code === 0 && !modelError) {
                     const finalOutput = getPreservedSpecOutput({
                         specSessionId,
@@ -3083,8 +2981,8 @@ export const runSpecAgent = ({ specSessionId, tool, prompt, files = [], cwd, io,
                 }, transcriptRuns));
                 return;
             }
-            const modelError = isModelResolutionError(log);
-            if (isSuccessfulOpencodeExit(code, modelError, recoveryTracker)) {
+            const stderrModelError = parseOpencodeStderrModelResolutionError(stderrOutput);
+            if (isSuccessfulOpencodeExit(code, stderrModelError, recoveryTracker)) {
                 const finalOutput = getPreservedSpecOutput({
                     specSessionId,
                     log,
@@ -3109,7 +3007,8 @@ export const runSpecAgent = ({ specSessionId, tool, prompt, files = [], cwd, io,
             }
             updateSpecSessionStatusLocal(specSessionId, 'error', log, io, finalResponse);
             const transcriptRuns = subagentTracker.finalize('error', log, finalResponse);
-            rejectOnce(attachTranscriptRunsToError(new Error(`Agent exited with code ${code ?? 'null'}\n${log}${stderrOutput !== log && stderrOutput ? '\n\n' + stderrOutput : ''}`), transcriptRuns));
+            const failureMessage = `Agent exited with code ${code ?? 'null'}\n${log}${stderrOutput !== log && stderrOutput ? '\n\n' + stderrOutput : ''}`;
+            rejectOnce(attachTranscriptRunsToError(createOpencodeExitError(failureMessage, stderrModelError, recoveryTracker), transcriptRuns));
         });
         child.on('error', err => {
             progressUpdater.cancel();
@@ -3166,6 +3065,7 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
     });
     return new Promise((resolve, reject) => {
         let spawnTimestamp = null;
+        let opencodeSessionId = null;
         let opencodeSubagentMonitor = null;
         let settled = false;
         let startTime = null;
@@ -3173,6 +3073,7 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
         let usageSnapshot = EMPTY_CHAT_USAGE_SNAPSHOT;
         const reviewState = registeredState ?? {
             child: null,
+            interrupt: null,
             researchChildren: new Set(),
             stopRequested: false,
             metadataRefresher: null,
@@ -3188,21 +3089,56 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
         };
         const resolveOnce = settle(resolve);
         const rejectOnce = settle(reject);
-        const [cmd, args] = tool === 'claude'
-            ? [
-                'claude',
-                buildClaudeArgs('plan', resolvedModel, null, randomUUID()),
-            ]
-            : ['opencode', ['run', '--agent', 'plan', '--format', 'json', '--thinking', ...(resolvedModel ? ['--model', resolvedModel] : []), ...(variant ? ['--variant', variant] : []), ...files.flatMap(filePath => ['--file', filePath]), ...(files.length > 0 ? ['--'] : []), prompt]];
+        const [cmd, args] = [
+            'claude',
+            buildClaudeArgs('plan', resolvedModel, null, randomUUID()),
+        ];
         updateSpecReviewRunStreaming(specReviewRunId, null);
-        const child = spawn(cmd, args, {
-            cwd,
-            stdio: tool === 'claude' ? ['pipe', 'pipe', 'pipe'] : ['ignore', 'pipe', 'pipe'],
-            env: createWorkspaceProcessEnvironment(cwd, { PWD: cwd }),
-            detached: process.platform !== 'win32',
-        });
+        const env = createWorkspaceProcessEnvironment(cwd, { PWD: cwd });
+        let child;
+        if (tool === 'opencode') {
+            const invocation = buildOpencodeSpecReviewInvocation({ prompt, files, model: resolvedModel, variant });
+            try {
+                const handle = hostExecutionEnvironment.execute({
+                    target: {
+                        kind: 'repository',
+                        id: cwd,
+                        workspacePath: cwd,
+                        revision: 'working-tree',
+                    },
+                    command: invocation.command,
+                    args: invocation.args,
+                    cwd,
+                    stdio: invocation.stdio,
+                    env,
+                    detached: process.platform !== 'win32',
+                });
+                child = handle.child;
+                reviewState.interrupt = handle.interrupt;
+                void handle.placementFailure.then(failure => {
+                    if (failure) {
+                        rejectOnce(opencodeAgentProvider.classifyExecutionFailure(failure));
+                    }
+                });
+            }
+            catch (error) {
+                rejectOnce(opencodeAgentProvider.classifyExecutionFailure(error));
+                return;
+            }
+        }
+        else {
+            child = spawn(cmd, args, {
+                cwd,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env,
+                detached: process.platform !== 'win32',
+            });
+        }
         reviewState.child = child;
         activeSpecReviewProcesses.set(specReviewRunId, reviewState);
+        if (reviewState.stopRequested) {
+            interruptProcess(reviewState, 'SIGTERM');
+        }
         if (tool === 'claude') {
             writeClaudeStdin(child, buildClaudeStdinMessage(appendClaudeHeadlessPlanPrompt(prompt), files, cwd));
         }
@@ -3272,7 +3208,7 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
                     });
                     return;
                 }
-                const modelError = isModelResolutionError(finalLog);
+                const modelError = isLegacyModelResolutionError(errOutput);
                 if (code === 0 && !modelError) {
                     updateSpecReviewRunStreaming(specReviewRunId, finalResponse || null);
                     subagentTracker.finalize('done', finalLog || null, finalResponse || null);
@@ -3326,6 +3262,7 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
                 const parsed = parseOpencodeJsonLine(line, cwd);
                 const { logFragment, responseFragment, subagentEvents, providerSessionId } = parsed;
                 opencodeSubagentMonitor?.setParentSessionId(providerSessionId);
+                opencodeSessionId = providerSessionId ?? opencodeSessionId;
                 subagentTracker.handle(subagentEvents);
                 if (appendOpencodeTranscriptLine({ parsed, logLines, responseLines, recoveryTracker })) {
                     firstFinalAnswerTime = null;
@@ -3343,6 +3280,7 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
                 usageSnapshot = mergeUsageFromJsonLine(usageSnapshot, remainder);
                 const parsed = parseOpencodeJsonLine(remainder, cwd);
                 opencodeSubagentMonitor?.setParentSessionId(parsed.providerSessionId);
+                opencodeSessionId = parsed.providerSessionId ?? opencodeSessionId;
                 subagentTracker.handle(parsed.subagentEvents);
                 if (appendOpencodeTranscriptLine({ parsed, logLines, responseLines, recoveryTracker })) {
                     firstFinalAnswerTime = null;
@@ -3354,6 +3292,13 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
             const finalResponse = recoveryTracker.hasRecoveredFinalAnswer()
                 ? recoveredResponse
                 : responseLines.join('\n\n') || stderrOutput;
+            if (opencodeSessionId && spawnTimestamp !== null) {
+                usageSnapshot = resolveOpencodeUsageSnapshot({
+                    current: usageSnapshot,
+                    sessionId: opencodeSessionId,
+                    spawnTimestamp,
+                });
+            }
             if (reviewState.stopRequested) {
                 updateSpecReviewRunStreaming(specReviewRunId, finalResponse || null);
                 subagentTracker.finalize('stopped', log || null, finalResponse || null);
@@ -3365,8 +3310,8 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
                 });
                 return;
             }
-            const modelError = isModelResolutionError(log);
-            if (isSuccessfulOpencodeExit(code, modelError, recoveryTracker)) {
+            const stderrModelError = parseOpencodeStderrModelResolutionError(stderrOutput);
+            if (isSuccessfulOpencodeExit(code, stderrModelError, recoveryTracker)) {
                 updateSpecReviewRunStreaming(specReviewRunId, finalResponse || null);
                 subagentTracker.finalize('done', log || null, finalResponse || null);
                 resolveOnce({
@@ -3378,12 +3323,30 @@ export const runSpecReviewAgent = ({ specReviewRunId, specSessionId, tool, promp
                 return;
             }
             subagentTracker.finalize('error', log || null, finalResponse || null);
-            rejectOnce(new Error(`Agent exited with code ${code ?? 'null'}\n${log}${stderrOutput !== log && stderrOutput ? '\n\n' + stderrOutput : ''}`));
+            const failureMessage = `Agent exited with code ${code ?? 'null'}\n${log}${stderrOutput !== log && stderrOutput ? '\n\n' + stderrOutput : ''}`;
+            rejectOnce(createOpencodeExitError(failureMessage, stderrModelError, recoveryTracker));
         });
         child.on('error', err => {
             progressUpdater.cancel();
-            subagentTracker.finalize(reviewState.stopRequested ? 'stopped' : 'error', getErrorMessage(err), null);
-            rejectOnce(err instanceof Error ? err : new Error(getErrorMessage(err)));
+            if (reviewState.stopRequested) {
+                const processError = getErrorMessage(err);
+                const finalLog = logLines.join('\n\n') || processError;
+                const finalResponse = recoveryTracker.hasRecoveredFinalAnswer()
+                    ? recoveryTracker.getRecoveredResponse()
+                    : responseLines.join('\n\n') || null;
+                updateSpecReviewRunStreaming(specReviewRunId, finalResponse);
+                subagentTracker.finalize('stopped', finalLog || null, finalResponse);
+                resolveOnce({
+                    completionStatus: 'stopped',
+                    finalResponse,
+                    usageSnapshot,
+                    responseTiming: buildResponseTiming({ startTime, firstFinalAnswerTime, isStopped: true }),
+                });
+                return;
+            }
+            const failure = opencodeAgentProvider.classifyExecutionFailure(err);
+            subagentTracker.finalize('error', failure.message, null);
+            rejectOnce(failure);
         });
     });
 };