@steipete/oracle 0.9.0 → 0.10.0

package/dist/src/cli/sessionDisplay.js

@@ -1,13 +1,13 @@
-import chalk from 'chalk';
-import kleur from 'kleur';
-import { renderMarkdownAnsi } from './markdownRenderer.js';
-import { formatFinishLine } from '../oracle/finishLine.js';
-import { sessionStore, wait } from '../sessionStore.js';
-import { formatTokenCount, formatTokenValue } from '../oracle/runUtils.js';
-import { resumeBrowserSession } from '../browser/reattach.js';
-import { estimateTokenCount } from '../browser/utils.js';
-import { formatSessionTableHeader, formatSessionTableRow, resolveSessionCost } from './sessionTable.js';
-import { abbreviateResponseId, buildResponseOwnerIndex, resolveSessionLineage, } from './sessionLineage.js';
+import chalk from "chalk";
+import kleur from "kleur";
+import { renderMarkdownAnsi } from "./markdownRenderer.js";
+import { formatFinishLine } from "../oracle/finishLine.js";
+import { sessionStore, wait } from "../sessionStore.js";
+import { formatTokenCount, formatTokenValue } from "../oracle/runUtils.js";
+import { resumeBrowserSession } from "../browser/reattach.js";
+import { estimateTokenCount } from "../browser/utils.js";
+import { formatSessionTableHeader, formatSessionTableRow, resolveSessionCost, } from "./sessionTable.js";
+import { abbreviateResponseId, buildResponseOwnerIndex, resolveSessionLineage, } from "./sessionLineage.js";
 const isTty = () => Boolean(process.stdout.isTTY);
 const dim = (text) => (isTty() ? kleur.dim(text) : text);
 export const MAX_RENDER_BYTES = 200_000;
