@vincemakes/kiso-code 0.52.0 → 0.53.0

package/dist/chat.d.ts

@@ -411,5 +411,7 @@ export interface ChatNav {
     /** 0.40.0: an id outside this project's folder — refused, or opened where it is */
     readonly route?: (id: string) => SessionRoute | null;
     readonly pick?: () => Promise<string | null>;
+    /** the session's first message was sent: the caller may title the session from it (Session.title) */
+    readonly titled?: (firstMessage: string) => void;
 }
 export declare function chat(session: AgentSession, faux: boolean, input: LineInput, autoCompact?: AutoCompact, nav?: ChatNav, seed?: readonly string[]): Promise<ChatEnd>;

package/dist/chat.js

@@ -1386,7 +1386,11 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
         // 0.40.0: a skill turn is not scanned either — its text is a
         // SKILL.md body, and a body that mentions `diagram.png` must not
         // attach a file from the workspace the person never pointed at.
+        input.setGhost?.(null); // a new turn: the last run's follow-up no longer applies
         const content = via !== undefined ? text : attachImages(text, input.attachments?.(), protectedFiles());
+        // the person's first message of the session: a title is made from it beside the run, never in its way
+        if (via === undefined && !session.log.all.some((e) => e.type === "user_input"))
+            nav?.titled?.(text);
         // ADR-0058: a task notice is the runtime's input — source "system"
         const run = via !== undefined ? session.run(content, { via, ...(via.kind === "tasks" ? { source: "system" } : {}) }) : session.run(content);
         currentRun = run;
@@ -1435,6 +1439,15 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
                 // round 8: after EVERY turn the prompt is re-armed — the human
                 // never types blind after the first turn.
                 input.prompt();
+                // the follow-up (owner 2026-11-03): after a run that ended well, the line the person may send next,
+                // asked of the session's own model with the run's own prefix (Session.followUp); shown dim in the
+                // empty box only while no other turn has started or waits; off with the faux model and KISO_FOLLOWUP=off
+                if (last?.type === "terminal" && last.outcome.kind === "completed" && !faux && input.setGhost !== undefined && process.env["KISO_FOLLOWUP"] !== "off" && queued === 0) {
+                    void session.followUp({ maxTokens: 200, signal: AbortSignal.timeout(15_000) }).then((line) => {
+                        if (turnNo === myTurn && currentRun === null && queued === 0)
+                            input.setGhost?.(line === "" ? null : line);
+                    }, () => undefined);
+                }
                 // the ergonomics batch C8: the opt-in auto-compact — checked AFTER the
                 // turn ended (the run's terminal is in the log, the ratio
                 // is post-run).

package/dist/dispatch.d.ts

@@ -4,7 +4,9 @@
  * the context (the chain, the run state, the prompt arming).
  */
 import type { SessionRoute } from "./projects.js";
-import type { AgentSession } from "@vincemakes/kiso-runtime";
+import { type StoreRecord } from "@vincemakes/kiso-runtime/internal";
+import { type AgentSession } from "@vincemakes/kiso-runtime";
+import type { SessionCardView } from "@vincemakes/kiso-tui";
 import { type LineInput } from "./state.js";
 import type { UserInputVia } from "@vincemakes/kiso-core";
 /** Everything dispatch touches that chat() owns. */
