@vincemakes/kiso-code 0.45.3 → 0.46.1

package/dist/create-coding-agent.js

@@ -7,7 +7,7 @@
  * Moved verbatim from index.ts's makeAgent (R1, 2026-09-23) and renamed;
  * the body is not edited beyond the rename and activeStoreDir's setter.
  */
-import { activeStoreDir, setActiveStoreDir, body, bodyLog, codingToolOptions, extensionsDir, floorOn, kisoHome, loadedExtensions, ownSessionsDir, projectRoot, protectedFiles, secretEnvNamesOf, sessionsDir, setAgentModel, setConfigModels, setConfiguredWindow, setCurrentAgentExtensions, setCurrentFaux, setCurrentModelName, setCurrentProfileName, setExtensionLists, setFloorOn, setMergedConfig, setModelChoice, setNeverInherited, setRetryShown, setSessionStore, setUserProtectedPaths, settingsLayers, workspaceRoot } from "./state.js";
+import { activeStoreDir, childTurnBudget, setActiveStoreDir, body, bodyLog, codingToolOptions, extensionsDir, floorOn, kisoHome, loadedExtensions, ownSessionsDir, projectRoot, protectedFiles, secretEnvNamesOf, sessionsDir, setAgentModel, setConfigModels, setConfiguredWindow, setCurrentAgentExtensions, setCurrentFaux, setCurrentModelName, setCurrentProfileName, setExtensionLists, setFloorOn, setMergedConfig, setModelChoice, setNeverInherited, setRetryShown, setSessionStore, setUserProtectedPaths, settingsLayers, workspaceRoot } from "./state.js";
 import { claimProjectDir, projectLayoutActive } from "./projects.js";
 import { migrationNotice, pendingLegacyIds, planMigration, runMigration } from "./session-migration.js";
 import { askUi, resolveProjectTrust } from "./trust-ui.js";
@@ -34,6 +34,7 @@ import { createFauxProvider } from "@vincemakes/kiso-evals";
 import { sweepStaleMergeDirs } from "./temp-sweep.js";
 import { CODING_TOOL_RULES, composeSystemPrompt } from "./coding-prompt.js";
 import { createAgent, loadExtensions, loadProjectExtensions, SessionStore } from "@vincemakes/kiso-runtime";
+import { preferences, startingEffort } from "./preferences.js";
 /** LT-1: the stream watchdog's bound from the environment — a non-negative
  *  number of milliseconds (0 disables it); anything else is ignored. The
  *  PTY rigs use it to trip the watchdog in seconds against a stub that
@@ -265,6 +266,15 @@ export async function createCodingAgent(sessionId, input, modelFlag) {
         // config profile — a direct provider/model or an env key names none.
         workspace: workspaceRoot(),
         ...(resolved !== null && merged.models?.[resolved.name] === resolved.profile ? { profileName: resolved.name } : {}),
+        // B1: a NEW session of a config profile starts at the effort last
+        // picked for it (the picker's fallback applied); the runtime reads it
+        // for a new session only — a resumed one keeps its own
+        ...(() => {
+            if (resolved === null || merged.models?.[resolved.name] !== resolved.profile)
+                return {};
+            const effort = startingEffort(resolved.profile, preferences().effort?.[resolved.name]);
+            return effort === null ? {} : { reasoning: { thinking: "default", effort } };
+        })(),
         // Area 5: the coding tools are bound to the workspace — every path
         // they touch is canonicalized inside cwd, escapes are refused.
         tools: [...createCodingTools(codingToolOptions())], // DC-49 — the options live in state.ts, shared with the `!` command's runner
@@ -314,6 +324,8 @@ export async function createCodingAgent(sessionId, input, modelFlag) {
         // Modes: the five tiers join at the CHAIN HEAD, before the user/
         // project extensions (the deny>allow>ask composition keeps a user
         // deny winning over any mode tier — bypass included).
+        // ADR-0058 3d (D6): a background child's budget, its only bound.
+        ...(childTurnBudget !== undefined ? { maxTurns: childTurnBudget } : {}),
         extensions,
         ...(resolved !== null
             ? {

package/dist/dispatch.d.ts

@@ -39,6 +39,8 @@ export interface DispatchCtx {
     readonly requestSwitch: (id: string) => void;
     /** DC-57: true once this entry has been asked to leave — the guard that keeps a departing session from answering a batch's later lines. */
     readonly leaving: () => boolean;
