@corenel/web-ui 0.13.3 → 0.14.0

package/dist/steps/peek.js

@@ -0,0 +1,219 @@
+/* Peeks: the few lines a step shows without opening it.
+ *
+ * Everything here is cheap on huge input. A command result is read from its end
+ * (never split whole), and a written file is never diffed: the peek is its line
+ * count and its first few lines. */
+/** How many trailing characters a tail or a count scan will look at. */
+export const TAIL_WINDOW = 8000;
+/** The detail view renders at most this many lines; Copy output still copies all. */
+export const DETAIL_LINE_CAP = 2000;
+const BAD = /\b(error|errors|fail|failed|failure|fatal|exception|panic)\b|✕|✗|^\s*×/i;
+const OK = /^\s*(✓|✔|ok\b|pass(ed)?\b)/i;
+function asText(v) {
+    return typeof v === 'string' ? v : '';
+}
+/** Splits off the first line without splitting the rest. */
+function splitFirst(text) {
+    const i = text.indexOf('\n');
+    if (i === -1)
+        return { first: text.slice(0, 400).trim(), rest: '' };
+    return { first: text.slice(0, Math.min(i, 400)).trim(), rest: text.slice(i + 1) };
+}
+/** Right-trims whitespace with a linear walk from the end (no $-anchored regex). */
+function rtrim(text) {
+    let end = text.length;
+    while (end > 0 && /\s/.test(text[end - 1]))
+        end--;
+    return end === text.length ? text : text.slice(0, end);
+}
+/** Longest a peek line may be; a minified one-line file must not land whole. */
+const LINE_CLIP = 300;
+/** Removes the first whole `[output truncated]` line. indexOf only; no regex over the body. */
+function dropTruncationMarker(text) {
+    const marker = '[output truncated]';
+    let from = 0;
+    for (;;) {
+        const at = text.indexOf(marker, from);
+        if (at === -1)
+            return text;
+        const before = at === 0 || text[at - 1] === '\n';
+        let after = at + marker.length;
+        while (after < text.length && (text[after] === ' ' || text[after] === '\t' || text[after] === '\r'))
+            after++;
+        if (before && (after === text.length || text[after] === '\n')) {
+            return text.slice(0, at) + text.slice(after < text.length ? after + 1 : after);
+        }
+        from = at + marker.length;
+    }
+}
+/** Removes `stdout:` / `stderr:` label lines by walking lines; only short lines are tested. */
+function dropLabelLines(text) {
+    const kept = [];
+    let start = 0;
+    while (start <= text.length) {
+        let end = text.indexOf('\n', start);
+        if (end === -1)
+            end = text.length;
+        const line = text.slice(start, end);
+        if (!(line.length <= 16 && /^(stdout|stderr):\s*$/.test(line)))
+            kept.push(line);
+        start = end + 1;
+    }
+    return kept.join('\n');
+}
+function exitNumber(raw) {
+    if (raw === undefined)
+        return null;
+    const n = Number(raw);
+    return Number.isInteger(n) ? n : null;
+}
+export function parseCommandResult(name, args, result) {
+    const text = asText(result);
+    switch (name) {
+        case 'sidecar_shell_exec': {
+            const { first, rest } = splitFirst(text);
+            const timedOut = /^timed out\b/i.test(first);
+            const m = /^exit\s+(-?\d+|null)\b/i.exec(first);
+            const body = rtrim(dropTruncationMarker(rest));
+            return { exit: m ? exitNumber(m[1]) : null, timedOut, body };
+        }
+        case 'shell': {
+            const { first, rest } = splitFirst(text);
+            const timedOut = /^timed out\b/i.test(first);
+            const m = /^exit\s+(-?\d+|unknown)\b/i.exec(first);
+            const body = rtrim(dropLabelLines(rest));
+            return { exit: m ? exitNumber(m[1]) : null, timedOut, body };
+        }
+        case 'sidecar_run_check': {
+            try {
+                const parsed = JSON.parse(text);
+                if (parsed && typeof parsed === 'object') {
+                    const o = parsed;
+                    if (o.ok === false)
+                        return { exit: null, timedOut: false, body: asText(o.error) };
+                    const out = {
+                        exit: typeof o.exitCode === 'number' ? o.exitCode : null,
+                        timedOut: o.timedOut === true,
+                        body: asText(o.output),
+                    };
+                    if (typeof o.durationMs === 'number')
+                        out.ms = o.durationMs;
+                    return out;
+                }
+            }
+            catch {
+                /* not JSON: show it as it came */
+            }
+            return { exit: null, timedOut: false, body: text };
+        }
+        case 'proc_start': {
+            const exited = /ALREADY EXITED[^\n]*?exit code\s+(-?\d+)/.exec(text.slice(0, 2000));
+            const marker = 'Output so far:\n';
+            const at = text.indexOf(marker);
+            return {
+                exit: exited ? exitNumber(exited[1]) : null,
+                timedOut: false,
+                body: at === -1 ? '' : text.slice(at + marker.length),
+            };
+        }
+        case 'console_command':
+            return { exit: args && args.ok === false ? 1 : 0, timedOut: false, body: text };
+        default:
+            return { exit: null, timedOut: false, body: text };
+    }
+}
+/** A line's tone by the peek rules: error words red, pass marks green. */
+export function lineTone(line) {
+    if (BAD.test(line))
+        return 'bad';
+    if (OK.test(line))
+        return 'ok';
+    return 'plain';
+}
+/** The last `count` non-empty lines. Reads at most the final TAIL_WINDOW characters. */
+export function tailLines(body, count) {
+    const text = asText(body);
+    if (!text || count <= 0)
+        return [];
+    const cut = text.length > TAIL_WINDOW;
+    const window = cut ? text.slice(text.length - TAIL_WINDOW) : text;
+    const lines = window.split('\n');
+    // The window may start mid-line. Drop that fragment, unless it is all there is.
+    if (cut && lines.length > 1)
+        lines.shift();
+    const out = [];
+    for (let i = lines.length - 1; i >= 0 && out.length < count; i--) {
+        const t = lines[i].replace(/\r$/, '').trimEnd();
+        if (t.trim() === '')
+            continue;
+        out.push({ text: t, tone: lineTone(t) });
+    }
+    return out.reverse();
+}
+export function commandMeta(r) {
+    const body = asText(r.body);
+    const window = body.length > TAIL_WINDOW ? body.slice(body.length - TAIL_WINDOW) : body;
+    const failed = [...window.matchAll(/(\d+) failed/g)].pop();
+    if (failed)
+        return { text: `${failed[1]} failed`, tone: 'bad' };
+    const passed = [...window.matchAll(/(\d+) passed/g)].pop();
+    if (passed)
+        return { text: `${passed[1]} passed`, tone: 'ok' };
+    if (r.timedOut)
+        return { text: 'timed out', tone: 'bad' };
+    if (r.exit !== null && r.exit !== 0)
+        return { text: `exit ${r.exit}`, tone: 'bad' };
+    return { text: '', tone: 'plain' };
+}
+/** Number of lines in `text`, a trailing newline not counting as one. */
+function countLines(text) {
+    if (!text)
+        return 0;
+    let n = 1;
+    let i = -1;
+    while ((i = text.indexOf('\n', i + 1)) !== -1)
+        n++;
+    return text.endsWith('\n') ? n - 1 : n;
+}
+/** Index of the newline ending the `lines`-th line (the text length when it has fewer). */
+function endOfLines(text, lines) {
+    let at = -1;
+    for (let k = 0; k < lines; k++) {
+        const next = text.indexOf('\n', at + 1);
+        if (next === -1)
+            return text.length;
+        at = next;
+    }
+    return at;
+}
+/** The line count and first `count` lines of a write. Never diffs: there is no old text to compare with. */
+export function writePeek(args, count) {
+    const content = args ? args.content : undefined;
+    if (typeof content !== 'string')
+        return null;
+    const added = countLines(content);
+    const lines = [];
+    let start = 0;
+    while (lines.length < count && lines.length < added) {
+        let end = content.indexOf('\n', start);
+        if (end === -1)
+            end = content.length;
+        let t = content.slice(start, Math.min(end, start + LINE_CLIP + 1));
+        if (t.endsWith('\r'))
+            t = t.slice(0, -1);
+        if (t.length > LINE_CLIP)
+            t = t.slice(0, LINE_CLIP);
+        lines.push({ text: t, tone: 'add', n: lines.length + 1 });
+        start = end + 1;
+    }
+    return { added, lines };
+}
+/** The first `cap` lines of `text`, and how many more there are. */
+export function capLines(text, cap) {
+    const t = asText(text);
+    const total = countLines(t);
+    if (total <= cap)
+        return { shown: t.endsWith('\n') ? t.slice(0, -1) : t, more: 0 };
+    return { shown: t.slice(0, endOfLines(t, cap)), more: total - cap };
+}
+//# sourceMappingURL=peek.js.map