@@ -20,10 +20,10 @@ function isProcessAlive(pid) {
     }
     catch (error) {
         const code = error instanceof Error ? error.code : undefined;
-        if (code === 'ESRCH' || code === 'EINVAL') {
+        if (code === "ESRCH" || code === "EINVAL") {
             return false;
         }
-        if (code === 'EPERM') {
+        if (code === "EPERM") {
             return true;
         }
         return true;
@@ -32,8 +32,14 @@ function isProcessAlive(pid) {
 const CLEANUP_TIP = 'Tip: Run "oracle session --clear --hours 24" to prune cached runs (add --all to wipe everything).';
 export async function showStatus({ hours, includeAll, limit, showExamples = false, modelFilter, }) {
     const metas = await sessionStore.listSessions();
-    const { entries, truncated, total } = sessionStore.filterSessions(metas, { hours, includeAll, limit });
-    const filteredEntries = modelFilter ? entries.filter((entry) => matchesModel(entry, modelFilter)) : entries;
+    const { entries, truncated, total } = sessionStore.filterSessions(metas, {
+        hours,
+        includeAll,
+        limit,
+    });
+    const filteredEntries = modelFilter
+        ? entries.filter((entry) => matchesModel(entry, modelFilter))
+        : entries;
     const richTty = process.stdout.isTTY && chalk.level > 0;
     const responseOwners = buildResponseOwnerIndex(metas);
     if (!filteredEntries.length) {
@@ -43,7 +49,7 @@ export async function showStatus({ hours, includeAll, limit, showExamples = fals
         }
         return;
     }
-    console.log(chalk.bold('Recent Sessions'));
+    console.log(chalk.bold("Recent Sessions"));
     console.log(formatSessionTableHeader(richTty));
     const treeRows = buildStatusTreeRows(filteredEntries, responseOwners);
     for (const row of treeRows) {
@@ -52,7 +58,7 @@ export async function showStatus({ hours, includeAll, limit, showExamples = fals
             ? richTty
                 ? chalk.gray(` <- ${row.detachedParentLabel}`)
                 : ` <- ${row.detachedParentLabel}`
-            : '';
+            : "";
         console.log(`${line}${detachedParent}`);
     }
     if (truncated) {
@@ -70,7 +76,7 @@ export async function attachSession(sessionId, options) {
         process.exitCode = 1;
         return;
     }
-    if (metadata.mode === 'browser' && metadata.status === 'running' && !metadata.browser?.runtime) {
+    if (metadata.mode === "browser" && metadata.status === "running" && !metadata.browser?.runtime) {
         await wait(250);
         const refreshed = await sessionStore.readSession(sessionId);
         if (refreshed) {
@@ -92,16 +98,16 @@ export async function attachSession(sessionId, options) {
     const isVerbose = Boolean(process.env.ORACLE_VERBOSE_RENDER);
     const runtime = metadata.browser?.runtime;
     const controllerAlive = isProcessAlive(runtime?.controllerPid);
-    const hasChromeDisconnect = metadata.response?.incompleteReason === 'chrome-disconnected';
-    const statusAllowsReattach = metadata.status === 'running' || (metadata.status === 'error' && hasChromeDisconnect);
+    const hasChromeDisconnect = metadata.response?.incompleteReason === "chrome-disconnected";
+    const statusAllowsReattach = metadata.status === "running" || (metadata.status === "error" && hasChromeDisconnect);
     const hasFallbackSessionInfo = Boolean(runtime?.chromePort || runtime?.tabUrl || runtime?.conversationId);
     const canReattach = statusAllowsReattach &&
-        metadata.mode === 'browser' &&
+        metadata.mode === "browser" &&
         hasFallbackSessionInfo &&
         (hasChromeDisconnect || (runtime?.controllerPid && !controllerAlive));
     if (canReattach) {
-        const portInfo = runtime?.chromePort ? `port ${runtime.chromePort}` : 'unknown port';
-        const urlInfo = runtime?.tabUrl ? `url=${runtime.tabUrl}` : 'url=unknown';
+        const portInfo = runtime?.chromePort ? `port ${runtime.chromePort}` : "unknown port";
+        const urlInfo = runtime?.tabUrl ? `url=${runtime.tabUrl}` : "url=unknown";
         console.log(chalk.yellow(`Attempting to reattach to the existing Chrome session (${portInfo}, ${urlInfo})...`));
         try {
             const result = await resumeBrowserSession(runtime, metadata.browser?.config, Object.assign(((message) => {
@@ -111,13 +117,13 @@ export async function attachSession(sessionId, options) {
             }), { verbose: true }), { promptPreview: metadata.promptPreview });
             const outputTokens = estimateTokenCount(result.answerMarkdown);
             const logWriter = sessionStore.createLogWriter(sessionId);
-            logWriter.logLine('[reattach] captured assistant response from existing Chrome tab');
-            logWriter.logLine('Answer:');
+            logWriter.logLine("[reattach] captured assistant response from existing Chrome tab");
+            logWriter.logLine("Answer:");
             logWriter.logLine(result.answerMarkdown || result.answerText);
             logWriter.stream.end();
             if (metadata.model) {
                 await sessionStore.updateModelRun(metadata.id, metadata.model, {
-                    status: 'completed',
+                    status: "completed",
                     usage: {
                         inputTokens: 0,
                         outputTokens,
@@ -128,7 +134,7 @@ export async function attachSession(sessionId, options) {
                 });
             }
             await sessionStore.updateSession(sessionId, {
-                status: 'completed',
+                status: "completed",
                 completedAt: new Date().toISOString(),
                 usage: {
                     inputTokens: 0,
@@ -140,11 +146,11 @@ export async function attachSession(sessionId, options) {
                     config: metadata.browser?.config,
                     runtime,
                 },
-                response: { status: 'completed' },
+                response: { status: "completed" },
                 error: undefined,
                 transport: undefined,
             });
-            console.log(chalk.green('Reattach succeeded; session marked completed.'));
+            console.log(chalk.green("Reattach succeeded; session marked completed."));
             metadata = (await sessionStore.readSession(sessionId)) ?? metadata;
         }
         catch (error) {
@@ -164,11 +170,11 @@ export async function attachSession(sessionId, options) {
         console.log(`Created: ${metadata.createdAt}`);
         console.log(`Status: ${metadata.status}`);
         if (metadata.models && metadata.models.length > 0) {
-            console.log('Models:');
+            console.log("Models:");
             for (const run of metadata.models) {
                 const usage = run.usage
                     ? ` tok=${formatTokenCount(run.usage.outputTokens ?? 0)}/${formatTokenCount(run.usage.totalTokens ?? 0)}`
-                    : '';
+                    : "";
                 console.log(`- ${chalk.cyan(run.model)} — ${run.status}${usage}`);
             }
         }
@@ -188,19 +194,19 @@ export async function attachSession(sessionId, options) {
             console.log(dim(`User error: ${userErrorSummary}`));
         }
     }
-    const shouldTrimIntro = initialStatus === 'completed' || initialStatus === 'error';
+    const shouldTrimIntro = initialStatus === "completed" || initialStatus === "error";
     if (options?.renderPrompt !== false) {
         const prompt = await readStoredPrompt(sessionId);
         if (prompt) {
-            console.log(chalk.bold('Prompt:'));
+            console.log(chalk.bold("Prompt:"));
             console.log(renderMarkdownAnsi(prompt));
-            console.log(dim('---'));
+            console.log(dim("---"));
         }
     }
     if (shouldTrimIntro) {
         const fullLog = await buildSessionLogForDisplay(sessionId, metadata, normalizedModelFilter);
         const trimmed = trimBeforeFirstAnswer(fullLog);
-        const size = Buffer.byteLength(trimmed, 'utf8');
+        const size = Buffer.byteLength(trimmed, "utf8");
         const canRender = wantsRender && isTty() && size <= MAX_RENDER_BYTES;
         if (wantsRender && size > MAX_RENDER_BYTES) {
             const msg = `Render skipped (log too large: ${size} bytes > ${MAX_RENDER_BYTES}). Showing raw text.`;
@@ -210,7 +216,7 @@ export async function attachSession(sessionId, options) {
             }
         }
         else if (wantsRender && !isTty()) {
-            const msg = 'Render requested but stdout is not a TTY; showing raw text.';
+            const msg = "Render requested but stdout is not a TTY; showing raw text.";
             console.log(dim(msg));
             if (isVerbose) {
                 console.log(dim(`Verbose: renderMarkdown=true tty=${isTty()} size=${size}`));
@@ -232,13 +238,20 @@ export async function attachSession(sessionId, options) {
         return;
     }
     if (wantsRender) {
-        console.log(dim('Render will apply after completion; streaming raw text meanwhile...'));
+        console.log(dim("Render will apply after completion; streaming raw text meanwhile..."));
         if (isVerbose) {
             console.log(dim(`Verbose: streaming phase renderMarkdown=true tty=${isTty()}`));
         }
     }
     const liveRenderState = wantsRender && isTty()
-        ? { pending: '', inFence: false, inTable: false, renderedBytes: 0, fallback: false, noticedFallback: false }
+        ? {
+            pending: "",
+            inFence: false,
+            inTable: false,
+            renderedBytes: 0,
+            fallback: false,
+            noticedFallback: false,
+        }
         : null;
     let lastLength = 0;
     const renderLiveChunk = (chunk) => {
@@ -254,7 +267,7 @@ export async function attachSession(sessionId, options) {
         const { chunks, remainder } = extractRenderableChunks(liveRenderState.pending, liveRenderState);
         liveRenderState.pending = remainder;
         for (const candidate of chunks) {
-            const projected = liveRenderState.renderedBytes + Buffer.byteLength(candidate, 'utf8');
+            const projected = liveRenderState.renderedBytes + Buffer.byteLength(candidate, "utf8");
             if (projected > MAX_RENDER_BYTES) {
                 if (!liveRenderState.noticedFallback) {
                     console.log(dim(`Render skipped (log too large: > ${MAX_RENDER_BYTES} bytes). Showing raw text.`));
@@ -262,11 +275,11 @@ export async function attachSession(sessionId, options) {
                 }
                 liveRenderState.fallback = true;
                 process.stdout.write(candidate + liveRenderState.pending);
-                liveRenderState.pending = '';
+                liveRenderState.pending = "";
                 return;
             }
             process.stdout.write(renderMarkdownAnsi(candidate));
-            liveRenderState.renderedBytes += Buffer.byteLength(candidate, 'utf8');
+            liveRenderState.renderedBytes += Buffer.byteLength(candidate, "utf8");
         }
     };
     const flushRemainder = () => {
@@ -277,8 +290,8 @@ export async function attachSession(sessionId, options) {
             return;
         }
         const text = liveRenderState.pending;
-        liveRenderState.pending = '';
-        const projected = liveRenderState.renderedBytes + Buffer.byteLength(text, 'utf8');
+        liveRenderState.pending = "";
+        const projected = liveRenderState.renderedBytes + Buffer.byteLength(text, "utf8");
         if (projected > MAX_RENDER_BYTES) {
             if (!liveRenderState.noticedFallback) {
                 console.log(dim(`Render skipped (log too large: > ${MAX_RENDER_BYTES} bytes). Showing raw text.`));
@@ -304,15 +317,15 @@ export async function attachSession(sessionId, options) {
         if (!latest) {
             break;
         }
-        if (latest.status === 'completed' || latest.status === 'error') {
+        if (latest.status === "completed" || latest.status === "error") {
             await printNew();
             flushRemainder();
             if (!options?.suppressMetadata) {
-                if (latest.status === 'error' && latest.errorMessage) {
-                    console.log('\nResult:');
+                if (latest.status === "error" && latest.errorMessage) {
+                    console.log("\nResult:");
                     console.log(`Session failed: ${latest.errorMessage}`);
                 }
-                if (latest.status === 'completed' && latest.usage) {
+                if (latest.status === "completed" && latest.usage) {
                     const summary = formatCompletionSummary(latest, { includeSlug: true });
                     if (summary) {
                         console.log(`\n${chalk.green.bold(summary)}`);
@@ -346,19 +359,19 @@ export function formatResponseMetadata(metadata) {
     if (metadata.incompleteReason) {
         parts.push(`incomplete=${metadata.incompleteReason}`);
     }
-    return parts.length > 0 ? parts.join(' | ') : null;
+    return parts.length > 0 ? parts.join(" | ") : null;
 }
 export function formatTransportMetadata(metadata) {
     if (!metadata?.reason) {
         return null;
     }
     const reasonLabels = {
-        'client-timeout': 'client timeout (deadline exceeded)',
-        'connection-lost': 'connection lost before completion',
-        'client-abort': 'request aborted locally',
-        unknown: 'unknown transport failure',
+        "client-timeout": "client timeout (deadline exceeded)",
+        "connection-lost": "connection lost before completion",
+        "client-abort": "request aborted locally",
+        unknown: "unknown transport failure",
     };
-    const label = reasonLabels[metadata.reason] ?? 'transport error';
+    const label = reasonLabels[metadata.reason] ?? "transport error";
     return `${metadata.reason} — ${label}`;
 }
 export function formatUserErrorMetadata(metadata) {
@@ -375,7 +388,7 @@ export function formatUserErrorMetadata(metadata) {
     if (metadata.details && Object.keys(metadata.details).length > 0) {
         parts.push(`details=${JSON.stringify(metadata.details)}`);
     }
-    return parts.length > 0 ? parts.join(' | ') : null;
+    return parts.length > 0 ? parts.join(" | ") : null;
 }
 export function buildReattachLine(metadata) {
     if (!metadata.id) {
@@ -389,13 +402,13 @@ export function buildReattachLine(metadata) {
     if (!elapsedLabel) {
         return null;
     }
-    if (metadata.status === 'running') {
+    if (metadata.status === "running") {
         return `Session ${metadata.id} reattached, request started ${elapsedLabel} ago.`;
     }
     return null;
 }
 export function trimBeforeFirstAnswer(logText) {
-    const marker = 'Answer:';
+    const marker = "Answer:";
     const index = logText.indexOf(marker);
     if (index === -1) {
         return logText;
@@ -427,7 +440,7 @@ function formatRelativeDuration(referenceIso) {
         if (remainingMinutes > 0) {
             parts.push(`${remainingMinutes}m`);
         }
-        return parts.join(' ');
+        return parts.join(" ");
     }
     const days = Math.floor(hours / 24);
     const remainingHours = hours % 24;
@@ -438,17 +451,17 @@ function formatRelativeDuration(referenceIso) {
     if (remainingMinutes > 0 && days === 0) {
         parts.push(`${remainingMinutes}m`);
     }
-    return parts.join(' ');
+    return parts.join(" ");
 }
 function printStatusExamples() {
-    console.log('');
-    console.log(chalk.bold('Usage Examples'));
-    console.log(`${chalk.bold('  oracle status --hours 72 --limit 50')}`);
-    console.log(dim('    Show 72h of history capped at 50 entries.'));
-    console.log(`${chalk.bold('  oracle status --clear --hours 168')}`);
-    console.log(dim('    Delete sessions older than 7 days (use --all to wipe everything).'));
-    console.log(`${chalk.bold('  oracle session <session-id>')}`);
-    console.log(dim('    Attach to a specific running/completed session to stream its output.'));
+    console.log("");
+    console.log(chalk.bold("Usage Examples"));
+    console.log(`${chalk.bold("  oracle status --hours 72 --limit 50")}`);
+    console.log(dim("    Show 72h of history capped at 50 entries."));
+    console.log(`${chalk.bold("  oracle status --clear --hours 168")}`);
+    console.log(dim("    Delete sessions older than 7 days (use --all to wipe everything)."));
+    console.log(`${chalk.bold("  oracle session <session-id>")}`);
+    console.log(dim("    Attach to a specific running/completed session to stream its output."));
     console.log(dim(CLEANUP_TIP));
 }
 function matchesModel(entry, filter) {
@@ -456,7 +469,8 @@ function matchesModel(entry, filter) {
     if (!normalized) {
         return true;
     }
-    const models = entry.models?.map((model) => model.model.toLowerCase()) ?? (entry.model ? [entry.model.toLowerCase()] : []);
+    const models = entry.models?.map((model) => model.model.toLowerCase()) ??
+        (entry.model ? [entry.model.toLowerCase()] : []);
     return models.includes(normalized);
 }
 function buildStatusTreeRows(entries, responseOwners) {
@@ -485,8 +499,8 @@ function buildStatusTreeRows(entries, responseOwners) {
         }
         visited.add(entry.id);
         const children = childMap.get(entry.id) ?? [];
-        const nodeBranch = isLast ? '└─ ' : '├─ ';
-        const prefix = `${ancestorHasMore.map((hasMore) => (hasMore ? '│  ' : '   ')).join('')}${nodeBranch}`;
+        const nodeBranch = isLast ? "└─ " : "├─ ";
+        const prefix = `${ancestorHasMore.map((hasMore) => (hasMore ? "│  " : "   ")).join("")}${nodeBranch}`;
         rows.push({ entry, displaySlug: `${prefix}${entry.id}` });
         children.forEach((child, index) => {
             walkChild(child, [...ancestorHasMore, !isLast], index === children.length - 1);
@@ -549,12 +563,12 @@ async function buildSessionLogForDisplay(sessionId, fallbackMeta, modelFilter) {
         ? models.filter((model) => model.model.toLowerCase() === normalizedFilter)
         : models;
     if (candidates.length === 0) {
-        return '';
+        return "";
     }
     const sections = [];
     let hasContent = false;
     for (const model of candidates) {
-        const body = (await sessionStore.readModelLog(sessionId, model.model)) ?? '';
+        const body = (await sessionStore.readModelLog(sessionId, model.model)) ?? "";
         if (body.trim().length > 0) {
             hasContent = true;
         }
@@ -564,18 +578,18 @@ async function buildSessionLogForDisplay(sessionId, fallbackMeta, modelFilter) {
         // Fallback for runs that recorded output only in the session log (e.g., browser runs without per-model logs).
         return await sessionStore.readLog(sessionId);
     }
-    return sections.join('\n\n');
+    return sections.join("\n\n");
 }
 function extractRenderableChunks(text, state) {
     const chunks = [];
-    let buffer = '';
+    let buffer = "";
     const lines = text.split(/(\n)/);
     for (let i = 0; i < lines.length; i += 1) {
         const segment = lines[i];
-        if (segment === '\n') {
+        if (segment === "\n") {
             buffer += segment;
             // Detect code fences
-            const prev = lines[i - 1] ?? '';
+            const prev = lines[i - 1] ?? "";
             const fenceMatch = prev.match(/^(\s*)(`{3,}|~{3,})(.*)$/);
             if (!state.inFence && fenceMatch) {
                 state.inFence = true;
@@ -587,17 +601,17 @@ function extractRenderableChunks(text, state) {
             }
             const trimmed = prev.trim();
             if (!state.inFence) {
-                if (!state.inTable && trimmed.startsWith('|') && trimmed.includes('|')) {
+                if (!state.inTable && trimmed.startsWith("|") && trimmed.includes("|")) {
                     state.inTable = true;
                 }
-                if (state.inTable && trimmed === '') {
+                if (state.inTable && trimmed === "") {
                     state.inTable = false;
                 }
             }
-            const safeBreak = !state.inFence && !state.inTable && trimmed === '';
+            const safeBreak = !state.inFence && !state.inTable && trimmed === "";
             if (safeBreak) {
                 chunks.push(buffer);
-                buffer = '';
+                buffer = "";
             }
             continue;
         }
@@ -609,7 +623,7 @@ export function formatCompletionSummary(metadata, options = {}) {
     if (!metadata.usage || metadata.elapsedMs == null) {
         return null;
     }
-    const modeLabel = metadata.mode === 'browser' ? `${metadata.model ?? 'n/a'}[browser]` : metadata.model ?? 'n/a';
+    const modeLabel = metadata.mode === "browser" ? `${metadata.model ?? "n/a"}[browser]` : (metadata.model ?? "n/a");
     const usage = metadata.usage;
     const cost = resolveSessionCost(metadata);
     const tokensDisplay = [
@@ -624,9 +638,9 @@ export function formatCompletionSummary(metadata, options = {}) {
         reasoning_tokens: usage.reasoningTokens,
         total_tokens: usage.totalTokens,
     }, index))
-        .join('/');
+        .join("/");
     const tokensPart = (() => {
-        const parts = tokensDisplay.split('/');
+        const parts = tokensDisplay.split("/");
         if (parts.length !== 4)
             return tokensDisplay;
         return `↑${parts[0]} ↓${parts[1]} ↻${parts[2]} Δ${parts[3]}`;

package/dist/src/cli/sessionLineage.js

@@ -1,8 +1,12 @@
 function readResponseId(record) {
     if (!record)
         return null;
-    const candidate = typeof record.responseId === 'string' ? record.responseId : typeof record.id === 'string' ? record.id : null;
-    if (!candidate || !candidate.startsWith('resp_')) {
+    const candidate = typeof record.responseId === "string"
+        ? record.responseId
+        : typeof record.id === "string"
+            ? record.id
+            : null;
+    if (!candidate || !candidate.startsWith("resp_")) {
         return null;
     }
     return candidate;