+    /** ADR-0058 (3e): with live tasks, ask before exiting; true = exit. */
+    readonly confirmExit: () => Promise<boolean>;
     /** §2.5: end this chat() with a REBUILD of the agent on the SAME
      *  session — extensions, skills and config are read again. */
     readonly requestReload: () => void;

package/dist/dispatch.js

@@ -3,21 +3,22 @@
  * turns. The bodies moved verbatim from chat()'s closure; chat provides
  * the context (the chain, the run state, the prompt arming).
  */
-import { STATUS_GLYPHS, contextRows, contextUnavailableRows, displayVerb, escapeTerminal, helpRows, kUnit, modePickView, modelPickView, compactingStatus, palette, renderEvent, settledLabel, slashCommandNames } from "@vincemakes/kiso-tui";
+import { STATUS_GLYPHS, contextRows, contextUnavailableRows, displayVerb, escapeTerminal, helpRows, kUnit, modePickView, modelPickView, namedPickView, compactingStatus, palette, renderEvent, settledLabel, slashCommandNames } from "@vincemakes/kiso-tui";
 import { newSessionId } from "./session-id.js";
 import { buildAdapter, lookupModelMetadata, resolveContinuationScope, resolveReasoning } from "@vincemakes/kiso-runtime/internal";
-import { MODES, MODE_NOTE, OFFERED_MODES, getMode, setMode } from "./mode.js";
+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 { 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";
-import { preferences, setPreference } from "./preferences.js";
+import { preferences, rememberEffort, setPreference } from "./preferences.js";
 import { settingsRows } from "./settings.js";
 import { floorOn, settingsLayers } from "./state.js";
 import { currentGround } from "@vincemakes/kiso-tui-cells/render";
-import { queuedSwitchLines } from "./state.js";
+import { queuedSwitchLines, seenUnknownTasks, tasksFor } from "./state.js";
+import { taskOutput, taskRow, taskStateLabel } from "./task-notice.js";
 import { contextWindowTokens, microcompactThresholdFor, startStatusSpinner, statedContextWindow, windowSourceNote } from "./chat.js";
 import { authForProfile, directWriteProfile, profileAvailable, resolveContextWindow, unavailableReason } from "./config.js";
 import { shellTool } from "@vincemakes/kiso-tools-node";
@@ -97,7 +98,7 @@ function effortAxis(p) {
         // the sentence the coordination note asked for: said only when the
         // cursor could NOT land where the previous selection asked.
         ...(carried !== undefined && carried !== "default" && carriedIdx < 0 && defaultIdx >= 0
-            ? { levelNote: `effort ${carried} \u2192 ${levels[defaultIdx]}: the nearest this model supports` }
+            ? { levelNote: `effort ${carried} \u2192 ${levels[defaultIdx]}: this model's default (it has no ${carried})` }
             : {}),
     };
 }
@@ -396,6 +397,16 @@ export function dispatch(line, ctx) {
         });
         return;
     }
