@vincemakes/kiso-code 0.1.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kiso contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @vincemakes/kiso-code
+
+The coding-agent reference product: kiso chat / kiso resume / kiso
+sessions. Install it or run directly with npx @vincemakes/kiso-code. Keyless faux
+mode out of the box; ANTHROPIC_API_KEY or OPENAI_API_KEY + OPENAI_BASE_URL
+switch to real providers.
+
+Requires Node >= 22. See the repository README for the framework
+overview.

package/dist/dock.d.ts

@@ -0,0 +1,55 @@
+/**
+ * v2b — the bottom-anchored UI (TTY + color only). Borrows pi-tui's IDEA —
+ * a DECSTBM scroll region with a reserved bottom — without its
+ * implementation: zero dependencies, line-level ANSI, no differential
+ * renderer.
+ *
+ * Layout (H = terminal height): rows 1..H-3 = the scroll region (the body
+ * streams and scrolls here, never touching the bottom), row H-2 = the dim
+ * separator, row H-1 = the live status bar (or a takeover question), row
+ * H = the input line (blue you> + readline). Bottom redraws are wrapped in
+ * CSI 2026 (synchronized output) to avoid flicker — the pi trick.
+ *
+ * Pipes / NO_COLOR: the dock never activates; the v2a line mode stays
+ * byte-for-byte (the existing e2e assertions guard it).
+ */
+export declare class Dock {
+    #private;
+    /** v2b: docked only on a color TTY — pipes and NO_COLOR stay v2a. */
+    get active(): boolean;
+    /** Bind the CURRENT input line's state — called when a readline takes
+     *  over (the chat REPL, the trust question's short-lived rl, resume). */
+    bindInput(state: () => {
+        line: string;
+        cursor: number;
+    }, prompt: string): void;
+    /** Enter docked mode: DECSTBM the scroll region, draw the chrome. A
+     *  TTY without a real window size (rows < 4) stays in the v2a line
+     *  mode — the bottom three rows need room to exist. */
+    enter(): void;
+    /** Teardown — CSI r resets the scroll region, the cursor lands at the
+     *  input line, the bottom rows are cleared: no broken terminal. Called
+     *  from main's finally on EVERY exit path (kill -9 excepted — README:
+     *  `reset` saves it). */
+    exit(): void;
+    /** SIGWINCH: recompute the region, redraw the chrome. */
+    onResize(): void;
+    /** Body output: position the cursor inside the scroll region at the
+     *  body's tracked position, write, and hand the cursor back to the
+     *  input line. The row/col tracking is approximate for width-wrapped
+     *  and wide-char lines (documented) — the region clamp keeps the
+     *  bottom rows safe regardless. */
+    writeBody(text: string): void;
+    /** The status bar's base text (usage, ctx, session, …). */
+    setStatus(text: string): void;
+    /** The live tail — the spinner glyph or "running <tool> Ns". */
+    setTail(tail: string): void;
+    /** Show a takeover question at the status position (answered at the
+     *  input line by the caller's readline); clearQuestion() restores. */
+    showQuestion(question: string): void;
+    clearQuestion(): void;
+    /** The bottom three rows, wrapped in CSI 2026 (synchronized output —
+     *  the pi trick against flicker). The cursor ends at the input line's
+     *  edit position. */
+    redraw(): void;
+}

package/dist/dock.js

