cli-jaw 2.17.72 → 2.17.73

package/dist/src/agent/aside-replay.js

@@ -0,0 +1,120 @@
+import { createHash } from 'node:crypto';
+import { ASIDE_HISTORY_LIMIT, ASIDE_REPL_BYTES, AsideTransportError } from './aside-cli.js';
+function malformed() { throw new AsideTransportError('invalid_replay'); }
+function record(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return malformed();
+    return value;
+}
+function string(value) { if (typeof value !== 'string')
+    return malformed(); return value; }
+function contentText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === undefined || value === null)
+        return null;
+    if (!Array.isArray(value) || value.length > 512)
+        return malformed();
+    const texts = [];
+    for (const block of value) {
+        const row = record(block);
+        if (row['type'] === 'text')
+            texts.push(string(row['text']));
+    }
+    return texts.length ? texts.join('') : null;
+}
+/** Parse once at the structured process boundary. Preserve storage order, never timestamps. */
+export function parseAsideReplay(value, sessionId) {
+    if (Buffer.byteLength(JSON.stringify(value) ?? '') > ASIDE_REPL_BYTES)
+        throw new AsideTransportError('replay_limit');
+    const root = record(value), session = record(root['session']), before = record(root['before']);
+    if (session['id'] !== sessionId || before['id'] !== sessionId || session['status'] !== before['status']
+        || root['order'] !== 'desc' || root['limit'] !== ASIDE_HISTORY_LIMIT || root['truncated'] === true)
+        return malformed();
+    const status = string(session['status']);
+    const raw = root['messages'];
+    if (!Array.isArray(raw) || raw.length > ASIDE_HISTORY_LIMIT)
+        return malformed();
+    const messages = [...raw].reverse().map(value => {
+        const row = record(value), role = string(row['role']);
+        const message = { role, text: contentText(row['content']), receipt: createHash('sha256').update(JSON.stringify(row)).digest('hex') };
+        if (role === 'turn-lifecycle') {
+            message.event = string(row['event']);
+            message.turnId = string(row['turnId']);
+            if (!message.turnId || message.turnId.length > 128 || !['started', 'finished', 'aborted', 'error'].includes(message.event))
+                return malformed();
+        }
+        if (row['stopReason'] !== undefined)
+            message.stopReason = string(row['stopReason']);
+        if (row['completedAt'] !== undefined) {
+            if (typeof row['completedAt'] !== 'number' || !Number.isFinite(row['completedAt']) || row['completedAt'] <= 0)
+                return malformed();
+            message.completedAt = row['completedAt'];
+        }
+        return Object.freeze(message);
+    });
+    return Object.freeze({ sessionId, status, messages: Object.freeze(messages), full: raw.length < ASIDE_HISTORY_LIMIT });
+}
+export function captureAsideBaseline(replay) {
+    if (!replay)
+        return Object.freeze({ sessionId: null, anchor: null, turnIds: Object.freeze([]) });
+    const last = replay.messages.at(-1);
+    if (replay.status !== 'idle' || (last && (last.role !== 'turn-lifecycle' || last.event !== 'finished'))
+        || (!last && !replay.full))
+        throw new AsideTransportError('resume_not_idle');
+    return Object.freeze({ sessionId: replay.sessionId, anchor: last?.receipt ?? null,
+        turnIds: Object.freeze(replay.messages.filter(m => m.role === 'turn-lifecycle').map(m => m.turnId)) });
+}
+function newMessages(replay, baseline) {
+    if (baseline.sessionId !== null && baseline.sessionId !== replay.sessionId)
+        throw new AsideTransportError('replay_owner_mismatch');
+    if (baseline.anchor === null) {
+        if (!replay.full)
+            throw new AsideTransportError('replay_truncated');
+        return replay.messages;
+    }
+    const matches = replay.messages.map((m, i) => m.receipt === baseline.anchor ? i : -1).filter(i => i >= 0);
+    if (matches.length !== 1)
+        throw new AsideTransportError('baseline_missing');
+    return replay.messages.slice(matches[0] + 1);
+}
+export function inspectAsideInterval(replay, baseline, capturedTurnId) {
+    const messages = newMessages(replay, baseline);
+    const lifecycle = messages.filter(m => m.role === 'turn-lifecycle');
+    const starts = lifecycle.filter(m => m.event === 'started');
+    if (starts.length !== 1 || !starts[0]?.turnId || baseline.turnIds.includes(starts[0].turnId)
+        || (capturedTurnId !== undefined && capturedTurnId !== starts[0].turnId))
+        throw new AsideTransportError('ambiguous_turn');
+    const start = starts[0], turnId = start.turnId;
+    const startIndex = messages.indexOf(start);
+    // System metadata may precede creation; user/assistant/tool rows cannot precede the owned start.
+    if (messages.slice(0, startIndex).some(m => m.role !== 'system-message'))
+        throw new AsideTransportError('unowned_messages');
+    const terminals = lifecycle.filter(m => m.event !== 'started');
+    if (terminals.length > 1 || terminals.some(m => m.turnId !== turnId))
+        throw new AsideTransportError('ambiguous_terminal');
+    const terminal = terminals[0];
+    const body = messages.slice(startIndex + 1, terminal ? messages.indexOf(terminal) : undefined);
+    if (body.filter(m => m.role === 'user').length !== 1)
+        throw new AsideTransportError('ambiguous_input');
+    if (terminal && messages.at(-1) !== terminal)
+        throw new AsideTransportError('trailing_messages');
+    if (!terminal) {
+        return { turnId, outcome: null, interrupted: replay.status === 'interrupted' };
+    }
+    if (body.some(m => m.role === 'error' || m.stopReason === 'error')) {
+        return { turnId, outcome: { status: 'error', finalText: null, partialText: '' }, interrupted: false };
+    }
+    if (terminal.event === 'aborted')
+        return { turnId, outcome: { status: 'stopped', finalText: null, partialText: '' }, interrupted: false };
+    if (terminal.event === 'error')
+        return { turnId, outcome: { status: 'error', finalText: null, partialText: '' }, interrupted: false };
+    const finals = body.filter(m => m.role === 'assistant' && m.stopReason === 'stop');
+    const final = finals[0];
+    if (replay.status !== 'idle' || finals.length !== 1 || !final || final.text === null || final.completedAt === undefined
+        || body.at(-1) !== final || body.some(m => m.stopReason === 'aborted' || m.stopReason === 'length')) {
+        throw new AsideTransportError('incomplete_final');
+    }
+    return { turnId, outcome: { status: 'done', finalText: final.text, partialText: '' }, interrupted: false };
+}
+//# sourceMappingURL=aside-replay.js.map

