@vincemakes/kiso-code 0.44.0 → 0.45.0

package/dist/chat.d.ts

@@ -369,7 +369,9 @@ export declare function consumeRun(session: AgentSession, run: Run, input: LineI
 /** W21: the amend words ("Yes + feedback") ride the NEXT user turn —
  *  threaded from chat's submitTurn; absent in the recovery flow
  *  (resume) where a dropped amend is noticed instead. */
-submitTurn?: (line: string) => void): Promise<import("@vincemakes/kiso-core").Event | undefined>;
+submitTurn?: (line: string) => void, 
+/** ADR-0057: a steer landed — an input after the run's own. */
+onInputLanded?: () => void): Promise<import("@vincemakes/kiso-core").Event | undefined>;
 /** Interactive REPL: stream events, pause for approvals, Ctrl+C aborts. */
 /** The chat loop's ENDING: exit closes the process's REPL for good; a
  *  switch hands main another session id to re-enter chat with — the

package/dist/chat.js

@@ -10,7 +10,7 @@ import { askView, coldResumeLine, coldResumeView, deletionRiskHint, editFileDiff
 import { canonicalTargetPath, isProtectedPath, protectedIdentity, shellProgressPath } from "@vincemakes/kiso-tools-node";
 import { queuedSwitchLines } from "./state.js";
 import { echoText } from "@vincemakes/kiso-tui-cells/render";
-import { canonicalizeUsage } from "@vincemakes/kiso-runtime";
+import { canonicalizeUsage, RunClosedError } from "@vincemakes/kiso-runtime";
 import { canonicalizeUsageForModel, requestBudget } from "@vincemakes/kiso-runtime/internal";
 import { dispatch, abortBangCommand } from "./dispatch.js";
 import { paintWindowTitle } from "./window-title.js";
@@ -854,8 +854,11 @@ export async function consumeRun(session, run, input, turnNo, faux, statusCb,
 /** W21: the amend words ("Yes + feedback") ride the NEXT user turn —
  *  threaded from chat's submitTurn; absent in the recovery flow
  *  (resume) where a dropped amend is noticed instead. */
-submitTurn) {
+submitTurn, 
+/** ADR-0057: a steer landed — an input after the run's own. */
+onInputLanded) {
     let last;
+    let inputsSeen = 0;
     // W22: the TURN's usage — null until a call settles, then the sum of
     // every call in this turn (accumulateUsage). Null rather than an empty
     // accumulator, so the first call is the sum rather than an addition to
@@ -931,6 +934,9 @@ submitTurn) {
             // construction (ADR-0040).
             switch (ev.type) {
                 case "user_input":
+                    inputsSeen += 1;
+                    if (inputsSeen > 1)
+                        onInputLanded?.();
                     // The window title is re-derived here because THIS is when a
                     // session stops being nameless: the tab opened as `kiso —
                     // <workspace>` and the first substantive prompt is what gives
@@ -1294,10 +1300,11 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
         (async () => {
             let last;
             try {
-                last = await consumeRun(session, run, input, myTurn, faux, statusCb, submitTurn);
+                last = await consumeRun(session, run, input, myTurn, faux, statusCb, submitTurn, landed);
                 stopSpinner();
                 paintIdle();
                 currentRun = null;
+                handBack(run);
                 // 0.40.5: the kiso on disk may no longer be the one this
                 // session runs (an upgrade since it started) — said once per
                 // installed version (stale-version.ts).
@@ -1335,6 +1342,7 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
                 }
                 console.error(`\n[run failed] ${err instanceof Error ? err.message : String(err)}\n`);
                 currentRun = null;
+                handBack(run);
                 input.prompt();
                 resolve();
             }
@@ -1347,6 +1355,7 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
             // aborted terminal, which the consumer keeps consuming.
             console.log("\n[aborting run]");
             pendingAsk?.();
+            giveBack();
             currentRun.abort();
         }
         else if (pendingAsk !== null) {
@@ -1379,6 +1388,7 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
         if (currentRun) {
             console.log("\n[aborting run]");
             pendingAsk?.();
+            giveBack();
             currentRun.abort();
         }
     });
@@ -1392,6 +1402,9 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
             return dispatch(line, dispatchCtx);
         console.log("\n[redirecting run]");
         pendingAsk?.();
+        // ADR-0057: steers that had not landed ride the correction — one next
+        // message, not a queue; the correction first (§3: it corrects them).
+        const unsent = handed(currentRun.retract().length);
         currentRun.abort();
         // §3: a correction must run BEFORE the follow-ups queued earlier —
         // it is a correction OF them. The existing slot mechanics compose
@@ -1406,9 +1419,9 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
         const jumped = pendingTurns.map((s) => ({ content: s.content, via: s.via }));
         for (let i = jumped.length; i > 0; i -= 1)
             popQueue();
-        submitTurn(line);
+        queueTurn(unsent.length > 0 ? [line, ...unsent.map((u) => u.content)].join("\n\n") : line);
         for (const j of jumped)
-            submitTurn(j.content, j.via);
+            queueTurn(j.content, j.via);
     });
     // round 5 (P1-11): the PERSISTENT line listener is installed BEFORE the
     // startup recovery — a cancelled question's re-emitted "line" needs a
