@vincemakes/kiso-code 0.7.0 → 0.8.0

package/dist/builtin.d.ts

@@ -1,2 +1,8 @@
+import { type AskUI } from "@vincemakes/kiso-ask-ext";
 import type { KisoExtension } from "@vincemakes/kiso-runtime";
-export declare function builtInLayer(user: readonly KisoExtension[], project: readonly KisoExtension[]): Promise<readonly KisoExtension[]>;
+export declare function builtInLayer(user: readonly KisoExtension[], project: readonly KisoExtension[], 
+/** KC3.5: built-in #4 — the ask extension, loaded ONLY when a panel
+ *  bridge exists (an interactive TTY). No bridge, no fourth built-in:
+ *  a headless session never pays the rent for a question nobody could
+ *  answer, and its tool table cannot mention ask_user. */
+ask?: AskUI): Promise<readonly KisoExtension[]>;

package/dist/builtin.js

@@ -24,8 +24,14 @@
 import createMcp from "@vincemakes/kiso-mcp-ext";
 import createSkills from "@vincemakes/kiso-skills-ext";
 import createSubagent from "@vincemakes/kiso-subagent-ext";
-export async function builtInLayer(user, project) {
-    const all = await Promise.all([createMcp(), createSkills(), createSubagent()]);
+import createAsk, {} from "@vincemakes/kiso-ask-ext";
+export async function builtInLayer(user, project, 
+/** KC3.5: built-in #4 — the ask extension, loaded ONLY when a panel
+ *  bridge exists (an interactive TTY). No bridge, no fourth built-in:
+ *  a headless session never pays the rent for a question nobody could
+ *  answer, and its tool table cannot mention ask_user. */
+ask) {
+    const all = await Promise.all([createMcp(), createSkills(), createSubagent(), ...(ask === undefined ? [] : [createAsk(ask)])]);
     const shadowed = all.filter((b) => user.some((u) => u.name === b.name));
     for (const s of shadowed) {
         console.error(`[extensions] user extension "${s.name}" shadows the built-in — the built-in is not loaded`);

package/dist/dispatch.js

@@ -3,7 +3,7 @@
  * turns. The bodies moved verbatim from chat()'s closure; chat provides
  * the context (the chain, the run state, the prompt arming).
  */
-import { escapeTerminal, kUnit, palette } from "@vincemakes/kiso-tui";
+import { escapeTerminal, helpRows, kUnit, palette } from "@vincemakes/kiso-tui";
 import { buildAdapter } from "@vincemakes/kiso-runtime/internal";
 import { MODES, getMode, setMode } from "./mode.js";
 import { agentModel, body, bodyLog, configModels, dock, setAgentModel, setCurrentModelName } from "./state.js";
@@ -15,24 +15,16 @@ import { directWriteProfile, profileAvailable } from "./config.js";
 export function dispatch(line, ctx) {
     const trimmed = line.trim();
     if (trimmed === "/help") {
-        // Prints the available commands with one-line descriptions.
-        // v2a: the command names are the blue identity accent.
-        const p = palette();
-        const cmd = (name, desc) => `${p.bold}${name}${p.reset}    ${desc}`;
+        // KC3.5 slice ⓪ (the extraction): the ROWS moved to the terminal
+        // layer's strings module (helpRows — the KC3 §1 pattern: what the
+        // human reads is presentation). The FLOW is what stays here, and
+        // it is unchanged: print on the chain, then re-prompt. The rows
+        // are byte-identical to the eight bodyLog calls they replace —
+        // the last one still carries its own \n, so `exit` and `keys`
+        // land as two rows from one call (bodyLog splits on \n).
         ctx.chainRef.current = ctx.chainRef.current.then(async () => {
-            bodyLog(cmd("/help", "print this list of commands"));
-            bodyLog(cmd("/think", "show the last full thinking block"));
-            bodyLog(cmd("/last", "show the most recent tool call's input and output"));
-            bodyLog(cmd("/status", "show session id, event count, and context estimate"));
-            bodyLog(cmd("/mode", "show the approval tier; /mode <name> switches (manual/default/accept-edits/plan/bypass)"));
-            bodyLog(cmd("/model", "list model profiles; /model <name|provider/model> switches"));
-            bodyLog(cmd("/compact", "summarize the older conversation to free context"));
-            // KC1: the composer's keys ride the SAME bodyLog call (it splits
-            // on \n) — the help gains a row, the cli source does not.
-            // KC2: the redirect joins the same row for the same reason.
-            // KC3: and so does the @ picker — the row is where a gesture is
-            // taught, and the row costs nothing.
-            bodyLog(`${cmd("exit", "leave the session")}\n${cmd("keys", "enter sends · ctrl+J newline (shift+enter where encoded) · esc stops the run · alt+⏎ stops it and sends this instead · @ files")}`);
+            for (const row of helpRows())
+                bodyLog(row);
             ctx.input.prompt();
         });
         return;

package/dist/index.js

@@ -26,14 +26,14 @@ import { readFileSync, realpathSync, rmSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
-import { Body, Editor, bannerLines, escapeTerminal, interactivePrompt, palette, renderSessionLine } from "@vincemakes/kiso-tui";
+import { Body, Editor, bannerLines, escapeTerminal, extensionsBannerText, interactivePrompt, palette, renderSessionLine } from "@vincemakes/kiso-tui";
 import { createAgent, disposeExtensions, loadExtensions, loadProjectExtensions, SessionStore, } from "@vincemakes/kiso-runtime";
 import { createFauxProvider } from "@vincemakes/kiso-evals";
 import { createCodingTools } from "@vincemakes/kiso-tools-node";
 import { MODES, modeExtensions, modeFromEnv, modeSystemPrompt, setMode } from "./mode.js";
 import { builtInLayer } from "./builtin.js";
 import { atFiles, body, bodyLog, builtInExtensions, currentFaux, dock, extensionsDir, loadedExtensions, mergedConfig, mergedTempPaths, projectExtensions, sessionsDir, setAgentModel, setBody, setConfigModels, setConfiguredWindow, setCurrentAgentExtensions, setCurrentFaux, setCurrentModelName, setExtensionLists, setMergedConfig, userExtensions, VERSION } from "./state.js";
-import { resolveProjectTrust } from "./trust-ui.js";
+import { askUi, resolveProjectTrust } from "./trust-ui.js";
 import { isFirstRun, scaffoldFirstRun } from "./first-run.js";
 import { fauxSkip, readFauxScript } from "./faux-glue.js";
 import { autoCompactFromEnv, chat, contextWindowTokens } from "./chat.js";
@@ -209,20 +209,11 @@ function makeLineInput() {
  *  a fresh install reads `[3 extensions: built-in: mcp, skills, subagent]`
  *  with zero disk setup (E5: the task extension is opt-in). */
 function bannerExtensionText() {
-    const total = builtInExtensions.length + userExtensions.length + projectExtensions.length;
-    if (total === 0)
-        return "";
-    const parts = [];
-    // 0.1.26 (MCP lazy connection): an extension with a live `connecting` flag shows
-    // its in-flight state in the banner — "mcp (connecting…)".
-    const label = (e) => e.connecting === true ? `${e.name} (connecting…)` : e.name;
-    if (builtInExtensions.length > 0)
-        parts.push(`built-in: ${builtInExtensions.map(label).join(", ")}`);
-    if (userExtensions.length > 0)
-        parts.push(userExtensions.map(label).join(", "));
-    if (projectExtensions.length > 0)
-        parts.push(`project: ${projectExtensions.map(label).join(", ")}`);
-    return ` · [${total} extension${total === 1 ? "" : "s"}: ${parts.join(" · ")}]`;
+    // KC3.5 slice ⓪ (the extraction): the composition moved to the
+    // terminal layer (extensionsBannerText — a pure function of the three
+    // name lists, including the "(connecting…)" in-flight label). Which
+    // lists exist is the CLI's fact and stays here.
+    return extensionsBannerText(builtInExtensions, userExtensions, projectExtensions);
 }
 /** E1: the startup banner line(s) — TTY: logo + merged extensions + the
  *  W5 resume list as a LIVE banner cell (W1: the tier re-derives on
@@ -374,7 +365,11 @@ async function makeAgent(sessionId, input, modelFlag) {
     const proj = project !== null ? await loadProjectExtensions(process.cwd(), user) : [];
     // R-D 0.1.45: the built-in layer registers by module import (builtin.ts)
     // — a user extension may shadow a built-in, a project one may not.
-    const builtIn = await builtInLayer(user, proj);
+    // KC3.5: built-in #4 (ask) registers ONLY where a human can answer —
+    // the panel bridge is the argument, and a non-TTY session has none to
+    // give. A piped run's composed tool table therefore cannot contain
+    // ask_user (T-Q3: the bench's structural byte-identity proof).
+    const builtIn = await builtInLayer(user, proj, input !== undefined && process.stdin.isTTY ? askUi(input) : undefined);
     setExtensionLists(builtIn, user, proj, [...builtIn, ...user, ...proj]);
     // merge round B — the config surface: user config + (trusted) project config,
     // resolved with flags > env > project > user > default. The CLI never

package/dist/trust-ui.d.ts

@@ -6,6 +6,7 @@
  * decisions. All bodies moved verbatim from index.ts.
  */
 import { type PanelVerdict, type PanelView } from "@vincemakes/kiso-tui";
+import type { AskUI } from "@vincemakes/kiso-ask-ext";
 import { type ProjectArtifacts } from "@vincemakes/kiso-runtime";
 import type { AgentSession } from "@vincemakes/kiso-runtime";
 import { type LineInput } from "./state.js";
@@ -34,6 +35,24 @@ import { type LineInput } from "./state.js";
  */
 export declare let pendingAsk: (() => void) | null;
 export declare function askPanel(input: LineInput, view: PanelView): Promise<PanelVerdict>;
+/**
+ * KC3.5 — the AskUI bridge: the panel the ask extension asks through.
+ *
+ * It is deliberately three lines of GLUE. Everything an ask needs was
+ * already built for W21 and is reused whole: askPanel owns the
+ * abortable ask (the SIGINT/esc path resolves it), the non-interactive
+ * refusal (printed loudly, never hung) and the dock-less fallback; the
+ * editor owns the keys and the buffer stash; the tui owns the rows and
+ * the walk. What is left here is the mapping — the panel's `answers`
+ * verdict IS the tool's result, and EVERY other verdict is the decline,
+ * which is an honest recorded outcome naming what went unanswered.
+ *
+ * (A cancel, a non-interactive deny and a dock-less y/n all land in the
+ * same place on purpose: none of them is an answer to a multiple-choice
+ * question, and inventing one would be the dishonesty the whole round
+ * is built to avoid.)
+ */
+export declare function askUi(input: LineInput): AskUI;
 /**
  * W21/R3 — the "2 Yes, don't ask again for <tool>" rule: a GENERATED
  * extension, ALLOW-ONLY by construction (it never emits deny or ask —

package/dist/trust-ui.js

@@ -9,7 +9,7 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, symlinkS
 import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
-import { projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView } from "@vincemakes/kiso-tui";
+import { askDeclineAll, askView, projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView, unansweredAskView } from "@vincemakes/kiso-tui";
 import { projectArtifacts, recordTrust, trustFor } from "@vincemakes/kiso-runtime";
 import { bodyLog, currentAgentExtensions, dock, extensionsDir, kisoHome, mergedTempPaths } from "./state.js";
 import { loadUserConfig, resolveProjectTrustPolicy } from "./config.js";
@@ -83,6 +83,31 @@ export function askPanel(input, view) {
         }
     });
 }
+/**
+ * KC3.5 — the AskUI bridge: the panel the ask extension asks through.
+ *
+ * It is deliberately three lines of GLUE. Everything an ask needs was
+ * already built for W21 and is reused whole: askPanel owns the
+ * abortable ask (the SIGINT/esc path resolves it), the non-interactive
+ * refusal (printed loudly, never hung) and the dock-less fallback; the
+ * editor owns the keys and the buffer stash; the tui owns the rows and
+ * the walk. What is left here is the mapping — the panel's `answers`
+ * verdict IS the tool's result, and EVERY other verdict is the decline,
+ * which is an honest recorded outcome naming what went unanswered.
+ *
+ * (A cancel, a non-interactive deny and a dock-less y/n all land in the
+ * same place on purpose: none of them is an answer to a multiple-choice
+ * question, and inventing one would be the dishonesty the whole round
+ * is built to avoid.)
+ */
+export function askUi(input) {
+    return {
+        ask: async (spec) => {
+            const verdict = await askPanel(input, askView(spec));
+            return verdict.action === "answers" ? verdict.result : askDeclineAll(spec);
+        },
+    };
+}
 /**
  * W21/R3 — the "2 Yes, don't ask again for <tool>" rule: a GENERATED
  * extension, ALLOW-ONLY by construction (it never emits deny or ask —
@@ -299,7 +324,12 @@ function readdirSyncSafe(dir) {
  *  the body is the single stdout writer, never a stray console.log. */
 export async function resolveUncertains(session, input, isCancelled) {
     for (const uncertain of session.uncertainExecutions()) {
-        const verdict = await askPanel(input, uncertainView(uncertain.name, uncertain.executionId));
+        // KC3.5 §4: an interrupted ask_user is not a side effect that may
+        // have applied — it is a question nobody answered. The COPY says
+        // so; the mechanism is untouched (allow → the runtime's own rerun
+        // resolution, whose error-fill text this round never edits).
+        const view = uncertain.name === "ask_user" ? unansweredAskView(uncertain.executionId) : uncertainView(uncertain.name, uncertain.executionId);
+        const verdict = await askPanel(input, view);
         if (isCancelled() || verdict.action === "cancel") {
             // round 10: a cancellation NEVER records a verdict — the execution
             // stays uncertain and durable; no rerun/abandoned is fabricated.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-code",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "kiso CLI — the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
   "type": "module",
   "license": "MIT",
@@ -18,18 +18,19 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@vincemakes/kiso-core": "0.7.0",
-    "@vincemakes/kiso-evals": "0.7.0",
-    "@vincemakes/kiso-mcp-ext": "0.7.0",
-    "@vincemakes/kiso-provider-anthropic": "0.7.0",
-    "@vincemakes/kiso-provider-openai": "0.7.0",
-    "@vincemakes/kiso-runtime": "0.7.0",
-    "@vincemakes/kiso-skills-ext": "0.7.0",
-    "@vincemakes/kiso-subagent-ext": "0.7.0",
-    "@vincemakes/kiso-task-ext": "0.7.0",
-    "@vincemakes/kiso-tools-node": "0.7.0",
-    "@vincemakes/kiso-tui": "0.7.0",
-    "@vincemakes/kiso-tui-cells": "0.7.0"
+    "@vincemakes/kiso-ask-ext": "0.8.0",
+    "@vincemakes/kiso-core": "0.8.0",
+    "@vincemakes/kiso-evals": "0.8.0",
+    "@vincemakes/kiso-mcp-ext": "0.8.0",
+    "@vincemakes/kiso-provider-anthropic": "0.8.0",
+    "@vincemakes/kiso-provider-openai": "0.8.0",
+    "@vincemakes/kiso-runtime": "0.8.0",
+    "@vincemakes/kiso-skills-ext": "0.8.0",
+    "@vincemakes/kiso-subagent-ext": "0.8.0",
+    "@vincemakes/kiso-task-ext": "0.8.0",
+    "@vincemakes/kiso-tools-node": "0.8.0",
+    "@vincemakes/kiso-tui": "0.8.0",
+    "@vincemakes/kiso-tui-cells": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",