+    if (trimmed === "\x02background") {
+        // ADR-0058 (3e) — ctrl+b: the running foreground command(s) to the
+        // background, through the session's TaskManager (§6), at once — a
+        // steer waits for a command to be 2 s old (D1), the key never does.
+        // Off the chain on purpose: it is pressed DURING a run.
+        const moved = tasksFor(ctx.session.id)?.detachAll("person") ?? [];
+        if (moved.length === 0)
+            body.notice("nothing to move to the background");
+        return;
+    }
     if (trimmed === "\x14think") {
         // §2.3 / 0.40.6 — ctrl+t hides thinking (one italic line per block,
         // the open one included) and shows it again. DC-50's mechanism: one
@@ -510,7 +521,9 @@ export function dispatch(line, ctx) {
                 env: process.env,
                 ...(settingsLayers.modeFlag !== undefined ? { modeFlag: settingsLayers.modeFlag } : {}),
                 ...(settingsLayers.modelFlag !== undefined ? { modelFlag: settingsLayers.modelFlag } : {}),
+                dontAskFlag: settingsLayers.dontAskFlag,
                 mode: getMode(),
+                dontAsk: getDontAsk(),
                 model: { label: `${agentModel}${providerLabel(agentBaseUrl, upstreamOf(agentBaseUrl))}${profile === null ? "" : ` · profile ${profile}`}`, profile, switched: settingsLayers.modelSwitched },
                 ground: currentGround(),
                 floorOn,
@@ -563,59 +576,89 @@ export function dispatch(line, ctx) {
         // /mode <name> switches — the notice cell leaves the audit
         // line in the body, the status bar repaints at once.
         ctx.chainRef.current = ctx.chainRef.current.then(async () => {
-            const m = MODES.find((x) => x === trimmed.slice(5).trim());
-            if (trimmed.slice(5).trim() === "") {
+            const arg = trimmed.slice(5).trim();
+            // a tier switch, old names included — and when the switch came
+            // with the old dontAsk tier and leaves with it, a line says so
+            const switchTier = (s) => {
+                const wasOn = getDontAsk();
+                applyModeSetting(s);
+                body.notice(`mode → ${MODE_LABEL[getMode()]}`);
+                if (getDontAsk() !== wasOn)
+                    body.notice(`don't ask → ${getDontAsk() ? "on" : "off"}`);
+                ctx.paintIdle();
+            };
+            if (arg === "") {
                 // DC-36 — BARE /mode PICKS, the way bare /model has since
-                // TUI2-R2 ④. The five tiers are a CLOSED set, which makes
-                // this the least defensible place in the product to have
-                // asked a human to type the answer: everything needed to
-                // make it a choice was on screen and only the choosing was
-                // missing.
+                // TUI2-R2 ④. The tiers are a CLOSED set, which makes this the
+                // least defensible place in the product to have asked a human
+                // to type the answer: everything needed to make it a choice
+                // was on screen and only the choosing was missing.
                 //
-                // The printed form survives VERBATIM wherever there is no
-                // panel to draw — a pipe, a dock-less TTY — because that is
-                // a machine-readable surface and this round moves no bytes
-                // on one. `/mode <name>` is untouched.
+                // The printed form survives wherever there is no panel to
+                // draw — a pipe, a dock-less TTY — because that is a
+                // machine-readable surface. `/mode <name>` is untouched.
                 if (dock.active && ctx.input.panelAsk !== undefined) {
                     const current = getMode();
                     const picked = await new Promise((resolve) => {
                         ctx.input.panelAsk(modePickView({
-                            header: `mode — current: ${current}`,
-                            options: OFFERED_MODES.map((name) => ({ label: name, note: [MODE_NOTE[name], ...(name === current ? ["current"] : [])].join(" · ") })),
+                            // the header names the switch when it is on; the
+                            // rows are the tiers alone — don't ask is not a tier
+                            // and is not offered beside them (owner, 2026-09-30)
+                            header: `mode — current: ${modeDisplay()}`,
+                            options: OFFERED_MODES.map((name) => ({ label: MODE_LABEL[name], note: [MODE_NOTE[name], ...(name === current ? ["current"] : [])].join(" · ") })),
                             // MP-1 (0.40.7): the cursor opens on the tier in force
                             ...(OFFERED_MODES.indexOf(current) >= 0 ? { initial: OFFERED_MODES.indexOf(current) } : {}),
                         }, 
                         // DC-12 (design §4): a panel WAITING ON A HUMAN says ❯.
-                        ctx.isRunning() ? "❯ run paused" : `▸ ${current}`), (v) => resolve(v.action === "picked" ? v.result : null));
+                        ctx.isRunning() ? "❯ run paused" : `▸ ${modeDisplay()}`), (v) => resolve(v.action === "picked" ? v.result : null));
                     });
                     ctx.paintIdle();
                     if (picked === null) {
                         ctx.input.prompt();
                         return; // esc — nothing switched, nothing said
                     }
-                    const chosen = "index" in picked ? OFFERED_MODES[picked.index] : MODES.find((x) => x === picked.custom.trim());
+                    const chosen = "index" in picked ? (OFFERED_MODES[picked.index] === undefined ? undefined : { mode: OFFERED_MODES[picked.index] }) : parseMode(picked.custom);
                     if (chosen === undefined) {
                         bodyLog(`no such mode: ${"index" in picked ? String(picked.index) : picked.custom.trim()}`);
                         bodyLog(`tiers: ${OFFERED_MODES.join(" ")}`);
                     }
                     else {
-                        setMode(chosen);
-                        body.notice(`mode → ${chosen}`);
-                        ctx.paintIdle();
+                        switchTier(chosen);
                     }
                     ctx.input.prompt();
                     return;
                 }
                 bodyLog(`mode ${getMode()}`);
+                if (getDontAsk())
+                    bodyLog("don't ask on");
                 bodyLog(`tiers: ${OFFERED_MODES.join(" ")}`);
             }
-            else if (m === undefined) {
-                bodyLog(`no such mode: ${trimmed.slice(5).trim()}`);
-                bodyLog(`tiers: ${OFFERED_MODES.join(" ")}`);
+            else {
+                const typed = parseMode(arg);
+                if (typed === undefined) {
+                    bodyLog(`no such mode: ${arg}`);
+                    bodyLog(`tiers: ${OFFERED_MODES.join(" ")}`);
+                }
+                else {
+                    switchTier(typed);
+                }
+            }
+            ctx.input.prompt();
+        });
+        return;
+    }
+    if (trimmed === "/dont-ask" || trimmed.startsWith("/dont-ask ")) {
+        // The don't-ask switch on its own — the tier stays. Bare flips it;
+        // `on` / `off` set it. A switch set here outlives tier changes.
+        ctx.chainRef.current = ctx.chainRef.current.then(async () => {
+            const arg = trimmed.slice(9).trim();
+            const want = arg === "" ? !getDontAsk() : arg === "on" ? true : arg === "off" ? false : undefined;
+            if (want === undefined) {
+                bodyLog("usage: /dont-ask [on|off]");
             }
             else {
-                setMode(m);
-                body.notice(`mode → ${m}`);
+                setDontAsk(want);
+                body.notice(`don't ask → ${want ? "on" : "off"}`);
                 ctx.paintIdle();
             }
             ctx.input.prompt();
@@ -684,7 +727,7 @@ export function dispatch(line, ctx) {
                     // DC-12 (design §4): a panel WAITING ON A HUMAN says ❯. The
                     // else-branch keeps ▸ — it names the current tier, which is
                     // what ▸ means everywhere else.
-                    ctx.isRunning() ? "❯ run paused" : `▸ ${getMode()}`), (v) => {
+                    ctx.isRunning() ? "❯ run paused" : `▸ ${modeDisplay()}`), (v) => {
                         // OR-7: the level rides beside the result, so a pick
                         // with no second axis is byte-for-byte the old one.
                         if (v.action === "picked")
@@ -824,6 +867,11 @@ export function dispatch(line, ctx) {
                             // §2.5: the ONE source a reload reads for the model — a
                             // switch made here must survive the rebuild.
                             setModelChoice(arg);
+                            // B1: an explicit effort (typed, or the panel's level) is
+                            // remembered for the profile — where its next NEW session
+                            // starts (preferences.json)
+                            if (direct === null && effortTok !== undefined && reasoning !== undefined)
+                                rememberEffort(profName, effortTok);
                             // The window a PROFILE states travels with the switch,
                             // like the model id and the endpoint. Leaving it behind
                             // is CTX-1 one field over: the row would show a
@@ -1034,15 +1082,31 @@ export function dispatch(line, ctx) {
         // streams), a pipe's "exit" always arrives mid-run, and the
         // approval panel the fix protects only exists on the dock. An idle
         // exit is immediate, byte-for-byte as before, on every surface.
+        // 3e: with live tasks the dock asks first; staying re-prompts
+        const exitAfterAsking = async () => {
+            if (await ctx.confirmExit())
+                ctx.input.close();
+            else
+                ctx.input.prompt();
+        };
         if (ctx.isRunning() && dock.active) {
             if (trimmed === "exit")
                 body.notice("[exit queued — closing after the current run completes]");
-            ctx.chainRef.current = ctx.chainRef.current.then(async () => {
-                ctx.input.close();
-            });
+            ctx.chainRef.current = ctx.chainRef.current.then(exitAfterAsking);
             return;
         }
-        ctx.input.close();
+        void exitAfterAsking();
+        return;
+    }
+    if (trimmed === "/tasks" || trimmed.startsWith("/tasks ")) {
+        // ADR-0058 (3e): the session's tasks, for the PERSON. Everything here
+        // is drawn on the screen and nowhere else — no user_input, no event
+        // in the session log, nothing the model sees, no wake.
+        ctx.chainRef.current = ctx.chainRef.current.then(async () => {
+            await tasksCommand(trimmed.slice("/tasks".length).trim(), ctx);
+            ctx.paintIdle();
+            ctx.input.prompt();
+        });
         return;
     }
     if (trimmed === "/clear") {
@@ -1188,3 +1252,76 @@ export function dispatch(line, ctx) {
     // live count rides the status bar (+N queued).
     ctx.submitTurn(line);
 }
+/** ADR-0058 (3e) — `/tasks`, `/tasks show <id>`, `/tasks stop <id>`. On a
+ *  dock the bare command is a pick: a task, then what to do with it. A
+ *  stop is REQUESTED here; the row says `stopping` until the journal says
+ *  how it ended. Looking at the list counts as having seen its unknown
+ *  tasks (the status row stops counting them). */
+async function tasksCommand(arg, ctx) {
+    const manager = tasksFor(ctx.session.id);
+    if (manager === undefined) {
+        bodyLog("no tasks here — this session has no task manager");
+        return;
+    }
+    let list;
+    try {
+        list = manager.list();
+    }
+    catch (err) {
+        bodyLog(`tasks: ${err.message}`);
+        return;
+    }
+    const show = (t) => {
+        const lines = taskOutput(t);
+        bodyLog(`${t.id} — ${t.agent !== undefined ? "its answer" : "its last output"}${lines.length === 0 ? ": nothing yet" : ""}`);
+        for (const line of lines)
+            bodyLog(`  ${line}`);
+    };
+    const stop = (t) => {
+        bodyLog(manager.stop(t.id, "person") ? `${t.id}: stop requested` : `${t.id}: nothing to stop (${taskStateLabel(t)})`);
+    };
+    const [verb, id] = arg.split(/\s+/);
+    if (verb === "show" || verb === "stop") {
+        const t = list.find((x) => x.id === id);
+        if (t === undefined)
+            bodyLog(`no task ${id ?? ""} in this session`);
+        else if (verb === "show")
+            show(t);
+        else
+            stop(t);
+        return;
+    }
+    if (arg !== "") {
+        bodyLog("usage: /tasks · /tasks show <id> · /tasks stop <id>");
+        return;
+    }
+    if (list.length === 0) {
+        bodyLog("no tasks in this session");
+        return;
+    }
+    for (const t of list)
+        if (t.state.kind === "unknown")
+            seenUnknownTasks.add(t.id);
+    if (!dock.active) {
+        for (const t of list) {
+            const r = taskRow(t);
+            bodyLog(`${r.label}  ${r.note}`);
+        }
+        return;
+    }
+    const ask = (header, options) => new Promise((resolve) => {
+        ctx.input.panelAsk(namedPickView("tasks", { header, options }, ctx.isRunning() ? "❯ run paused" : "▸ tasks", "which task? (id) "), (v) => resolve(v.action === "picked" && "index" in v.result ? v.result.index : null));
+    });
+    const shown = list.slice(-20); // the newest twenty; /tasks show <id> reaches any
+    const which = await ask(`tasks — ${list.length} in this session`, shown.map((t) => taskRow(t)));
+    const task = which === null ? undefined : shown[which];
+    if (task === undefined)
+        return;
+    const live = task.state.kind === "running" || task.state.kind === "starting";
+    const actions = [task.agent !== undefined ? "show its answer" : "show its output", ...(live ? ["stop it"] : [])];
+    const action = await ask(`${task.id} · ${taskStateLabel(task)} · ${taskRow(task).note}`, actions.map((label) => ({ label })));
+    if (action === 0)
+        show(task);
+    else if (action === 1)
+        stop(task);
+}

package/dist/empty-sessions.d.ts

@@ -14,8 +14,10 @@ export interface EmptyScan {
 export declare function pidAlive(pid: number): boolean;
 /** Every session in `dirs` with a sidecar and no log. Reads only. */
 export declare function findEmptySessions(dirs: readonly string[], alive?: (pid: number) => boolean): EmptyScan;
-/** The platform's Trash: ~/.Trash on macOS, the freedesktop one elsewhere. */
-export declare function defaultTrashRoot(): string;
+/** The platform's Trash: ~/.Trash on macOS, kiso's own folder on Windows
+ *  (its Recycle Bin is not a folder a program moves files into), the
+ *  freedesktop one elsewhere. */
+export declare function defaultTrashRoot(kisoHome: string): string;
 /** Move the sessions into one new folder under `trashRoot`, keeping each
  *  session folder's name; returns that folder. Never deletes: a file that
  *  cannot be renamed across devices is copied, then unlinked. */

package/dist/empty-sessions.js

@@ -72,10 +72,14 @@ export function findEmptySessions(dirs, alive = pidAlive) {
     }
     return { empty, inUse };
 }
-/** The platform's Trash: ~/.Trash on macOS, the freedesktop one elsewhere. */
-export function defaultTrashRoot() {
+/** The platform's Trash: ~/.Trash on macOS, kiso's own folder on Windows
+ *  (its Recycle Bin is not a folder a program moves files into), the
+ *  freedesktop one elsewhere. */
+export function defaultTrashRoot(kisoHome) {
     if (process.platform === "darwin")
         return join(homedir(), ".Trash");
+    if (process.platform === "win32")
+        return join(kisoHome, "trash");
     return join(process.env.XDG_DATA_HOME ?? join(homedir(), ".local", "share"), "Trash", "files");
 }
 /** Move the sessions into one new folder under `trashRoot`, keeping each

package/dist/external-editor.js

@@ -23,6 +23,7 @@
 import { spawnSync } from "node:child_process";
 import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { launchCommand } from "./launch.js";
 /**
  * Run `bin` on `text` and return what came back, or `null` when the edit
  * failed — in which case `onFailure` has already been told, in one line,
@@ -43,7 +44,9 @@ export function runExternalEditor(bin, root, text, onFailure) {
     const file = join(dir, "message.md"); // .md so the editor lights it up
     try {
         writeFileSync(file, text, { encoding: "utf8", mode: 0o600 });
-        const r = spawnSync(bin, [file], { stdio: "inherit", shell: false });
+        // Windows: an editor is often a .cmd shim (code.cmd) — through cmd.exe
+        const l = launchCommand(bin, [file]);
+        const r = spawnSync(l.file, [...l.args], { stdio: "inherit", shell: false, ...(l.windowsVerbatimArguments === true ? { windowsVerbatimArguments: true } : {}) });
         if (r.error !== undefined || (r.status !== null && r.status !== 0)) {
             onFailure(`[ctrl+g] ${bin} exited ${r.status ?? "abnormally"} — the composer is unchanged`);
             return null;