@vincemakes/kiso-code 0.50.0 → 0.51.0

package/dist/chat.js

@@ -9,7 +9,7 @@ import { escapeTerminal, cacheHitPct, decodeRate, palette, renderEvent, renderRe
 import { askView, coldResumeLine, coldResumeView, deletionRiskHint, editFileHunksDiff, hunksOf, writeFileDiff } from "@vincemakes/kiso-tui";
 import { canonicalTargetPath, isProtectedPath, protectedIdentity, shellProgressPath } from "@vincemakes/kiso-tools-node";
 import { deliveryLines, liveTasks, lostToldOf, mergedConfig, queuedSwitchLines, setExitTasks, tasksFor, taskWhatOf } from "./state.js";
-import { budgetSpentLine, taskCounts, taskNoticeLines, taskNoticeRows, tasksForDisplay } from "./task-notice.js";
+import { budgetSpentLine, cappedWaitLine, taskCounts, taskNoticeLines, taskNoticeRows, tasksForDisplay } from "./task-notice.js";
 import { current as inRunCompaction, takeKept as takeKeptCompaction } from "./in-run-compaction.js";
 import { echoText } from "@vincemakes/kiso-tui-cells/render";
 import { canonicalizeUsage, RunClosedError } from "@vincemakes/kiso-runtime";
@@ -1063,6 +1063,9 @@ onInputLanded) {
                             reason = m[1];
                     }
                     body.toolResult(ev.callId, { content: text, isError: ev.isError, reason, ...((ev.tags ?? []).includes("created") ? { created: true } : {}) });
+                    const capped = ev.isError ? null : cappedWaitLine(text);
+                    if (capped !== null)
+                        body.notice(capped);
                     break;
                 }
                 case "text_delta":
@@ -1642,7 +1645,7 @@ export async function chat(session, faux, input, autoCompact, nav, seed) {
             dock.setLive(liveRow(compactingStatus(runGlyph, summary.rounds, summary.tokens, Math.round((Date.now() - summary.since) / 1000), W - 20, retryOnRow(), summary.progress, "auto"), ["esc stops"], W));
             return;
         }
-        dock.setLive(workingRow(runGlyph, runStart, runUsage.out, lastTokPerSec, rowWidth(), retryOnRow(), detachableNow()));
+        dock.setLive(workingRow(runGlyph, runStart, runUsage.out, rowWidth(), retryOnRow(), detachableNow()));
         dock.setBar(barFor(session, { tokPerSec: lastTokPerSec, tasks: taskCountsNow() }));
     };
     // W19: under plan the idle row makes the posture unmistakable — the W4

package/dist/config.d.ts

@@ -31,6 +31,20 @@
  * with an invalid value is likewise loud; unknown top-level keys are
  * ignored (forward compatibility).
  */
+/** The reasoning-effort levels a profile may declare: the registry's own
+ *  vocabulary (without `default`, which is "send nothing"). */
+declare const EFFORT_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
+type EffortLevel = (typeof EFFORT_LEVELS)[number];
+/** A profile's own claim about its route's effort levels (the same kind of
+ *  claim as `contextWindow`: yours, not ours). */
+export interface ProfileEffort {
+    readonly levels: readonly EffortLevel[];
+    /** the level the route uses when none is sent; omit or null = unknown */
+    readonly default?: EffortLevel | null;
+    /** the route's spelling where it differs from the level's name, e.g.
+     *  `{ "none": "off" }`; each key must be one of `levels` */
+    readonly values?: Readonly<Partial<Record<EffortLevel, string>>>;
+}
 /** OR-1: `openai-responses` is a DIALECT, not a vendor — the same kind
  *  drives the first-party Responses API and the ChatGPT subscription
  *  backend, and which one it is follows the profile's baseUrl (and so
@@ -67,6 +81,15 @@ export interface ModelProfile {
      * registry, where every figure has to carry a source.
      */
     readonly contextWindow?: number;
+    /**
+     * The reasoning-effort levels this profile's route accepts, for a route
+     * the registry has no row for (a gateway, a new model). It enables the
+     * effort picker and the `/model <profile> <level>` form; the levels are
+     * YOUR claim. A route that refuses a level answers 400, and nothing here
+     * hides it. `kiso`'s own table wins nowhere over this: your declaration
+     * replaces the registry's levels for this model at this endpoint.
+     */
+    readonly effort?: ProfileEffort;
     /**
      * What this endpoint FORWARDS to, when `baseUrl` is a local proxy — a URL
      * (`https://gateway.example/v1`) or a name (`my gateway`). It never
@@ -88,6 +111,10 @@ export interface ModelProfile {
      */
     readonly headers?: Readonly<Record<string, string>>;
 }