@@ -72,3 +74,6 @@ export declare function parseBang(trimmed: string): {
 export declare function markCompactWhy(why: string): void;
 export declare function markAutoCompact(): void;
 export declare function dispatch(line: string, ctx: DispatchCtx): void;
+/** /fork's rows: each finished run's reply, newest first, by its first line and when it ended; the opened row says the
+ *  line it answered. The card's id is the seq of the run's terminal, where SessionStore.fork cuts. */
+export declare function replyCards(records: readonly StoreRecord[]): SessionCardView[];

package/dist/dispatch.js

@@ -5,11 +5,12 @@
  */
 import { STATUS_GLYPHS, contextRows, contextSheetRows, contextUnavailableRows, contextUnavailableSheetRows, displayVerb, escapeTerminal, helpRows, toolTarget, infoSheetRows, kUnit, modePickView, modelPickView, namedPickView, settingsPickView, compactingStatus, liveRow, palette, renderEvent, settledLabel, slashCommandNames } from "@vincemakes/kiso-tui";
 import { newSessionId } from "./session-id.js";
-import { buildAdapter, lookupModelMetadata, readSessionName, resolveContinuationScope, resolveReasoning, sessionTitle, tiersFor, writeSessionName } from "@vincemakes/kiso-runtime/internal";
+import { buildAdapter, isForkNote, lookupModelMetadata, readSessionName, resolveContinuationScope, resolveReasoning, sessionTitle, tiersFor, writeSessionName } from "@vincemakes/kiso-runtime/internal";
+import { ForkRefusedError, SessionStore } from "@vincemakes/kiso-runtime";
 import { MODE_LABEL, MODE_NOTE, OFFERED_MODES, applyModeSetting, getDontAsk, getMode, modeDisplay, parseMode, setDontAsk } from "./mode.js";
 import { clipboardWrite, lastAnswer } from "./clipboard.js";
 import { protectedBangReason, protectedShellVerdict } from "./protected-shell.js";
-import { activeStoreDir, agentBaseUrl, currentProfileName, setCurrentProfileName, currentModelName, agentModel, body, bodyLog, codingToolOptions, protectedFiles, kisoHome, configModels, dock, lastBinding, loadedSkillsCatalog, mergedConfig, readContextLedger, retryOnRow, sessionsDir, setAgentModel, setConfiguredWindow, setCurrentModelName, setModelChoice, setRetryShown, upstreamOf, VERSION, setLastBinding } from "./state.js";
+import { activeStoreDir, sessionStoreRef, agentBaseUrl, currentProfileName, setCurrentProfileName, currentModelName, agentModel, body, bodyLog, codingToolOptions, protectedFiles, kisoHome, configModels, dock, lastBinding, loadedSkillsCatalog, mergedConfig, readContextLedger, retryOnRow, sessionsDir, setAgentModel, setConfiguredWindow, setCurrentModelName, setModelChoice, setRetryShown, upstreamOf, VERSION, setLastBinding } from "./state.js";
 import { adapterOptionsFor } from "./auth/adapter-options.js";
 import { profileProviderLabel, providerLabel } from "./provider-label.js";
 import { installedVersion, versionStatusLine } from "./stale-version.js";
@@ -1384,6 +1385,44 @@ export function dispatch(line, ctx) {
         ctx.requestReload();
         return;
     }
+    if (trimmed === "/fork") {
+        // owner 2026-11-03: the web app's fork, one rule — a new session from after one of this session's replies
+        // (SessionStore.fork), then the terminal switches to it as /resume does; the replies are picked in /resume's band
+        if (ctx.isRunning()) {
+            body.notice("[/fork] a run is in flight — let it finish (esc stops it), then fork");
+            ctx.input.prompt();
+            return;
+        }
+        ctx.chainRef.current = ctx.chainRef.current.then(async () => {
+            const cards = replyCards(sessionStoreRef?.load(ctx.session.id) ?? []);
+            if (cards.length === 0) {
+                body.notice("no finished reply to fork after yet");
+                ctx.input.prompt();
+                return;
+            }
+            const fork = (afterSeq) => {
+                try {
+                    const made = new SessionStore(activeStoreDir).fork(ctx.session.id, { afterSeq });
+                    body.notice(`forked "${escapeTerminal(readSessionName(activeStoreDir, made.id) ?? made.id)}" — switching to it`);
+                    ctx.requestSwitch(made.id);
+                }
+                catch (error) {
+                    body.notice(error instanceof ForkRefusedError ? `[/fork] ${error.message}` : `[/fork] ${error instanceof Error ? error.message : String(error)}`);
+                    ctx.input.prompt();
+                }
+            };
+            // no band (a pipe, a dock-less terminal): after the last reply, the sidebar's Fork
+            if (ctx.input.pick === undefined || !dock.active)
+                return fork(Number(cards[0].id));
+            ctx.input.pick(() => cards, (picked) => {
+                if (picked === null)
+                    ctx.input.prompt(); // esc: nothing forked, nothing said
+                else
+                    fork(Number(picked));
+            }, undefined, "fork");
+        });
+        return;
+    }
     if (trimmed === "/resume" || trimmed.startsWith("/resume ")) {
         // the mini-spec: the in-session door to the durable sessions —
         // /resume <id> switches directly; bare /resume opens the SAME
@@ -1589,3 +1628,27 @@ async function tasksCommand(arg, ctx) {
     else if (action === 1)
         stop(task);
 }
+/** /fork's rows: each finished run's reply, newest first, by its first line and when it ended; the opened row says the
+ *  line it answered. The card's id is the seq of the run's terminal, where SessionStore.fork cuts. */
+export function replyCards(records) {
+    const cards = [];
+    let asked = "";
+    let reply = "";
+    for (const { event: e, ts } of records) {
+        if (e.type === "user_input" && e.source !== "system") {
+            const content = Array.isArray(e.content) ? e.content.filter((b) => !(b.type === "text" && isForkNote(b.text ?? ""))) : e.content;
+            asked = (typeof content === "string" ? content : content.map((b) => (b.type === "text" ? (b.text ?? "") : "")).join(" ")).trim();
+            reply = "";
+        }
+        else if (e.type === "tool_result")
+            reply = "";
+        else if (e.type === "text_delta")
+            reply += e.text;
+        else if (e.type === "terminal" && e.outcome.kind === "completed") {
+            // the row is how the person recognizes the reply: its first line, inline code read as plain text
+            const first = (reply.split("\n").map((l) => l.trim()).find((l) => l !== "") ?? "(no reply text)").replace(/`([^`]*)`/g, "$1");
+            cards.unshift({ id: String(e.seq), title: first, badge: "completed", turns: null, updatedAt: ts, uncertain: 0, asks: 0, outcome: null, detail: `answered: ${asked.split("\n")[0] ?? ""}` });
+        }
+    }
+    return cards;
+}

package/dist/index.js

@@ -33,7 +33,7 @@ import { createRequire } from "node:module";
 import { basename, dirname, join } from "node:path";
 import { Body, Editor, PROMPT, bannerLines, currentGround, currentGroundRgb, parseOscColor, resolveGround, setGround, escapeTerminal, extensionsBannerText, extensionsFact, idColumn, interactivePrompt, palette, renderSessionLine, sessionListFooter, sessionListHeader, sessionListRow, sessionListUnknownLine, slashCommandNames } from "@vincemakes/kiso-tui";
 import { disposeExtensions, SessionStore } from "@vincemakes/kiso-runtime";
-import { listSessionSidecars, migrateSummaries, readProfile, readSessionName, summaryMigrationPending } from "@vincemakes/kiso-runtime/internal";
+import { listSessionSidecars, migrateSummaries, readProfile, readSessionName, summaryMigrationPending, writeSessionName } from "@vincemakes/kiso-runtime/internal";
 import { skillMenuItems } from "./skill-invoke.js";
 import { canonicalPath, hasSession, locateSession, projectLayoutActive, sessionFolders } from "./projects.js";
 import { reverseMigration } from "./session-migration.js";
@@ -332,8 +332,8 @@ function editorInput(editor) {
         // TUI2-R2 ②: the session picker — the editor owns the keys (the
         // selection walk, the filter, enter/esc), the compositor draws the
         // band, and the id comes back here.
-        pick(cards, onPick, here) {
-            editor.beginPick(cards, onPick, here);
+        pick(cards, onPick, here, kind) {
+            editor.beginPick(cards, onPick, here, kind);
         },
         // W22: the pending-turn queue — the ↑ pop walk (the keys); the
         // chips are the compositor's bindQueue (the dock side).
@@ -341,6 +341,9 @@ function editorInput(editor) {
             editor.bindQueue(state, pop);
         },
         // ADR-0057: the steers a stop handed back return to the buffer.
+        setGhost(text) {
+            editor.setGhost(text);
+        },
         restore(text) {
             editor.restore(text);
         },
@@ -1158,6 +1161,30 @@ async function chatLoop(first, firstId, input, autoCompact) {
             sessions: () => agent.sessionIds(),
             route: (sessionId) => routeSession(sessionId),
             ...(process.stdin.isTTY ? { pick: () => pickSession(agent, input) } : {}),
+            // owner 2026-11-03: a session is titled by a summary of its first message, in the background; the person's own
+            // name wins, before or after; off with KISO_AUTO_TITLE=off and with the faux model, and never without a TTY:
+            // a piped chat is a script or a bench leg, where one more request per session is not the person's
+            ...(currentFaux || process.env["KISO_AUTO_TITLE"] === "off" || process.stdin.isTTY !== true
+                ? {}
+                : {
+                    titled: (firstMessage) => {
+                        // the session and its folder as they are NOW: a /resume or a switch before the title lands must not
+                        // send it to another session, nor repaint another session's window title
+                        const [titling, mine, dir] = [session, session.id, activeStoreDir];
+                        if (readSessionName(dir, mine) !== null)
+                            return;
+                        void titling.title(firstMessage, { signal: AbortSignal.timeout(15_000) }).then((title) => {
+                            if (title === "" || readSessionName(dir, mine) !== null)
+                                return;
+                            writeSessionName(dir, mine, title);
+                            // `id` is the loop's: the session open now (a switch moves it on)
+                            if (id !== mine)
+                                return;
+                            setTitleName(title);
+                            paintWindowTitle();
+                        }, () => undefined);
+                    },
+                }),
         };
         const end = await chat(session, currentFaux, input, autoCompact, nav, seed);
         if (end.next === "exit") {

package/dist/replay.d.ts

@@ -19,7 +19,7 @@
  *     summary (what the model sees next) and the turns it covers, read in
  *     the viewer — then any uncovered earlier turns folded as above.
  */
-import type { TaskInfo } from "@vincemakes/kiso-runtime/internal";
+import { type TaskInfo } from "@vincemakes/kiso-runtime/internal";
 import type { NoticeMark } from "@vincemakes/kiso-tui";
 /** The Body surface the replay drives — the live run's own mutations. */
 export interface ReplayBody {

package/dist/replay.js

@@ -22,6 +22,7 @@
 import { echoText } from "@vincemakes/kiso-tui-cells/render";
 import { bandHeader } from "@vincemakes/kiso-tui-cells/strings";
 import { cappedWaitLine, taskNoticeLines, taskNoticeRows, taskWhat } from "./task-notice.js";
+import { isForkNote } from "@vincemakes/kiso-runtime/internal";
 /** How many turns stay on screen in full. */
 const FULL_TURNS = 2;
 /** A user turn's opening line, or null when this input does not open one
@@ -32,7 +33,9 @@ function askOf(e) {
     if (e.type !== "user_input" || e.source === "system")
         return null;
     const via = e.via;
-    const text = typeof via?.line === "string" ? via.line : echoText(e.content);
+    // a fork's first input carries the fork note before the person's words: the model's, not the line they typed
+    const content = Array.isArray(e.content) ? e.content.filter((b) => !(b.type === "text" && isForkNote(b.text ?? ""))) : e.content;
+    const text = typeof via?.line === "string" ? via.line : echoText(content);
     return text.trim() === "" ? null : text;
 }
 /** Split events into turns: each starts at a user turn's input; anything

package/dist/state.d.ts

@@ -241,7 +241,7 @@ export interface LineInput {
      *  picked id, or null when the human leaves without picking.
      *  OPTIONAL: only the raw-mode editor has it, and the picker only
      *  ever opens on a TTY (a pipe has nobody to pick). */
-    pick?(cards: () => readonly SessionCardView[], onPick: (id: string | null) => void, here?: string): void;
+    pick?(cards: () => readonly SessionCardView[], onPick: (id: string | null) => void, here?: string, kind?: "resume" | "fork"): void;
     /** W22: bind the pending-turn queue — the ↑ pop walks the CLI's
      *  live slots (each pop cancels the turn), esc ends the walk after
      *  one more pop. The chips are the compositor's own bindQueue. */
@@ -249,6 +249,9 @@ export interface LineInput {
     /** ADR-0057: put text back into the editor — the steers a stop handed
      *  back before they landed. The pipe path has no editor; optional. */
     restore?(text: string): void;
+    /** The follow-up: a line the person may send next, dim in the empty box, Tab takes it; null clears it. Optional: the
+     *  readline input has no box to draw it in. */
+    setGhost?(text: string | null): void;
     /** R3a: cross-session history — seed the recall buffer, register the
      *  append sink. The pipe path has no recall keys; optional. */
     bindHistory?(seed: readonly string[], persist: (line: string) => void): void;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-code",
-	"version": "0.52.0",
+	"version": "0.53.0",
 	"description": "kiso-code \u2014 the coding agent on kiso, the durable runtime for AI agents: kiso chat / kiso resume / kiso sessions.",
 	"type": "module",
 	"license": "MIT",
@@ -29,19 +29,19 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-ask-ext": "0.52.0",
-		"@vincemakes/kiso-core": "0.52.0",
-		"@vincemakes/kiso-evals": "0.52.0",
-		"@vincemakes/kiso-mcp-ext": "0.52.0",
-		"@vincemakes/kiso-provider-anthropic": "0.52.0",
-		"@vincemakes/kiso-provider-openai": "0.52.0",
-		"@vincemakes/kiso-provider-openai-responses": "0.52.0",
-		"@vincemakes/kiso-runtime": "0.52.0",
-		"@vincemakes/kiso-skills-ext": "0.52.0",
-		"@vincemakes/kiso-subagent-ext": "0.52.0",
-		"@vincemakes/kiso-tools-node": "0.52.0",
-		"@vincemakes/kiso-tui": "0.52.0",
-		"@vincemakes/kiso-tui-cells": "0.52.0"
+		"@vincemakes/kiso-ask-ext": "0.53.0",
+		"@vincemakes/kiso-core": "0.53.0",
+		"@vincemakes/kiso-evals": "0.53.0",
+		"@vincemakes/kiso-mcp-ext": "0.53.0",
+		"@vincemakes/kiso-provider-anthropic": "0.53.0",
+		"@vincemakes/kiso-provider-openai": "0.53.0",
+		"@vincemakes/kiso-provider-openai-responses": "0.53.0",
+		"@vincemakes/kiso-runtime": "0.53.0",
+		"@vincemakes/kiso-skills-ext": "0.53.0",
+		"@vincemakes/kiso-subagent-ext": "0.53.0",
+		"@vincemakes/kiso-tools-node": "0.53.0",
+		"@vincemakes/kiso-tui": "0.53.0",
+		"@vincemakes/kiso-tui-cells": "0.53.0"
 	},
 	"devDependencies": {
 		"@types/node": "^26.1.2",