package/dist/steps/peek.js.map

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

package/dist/steps/plan.d.ts

@@ -0,0 +1,50 @@
+import type { KitStatus } from '@corenel/ui-kit/kit';
+import type { ConversationTurn } from '@corenel/harness/conversation';
+import { type TodoEntry } from '@corenel/harness/todos';
+import type { RailItem, Step } from './model';
+export type { RailTask, TaskState } from './model';
+export declare const TODO_WRITE = "todo_write";
+/** The task list a todo_write call's arguments state, given the raw JSON string
+ * or the parsed object. Malformed arguments are no tasks. */
+export declare function todosFromArgs(args: unknown): TodoEntry[];
+/** The plan in force after `turns`: the newest todo_write's list, [] when there
+ * is none or when it had zero tasks (a zero-task write ends the plan). */
+export declare function planAfter(turns: readonly ConversationTurn[]): TodoEntry[];
+/** The plan in force when each turn began, walking forward from `start`: entry i is
+ * turn i's, and the extra last entry is the plan after the final turn. A turn with
+ * no todo_write carries the plan; a zero-task write ends it. */
+export declare function planStarts(turns: readonly ConversationTurn[], start: TodoEntry[]): TodoEntry[][];
+/** Whether a plan is in force anywhere in a turn: it began with one, or one of its
+ * writes has tasks. When not, todo_write calls are ordinary steps (C10). */
+export declare function planInForce(start: readonly TodoEntry[], writes: readonly {
+    todos: readonly TodoEntry[];
+}[]): boolean;
+/** How a group of quiet steps reads. */
+export declare function exploredStatus(steps: Step[]): KitStatus;
+/** Every step in `items`, including those inside Explored groups and tasks; a custom card is one. */
+export declare function countSteps(items: RailItem[]): number;
+/** Nest one rail segment's items under the plan's tasks.
+ *
+ * `callIdsInOrder` is the whole turn's call ids in call order (todo_write calls
+ * included), and `writes` the turn's todo_write calls with their task lists, so a
+ * segment knows the plan as it stood at each of its calls and which tasks had
+ * steps anywhere in the turn. Call ids must be unique within the turn (turnBlocks
+ * suffixes reused ones). `start` is the plan in force when the turn began.
+ *
+ * - No plan in force anywhere in the turn: the items come back untouched (a
+ *   zero-task write then stays an ordinary step).
+ * - Otherwise todo_write calls are headings, never steps. A step goes under the
+ *   first in_progress task of the plan at its call; with none, or when that task
+ *   is gone from the final plan, it stays at turn level in order.
+ * - A task's stepCount is the steps under it in THIS segment (a task heading two
+ *   segments counts each separately).
+ * - Headings come from the final plan. A task sits at the position of its first
+ *   step; a subtask sits inside its parent. With `showUpcoming`, tasks with no
+ *   steps in the turn follow the last item, in plan order: those not yet done,
+ *   and those done in this turn (one already done when the turn began is not
+ *   repeated). */
+export declare function nestPlan(items: RailItem[], callIdsInOrder: string[], writes: {
+    callId: string;
+    todos: TodoEntry[];
+}[], start: TodoEntry[], showUpcoming: boolean): RailItem[];
+//# sourceMappingURL=plan.d.ts.map

