@chances-ai/tui 16.0.0 → 18.0.0

package/dist/view-model.d.ts

@@ -1,226 +0,0 @@
-import type { ApprovalMode, ApprovalState, EventBus } from "@chances-ai/runtime";
-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;
-}
-/**
- * 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;
-    /** 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: EventBus): 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

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