@vincemakes/kiso-runtime 0.46.2 → 0.47.0

package/dist/internal.d.ts

@@ -29,7 +29,7 @@ export { canonicalizeUsageForModel } from "./usage/canonical.js";
 export { BUILTIN_MANIFESTS, resolveContinuationScope, type ModelRef, type ProviderManifest } from "./provider/manifest.js";
 export * from "./checkpoint.js";
 export * from "./request-budget.js";
-export { readProfile, readSummary, writeSummary, type ExecutionProfile, type ProfileReadResult } from "./profile.js";
+export { readProfile, readSessionName, readSummary, writeSessionName, writeSummary, type ExecutionProfile, type ProfileReadResult } from "./profile.js";
 export { SUMMARY_MIGRATION_MARKER, listSessionSidecars, migrateSummaries, sessionSummary, summarizeEvents, summaryMigrationPending, type SessionListing, type SessionSummary } from "./session-summary.js";
 export * from "./tasks/journal.js";
 export * from "./tasks/manager.js";

package/dist/internal.js

@@ -38,7 +38,7 @@ export { BUILTIN_MANIFESTS, resolveContinuationScope } from "./provider/manifest
 export * from "./checkpoint.js";
 export * from "./request-budget.js";
 // 0.40.0: the listing reads the recorded workspace and profile name.
-export { readProfile, readSummary, writeSummary } from "./profile.js";
+export { readProfile, readSessionName, readSummary, writeSessionName, writeSummary } from "./profile.js";
 export { SUMMARY_MIGRATION_MARKER, listSessionSidecars, migrateSummaries, sessionSummary, summarizeEvents, summaryMigrationPending } from "./session-summary.js";
 // ADR-0058 §6: the task journal and the TaskManager (internal until the
 // public shape is proven by the shell and delegate steps)

package/dist/profile.d.ts

