voratiq 0.1.0-beta.21 → 0.1.0-beta.23

package/dist/render/transcripts/message.d.ts

@@ -1,9 +1,6 @@
 import type { ExtractedTokenUsage } from "../../domain/run/model/types.js";
 import type { TokenUsageResult } from "../../workspace/chat/token-usage-result.js";
-type CliWriter = Pick<NodeJS.WriteStream, "write"> & {
-    isTTY?: boolean;
-    columns?: number;
-};
+import type { CliWriter } from "../utils/cli-writer.js";
 export interface MessageProgressContext {
     messageId: string;
     createdAt: string;
@@ -44,6 +41,7 @@ export interface MessageTranscriptOptions {
     elapsed: string;
     workspacePath: string;
     status: "queued" | "running" | "succeeded" | "failed" | "aborted";
+    targetDisplay?: string;
     recipients: readonly MessageTranscriptRecipientBlock[];
     isTty?: boolean;
     includeSummarySection?: boolean;
@@ -68,5 +66,5 @@ export declare function formatMessageRecipientDuration(input: {
     startedAt?: string;
     completedAt?: string;
     now?: number;
-}): string | undefined;
+}): string;
 export {};

package/dist/render/transcripts/message.js

@@ -1,43 +1,13 @@
 import { getAgentStatusStyle, getRunStatusStyle } from "../../status/colors.js";
 import { TERMINAL_MESSAGE_STATUSES } from "../../status/index.js";
 import { formatAgentErrorLine } from "../utils/agents.js";
-import { formatRenderLifecycleDuration } from "../utils/duration.js";
+import { formatRenderLifecycleDuration, formatRenderLifecycleRowDuration, } from "../utils/duration.js";
 import { createInteractiveFrameRenderer } from "../utils/interactive-frame.js";
+import { clearRefreshIntervalHandle, formatProgressiveRenderErrorDetail, parseProgressTimestamp, } from "../utils/progressive-render.js";
 import { buildStageFrameLines, buildStageFrameSections, } from "../utils/stage-output.js";
 import { renderTranscript } from "../utils/transcript.js";
 import { buildStandardSessionShellSection, formatTranscriptStatusLabel, renderTranscriptStatusTable, resolveTranscriptShellStyle, resolveTranscriptShellStyleFromWriter, } from "../utils/transcript-shell.js";
 const DASH = "—";