@@ -1541,7 +1554,7 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
             return;
         spentUsd = (spentUsd ?? 0) + usd;
     };
-    const submitTurn = (line, via) => {
+    const queueTurn = (line, via) => {
         const slot = { line: via?.line ?? line, content: line, ...(via !== undefined ? { via } : {}), cancelled: false };
         pendingTurns.push(slot);
         queued += 1;
@@ -1588,10 +1601,78 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
         queued = Math.max(0, queued - 1);
         return slot.line;
     };
+    // ADR-0057 (the owner's ruling, 2026-09-28): Enter while a run is live
+    // is a STEER — there is no queue. `steering` mirrors what the run holds
+    // and has not admitted; the run takes ALL of it at its next quiescent
+    // boundary, and the landed user_input clears the rows. Piped and
+    // task-file input keep one turn per line: a script has nobody steering.
+    const steerable = process.stdin.isTTY === true && input.literal !== true;
+    let steering = [];
+    const steer = (line, via) => {
+        if (!steerable || currentRun === null)
+            return false;
+        try {
+            currentRun.steer(via !== undefined ? line : attachImages(line, input.attachments?.(), protectedFiles()));
+        }
+        catch (err) {
+            if (err instanceof RunClosedError)
+                return false; // the run is ending: this is the next turn
+            throw err;
+        }
+        steering.push({ line: via?.line ?? line, content: line, ...(via !== undefined ? { via } : {}) });
+        return true;
+    };
+    const submitTurn = (line, via) => {
+        if (!steer(line, via))
+            queueTurn(line, via);
+    };
+    /** The mirror of the last `n` steers the run handed back; clears it. */
+    const handed = (n) => {
+        const out = n > 0 ? steering.slice(-n) : [];
+        steering = [];
+        return out;
+    };
+    const landed = () => {
+        steering = [];
+    };
+    /** A run sealed with steers still pending (max_turns, an END_TURN
+     *  result, an error): they are the person's next message, sent now. */
+    const handBack = (run) => {
+        const left = handed(run.unadmitted().length);
+        if (left.length === 1)
+            queueTurn(left[0].content, left[0].via);
+        else if (left.length > 1)
+            queueTurn(left.map((s) => s.content).join("\n\n"));
+    };
+    /** Esc / ctrl+c: a stop is not a send — steers that have not landed
+     *  go back to the editor. */
+    const giveBack = () => {
+        if (currentRun === null)
+            return;
+        const back = handed(currentRun.retract().length);
+        if (back.length > 0)
+            input.restore?.(back.map((s) => s.line).join("\n"));
+    };
+    /** ↑ takes back the LAST steer that has not landed (the others go back
+     *  in, in order); with none, the pipe-era queue pop. */
+    const popPending = () => {
+        if (currentRun !== null && steering.length > 0) {
+            const back = currentRun.retract();
+            const mine = handed(back.length);
+            const last = mine.pop();
+            for (const c of back.slice(0, -1))
+                currentRun.steer(c);
+            steering = mine;
+            if (last !== undefined)
+                return last.line;
+        }
+        return popQueue();
+    };
     // W22: the visibility invariant's binds — the dock renders the
-    // pending chips (+N queued), the editor routes the pop keys.
-    dock.bindQueue(() => pendingTurns.map((s) => s.line));
-    input.bindQueue(() => pendingTurns.map((s) => s.line), popQueue);
+    // pending chips, the editor routes the pop keys.
+    const pendingLines = () => [...steering.map((s) => s.line), ...pendingTurns.map((s) => s.line)];
+    dock.bindQueue(pendingLines);
+    input.bindQueue(pendingLines, popPending);
     const dispatchCtx = {
         session,
         input,
@@ -1717,8 +1798,9 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
         runStart = Date.now();
         runUsage = { in: null, out: null, cache: null, known: false };
         lastTokPerSec = null; // TPS-1: nothing has settled in THIS turn yet
-        const last = await consumeRun(session, recoveryRun, input, turnNo, faux, statusCb, submitTurn);
+        const last = await consumeRun(session, recoveryRun, input, turnNo, faux, statusCb, submitTurn, landed);
         currentRun = null;
+        handBack(recoveryRun);
         failOnFauxExhaustion(last, faux, input);
         // E group (the graceful-exit gate ③): the same deferred re-check
         // as the turn path — the recovery run's end is also a safe point.

package/dist/index.js

@@ -319,6 +319,10 @@ function editorInput(editor) {
         bindQueue(state, pop) {
             editor.bindQueue(state, pop);
         },
+        // ADR-0057: the steers a stop handed back return to the buffer.
+        restore(text) {
+            editor.restore(text);
+        },
         // R3a: cross-session history — the CLI owns the file I/O.
         bindHistory(seed, persist) {
             editor.bindHistory(seed, persist);

package/dist/state.d.ts

@@ -179,6 +179,9 @@ export interface LineInput {
      *  live slots (each pop cancels the turn), esc ends the walk after
      *  one more pop. The chips are the compositor's own bindQueue. */
     bindQueue(state: () => readonly string[], pop: () => string | null): void;
+    /** 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;
     /** 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.44.0",
+	"version": "0.45.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",
@@ -18,19 +18,19 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-ask-ext": "0.44.0",
-		"@vincemakes/kiso-core": "0.44.0",
-		"@vincemakes/kiso-evals": "0.44.0",
-		"@vincemakes/kiso-mcp-ext": "0.44.0",
-		"@vincemakes/kiso-provider-anthropic": "0.44.0",
-		"@vincemakes/kiso-provider-openai": "0.44.0",
-		"@vincemakes/kiso-provider-openai-responses": "0.44.0",
-		"@vincemakes/kiso-runtime": "0.44.0",
-		"@vincemakes/kiso-skills-ext": "0.44.0",
-		"@vincemakes/kiso-subagent-ext": "0.44.0",
-		"@vincemakes/kiso-tools-node": "0.44.0",
-		"@vincemakes/kiso-tui": "0.44.0",
-		"@vincemakes/kiso-tui-cells": "0.44.0"
+		"@vincemakes/kiso-ask-ext": "0.45.0",
+		"@vincemakes/kiso-core": "0.45.0",
+		"@vincemakes/kiso-evals": "0.45.0",
+		"@vincemakes/kiso-mcp-ext": "0.45.0",
+		"@vincemakes/kiso-provider-anthropic": "0.45.0",
+		"@vincemakes/kiso-provider-openai": "0.45.0",
+		"@vincemakes/kiso-provider-openai-responses": "0.45.0",
+		"@vincemakes/kiso-runtime": "0.45.0",
+		"@vincemakes/kiso-skills-ext": "0.45.0",
+		"@vincemakes/kiso-subagent-ext": "0.45.0",
+		"@vincemakes/kiso-tools-node": "0.45.0",
+		"@vincemakes/kiso-tui": "0.45.0",
+		"@vincemakes/kiso-tui-cells": "0.45.0"
 	},
 	"devDependencies": {
 		"@types/node": "^26.1.2",