@vincemakes/kiso-runtime 0.47.3 → 0.48.0

package/dist/provider/metadata.js

@@ -167,6 +167,14 @@ const chatgptRow = (model, opts = {}) => ({
 const OPENAI_MODELS_ASOF_2 = "2026-09-09";
 const CHATGPT_PRESETS_SOURCE_2 = "https://github.com/openai/codex/blob/634ebc1865c6ac840ed3ba118f040d527bf4b55d/codex-rs/models-manager/models.json";
 const ULTRA_LADDER = ["low", "medium", "high", "xhigh", "max", "ultra"];
+/** 0.48.0 (finding 0473-F2): the presets at a later commit, read 2026-10-09.
+ *  The owner's `sol` profile moved to `gpt-6.1-sol` on 2026-10-08, and with
+ *  no row kiso sent it no effort: the remembered `high` never reached the
+ *  wire and no reasoning summary came back. The id answered on the
+ *  subscription backend that night (the 0.47.3 live sessions). No
+ *  first-party row: no model page was read for it. */
+const OPENAI_MODELS_ASOF_3 = "2026-10-09";
+const CHATGPT_PRESETS_SOURCE_3 = "https://github.com/openai/codex/blob/d63a9b8344cfe58bc78bbe319b560378fc8756ef/codex-rs/models-manager/models.json";
 /** The v1 table. Nulls outnumber numbers ON PURPOSE: only values with a
  *  named source enter; everything else waits for one. */
 const ENTRIES = [
@@ -409,6 +417,7 @@ const ENTRIES = [
     openaiRow("gpt-5.6-sol", "medium", { inputPerM: 4, outputPerM: 20, cacheReadPerM: 0.4 }, "https://developers.openai.com/api/docs/models/gpt-5.6-sol", { levels: ["none", "low", "medium", "high", "xhigh", "max"], asOf: OPENAI_MODELS_ASOF_2 }),
     chatgptRow("gpt-6-astra", { levels: ULTRA_LADDER, default: "low", source: CHATGPT_PRESETS_SOURCE_2, asOf: OPENAI_MODELS_ASOF_2 }),
     chatgptRow("gpt-5.6-sol", { levels: ULTRA_LADDER, default: "low", source: CHATGPT_PRESETS_SOURCE_2, asOf: OPENAI_MODELS_ASOF_2 }),
+    chatgptRow("gpt-6.1-sol", { levels: ULTRA_LADDER, default: "low", source: CHATGPT_PRESETS_SOURCE_3, asOf: OPENAI_MODELS_ASOF_3 }),
     // The compat table's SECOND row (roadmap R3.2 §1a step 1): GLM 5.3 Flash
     // through OpenRouter, read from OpenRouter's models API on 2026-09-09. The
     // id is OpenRouter's, so the row is keyed to that origin; the

package/dist/run.js

@@ -7,7 +7,7 @@ import { denialResult, loop, validateArgs } from "@vincemakes/kiso-core";
 import { ABORTED, MergedSignal, abortable, openRunId } from "./recovery.js";
 import { resolveReasoning } from "./provider/metadata.js";
 import { deriveRecoveryPlan, invocationSeqOf } from "./recovery-plan.js";
-import { appendOf, composeApprovalChain, joinPrompt, promptPerAttempt, runBasePrompt } from "./compose.js";
+import { appendOf, composeApprovalChain, composeToolTable, joinPrompt, promptPerAttempt, runBasePrompt } from "./compose.js";
 import { truncationGuard } from "./truncation-guard.js";
 import { overflowBelt } from "./overflow-belt.js";
 import { DEFAULT_STREAM_IDLE_MS, idleGuard } from "./idle-guard.js";
@@ -212,7 +212,11 @@ export class Run {
             // that layer, records the bytes the model was sent. The in-band
             // summary reads the last attempt's snapshot (the prefix the run
             // last sent) or takes one if no attempt has happened yet.
-            const rentParts = { ...(this.#config.systemPrompt !== undefined ? { base: this.#config.systemPrompt } : {}), appends: [] };
+            // RG-F2: the generated table is a ledger line of its own — the
+            // same text runBasePrompt placed between the base and the appends
+            // (one registry read at the same instant, so it cannot differ).
+            const table = (this.#config.toolTable ?? "on") === "on" ? composeToolTable(this.#config.registry, this.#config.toolRules ?? []) : "";
+            const rentParts = { ...(this.#config.systemPrompt !== undefined ? { base: this.#config.systemPrompt } : {}), ...(table !== "" ? { table } : {}), appends: [] };
             let lastPrompt;
             let taken = false;
             const snapshot = () => {

package/dist/session.d.ts

@@ -130,7 +130,7 @@ export declare class AgentSession {
     /** Deliver this session's task transitions to the model: into a live
      *  run at its next safe point, or — idle — held for the next run, or one
      *  continuation run through `onWake` (off with `wake: false`). */
-    useTasks(manager: TaskManager, options?: Pick<TaskDeliveryOptions, "wake" | "onWake" | "windowMs" | "onLost"> & {
+    useTasks(manager: TaskManager, options?: Pick<TaskDeliveryOptions, "wake" | "onWake" | "windowMs" | "maxWakes" | "onLost"> & {
         readonly autoDetachMinAgeMs?: number;
     }): () => void;
     /** ADR-0057 §5 (3e D1) — a person's steer arrived: the foreground

package/dist/tasks/delivery.d.ts

@@ -15,8 +15,8 @@
  * Exactly once, from the log: a transition counts as delivered when a
  * `user_input` whose `via.items` names it is in the session's log (ADR-0051
  * Amendment 8). The set is a cache rebuilt from the log, never a second
- * truth. Lineage from the log too: a task started inside a wake run (a run
- * whose first input is a task notice) never wakes — depth 1.
+ * truth. The chain budget from the log too (ADR-0058 Amendment 9): the wake
+ * runs since the last run a person started are counted, never kept.
  *
  * The summary snapshot is what the MODEL was told, never the live journal:
  * a compaction must not reveal a transition that has not been delivered.
@@ -43,12 +43,16 @@ import { type Run } from "../run.js";
 import { type TaskInfo, type TaskManager } from "./manager.js";
 export interface TaskDeliveryOptions {
     readonly manager: TaskManager;
-    /** The session's durable events: receipts and lineage are read here. */
+    /** The session's durable events: receipts and the chain are read here. */
     readonly events: () => readonly Event[];
     /** The session's live run, when one is running. */
     readonly liveRun: () => Run | undefined;
     /** False turns every wake into a notify (the switch, ADR-0058 §8.4). */
     readonly wake?: boolean;
+    /** ADR-0058 Amendment 9 — the chain budget: how many autonomous wakes may follow
+     *  one person's input before a terminal delivers as a notify instead.
+     *  Replaces ADR-0058 §8 guard 3 (lineage depth 1). Default 20. */
+    readonly maxWakes?: number;
     /** Start ONE continuation run whose first input is this notice. */
     readonly onWake?: (input: {
         readonly content: string;
@@ -65,6 +69,7 @@ export interface TaskDeliveryOptions {
     /** Read a task's output tail (injectable for tests). */
     readonly readTail?: (task: TaskInfo, bytes: number) => string;
 }
+export declare const DEFAULT_MAX_WAKES = 20;
 export declare class TaskDelivery {
     #private;
     constructor(options: TaskDeliveryOptions);

package/dist/tasks/delivery.js

@@ -15,8 +15,8 @@
  * Exactly once, from the log: a transition counts as delivered when a
  * `user_input` whose `via.items` names it is in the session's log (ADR-0051
  * Amendment 8). The set is a cache rebuilt from the log, never a second
- * truth. Lineage from the log too: a task started inside a wake run (a run
- * whose first input is a task notice) never wakes — depth 1.
+ * truth. The chain budget from the log too (ADR-0058 Amendment 9): the wake
+ * runs since the last run a person started are counted, never kept.
  *
  * The summary snapshot is what the MODEL was told, never the live journal:
  * a compaction must not reveal a transition that has not been delivered.
@@ -44,6 +44,7 @@ import { isRuntimeInput } from "@vincemakes/kiso-core";
 import { NOTICE_FOOTER as FOOTER } from "../run.js";
 import { endTransitionOf } from "./manager.js";
 const key = (i) => `${i.taskId}:${i.transition}`;
+export const DEFAULT_MAX_WAKES = 20;
 /** ADR-0058 3d (D3): a child's excerpt, and a group's excerpts together. */
 const CHILD_EXCERPT_BYTES = 4_096;
 const GROUP_EXCERPT_BYTES = 16_384;
@@ -166,7 +167,8 @@ export class TaskDelivery {
         const mode = this.#modeOf(task, item);
         if (mode === "silent")
             return;
-        this.#buffer.push({ item, line: this.#line(task, item), mode });
+        const spent = mode === "notify" && this.#eligible(task, item) && !this.#underBudget();
+        this.#buffer.push({ item, line: spent ? `${this.#line(task, item)}\nchain budget spent: ${this.#wakesSinceLastPerson()} autonomous wakes since the person's last message — continue when they speak` : this.#line(task, item), mode });
         if (this.#timer === null)
             this.#timer = setTimeout(() => this.#flush(), this.#o.windowMs ?? 1_000);
     }
@@ -221,7 +223,7 @@ export class TaskDelivery {
         }
         this.#scanned = events.length;
     }
-    /** ADR-0058 §8 defaults, then the guards: the switch, and lineage. */
+    /** ADR-0058 §8 defaults, then the guards: the switch, and the chain budget. */
     #modeOf(task, item) {
         if (item.transition === "ready" || item.transition === "stopped" || item.transition === "unknown")
             return "notify";
@@ -232,17 +234,45 @@ export class TaskDelivery {
         return this.#wakes(item) ? "wake" : "notify";
     }
     #wakes(item) {
-        if (this.#o.wake === false)
-            return false;
-        if (item.transition !== "exited" && item.transition !== "failed")
-            return false;
         const task = this.#o.manager.get(item.taskId);
-        if (task === undefined || task.executionId === undefined || task.profile === "service")
+        if (task === undefined || !this.#eligible(task, item))
             return false;
         // a child wakes only with its whole group (D2): never on its own
         if (task.agent !== undefined && !this.#complete(this.#groupOf(task)))
             return false;
-        return !this.#startedInWakeRun(task.executionId);
+        return this.#underBudget();
+    }
+    /** The transition could wake, budget aside: the switch, a terminal, an
+     *  execution's task, not a service. */
+    #eligible(task, item) {
+        if (this.#o.wake === false)
+            return false;
+        if (item.transition !== "exited" && item.transition !== "failed")
+            return false;
+        if (task.executionId === undefined || task.profile === "service")
+            return false;
+        return true;
+    }
+    /** ADR-0058 Amendment 9: the chain budget, derived from the log — never a
+     *  counter. The count is the wake runs (first input a runtime notice)
+     *  since the last run a person started. */
+    #underBudget() {
+        return this.#wakesSinceLastPerson() < (this.#o.maxWakes ?? DEFAULT_MAX_WAKES);
+    }
+    #wakesSinceLastPerson() {
+        let wakes = 0;
+        let firstOfRun = true;
+        for (const e of this.#o.events()) {
+            if (e.type === "terminal") {
+                firstOfRun = true;
+                continue;
+            }
+            if (e.type !== "user_input" || !firstOfRun)
+                continue;
+            firstOfRun = false;
+            wakes = isRuntimeInput(e) ? wakes + 1 : 0;
+        }
+        return wakes;
     }
     /** ADR-0058 3d: an agent task has ended — a failure goes into a live run
      *  at once; every end waits for its group. */
@@ -383,22 +413,6 @@ export class TaskDelivery {
         attrs.push(existsSync(result) ? `result="${result}"` : `output="${task.outputPath}"`);
         return `<kiso-task ${attrs.join(" ")}/>`;
     }
-    /** Lineage depth 1: the run that started the task began with a notice. */
-    #startedInWakeRun(executionId) {
-        const events = this.#o.events();
-        const at = events.findIndex((e) => e.type === "tool_execution_started" && e.executionId === executionId);
-        if (at < 0)
-            return false;
-        let start = 0;
-        for (let n = at - 1; n >= 0; n--) {
-            if (events[n].type === "terminal") {
-                start = n + 1;
-                break;
-            }
-        }
-        const first = events.slice(start, at).find((e) => e.type === "user_input");
-        return isRuntimeInput(first);
-    }
     #line(task, item) {
         const attrs = [`id="${task.id}"`, `status="${item.transition}"`];
         if (task.state.kind === "ended" && task.state.exitCode !== null)

package/dist/trace/guard.js

@@ -176,6 +176,7 @@ export class RequestTracer {
         const rent = buildRentLedger({
             model: options.model,
             ...(rentParts?.base !== undefined ? { base: rentParts.base } : {}),
+            ...(rentParts?.table !== undefined ? { table: rentParts.table } : {}),
             ...(rentParts?.appends !== undefined ? { appends: rentParts.appends } : {}),
             ...(tools !== undefined ? { tools } : {}),
         });

package/dist/trace/rent.d.ts

@@ -11,10 +11,17 @@
  *
  *   - system:base       the session's own prompt as the CLI handed it
  *                       (built-in constant + project instructions — the
- *                       runtime cannot split those, R3). The runtime's
- *                       generated tool table is machinery BETWEEN base and
- *                       appends; it stays out of the ledger (counts live
- *                       in tool:<name> lines and the base's own line).
+ *                       runtime cannot split those, R3).
+ *   - system:tools      the runtime's generated tool table (compose.ts,
+ *                       composeToolTable): the routing rows, the fixed
+ *                       directives, each tool's snippet and guidelines,
+ *                       between the base and the appends. OVERTURNS the
+ *                       E3 note that it "stays out of the ledger (counts
+ *                       live in tool:<name> lines)": the table is prose
+ *                       the tool specs do not contain (1,686 chars at
+ *                       f42a0edc), so the ledger was short by that much
+ *                       on every request (finding RG-F2, kiso-doc
+ *                       plan-rent-gate rev 2).
  *   - system:ext:<name> one line per extension with a non-empty
  *                       systemPrompt.append, measured on the append
  *                       string, in load order.
@@ -44,7 +51,7 @@
  */
 import type { ToolSpec } from "@vincemakes/kiso-core";
 export interface RentLine {
-    /** "system:base" | "system:ext:<name>" | "tool:<name>" | "envelope" */
+    /** "system:base" | "system:tools" | "system:ext:<name>" | "tool:<name>" | "envelope" */
     surface: string;
     /** length of the serialized surface, measured, never a copy */
     chars: number;
@@ -59,6 +66,9 @@ export declare const RENT_LINE_FIELDS: readonly ["surface", "chars", "estTokens"
  *  systemPrompt is the result — the parts are the ledger's inputs). */
 export interface RentParts {
     base?: string;
+    /** RG-F2: the generated tool table's text, as composed for the run
+     *  (absent when the table is off or the registry is empty). */
+    table?: string;
     appends?: readonly {
         name: string;
         text: string;
@@ -68,7 +78,7 @@ export interface RentInput extends RentParts {
     model: string;
     tools?: readonly ToolSpec[];
 }
-/** The one ledger: system:base, then system:ext:* (load order), then
+/** The one ledger: system:base, then system:tools, then system:ext:* (load order), then
  *  tool:* (the array's order — the registry's toSpecs() order), then the
  *  envelope. Absent surfaces contribute no lines (R9). */
 export declare function buildRentLedger(input: RentInput): RentLine[];

package/dist/trace/rent.js

@@ -11,10 +11,17 @@
  *
  *   - system:base       the session's own prompt as the CLI handed it
  *                       (built-in constant + project instructions — the
- *                       runtime cannot split those, R3). The runtime's
- *                       generated tool table is machinery BETWEEN base and
- *                       appends; it stays out of the ledger (counts live
- *                       in tool:<name> lines and the base's own line).
+ *                       runtime cannot split those, R3).
+ *   - system:tools      the runtime's generated tool table (compose.ts,
+ *                       composeToolTable): the routing rows, the fixed
+ *                       directives, each tool's snippet and guidelines,
+ *                       between the base and the appends. OVERTURNS the
+ *                       E3 note that it "stays out of the ledger (counts
+ *                       live in tool:<name> lines)": the table is prose
+ *                       the tool specs do not contain (1,686 chars at
+ *                       f42a0edc), so the ledger was short by that much
+ *                       on every request (finding RG-F2, kiso-doc
+ *                       plan-rent-gate rev 2).
  *   - system:ext:<name> one line per extension with a non-empty
  *                       systemPrompt.append, measured on the append
  *                       string, in load order.
@@ -49,13 +56,15 @@ const line = (surface, text) => ({
     chars: text.length,
     estTokens: Math.ceil(text.length / 4),
 });
-/** The one ledger: system:base, then system:ext:* (load order), then
+/** The one ledger: system:base, then system:tools, then system:ext:* (load order), then
  *  tool:* (the array's order — the registry's toSpecs() order), then the
  *  envelope. Absent surfaces contribute no lines (R9). */
 export function buildRentLedger(input) {
     const lines = [];
     if (input.base !== undefined)
         lines.push(line("system:base", input.base));
+    if (input.table !== undefined && input.table !== "")
+        lines.push(line("system:tools", input.table));
     for (const append of input.appends ?? [])
         lines.push(line(`system:ext:${append.name}`, append.text));
     for (const tool of input.tools ?? []) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-runtime",
-	"version": "0.47.3",
+	"version": "0.48.0",
 	"description": "kiso runtime \u2014 durable multi-turn agent sessions: AgentDefinition, AgentRuntime, AgentSession, Run, append-only JSONL store.",
 	"type": "module",
 	"license": "MIT",
@@ -25,12 +25,12 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-core": "0.47.3"
+		"@vincemakes/kiso-core": "0.48.0"
 	},
 	"peerDependencies": {
-		"@vincemakes/kiso-provider-anthropic": "0.47.3",
-		"@vincemakes/kiso-provider-openai": "0.47.3",
-		"@vincemakes/kiso-provider-openai-responses": "0.47.3"
+		"@vincemakes/kiso-provider-anthropic": "0.48.0",
+		"@vincemakes/kiso-provider-openai": "0.48.0",
+		"@vincemakes/kiso-provider-openai-responses": "0.48.0"
 	},
 	"peerDependenciesMeta": {
 		"@vincemakes/kiso-provider-anthropic": {
@@ -44,7 +44,7 @@
 		}
 	},
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.47.3",
+		"@vincemakes/kiso-evals": "0.48.0",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"