-function formatErrorDetail(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    if (typeof error === "string") {
-        return error;
-    }
-    if (error === null || error === undefined) {
-        return "unknown error";
-    }
-    if (typeof error === "number" ||
-        typeof error === "boolean" ||
-        typeof error === "bigint") {
-        return `${error}`;
-    }
-    if (typeof error === "symbol") {
-        return error.description ?? error.toString();
-    }
-    if (typeof error === "object") {
-        try {
-            const serialized = JSON.stringify(error);
-            if (serialized) {
-                return serialized;
-            }
-        }
-        catch {
-            // Ignore serialization errors and fall back.
-        }
-    }
-    return "unknown error";
-}
 function buildMessageStageShell(options) {
     return {
         metadataLines: buildStandardSessionShellSection({
@@ -69,13 +39,6 @@ export function createMessageRenderer(options = {}) {
     const interactiveFrameRenderer = createInteractiveFrameRenderer(stdout);
     const recipientOrder = [];
     const recipientRecords = new Map();
-    function stopRefreshLoop() {
-        if (!refreshInterval) {
-            return;
-        }
-        clearInterval(refreshInterval);
-        refreshInterval = undefined;
-    }
     function hasRunningRecipients() {
         for (const recipient of recipientRecords.values()) {
             if (recipient.status === "running") {
@@ -86,7 +49,7 @@ export function createMessageRenderer(options = {}) {
     }
     function syncRefreshLoop() {
         if (!stdout.isTTY || disabled || !context || !hasRunningRecipients()) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             return;
         }
         if (refreshInterval) {
@@ -95,7 +58,7 @@ export function createMessageRenderer(options = {}) {
         refreshInterval = setInterval(() => {
             guard(() => {
                 if (!stdout.isTTY || disabled || !context || !hasRunningRecipients()) {
-                    stopRefreshLoop();
+                    refreshInterval = clearRefreshIntervalHandle(refreshInterval);
                     return;
                 }
                 const nextElapsed = formatMessageProgressElapsed(context, now());
@@ -116,25 +79,15 @@ export function createMessageRenderer(options = {}) {
         }
         catch (error) {
             disabled = true;
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             if (!warningLogged) {
                 warningLogged = true;
-                stderr.write(`[voratiq] Progressive message output disabled: ${formatErrorDetail(error)}\n`);
+                stderr.write(`[voratiq] Progressive message output disabled: ${formatProgressiveRenderErrorDetail(error)}\n`);
             }
         }
     }
-    function safeParse(value) {
-        if (!value) {
-            return undefined;
-        }
-        const parsed = Date.parse(value);
-        return Number.isNaN(parsed) ? undefined : parsed;
-    }
     function formatDuration(record) {
-        if (record.status === "running") {
-            return DASH;
-        }
-        return (formatRenderLifecycleDuration({
+        return formatRenderLifecycleRowDuration({
             lifecycle: {
                 status: record.status,
                 startedAt: record.startedAt,
@@ -142,21 +95,21 @@ export function createMessageRenderer(options = {}) {
             },
             terminalStatuses: TERMINAL_MESSAGE_STATUSES,
             now: now(),
-        }) ?? DASH);
+        });
     }
     function syncContextLifecycleFromRecipientRecords() {
         if (!context) {
             return;
         }
-        let earliestStartedAt = safeParse(context.startedAt);
-        let latestCompletedAt = safeParse(context.completedAt);
+        let earliestStartedAt = parseProgressTimestamp(context.startedAt);
+        let latestCompletedAt = parseProgressTimestamp(context.completedAt);
         for (const recipient of recipientRecords.values()) {
-            const startedAt = safeParse(recipient.startedAt);
+            const startedAt = parseProgressTimestamp(recipient.startedAt);
             if (startedAt !== undefined &&
                 (earliestStartedAt === undefined || startedAt < earliestStartedAt)) {
                 earliestStartedAt = startedAt;
             }
-            const completedAt = safeParse(recipient.completedAt);
+            const completedAt = parseProgressTimestamp(recipient.completedAt);
             if (completedAt !== undefined &&
                 (latestCompletedAt === undefined || completedAt > latestCompletedAt)) {
                 latestCompletedAt = completedAt;
@@ -259,7 +212,7 @@ export function createMessageRenderer(options = {}) {
             });
         },
         complete(status, lifecycle) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             guard(() => {
                 if (context && lifecycle) {
                     context = {
@@ -281,24 +234,26 @@ export function createMessageRenderer(options = {}) {
     };
 }
 export function renderMessageTranscript(options) {
-    const { recipients, isTty, includeSummarySection = true } = options;
+    const { recipients, isTty, includeSummarySection = true, targetDisplay, } = options;
     const style = { isTty };
     const resolvedStyle = resolveTranscriptShellStyle(style);
     const sections = [];
     if (includeSummarySection) {
+        const metadataLines = buildStandardSessionShellSection({
+            badgeText: options.messageId,
+            badgeVariant: "message",
+            status: {
+                value: options.status,
+                color: getRunStatusStyle(options.status).cli,
+            },
+            elapsed: options.elapsed,
+            createdAt: options.createdAt,
+            workspacePath: options.workspacePath,
+            targetDisplay,
+            style,
+        });
         const shell = {
-            metadataLines: buildStandardSessionShellSection({
-                badgeText: options.messageId,
-                badgeVariant: "message",
-                status: {
-                    value: options.status,
-                    color: getRunStatusStyle(options.status).cli,
-                },
-                elapsed: options.elapsed,
-                createdAt: options.createdAt,
-                workspacePath: options.workspacePath,
-                style,
-            }),
+            metadataLines,
             statusTableLines: recipients.length > 0
                 ? renderTranscriptStatusTable({
                     rows: recipients,
@@ -342,7 +297,7 @@ export function formatMessageElapsed(input) {
     });
 }
 export function formatMessageRecipientDuration(input) {
-    return formatRenderLifecycleDuration({
+    return formatRenderLifecycleRowDuration({
         lifecycle: {
             status: input.status,
             startedAt: input.startedAt,

package/dist/render/transcripts/reduce.d.ts

@@ -1,10 +1,7 @@
 import type { ExtractedTokenUsage } from "../../domain/run/model/types.js";
 import type { TokenUsageResult } from "../../workspace/chat/token-usage-result.js";
+import type { CliWriter } from "../utils/cli-writer.js";
 import type { StageProgressEventConsumer } from "./stage-progress.js";
-type CliWriter = Pick<NodeJS.WriteStream, "write"> & {
-    isTTY?: boolean;
-    columns?: number;
-};
 export interface ReduceProgressContext {
     reductionId: string;
     createdAt: string;
@@ -51,6 +48,7 @@ export interface ReduceTranscriptOptions {
     elapsed: string;
     workspacePath: string;
     status: "queued" | "succeeded" | "failed" | "aborted" | "running";
+    targetDisplay?: string;
     reducers: readonly ReduceTranscriptReducerBlock[];
     nextCommandLines?: readonly string[];
     suppressHint?: boolean;

package/dist/render/transcripts/reduce.js

@@ -1,57 +1,29 @@
 import { getAgentStatusStyle, getRunStatusStyle } from "../../status/colors.js";
 import { TERMINAL_REDUCTION_STATUSES } from "../../status/index.js";
 import { formatAgentErrorLine } from "../utils/agents.js";
-import { formatRenderLifecycleDuration } from "../utils/duration.js";
+import { formatRenderLifecycleDuration, formatRenderLifecycleRowDuration, } from "../utils/duration.js";
 import { createInteractiveFrameRenderer } from "../utils/interactive-frame.js";
+import { clearRefreshIntervalHandle, formatProgressiveRenderErrorDetail, parseProgressTimestamp, } from "../utils/progressive-render.js";
 import { buildStageFrameLines, buildStageFrameSections, } from "../utils/stage-output.js";
 import { renderTranscript } from "../utils/transcript.js";
 import { buildStandardSessionShellSection, formatTranscriptStatusLabel, renderTranscriptStatusTable, resolveTranscriptShellStyle, resolveTranscriptShellStyleFromWriter, } from "../utils/transcript-shell.js";
 const DASH = "—";
-function formatErrorDetail(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    if (typeof error === "string") {
-        return error;
-    }
-    if (error === null || error === undefined) {
-        return "unknown error";
-    }
-    if (typeof error === "number" ||
-        typeof error === "boolean" ||
-        typeof error === "bigint") {
-        return `${error}`;
-    }
-    if (typeof error === "symbol") {
-        return error.description ?? error.toString();
-    }
-    if (typeof error === "object") {
-        try {
-            const serialized = JSON.stringify(error);
-            if (serialized) {
-                return serialized;
-            }
-        }
-        catch {
-            // Ignore serialization errors and fall back.
-        }
-    }
-    return "unknown error";
-}
 function buildReduceStageShell(options) {
+    const metadataLines = buildStandardSessionShellSection({
+        badgeText: options.reductionId,
+        badgeVariant: "reduce",
+        status: {
+            value: options.status,
+            color: getRunStatusStyle(options.status).cli,
+        },
+        elapsed: options.elapsed,
+        createdAt: options.createdAt,
+        workspacePath: options.workspacePath,
+        targetDisplay: options.targetDisplay,
+        style: options.style,
+    });
     return {
-        metadataLines: buildStandardSessionShellSection({
-            badgeText: options.reductionId,
-            badgeVariant: "reduce",
-            status: {
-                value: options.status,
-                color: getRunStatusStyle(options.status).cli,
-            },
-            elapsed: options.elapsed,
-            createdAt: options.createdAt,
-            workspacePath: options.workspacePath,
-            style: options.style,
-        }),
+        metadataLines,
         statusTableLines: options.tableLines ?? [],
     };
 }
@@ -69,13 +41,6 @@ export function createReduceRenderer(options = {}) {
     const interactiveFrameRenderer = createInteractiveFrameRenderer(stdout);
     const reducerOrder = [];
     const reducerRecords = new Map();
-    function stopRefreshLoop() {
-        if (!refreshInterval) {
-            return;
-        }
-        clearInterval(refreshInterval);
-        refreshInterval = undefined;
-    }
     function hasRunningReducers() {
         for (const reducer of reducerRecords.values()) {
             if (reducer.status === "running") {
@@ -86,7 +51,7 @@ export function createReduceRenderer(options = {}) {
     }
     function syncRefreshLoop() {
         if (!stdout.isTTY || disabled || !context || !hasRunningReducers()) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             return;
         }
         if (refreshInterval) {
@@ -95,7 +60,7 @@ export function createReduceRenderer(options = {}) {
         refreshInterval = setInterval(() => {
             guard(() => {
                 if (!stdout.isTTY || disabled || !context || !hasRunningReducers()) {
-                    stopRefreshLoop();
+                    refreshInterval = clearRefreshIntervalHandle(refreshInterval);
                     return;
                 }
                 const nextElapsed = formatReduceProgressElapsed(context);
@@ -116,10 +81,10 @@ export function createReduceRenderer(options = {}) {
         }
         catch (error) {
             disabled = true;
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             if (!warningLogged) {
                 warningLogged = true;
-                stderr.write(`[voratiq] Progressive reduce output disabled: ${formatErrorDetail(error)}\n`);
+                stderr.write(`[voratiq] Progressive reduce output disabled: ${formatProgressiveRenderErrorDetail(error)}\n`);
             }
         }
     }
@@ -134,18 +99,8 @@ export function createReduceRenderer(options = {}) {
             now: now(),
         });
     }
-    function safeParse(value) {
-        if (!value) {
-            return undefined;
-        }
-        const parsed = Date.parse(value);
-        return Number.isNaN(parsed) ? undefined : parsed;
-    }
     function formatDuration(record) {
-        if (record.status === "running") {
-            return DASH;
-        }
-        return (formatRenderLifecycleDuration({
+        return formatRenderLifecycleRowDuration({
             lifecycle: {
                 status: record.status,
                 startedAt: record.startedAt,
@@ -153,21 +108,21 @@ export function createReduceRenderer(options = {}) {
             },
             terminalStatuses: TERMINAL_REDUCTION_STATUSES,
             now: now(),
-        }) ?? DASH);
+        });
     }
     function syncContextLifecycleFromReducerRecords() {
         if (!context) {
             return;
         }
-        let earliestStartedAt = safeParse(context.startedAt);
-        let latestCompletedAt = safeParse(context.completedAt);
+        let earliestStartedAt = parseProgressTimestamp(context.startedAt);
+        let latestCompletedAt = parseProgressTimestamp(context.completedAt);
         for (const reducer of reducerRecords.values()) {
-            const startedAt = safeParse(reducer.startedAt);
+            const startedAt = parseProgressTimestamp(reducer.startedAt);
             if (startedAt !== undefined &&
                 (earliestStartedAt === undefined || startedAt < earliestStartedAt)) {
                 earliestStartedAt = startedAt;
             }
-            const completedAt = safeParse(reducer.completedAt);
+            const completedAt = parseProgressTimestamp(reducer.completedAt);
             if (completedAt !== undefined &&
                 (latestCompletedAt === undefined || completedAt > latestCompletedAt)) {
                 latestCompletedAt = completedAt;
@@ -296,7 +251,7 @@ export function createReduceRenderer(options = {}) {
             });
         },
         complete(status, lifecycle) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             guard(() => {
                 if (context && lifecycle) {
                     context = {
@@ -321,7 +276,7 @@ export function createReduceRenderer(options = {}) {
     };
 }
 export function renderReduceTranscript(options) {
-    const { reductionId, createdAt, elapsed, workspacePath, status, reducers, nextCommandLines, suppressHint, isTty, includeSummarySection = true, } = options;
+    const { reductionId, createdAt, elapsed, workspacePath, status, targetDisplay, reducers, nextCommandLines, suppressHint, isTty, includeSummarySection = true, } = options;
     const style = { isTty };
     const resolvedStyle = resolveTranscriptShellStyle(style);
     const sections = [];
@@ -332,6 +287,7 @@ export function renderReduceTranscript(options) {
             elapsed,
             workspacePath,
             status,
+            targetDisplay,
             tableLines: reducers.length > 0
                 ? renderTranscriptStatusTable({
                     rows: reducers,
@@ -372,7 +328,7 @@ export function renderReduceTranscript(options) {
     return renderTranscript({ sections, hint });
 }
 export function formatReducerDuration(options) {
-    return (formatRenderLifecycleDuration({
+    return formatRenderLifecycleRowDuration({
         lifecycle: {
             status: options.status,
             startedAt: options.startedAt,
@@ -380,7 +336,7 @@ export function formatReducerDuration(options) {
         },
         terminalStatuses: TERMINAL_REDUCTION_STATUSES,
         now: options.now,
-    }) ?? "—");
+    });
 }
 export function formatReduceElapsed(options) {
     return formatRenderLifecycleDuration({

package/dist/render/transcripts/root-launcher.js

@@ -1,28 +1,18 @@
 import { colorize } from "../../utils/colors.js";
 export function renderRootLauncherSelectionScreen(options) {
+    void options.unavailable;
     const lines = [
         "Start a native agent session from this repository.",
         "",
         "Enabled agents:",
         ...options.launchable.map((agent, index) => `  ${index + 1}. ${agent.label}`),
     ];
-    if (options.unavailable.length > 0) {
-        lines.push("", "Unavailable enabled agents:");
-        for (const agent of options.unavailable) {
-            lines.push(`  - ${agent.label}: ${agent.reasons.join("; ")}`);
-        }
-    }
     lines.push("", "Choose one agent to launch.");
     return lines.join("\n");
 }
 export function renderRootLauncherSingleAgentScreen(options) {
+    void options.unavailable;
     const lines = ["Start a native agent session from this repository.", ""];
-    if (options.unavailable.length > 0) {
-        lines.push("", "Unavailable enabled agents:");
-        for (const agent of options.unavailable) {
-            lines.push(`  - ${agent.label}: ${agent.reasons.join("; ")}`);
-        }
-    }
     lines.push(`Using agent: ${options.selected}`);
     return lines.join("\n");
 }

package/dist/render/transcripts/run.d.ts

@@ -1,9 +1,6 @@
 import type { AgentInvocationRecord, RunReport } from "../../domain/run/model/types.js";
+import type { CliWriter } from "../utils/cli-writer.js";
 import type { StageProgressEventConsumer } from "./stage-progress.js";
-type CliWriter = Pick<NodeJS.WriteStream, "write"> & {
-    isTTY?: boolean;
-    columns?: number;
-};
 interface RunProgressContext {
     runId: string;
     status: RunReport["status"];
@@ -32,6 +29,8 @@ export interface RunTranscriptAgentRecord {
     startedAt?: string;
     completedAt?: string;
     diffStatistics?: string;
+    outputPath?: string;
+    errorLine?: string;
 }
 export interface RunTranscriptOptions {
     runId: string;
@@ -40,6 +39,7 @@ export interface RunTranscriptOptions {
     createdAt: string;
     startedAt?: string;
     completedAt?: string;
+    targetDisplay?: string;
     agents: readonly RunTranscriptAgentRecord[];
     isTty?: boolean;
     now?: number;

package/dist/render/transcripts/run.js

@@ -1,12 +1,14 @@
 import { TERMINAL_RUN_STATUSES } from "../../status/index.js";
 import { formatCompactDiffStatistics } from "../../utils/diff.js";
-import { formatAgentDuration, formatAgentStatusLabelWithStyle, } from "../utils/agents.js";
+import { formatAgentDuration, formatAgentErrorLine, formatAgentStatusLabelWithStyle, } from "../utils/agents.js";
 import { formatAgentBadge } from "../utils/badges.js";
 import { formatRenderLifecycleDuration } from "../utils/duration.js";
 import { createInteractiveFrameRenderer } from "../utils/interactive-frame.js";
+import { clearRefreshIntervalHandle, formatProgressiveRenderErrorDetail, } from "../utils/progressive-render.js";
 import { formatRunTimestamp } from "../utils/records.js";
 import { buildRunMetadataSectionWithStyle } from "../utils/runs.js";
 import { buildStageFrameLines, renderStageFinalFrame, } from "../utils/stage-output.js";
+import { renderTranscript } from "../utils/transcript.js";
 import { renderTranscriptStatusTable, resolveTranscriptShellStyle, resolveTranscriptShellStyleFromWriter, } from "../utils/transcript-shell.js";
 const DASH = "—";
 export function formatRunElapsed(source, now) {
@@ -33,6 +35,7 @@ export function renderRunTranscript(options) {
                 completedAt: options.completedAt,
             }, options.now) ?? DASH,
             createdAt: formatRunTimestamp(options.createdAt),
+            targetDisplay: options.targetDisplay,
         }, style),
         statusTableLines: options.agents.length === 0
             ? []
@@ -53,41 +56,34 @@ export function renderRunTranscript(options) {
                 extras: [{ header: "CHANGES", accessor: (row) => row.diff }],
             }),
     };
-    return renderStageFinalFrame({
-        metadataLines: shell.metadataLines,
-        statusTableLines: shell.statusTableLines,
-    });
-}
-function formatErrorDetail(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    if (typeof error === "string") {
-        return error;
-    }
-    if (error === null || error === undefined) {
-        return "unknown error";
-    }
-    if (typeof error === "number" ||
-        typeof error === "boolean" ||
-        typeof error === "bigint") {
-        return `${error}`;
-    }
-    if (typeof error === "symbol") {
-        return error.description ?? error.toString();
+    if (options.agents.length === 0) {
+        return renderStageFinalFrame({
+            metadataLines: shell.metadataLines,
+            statusTableLines: shell.statusTableLines,
+        });
     }
-    if (typeof error === "object") {
-        try {
-            const serialized = JSON.stringify(error);
-            if (serialized) {
-                return serialized;
-            }
+    const sections = [
+        [
+            ...shell.metadataLines,
+            ...(shell.statusTableLines.length > 0
+                ? ["", ...shell.statusTableLines]
+                : []),
+        ],
+        ["---"],
+    ];
+    options.agents.forEach((agent, index) => {
+        const block = [`Agent: ${agent.agentId}`];
+        if (agent.errorLine) {
+            const inlineError = agent.errorLine.replace(/\s+/gu, " ").trim();
+            block.push("", formatAgentErrorLine(inlineError, style));
         }
-        catch {
-            // ignore JSON serialization failures; fall through to default message.
+        block.push("", `Output: ${agent.outputPath ?? DASH}`);
+        if (index < options.agents.length - 1) {
+            block.push("", "---");
         }
-    }
-    return "unknown error";
+        sections.push(block);
+    });
+    return renderTranscript({ sections });
 }
 export function createRunRenderer(options = {}) {
     const stdout = options.stdout ?? process.stdout;
@@ -103,13 +99,6 @@ export function createRunRenderer(options = {}) {
     const interactiveFrameRenderer = createInteractiveFrameRenderer(stdout);
     const agentOrder = [];
     const agentRecords = new Map();
-    function stopRefreshLoop() {
-        if (!refreshInterval) {
-            return;
-        }
-        clearInterval(refreshInterval);
-        refreshInterval = undefined;
-    }
     function hasRunningAgents() {
         for (const record of agentRecords.values()) {
             if (record.status === "running") {
@@ -120,11 +109,11 @@ export function createRunRenderer(options = {}) {
     }
     function syncRefreshLoop() {
         if (!stdout.isTTY || disabled) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             return;
         }
         if (!hasRunningAgents()) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             return;
         }
         if (refreshInterval) {
@@ -133,11 +122,11 @@ export function createRunRenderer(options = {}) {
         refreshInterval = setInterval(() => {
             guard(() => {
                 if (!stdout.isTTY || disabled || !context) {
-                    stopRefreshLoop();
+                    refreshInterval = clearRefreshIntervalHandle(refreshInterval);
                     return;
                 }
                 if (!hasRunningAgents()) {
-                    stopRefreshLoop();
+                    refreshInterval = clearRefreshIntervalHandle(refreshInterval);
                     return;
                 }
                 const nextElapsed = formatRunElapsed(context);
@@ -158,10 +147,10 @@ export function createRunRenderer(options = {}) {
         }
         catch (error) {
             disabled = true;
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             if (!warningLogged) {
                 warningLogged = true;
-                const detail = formatErrorDetail(error);
+                const detail = formatProgressiveRenderErrorDetail(error);
                 stderr.write(`[voratiq] Progressive run output disabled: ${detail}\n`);
             }
         }
@@ -340,7 +329,7 @@ export function createRunRenderer(options = {}) {
             });
         },
         complete(report, options) {
-            stopRefreshLoop();
+            refreshInterval = clearRefreshIntervalHandle(refreshInterval);
             syncRecordsFromReport(report);
             guard(() => {
                 this.onProgressEvent({

package/dist/render/transcripts/spec.d.ts

@@ -1,10 +1,7 @@
 import type { ExtractedTokenUsage } from "../../domain/run/model/types.js";
 import type { TokenUsageResult } from "../../workspace/chat/token-usage-result.js";
+import type { CliWriter } from "../utils/cli-writer.js";
 import type { StageProgressEventConsumer } from "./stage-progress.js";
-type CliWriter = Pick<NodeJS.WriteStream, "write"> & {
-    isTTY?: boolean;
-    columns?: number;
-};
 export interface SpecProgressContext {
     sessionId: string;
     createdAt: string;