@vincemakes/kiso-runtime 0.1.18 → 0.1.20

package/dist/agent.d.ts

@@ -42,6 +42,12 @@ export interface AgentDefinition {
     readonly maxTurns?: number;
     readonly maxTokens?: number;
     readonly temperature?: number;
+    /**
+     * DEPRECATED (ADR-0044): the classic auto-compaction path is retired —
+     * the loop ignores this (microcompact absorbed the responsibility; old
+     * sessions' `compacted` events still replay). Kept so old definitions
+     * type-check; removed at 1.0.
+     */
     readonly compaction?: {
         readonly thresholdTokens: number;
     };

package/dist/session.d.ts

@@ -49,6 +49,13 @@ export interface ApprovalRequest {
     readonly name: string;
     readonly input: Readonly<Record<string, unknown>>;
 }
+/** The /compact result — what the NoticeCell shows (ADR-0044). */
+export interface SummarizeResult {
+    readonly coversToSeq: number;
+    readonly summary: string;
+    /** The estimated tokens the compression saved (chars/4 proxy). */
+    readonly savedTokens: number;
+}
 export declare class AgentSession {
     #private;
     readonly id: string;
@@ -78,6 +85,21 @@ export declare class AgentSession {
      * Yields nothing when the session already completed.
      */
     resume(): Run;
+    /**
+     * /compact (ADR-0044): compress the older conversation with a model
+     * summary. Covers the range (previous summary point, boundary] —
+     * boundary = the event before the keepRounds-th most recent round —
+     * and persists ONE `summarized` event. The summary call is OFF-LOOP
+     * through the session's OWN adapter: it writes nothing; a failure
+     * throws and the session is unchanged ("nothing happened"). Returns
+     * null when fewer than keepRounds+1 uncovered rounds exist (nothing
+     * worth covering yet). Crash semantics: a crash BEFORE the persist is
+     * "nothing happened"; after it, a resume projects the compressed view.
+     */
+    summarize(options?: {
+        keepRounds?: number;
+        signal?: AbortSignalLike;
+    }): Promise<SummarizeResult | null>;
     /**
      * Pauses that still await a human decision (durable, survives restart).
      * B 组: a request whose RUN has terminated is DEAD — it is neither
@@ -136,6 +158,10 @@ export interface SessionConfig {
     readonly maxTurns?: number;
     readonly maxTokens?: number;
     readonly temperature?: number;
+    /**
+     * DEPRECATED (ADR-0044): forwarded to the loop's deprecated field,
+     * which IGNORES it — kept for type compatibility, removed at 1.0.
+     */
     readonly compaction?: {
         readonly thresholdTokens: number;
     };

package/dist/session.js

@@ -25,6 +25,7 @@
  */
 import { EventLog, executionLedger, loop, projectMessages, } from "@vincemakes/kiso-core";
 import { denialResult } from "@vincemakes/kiso-core";
+import { estimateSummarySavings, KEEP_RECENT_ROUNDS, lastSummaryPoint, summarizeConversation, summaryBoundarySeq, } from "@vincemakes/kiso-core";
 import { StaleWriterError } from "./store.js";
 /** A session whose disk write was rejected (stale handle) is PERMANENTLY
  * poisoned: its in-memory log no longer matches the disk, so no further
@@ -148,6 +149,42 @@ export class AgentSession {
         this.ensureHealthy();
         return new Run(this.#store, this.#adapter, this.#config, this, undefined, undefined, true);
     }
+    /**
+     * /compact (ADR-0044): compress the older conversation with a model
+     * summary. Covers the range (previous summary point, boundary] —
+     * boundary = the event before the keepRounds-th most recent round —
+     * and persists ONE `summarized` event. The summary call is OFF-LOOP
+     * through the session's OWN adapter: it writes nothing; a failure
+     * throws and the session is unchanged ("nothing happened"). Returns
+     * null when fewer than keepRounds+1 uncovered rounds exist (nothing
+     * worth covering yet). Crash semantics: a crash BEFORE the persist is
+     * "nothing happened"; after it, a resume projects the compressed view.
+     */
+    async summarize(options = {}) {
+        this.ensureHealthy();
+        const keepRounds = options.keepRounds ?? KEEP_RECENT_ROUNDS;
+        const events = this.log.all;
+        const boundary = summaryBoundarySeq(events, keepRounds);
+        if (boundary === undefined)
+            return null;
+        const prevPoint = lastSummaryPoint(events);
+        const covered = projectMessages(events.filter((e) => e.seq > prevPoint && e.seq <= boundary && e.type !== "summarized"));
+        const summary = await summarizeConversation({
+            adapter: this.#adapter,
+            model: this.#config.model,
+            messages: covered,
+            ...(options.signal !== undefined ? { signal: options.signal } : {}),
+        });
+        const full = this.log.append({ type: "summarized", coversToSeq: boundary, summary });
+        // The record rides the LAST recorded run's id — a summarized fact
+        // must never open a run of its own: the open-run gate keys on
+        // terminal-less runIds, and a "compact" runId would block the next
+        // run() ("still has an open run").
+        const records = this.#store.load(this.id);
+        const runId = records.length > 0 ? records[records.length - 1].runId : "compact";
+        await this.persist(runId, full);
+        return { coversToSeq: boundary, summary, savedTokens: estimateSummarySavings(covered, summary) };
+    }
     // ── Phase D: approvals ───────────────────────────────────────────────
     /**
      * Pauses that still await a human decision (durable, survives restart).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-runtime",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "kiso runtime — durable multi-turn agent sessions: AgentDefinition, AgentRuntime, AgentSession, Run, append-only JSONL store.",
   "type": "module",
   "license": "MIT",
@@ -21,11 +21,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@vincemakes/kiso-core": "0.1.18"
+    "@vincemakes/kiso-core": "0.1.20"
   },
   "peerDependencies": {
-    "@vincemakes/kiso-provider-anthropic": "0.1.18",
-    "@vincemakes/kiso-provider-openai": "0.1.18"
+    "@vincemakes/kiso-provider-anthropic": "0.1.20",
+    "@vincemakes/kiso-provider-openai": "0.1.20"
   },
   "peerDependenciesMeta": {
     "@vincemakes/kiso-provider-anthropic": {
@@ -36,7 +36,7 @@
     }
   },
   "devDependencies": {
-    "@vincemakes/kiso-evals": "0.1.18",
+    "@vincemakes/kiso-evals": "0.1.20",
     "@types/node": "^26.1.2",
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"