+/** Hand every profile's declared effort levels to the registry's lookup
+ *  (called once, right after the config is merged). A profile without a
+ *  declaration is not touched, and one that declares nothing changes nothing. */
+export declare function applyEffortDeclarations(cfg: KisoConfig): void;
 export interface AutoCompactConfig {
     readonly thresholdRatio: number;
 }
@@ -228,3 +255,4 @@ export declare function resolveAutoCompact(merged: KisoConfig): AutoCompactConfi
  *  gate, and it could not anyway, since an untrusted project's config is
  *  never read. */
 export declare function resolveProjectTrustPolicy(merged: KisoConfig): "ask" | "never";
+export {};

package/dist/config.js

@@ -37,7 +37,10 @@ import { join, win32 } from "node:path";
 import { kisoHome } from "./state.js";
 import { MODE_VALUES, parseMode } from "./mode.js";
 import { AuthError, effectiveBaseUrl, endpointCredentialId, getCredential, providerIdOf } from "./auth/credentials.js";
-import { BUILTIN_MANIFESTS } from "@vincemakes/kiso-runtime/internal";
+import { BUILTIN_MANIFESTS, declareEffort } from "@vincemakes/kiso-runtime/internal";
+/** The reasoning-effort levels a profile may declare: the registry's own
+ *  vocabulary (without `default`, which is "send nothing"). */
+const EFFORT_LEVELS = ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
 /** Header names a profile may not set: credentials (a key never lives in the
  *  config file) and the framing the adapter owns. */
 const REFUSED_HEADERS = new Set(["authorization", "proxy-authorization", "x-api-key", "api-key", "cookie", "host", "content-length", "content-type", "transfer-encoding", "connection"]);
@@ -59,6 +62,61 @@ function parseHeaders(field, raw, fail) {
     }
     return out;
 }
+function parseEffort(field, raw, fail) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+        fail(field, "expected an object: { levels: [...], default?: ..., values?: { ... } }");
+    const o = raw;
+    for (const k of Object.keys(o))
+        if (k !== "levels" && k !== "default" && k !== "values")
+            fail(`${field}.${k}`, "unknown key (levels, default and values are the only ones)");
+    const known = (v) => typeof v === "string" && EFFORT_LEVELS.includes(v);
+    if (!Array.isArray(o.levels) || o.levels.length === 0 || o.levels.length > EFFORT_LEVELS.length)
+        fail(`${field}.levels`, `expected 1 to ${EFFORT_LEVELS.length} levels`);
+    const levels = [];
+    for (const l of o.levels) {
+        if (!known(l))
+            fail(`${field}.levels`, `${JSON.stringify(l)} is not a level (${EFFORT_LEVELS.join(", ")})`);
+        if (levels.includes(l))
+            fail(`${field}.levels`, `${l} is listed twice`);
+        levels.push(l);
+    }
+    let def;
+    if (o.default !== undefined && o.default !== null) {
+        if (!known(o.default) || !levels.includes(o.default))
+            fail(`${field}.default`, "expected null or one of the listed levels");
+        def = o.default;
+    }
+    else if (o.default === null)
+        def = null;
+    let values;
+    if (o.values !== undefined) {
+        if (o.values === null || typeof o.values !== "object" || Array.isArray(o.values))
+            fail(`${field}.values`, "expected an object of level names to the route's spelling");
+        values = {};
+        for (const [k, v] of Object.entries(o.values)) {
+            if (!known(k) || !levels.includes(k))
+                fail(`${field}.values.${k}`, "expected one of the listed levels");
+            if (typeof v !== "string" || !/^[A-Za-z0-9_.-]{1,24}$/.test(v))
+                fail(`${field}.values.${k}`, "expected a short word (letters, digits, . _ -)");
+            values[k] = v;
+        }
+    }
+    return { levels, ...(def !== undefined ? { default: def } : {}), ...(values !== undefined ? { values } : {}) };
+}
+/** Hand every profile's declared effort levels to the registry's lookup
+ *  (called once, right after the config is merged). A profile without a
+ *  declaration is not touched, and one that declares nothing changes nothing. */
+export function applyEffortDeclarations(cfg) {
+    for (const profile of Object.values(cfg.models ?? {})) {
+        if (profile.effort === undefined)
+            continue;
+        declareEffort(profile.model, profile.baseUrl, {
+            levels: profile.effort.levels,
+            default: profile.effort.default ?? null,
+            ...(profile.effort.values !== undefined ? { values: profile.effort.values } : {}),
+        });
+    }
+}
 const KINDS = ["openai-compat", "anthropic", "openai-responses"];
 export class ConfigError extends Error {
 }
