@vincemakes/kiso-runtime 0.42.0 → 0.42.2

package/dist/compose.d.ts

@@ -43,7 +43,8 @@ export declare function composeToolTable(registry: ToolRegistry, rules?: ToolRul
  * No appends → the base passes through byte-identical.
  */
 /** An extension's append as text: a string as is, a function evaluated
- *  NOW (0.42.0 — the per-run seam; call this once per composition). */
+ *  NOW (0.42.0 — call this once per attempt). 0.42.1 (#14): a function
+ *  may answer undefined — no append this attempt, no separator. */
 export declare function appendOf(extension: KisoExtension): string | undefined;
 export declare function composeSystemPrompt(base: string | undefined, extensions: readonly KisoExtension[]): string | undefined;
 /** The base and the append texts, \n\n-joined; no appends → the base as is. */

package/dist/compose.js

@@ -4,10 +4,13 @@
  * hook composition (the existing come first), and the loop's microcompact config lookup.
  */
 export function runBasePrompt(systemPrompt, registry, rules = [], table = "on") {
+    // 0.42.1 (the products' request #15): "" composes as ABSENT — never a
+    // bare separator ahead of the table or the appends.
+    const base = systemPrompt === "" ? undefined : systemPrompt;
     if (table === "off")
-        return systemPrompt;
+        return base;
     const toolTable = composeToolTable(registry, rules);
-    return toolTable === "" ? systemPrompt : systemPrompt === undefined ? toolTable : `${systemPrompt}\n\n${toolTable}`;
+    return toolTable === "" ? base : base === undefined ? toolTable : `${base}\n\n${toolTable}`;
 }
 /** The table, or "" when the registry is empty (no vocabulary, no tools). */
 export function composeToolTable(registry, rules = []) {
@@ -36,7 +39,8 @@ export function composeToolTable(registry, rules = []) {
  * No appends → the base passes through byte-identical.
  */
 /** An extension's append as text: a string as is, a function evaluated
- *  NOW (0.42.0 — the per-run seam; call this once per composition). */
+ *  NOW (0.42.0 — call this once per attempt). 0.42.1 (#14): a function
+ *  may answer undefined — no append this attempt, no separator. */
 export function appendOf(extension) {
     const append = extension.systemPrompt?.append;
     return typeof append === "function" ? append() : append;
@@ -49,9 +53,10 @@ export function composeSystemPrompt(base, extensions) {
 }
 /** The base and the append texts, \n\n-joined; no appends → the base as is. */
 export function joinPrompt(base, appends) {
+    const head = base === "" ? undefined : base; // 0.42.1 (#15): "" is absent
     if (appends.length === 0)
-        return base;
-    return base === undefined ? appends.join("\n\n") : `${base}\n\n${appends.join("\n\n")}`;
+        return head;
+    return head === undefined ? appends.join("\n\n") : `${head}\n\n${appends.join("\n\n")}`;
 }
 /** 0.42.0: the OUTERMOST adapter layer — `compose` runs exactly once per
  *  provider attempt (a retry is a new attempt) and its result is the

package/dist/trace/guard.js

@@ -274,7 +274,7 @@ export class RequestTracer {
                 this.#provider === "anthropic"
                     ? p.inputTokens ?? 0
                     : p.inputTokens !== null
-                        ? Math.max(0, p.inputTokens - (p.cacheRead ?? 0))
+                        ? Math.max(0, p.inputTokens - (p.cacheRead ?? 0) - (p.cacheWrite ?? 0)) // 0.42.2 (#17): the same arithmetic as canonical.ts
                         : 0;
             record.cacheRead = p.cacheRead ?? 0;
             record.cacheWrite = p.cacheWrite ?? null;

package/dist/usage/canonical.d.ts

@@ -118,7 +118,11 @@ export declare function priceFor(route: string, u: {
 }, table: PricingTable): number | null;
 /** Raw → canonical (the accounting boundary). Behavior-preserving against
  *  the guard's incumbent per-provider branch (guard.ts settle): anthropic
- *  input is fresh as-is; every other route subtracts cacheRead.
+ *  input is fresh as-is; every other route subtracts cacheRead — and,
+ *  0.42.2 (#17), cacheWrite when the provider reported one: a "total"
+ *  prompt count includes the tokens written to the cache, and they are
+ *  priced as the write, never twice. total = input + cacheRead +
+ *  cacheWrite holds by construction on both routes.
  *
  *  The trailing `table` parameter is the injection slot (R5b-④a): the
  *  R5a-1-commercial table rides it on day one, defaulting to the pinned

package/dist/usage/canonical.js

@@ -35,7 +35,7 @@ import { lookupModelMetadata } from "../provider/metadata.js";
  *  total), preserved by construction. */
 export const INPUT_CONVENTIONS = {
     anthropic: "fresh", // input_tokens excludes the cached prefix
-    "openai-compat": "total", // prompt_tokens includes the cached prefix
+    "openai-compat": "total", // prompt_tokens includes the cached prefix AND, on a gateway that reports it, the written one
 };
 /** Pricing table v1. Freeze date 2026-08-13 (the E2 ruling). Rates:
  *  DeepSeek's published rates (https://api-docs.deepseek.com/quick_start/pricing),
@@ -80,7 +80,11 @@ export function priceFor(route, u, table) {
 }
 /** Raw → canonical (the accounting boundary). Behavior-preserving against
  *  the guard's incumbent per-provider branch (guard.ts settle): anthropic
- *  input is fresh as-is; every other route subtracts cacheRead.
+ *  input is fresh as-is; every other route subtracts cacheRead — and,
+ *  0.42.2 (#17), cacheWrite when the provider reported one: a "total"
+ *  prompt count includes the tokens written to the cache, and they are
+ *  priced as the write, never twice. total = input + cacheRead +
+ *  cacheWrite holds by construction on both routes.
  *
  *  The trailing `table` parameter is the injection slot (R5b-④a): the
  *  R5a-1-commercial table rides it on day one, defaulting to the pinned
@@ -92,7 +96,7 @@ export function canonicalizeUsage(route, raw, table = PRICING_TABLE_V1) {
         ? 0
         : convention === "fresh"
             ? raw.inputTokens
-            : Math.max(0, raw.inputTokens - (raw.cacheRead ?? 0));
+            : Math.max(0, raw.inputTokens - (raw.cacheRead ?? 0) - (raw.cacheWrite ?? 0));
     const cacheRead = raw.cacheRead ?? 0;
     const cacheWrite = raw.cacheWrite ?? null;
     const output = raw.outputTokens ?? 0;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-runtime",
-	"version": "0.42.0",
+	"version": "0.42.2",
 	"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.42.0"
+		"@vincemakes/kiso-core": "0.42.2"
 	},
 	"peerDependencies": {
-		"@vincemakes/kiso-provider-anthropic": "0.42.0",
-		"@vincemakes/kiso-provider-openai": "0.42.0",
-		"@vincemakes/kiso-provider-openai-responses": "0.42.0"
+		"@vincemakes/kiso-provider-anthropic": "0.42.2",
+		"@vincemakes/kiso-provider-openai": "0.42.2",
+		"@vincemakes/kiso-provider-openai-responses": "0.42.2"
 	},
 	"peerDependenciesMeta": {
 		"@vincemakes/kiso-provider-anthropic": {
@@ -44,7 +44,7 @@
 		}
 	},
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.42.0",
+		"@vincemakes/kiso-evals": "0.42.2",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"