@@ -83,6 +83,17 @@ export declare function writeProfile(root: string, sessionId: string, profile: E
 export declare function writeSummary(root: string, sessionId: string, summary: import("./session-summary.js").SessionSummary): void;
 /** The summary tenant, or null (no sidecar, no summary, or unreadable). */
 export declare function readSummary(root: string, sessionId: string): import("./session-summary.js").SessionSummary | null;
+/** Graphite R3d — the name the person gave the session (`/name`): the
+ *  sidecar's third tenant, beside `profile` and `summary`, carried
+ *  through their writes untouched as they are through its. Session
+ *  metadata, not an event (ADR-0051 §6's OUT class, the profile's own
+ *  footing): the derivation never reads it; the lists and the title do,
+ *  the derived title (`sessionTitle`) the fallback. Null when unnamed or
+ *  unreadable. */
+export declare function readSessionName(root: string, sessionId: string): string | null;
+/** Name the session, or clear its name (`null`). Atomic and fail-closed
+ *  like every tenant's write; the others' bytes ride through. */
+export declare function writeSessionName(root: string, sessionId: string, name: string | null): void;
 export type ProfileReadResult = {
     readonly kind: "ok";
     readonly profile: ExecutionProfile;

package/dist/profile.js

@@ -80,6 +80,24 @@ export function readSummary(root, sessionId) {
     const t = currentTenants(root, sessionId).summary;
     return t !== undefined && typeof t.updatedAt === "number" ? t : null;
 }
+/** Graphite R3d — the name the person gave the session (`/name`): the
+ *  sidecar's third tenant, beside `profile` and `summary`, carried
+ *  through their writes untouched as they are through its. Session
+ *  metadata, not an event (ADR-0051 §6's OUT class, the profile's own
+ *  footing): the derivation never reads it; the lists and the title do,
+ *  the derived title (`sessionTitle`) the fallback. Null when unnamed or
+ *  unreadable. */
+export function readSessionName(root, sessionId) {
+    const n = currentTenants(root, sessionId).name;
+    return typeof n === "string" && n.trim() !== "" ? n : null;
+}
+/** Name the session, or clear its name (`null`). Atomic and fail-closed
+ *  like every tenant's write; the others' bytes ride through. */
+export function writeSessionName(root, sessionId, name) {
+    const tenants = { ...currentTenants(root, sessionId) };
+    delete tenants.name;
+    writeTenants(root, sessionId, name === null ? tenants : { ...tenants, name });
+}
 function writeTenants(root, sessionId, tenants) {
     const path = profilePath(root, sessionId);
     const tmpDir = mkdtempSync(join(root, ".meta-"));

package/dist/session-summary.d.ts

@@ -68,6 +68,9 @@ export interface SessionListing {
     readonly summary: SessionSummary | null;
     readonly workspace: string | null;
     readonly profileName: string | null;
+    /** Graphite R3d: the name the person gave it (`/name`), or null —
+     *  optional, so a listing built before names existed still types */
+    readonly name?: string | null;
 }
 /** Every session in `root`, from the DIRECTORY and the sidecars only — no
  *  log is opened. The 0.40.0 dogfood's list path. */

package/dist/session-summary.js

@@ -23,7 +23,7 @@
  */
 import { existsSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { readProfile, readSummary, writeSummary } from "./profile.js";
+import { readProfile, readSessionName, readSummary, writeSummary } from "./profile.js";
 import { executionLedger } from "./ledger.js";
 import { openRunId } from "./recovery.js";
 import { sessionTitle } from "./store.js";
@@ -124,6 +124,7 @@ export function listSessionSidecars(root) {
             summary: readSummary(root, id),
             workspace: profile.kind === "ok" ? profile.profile.workspace : null,
             profileName: profile.kind === "ok" ? profile.profile.profileName : null,
+            name: readSessionName(root, id),
         });
     }
     return out;

package/dist/session.d.ts

@@ -514,6 +514,30 @@ export interface ContextPolicy {
             readonly model: string;
             readonly baseUrl?: string;
         }) => void;
+        /** The compaction round (owner, 2026-10-06): an in-run summary call,
+         *  told as `/compact`'s caller is told one — when it starts (the tier
+         *  that fired it, and `onStart`'s pre-call data: the covered rounds
+         *  and their estimated tokens), its progress against the output
+         *  budget (`onProgress`'s reports), and how it ended: `kept` (a
+         *  `summarized` event follows), `discarded` (it did not shrink the
+         *  context; `onDiscard` is told too) or `failed` (both paths refused,
+         *  or the run was aborted). `pre` and `post` are the context's
+         *  chars/4 estimates before and after (equal when nothing was kept).
+         *  Display only: nothing here reaches a request, and a callback that
+         *  throws changes nothing. */
+        readonly onSummary?: (event: {
+            readonly phase: "start";
+            readonly reason: string;
+            readonly info: CompactInfo;
+        } | {
+            readonly phase: "progress";
+            readonly progress: import("./summarize.js").SummaryProgress;
+        } | {
+            readonly phase: "end";
+            readonly outcome: "kept" | "discarded" | "failed";
+            readonly pre: number;
+            readonly post: number;
+        }) => void;
     };
 }
 export interface SessionConfig {

package/dist/session.js

@@ -385,7 +385,7 @@ export class AgentSession {
             const breakerOpen = reason !== "overflow" && this.#summaryFailures >= (tiersPolicy.maxFailures ?? MAX_SUMMARY_FAILURES);
             if (breakerOpen && !urgent)
                 return [];
-            const summarized = breakerOpen ? null : await this.#summarizeInRun(events, messages, t.tail, reason, run, tiersPolicy.onDiscard);
+            const summarized = breakerOpen ? null : await this.#summarizeInRun(events, messages, t.tail, reason, run, tiersPolicy.onDiscard, tiersPolicy.onSummary);
             if (summarized !== null)
                 return [summarized];
             if (!urgent)
@@ -441,10 +441,32 @@ export class AgentSession {
     /** A2 — one in-run summary: in-band first, the serialised form once on
      *  a rejection; null when neither produced a valid checkpoint. The
      *  summary call's usage and path ride the trace ledger, as /compact's do. */
-    async #summarizeInRun(events, messages, tail, reason, run, onDiscard) {
+    async #summarizeInRun(events, messages, tail, reason, run, onDiscard, onSummary) {
         const boundary = checkpointBoundarySeq(events, { keepTokens: tail });
         if (boundary === undefined)
             return null;
+        // the compaction round (owner, 2026-10-06): what /compact's onStart
+        // and onProgress tell its caller, told here too — display only, and
+        // a callback that throws changes nothing
+        const tell = (event) => {
+            try {
+                onSummary?.(event);
+            }
+            catch {
+                // observation only
+            }
+        };
+        const prevPoint = lastSummaryPoint(events);
+        const pre = estimateTokens(projectMessages(events));
+        tell({
+            phase: "start",
+            reason,
+            info: {
+                coversToSeq: boundary,
+                rounds: events.filter((e) => e.type === "user_input" && e.seq > prevPoint && e.seq <= boundary).length,
+                tokens: estimateTokens(projectMessages(events.filter((e) => e.seq > prevPoint && e.seq <= boundary && e.type !== "summarized"))),
+            },
+        });
         const summaryPrompt = typeof run.systemPrompt === "function" ? run.systemPrompt() : run.systemPrompt;
         let path;
         let result;
@@ -453,15 +475,17 @@ export class AgentSession {
                 messages,
                 inBand: { ...(summaryPrompt !== undefined ? { systemPrompt: summaryPrompt } : {}), tools: run.tools() },
                 ...(run.reasoning !== undefined ? { reasoning: run.reasoning } : {}),
-                serialized: () => serializeCovered({ events, prevPoint: lastSummaryPoint(events), boundary }),
+                serialized: () => serializeCovered({ events, prevPoint, boundary }),
                 serializedReasoning: true,
                 budget: MANUAL_SUMMARY_BUDGET,
                 ...(run.signal !== undefined ? { signal: run.signal } : {}),
+                ...(onSummary !== undefined ? { onProgress: (progress) => tell({ phase: "progress", progress }) } : {}),
             }));
         }
         catch {
             if (run.signal?.aborted !== true)
                 this.#summaryFailures += 1;
+            tell({ phase: "end", outcome: "failed", pre, post: pre });
             return null;
         }
         // ADR-0055 Amendment 2 (the shrink invariant): a fire is kept only if