@@ -192,6 +250,7 @@ export function parseConfig(text, source) {
             if (p.upstream !== undefined && (typeof p.upstream !== "string" || p.upstream.trim() === ""))
                 fail(`models.${name}.upstream`, "expected the URL or name of what this endpoint forwards to");
             const headers = p.headers === undefined ? undefined : parseHeaders(`models.${name}.headers`, p.headers, fail);
+            const effort = p.effort === undefined ? undefined : parseEffort(`models.${name}.effort`, p.effort, fail);
             models[name] = {
                 kind: p.kind,
                 model: p.model,
@@ -202,6 +261,7 @@ export function parseConfig(text, source) {
                 ...(typeof p.contextWindow === "number" ? { contextWindow: p.contextWindow } : {}),
                 ...(typeof p.upstream === "string" ? { upstream: p.upstream.trim() } : {}),
                 ...(headers !== undefined ? { headers } : {}),
+                ...(effort !== undefined ? { effort } : {}),
             };
         }
         out.models = models;

package/dist/create-coding-agent.js

@@ -14,7 +14,7 @@ import { migrationNotice, pendingLegacyIds, planMigration, runMigration } from "
 import { askUi, resolveProjectTrust } from "./trust-ui.js";
 import { isFirstRun, scaffoldFirstRun } from "./first-run.js";
 import { fauxSkip, readFauxScript } from "./faux-glue.js";
-import { loadProjectConfig, loadUserConfig, mergeConfigs, resolveContextWindow, resolveModel } from "./config.js";
+import { applyEffortDeclarations, loadProjectConfig, loadUserConfig, mergeConfigs, resolveContextWindow, resolveModel } from "./config.js";
 import { builtInLayer } from "./builtin.js";
 import { recordLearnedWindow, useLearnedWindows } from "./learned-windows.js";
 import { compactionDiscardedNotice, contextWindowTokens, knownContextWindow, unknownWindowNotice, windowLearnedNotice } from "./chat.js";
@@ -163,6 +163,9 @@ export async function createCodingAgent(sessionId, input, modelFlag) {
     const userCfg = loadUserConfig();
     const projectCfg = loadProjectConfig(process.cwd(), project !== null);
     const merged = mergeConfigs(userCfg, projectCfg);
+    // a profile's own effort levels reach the registry's lookup before the
+    // picker, `/model <profile> <level>` or a resumed session reads them
+    applyEffortDeclarations(merged);
     // 0.40.6: /settings names each value's layer from these
     settingsLayers.user = userCfg;
     settingsLayers.project = projectCfg;

package/dist/dispatch.js

@@ -100,7 +100,9 @@ function effortAxis(p) {
         // cursor could NOT land where the previous selection asked.
         ...(carried !== undefined && carried !== "default" && carriedIdx < 0 && defaultIdx >= 0
             ? { levelNote: `effort ${carried} \u2192 ${levels[defaultIdx]}: this model's default (it has no ${carried})` }
-            : {}),
+            : effort.declared === true
+                ? { levelNote: "levels declared in your profile" }
+                : {}),
     };
 }
 /** What signs a profile in, for the listing: `stored key` when a key in

package/dist/index.js

@@ -45,7 +45,7 @@ import { activeStoreDir, setActiveStoreDir, agentModel, atFiles, body, bodyLog,
 import { fauxSkip, readFauxScript } from "./faux-glue.js";
 import { barFor, chat, contextWindowTokens, displayCtxRatio, microcompactThresholdFor, statusModelLabel } from "./chat.js";
 import { preferences, usePreferences } from "./preferences.js";
-import { settingsLayers, setChildTurnBudget, stopAllTasks, tasksFor } from "./state.js";
+import { settingsLayers, setChildTurnBudget, setPrintRun, stopAllTasks, tasksFor } from "./state.js";
 import { tasksForDisplay } from "./task-notice.js";
 import { finishChild } from "./child-result.js";
 import { loadUserConfig, resolveAutoCompact } from "./config.js";
@@ -1305,6 +1305,7 @@ async function main() {
             process.exit(2);
         }
         args.splice(printIdx, 2);
+        setPrintRun();
     }
     // merge round B: --model <profile|provider/model> — the top of the model
     // precedence chain; the value flows into createCodingAgent's config resolution.

package/dist/replay.js

@@ -21,7 +21,7 @@
  */
 import { echoText } from "@vincemakes/kiso-tui-cells/render";
 import { bandHeader } from "@vincemakes/kiso-tui-cells/strings";