package/dist/steps/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../steps/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAkB,KAAK,SAAS,EAAmB,MAAM,wBAAwB,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAY,IAAI,EAAa,MAAM,SAAS,CAAC;AAEnE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAYnD,eAAO,MAAM,UAAU,eAAe,CAAC;AASvC;6DAC6D;AAC7D,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,CAOxD;AAED;0EAC0E;AAC1E,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,EAAE,CAMzE;AAgBD;;gEAEgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,EAAE,CAQhG;AAED;4EAC4E;AAC5E,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS;IAAE,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,EAAE,GAAG,OAAO,CAEpH;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAMvD;AAED,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAQpD;AA4DD;;;;;;;;;;;;;;;;;;;kBAmBkB;AAClB,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,EAAE,EACjB,cAAc,EAAE,MAAM,EAAE,EACxB,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,EAAE,EAChD,KAAK,EAAE,SAAS,EAAE,EAClB,YAAY,EAAE,OAAO,GACpB,QAAQ,EAAE,CA0DZ"}

package/dist/steps/plan.js

@@ -0,0 +1,242 @@
+import { parseTodoWrite } from '@corenel/harness/todos';
+/* The plan is the rail: a turn's todo_write calls become task headings and its
+ * steps nest under them.
+ *
+ * Read from the transcript, not the todos store, so it works for reloaded chats,
+ * sidecar sessions and past the store's LRU cap. The bucketing rule is the
+ * store's (addActivity): a call made while a task is in_progress belongs to the
+ * first in_progress task of the plan as it stood when the call was made.
+ *
+ * Pure. This module imports only types from ./model; model imports it. */
+export const TODO_WRITE = 'todo_write';
+const STATE = {
+    completed: 'done',
+    in_progress: 'current',
+    pending: 'waiting',
+    blocked: 'blocked',
+};
+/** The task list a todo_write call's arguments state, given the raw JSON string
+ * or the parsed object. Malformed arguments are no tasks. */
+export function todosFromArgs(args) {
+    if (typeof args !== 'string')
+        return parseTodoWrite(args);
+    try {
+        return parseTodoWrite(JSON.parse(args));
+    }
+    catch {
+        return [];
+    }
+}
+/** The plan in force after `turns`: the newest todo_write's list, [] when there
+ * is none or when it had zero tasks (a zero-task write ends the plan). */
+export function planAfter(turns) {
+    for (let t = turns.length - 1; t >= 0; t--) {
+        const w = lastWrite(turns[t]);
+        if (w)
+            return w;
+    }
+    return [];
+}
+/** The task list of a turn's last todo_write, or undefined when it made none. */
+function lastWrite(turn) {
+    const messages = Array.isArray(turn?.messages) ? turn.messages : [];
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (!m || typeof m !== 'object' || m.role !== 'assistant' || !Array.isArray(m.tool_calls))
+            continue;
+        for (let n = m.tool_calls.length - 1; n >= 0; n--) {
+            const fn = m.tool_calls[n]?.function;
+            if (fn?.name === TODO_WRITE)
+                return todosFromArgs(fn.arguments);
+        }
+    }
+    return undefined;
+}
+/** The plan in force when each turn began, walking forward from `start`: entry i is
+ * turn i's, and the extra last entry is the plan after the final turn. A turn with
+ * no todo_write carries the plan; a zero-task write ends it. */
+export function planStarts(turns, start) {
+    const out = [start];
+    let plan = start;
+    for (const turn of turns) {
+        plan = lastWrite(turn) ?? plan;
+        out.push(plan);
+    }
+    return out;
+}
+/** Whether a plan is in force anywhere in a turn: it began with one, or one of its
+ * writes has tasks. When not, todo_write calls are ordinary steps (C10). */
+export function planInForce(start, writes) {
+    return start.length > 0 || writes.some((w) => w.todos.length > 0);
+}
+/** How a group of quiet steps reads. */
+export function exploredStatus(steps) {
+    if (steps.some((s) => s.status === 'failed'))
+        return 'failed';
+    if (steps.some((s) => s.status === 'running'))
+        return 'running';
+    // A stopped member (no result) must not read green.
+    if (steps.some((s) => s.status === 'stopped'))
+        return 'stopped';
+    return 'done';
+}
+/** Every step in `items`, including those inside Explored groups and tasks; a custom card is one. */
+export function countSteps(items) {
+    let n = 0;
+    for (const item of items) {
+        if (item.kind === 'step' || item.kind === 'custom')
+            n += 1;
+        else if (item.kind === 'explored')
+            n += item.steps.length;
+        else if (item.kind === 'task')
+            n += countSteps(item.items);
+    }
+    return n;
+}
+function atomsOf(items) {
+    const out = [];
+    for (const item of items) {
+        if (item.kind === 'step')
+            out.push({ item, id: item.step.id, group: null });
+        else if (item.kind === 'explored')
+            for (const step of item.steps)
+                out.push({ item: { kind: 'step', step, peek: false }, id: step.id, group: item });
+        else if (item.kind === 'custom')
+            out.push({ item, id: item.callId ?? null, group: null });
+        else
+            out.push({ item, id: null, group: null });
+    }
+    return out;
+}
+function stepIdOf(a) {
+    return a.item.kind === 'step' ? a.item.step.id : '';
+}
+/** Nodes back into rail items: consecutive members of one Explored group regroup
+ * (two or more), a lone member becomes a plain step. No new groups are made. */
+function render(nodes, kids, byId) {
+    const out = [];
+    let run = [];
+    const flush = () => {
+        if (run.length >= 2 && run[0].group) {
+            const steps = run.flatMap((a) => (a.item.kind === 'step' ? [a.item.step] : []));
+            out.push({ kind: 'explored', key: `x:${stepIdOf(run[0])}`, steps, status: exploredStatus(steps), open: run[0].group.open });
+        }
+        else {
+            for (const a of run)
+                out.push(a.item);
+        }
+        run = [];
+    };
+    for (const n of nodes) {
+        if (n.kind === 'task') {
+            flush();
+            const t = byId.get(n.id);
+            if (!t)
+                continue;
+            const items = render(kids.get(n.id) ?? [], kids, byId);
+            const task = { id: t.id, title: t.title, state: STATE[t.status] ?? 'waiting', stepCount: countSteps(items) };
+            if (t.parentId)
+                task.parentId = t.parentId;
+            out.push({ kind: 'task', key: `task:${t.id}`, task, items });
+            continue;
+        }
+        const a = n.atom;
+        if (a.group && run.length && run[0].group === a.group) {
+            run.push(a);
+            continue;
+        }
+        flush();
+        if (a.group)
+            run = [a];
+        else
+            out.push(a.item);
+    }
+    flush();
+    return out;
+}
+/** Nest one rail segment's items under the plan's tasks.
+ *
+ * `callIdsInOrder` is the whole turn's call ids in call order (todo_write calls
+ * included), and `writes` the turn's todo_write calls with their task lists, so a
+ * segment knows the plan as it stood at each of its calls and which tasks had
+ * steps anywhere in the turn. Call ids must be unique within the turn (turnBlocks
+ * suffixes reused ones). `start` is the plan in force when the turn began.
+ *
+ * - No plan in force anywhere in the turn: the items come back untouched (a
+ *   zero-task write then stays an ordinary step).
+ * - Otherwise todo_write calls are headings, never steps. A step goes under the
+ *   first in_progress task of the plan at its call; with none, or when that task
+ *   is gone from the final plan, it stays at turn level in order.
+ * - A task's stepCount is the steps under it in THIS segment (a task heading two
+ *   segments counts each separately).
+ * - Headings come from the final plan. A task sits at the position of its first
+ *   step; a subtask sits inside its parent. With `showUpcoming`, tasks with no
+ *   steps in the turn follow the last item, in plan order: those not yet done,
+ *   and those done in this turn (one already done when the turn began is not
+ *   repeated). */
+export function nestPlan(items, callIdsInOrder, writes, start, showUpcoming) {
+    if (!planInForce(start, writes))
+        return items;
+    const writeAt = new Map();
+    for (const w of writes)
+        writeAt.set(w.callId, w.todos);
+    const final = writes.length ? writes[writes.length - 1].todos : start;
+    const byId = new Map();
+    for (const t of final)
+        if (!byId.has(t.id))
+            byId.set(t.id, t);
+    // The plan as it stood at each call.
+    const bucketOf = new Map();
+    const withSteps = new Set();
+    let plan = start;
+    for (const id of callIdsInOrder) {
+        const w = writeAt.get(id);
+        if (w) {
+            plan = w;
+            continue;
+        }
+        const active = plan.find((t) => t.status === 'in_progress')?.id;
+        const bucket = active !== undefined && byId.has(active) ? active : null;
+        bucketOf.set(id, bucket);
+        if (bucket !== null)
+            withSteps.add(bucket);
+    }
+    const top = [];
+    const kids = new Map();
+    /** The node list a task's items go in, placing the task (and its parent) on first use. */
+    const slot = (t, nest) => {
+        const have = kids.get(t.id);
+        if (have)
+            return have;
+        const list = [];
+        kids.set(t.id, list);
+        const parent = nest && t.parentId && t.parentId !== t.id ? byId.get(t.parentId) : undefined;
+        (parent ? slot(parent, false) : top).push({ kind: 'task', id: t.id });
+        return list;
+    };
+    let prev = null;
+    for (const atom of atomsOf(items)) {
+        if (atom.id !== null && writeAt.has(atom.id))
+            continue;
+        if (atom.item.kind === 'step' && atom.item.step.name === TODO_WRITE)
+            continue;
+        // An item with no call (an approval) stays beside the item before it.
+        const bucket = atom.id !== null ? bucketOf.get(atom.id) ?? null : prev;
+        prev = bucket;
+        const task = bucket !== null ? byId.get(bucket) : undefined;
+        (task ? slot(task, true) : top).push({ kind: 'atom', atom });
+    }
+    if (showUpcoming) {
+        // Not done yet, or done in this turn, so a list made and ticked off with no
+        // other calls still shows. A done parent still appears as the container of an
+        // upcoming subtask (slot places it).
+        const doneBefore = new Set(start.filter((t) => t.status === 'completed').map((t) => t.id));
+        for (const t of byId.values()) {
+            const shown = t.status !== 'completed' || !doneBefore.has(t.id);
+            if (shown && !withSteps.has(t.id) && !kids.has(t.id))
+                slot(t, true);
+        }
+    }
+    return render(top, kids, byId);
+}
+//# sourceMappingURL=plan.js.map