package/dist/src/agent/aside-replay.js.map

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

package/dist/src/agent/aside-runtime.js

@@ -0,0 +1,175 @@
+import { ASIDE_CLOSE_TIMEOUT_MS, ASIDE_KILL_TIMEOUT_MS, ASIDE_PROBE_TIMEOUT_MS, AsideTransportError, asideWithin, buildAsideRunArgs, buildAsideStopArgs, closeAsideCommand, createAsideHeaderReader, launchAsideCommand, observeAsideCallback, readAsideSession, safeAsideDiagnostic, } from './aside-cli.js';
+import { captureAsideBaseline, inspectAsideInterval, parseAsideReplay } from './aside-replay.js';
+export const ASIDE_TURN_TIMEOUT_MS = 10 * 60 * 1000;
+const INTERRUPTED = 'Aside session interruption verified and local CLI closed. External tool physical completion is not proved; session cannot be reused.';
+const UNCERTAIN = 'Aside cancellation is unresolved. Session cannot be reused; external tool physical completion is not proved.';
+const CLOSE_UNCERTAIN = 'Aside local CLI closure is unconfirmed. Session cannot be reused.';
+/** All dependencies are captured per owner; production has no test-mode switches. */
+export function createAsideRuntime(dependencies = {}) {
+    const deps = { ...dependencies };
+    return function start(input, callbacks = {}) {
+        // Capture selectors, process environment and observers synchronously, before any read.
+        const captured = { ...input, selection: Object.freeze({ ...input.selection }), env: { ...input.env } };
+        const observers = { ...callbacks };
+        let cancelled = false, sealed = false;
+        let wakeCancel;
+        const cancellation = new Promise(resolve => { wakeCancel = resolve; });
+        let command;
+        const commands = new Set();
+        const captureCommand = (launched) => { commands.add(launched); return launched; };
+        const commandsClosed = () => [...commands].every(capturedCommand => capturedCommand.closed);
+        let sessionId = input.sessionId ?? null;
+        let receiptSeen = false;
+        let resolveReceipt;
+        const receipt = new Promise(resolve => { resolveReceipt = resolve; });
+        const probeMs = deps.probeMs ?? ASIDE_PROBE_TIMEOUT_MS;
+        const closeMs = deps.closeMs ?? ASIDE_CLOSE_TIMEOUT_MS;
+        const killMs = deps.killMs ?? ASIDE_KILL_TIMEOUT_MS;
+        let baseline = captureAsideBaseline();
+        const read = async (id) => {
+            const value = deps.read
+                ? await asideWithin(deps.read(captured, id), probeMs)
+                : await readAsideSession(captured, captured.selection, id, { ...deps, onCommand: captureCommand });
+            if (value === undefined)
+                throw new AsideTransportError('replay_timeout');
+            return parseAsideReplay(value, id);
+        };
+        function result(status, finalText, exitCode, diagnostic, cleanup = 'confirmed') {
+            if (!commandsClosed())
+                cleanup = 'uncertain';
+            return { status, finalText, partialText: '', sessionId, reusable: status === 'done' && cleanup === 'confirmed', exitCode, cleanup,
+                ...(diagnostic ? { diagnostic } : {}) };
+        }
+        async function cleanup() {
+            await Promise.all([...commands].map(capturedCommand => closeAsideCommand(capturedCommand, closeMs, killMs)));
+            return commandsClosed();
+        }
+        async function stopOwned(status = 'stopped', failure) {
+            let verified = false, terminal = false;
+            try {
+                if (!receiptSeen && command) {
+                    await asideWithin(Promise.race([receipt, command.completion.then(() => null)]), probeMs);
+                }
+                if (receiptSeen && sessionId && command) {
+                    // Capture the only new start before issuing control. No current-session lookup.
+                    const before = await read(sessionId);
+                    const interval = inspectAsideInterval(before, baseline);
+                    if (interval.outcome === null && !interval.interrupted) {
+                        const control = captureCommand(launchAsideCommand(captured, buildAsideStopArgs(captured.selection, sessionId), { ...(deps.spawn ? { spawn: deps.spawn } : {}) }));
+                        const stopped = await asideWithin(control.completion, probeMs);
+                        if (!stopped)
+                            await closeAsideCommand(control, closeMs, killMs);
+                        if (stopped && stopped.exitCode === 0 && !stopped.failed && !stopped.overflow
+                            && safeAsideDiagnostic(stopped.stdout).trim() === 'interrupted' && !stopped.stderr.trim()) {
+                            const after = inspectAsideInterval(await read(sessionId), baseline, interval.turnId);
+                            terminal = after.outcome !== null;
+                            verified = (after.interrupted && after.outcome === null) || terminal;
+                        }
+                    }
+                    else if (interval.outcome !== null) {
+                        terminal = true;
+                        verified = true;
+                    }
+                    else if (interval.interrupted && interval.outcome === null) {
+                        // Existing exact owned interruption still needs local child closure.
+                        verified = true;
+                    }
+                }
+            }
+            catch { /* A safe unresolved diagnostic is the control result, never a guessed stop. */ }
+            const closed = await cleanup();
+            const exit = command?.closed ? (await command.completion).exitCode : null;
+            const confirmed = closed && verified;
+            const diagnostic = confirmed
+                ? terminal ? 'Aside owned terminal verified and local CLI closed; final withheld.' : INTERRUPTED
+                : `${UNCERTAIN}${closed ? '' : ` ${CLOSE_UNCERTAIN}`}`;
+            return result(status, null, exit, failure ? `${failure} ${diagnostic}` : diagnostic, confirmed ? 'confirmed' : 'uncertain');
+        }
+        async function execute() {
+            try {
+                const args = buildAsideRunArgs(captured);
+                if (captured.sessionId !== undefined) {
+                    baseline = captureAsideBaseline(await read(captured.sessionId));
+                }
+                if (cancelled)
+                    return result('stopped', null, null, 'Aside run cancelled before dispatch.');
+                const header = createAsideHeaderReader(captured.sessionId);
+                const report = (text) => {
+                    if (!cancelled && !sealed)
+                        observeAsideCallback(observers.onOutput, safeAsideDiagnostic(text));
+                };
+                command = captureCommand(launchAsideCommand(captured, args, {
+                    ...(deps.spawn ? { spawn: deps.spawn } : {}),
+                    onStdout: report,
+                    onStderr: text => {
+                        const id = header(text);
+                        if (id && !receiptSeen) {
+                            sessionId = id;
+                            receiptSeen = true;
+                            resolveReceipt(id);
+                            observeAsideCallback(observers.onSession, id);
+                        }
+                        report(text);
+                    },
+                }));
+                observeAsideCallback(observers.onChild, command.child);
+                const admitted = await asideWithin(Promise.race([
+                    receipt.then(() => 'receipt'), command.completion.then(() => 'closed'),
+                    cancellation.then(() => 'cancel'),
+                ]), probeMs);
+                if (!admitted || cancelled) {
+                    cancelled = true;
+                    return await stopOwned();
+                }
+                const completion = await asideWithin(Promise.race([
+                    command.completion.then(value => ({ kind: 'closed', value })),
+                    cancellation.then(() => ({ kind: 'cancel' })),
+                ]), deps.turnMs ?? ASIDE_TURN_TIMEOUT_MS);
+                if (cancelled || completion?.kind === 'cancel' || !completion) {
+                    cancelled = true;
+                    return await stopOwned();
+                }
+                if (!receiptSeen || !sessionId)
+                    throw new AsideTransportError('session_receipt_missing');
+                if (completion.value.failed || completion.value.overflow || completion.value.exitCode !== 0)
+                    throw new AsideTransportError('agent_transport_failed');
+                const replay = await read(sessionId);
+                if (cancelled)
+                    return await stopOwned();
+                const interval = inspectAsideInterval(replay, baseline);
+                if (!interval.outcome)
+                    throw new AsideTransportError('terminal_missing');
+                // No callbacks after authoritative selection, so observers cannot trigger re-selection.
+                sealed = true;
+                return result(interval.outcome.status, interval.outcome.finalText, completion.value.exitCode, interval.outcome.status === 'done' ? undefined : 'Aside owned turn did not complete successfully.');
+            }
+            catch (error) {
+                const diagnostic = error instanceof AsideTransportError ? error.message : 'Aside runtime boundary failed.';
+                if (command)
+                    return await stopOwned(cancelled ? 'stopped' : 'error', cancelled ? undefined : diagnostic);
+                // Baseline preparation can launch a probe even before main admission.
+                const closed = await cleanup();
+                return result(cancelled ? 'stopped' : 'error', null, null, diagnostic, closed ? 'confirmed' : 'uncertain');
+            }
+            finally {
+                sealed = true;
+            }
+        }
+        const pending = execute();
+        return {
+            result: pending,
+            commandsClosed,
+            closeCommands: cleanup,
+            cancel() {
+                // Synchronous latch precedes every await and is idempotent after terminal selection.
+                if (!sealed) {
+                    cancelled = true;
+                    wakeCancel();
+                }
+                return pending.then(() => undefined);
+            },
+        };
+    };
+}
+export const startAsideRun = createAsideRuntime();
+//# sourceMappingURL=aside-runtime.js.map

