@mickorz/opencode-agentic-workflow 0.4.0 → 0.5.0

package/dist/plugin/progress-rpc.js

@@ -0,0 +1,318 @@
+/**
+ * Workflow Progress RPC 契约（P2-8，server 与 TUI 双形态共享）
+ *
+ * 流向：
+ *   server RunJournal 状态转换 -> emitEvent("run.progress") -> ProgressBoard
+ *     --events.emit--> rpc.agentic-workflow-progress.progress { run 快照 }
+ *   TUI 面板：
+ *     <--call-- rpc "snapshot" -> { runs: [...] }（面板打开时初始同步）
+ *     --事件--> 实时更新（全量快照，无需增量对账）
+ *
+ * 快照小而可序列化（不含步骤 output——详情看 journal 文件）。
+ */
+import { Rpc } from "@opencode/plugin/rpc";
+/** run 快照 JSON Schema（event 载荷与 snapshot 方法输出条目共用） */
+const runSnapshotSchema = {
+    type: "object",
+    properties: {
+        runId: { type: "string" },
+        workflow: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                version: { type: "string" },
+            },
+            required: ["id", "version"],
+            additionalProperties: false,
+        },
+        status: { type: "string" },
+        startedAt: { type: "number" },
+        completedAt: { type: "number" },
+        failure: { type: "string" },
+        parentRunId: { type: "string" },
+        depth: { type: "number" },
+        steps: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    index: { type: "number" },
+                    name: { type: "string" },
+                    status: { type: "string" },
+                    startedAt: { type: "number" },
+                    completedAt: { type: "number" },
+                },
+                required: ["index", "status"],
+            },
+        },
+    },
+    required: ["runId", "workflow", "status", "startedAt", "steps"],
+};
+/** run 详情 JSON Schema（detail 方法输出；步骤载荷为预览化字符串） */
+const runDetailSchema = {
+    type: "object",
+    properties: {
+        runId: { type: "string" },
+        workflow: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                version: { type: "string" },
+            },
+            required: ["id", "version"],
+            additionalProperties: false,
+        },
+        status: { type: "string" },
+        startedAt: { type: "number" },
+        completedAt: { type: "number" },
+        failure: { type: "string" },
+        parentRunId: { type: "string" },
+        depth: { type: "number" },
+        args: { type: "string" },
+        steps: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    index: { type: "number" },
+                    name: { type: "string" },
+                    status: { type: "string" },
+                    startedAt: { type: "number" },
+                    completedAt: { type: "number" },
+                    input: { type: "string" },
+                    output: { type: "string" },
+                    error: { type: "string" },
+                    usage: {
+                        type: "object",
+                        properties: {
+                            input: { type: "number" },
+                            output: { type: "number" },
+                            reasoning: { type: "number" },
+                        },
+                        required: ["input", "output", "reasoning"],
+                        additionalProperties: false,
+                    },
+                    model: { type: "string" },
+                    sessionIDs: { type: "array", items: { type: "string" } },
+                },
+                required: ["index", "status"],
+            },
+        },
+    },
+    required: ["runId", "workflow", "status", "startedAt", "steps"],
+};
+export const ProgressRpc = Rpc.define({
+    id: "agentic-workflow-progress",
+    methods: {
+        /** TUI -> server：拉取当前 board（面板打开时初始同步） */
+        snapshot: {
+            input: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+            output: {
+                type: "object",
+                properties: {
+                    runs: { type: "array", items: runSnapshotSchema },
+                },
+                required: ["runs"],
+                additionalProperties: false,
+            },
+        },
+        /** TUI -> server：单个 run 的节点详情（journal 单读，载荷为预览） */
+        detail: {
+            input: {
+                type: "object",
+                properties: {
+                    runId: { type: "string" },
+                },
+                required: ["runId"],
+                additionalProperties: false,
+            },
+            output: {
+                type: "object",
+                properties: {
+                    run: { oneOf: [runDetailSchema, { type: "null" }] },
+                },
+                required: ["run"],
+                additionalProperties: false,
+            },
+        },
+        /**
+         * TUI -> server：Open Session 回放——按 runId + 步骤名取该步骤子会话的
+         * 完整对话（文本预览）。index 选多会话步骤（pipeline）的第几个，缺省最后。
+         */
+        session: {
+            input: {
+                type: "object",
+                properties: {
+                    runId: { type: "string" },
+                    step: { type: "string" },
+                    index: { type: "number" },
+                },
+                required: ["runId", "step"],
+                additionalProperties: false,
+            },
+            output: {
+                type: "object",
+                properties: {
+                    session: {
+                        oneOf: [
+                            {
+                                type: "object",
+                                properties: {
+                                    sessionID: { type: "string" },
+                                    step: { type: "string" },
+                                    messages: {
+                                        type: "array",
+                                        items: {
+                                            type: "object",
+                                            properties: {
+                                                type: { type: "string" },
+                                                text: { type: "string" },
+                                            },
+                                            required: ["type", "text"],
+                                            additionalProperties: false,
+                                        },
+                                    },
+                                },
+                                required: ["sessionID", "messages"],
+                                additionalProperties: false,
+                            },
+                            { type: "null" },
+                        ],
+                    },
+                },
+                required: ["session"],
+                additionalProperties: false,
+            },
+        },
+    },
+    events: {
+        /** server -> TUI：run 全量快照 */
+        progress: { schema: runSnapshotSchema },
+    },
+});
+/** TUI 订阅用事件名（字面量类型；与 ProgressRpc.id 的一致性由单测保证） */
+export const PROGRESS_EVENT = "rpc.agentic-workflow-progress.progress";
+/** 收窄事件/方法载荷为快照（事件 data 为 unknown 形状）；不合法返回 undefined */
+export function parseRunSnapshot(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const record = data;
+    if (typeof record.runId !== "string")
+        return undefined;
+    if (typeof record.status !== "string")
+        return undefined;
+    if (typeof record.startedAt !== "number")
+        return undefined;
+    if (!Array.isArray(record.steps))
+        return undefined;
+    const workflow = record.workflow;
+    if (typeof workflow !== "object" ||
+        workflow === null ||
+        typeof workflow.id !== "string" ||
+        typeof workflow.version !== "string") {
+        return undefined;
+    }
+    for (const step of record.steps) {
+        if (typeof step !== "object" || step === null)
+            return undefined;
+        const s = step;
+        if (typeof s.index !== "number" || typeof s.status !== "string")
+            return undefined;
+    }
+    return data;
+}
+/** 收窄 snapshot 方法输出为快照数组；不合法整体丢弃（面板回退到空态） */
+export function parseRunSnapshotList(data) {
+    if (typeof data !== "object" || data === null)
+        return [];
+    const runs = data.runs;
+    if (!Array.isArray(runs))
+        return [];
+    const parsed = runs.map(parseRunSnapshot).filter((s) => s !== undefined);
+    return parsed.filter((s) => s !== undefined);
+}
+/** 收窄 detail 方法入参为 runId；不合法（缺/非串）返回 undefined */
+export function parseRunDetailRequest(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const runId = data.runId;
+    return typeof runId === "string" ? runId : undefined;
+}
+/** 收窄 detail 方法输出为详情；null（run 不存在/无 journal）或不合法返回 undefined */
+export function parseRunDetail(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const record = data;
+    if (record.run === null)
+        return undefined;
+    const run = record.run;
+    if (typeof run !== "object" || run === null)
+        return undefined;
+    const detail = run;
+    if (typeof detail.runId !== "string")
+        return undefined;
+    if (typeof detail.status !== "string")
+        return undefined;
+    if (typeof detail.startedAt !== "number")
+        return undefined;
+    if (!Array.isArray(detail.steps))
+        return undefined;
+    const workflow = detail.workflow;
+    if (typeof workflow !== "object" ||
+        workflow === null ||
+        typeof workflow.id !== "string" ||
+        typeof workflow.version !== "string") {
+        return undefined;
+    }
+    for (const step of detail.steps) {
+        if (typeof step !== "object" || step === null)
+            return undefined;
+        const s = step;
+        if (typeof s.index !== "number" || typeof s.status !== "string")
+            return undefined;
+    }
+    return run;
+}
+/** 收窄 session 方法入参；不合法返回 undefined */
+export function parseSessionReplayRequest(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const req = data;
+    if (typeof req.runId !== "string" || typeof req.step !== "string")
+        return undefined;
+    return {
+        runId: req.runId,
+        step: req.step,
+        ...(typeof req.index === "number" ? { index: req.index } : {}),
+    };
+}
+/** 收窄 session 方法输出；不合法返回 undefined */
+export function parseSessionReplay(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const out = data;
+    if (typeof out.session !== "object" || out.session === null)
+        return undefined;
+    const session = out.session;
+    if (typeof session.sessionID !== "string" || !Array.isArray(session.messages))
+        return undefined;
+    const messages = [];
+    for (const message of session.messages) {
+        if (typeof message !== "object" || message === null)
+            return undefined;
+        const m = message;
+        if (typeof m.type !== "string" || typeof m.text !== "string")
+            return undefined;
+        messages.push({ type: m.type, text: m.text });
+    }
+    return {
+        sessionID: session.sessionID,
+        ...(typeof session.step === "string" ? { step: session.step } : {}),
+        messages,
+    };
+}
+//# sourceMappingURL=progress-rpc.js.map

