@vincemakes/kiso-code 0.1.30 → 0.1.32

package/dist/editor.js

@@ -1,444 +0,0 @@
-/**
- * v2c — the raw-mode single-line editor that REPLACES readline on the TTY
- * path. Root cause of the v2b drift (plan 2026-08-05-tui-v2b §11): readline
- * re-renders its line by CHARACTER count and assumes it owns the row
- * exclusively — a CJK wide character (2 cells) shifts every following
- * column, and the dock's redraws make the mismatch permanent. Patching
- * readline is a dead end; the TTY path draws its own input row instead.
- * Non-TTY paths keep readline untouched (pipe bytes unchanged).
- *
- * Zero dependencies. The eastAsianWidth table is a ~40-line subset (CJK
- * ideographs/kana/hangul/fullwidth/common wide symbols = 2, everything
- * else = 1). Known limitation, documented in the README: emoji ZWJ
- * clusters (family emoji etc.) are not guaranteed perfect — each code
- * point counts as its width.
- *
- * The editor is a SINGLE line: bracketed paste (?2004h) unwraps and
- * inserts, internal newlines become spaces.
- */
-/** A code point's display width: 2 for the wide ranges, 1 otherwise. */
-export function charWidth(cp) {
-    if (cp >= 0x1100 && cp <= 0x115f)
-        return 2; // hangul jamo
-    if (cp >= 0x2e80 && cp <= 0x303e)
-        return 2; // radicals .. CJK punctuation
-    if (cp >= 0x3041 && cp <= 0x33ff)
-        return 2; // kana, CJK compat
-    if (cp >= 0x3400 && cp <= 0x4dbf)
-        return 2; // CJK ext A
-    if (cp >= 0x4e00 && cp <= 0x9fff)
-        return 2; // CJK unified
-    if (cp >= 0xa000 && cp <= 0xa4cf)
-        return 2; // yi
-    if (cp >= 0xa960 && cp <= 0xa97f)
-        return 2; // hangul jamo ext
-    if (cp >= 0xac00 && cp <= 0xd7a3)
-        return 2; // hangul syllables
-    if (cp >= 0xf900 && cp <= 0xfaff)
-        return 2; // CJK compat ideographs
-    if (cp >= 0xfe10 && cp <= 0xfe19)
-        return 2; // vertical forms
-    if (cp >= 0xfe30 && cp <= 0xfe6f)
-        return 2; // CJK compat forms
-    if (cp >= 0xff00 && cp <= 0xff60)
-        return 2; // fullwidth forms
-    if (cp >= 0xffe0 && cp <= 0xffe6)
-        return 2; // fullwidth signs
-    if (cp >= 0x1f300 && cp <= 0x1f64f)
-        return 2; // emoji (misc + emoticons)
-    if (cp >= 0x1f900 && cp <= 0x1f9ff)
-        return 2; // supplemental emoji
-    if (cp >= 0x20000 && cp <= 0x3fffd)
-        return 2; // CJK ext B..G
-    return 1;
-}
-/** Display width of a code-point array (cursor math, scrolling). */
-export function widthOf(chars) {
-    let w = 0;
-    for (const cp of chars)
-        w += charWidth(cp);
-    return w;
-}
-/** Display width of a string. */
-export function displayWidth(text) {
-    let w = 0;
-    for (const ch of text)
-        w += charWidth(ch.codePointAt(0));
-    return w;
-}
-import { palette } from "./render.js";
-export const PROMPT = "▌you> "; // the kiso brick motif: one blue half-block, then you>
-export const PROMPT_WIDTH = displayWidth(PROMPT);
-export const MENU_ITEMS = [
-    { name: "/mode", desc: "switch the approval tier (manual/default/accept-edits/plan/bypass)" },
-    { name: "/think", desc: "show the last full thinking block" },
-    { name: "/last", desc: "show the most recent tool call's input and output" },
-    { name: "/status", desc: "show session id, event count, and context estimate" },
-    { name: "/help", desc: "print this list of commands" },
-];
-/**
- * The editor. Raw mode + bracketed paste (?2004h) on enter, restored on
- * exit. The input row is rendered by `onRender` (the CLI wires it to the
- * dock's redraw when docked, the editor's own self-render otherwise) —
- * the editor itself never writes while docked. The event handlers are
- * settable — the chat/resume contexts wire them after construction.
- */
-export class Editor {
-    #chars = [];
-    #cursor = 0;
-    #scroll = 0; // chars scrolled off the left (width-based reflow)
-    #questionCb = null;
-    #pasting = false;
-    #lineCb = null;
-    #pendingLines = []; // submits before onLine is wired (startup) — never dropped
-    #sigintCb = null;
-    #eotCb = null;
-    #escapeCb = null;
-    #onRender;
-    #menuOpen = false; // v3 §04: the slash-command menu
-    #menuSel = 0;
-    #pending = ""; // an incomplete ESC/CSI prefix across chunks
-    #decoder = new TextDecoder();
-    #entered = false;
-    #onData;
-    #closedResolve;
-    closed;
-    constructor(onRender) {
-        this.#onRender = onRender;
-        this.#onData = (raw) => this.feed(raw);
-        this.closed = new Promise((resolve) => {
-            this.#closedResolve = resolve;
-        });
-    }
-    onLine(cb) {
-        this.#lineCb = cb;
-        // Flush submits that arrived before the handler was wired (typed
-        // during startup) — readline buffered these; the editor must too.
-        for (const line of this.#pendingLines)
-            cb(line);
-        this.#pendingLines.length = 0;
-    }
-    onSigint(cb) {
-        this.#sigintCb = cb;
-    }
-    onEot(cb) {
-        this.#eotCb = cb;
-    }
-    onEscape(cb) {
-        this.#escapeCb = cb;
-    }
-    /** The whole buffer as text (the CLI's line()/clearLine()). */
-    line() {
-        return String.fromCodePoint(...this.#chars);
-    }
-    clearLine() {
-        this.#chars = [];
-        this.#cursor = 0;
-        this.#scroll = 0;
-        this.#onRender();
-    }
-    /** The visible slice (dim "…" prefix when scrolled) + the cursor's
-     *  display column within it — the dock's input-row state. */
-    dockState() {
-        const visible = String.fromCodePoint(...this.#chars.slice(this.#scroll));
-        const prefix = this.#scroll > 0 ? "\x1b[2m…\x1b[0m" : "";
-        const col = (this.#scroll > 0 ? 1 : 0) + widthOf(this.#chars.slice(this.#scroll, this.#cursor));
-        return { line: `${prefix}${visible}`, cursor: col };
-    }
-    /** v3 §04: the menu's visible state for the dock — null when closed. */
-    menuState() {
-        if (!this.#menuOpen)
-            return null;
-        return { items: this.#menuFiltered(), selected: this.#menuSel };
-    }
-    /** v3 §04: the filtered command list for the current buffer — open
-     *  only while the line is "/" + something (a bare "/" waits). */
-    #menuFiltered() {
-        const line = this.line();
-        if (!line.startsWith("/") || line === "/")
-            return [];
-        return MENU_ITEMS.filter((m) => m.name.startsWith(line));
-    }
-    #refreshMenu() {
-        const f = this.#menuFiltered();
-        this.#menuOpen = f.length > 0;
-        if (this.#menuSel >= f.length)
-            this.#menuSel = 0;
-        this.#onRender();
-    }
-    /** One-shot question mode: the NEXT submit answers, not a turn. */
-    question(_query, cb) {
-        this.#questionCb = cb;
-    }
-    /** Cancel a pending question — the buffer stays (its text becomes the
-     *  next turn on Enter, the readline re-emit equivalent). */
-    cancelQuestion() {
-        this.#questionCb = null;
-    }
-    enter() {
-        if (this.#entered)
-            return;
-        this.#entered = true;
-        process.stdin.setRawMode(true);
-        process.stdout.write("\x1b[?2004h"); // bracketed paste ON
-        process.stdin.on("data", this.#onData);
-        this.#onRender();
-    }
-    exit() {
-        if (!this.#entered)
-            return;
-        this.#entered = false;
-        process.stdin.off("data", this.#onData);
-        process.stdout.write("\x1b[?2004l"); // bracketed paste OFF
-        process.stdin.setRawMode(false);
-        this.#closedResolve();
-    }
-    /** The row's own render when the dock is inactive (a TTY without a
-     *  real size): \r + clear + blue brick prompt + visible + cursor
-     *  column. */
-    selfRender() {
-        const p = palette();
-        const st = this.dockState();
-        const W = (process.stdout.columns ?? 0) || 80; // a degenerate 0 size (no TIOCSWINSZ) falls back
-        const cursorCol = Math.min(1 + PROMPT_WIDTH + st.cursor, W);
-        process.stdout.write(`\r\x1b[0K${p.blue}${PROMPT}${p.reset}${st.line}\x1b[${cursorCol}G`);
-    }
-    // ---- input ----
-    /** Feed raw stdin bytes — the parser. Public for unit tests. */
-    feed(raw) {
-        const text = this.#pending + this.#decoder.decode(raw, { stream: true });
-        this.#pending = "";
-        let i = 0;
-        while (i < text.length) {
-            const c = text[i];
-            if (c === "\x1b") {
-                const rest = text.slice(i + 1);
-                if (rest.startsWith("[")) {
-                    const m = rest.match(/^\[([0-9;?]*)([A-Za-z~])/);
-                    if (m === null) {
-                        this.#pending = text.slice(i); // incomplete CSI — wait for more
-                        break;
-                    }
-                    this.#csi(m[1], m[2]);
-                    i += m[0].length + 1;
-                }
-                else if (rest.startsWith("O")) {
-                    i += 3; // SS3 (function keys) — ignored
-                }
-                else if (this.#menuOpen) {
-                    // v3 §04: Esc closes the menu and clears the buffer.
-                    this.#chars = [];
-                    this.#cursor = 0;
-                    this.#scroll = 0;
-                    this.#refreshMenu();
-                }
-                else {
-                    this.#escapeCb?.();
-                    i += 1;
-                }
-            }
-            else if (c === "\x0d" || c === "\x0a") {
-                if (this.#pasting) {
-                    this.#insert(0x20); // single-line editor: newlines become spaces
-                }
-                else {
-                    this.#submit();
-                }
-                i += 1;
-            }
-            else if (c === "\x7f" || c === "\x08") {
-                this.#backspace();
-                i += 1;
-            }
-            else if (c === "\x03") {
-                this.#sigintCb?.();
-                i += 1;
-            }
-            else if (c === "\x04") {
-                this.#eotCb?.();
-                i += 1;
-            }
-            else if (c === "\x15") {
-                this.#killToStart();
-                i += 1;
-            }
-            else if (c === "\x0b") {
-                this.#killToEnd();
-                i += 1;
-            }
-            else if (c === "\x17") {
-                this.#killWord();
-                i += 1;
-            }
-            else if (c === "\x01") {
-                this.#cursor = 0;
-                this.#reflow();
-                this.#onRender();
-                i += 1;
-            }
-            else if (c === "\x05") {
-                this.#cursor = this.#chars.length;
-                this.#reflow();
-                this.#onRender();
-                i += 1;
-            }
-            else if (c === "\t" && this.#menuOpen) {
-                // v3 §04: Tab completes the buffer to the selected command.
-                const f = this.#menuFiltered();
-                const m = f[this.#menuSel];
-                if (m !== undefined) {
-                    this.#chars = [...m.name].map((ch) => ch.codePointAt(0));
-                    this.#cursor = this.#chars.length;
-                    this.#reflow();
-                    this.#refreshMenu();
-                }
-                i += 1;
-            }
-            else if (c !== undefined && c < " ") {
-                i += 1; // other control — ignored
-            }
-            else {
-                this.#insert(text.codePointAt(i));
-                i += c.length;
-            }
-        }
-    }
-    #csi(params, final) {
-        if (final === "~") {
-            const n = Number(params);
-            if (n === 3)
-                this.#delete();
-            else if (n === 200)
-                this.#pasting = true;
-            else if (n === 201) {
-                this.#pasting = false;
-                this.#onRender();
-            }
-        }
-        else if (final === "A" && this.#menuOpen) {
-            // v3 §04: ↑↓ move the menu selection, never the cursor.
-            this.#menuSel = Math.max(0, this.#menuSel - 1);
-            this.#onRender();
-        }
-        else if (final === "B" && this.#menuOpen) {
-            this.#menuSel = Math.min(this.#menuFiltered().length - 1, this.#menuSel + 1);
-            this.#onRender();
-        }
-        else if (final === "D") {
-            this.#move(-1);
-        }
-        else if (final === "C") {
-            this.#move(1);
-        }
-        else if (final === "H") {
-            this.#cursor = 0;
-            this.#reflow();
-        }
-        else if (final === "F") {
-            this.#cursor = this.#chars.length;
-            this.#reflow();
-        }
-    }
-    // ---- editing ----
-    #insert(cp) {
-        this.#chars.splice(this.#cursor, 0, cp);
-        this.#cursor += 1;
-        this.#reflow();
-        if (!this.#pasting)
-            this.#refreshMenu();
-    }
-    #backspace() {
-        if (this.#cursor === 0)
-            return;
-        this.#chars.splice(this.#cursor - 1, 1);
-        this.#cursor -= 1;
-        this.#reflow();
-        if (!this.#pasting)
-            this.#refreshMenu();
-    }
-    #delete() {
-        if (this.#cursor >= this.#chars.length)
-            return;
-        this.#chars.splice(this.#cursor, 1);
-        this.#reflow();
-        if (!this.#pasting)
-            this.#refreshMenu();
-    }
-    #move(delta) {
-        this.#cursor = Math.max(0, Math.min(this.#chars.length, this.#cursor + delta));
-        this.#reflow();
-        if (!this.#pasting)
-            this.#onRender();
-    }
-    #killToStart() {
-        this.#chars.splice(0, this.#cursor);
-        this.#cursor = 0;
-        this.#reflow();
-        if (!this.#pasting)
-            this.#onRender();
-    }
-    #killToEnd() {
-        this.#chars.length = this.#cursor;
-        this.#reflow();
-        if (!this.#pasting)
-            this.#onRender();
-    }
-    #killWord() {
-        let i = this.#cursor;
-        while (i > 0 && this.#chars[i - 1] === 0x20)
-            i -= 1; // trailing spaces
-        while (i > 0 && this.#chars[i - 1] !== 0x20)
-            i -= 1; // the word
-        this.#chars.splice(i, this.#cursor - i);
-        this.#cursor = i;
-        this.#reflow();
-    }
-    #submit() {
-        let line = String.fromCodePoint(...this.#chars);
-        if (this.#menuOpen) {
-            // v3 §04: Enter submits the SELECTED command.
-            const m = this.#menuFiltered()[this.#menuSel];
-            if (m !== undefined)
-                line = m.name;
-        }
-        this.#chars = [];
-        this.#cursor = 0;
-        this.#scroll = 0;
-        this.#menuOpen = false;
-        this.#menuSel = 0;
-        const cb = this.#questionCb;
-        this.#questionCb = null;
-        if (cb !== null) {
-            cb(line);
-        }
-        else if (this.#lineCb !== null) {
-            this.#lineCb(line);
-        }
-        else {
-            this.#pendingLines.push(line); // nobody wired yet — hold it
-        }
-        this.#onRender();
-    }
-    // ---- width-based horizontal scroll ----
-    #reflow() {
-        const W = (process.stdout.columns ?? 0) || 80; // degenerate 0 falls back to 80
-        const maxW = Math.max(1, W - PROMPT_WIDTH - 1); // 1 col for the "…"
-        const curCol = widthOf(this.#chars.slice(0, this.#cursor));
-        const scrolledW = widthOf(this.#chars.slice(0, this.#scroll));
-        if (curCol < scrolledW) {
-            this.#scroll = this.#indexAtWidth(curCol);
-        }
-        else if (curCol >= scrolledW + maxW) {
-            this.#scroll = this.#indexAtWidth(Math.max(0, curCol - maxW + 1));
-        }
-    }
-    #indexAtWidth(target) {
-        let w = 0;
-        for (let i = 0; i < this.#chars.length; i += 1) {
-            if (w >= target)
-                return i;
-            w += charWidth(this.#chars[i]);
-        }
-        return this.#chars.length;
-    }
-}

package/dist/render.d.ts

@@ -1,135 +0,0 @@
-/**
- * Event rendering for the terminal. Pure (testable): given events, produce
- * the lines a human sees. Colors are raw ANSI — no dependencies.
- */
-import type { Event } from "@vincemakes/kiso-core";
-import { canonicalTargetPath } from "@vincemakes/kiso-tools-node";
-/**
- * v2a — the palette, centralized (no hard-coded codes elsewhere): ONE
- * accent — blue, ANSI 256 color 75 — for the identity accents (the you>
- * prompt, the banner tagline, ✓ marks, slash-command names); red for
- * errors; dim for metadata. NO_COLOR set, or a non-TTY output → every
- * code is empty, so pipes and CI carry ZERO ANSI (the existing byte-level
- * e2e assertions guard it). Everything not listed here is plain.
- * v3: `bg` — the user-message block background (SGR 48, dark gray 237).
- */
-export interface Palette {
-    readonly blue: string;
-    readonly dim: string;
-    readonly red: string;
-    readonly green: string;
-    readonly bg: string;
-    readonly reset: string;
-}
-export declare const COLOR_ON: Palette;
-export declare const COLOR_OFF: Palette;
-export declare function palette(): Palette;
-/**
- * E 组/八: strip terminal-injection vectors from MODEL/TOOL text before it
- * reaches the terminal — ESC, C0 (except \t \n), C1, CR, backspace, and
- * bidi overrides. The kiso colors are applied by render, not by the data.
- * EVERY externally-sourced string must pass through this before any output.
- */
-export declare function escapeTerminal(text: string): string;
-/**
- * 八/十: the path the human is asked to approve is the CANONICAL one the
- * tool will actually touch — the tools' OWN resolution (deepest existing
- * ancestor realpath'd, the not-yet-existing tail re-appended), so a file
- * to be created under a symlinked directory shows the REAL target, and
- * the UI and the tool share ONE resolution (canonicalTargetPath).
- */
-export declare const canonicalPath: typeof canonicalTargetPath;
-export interface RenderResult {
-    readonly text: string;
-    readonly newline: boolean;
-    readonly prompt: boolean;
-}
-/**
- * Render one event. `text` may be a continuation (text_delta appends to the
- * current line); `newline` says whether the line is complete.
- *
- * 自举 P1: `prevThinking` marks a thinking delta that continues the SAME
- * block — it renders appended to the segment, without the … prefix. The
- * consumer closes the segment with a newline at the next non-thinking
- * event.
- */
-/**
- * v2b — one thinking BLOCK folds to ONE dim line: the first 100 chars, a
- * " (… /think shows full)" marker when the block is longer. The consumer
- * buffers the block's deltas, renders this at the block's end, and keeps
- * the full text for /think. Pipes get the same fold — the content
- * strategy is presentation-independent.
- */
-export declare function foldThinking(block: string): string;
-/** v2b — the [result] echo truncates at 160 chars + a /last hint. */
-export declare function foldResult(content: string): string;
-export declare function renderEvent(ev: Event, prevThinking?: boolean): RenderResult;
-/**
- * B 区: one-line summary of a completed tool call, e.g.
- *   ✓ edit src/foo.ts (+12 -3)    ✓ read src/bar.ts (140 lines)
- *   ✗ shell npm test (exit 1)
- * edit/write show +/- line counts, read shows lines, shell shows the exit
- * code; failures (isError) are ✗. Pure and deterministic.
- */
-export declare function renderToolSummary(name: string, input: Record<string, unknown>, result: {
-    content: string;
-    isError: boolean;
-}): string;
-/** k-units for the status line: 12345 → 12.3k, 800 → 800, null → ?. */
-export declare function kUnit(value: number | null): string;
-/** B 区: usage data gathered from the run's usage events. */
-export interface RunUsage {
-    readonly in: number | null;
-    readonly out: number | null;
-    readonly cache: number | null;
-    readonly known: boolean;
-}
-/**
- * B 区/v2a: the one-line status bar after a terminal, e.g.
- *   [turn 3 · in 12.4k out 1.8k · cache 9.2k · ctx ~14%]
- * 降噪: unknown fields are OMITTED ENTIRELY (有什么显什么); a fully unknown
- * usage → null (the caller prints nothing); faux mode → [turn N · faux].
- * All data comes from usage events; ctx is the approximate estimate
- * passed in (chars/4 vs the window), marked with ~.
- */
-export declare function renderStatusLine(turn: number, usage: RunUsage, ctxRatio: number, faux?: boolean): string | null;
-/**
- * v2a rhythm — the exact bytes after a terminal event: the status line
- * hugs the terminal (有什么显什么 — omitted when there is nothing to show),
- * then EXACTLY one blank line before the next prompt. The consumer prints
- * this verbatim; the render tests pin the sequence.
- */
-export declare function renderTerminalGap(statusLine: string | null): string;
-/**
- * v3 §01 — the banner, block-split. The logo is three INDEPENDENT rows
- * (TOP / the tagline / BOTTOM), then TWO info rows (version,
- * extensions). Every row truncates at the terminal width with a " (+N)"
- * marker (N = the hidden display width); a window narrower than 40
- * columns skips the logo entirely — only the info rows. Pure.
- */
-export declare const TAGLINE = "the coding agent that survives kill -9";
-/** v3 §01: truncate a row at `width`, marking the hidden span " (+N)". */
-export declare function truncateRow(row: string, width: number): string;
-/** v3 §01: the banner lines for a width W — logo (skipped under 40
- *  columns) + version + extensions. */
-export declare function bannerLines(W: number, version: string, extensionsText: string): string[];
-/** v3 §02 — the recap line that ends a run, replacing the "done" label +
- *  the old status line. All fields derive LOCALLY from the event stream
- *  (zero tokens): wall seconds, tool counts, usage, cache hit %, ctx left.
- */
-export interface RecapStats {
-    readonly seconds: number;
-    readonly tools: number;
-    readonly edits: number;
-    readonly usage: RunUsage;
-    readonly ctxLeftPct: number | null;
-}
-export declare function renderRecap(s: RecapStats): string;
-/** One-line summary of a session, for `kiso sessions`. */
-export declare function renderSessionLine(meta: {
-    id: string;
-    title: string;
-    events: number;
-    runs: number;
-    updatedAt: number;
-}): string;