package/dist/src/agent/aside-runtime.js.map

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

package/dist/src/agent/lifecycle-handler.js

@@ -136,7 +136,7 @@ function performedSideEffects(ctx) {
  *  ended in error has already stopped waiting (observed 2026-09-28: "You've hit
  *  your session limit" ended every Claude turn while Cursor was idle). */
 export function pickNativeFallbackCli(cli, opts, toolLog) {
-    if (opts.internal || opts._isFallback)
+    if (cli === 'aside' || opts.internal || opts._isFallback)
         return null;
     if (toolLog.some(tool => !REPEATABLE_TOOL_TYPES.has(tool.toolType)))
         return null;
@@ -158,7 +158,7 @@ export function setMainMetaHandler(fn) {
  * retirement check has to run before detection.
  */
 export function isLiveFallbackCandidate(fc, currentCli, detect, coolingDown) {
-    return fc !== currentCli
+    return fc !== 'aside' && currentCli !== 'aside' && fc !== currentCli
         && !isRetiredCliSelection(fc)
         && detect(fc).available
         && !coolingDown(fc);
@@ -210,6 +210,7 @@ export async function handleAgentExit(params) {
     const nativeTraceRunId = ctx.traceRunId;
     const effectiveProvider = params.effectiveProvider;
     const runtimeCli = cli;
+    const workingDir = params.workingDir ?? settings['workingDir'];
     const effortVal = cfg.effort || effortDefault;
     // Every runtime now has a bucket of its own keyed by scope (073 §2.1), so the guard
     // 072 put here is gone: instead of refusing to touch shared state, each session
@@ -267,7 +268,7 @@ export async function handleAgentExit(params) {
         }
     };
     // ─── Smoke response auto-continuation ───
-    if (nativeOutcome === undefined
+    if (cli !== 'aside' && nativeOutcome === undefined
         && smokeResult.isSmoke
         && smokeResult.confidence !== 'low'
         && !opts._isSmokeContinuation
@@ -287,6 +288,8 @@ export async function handleAgentExit(params) {
                 sessionId: smokeSessionId, isFallback: opts._isFallback === true,
                 code, cli, model, provider: effectiveProvider, resumeKey: params.resumeKey, effort: effortVal,
                 skipSessionPersist: opts._skipSessionPersist === true,
+                ...(params.workingDir !== undefined ? { workingDir: params.workingDir } : {}),
+                ...(params.permissions !== undefined ? { permissions: params.permissions } : {}),
                 outputLen: params.outputLen,
                 ...(params.codexAppBucket ? { codexAppBucket: params.codexAppBucket } : {}),
                 runtimeTransport: params.runtimeTransport,
@@ -344,7 +347,7 @@ export async function handleAgentExit(params) {
         // One row owns a run: when a final answer also exists, that row takes it below.
         const salvageRunId = nativeOutcome.finalText === null ? nativeTraceRunId || null : null;
         const salvageContent = '⏹️ [interrupted]\n\n' + nativeOutcome.partialText;
-        const info = insertMessageWithTraceRun.run('assistant', salvageContent, cli, model, ctx.traceLog.join('\n') || null, serializeSanitizedToolLog(partialTools), settings['workingDir'] || null, salvageRunId, chatSessionId);
+        const info = insertMessageWithTraceRun.run('assistant', salvageContent, cli, model, ctx.traceLog.join('\n') || null, serializeSanitizedToolLog(partialTools), workingDir || null, salvageRunId, chatSessionId);
         const messageId = Number(info.lastInsertRowid);
         if (salvageRunId && Number.isSafeInteger(messageId) && messageId > 0) {
             try {
@@ -365,7 +368,7 @@ export async function handleAgentExit(params) {
         try {
             const { autoCompactRefresh } = await import('../core/compact.js');
             await autoCompactRefresh({
-                workDir: settings["workingDir"] || '',
+                workDir: workingDir || '',
                 instructions: prompt || '',
                 cli,
                 model,
@@ -386,6 +389,8 @@ export async function handleAgentExit(params) {
         sessionId: persistedSessionId, isFallback: opts._isFallback === true,
         code, wasKilled, cli, model, provider: effectiveProvider, resumeKey: params.resumeKey, effort: effortVal,
         skipSessionPersist: opts._skipSessionPersist === true,
+        ...(params.workingDir !== undefined ? { workingDir: params.workingDir } : {}),
+        ...(params.permissions !== undefined ? { permissions: params.permissions } : {}),
         outputLen: params.outputLen,
         ...(params.codexAppBucket ? { codexAppBucket: params.codexAppBucket } : {}),
         runtimeTransport: params.runtimeTransport,
@@ -398,7 +403,7 @@ export async function handleAgentExit(params) {
         const checkpointSeen = ctx.metadata?.['agyCheckpointSeen'] === true;
         const plannerOnly = ctx.metadata?.['agyPlannerOnly'] === true;
         const clean = code === 0 && !wasKilled && !ctx.stallReason && !plannerOnly && !checkpointSeen;
-        updateSessionBucketLastRun.run(clean ? 1 : 0, settings['workingDir'] || '', JSON.stringify({ checkpointSeen, plannerOnly, exitCode: code, at: Date.now() }), runBucket);
+        updateSessionBucketLastRun.run(clean ? 1 : 0, workingDir || '', JSON.stringify({ checkpointSeen, plannerOnly, exitCode: code, at: Date.now() }), runBucket);
     }
     // ─── Phase 54-A: Proactive compact by turn count ───
     // CLIs without a reliable native compact/resume path get a conservative
@@ -412,7 +417,7 @@ export async function handleAgentExit(params) {
                 if (getSessionBucket.get(runBucket)?.session_id === persistedSessionId) {
                     console.log(`[jaw:compact] ${cli} reached ${turns} turns — forcing auto-refresh`);
                     await autoCompactRefresh({
-                        workDir: settings["workingDir"] || '',
+                        workDir: workingDir || '',
                         instructions: prompt || '',
                         cli,
                         model,
@@ -501,7 +506,7 @@ export async function handleAgentExit(params) {
             if (!peekPendingBootstrapPrompt(scopeKey)) {
                 const { autoCompactRefresh } = await import('../core/compact.js');
                 await autoCompactRefresh({
-                    workDir: settings["workingDir"] || null, instructions: '', cli, model, scopeKey,
+                    workDir: workingDir || null, instructions: '', cli, model, scopeKey,
                     chatSessionId,
                     sessionBucket: runBucket,
                 });
@@ -582,7 +587,7 @@ export async function handleAgentExit(params) {
                 }
                 // trace_run_id is nullable TEXT, not a FK: missing journal rows
                 // cannot suppress final delivery or this history pointer.
-                const info = insertMessageWithTraceRun.run('assistant', finalContent, cli, model, ctx.traceLog.join('\n') || null, serializeSanitizedToolLog(safeTools), settings['workingDir'] || null, nativeTraceRunId || null, chatSessionId);
+                const info = insertMessageWithTraceRun.run('assistant', finalContent, cli, model, ctx.traceLog.join('\n') || null, serializeSanitizedToolLog(safeTools), workingDir || null, nativeTraceRunId || null, chatSessionId);
                 const messageId = Number(info.lastInsertRowid);
                 if (nativeTraceRunId && Number.isSafeInteger(messageId) && messageId > 0) {
                     try {
@@ -618,8 +623,11 @@ export async function handleAgentExit(params) {
             // A turn being handed to a fallback runtime is not the answer yet: its
             // diagnostic and error tag would reach the Slack forwarder as an error
             // block in the user's thread, ahead of the answer that follows.
-            const terminalText = nativeFallbackCli ? '' : compatibilityText || (nativeOutcome.status === 'error'
+            const terminalText = nativeFallbackCli ? '' : compatibilityText || ((nativeOutcome.status === 'error'
+                || (cli === 'aside' && ctx.metadata?.['asideCleanup'] === 'uncertain'))
                 && ctx.runtimeDiagnostic?.trim() ? `❌ ${ctx.runtimeDiagnostic.trim()}` : '');
+            if (cli === 'aside')
+                ctx.runtimeTerminalAttempted = true;
             broadcast('agent_done', {
                 ...donePin,
                 ...(nativeTraceRunId ? { traceRunId: nativeTraceRunId } : {}),
@@ -727,7 +735,7 @@ export async function handleAgentExit(params) {
             const liveRun = getLiveRun(liveScope);
             const sanitizedToolLog = sanitizeToolLogForDurableStorage(mergeLatestTools(ctx.toolLog, liveRun.toolLog, ctx.traceRunId || ''));
             const toolLogJson = serializeSanitizedToolLog(sanitizedToolLog);
-            const info = insertMessageWithTraceRun.run('assistant', finalContent, cli, model, traceText || null, toolLogJson, settings["workingDir"] || null, ctx.traceRunId || null, chatSessionId);
+            const info = insertMessageWithTraceRun.run('assistant', finalContent, cli, model, traceText || null, toolLogJson, workingDir || null, ctx.traceRunId || null, chatSessionId);
             const messageId = Number(info.lastInsertRowid || 0);
             if (ctx.traceRunId && Number.isInteger(messageId) && messageId > 0) {
                 try {
@@ -768,7 +776,7 @@ export async function handleAgentExit(params) {
         // channel's generic "no response" message.
         const { message: errMsg, errorKind } = classifyExitError(runtimeCli, code, ctx.stderrBuf, ctx.stallReason, `${ctx.fullText}\n${ctx.traceLog.join('\n')}`);
         if (mainManaged && !opts.internal) {
-            insertMessage.run('assistant', errMsg, cli, model, settings["workingDir"] || null, chatSessionId);
+            insertMessage.run('assistant', errMsg, cli, model, workingDir || null, chatSessionId);
         }
         broadcast('agent_done', 
         // Classified like the retry-exhausted site below: a watchdog kill is
@@ -820,7 +828,7 @@ export async function handleAgentExit(params) {
                 console.log(`[jaw:session] invalidated stale resume — ${cli}/${bucket} bucket cleared (scope ${scopeKey})`);
             }
             else {
-                updateSession.run(cli, null, model, settings["permissions"], settings["workingDir"], effortVal);
+                updateSession.run(cli, null, model, settings["permissions"], workingDir, effortVal);
                 const bucket = runBucket;
                 if (bucket)
                     clearSessionBucket.run(bucket);
@@ -862,14 +870,14 @@ export async function handleAgentExit(params) {
                     try {
                         const { autoCompactRefresh } = await import('../core/compact.js');
                         await autoCompactRefresh({
-                            workDir: settings["workingDir"] || null, instructions: '', cli, model, scopeKey,
+                            workDir: workingDir || null, instructions: '', cli, model, scopeKey,
                             chatSessionId,
                             sessionBucket: runBucket,
                         });
                     }
                     catch { }
                 }
-                insertMessage.run('assistant', `⏱️ ${errMsg}`, cli, model, settings["workingDir"] || null, chatSessionId);
+                insertMessage.run('assistant', `⏱️ ${errMsg}`, cli, model, workingDir || null, chatSessionId);
             }
             broadcast('agent_done', { ...runTag(ctx), ...donePin, text: `❌ ${errMsg}`, error: true, errorKind, cli: runtimeCli, origin, ...empTag, ...(wasSteer ? { steered: true } : {}) }, isEmployee ? 'internal' : 'public');
             finalizeRun('error', errMsg);
@@ -951,7 +959,7 @@ export async function handleAgentExit(params) {
                     if (!peekPendingBootstrapPrompt(scopeKey)) {
                         const { autoCompactRefresh } = await import('../core/compact.js');
                         await autoCompactRefresh({
-                            workDir: settings["workingDir"] || null, instructions: '', cli, model, scopeKey,
+                            workDir: workingDir || null, instructions: '', cli, model, scopeKey,
                             chatSessionId,
                             sessionBucket: runBucket,
                         });
@@ -1155,8 +1163,8 @@ export async function handleAgentExit(params) {
     // and execute it so the continuation loop stops.
     const controlText = resolvedOutcome === undefined ? ctx.fullText
         : resolvedOutcome.status === 'done' ? resolvedOutcome.finalText ?? '' : '';
-    const allowNativeContinuation = resolvedOutcome === undefined
-        || (resolvedOutcome.status === 'done' && resolvedOutcome.finalText !== null);
+    const allowNativeContinuation = cli !== 'aside' && (resolvedOutcome === undefined
+        || (resolvedOutcome.status === 'done' && resolvedOutcome.finalText !== null));
     let goalDoneRejected = false;
     if (mainManaged && !opts.internal && controlText) {
         const activeGoal = getActiveGoal();