package/dist/plugin/progress-rpc.js.map

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

package/dist/plugin/progress-view.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 进度面板视图模型（P2-8）
+ *
+ * 纯函数层：RunProgressSnapshot -> 展示行。无 solid 依赖——
+ * TUI 组件消费，单测直接断言（渲染逻辑的最小不可测面只剩 JSX 摆放）。
+ */
+import type { RunProgressSnapshot } from "../observability/events.js";
+import type { RunDetail } from "../state/recorder.js";
+export declare function runGlyph(status: string): string;
+export declare function stepGlyph(status: string): string;
+/** 毫秒 -> 人读时长（0s / 12.3s / 1m02s / 1h03m） */
+export declare function formatDuration(ms: number): string;
+export interface StepViewModel {
+    label: string;
+    glyph: string;
+    status: string;
+    duration?: string;
+}
+export interface RunViewModel {
+    title: string;
+    glyph: string;
+    status: string;
+    /** 完成用 completedAt-startedAt；进行中用 now-startedAt（随事件刷新） */
+    duration: string;
+    failure?: string;
+    steps: StepViewModel[];
+}
+/** 单 run -> 视图模型（now 注入，测试可冻结时间） */
+export declare function toRunViewModel(run: RunProgressSnapshot, now?: number): RunViewModel;
+export interface PanelLinesOptions {
+    /** 行宽上限（截断加 …）；默认不截断 */
+    maxWidth?: number;
+    /** 展开全步骤树的 run 数（最新的在前）；默认 1（最新 run 展开） */
+    expandedRuns?: number;
+}
+/**
+ * 整板 -> 展示行（最新顶层 run 展开步骤树，其余收为一行摘要；
+ * subflow 子 run 按 parentRunId 缩进挂在父 run 下，深度再加两格）。
+ * 面板组件逐行渲染；单测直接断言行内容。
+ */
+export declare function renderPanelLines(runs: readonly RunProgressSnapshot[], now?: number, options?: PanelLinesOptions): string[];
+/** TUI 侧详情缓存条目（runId + 预渲染行；key 仅供去重，不参与渲染） */
+export interface DetailSection {
+    runId: string;
+    lines: string[];
+}
+/** 详情区行：缓存的详情属于板上最新 run 时输出（头行分隔），否则空 */
+export declare function renderDetailSection(runs: readonly RunProgressSnapshot[], detail: DetailSection | undefined): string[];
+/** TUI 侧会话回放缓存条目（runId@step 去重键 + 预渲染行） */
+export interface SessionSection {
+    runId: string;
+    step: string;
+    lines: string[];
+}
+/** 会话回放区行：缓存属于板上最新 run 时输出（头行分隔），否则空 */
+export declare function renderSessionSection(runs: readonly RunProgressSnapshot[], session: SessionSection | undefined): string[];
+/**
+ * 回放载荷 -> 预渲染行：步骤头（步骤名 + 会话 ID）+ 逐消息折行块，
+ * 总行数预算 maxLines（超出尾缀 …）。纯函数，单测覆盖。
+ */
+export declare function renderSessionLines(replay: {
+    sessionID: string;
+    step?: string;
+    messages: ReadonlyArray<{
+        type: string;
+        text: string;
+    }>;
+}, maxWidth?: number, maxLines?: number): string[];
+/** token 数 -> 紧凑人读（123 / 1.2k / 15.3k） */
+export declare function formatTokens(n: number): string;
+export interface DetailLinesOptions {
+    /** 行宽上限（截断加 …）；默认不截断 */
+    maxWidth?: number;
+    /** 每段预览最多折行数（默认 3） */
+    maxPreviewLines?: number;
+}
+/**
+ * run 详情 -> 展示行（P2-8b 节点详情）：头行（workflow@version · 状态 · 时长）、
+ * runId/lineage、args 预览、逐步骤（状态 + 时长 + 输出/错误预览折行）。
+ * 纯函数，TUI 组件逐行渲染；单测直接断言行内容。
+ */
+export declare function renderDetailLines(detail: RunDetail, now?: number, options?: DetailLinesOptions): string[];