@@ -0,0 +1,152 @@
+/**
+ * v2b — the bottom-anchored UI (TTY + color only). Borrows pi-tui's IDEA —
+ * a DECSTBM scroll region with a reserved bottom — without its
+ * implementation: zero dependencies, line-level ANSI, no differential
+ * renderer.
+ *
+ * Layout (H = terminal height): rows 1..H-3 = the scroll region (the body
+ * streams and scrolls here, never touching the bottom), row H-2 = the dim
+ * separator, row H-1 = the live status bar (or a takeover question), row
+ * H = the input line (blue you> + readline). Bottom redraws are wrapped in
+ * CSI 2026 (synchronized output) to avoid flicker — the pi trick.
+ *
+ * Pipes / NO_COLOR: the dock never activates; the v2a line mode stays
+ * byte-for-byte (the existing e2e assertions guard it).
+ */
+import { palette } from "./render.js";
+export class Dock {
+    #active = false;
+    #height = 0;
+    #width = 0;
+    #status = "";
+    #tail = ""; // the live tail: the spinner glyph or "running <tool> Ns"
+    #question = null; // a takeover question shown at H-1
+    #inputState = () => ({ line: "", cursor: 0 });
+    #inputPrompt = "";
+    #bodyRow = 1; // the body's logical row inside the scroll region
+    #bodyCol = 1; // …and column (mid-line continuations survive cursor jumps)
+    #resizeHandler = null;
+    /** v2b: docked only on a color TTY — pipes and NO_COLOR stay v2a. */
+    get active() {
+        return this.#active;
+    }
+    /** Bind the CURRENT input line's state — called when a readline takes
+     *  over (the chat REPL, the trust question's short-lived rl, resume). */
+    bindInput(state, prompt) {
+        this.#inputState = state;
+        this.#inputPrompt = prompt;
+    }
+    /** Enter docked mode: DECSTBM the scroll region, draw the chrome. A
+     *  TTY without a real window size (rows < 4) stays in the v2a line
+     *  mode — the bottom three rows need room to exist. */
+    enter() {
+        const rows = process.stdout.rows ?? 0;
+        if (process.stdout.isTTY !== true || palette().blue === "" || rows < 4)
+            return;
+        this.#active = true;
+        this.#height = rows;
+        this.#width = process.stdout.columns ?? 80;
+        this.#bodyRow = 1;
+        this.#bodyCol = 1;
+        process.stdout.write(`\x1b[1;${this.#height - 3}r`); // scroll region: top .. H-3
+        this.redraw();
+        this.#resizeHandler = () => this.onResize();
+        process.stdout.on("resize", this.#resizeHandler);
+    }
+    /** Teardown — CSI r resets the scroll region, the cursor lands at the
+     *  input line, the bottom rows are cleared: no broken terminal. Called
+     *  from main's finally on EVERY exit path (kill -9 excepted — README:
+     *  `reset` saves it). */
+    exit() {
+        if (!this.#active)
+            return;
+        this.#active = false;
+        if (this.#resizeHandler !== null) {
+            process.stdout.off("resize", this.#resizeHandler);
+            this.#resizeHandler = null;
+        }
+        const H = this.#height;
+        process.stdout.write("\x1b[r"); // reset the scroll region
+        for (let row = H - 2; row <= H; row += 1) {
+            process.stdout.write(`\x1b[${row};1H\x1b[0K`); // clear the three rows
+        }
+        process.stdout.write(`\x1b[${H};1H`);
+    }
+    /** SIGWINCH: recompute the region, redraw the chrome. */
+    onResize() {
+        if (!this.#active)
+            return;
+        this.#height = process.stdout.rows ?? this.#height;
+        this.#width = process.stdout.columns ?? this.#width;
+        process.stdout.write(`\x1b[1;${this.#height - 3}r`);
+        this.redraw();
+    }
+    /** Body output: position the cursor inside the scroll region at the
+     *  body's tracked position, write, and hand the cursor back to the
+     *  input line. The row/col tracking is approximate for width-wrapped
+     *  and wide-char lines (documented) — the region clamp keeps the
+     *  bottom rows safe regardless. */
+    writeBody(text) {
+        if (!this.#active) {
+            process.stdout.write(text);
+            return;
+        }
+        const row = Math.min(this.#bodyRow, this.#height - 3);
+        const col = this.#bodyCol > this.#width ? this.#width : this.#bodyCol;
+        process.stdout.write(`\x1b[${row};${col}H`);
+        process.stdout.write(text);
+        for (const ch of text) {
+            if (ch === "\n") {
+                this.#bodyRow += 1;
+                this.#bodyCol = 1;
+            }
+            else {
+                this.#bodyCol += 1;
+            }
+        }
+        process.stdout.write(`\x1b[${this.#height};1H`); // back to the input line
+    }
+    /** The status bar's base text (usage, ctx, session, …). */
+    setStatus(text) {
+        this.#status = text;
+        this.redraw();
+    }
+    /** The live tail — the spinner glyph or "running <tool> Ns". */
+    setTail(tail) {
+        this.#tail = tail;
+        this.redraw();
+    }
+    /** Show a takeover question at the status position (answered at the
+     *  input line by the caller's readline); clearQuestion() restores. */
+    showQuestion(question) {
+        this.#question = question;
+        this.redraw();
+    }
+    clearQuestion() {
+        this.#question = null;
+        this.redraw();
+    }
+    /** The bottom three rows, wrapped in CSI 2026 (synchronized output —
+     *  the pi trick against flicker). The cursor ends at the input line's
+     *  edit position. */
+    redraw() {
+        if (!this.#active)
+            return;
+        const p = palette();
+        const H = this.#height;
+        const W = this.#width;
+        const sep = `${p.dim}${"─".repeat(W)}${p.reset}`;
+        const status = `${this.#status}${this.#tail === "" ? "" : ` · ${this.#tail}`}`;
+        const statusLine = this.#question ?? status;
+        const inp = this.#inputState();
+        const promptWidth = this.#inputPrompt.replace(/\x1b\[[0-9;]*m/g, "").length;
+        const out = [];
+        out.push("\x1b[2026h"); // synchronized output ON
+        out.push(`\x1b[${H - 2};1H\x1b[0K${sep}`);
+        out.push(`\x1b[${H - 1};1H\x1b[0K${statusLine}`);
+        out.push(`\x1b[${H};1H\x1b[0K${this.#inputPrompt}${inp.line}`);
+        out.push(`\x1b[${H};${promptWidth + inp.cursor + 1}H`); // back to the edit position
+        out.push("\x1b[2026l"); // synchronized output OFF
+        process.stdout.write(out.join(""));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * kiso — the coding-agent reference product.
+ *
+ *   kiso chat [sessionId]   start or continue an interactive session
+ *   kiso resume <sessionId> continue a session in one-shot mode
+ *   kiso sessions           list durable sessions
+ *
+ * Provider selection (first match):
+ *   ANTHROPIC_API_KEY      → Anthropic (ANTHROPIC_MODEL, default claude-sonnet-5)
+ *   OPENAI_API_KEY         → OpenAI-compatible (OPENAI_MODEL, OPENAI_BASE_URL)
+ *   neither                → faux mode: scripted model, zero keys, full CLI
+ *
+ * Sessions live under $KISO_HOME/sessions (default ~/.kiso/sessions) as
+ * append-only JSONL. Write/edit/shell tools sit behind the approval policy:
+ * the run pauses, asks, and resumes — durably (ADR-0024).
+ */
+import { type ProjectArtifacts } from "@vincemakes/kiso-runtime";
+/**
+ * E3 — merge the project's mcp.json and skills into the env BEFORE the
+ * extension load. A server name in BOTH configs is a LOUD error (a silent
+ * override would be a supply-chain surprise); a skill name in both merges
+ * with project-wins and a stderr note. Exported for tests.
+ */
+export declare function applyProjectMerges(artifacts: ProjectArtifacts): void;
+/**
+ * A 区: read the FIRST present instruction file (AGENTS.md preferred) and
+ * return it as an injected section, or "" when none exists. Truncated at
+ * 8KB with an explicit note. Pure — read once per session, so the prompt
+ * is byte-stable for the session's lifetime.
+ */
+export declare function readProjectInstructions(cwd: string): string;
+/** A 区: the session's system prompt — the constant plus any project
+ *  instructions found in the workspace. Deterministic per cwd. */
+export declare function composeSystemPrompt(cwd: string): string;