-import { taskNoticeLines, taskNoticeRows, taskWhat } from "./task-notice.js";
+import { cappedWaitLine, taskNoticeLines, taskNoticeRows, taskWhat } from "./task-notice.js";
 /** 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
@@ -101,6 +101,10 @@ function replayTurn(body, turn, tasks) {
                 const created = (e.tags ?? []).includes("created");
                 body.toolResult(String(e.callId), { content: text, isError: e.isError === true, reason, untimed: true, ...(created ? { created: true } : {}) });
                 results.add(String(e.callId));
+                // 0.50.1: the capped wait's TASK row, as the live run drew it
+                const capped = e.isError === true ? null : cappedWaitLine(text);
+                if (capped !== null)
+                    body.notice(capped);
                 break;
             }
             case "text_delta":

package/dist/resume.js

@@ -32,7 +32,7 @@ export async function resume(session, prompt, faux, input) {
         runUsage = u;
         if (!dock.active)
             return;
-        dock.setLive(workingRow(runGlyph, runStart, u.out, null, width(), retryOnRow()));
+        dock.setLive(workingRow(runGlyph, runStart, u.out, width(), retryOnRow()));
         dock.setBar(barFor(session, { tokPerSec: null }));
     };
     const paintIdle = () => {

package/dist/state.d.ts

@@ -29,6 +29,7 @@ export declare function kisoHome(): string;
  * these state setters have run.
  */
 export declare function secretEnvNamesOf(models: Readonly<Record<string, unknown>>): readonly string[];