package/dist/steps/plan.js.map

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

package/dist/steps/useRailDetail.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from 'react';
+import type { RailItem, Step, TurnBlock } from './model';
+/** Where a command ran, when its arguments say: a host that cannot rerun it
+ * there hides Run again (canRerun false). */
+export interface RerunWhere {
+    cwd?: string;
+    root?: string;
+}
+/** Run again for a command step. `canRerun` false hides it for that tool.
+ * `where` is passed only when the step's arguments name a cwd or root. */
+export interface RerunOpts {
+    onRerun?: (tool: string, command: string, where?: RerunWhere) => void;
+    canRerun?: (tool: string, command: string, where?: RerunWhere) => boolean;
+}
+/** Every step in `items`, nested ones included, by Step.id. */
+export declare function collectSteps(items: RailItem[], into: Map<string, Step>): void;
+/** The detail body for `step`, with Run again when the command can be rerun. */
+export declare function stepDetailBody(step: Step, rerun: RerunOpts): () => ReactNode;
+/** `scope` prefixes every detail id this rail opens (providers reuse call ids
+ * across turns). Returns the selected step's id within the scope, and the opener. */
+export declare function useRailDetail(scope: string, blocks: TurnBlock[], rerun: RerunOpts): {
+    selectedId: string | null;
+    openStep: (step: Step) => void;
+};
+//# sourceMappingURL=useRailDetail.d.ts.map

package/dist/steps/useRailDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRailDetail.d.ts","sourceRoot":"","sources":["../../steps/useRailDetail.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGtF,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzD;6CAC6C;AAC7C,MAAM,WAAW,UAAU;IAAG,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAE3D;0EAC0E;AAC1E,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;CAC3E;AAUD,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAM7E;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,SAAS,CAU5E;AAED;qFACqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG;IACnF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAChC,CAsDA"}