@chances-ai/ui-core 17.0.0

package/dist/tool-line.js

@@ -0,0 +1,172 @@
+/**
+ * (5.9 / v14) Pure view-side tool-call label. Renders `⏺ Name(argSummary)` —
+ * see `tool-message.tsx`. This is a MINIMAL, NON-AUTHORITATIVE label (codex R1
+ * SHOULD-1): it only echoes the call's own args (available on the `tool:call`
+ * bus event, which carries no `ToolContext`). It deliberately does NOT claim
+ * create-vs-overwrite, byte counts, or diffs — that fidelity comes only from
+ * the richer permission summary (`tool:permission`), which the view stashes
+ * and renders under the `⎿` branch (see `view-model.ts`).
+ *
+ * Pure `(name, args) => string`, so it is fully unit-testable without Ink.
+ *
+ * (v17 ui-core) NO `node:*`: `home` is always injected by the caller (the TUI
+ * passes `homedir()`; the web/server passes the engine's reported home or
+ * nothing). When `home` is absent, paths are shown verbatim (no `~` fold) —
+ * the browser-safe degradation.
+ */
+/** Read a string property from an unknown JSON args bag, or "" if absent. */
+function s(args, key) {
+    if (args && typeof args === "object" && key in args) {
+        const v = args[key];
+        if (typeof v === "string")
+            return v;
+        if (typeof v === "number" || typeof v === "boolean")
+            return String(v);
+    }
+    return "";
+}
+/** Collapse a leading home-dir to `~`. `home` is injected by the caller; when
+ *  absent (browser/no-home) the path is returned verbatim. Handles both POSIX
+ *  (`/`) and Windows (`\`) separators after the home prefix (codex R2 NICE-8). */
+export function homeRelative(path, home) {
+    if (!path || !home)
+        return path;
+    if (path === home)
+        return "~";
+    if (path.startsWith(`${home}/`) || path.startsWith(`${home}\\`)) {
+        return `~${path.slice(home.length)}`;
+    }
+    return path;
+}
+/** Truncate a single-line value for the inline label. */
+function clip(text, max = 60) {
+    const oneLine = text.replace(/\s+/g, " ").trim();
+    return oneLine.length <= max ? oneLine : `${oneLine.slice(0, max - 1)}…`;
+}
+/** Display name for a tool: builtin names verbatim; `mcp__<server>__<tool>`
+ *  shown as `<server›>`. Edit/write get a claude-code-style verb. */
+export function toolDisplayName(name) {
+    const mcp = parseMcpName(name);
+    if (mcp)
+        return mcp.server;
+    switch (name) {
+        case "edit":
+            return "Edit";
+        case "write":
+            return "Write";
+        case "read":
+            return "Read";
+        case "bash":
+            return "Bash";
+        case "grep":
+            return "Grep";
+        case "glob":
+            return "Glob";
+        case "diff":
+            return "Diff";
+        case "web_fetch":
+            return "Fetch";
+        case "task":
+            return "Task";
+        case "lsp":
+            return "Lsp";
+        case "pty":
+            return "Pty";
+        case "memory_save":
+            return "Memory";
+        case "memory_delete":
+            return "Memory";
+        case "memory_list":
+            return "Memory";
+        default:
+            return name;
+    }
+}
+/** `mcp__<server>__<tool>` → `{server, tool}`; null for non-MCP or malformed
+ *  names (empty server — codex R2 NICE-9). A `mcp__<server>` with no `__tool`
+ *  is allowed (server-level), but an empty server component is rejected. */
+export function parseMcpName(name) {
+    if (!name.startsWith("mcp__"))
+        return null;
+    const rest = name.slice("mcp__".length);
+    const sep = rest.indexOf("__");
+    const server = sep < 0 ? rest : rest.slice(0, sep);
+    if (server.length === 0)
+        return null;
+    return { server, tool: sep < 0 ? "" : rest.slice(sep + 2) };
+}
+/**
+ * The parenthesized argument summary for the header. Empty string ⇒ the header
+ * renders just `⏺ Name` with no parens.
+ */
+export function formatToolCall(name, args, opts) {
+    const home = opts?.home;
+    const rel = (p) => homeRelative(p, home);
+    const mcp = parseMcpName(name);
+    if (mcp)
+        return mcp.tool;
+    switch (name) {
+        case "read":
+        case "edit":
+        case "write":
+        case "diff":
+            return clip(rel(s(args, "path")));
+        case "bash": {
+            const desc = s(args, "description");
+            return clip(desc || s(args, "command"));
+        }
+        case "grep": {
+            const pattern = s(args, "pattern");
+            const path = s(args, "path");
+            return clip(path ? `${pattern} in ${rel(path)}` : pattern);
+        }
+        case "glob": {
+            const pattern = s(args, "pattern");
+            const path = s(args, "path");
+            return clip(path ? `${pattern} in ${rel(path)}` : pattern);
+        }
+        case "web_fetch":
+            return clip(s(args, "url"));
+        case "task": {
+            const sub = s(args, "subagent_type");
+            const desc = s(args, "description");
+            return clip([sub, desc].filter(Boolean).join(": ") || desc || sub);
+        }
+        case "lsp": {
+            const op = s(args, "op");
+            const path = s(args, "path");
+            const query = s(args, "query");
+            const detail = path ? rel(path) : query;
+            return clip([op, detail].filter(Boolean).join(" "));
+        }
+        case "pty": {
+            const op = s(args, "op");
+            const cmd = s(args, "command");
+            return clip([op, cmd].filter(Boolean).join(" "));
+        }
+        case "memory_save":
+        case "memory_delete":
+            return clip(s(args, "name"));
+        case "memory_list":
+            return clip(s(args, "scope"));
+        default:
+            return compactArgs(args);
+    }
+}
+/** Fallback for unknown tools: a compact `key=value` join of scalar args. */
+function compactArgs(args) {
+    if (!args || typeof args !== "object")
+        return "";
+    const parts = [];
+    for (const [k, v] of Object.entries(args)) {
+        if (v === null || v === undefined)
+            continue;
+        if (typeof v === "object")
+            continue; // skip nested for a one-liner
+        parts.push(`${k}=${String(v)}`);
+        if (parts.length >= 3)
+            break;
+    }
+    return clip(parts.join(" "));
+}
+//# sourceMappingURL=tool-line.js.map