+export declare function setPrintRun(): void;
 export declare function codingToolOptions(): {
     readonly workspaceRoot: string;
     readonly excludeRoots: readonly string[];
@@ -37,7 +38,8 @@ export declare function codingToolOptions(): {
     readonly tasks: (sessionId: string | undefined) => ShellTasks | undefined;
     readonly observedRevision: (sessionId: string | undefined, full: string, kind?: "edit" | "write") => string | undefined;
     readonly limits?: {
-        readonly minForegroundMs: number;
+        readonly minForegroundMs?: number;
+        readonly maxForegroundMs?: number;
     };
 };
 /** Amendment 8: what a session's task ran — a lost task's transcript row

package/dist/state.js

@@ -43,11 +43,25 @@ export function secretEnvNamesOf(models) {
             .filter((n) => typeof n === "string" && n.length > 0)),
     ];
 }
+/** 0.50.1 (ADR-0058 Amendment 16): `kiso -p` runs with nobody watching and
+ *  stops its tasks when the one turn ends, so the foreground wait keeps the
+ *  model's value — no ceiling. Set once, where `-p` is parsed. */
+let printRun = false;
+export function setPrintRun() {
+    printRun = true;
+}
 export function codingToolOptions() {
     // KISO_MIN_FOREGROUND_MS — the test rigs' knob (like KISO_AUTO_DETACH_MS):
     // the least foreground wait (ADR-0058 Amendment 10, default 60 s). The
     // rigs that promote a command by a short wait lower it; nothing else does.
     const minForeground = Number.parseInt(process.env.KISO_MIN_FOREGROUND_MS ?? "", 10);
+    // KISO_MAX_FOREGROUND_MS — the rigs' knob for the ceiling (Amendment 15,
+    // default 5 min). `-p` has none whatever the knob says (Amendment 16).
+    const maxForeground = Number.parseInt(process.env.KISO_MAX_FOREGROUND_MS ?? "", 10);
+    const limits = {
+        ...(Number.isFinite(minForeground) && minForeground >= 0 ? { minForegroundMs: minForeground } : {}),
+        ...(printRun ? { maxForegroundMs: 0 } : Number.isFinite(maxForeground) && maxForeground >= 0 ? { maxForegroundMs: maxForeground } : {}),
+    };
     return {
         workspaceRoot: process.cwd(),
         excludeRoots: [kisoHome()],
@@ -55,7 +69,7 @@ export function codingToolOptions() {
         protectedFiles: protectedFiles(),
         tasks: tasksFor,
         observedRevision: observedRevisionFromLog,
-        ...(Number.isFinite(minForeground) && minForeground >= 0 ? { limits: { minForegroundMs: minForeground } } : {}),
+        ...(Object.keys(limits).length > 0 ? { limits } : {}),
     };
 }
 /** ADR-0058 (3b): one TaskManager per session, its directory beside the

package/dist/task-notice.d.ts

@@ -7,6 +7,13 @@ import type { NoticeMark } from "@vincemakes/kiso-tui";
  *  (<what>) — ` — the parenthesis only when the command is known — and the
  *  LAST ` — ` part opening with "it may still be running". One line each. */
 export declare function taskNoticeLines(items: readonly TaskDeliveryItem[], what?: (taskId: string) => string | undefined): string[];
+/** 0.50.1: a command promoted at the foreground ceiling — its shell result
+ *  opens `still running after <wait> ms (the limit; you asked <asked> ms);
+ *  continued as background task <id>` — is said to the person as one TASK
+ *  row: `t3 · moved to the background at the 5m limit · asked 6m 40s`. Only
+ *  this case: every other promotion stays rowless (the task-start row is
+ *  deferred, owner 2026-10-14). */
+export declare function cappedWaitLine(result: string): string | null;
 /** Finding 0480-F9: the chain budget is spent — said to the person once,
  *  so a chain that went quiet on its budget does not look idle. */
 export declare function budgetSpentLine(info: {

package/dist/task-notice.js

@@ -36,6 +36,19 @@ export function taskNoticeLines(items, what) {
     }
     return rows;
 }
+/** 0.50.1: a command promoted at the foreground ceiling — its shell result
+ *  opens `still running after <wait> ms (the limit; you asked <asked> ms);
+ *  continued as background task <id>` — is said to the person as one TASK
+ *  row: `t3 · moved to the background at the 5m limit · asked 6m 40s`. Only
+ *  this case: every other promotion stays rowless (the task-start row is
+ *  deferred, owner 2026-10-14). */
+export function cappedWaitLine(result) {
+    const m = /^still running after (\d+) ms \(the limit; you asked (\d+) ms\); continued as background task (\S+) /.exec(result);
+    if (m === null)
+        return null;
+    const limit = elapsedLabel(Number(m[1]) / 1000).replace(/(?<=m) 0s$/, "");
+    return `✦ task ${m[3]} · moved to the background at the ${limit} limit · asked ${elapsedLabel(Number(m[2]) / 1000)}`;
+}
 /** Finding 0480-F9: the chain budget is spent — said to the person once,
  *  so a chain that went quiet on its budget does not look idle. */
 export function budgetSpentLine(info) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-code",
-	"version": "0.50.0",
+	"version": "0.51.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.50.0",
-		"@vincemakes/kiso-core": "0.50.0",
-		"@vincemakes/kiso-evals": "0.50.0",
-		"@vincemakes/kiso-mcp-ext": "0.50.0",
-		"@vincemakes/kiso-provider-anthropic": "0.50.0",
-		"@vincemakes/kiso-provider-openai": "0.50.0",
-		"@vincemakes/kiso-provider-openai-responses": "0.50.0",
-		"@vincemakes/kiso-runtime": "0.50.0",
-		"@vincemakes/kiso-skills-ext": "0.50.0",
-		"@vincemakes/kiso-subagent-ext": "0.50.0",
-		"@vincemakes/kiso-tools-node": "0.50.0",
-		"@vincemakes/kiso-tui": "0.50.0",
-		"@vincemakes/kiso-tui-cells": "0.50.0"
+		"@vincemakes/kiso-ask-ext": "0.51.0",
+		"@vincemakes/kiso-core": "0.51.0",
+		"@vincemakes/kiso-evals": "0.51.0",
+		"@vincemakes/kiso-mcp-ext": "0.51.0",
+		"@vincemakes/kiso-provider-anthropic": "0.51.0",
+		"@vincemakes/kiso-provider-openai": "0.51.0",
+		"@vincemakes/kiso-provider-openai-responses": "0.51.0",
+		"@vincemakes/kiso-runtime": "0.51.0",
+		"@vincemakes/kiso-skills-ext": "0.51.0",
+		"@vincemakes/kiso-subagent-ext": "0.51.0",
+		"@vincemakes/kiso-tools-node": "0.51.0",
+		"@vincemakes/kiso-tui": "0.51.0",
+		"@vincemakes/kiso-tui-cells": "0.51.0"
 	},
 	"devDependencies": {
 		"@types/node": "^26.1.2",