package/dist/plugin/progress-view.js

@@ -0,0 +1,244 @@
+/**
+ * 进度面板视图模型（P2-8）
+ *
+ * 纯函数层：RunProgressSnapshot -> 展示行。无 solid 依赖——
+ * TUI 组件消费，单测直接断言（渲染逻辑的最小不可测面只剩 JSX 摆放）。
+ */
+const RUN_GLYPHS = {
+    running: "▶",
+    completed: "✓",
+    failed: "✗",
+    aborted: "⏹",
+};
+const STEP_GLYPHS = {
+    pending: "·",
+    running: "▶",
+    completed: "✓",
+    failed: "✗",
+    skipped: "–",
+};
+export function runGlyph(status) {
+    return RUN_GLYPHS[status] ?? "?";
+}
+export function stepGlyph(status) {
+    return STEP_GLYPHS[status] ?? "?";
+}
+/** 毫秒 -> 人读时长（0s / 12.3s / 1m02s / 1h03m） */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms <= 0)
+        return "0s";
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const totalSeconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes < 60)
+        return `${minutes}m${String(seconds).padStart(2, "0")}s`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h${String(minutes % 60).padStart(2, "0")}m`;
+}
+/** 单 run -> 视图模型（now 注入，测试可冻结时间） */
+export function toRunViewModel(run, now = Date.now()) {
+    const end = run.completedAt ?? now;
+    const steps = run.steps.map((step) => {
+        const startedAt = step.startedAt;
+        const finishedAt = step.completedAt;
+        return {
+            label: step.name ?? `step ${step.index}`,
+            glyph: stepGlyph(step.status),
+            status: step.status,
+            ...(startedAt !== undefined
+                ? { duration: formatDuration((finishedAt ?? end) - startedAt) }
+                : {}),
+        };
+    });
+    return {
+        title: `${run.workflow.id}@${run.workflow.version}`,
+        glyph: runGlyph(run.status),
+        status: run.status,
+        duration: formatDuration(Math.max(0, end - run.startedAt)),
+        ...(run.failure !== undefined ? { failure: run.failure } : {}),
+        steps,
+    };
+}
+function truncate(line, maxWidth) {
+    if (maxWidth === undefined || line.length <= maxWidth)
+        return line;
+    return `${line.slice(0, Math.max(1, maxWidth - 1))}…`;
+}
+/**
+ * 整板 -> 展示行（最新顶层 run 展开步骤树，其余收为一行摘要；
+ * subflow 子 run 按 parentRunId 缩进挂在父 run 下，深度再加两格）。
+ * 面板组件逐行渲染；单测直接断言行内容。
+ */
+export function renderPanelLines(runs, now = Date.now(), options) {
+    if (runs.length === 0) {
+        return ["Agentic Workflow", "(no runs yet — start one with workflow_start)"];
+    }
+    // P2-9 lineage：父子分组（父不在板上的孤儿按顶层渲染）
+    const byId = new Set(runs.map((r) => r.runId));
+    const childrenOf = new Map();
+    const topLevels = [];
+    for (const run of runs) {
+        if (run.parentRunId !== undefined && byId.has(run.parentRunId)) {
+            const list = childrenOf.get(run.parentRunId) ?? [];
+            list.push(run);
+            childrenOf.set(run.parentRunId, list);
+        }
+        else {
+            topLevels.push(run);
+        }
+    }
+    const expanded = options?.expandedRuns ?? 1;
+    const lines = ["Agentic Workflow"];
+    /** 递归渲染一棵 run 树：本体 + 其 subflow 子孙（缩进随深度） */
+    const emitRun = (run, topLevelIndex) => {
+        const vm = toRunViewModel(run, now);
+        const isTop = run.parentRunId === undefined;
+        if (isTop) {
+            lines.push(truncate(`${vm.glyph} ${vm.title}  ${vm.duration}`, options?.maxWidth));
+            if (topLevelIndex < expanded) {
+                for (const step of vm.steps) {
+                    const duration = step.duration ? `  ${step.duration}` : "";
+                    lines.push(truncate(`  ${step.glyph} ${step.label}${duration}`, options?.maxWidth));
+                }
+                if (vm.failure) {
+                    lines.push(truncate(`  ↳ ${vm.failure}`, options?.maxWidth));
+                }
+            }
+        }
+        else {
+            const indent = "    ".repeat(Math.min(run.depth ?? 1, 3));
+            const lineage = run.status === "running" ? " ⇢ subflow" : " · subflow";
+            lines.push(truncate(`${indent}↳ ${vm.glyph} ${vm.title}  ${vm.duration}${lineage}`, options?.maxWidth));
+            if (vm.failure) {
+                lines.push(truncate(`${indent}  ↳ ${vm.failure}`, options?.maxWidth));
+            }
+        }
+        for (const child of childrenOf.get(run.runId) ?? []) {
+            emitRun(child, topLevelIndex);
+        }
+    };
+    topLevels.forEach((run, i) => emitRun(run, i));
+    return lines;
+}
+/** 详情区行：缓存的详情属于板上最新 run 时输出（头行分隔），否则空 */
+export function renderDetailSection(runs, detail) {
+    const newest = runs[0];
+    if (!newest || !detail || detail.runId !== newest.runId || detail.lines.length === 0) {
+        return [];
+    }
+    return ["── detail", ...detail.lines];
+}
+/** 会话回放区行：缓存属于板上最新 run 时输出（头行分隔），否则空 */
+export function renderSessionSection(runs, session) {
+    const newest = runs[0];
+    if (!newest || !session || session.runId !== newest.runId || session.lines.length === 0) {
+        return [];
+    }
+    return ["── session", ...session.lines];
+}
+/** 消息类型的行前缀（与面板既有图标语言一致：❯ 提问 / · 回答 / ↳ 其他） */
+function sessionMessagePrefix(type) {
+    if (type === "user")
+        return "❯ ";
+    if (type === "assistant")
+        return "· ";
+    return "↳ ";
+}
+/**
+ * 回放载荷 -> 预渲染行：步骤头（步骤名 + 会话 ID）+ 逐消息折行块，
+ * 总行数预算 maxLines（超出尾缀 …）。纯函数，单测覆盖。
+ */
+export function renderSessionLines(replay, maxWidth, maxLines = 24) {
+    const header = `${replay.step !== undefined ? `${replay.step} · ` : ""}${replay.sessionID}`;
+    const lines = [header];
+    for (const message of replay.messages) {
+        if (lines.length >= maxLines)
+            break;
+        const prefix = sessionMessagePrefix(message.type);
+        const wrapped = wrapPreview(message.text, maxWidth, 3);
+        for (let i = 0; i < wrapped.length && lines.length < maxLines; i++) {
+            lines.push(i === 0 ? `${prefix}${wrapped[i]}` : `  ${wrapped[i]}`);
+        }
+    }
+    if (lines.length >= maxLines)
+        lines.push("…");
+    return lines;
+}
+/** 单段预览 -> 折行块（宽度不定时按单行原样；超出行数截断加 …） */
+function wrapPreview(text, maxWidth, maxLines) {
+    if (maxWidth === undefined || maxWidth < 8)
+        return [text];
+    const chunks = [];
+    for (let i = 0; i < text.length && chunks.length < maxLines; i += maxWidth) {
+        chunks.push(text.slice(i, i + maxWidth));
+    }
+    if (text.length > maxLines * maxWidth) {
+        const last = chunks[chunks.length - 1] ?? "";
+        chunks[chunks.length - 1] = `${last.slice(0, Math.max(1, maxWidth - 1))}…`;
+    }
+    return chunks;
+}
+/** token 数 -> 紧凑人读（123 / 1.2k / 15.3k） */
+export function formatTokens(n) {
+    if (!Number.isFinite(n) || n < 1000)
+        return String(Math.max(0, Math.round(n)));
+    return `${(n / 1000).toFixed(1)}k`;
+}
+/**
+ * run 详情 -> 展示行（P2-8b 节点详情）：头行（workflow@version · 状态 · 时长）、
+ * runId/lineage、args 预览、逐步骤（状态 + 时长 + 输出/错误预览折行）。
+ * 纯函数，TUI 组件逐行渲染；单测直接断言行内容。
+ */
+export function renderDetailLines(detail, now = Date.now(), options) {
+    const maxWidth = options?.maxWidth;
+    const maxPreview = options?.maxPreviewLines ?? 3;
+    const duration = detail.completedAt !== undefined
+        ? formatDuration(Math.max(0, detail.completedAt - detail.startedAt))
+        : formatDuration(Math.max(0, now - detail.startedAt));
+    const lines = [
+        truncate(`${runGlyph(detail.status)} ${detail.workflow.id}@${detail.workflow.version} · ${detail.status} · ${duration}`, maxWidth),
+    ];
+    const meta = [detail.runId];
+    if (detail.parentRunId !== undefined) {
+        meta.push(`parent ${detail.parentRunId}`, `depth ${detail.depth ?? "?"}`);
+    }
+    lines.push(truncate(`  ${meta.join(" · ")}`, maxWidth));
+    if (detail.args !== undefined && detail.args !== "") {
+        lines.push(truncate(`  args ${detail.args}`, maxWidth));
+    }
+    for (const step of detail.steps) {
+        const stepDuration = step.startedAt !== undefined
+            ? `  ${formatDuration(Math.max(0, (step.completedAt ?? now) - step.startedAt))}`
+            : "";
+        // P2-8b 元数据后缀：模型 + token 合计（input+output+reasoning；reasoning
+        // 已含于 output 时宿主报 0，不会重复计）
+        const meta = [];
+        if (step.usage !== undefined) {
+            const total = step.usage.input + step.usage.output + step.usage.reasoning;
+            meta.push(`${formatTokens(total)} tok`);
+        }
+        if (step.model !== undefined)
+            meta.push(step.model);
+        const metaSuffix = meta.length > 0 ? `  · ${meta.join(" · ")}` : "";
+        lines.push(truncate(`  ${stepGlyph(step.status)} ${step.name ?? `step ${step.index}`}${stepDuration}${metaSuffix}`, maxWidth));
+        // 预览折行宽度扣除缩进，保证整行不超 maxWidth（宽度不定时不折）
+        const previewWidth = maxWidth === undefined ? undefined : Math.max(8, maxWidth - 4);
+        if (step.error !== undefined && step.error !== "") {
+            for (const line of wrapPreview(`✗ ${step.error}`, previewWidth, maxPreview)) {
+                lines.push(`    ${line}`);
+            }
+        }
+        else if (step.output !== undefined && step.output !== "") {
+            for (const line of wrapPreview(`→ ${step.output}`, previewWidth, maxPreview)) {
+                lines.push(`    ${line}`);
+            }
+        }
+    }
+    if (detail.failure !== undefined && detail.failure !== "") {
+        lines.push(truncate(`  ↳ ${detail.failure}`, maxWidth));
+    }
+    return lines;
+}
+//# sourceMappingURL=progress-view.js.map