@wrongstack/core 0.291.2 → 0.292.0

package/dist/infrastructure/provider-cache-ledger.d.ts

@@ -0,0 +1,48 @@
+import type { EventBus } from '../kernel/events.js';
+export interface ProviderCacheEntry {
+    provider: string;
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+    /** cacheRead / (cacheRead + input); 0 when nothing cached. */
+    hitRatio: number;
+}
+/**
+ * Per-provider prompt-cache accounting for a session. `TokenCounter.cacheStats()`
+ * blends every provider into one figure; this splits it so a session that
+ * switched providers (fallback, `/model`) can show each provider's real
+ * cache-hit ratio.
+ *
+ * New counters provide an exact per-call `deltaUsage`; older event producers
+ * remain compatible through cumulative-snapshot differencing. The explicit
+ * delta keeps attribution correct even when asynchronous price lookups settle
+ * out of order after a provider switch.
+ *
+ * **LIFECYCLE WARNING:** The constructor subscribes to `events.on('token.accounted', …)`,
+ * creating a permanent listener on the shared EventBus. The **caller MUST invoke
+ * `dispose()` on session teardown** (e.g. via the `detachTodosCheckpoint` chain
+ * in `packages/cli/src/wiring/session.ts`). Failure to do so leaks the listener
+ * across session restarts/resumes — every constructor invocation after the first
+ * adds a permanent listener that accumulates unboundedly.
+ */
+export declare class ProviderCacheLedger {
+    private readonly byProvider;
+    private last;
+    private readonly off;
+    constructor(events: EventBus);
+    private record;
+    /** Distinct providers seen this session. */
+    providers(): string[];
+    /** Per-provider cache stats, most-cached first. */
+    perProvider(): ProviderCacheEntry[];
+    /**
+     * Unsubscribe from the event bus and release the per-session listener.
+     *
+     * **The caller MUST invoke `dispose()` on session teardown** — see the
+     * constructor's lifecycle warning. Failure to call this method leaves a
+     * permanent `token.accounted` listener on the shared EventBus that
+     * accumulates unboundedly across session restarts/resumes.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=provider-cache-ledger.d.ts.map

package/dist/infrastructure/provider-cache-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-cache-ledger.d.ts","sourceRoot":"","sources":["../../src/infrastructure/provider-cache-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAQD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,IAAI,CAAoD;IAChE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IAEjC,YAAY,MAAM,EAAE,QAAQ,EAO3B;IAED,OAAO,CAAC,MAAM;IA8Bd,4CAA4C;IAC5C,SAAS,IAAI,MAAM,EAAE,CAEpB;IAED,mDAAmD;IACnD,WAAW,IAAI,kBAAkB,EAAE,CAalC;IAED;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI,CAEd;CACF"}

package/dist/infrastructure/token-counter.d.ts

@@ -14,6 +14,7 @@ export declare class DefaultTokenCounter implements TokenCounter {
     private cacheWrite;
     private costInput;
     private costOutput;
+    private cacheSaved;
     private readonly registry?;
     private readonly providerId?;
     private readonly events?;
@@ -25,12 +26,12 @@ export declare class DefaultTokenCounter implements TokenCounter {
     private lastCacheWrite;
     constructor(opts?: {
         registry?: ModelsRegistry | undefined;
-        providerId?: string | undefined;
+        providerId?: string | (() => string | undefined) | undefined;
         events?: EventBus | undefined;
         sessionId?: string | (() => string | undefined) | undefined;
     });
     setSessionId(sessionId: string | (() => string | undefined) | undefined): void;
-    account(usage: Usage, model?: string): void;
+    account(usage: Usage, model?: string, providerId?: string | undefined): void;
     /** Synchronous variant for code paths that have already resolved the model. */
     accountWithModel(usage: Usage, resolved: ResolvedModel): void;
     total(): Usage;
@@ -51,6 +52,7 @@ export declare class DefaultTokenCounter implements TokenCounter {
     invalidateCache(): void;
     private emitAccounted;
     private currentSessionId;
+    private currentProviderId;
     reset(): void;
     private applyPrice;
 }

package/dist/infrastructure/token-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAa1E;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAAC,CAAkD;IACpE,OAAO,CAAC,UAAU,CAAiC;IACnD,uFAAuF;IACvF,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAE3B,YACE,IAAI,GAAE;QACJ,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;QACtC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;KACxD,EAMP;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE7E;IAED,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAqD1C;IAED,+EAA+E;IAC/E,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAkB5D;IAED,KAAK,IAAI,KAAK,CAOb;IAED,oBAAoB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAE/E;IAED,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpF;IAED,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAOhF;IAED,UAAU,IAAI,UAAU,CAUvB;IAED,8EAA8E;IAC9E,eAAe,IAAI,IAAI,CAEtB;IAED,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,gBAAgB;IAKxB,KAAK,IAAI,IAAI,CAWZ;IAED,OAAO,CAAC,UAAU;CAgBnB"}
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/infrastructure/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAa1E;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAkD;IAC9E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAAC,CAAkD;IACpE,OAAO,CAAC,UAAU,CAAiC;IACnD,uFAAuF;IACvF,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAE3B,YACE,IAAI,GAAE;QACJ,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;QACtC,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;QAC7D,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;KACxD,EAMP;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE7E;IAED,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,qBAA2B,GAAG,IAAI,CAsDjF;IAED,+EAA+E;IAC/E,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAkB5D;IAED,KAAK,IAAI,KAAK,CAOb;IAED,oBAAoB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAE/E;IAED,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpF;IAED,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAOhF;IAED,UAAU,IAAI,UAAU,CAWvB;IAED,8EAA8E;IAC9E,eAAe,IAAI,IAAI,CAEtB;IAED,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,iBAAiB;IAKzB,KAAK,IAAI,IAAI,CAiBZ;IAED,OAAO,CAAC,UAAU;CAqBnB"}

package/dist/kernel/events/brain-events.d.ts

@@ -81,6 +81,8 @@ export interface BrainEventMap {
     'token.accounted': {
         sessionId?: string | undefined;
         usage: Usage;
+        /** Usage contributed by this one accounting call (not cumulative). */
+        deltaUsage?: Usage | undefined;
         cost: {
             input: number;
             output: number;

package/dist/kernel/events/brain-events.d.ts.map

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

package/dist/kernel/events/memory-events.d.ts

@@ -26,6 +26,10 @@ export interface MemoryEventMap {
     /** Structured Super Memory lifecycle events. Kept structural so core never depends on the package. */
     'memory.accepted': {
         memoryId: string;
+        kind?: string | undefined;
+        persistence?: string | undefined;
+        confidence?: number | undefined;
+        freshness?: number | undefined;
         sessionId?: string | undefined;
         traceId?: string | undefined;
     };
@@ -52,6 +56,20 @@ export interface MemoryEventMap {
     'memory.updated': {
         memoryId: string;
         status: string;
+        kind?: string | undefined;
+        persistence?: string | undefined;
+        confidence?: number | undefined;
+        freshness?: number | undefined;
+        sessionId?: string | undefined;
+        traceId?: string | undefined;
+    };
+    /** Fired after an explicitly authorized memory deletion has completed. */
+    'memory.deleted': {
+        memoryId: string;
+        reason: string;
+        persistence: string;
+        removedEdges: number;
+        contextPolicy: 'never' | 'eligible';
         sessionId?: string | undefined;
         traceId?: string | undefined;
     };
@@ -112,6 +130,81 @@ export interface MemoryEventMap {
         sessionId?: string | undefined;
         traceId?: string | undefined;
     };
+    /** Exact Super Memory presence in the provider-bound request context. */
+    'memory.context_snapshot': {
+        at: string;
+        activeMemoryIds: string[];
+        enteredMemoryIds: string[];
+        exitedMemoryIds: string[];
+        reason: 'provider_request';
+        sessionId?: string | undefined;
+        traceId?: string | undefined;
+    };
+    /**
+     * One bounded, UI-facing decision trace for each on-demand Memory Injector
+     * run. This is deliberately richer than `memory.injected`: it is also
+     * emitted when nothing is injected, so operators can see what entered the
+     * model context and what was rejected by score, visibility, cooldown, or
+     * the current context budget.
+     */
+    'memory.injector_run': {
+        runId: string;
+        at: string;
+        outcome: 'injected' | 'empty' | 'error';
+        trigger: string;
+        toolName: string;
+        queryPreview: string;
+        paths: string[];
+        taskSignals: string[];
+        contextPressure: number;
+        budget: {
+            maxHints: number;
+            maxChars: number;
+        };
+        candidates: number;
+        eligible: number;
+        rejected: {
+            duplicate: number;
+            belowScore: number;
+            alreadyVisible: number;
+            cooldown: number;
+            budget: number;
+        };
+        activated: Array<{
+            id: string;
+            kind: string;
+            text: string;
+            score: number;
+            relationStrength: number;
+            anchor?: string | undefined;
+            anchors: string[];
+            tags: string[];
+            activationReasons: string[];
+            importance: number;
+            confidence: number;
+            freshness: number;
+            persistence: string;
+        }>;
+        injected: Array<{
+            id: string;
+            kind: string;
+            text: string;
+            score: number;
+            relationStrength: number;
+            anchor?: string | undefined;
+            anchors: string[];
+            tags: string[];
+            activationReasons: string[];
+            importance: number;
+            confidence: number;
+            freshness: number;
+            persistence: string;
+        }>;
+        injectedChars: number;
+        error?: string | undefined;
+        sessionId?: string | undefined;
+        traceId?: string | undefined;
+    };
     'memory.used': {
         memoryIds: string[];
         source: string;
@@ -142,6 +235,15 @@ export interface MemoryEventMap {
         from: string;
         to: string;
         relation: string;
+        weight?: number | undefined;
+        evidence?: string[] | undefined;
+        sessionId?: string | undefined;
+        traceId?: string | undefined;
+    };
+    'memory.relationships_rebuilt': {
+        examined: number;
+        proposed: number;
+        added: number;
         sessionId?: string | undefined;
         traceId?: string | undefined;
     };

package/dist/kernel/events/memory-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-events.d.ts","sourceRoot":"","sources":["../../../src/kernel/events/memory-events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-events.d.ts","sourceRoot":"","sources":["../../../src/kernel/events/memory-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,mBAAmB,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;OAIG;IACH,iBAAiB,EAAE;QACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;KAC7B,CAAC;IAEF,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,qBAAqB,EAAE,yBAAyB,CAAC;IACjD,sGAAsG;IACtG,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,0BAA0B,EAAE;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,2BAA2B,EAAE;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,4FAA4F;IAC5F,2BAA2B,EAAE;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QACxC,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,0EAA0E;IAC1E,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,OAAO,GAAG,UAAU,CAAC;QACpC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,mBAAmB,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,4EAA4E;IAC5E,kBAAkB,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,8FAA8F;IAC9F,qBAAqB,EAAE;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,+EAA+E;IAC/E,iCAAiC,EAAE;QACjC,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,qBAAqB,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,iBAAiB,EAAE;QACjB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,yEAAyE;IACzE,yBAAyB,EAAE;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,kBAAkB,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF;;;;;;OAMG;IACH,qBAAqB,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE;YACR,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,cAAc,EAAE,MAAM,CAAC;YACvB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,SAAS,EAAE,KAAK,CAAC;YACf,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,gBAAgB,EAAE,MAAM,CAAC;YACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;YACnB,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK,CAAC;YACd,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,gBAAgB,EAAE,MAAM,CAAC;YACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;YACnB,SAAS,EAAE,MAAM,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,aAAa,EAAE;QACb,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,wBAAwB,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,0BAA0B,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,yBAAyB,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,8BAA8B,EAAE;QAC9B,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IAEF;;;;OAIG;IACH,cAAc,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,4BAA4B;QAC5B,KAAK,EACD,SAAS,GACT,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,GACP,OAAO,GACP,gBAAgB,GAChB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,6NAA6N;QAC7N,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;OAGG;IACH,eAAe,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EACD,SAAS,GACT,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,GACP,OAAO,GACP,gBAAgB,GAChB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB;;;;mCAI2B;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;OAGG;IACH,eAAe,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EACD,SAAS,GACT,MAAM,GACN,MAAM,GACN,SAAS,GACT,OAAO,GACP,OAAO,GACP,OAAO,GACP,gBAAgB,GAChB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,SAAS,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH"}

package/dist/kernel/events/session-events.d.ts

@@ -147,6 +147,41 @@ export interface SessionEventMap {
         load: number;
         fatal: boolean;
     };
+    /**
+     * Fired when the last-resort emergency trim runs — normal compaction left the
+     * request above the hard threshold, so message content was head/tail
+     * truncated (and, as a final step, oldest messages dropped) until it
+     * structurally fit the window. This is the no-overflow guarantee in action;
+     * `withinBudget: false` would indicate the impossible case where even a
+     * fully-floored request exceeds the budget.
+     */
+    'compaction.emergency_trim': {
+        sessionId?: string | undefined;
+        level: 'warn' | 'soft' | 'hard';
+        /** Estimated message tokens reclaimed by the trim. */
+        saved: number;
+        /** Content blocks elided or head/tail truncated. */
+        trimmedBlocks: number;
+        /** Whole messages dropped as the final pass. */
+        droppedMessages: number;
+        /** Full-request token estimate after the trim. */
+        tokens: number;
+        /** Fraction of the window occupied after the trim. */
+        load: number;
+        maxContext: number;
+        budget?: {
+            maxContext: number;
+            inputTokens: number;
+            availableInputTokens: number;
+            remainingInputTokens: number;
+            reservedOutputTokens: number;
+            reservedSafetyTokens: number;
+            load: number;
+            overflowTokens: number;
+        } | undefined;
+        /** True when the request fits the window after trimming (expected: always). */
+        withinBudget: boolean;
+    };
     /** Fired by SessionWriter.writeCheckpoint() after the checkpoint event is appended to JSONL. */
     'checkpoint.written': {
         sessionId?: string | undefined;

package/dist/kernel/events/session-events.d.ts.map

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

package/dist/models/index.js

@@ -7,6 +7,11 @@ import { randomBytes } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 
+// src/types/blocks.ts
+function isTextBlock(b) {
+  return b.type === "text";
+}
+
 // src/utils/error.ts
 function toErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
@@ -22,6 +27,62 @@ function expectDefined(value, label) {
   return value;
 }
 
+// src/utils/token-estimate.ts
+var RoughTokenEstimate = (text, charsPerToken = 3.5) => Math.max(1, Math.ceil(text.length / charsPerToken));
+var ESTIMATE_CACHE = /* @__PURE__ */ new Map();
+var _estimateCacheOrder = [];
+var ESTIMATE_CACHE_MAX_SIZE = 5e4;
+function getCachedEstimate(key, compute) {
+  const existing = ESTIMATE_CACHE.get(key);
+  if (existing !== void 0) return existing;
+  if (ESTIMATE_CACHE.size >= ESTIMATE_CACHE_MAX_SIZE) {
+    while (ESTIMATE_CACHE.size > Math.floor(ESTIMATE_CACHE_MAX_SIZE / 2)) {
+      const oldest = _estimateCacheOrder.shift();
+      if (oldest !== void 0) ESTIMATE_CACHE.delete(oldest);
+    }
+  }
+  const estimate = compute(key);
+  ESTIMATE_CACHE.set(key, estimate);
+  _estimateCacheOrder.push(key);
+  return estimate;
+}
+function estimateToolInputTokens(input) {
+  if (typeof input === "string") return RoughTokenEstimate(input);
+  if (input === null || typeof input !== "object") {
+    return RoughTokenEstimate(String(input));
+  }
+  return getCachedEstimate(JSON.stringify(input), (key) => RoughTokenEstimate(key));
+}
+function estimateToolResultTokens(content) {
+  if (typeof content === "string") return RoughTokenEstimate(content);
+  return getCachedEstimate(JSON.stringify(content), (key) => RoughTokenEstimate(key));
+}
+function estimateTextTokens(text) {
+  return RoughTokenEstimate(text);
+}
+function computeMessageTokens(msg) {
+  if (typeof msg.content === "string") return estimateTextTokens(msg.content);
+  let total = 0;
+  for (const b of msg.content) {
+    if (b.type === "text") total += estimateTextTokens(b.text);
+    else if (b.type === "tool_use") total += estimateToolInputTokens(b.input);
+    else if (b.type === "tool_result") total += estimateToolResultTokens(b.content);
+    else total += RoughTokenEstimate(JSON.stringify(b));
+  }
+  return total;
+}
+function estimateMessageTokens(messages) {
+  let total = 0;
+  for (const m of messages) {
+    if (typeof m._estTokens === "number" && m._estTokens > 0) {
+      total += m._estTokens;
+      continue;
+    }
+    total += computeMessageTokens(m);
+  }
+  return total;
+}
+
 // src/utils/merge-models-payload.ts
 function mergeModelsPayload(base, overlay) {
   const out = {};
@@ -85,62 +146,6 @@ function stripUndefined(obj) {
   return out;
 }
 
-// src/utils/token-estimate.ts
-var RoughTokenEstimate = (text, charsPerToken = 3.5) => Math.max(1, Math.ceil(text.length / charsPerToken));
-var ESTIMATE_CACHE = /* @__PURE__ */ new Map();
-var _estimateCacheOrder = [];
-var ESTIMATE_CACHE_MAX_SIZE = 5e4;
-function getCachedEstimate(key, compute) {
-  const existing = ESTIMATE_CACHE.get(key);
-  if (existing !== void 0) return existing;
-  if (ESTIMATE_CACHE.size >= ESTIMATE_CACHE_MAX_SIZE) {
-    while (ESTIMATE_CACHE.size > Math.floor(ESTIMATE_CACHE_MAX_SIZE / 2)) {
-      const oldest = _estimateCacheOrder.shift();
-      if (oldest !== void 0) ESTIMATE_CACHE.delete(oldest);
-    }
-  }
-  const estimate = compute(key);
-  ESTIMATE_CACHE.set(key, estimate);
-  _estimateCacheOrder.push(key);
-  return estimate;
-}
-function estimateToolInputTokens(input) {
-  if (typeof input === "string") return RoughTokenEstimate(input);
-  if (input === null || typeof input !== "object") {
-    return RoughTokenEstimate(String(input));
-  }
-  return getCachedEstimate(JSON.stringify(input), (key) => RoughTokenEstimate(key));
-}
-function estimateToolResultTokens(content) {
-  if (typeof content === "string") return RoughTokenEstimate(content);
-  return getCachedEstimate(JSON.stringify(content), (key) => RoughTokenEstimate(key));
-}
-function estimateTextTokens(text) {
-  return RoughTokenEstimate(text);
-}
-function computeMessageTokens(msg) {
-  if (typeof msg.content === "string") return estimateTextTokens(msg.content);
-  let total = 0;
-  for (const b of msg.content) {
-    if (b.type === "text") total += estimateTextTokens(b.text);
-    else if (b.type === "tool_use") total += estimateToolInputTokens(b.input);
-    else if (b.type === "tool_result") total += estimateToolResultTokens(b.content);
-    else total += RoughTokenEstimate(JSON.stringify(b));
-  }
-  return total;
-}
-function estimateMessageTokens(messages) {
-  let total = 0;
-  for (const m of messages) {
-    if (typeof m._estTokens === "number" && m._estTokens > 0) {
-      total += m._estTokens;
-      continue;
-    }
-    total += computeMessageTokens(m);
-  }
-  return total;
-}
-
 // src/types/errors.ts
 var ERROR_CODES = {
   // Provider
@@ -968,9 +973,77 @@ async function loadUserModes(modesDir) {
   return modes;
 }
 
-// src/types/blocks.ts
-function isTextBlock(b) {
-  return b.type === "text";
+// src/utils/compaction-preview.ts
+var PATH_HINT_PATTERN = /(?:(?:[A-Za-z]:)?[./\\]?[\w@.-]+(?:[\\/][\w@(). -]+)+\.[A-Za-z0-9]{1,12})/g;
+var PATH_BACKSLASH_PATTERN = /\\/g;
+var PATH_TRIM_PATTERN = /^["'`]+|["'`),;:]+$/g;
+var ERROR_LINE_PATTERN = /\b(error|exception|failed|failure|fatal|panic|timeout|denied|enoent|eacces|eperm)\b/i;
+var NEWLINE_SPLIT_PATTERN = /\r?\n/;
+var WHITESPACE_COLLAPSE_PATTERN = /\s+/g;
+function buildCompactionPreview(message, maxChars = 600) {
+  if (maxChars <= 0) return "";
+  if (typeof message.content === "string") {
+    return truncatePreview(message.content, maxChars);
+  }
+  const parts = [];
+  for (const block of message.content) {
+    if (isTextBlock(block)) {
+      const text = truncatePreview(block.text, maxChars);
+      if (text) parts.push(text);
+      continue;
+    }
+    if (block.type === "tool_use") {
+      const input = truncatePreview(safePreviewString(block.input), 220);
+      parts.push(`[tool_use: ${block.name}${input ? `; input=${input}` : ""}]`);
+      continue;
+    }
+    if (block.type === "tool_result") {
+      const raw = safePreviewString(block.content);
+      const details = [block.is_error ? "error" : "ok"];
+      if (block.name) details.push(`tool=${block.name}`);
+      const files = extractPathHints(raw).slice(0, 5);
+      if (files.length > 0) details.push(`files=${files.join(", ")}`);
+      const error = firstErrorLine(raw);
+      if (error) details.push(`error=${error}`);
+      const sample = truncatePreview(raw, 260);
+      if (sample) details.push(`sample=${sample}`);
+      parts.push(`[tool_result: ${details.join("; ")}]`);
+      continue;
+    }
+    parts.push(`[${block.type}]`);
+  }
+  return truncatePreview(parts.join(" "), maxChars);
+}
+function safePreviewString(value) {
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function truncatePreview(value, maxChars) {
+  const compact = value.replace(WHITESPACE_COLLAPSE_PATTERN, " ").trim();
+  if (compact.length <= maxChars) return compact;
+  return `${compact.slice(0, Math.max(0, maxChars - 1))}\u2026`;
+}
+function extractPathHints(content) {
+  const text = safePreviewString(content);
+  const out = /* @__PURE__ */ new Set();
+  for (const match of text.matchAll(PATH_HINT_PATTERN)) {
+    const clean = match[0]?.replace(PATH_BACKSLASH_PATTERN, "/").replace(PATH_TRIM_PATTERN, "");
+    if (clean) out.add(clean);
+  }
+  return [...out];
+}
+function firstErrorLine(content) {
+  const text = safePreviewString(content);
+  for (const line of text.split(NEWLINE_SPLIT_PATTERN)) {
+    if (!ERROR_LINE_PATTERN.test(line)) continue;
+    const trimmed = line.replace(WHITESPACE_COLLAPSE_PATTERN, " ").trim();
+    if (trimmed) return truncatePreview(trimmed, 220);
+  }
+  return void 0;
 }
 
 // src/utils/instruction-file.ts
@@ -1015,29 +1088,39 @@ function isDirectory2(candidate) {
 // src/models/llm-selector.ts
 var DEFAULT_SYSTEM_PROMPT = readBundledInstructionText("llm/llm-selector.md");
 function formatMessages(messages, maxTokens = 2048) {
+  const previewChars = Math.max(
+    120,
+    Math.min(600, Math.floor(maxTokens * 3.2 / Math.max(1, messages.length)))
+  );
   const lines = [];
-  let usedTokens = 0;
   for (let i = 0; i < messages.length; i++) {
     const m = expectDefined(messages[i]);
     const role = m.role.padEnd(10, " ");
-    let text;
-    if (typeof m.content === "string") {
-      text = m.content.slice(0, 500);
-    } else {
-      const content = m.content;
-      text = content.filter(isTextBlock).map((b) => b.text).join(" ");
-      const toolUses = content.filter((b) => b.type === "tool_use");
-      if (toolUses.length > 0) {
-        text += ` [tools: ${toolUses.map((b) => b.name).filter(Boolean).join(", ")}]`;
-      }
-    }
-    const line = `[${i}][${role}]: ${text}`;
-    const lineTokens = estimateTextTokens(line);
-    if (usedTokens + lineTokens > maxTokens) break;
-    lines.push(line);
-    usedTokens += lineTokens;
-  }
-  return lines.join("\n");
+    const line = `[${i}][${role}]: ${buildCompactionPreview(m, previewChars)}`;
+    lines.push({ index: i, text: line, tokens: estimateTextTokens(line) });
+  }
+  const total = lines.reduce((sum, line) => sum + line.tokens, 0);
+  if (total <= maxTokens) return lines.map((line) => line.text).join("\n");
+  const recentCount = Math.min(8, lines.length);
+  const recentStart = lines.length - recentCount;
+  const tail = [];
+  let usedTokens = 0;
+  for (let i = lines.length - 1; i >= recentStart; i--) {
+    const line = expectDefined(lines[i]);
+    if (tail.length >= 2 && usedTokens + line.tokens > Math.floor(maxTokens * 0.45)) continue;
+    tail.unshift(line);
+    usedTokens += line.tokens;
+  }
+  const head = [];
+  for (let i = 0; i < recentStart; i++) {
+    const line = expectDefined(lines[i]);
+    if (usedTokens + line.tokens > maxTokens) break;
+    head.push(line);
+    usedTokens += line.tokens;
+  }
+  const omitted = Math.max(0, recentStart - head.length);
+  const marker = omitted > 0 ? [`[\u2026 ${omitted} middle message(s) omitted from selector preview \u2026]`] : [];
+  return [...head.map((line) => line.text), ...marker, ...tail.map((line) => line.text)].join("\n");
 }
 var LLMSelector = class {
   provider;