@@ -472,7 +496,6 @@ export class AgentSession {
         // counts toward the breaker.
         const text = this.#withTasks(result.text);
         const fire = { type: "summarized", coversToSeq: boundary, summary: text };
-        const pre = estimateTokens(projectMessages(events));
         const post = estimateTokens(projectMessages([...events, { ...fire, seq: (events.at(-1)?.seq ?? -1) + 1 }]));
         const written = estimateTokens([{ role: "user", content: `${SUMMARY_FRAMING}\n\n${text}` }]);
         const shrinks = pre - post >= written;
@@ -498,9 +521,11 @@ export class AgentSession {
             catch {
                 // observation only — a notice that cannot be shown changes nothing
             }
+            tell({ phase: "end", outcome: "discarded", pre, post });
             return null;
         }
         this.#summaryFailures = 0;
+        tell({ phase: "end", outcome: "kept", pre, post });
         return fire;
     }
     /**

package/dist/store.js

@@ -45,6 +45,7 @@
 import { appendFileSync, closeSync, constants, existsSync, fsyncSync, fstatSync, statSync, ftruncateSync, mkdirSync, openSync, readFileSync, readdirSync, readSync, writeSync, } from "node:fs";
 import { dirname, join } from "node:path";
 import { isKisoEvent } from "@vincemakes/kiso-core";
+import { readSessionName } from "./profile.js";
 import { LockedError, nativeLockAdapter, } from "./lock-adapter.js";
 /** History that does not parse as a contiguous kiso trajectory. */
 export class StoreCorruptionError extends Error {
@@ -441,7 +442,9 @@ export class SessionStore {
                 continue;
             metas.push({
                 id,
-                title: sessionTitle(records),
+                // Graphite R3d: the name the person gave the session, when it has
+                // one; the title derived from its first real line otherwise
+                title: readSessionName(this.root, id) ?? sessionTitle(records),
                 events: records.length,
                 runs: new Set(records.map((r) => r.runId)).size,
                 createdAt: records[0]?.ts ?? 0,

package/package.json

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