@namzu/sdk 34.2.0 → 36.0.0

package/dist/compaction/index.js

@@ -13,4 +13,10 @@ export { clearStaleToolResults, isClearedToolResult, DEFAULT_KEEP_RECENT_TOOL_RE
 // can offer, rather than something that only happens when a threshold trips.
 export { compactNow, compactRegion } from './manual.js';
 export { COMPACTION_HEADER, buildCompactionMessage, isCompactionMessage } from './summary.js';
+// The salience-scored working set: every message scored, the least salient
+// evicted first. See `docs/sdk/salience-working-set.md`.
+export { DEFAULT_SALIENCE_CONFIG, DEFAULT_SALIENCE_WEIGHTS, buildGoal, isStubbedNarration, messageText, planWorkingSet, scoreMessages, } from './salience/index.js';
+export { DEFAULT_SOFT_TARGET, planSalienceWorkingSet } from './plan.js';
+// Episodic → semantic: what a run learned, as the entry a later run searches.
+export { CONSOLIDATION_TAG, consolidationEntry } from './consolidation.js';
 //# sourceMappingURL=index.js.map

package/dist/compaction/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compaction/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAQzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACN,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gCAAgC,EAChC,0BAA0B,GAC1B,MAAM,0BAA0B,CAAA;AAGjC,4EAA4E;AAC5E,6EAA6E;AAC7E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compaction/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAQzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACN,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gCAAgC,EAChC,0BAA0B,GAC1B,MAAM,0BAA0B,CAAA;AAGjC,4EAA4E;AAC5E,6EAA6E;AAC7E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAE7F,2EAA2E;AAC3E,yDAAyD;AACzD,OAAO,EACN,uBAAuB,EACvB,wBAAwB,EACxB,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,aAAa,GACb,MAAM,qBAAqB,CAAA;AAY5B,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAEvE,8EAA8E;AAC9E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/compaction/manager.d.ts

@@ -1,11 +1,18 @@
 import type { CompactionConfig } from '../config/runtime.js';
 import type { FileAction, PlanSlot, ToolResultSlot, WorkingState } from './types.js';
+/** Pins kept at most; the oldest is dropped past this, and the drop is counted. */
+export declare const MAX_PINS = 40;
+/** Characters one pin may carry; a pin is a fact, not a document. */
+export declare const MAX_PIN_CHARS = 600;
 export declare class WorkingStateManager {
     private state;
     private readonly config;
     constructor(config: CompactionConfig);
     setTask(task: string): void;
     setPlan(plan: PlanSlot[]): void;
+    /** Pin a fact under `key`, replacing what that key held; empty text unpins. */
+    pin(key: string, text: string, source: string): void;
+    unpin(key: string): void;
     trackFile(path: string, action: FileAction): void;
     addDecision(decision: string): void;
     /**

package/dist/compaction/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/compaction/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAY,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAkB9F,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAKpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI;IAI/B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IASjD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIjC,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAW3C,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAU7C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUpC,SAAS,IAAI,MAAM;IAenB,QAAQ,IAAI,YAAY;IAIxB;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIvC,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,gBAAgB;CAsBxB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/compaction/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EACX,UAAU,EAGV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,MAAM,YAAY,CAAA;AAEnB,mFAAmF;AACnF,eAAO,MAAM,QAAQ,KAAK,CAAA;AAC1B,qEAAqE;AACrE,eAAO,MAAM,aAAa,MAAM,CAAA;AAmBhC,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAKpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI;IAI/B,+EAA+E;IAC/E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBpD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IASjD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIjC,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAW3C,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAU7C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUpC,SAAS,IAAI,MAAM;IAgBnB,QAAQ,IAAI,YAAY;IAIxB;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIvC,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,gBAAgB;CAsBxB"}

package/dist/compaction/manager.js

@@ -1,7 +1,12 @@
+/** Pins kept at most; the oldest is dropped past this, and the drop is counted. */
+export const MAX_PINS = 40;
+/** Characters one pin may carry; a pin is a fact, not a document. */
+export const MAX_PIN_CHARS = 600;
 function createEmptyState() {
     return {
         task: '',
         plan: [],
+        pins: new Map(),
         files: new Map(),
         decisions: [],
         failures: [],
@@ -26,6 +31,31 @@ export class WorkingStateManager {
     setPlan(plan) {
         this.state.plan = plan;
     }
+    /** Pin a fact under `key`, replacing what that key held; empty text unpins. */
+    pin(key, text, source) {
+        const k = key.trim();
+        if (k.length === 0)
+            return;
+        const body = text.trim().slice(0, MAX_PIN_CHARS);
+        if (body.length === 0) {
+            this.state.pins?.delete(k);
+            return;
+        }
+        if (!this.state.pins)
+            this.state.pins = new Map();
+        this.state.pins.delete(k);
+        this.state.pins.set(k, { key: k, text: body, source, updatedAt: Date.now() });
+        while (this.state.pins.size > MAX_PINS) {
+            const oldest = [...this.state.pins.values()].sort((a, b) => a.updatedAt - b.updatedAt)[0];
+            if (!oldest)
+                break;
+            this.state.pins.delete(oldest.key);
+            this.state.evicted.pins = (this.state.evicted.pins ?? 0) + 1;
+        }
+    }
+    unpin(key) {
+        this.state.pins?.delete(key.trim());
+    }
     trackFile(path, action) {
         const existing = this.state.files.get(path);
         if (existing) {
@@ -92,6 +122,7 @@ export class WorkingStateManager {
         if (this.state.task)
             count++;
         count += this.state.plan.length;
+        count += this.state.pins?.size ?? 0;
         count += this.state.files.size;
         count += this.state.decisions.length;
         count += this.state.failures.length;

package/dist/compaction/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/compaction/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/compaction/manager.ts"],"names":[],"mappings":"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"}

package/dist/compaction/plan.d.ts

@@ -1,5 +1,6 @@
 import type { CompactionConfig } from '../config/runtime.js';
 import type { Message } from '../types/message/index.js';
+import { type WorkingSetPlan } from './salience/working-set.js';
 /**
  * The compaction decision, with no run attached.
  *
@@ -38,6 +39,8 @@ export type CompactionPlan = {
     readonly kind: 'cleared';
     readonly messages: readonly Message[];
     readonly clearedCount: number;
+    /** Assistant narrations cut to their first sentence by the salience pass. */
+    readonly stubbedCount?: number;
     readonly charsReclaimed: number;
     readonly reclaimedTokens: number;
     readonly reliefWasEnough: boolean;
@@ -96,6 +99,26 @@ export interface CompactionPlanInput {
  * the phase's copy is gone and its tests point here.
  */
 export declare function naiveKeepStartByTokens(messages: readonly Message[], budgetTokens: number): number;
+/**
+ * The salience pass: score every message and evict the least salient
+ * until the context is under `softTarget`. Returned as a `cleared` plan
+ * so the phase commits it the way it commits the stale-result pass; the
+ * summary path runs after it only when the trigger threshold is still
+ * exceeded.
+ */
+/** Where the salience pass holds the context, as a fraction of the window. */
+export declare const DEFAULT_SOFT_TARGET = 0.5;
+export declare function planSalienceWorkingSet(input: {
+    readonly messages: readonly Message[];
+    readonly config: CompactionConfig;
+    readonly contextWindowTokens: number;
+    readonly estimatedTokens: number;
+    readonly openTasks?: readonly string[];
+}): Extract<CompactionPlan, {
+    kind: 'cleared';
+}> & {
+    readonly working: WorkingSetPlan;
+};
 export declare function planCompaction(input: CompactionPlanInput): CompactionPlan;
 /**
  * Below this, a pass would summarise almost nothing and pay a model call to

package/dist/compaction/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/compaction/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAIxD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wCAAwC;AACxC,MAAM,MAAM,oBAAoB;AAC/B,4EAA4E;AAC1E,kBAAkB;AACpB,oFAAoF;GAClF,iBAAiB;AACnB,6DAA6D;GAC3D,aAAa;AACf,oEAAoE;GAClE,eAAe,CAAA;AAElB,MAAM,MAAM,cAAc,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChE;IACA,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAChC,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C,QAAQ,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;IAC1C,QAAQ,CAAC,cAAc,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CACzB,CAAA;AAEJ,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CACtC;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAajG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAgHzE;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/compaction/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAIxD,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,2BAA2B,CAAA;AAI/E;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wCAAwC;AACxC,MAAM,MAAM,oBAAoB;AAC/B,4EAA4E;AAC1E,kBAAkB;AACpB,oFAAoF;GAClF,iBAAiB;AACnB,6DAA6D;GAC3D,aAAa;AACf,oEAAoE;GAClE,eAAe,CAAA;AAElB,MAAM,MAAM,cAAc,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChE;IACA,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAChC,GACD;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C,QAAQ,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;IAC1C,QAAQ,CAAC,cAAc,EAAE,SAAS,OAAO,EAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CACzB,CAAA;AAEJ,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAajG;AAED;;;;;;GAMG;AACH,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC,GAAG,OAAO,CAAC,cAAc,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAyBtF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAiHzE;AAED;;;GAGG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA"}

package/dist/compaction/plan.js

@@ -1,27 +1,9 @@
-import { CHARS_PER_TOKEN } from '../constants/limits.js';
 import { findSafeTrimIndex } from './dangling.js';
+import { buildGoal } from './salience/goal.js';
+import { scoreMessages } from './salience/score.js';
+import { planWorkingSet } from './salience/working-set.js';
+import { estimateMessageTokens, estimateMessagesTokens } from './token-estimate.js';
 import { clearStaleToolResults } from './tool-result-editing.js';
-/**
- * How many characters a message's content is worth.
- *
- * An image costs far fewer tokens than its base64 length divided by four —
- * but under-counting it to zero is the worse error: it let a run full of
- * screenshots read as an empty context.
- */
-function measureContentChars(content) {
-    if (typeof content === 'string')
-        return content.length;
-    if (!Array.isArray(content))
-        return 0;
-    let total = 0;
-    for (const block of content) {
-        if (block.type === 'text' && typeof block.text === 'string')
-            total += block.text.length;
-        else if (block.type === 'image' && typeof block.data === 'string')
-            total += block.data.length;
-    }
-    return total;
-}
 /**
  * The last index whose tail fits in `budgetTokens`, walking backwards.
  *
@@ -43,7 +25,7 @@ export function naiveKeepStartByTokens(messages, budgetTokens) {
     let tokens = 0;
     let start = messages.length;
     for (let index = messages.length - 1; index >= 0; index--) {
-        const cost = Math.ceil(measureContentChars(messages[index]?.content) / CHARS_PER_TOKEN);
+        const cost = estimateMessageTokens(messages[index]);
         // Checked BEFORE adding, so the boundary never includes a message
         // that pushes the tail over. Adding first and trimming after would
         // admit one oversized message on every run.
@@ -54,6 +36,41 @@ export function naiveKeepStartByTokens(messages, budgetTokens) {
     }
     return start;
 }
+/**
+ * The salience pass: score every message and evict the least salient
+ * until the context is under `softTarget`. Returned as a `cleared` plan
+ * so the phase commits it the way it commits the stale-result pass; the
+ * summary path runs after it only when the trigger threshold is still
+ * exceeded.
+ */
+/** Where the salience pass holds the context, as a fraction of the window. */
+export const DEFAULT_SOFT_TARGET = 0.5;
+export function planSalienceWorkingSet(input) {
+    const { config, estimatedTokens, contextWindowTokens: budget } = input;
+    const goal = buildGoal(input.messages, {
+        ...(input.openTasks ? { openTasks: input.openTasks } : {}),
+    });
+    const scored = scoreMessages(input.messages, {
+        goal,
+        keepRecentMessages: config.keepRecentMessages,
+    });
+    const working = planWorkingSet(input.messages, scored, {
+        estimatedTokens,
+        targetTokens: Math.floor(budget * (config.softTarget ?? DEFAULT_SOFT_TARGET)),
+        minToolResultChars: config.minToolResultCharsToClear,
+        ...(config.preserveToolResultsFrom ? { preserveTools: config.preserveToolResultsFrom } : {}),
+    });
+    return {
+        kind: 'cleared',
+        messages: working.messages,
+        clearedCount: working.clearedCount,
+        stubbedCount: working.stubbedCount,
+        charsReclaimed: working.charsReclaimed,
+        reclaimedTokens: working.reclaimedTokens,
+        reliefWasEnough: (estimatedTokens - working.reclaimedTokens) / budget < config.triggerThreshold,
+        working,
+    };
+}
 export function planCompaction(input) {
     const { config, estimatedTokens, contextWindowTokens: budget } = input;
     if (!input.skipToolResultClear && config.clearToolResults !== false) {
@@ -67,7 +84,7 @@ export function planCompaction(input) {
             ...(config.preserveToolResultsFrom ? { preserveTools: config.preserveToolResultsFrom } : {}),
         });
         if (edit.clearedCount > 0) {
-            const reclaimedTokens = Math.ceil(edit.charsReclaimed / CHARS_PER_TOKEN);
+            const reclaimedTokens = estimateMessagesTokens(input.messages) - estimateMessagesTokens(edit.messages);
             // NOT on a forced pass. A forced pass runs because the provider
             // REJECTED the prompt as too long, which is a measurement — and
             // answering it with the same estimate the provider just refuted

package/dist/compaction/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/compaction/plan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/compaction/plan.ts"],"names":[],"mappings":"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"}

package/dist/compaction/salience/bm25.d.ts

@@ -0,0 +1,26 @@
+/**
+ * BM25 over the run's own messages.
+ *
+ * The corpus is small — a few hundred documents at most — so the index
+ * is rebuilt from term frequencies each pass rather than maintained
+ * incrementally; the arithmetic is the cost of a few string splits. The
+ * constants are the textbook ones (k1 = 1.2, b = 0.75). What matters
+ * here is not ranking quality against a web corpus but that a message
+ * mentioning the goal's identifiers outscores one that does not, and
+ * that a term every message contains (the run's own file name, say)
+ * stops counting.
+ */
+export interface Bm25Document {
+    readonly tf: ReadonlyMap<string, number>;
+    readonly length: number;
+}
+export interface Bm25Index {
+    readonly documents: readonly Bm25Document[];
+    readonly documentFrequency: ReadonlyMap<string, number>;
+    readonly averageLength: number;
+}
+export declare function indexDocument(text: string): Bm25Document;
+export declare function buildIndex(documents: readonly Bm25Document[]): Bm25Index;
+/** BM25 score of one document for a query given as tokens. */
+export declare function bm25Score(index: Bm25Index, doc: Bm25Document, queryTokens: readonly string[]): number;
+//# sourceMappingURL=bm25.d.ts.map

package/dist/compaction/salience/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../../src/compaction/salience/bm25.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAA;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC9B;AAKD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAGxD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAcxE;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CACxB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAgBR"}

package/dist/compaction/salience/bm25.js

@@ -0,0 +1,56 @@
+/**
+ * BM25 over the run's own messages.
+ *
+ * The corpus is small — a few hundred documents at most — so the index
+ * is rebuilt from term frequencies each pass rather than maintained
+ * incrementally; the arithmetic is the cost of a few string splits. The
+ * constants are the textbook ones (k1 = 1.2, b = 0.75). What matters
+ * here is not ranking quality against a web corpus but that a message
+ * mentioning the goal's identifiers outscores one that does not, and
+ * that a term every message contains (the run's own file name, say)
+ * stops counting.
+ */
+import { termFrequencies, tokenize } from './tokenize.js';
+const K1 = 1.2;
+const B = 0.75;
+export function indexDocument(text) {
+    const tokens = tokenize(text);
+    return { tf: termFrequencies(tokens), length: tokens.length };
+}
+export function buildIndex(documents) {
+    const documentFrequency = new Map();
+    let total = 0;
+    for (const doc of documents) {
+        total += doc.length;
+        for (const term of doc.tf.keys()) {
+            documentFrequency.set(term, (documentFrequency.get(term) ?? 0) + 1);
+        }
+    }
+    return {
+        documents,
+        documentFrequency,
+        averageLength: documents.length === 0 ? 0 : total / documents.length,
+    };
+}
+/** BM25 score of one document for a query given as tokens. */
+export function bm25Score(index, doc, queryTokens) {
+    if (doc.length === 0 || index.documents.length === 0)
+        return 0;
+    const n = index.documents.length;
+    let score = 0;
+    const seen = new Set();
+    for (const term of queryTokens) {
+        if (seen.has(term))
+            continue;
+        seen.add(term);
+        const tf = doc.tf.get(term);
+        if (!tf)
+            continue;
+        const df = index.documentFrequency.get(term) ?? 0;
+        const idf = Math.log(1 + (n - df + 0.5) / (df + 0.5));
+        const norm = tf + K1 * (1 - B + (B * doc.length) / Math.max(1, index.averageLength));
+        score += idf * ((tf * (K1 + 1)) / norm);
+    }
+    return score;
+}
+//# sourceMappingURL=bm25.js.map

package/dist/compaction/salience/bm25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.js","sourceRoot":"","sources":["../../../src/compaction/salience/bm25.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAazD,MAAM,EAAE,GAAG,GAAG,CAAA;AACd,MAAM,CAAC,GAAG,IAAI,CAAA;AAEd,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC7B,OAAO,EAAE,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAAkC;IAC5D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAA;IACnD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,KAAK,IAAI,GAAG,CAAC,MAAM,CAAA;QACnB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACpE,CAAC;IACF,CAAC;IACD,OAAO;QACN,SAAS;QACT,iBAAiB;QACjB,aAAa,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM;KACpE,CAAA;AACF,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CACxB,KAAgB,EAChB,GAAiB,EACjB,WAA8B;IAE9B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9D,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAA;IAChC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACd,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC,EAAE;YAAE,SAAQ;QACjB,MAAM,EAAE,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;QACrD,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAA;QACpF,KAAK,IAAI,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/compaction/salience/goal.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The goal vector: what "relevant" is measured against.
+ *
+ * Not the whole history — that would make every message relevant to
+ * itself — but the four things that say what the run is for right now:
+ * the first user message (the task), the most recent user turns (the
+ * requirements as they were refined), the open items of the task list
+ * when the run keeps one, and the latest assistant text (its stated
+ * intent). Weighted by repetition rather than a coefficient: the task
+ * statement is included twice so a run that has drifted into detail is
+ * still scored against what it was asked to do.
+ */
+import type { Message } from '../../types/message/index.js';
+export interface GoalSources {
+    /** Titles of task-list items not yet completed, when the host keeps a task store. */
+    readonly openTasks?: readonly string[];
+    /** How many of the latest user turns count as live requirements. */
+    readonly recentUserTurns?: number;
+}
+export declare function buildGoal(messages: readonly Message[], sources?: GoalSources): string;
+//# sourceMappingURL=goal.d.ts.map

package/dist/compaction/salience/goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.d.ts","sourceRoot":"","sources":["../../../src/compaction/salience/goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAE3D,MAAM,WAAW,WAAW;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,CAqBzF"}

package/dist/compaction/salience/goal.js

@@ -0,0 +1,32 @@
+/**
+ * The goal vector: what "relevant" is measured against.
+ *
+ * Not the whole history — that would make every message relevant to
+ * itself — but the four things that say what the run is for right now:
+ * the first user message (the task), the most recent user turns (the
+ * requirements as they were refined), the open items of the task list
+ * when the run keeps one, and the latest assistant text (its stated
+ * intent). Weighted by repetition rather than a coefficient: the task
+ * statement is included twice so a run that has drifted into detail is
+ * still scored against what it was asked to do.
+ */
+export function buildGoal(messages, sources = {}) {
+    const users = messages.filter((m) => m.role === 'user' && typeof m.content === 'string');
+    const first = users[0]?.content ?? '';
+    const recent = users
+        .slice(-(sources.recentUserTurns ?? 3))
+        .map((m) => m.content)
+        .filter((text) => text !== first);
+    let latestIntent = '';
+    for (let i = messages.length - 1; i >= 0; i -= 1) {
+        const m = messages[i];
+        if (m.role === 'assistant' && typeof m.content === 'string' && m.content.trim().length > 0) {
+            latestIntent = m.content;
+            break;
+        }
+    }
+    return [first, first, ...recent, ...(sources.openTasks ?? []), latestIntent]
+        .filter((part) => part.length > 0)
+        .join('\n');
+}
+//# sourceMappingURL=goal.js.map

package/dist/compaction/salience/goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.js","sourceRoot":"","sources":["../../../src/compaction/salience/goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,UAAU,SAAS,CAAC,QAA4B,EAAE,UAAuB,EAAE;IAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC5B,CAAC,CAAC,EAA2C,EAAE,CAC9C,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CACnD,CAAA;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;IACrC,MAAM,MAAM,GAAG,KAAK;SAClB,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAA;IAClC,IAAI,YAAY,GAAG,EAAE,CAAA;IACrB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAY,CAAA;QAChC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5F,YAAY,GAAG,CAAC,CAAC,OAAO,CAAA;YACxB,MAAK;QACN,CAAC;IACF,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC;SAC1E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,IAAI,CAAC,CAAA;AACb,CAAC"}

package/dist/compaction/salience/index.d.ts

@@ -0,0 +1,4 @@
+export { buildGoal, type GoalSources } from './goal.js';
+export { DEFAULT_SALIENCE_CONFIG, DEFAULT_SALIENCE_WEIGHTS, type ProtectedReason, type SalienceConfig, type SalienceWeights, type ScoreOptions, type ScoredMessage, messageText, scoreMessages, } from './score.js';
+export { type WorkingSetAction, type WorkingSetOptions, type WorkingSetPlan, isStubbedNarration, planWorkingSet, } from './working-set.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compaction/salience/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compaction/salience/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EACN,uBAAuB,EACvB,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,WAAW,EACX,aAAa,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,kBAAkB,EAClB,cAAc,GACd,MAAM,kBAAkB,CAAA"}

package/dist/compaction/salience/index.js

@@ -0,0 +1,4 @@
+export { buildGoal } from './goal.js';
+export { DEFAULT_SALIENCE_CONFIG, DEFAULT_SALIENCE_WEIGHTS, messageText, scoreMessages, } from './score.js';
+export { isStubbedNarration, planWorkingSet, } from './working-set.js';
+//# sourceMappingURL=index.js.map

package/dist/compaction/salience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/compaction/salience/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAA;AACvD,OAAO,EACN,uBAAuB,EACvB,wBAAwB,EAMxB,WAAW,EACX,aAAa,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAIN,kBAAkB,EAClB,cAAc,GACd,MAAM,kBAAkB,CAAA"}

package/dist/compaction/salience/minhash.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Near-duplicate detection with MinHash over word shingles.
+ *
+ * Two tool results are rarely byte-identical — a timestamp, a duration,
+ * a line number moves — and still the same output. Three-word shingles
+ * hashed 64 ways give a Jaccard estimate that is stable against those
+ * edits and cheap enough to compare every message against every other
+ * once per pass at the sizes a run reaches. Hashing is FNV-1a with a
+ * per-slot seed; nothing here needs to be cryptographic, only consistent
+ * within a process.
+ */
+/** The signature of `tokens`; an empty signature for fewer than one shingle. */
+export declare function minhash(tokens: readonly string[]): Uint32Array;
+/** Estimated Jaccard similarity of two signatures, 0..1. */
+export declare function similarity(a: Uint32Array, b: Uint32Array): number;
+export declare function isEmptySignature(signature: Uint32Array): boolean;
+//# sourceMappingURL=minhash.d.ts.map

package/dist/compaction/salience/minhash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minhash.d.ts","sourceRoot":"","sources":["../../../src/compaction/salience/minhash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAgB9D;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,CAIjE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAEhE"}

package/dist/compaction/salience/minhash.js

@@ -0,0 +1,54 @@
+/**
+ * Near-duplicate detection with MinHash over word shingles.
+ *
+ * Two tool results are rarely byte-identical — a timestamp, a duration,
+ * a line number moves — and still the same output. Three-word shingles
+ * hashed 64 ways give a Jaccard estimate that is stable against those
+ * edits and cheap enough to compare every message against every other
+ * once per pass at the sizes a run reaches. Hashing is FNV-1a with a
+ * per-slot seed; nothing here needs to be cryptographic, only consistent
+ * within a process.
+ */
+const HASHES = 64;
+const SHINGLE = 3;
+function fnv1a(text, seed) {
+    let hash = (0x811c9dc5 ^ seed) >>> 0;
+    for (let i = 0; i < text.length; i += 1) {
+        hash ^= text.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash;
+}
+/** The signature of `tokens`; an empty signature for fewer than one shingle. */
+export function minhash(tokens) {
+    const signature = new Uint32Array(HASHES).fill(0xffffffff);
+    if (tokens.length < SHINGLE) {
+        if (tokens.length === 0)
+            return signature;
+        const single = tokens.join(' ');
+        for (let slot = 0; slot < HASHES; slot += 1)
+            signature[slot] = fnv1a(single, slot);
+        return signature;
+    }
+    for (let i = 0; i + SHINGLE <= tokens.length; i += 1) {
+        const shingle = `${tokens[i]} ${tokens[i + 1]} ${tokens[i + 2]}`;
+        for (let slot = 0; slot < HASHES; slot += 1) {
+            const h = fnv1a(shingle, slot);
+            if (h < signature[slot])
+                signature[slot] = h;
+        }
+    }
+    return signature;
+}
+/** Estimated Jaccard similarity of two signatures, 0..1. */
+export function similarity(a, b) {
+    let same = 0;
+    for (let slot = 0; slot < HASHES; slot += 1)
+        if (a[slot] === b[slot])
+            same += 1;
+    return same / HASHES;
+}
+export function isEmptySignature(signature) {
+    return signature.every((h) => h === 0xffffffff);
+}
+//# sourceMappingURL=minhash.js.map

package/dist/compaction/salience/minhash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minhash.js","sourceRoot":"","sources":["../../../src/compaction/salience/minhash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,GAAG,EAAE,CAAA;AACjB,MAAM,OAAO,GAAG,CAAC,CAAA;AAEjB,SAAS,KAAK,CAAC,IAAY,EAAE,IAAY;IACxC,IAAI,IAAI,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC1B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,OAAO,CAAC,MAAyB;IAChD,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAClF,OAAO,SAAS,CAAA;IACjB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;QAChE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YAC9B,IAAI,CAAC,GAAI,SAAS,CAAC,IAAI,CAAY;gBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACzD,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAA;AACjB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,CAAc,EAAE,CAAc;IACxD,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,CAAC;QAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;YAAE,IAAI,IAAI,CAAC,CAAA;IAC/E,OAAO,IAAI,GAAG,MAAM,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAsB;IACtD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAA;AAChD,CAAC"}

package/dist/compaction/salience/score.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Salience: how much the next step depends on each message.
+ *
+ * The compaction pass chose what to keep by position — the floor, the
+ * last few turns, the last few tool results — and a fact stated in the
+ * middle of a long run aged out at the same rate as chatter. This gives
+ * every message a number instead, from four things the kernel can
+ * observe without a model:
+ *
+ *   recency     how many messages ago, decayed with a half-life;
+ *   relevance   BM25 against the goal — the task, the requirements, the
+ *               open plan items, the latest intent;
+ *   utility     whether it was USED: a tool result whose paths and
+ *               identifiers reappear in a later tool input or assistant
+ *               turn; an instruction from the user;
+ *   redundancy  whether a later message says the same thing — a repeated
+ *               read, the same error twice — so the older copy yields.
+ *
+ * What no score may cross is stated as `protected`: the leading system
+ * run, `retain` markers with the turn they pull in, the most recent
+ * turns, and the other half of a tool-call pair. Pure, like `plan.ts`:
+ * no run, no logger, no provider, so it can be asked without one.
+ */
+import type { Message } from '../../types/message/index.js';
+export interface SalienceWeights {
+    readonly recency: number;
+    readonly relevance: number;
+    readonly utility: number;
+    readonly redundancy: number;
+}
+export declare const DEFAULT_SALIENCE_WEIGHTS: SalienceWeights;
+export interface SalienceConfig {
+    /** Messages after which recency has halved. */
+    readonly halfLifeMessages: number;
+    /** Estimated Jaccard at or above which two messages are the same thing. */
+    readonly duplicateThreshold: number;
+    readonly weights: SalienceWeights;
+}
+export declare const DEFAULT_SALIENCE_CONFIG: SalienceConfig;
+export type ProtectedReason = 'system-floor' | 'retain' | 'recent' | 'pair';
+export interface ScoredMessage {
+    readonly index: number;
+    readonly role: Message['role'];
+    /** Estimated tokens of the message, including rich content and tool inputs. */
+    readonly tokens: number;
+    readonly recency: number;
+    readonly relevance: number;
+    readonly utility: number;
+    readonly redundancy: number;
+    /** The weighted sum; meaningful only relative to the other messages of the same pass. */
+    readonly salience: number;
+    readonly protected: ProtectedReason | null;
+}
+export interface ScoreOptions {
+    /** The goal vector as text: task statement, requirements, open plan items, latest intent. */
+    readonly goal: string;
+    /** How many trailing messages are protected as recent. */
+    readonly keepRecentMessages: number;
+    readonly config?: Partial<SalienceConfig>;
+}
+/** The model-visible text of a message, with an assistant's tool inputs. */
+export declare function messageText(message: Message): string;
+export declare function scoreMessages(messages: readonly Message[], options: ScoreOptions): ScoredMessage[];
+//# sourceMappingURL=score.d.ts.map