package/dist/tool-line.js.map

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

package/dist/view-model.d.ts

@@ -0,0 +1,233 @@
+import type { ApprovalMode, ApprovalState } from "@chances-ai/runtime";
+import type { AppEventBus } from "./event-bus.js";
+import type { AuthorizationDecision, PermissionDecision, PermissionRequest, QuestionDecision } from "@chances-ai/tools";
+import { type FrameScheduler } from "./frame-scheduler.js";
+/** (5.9) Extract the `linesDiff` block (from the first `@@ -d` hunk header to
+ *  the end) out of a write/edit permission summary, or null when the summary
+ *  carries no diff (single-line edits, "diff preview skipped", non-write tools). */
+export declare function extractDiff(summary: string): string | null;
+export type LineKind = "user" | "assistant" | "tool" | "error" | "info";
+export interface Line {
+    kind: LineKind;
+    /** user/assistant/info/error body — OR, for a `tool` line, the pure arg
+     *  summary from `formatToolCall`. */
+    text: string;
+    /** `tool`: undefined while running, then the result's ok/err. */
+    ok?: boolean;
+    /** `tool`: raw tool name (drives the ⏺ header + display-name mapping). */
+    toolName?: string;
+    /** `tool`: correlates the call / permission / result bus events. */
+    callId?: string;
+    /** `tool`: result preview shown under the ⎿ branch. */
+    result?: string;
+    /** `tool`: raw `linesDiff` text for write/edit, rendered under ⎿ (5.9). */
+    diff?: string;
+    /** `tool`: whether `diff` is whole-file-anchored (write) vs snippet (edit). */
+    anchored?: boolean;
+}
+interface Pending {
+    req: PermissionRequest;
+    resolve: (decision: PermissionDecision) => void;
+}
+export interface ChatViewModelOptions {
+    /** (5.8) Injectable frame coalescer. Production uses the default ~16 ms
+     *  `setTimeout` batcher; tests inject a manual queue for determinism. */
+    scheduler?: FrameScheduler;
+    /** (5.8) See `config.tui.toolResultPreviewLines`. Default 12. */
+    toolResultPreviewLines?: number;
+    /** (v17) Home dir for `~`-folding tool-call paths. Injected — the TUI passes
+     *  `homedir()`, a browser client passes the engine-reported home or nothing
+     *  (absent ⇒ paths shown verbatim). Keeps `view-model` free of `node:os`. */
+    home?: string;
+}
+/**
+ * Observable view-model. The Ink tree subscribes via useSyncExternalStore and
+ * never touches domain objects directly — the only inputs are bus events and the
+ * permission resolver. This is the seam that keeps the UI decoupled from core.
+ *
+ * (5.8) Rendering is split into a committed prefix (frozen scrollback fed to
+ * Ink `<Static>`, rendered once) and a small live tail (re-rendered each
+ * frame). Streamed `assistant:delta` re-renders are coalesced to one per frame
+ * via {@link FrameScheduler}; every structural event force-flushes immediately.
+ */
+export declare class ChatViewModel {
+    private readonly approval?;
+    lines: Line[];
+    busy: boolean;
+    pending: Pending | null;
+    /** (5.3) True while the Shift+Tab-into-yolo confirmation overlay is up.
+     *  app.tsx renders the red confirm box; `resolveYoloConfirm` clears it. */
+    yoloConfirmPending: boolean;
+    /**
+     * (5.8) Count of leading `lines` that are committed (frozen). Lines
+     * `[0, committedCount)` are append-only — an index's content never changes
+     * once committed — and feed Ink `<Static>`. Lines `[committedCount, end)`
+     * are the live tail. Advanced ONLY forward (monotonic) so `<Static>` never
+     * has to un-render anything. The only line that ever mutates in place is an
+     * open assistant line (text grows per delta) and it is always live.
+     */
+    committedCount: number;
+    /**
+     * (5.8) Bumped by `clearLines()` and used as the Ink `<Static key>`. Ink
+     * `<Static>` can't be emptied by replacing its items, so `/clear` remounts
+     * it under a fresh key (needs `ink >= 7.0.3`, which fixes the
+     * remount-with-different-key drop-new-items bug).
+     */
+    clearGeneration: number;
+    private version;
+    private readonly listeners;
+    private assistantOpen;
+    private busUnsubscribers;
+    private readonly scheduler;
+    private readonly toolResultPreviewLines;
+    /** (v17) Injected home dir for `~`-folding; undefined ⇒ no fold. */
+    private readonly home?;
+    /** Non-null while a coalesced delta frame is queued (see `scheduleBump`). */
+    private pendingFrame;
+    /**
+     * (5.9) Diff blocks parsed from `tool:permission` summaries, keyed by callId,
+     * awaiting their `tool:result` so they can be attached to the tool line and
+     * rendered under the `⎿` branch. Emitted before `gate.evaluate` for every
+     * write/edit call (engine.ts:763) — so this populates even under
+     * auto-edit/yolo, giving transcript diffs in all approval modes with zero
+     * engine/contract change. Cleared on detach/clear so it can't leak.
+     */
+    private readonly diffStash;
+    /**
+     * (5.3) Optional session approval-mode holder. When wired (interactive
+     * `chat`), the footer reflects `approvalMode` and Shift+Tab / `/approval`
+     * mutate it. Left undefined in tests that don't exercise modes — every
+     * approval method then no-ops and `approvalMode` reads `"default"`.
+     *
+     * (5.8) `options` injects the frame scheduler + tool-result preview length;
+     * both default so existing callers (`new ChatViewModel()`,
+     * `new ChatViewModel(approval)`) keep working unchanged.
+     */
+    constructor(approval?: ApprovalState | undefined, options?: ChatViewModelOptions);
+    subscribe: (fn: () => void) => (() => void);
+    getSnapshot: () => number;
+    /**
+     * (5.8) The frozen scrollback prefix — fed to Ink `<Static>` and rendered
+     * once. Guaranteed append-only: the element at index `i` never changes once
+     * it appears here. A fresh array is returned each call, but the prefix
+     * content is stable, which is all `<Static>` relies on.
+     */
+    committedLines(): Line[];
+    /** (5.8) The live tail re-rendered each frame: the open assistant line while
+     *  streaming, or an in-flight tool / tool-result line awaiting its terminal
+     *  event. Usually 0–1 entries. */
+    liveLines(): Line[];
+    /** (5.9) The still-live `tool` line for a callId (normally the last line).
+     *  Returns a mutable ref so `tool:result` can fill it in place — safe because
+     *  it is in the live region (index ≥ committedCount), not yet committed. */
+    private findLiveTool;
+    /**
+     * (5.9 codex R2 MUST-1) Advance `committedCount` toward `target` but NEVER
+     * past the earliest still-running tool line (`kind:"tool"` with `ok ===
+     * undefined`). A sync/background subagent emits its own `tool:call` /
+     * `assistant:delta` frames on the SAME bus BETWEEN a parent `task` tool's
+     * call and its result; without this clamp those frames would commit the
+     * parent's tool line, after which `findLiveTool` could no longer fill it
+     * (mutating a committed line breaks the `<Static>` append-only invariant) and
+     * the parent result would spawn a duplicate empty block. Keeping every
+     * unresolved tool line live until its result arrives makes the fill always
+     * append-only-safe. `turn:end` force-commits unconditionally (the turn is
+     * over). Monotonic: `target ≥ committedCount`, and the result is in
+     * `[committedCount, target]`.
+     */
+    private commitThrough;
+    private bump;
+    /**
+     * (5.8) Coalesce a streamed-token re-render onto the next frame. The first
+     * delta in a window arms the scheduler; later deltas in the same window are
+     * no-ops (the text is already accumulated on the line), so N tokens cause
+     * at most one render per frame instead of N.
+     */
+    private scheduleBump;
+    /** (5.8) Drop a queued delta frame if one is pending. */
+    private cancelPendingBump;
+    /**
+     * (5.8) Immediate notify that first drops any pending coalesced delta frame.
+     * Used by every structural mutation (finished message, tool call/result,
+     * turn boundary, user action) so the UI never renders a structural change
+     * behind a stale token-stream frame, and a cancelled frame can't fire into a
+     * later epoch.
+     */
+    private forceFlush;
+    /**
+     * Push a standalone, immutable line and commit everything (it and any prior
+     * live tail are terminal-on-creation).
+     *
+     * Closing `assistantOpen` here means a standalone line pushed while a stream
+     * is open ends that stream: the next `assistant:delta` opens a FRESH line
+     * rather than appending to the committed one — so the committed line is
+     * genuinely final (append-only holds; see the interleaving regression test).
+     * That a mid-stream user submit / mode-cycle visually splits the assistant
+     * message is a pre-existing interaction behavior (NOT a v13 regression — the
+     * pre-v13 `pushUser` closed the stream the same way); richer mid-turn input
+     * handling (queueing) is a v15 interaction-model concern, out of v13 scope.
+     */
+    private pushCommitted;
+    pushUser(text: string): void;
+    pushInfo(text: string): void;
+    pushError(text: string): void;
+    /** Empties the rendered scrollback — used by `/clear` so the user sees a
+     * fresh view alongside the session.clearTurns() that drops the conversation
+     * history. The view-model and the underlying session are intentionally
+     * separate operations; the slash command sequences both.
+     *
+     * (5.8) Because Ink `<Static>` keeps everything ever handed to it, emptying
+     * `lines` is not enough — `clearGeneration` is bumped so app.tsx can remount
+     * `<Static>` under a fresh key. Any pending delta frame is dropped so it
+     * can't fire into the cleared epoch. */
+    clearLines(): void;
+    attach(bus: AppEventBus): void;
+    /**
+     * (3.4 — codex Round-2 MUST-FIX #2) Once a VM is detached (engine
+     * respawn via `/resume`, `/clear` shouldn't detach but if a future
+     * caller does), any in-flight `requestPermission` is rejected with
+     * a synthetic "denied" decision so the closing-over-stale-resolver
+     * call sites (notably the background-task child engine that holds
+     * `deps.gate` from before the respawn) don't hang waiting for a
+     * prompt that will never reach a user. Any *future* call to
+     * `requestPermission` on this detached VM short-circuits the same
+     * way — same reasoning.
+     *
+     * (5.8) Also drops any pending coalesced frame so a scheduled bump
+     * can't fire into a remounted/stale epoch.
+     */
+    detach(): void;
+    private detached;
+    /** Returned to the PermissionGate as its resolver. After `detach()`,
+     * any call resolves denied synchronously — see `detach()` docstring. */
+    requestPermission: (req: PermissionRequest) => Promise<PermissionDecision>;
+    /**
+     * (5.3) Resolve the open permission prompt with a full decision:
+     *   - `{allow:true}` — approve once (not remembered).
+     *   - `{allow:true, remember:true}` — approve & don't ask again (the gate
+     *     caches it even for un-scoped tools like file-write).
+     *   - `{allow:false}` — plain deny.
+     *   - `{allow:false, feedback}` — deny + relay the user's note to the model.
+     */
+    resolvePermission(decision: AuthorizationDecision): void;
+    /**
+     * (5.10b) Resolve an open QUESTION prompt with the user's answers (or a
+     * decline). Mirrors {@link resolvePermission} for the `question` pending
+     * variant — the `ask_user_question` tool turns the decision into the
+     * model-facing tool result.
+     */
+    resolveQuestion(decision: QuestionDecision): void;
+    /** The current session approval mode (`"default"` when unwired). */
+    get approvalMode(): ApprovalMode;
+    /**
+     * Shift+Tab handler. Advances the cycle; cycling INTO `yolo` without a prior
+     * confirmation opens the confirm overlay instead of switching (the typed
+     * `/approval yolo` path counts as consent and skips this — see
+     * `setApprovalMode`).
+     */
+    cycleApprovalMode(): void;
+    /** Resolve the yolo confirm overlay. `confirm` latches yolo for the session. */
+    resolveYoloConfirm(confirm: boolean): void;
+}
+export {};
+//# sourceMappingURL=view-model.d.ts.map

package/dist/view-model.d.ts.map

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