acp-kernel 0.0.72 → 0.0.73-pr.302.168

package/dist/persist/index.js

@@ -449,7 +449,8 @@ function mergeCompressionState(parsed) {
     nextBlockId: parsed.nextBlockId ?? fresh.nextBlockId,
     nextRunId: parsed.nextRunId ?? fresh.nextRunId,
     tokenSnapshot: parsed.tokenSnapshot ?? fresh.tokenSnapshot,
-    absorbed: parsed.absorbed ?? fresh.absorbed
+    absorbed: parsed.absorbed ?? fresh.absorbed,
+    terminalStreak: parsed.terminalStreak
   };
 }
 export {

package/dist/persist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/persist/store.ts","../../src/persist/state-merge.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport fsp from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Logger callback. Downstream routes it wherever it wants (file, stderr). */\nexport type PersistLogger = (level: \"info\" | \"warn\" | \"error\", msg: string) => void;\n\n/**\n * On-disk record shape. The store owns the envelope (version stamp, save\n * time, id) so atomicity and discovery can rely on it; the payload schema\n * is entirely downstream-owned. `payload` must be JSON-serializable.\n */\nexport interface PersistedEnvelope<T> {\n    version: number;\n    savedAt: number;\n    id: string;\n    payload: T;\n}\n\n/** A legacy (pre-envelope) record adopted on load. `version`/`savedAt`\n * preserve the source record's own stamps when present. */\nexport interface LegacyAdoption<T> {\n    id: string;\n    payload: T;\n    version?: number;\n    savedAt?: number;\n}\n\n/**\n * Optional record codec: transforms serialized envelopes between the store\n * and disk (e.g. compress and/or encrypt at rest). The store is\n * codec-agnostic — it hands `encode` the exact JSON string it would have\n * written and passes raw file bytes to `decode`, which must return that same\n * JSON string or throw, in which case the file is treated as corrupt\n * (skipped + logged) like any unreadable record. Format detection (magic\n * bytes, plaintext fallback for unencoded legacy files) is the codec's job,\n * so mixed trees of legacy plaintext and encoded files load fine.\n */\nexport interface StateStoreCodec {\n    encode(data: string): Buffer | string;\n    decode(buf: Buffer): string;\n}\n\nexport interface StateStoreOptions<T> {\n    /**\n     * Storage root. The kernel deliberately has NO default location: the\n     * downstream decides where state lives (CLI dir, XDG data dir, plugin\n     * dir, temp dir in tests). All records live under this directory.\n     */\n    dir: string;\n    /**\n     * Schema version stamped into every envelope. Owned by the downstream;\n     * bump it when the payload shape changes. The store itself never\n     * rejects a record over its version — migration policy belongs to the\n     * reader.\n     */\n    version: number;\n    /** Debounce window for scheduleSave, ms. Default 500. */\n    debounceMs?: number;\n    /** Default true. When false, all writes are silent no-ops and loads\n     *  return empty results. */\n    enabled?: boolean;\n    log?: PersistLogger;\n    /**\n     * Relative path (under `dir`) for a record, possibly namespaced into\n     * subdirectories (e.g. `openai/host-hash.json`). Default: flat\n     * `<sha256(id)[:24]>.json`.\n     *\n     * Because the path may depend on payload fields the store only learns\n     * at write time, single-record loads resolve namespaced files only\n     * after loadAll() has discovered them (or the store itself wrote\n     * them). The flat default name is always checked as a fallback, so\n     * downstreams using a custom relPath should call loadAll() at boot.\n     */\n    relPath?: (id: string, payload: T) => string;\n    /**\n     * Adopt records written by an older, pre-envelope schema. Receives the\n     * parsed JSON of any file that failed the envelope-shape check; return\n     * an adoption to load it as an envelope, or null to skip it. Adopted\n     * records are re-persisted in the current envelope format on the next\n     * dirty write — files migrate organically, and old files keep loading\n     * (same policy billion-context's proxy used for its v1→v3 migration).\n     */\n    legacy?: (parsed: unknown) => LegacyAdoption<T> | null;\n    /**\n     * Payload validation on load. Return false to skip a record (foreign\n     * schema, corrupt content). Default: envelope-shape check only\n     * (string id, non-null payload).\n     */\n    validate?: (envelope: PersistedEnvelope<T>) => boolean;\n    /**\n     * Optional codec applied around every write (canonical + spill) and\n     * read. See StateStoreCodec. Default: none — files are plain UTF-8 JSON.\n     */\n    codec?: StateStoreCodec;\n    /**\n     * Transient-write retry policy (Windows + hostile temp environments).\n     * The whole write cycle — mkdir, temp write, rename — is retried with\n     * exponential backoff when it fails with a TRANSIENT code: EPERM/EBUSY/\n     * EACCES (a lock held by AV scan, search indexer, SMB) or ENOENT/ENOTDIR\n     * (the temp file or its directory vanished between create and rename —\n     * observed on CI Windows runners where a sweeper deletes freshly\n     * created files under %TEMP%). The delay after attempt i is\n     * min(retryBaseMs * 2^i, retryMaxMs). Defaults (6 attempts, 50ms base,\n     * 1600ms cap) give a ~1.5s window per write path — long enough for most\n     * locks to release, short enough not to stall a sync flush. When the\n     * window is exhausted the write spills to a side file (see spillPath)\n     * instead of dropping the data.\n     */\n    retryAttempts?: number;\n    retryBaseMs?: number;\n    retryMaxMs?: number;\n}\n\n/**\n * Crash-safe, debounce-coalescing JSON state store. Mechanism only — lifted\n * from billion-context's proxy SessionStore and generalized:\n *\n * - atomic writes: temp file + rename, so a crash mid-write never leaves a\n *   truncated record (readers see either the old or the new file)\n * - whole-cycle retries with exponential backoff on transient fs failures:\n *   Windows locks (EPERM/EBUSY/EACCES from AV/indexer/SMB) and vanishing\n *   files/dirs (ENOENT/ENOTDIR — a sweeper deleting fresh temp files, seen\n *   on CI Windows runners); when the window is exhausted the record spills\n *   to a side file (`<name>.fb.json`) instead of being dropped, so a lock\n *   held by AV/indexer/SMB never silently loses session data\n * - per-id serialization so concurrent writeNow calls never interleave\n *   temp-file names or reorders writes\n * - debounced scheduleSave coalesces bursts into one write; the record is\n *   built at WRITE time from a builder, so late mutations are picked up\n * - optional record codec (compress/encrypt at rest): encode on every write,\n *   decode on every read; a decode failure is corrupt-file semantics\n * - loadAll skips `.tmp-*` orphans, corrupt JSON, and records whose\n *   filename does not match their id — one bad file never blocks boot; it\n *   reconciles a canonical record against its spill by savedAt (freshest wins)\n *\n * The store never deletes a record's data. On a successful canonical write it\n * removes a now-stale spill of the SAME id (a duplicate, not distinct data).\n * Session cleanup is a downstream policy decision (kernel position: persisted\n * state should not be deleted opportunistically).\n */\nexport class StateStore<T> {\n    readonly enabled: boolean;\n    private readonly dir: string;\n    private readonly version: number;\n    private readonly debounceMs: number;\n    private readonly log: PersistLogger;\n    private readonly legacyFn?: (parsed: unknown) => LegacyAdoption<T> | null;\n    private readonly relPathFn?: (id: string, payload: T) => string;\n    private readonly validateFn: (envelope: PersistedEnvelope<T>) => boolean;\n    private readonly codec?: StateStoreCodec;\n    private readonly retryAttempts: number;\n    private readonly retryBaseMs: number;\n    private readonly retryMaxMs: number;\n    private readonly timers = new Map<string, NodeJS.Timeout>();\n    private readonly pending = new Map<string, () => T>();\n    private readonly writeChains = new Map<string, Promise<void>>();\n    /** id → absolute path, populated by writes and loadAll. */\n    private readonly discovered = new Map<string, string>();\n    /** id → cumulative write-failure count, for rate-limited alerting. */\n    private readonly failCounts = new Map<string, number>();\n    /** Monotonic counter for unique temp filenames within a process. */\n    private tmpSeq = 0;\n\n    constructor(opts: StateStoreOptions<T>) {\n        this.dir = opts.dir;\n        this.version = opts.version;\n        this.debounceMs = opts.debounceMs ?? 500;\n        this.enabled = opts.enabled ?? true;\n        this.log = opts.log ?? ((_level, _msg) => {});\n        this.relPathFn = opts.relPath;\n        this.legacyFn = opts.legacy;\n        this.validateFn = opts.validate ?? defaultValidate;\n        this.codec = opts.codec;\n        this.retryAttempts = Math.max(1, opts.retryAttempts ?? 6);\n        this.retryBaseMs = Math.max(1, opts.retryBaseMs ?? 50);\n        this.retryMaxMs = Math.max(this.retryBaseMs, opts.retryMaxMs ?? 1600);\n    }\n\n    /** Debounced save. Coalesces bursts; the builder runs at write time, so\n     *  the freshest state is always persisted. Never throws. */\n    scheduleSave(id: string, build: () => T): void {\n        if (!this.enabled) return;\n        this.pending.set(id, build);\n        const existing = this.timers.get(id);\n        if (existing) return;\n        const timer = setTimeout(() => {\n            this.timers.delete(id);\n            const builder = this.pending.get(id);\n            this.pending.delete(id);\n            if (!builder) return;\n            // Errors are logged inside writeInner; swallowing here keeps a\n            // failed timer write from becoming an unhandledRejection.\n            void this.writeNow(id, builder).catch(() => {});\n        }, this.debounceMs);\n        timer.unref?.();\n        this.timers.set(id, timer);\n    }\n\n    /** Immediate save, serialized per id. Rejects on write failure; a\n     *  failing write never breaks the chain for the next one. */\n    async writeNow(id: string, build: () => T): Promise<void> {\n        if (!this.enabled) return;\n        // The previous promise may reject (disk full, EPERM) — catch so our\n        // chain doesn't break, then run our own write.\n        const prev = this.writeChains.get(id) ?? Promise.resolve();\n        const next = prev.catch(() => {}).then(() => this.writeInner(id, build));\n        this.writeChains.set(id, next);\n        // Clean up the chain entry once settled so the Map doesn't grow. The\n        // .catch() is load-bearing: .finally() returns a derived promise that\n        // nobody else holds — when the chain rejects it would surface as an\n        // unhandledRejection and crash the host on default Node settings.\n        next\n            .finally(() => {\n                if (this.writeChains.get(id) === next) this.writeChains.delete(id);\n            })\n            .catch(() => {});\n        return next;\n    }\n\n    /** Synchronous flush for one id. Used where the caller cannot await\n     *  (memory eviction, sync shutdown paths). Cancels any pending debounce\n     *  timer. Returns true on success, false on failure — callers that use\n     *  the result to drop in-memory state must NOT drop it on failure. */\n    flushSync(id: string, build: () => T): boolean {\n        if (!this.enabled) return true;\n        const timer = this.timers.get(id);\n        if (timer) {\n            clearTimeout(timer);\n            this.timers.delete(id);\n            this.pending.delete(id);\n        }\n        let payload: T;\n        try {\n            payload = build();\n        } catch (e) {\n            this.log(\"error\", `[persist] builder failed for ${id}: ${errText(e)}`);\n            return false;\n        }\n        const file = this.resolvePath(id, payload);\n        const data = this.serialize(id, payload);\n        let lastErr: unknown;\n        for (let attempt = 0; attempt < this.retryAttempts; attempt++) {\n            // Fresh temp name + mkdir per attempt — same reasoning as the\n            // async writeInner loop (delete-pending tombstones, swept dirs).\n            const tmp = this.tempPath(file);\n            try {\n                fs.mkdirSync(path.dirname(file), { recursive: true });\n                fs.writeFileSync(tmp, data);\n                fs.renameSync(tmp, file);\n                lastErr = undefined;\n                break;\n            } catch (e) {\n                lastErr = e;\n                try {\n                    fs.unlinkSync(tmp);\n                } catch {\n                    // temp never created or already gone\n                }\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                // sync sleep (Atomics.wait) — backoff grows per attempt\n                Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, this.backoffMs(attempt));\n            }\n        }\n        if (!lastErr) {\n            this.discovered.set(id, file);\n            this.clearFailure(id);\n            this.removeSpillSync(file);\n            return true;\n        }\n        // The canonical write outlived the retry window (Windows lock held by\n        // AV/indexer/SMB). Spill to a side file so the data still lands on\n        // disk instead of being dropped — loadAll picks the freshest of the\n        // canonical and the spill, with its own transient retry window.\n        const spill = this.spillPathFor(file);\n        let spillPath: string | null = null;\n        for (let attempt = 0; attempt < this.retryAttempts && spillPath === null; attempt++) {\n            try {\n                fs.mkdirSync(path.dirname(spill), { recursive: true });\n                fs.writeFileSync(spill, data);\n                spillPath = spill;\n            } catch (e) {\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, this.backoffMs(attempt));\n            }\n        }\n        if (spillPath) this.discovered.set(id, spillPath);\n        this.recordFailure(id, lastErr, spillPath);\n        return spillPath !== null;\n    }\n\n    /** Load one record. Checks the discovered path (from a prior\n     *  write/loadAll), an optional relative-path hint, and the flat default\n     *  name. Returns null when absent, disabled, corrupt, or rejected by\n     *  validate. The hint covers namespaced records the store has not\n     *  discovered (e.g. an evicted session re-requested with its meta,\n     *  where the path depends on data the store cannot reconstruct from\n     *  the id alone). */\n    loadSync(id: string, hint?: string): PersistedEnvelope<T> | null {\n        if (!this.enabled) return null;\n        const candidates = [\n            this.discovered.get(id),\n            hint ? path.join(this.dir, hint) : undefined,\n            path.join(this.dir, flatFileNameFor(id)),\n        ];\n        for (const file of candidates) {\n            if (!file) continue;\n            const envelope = this.readEnvelope(file);\n            if (envelope && envelope.id === id) return envelope;\n        }\n        return null;\n    }\n\n    /** Load every record under dir. Populates the discovery map (enables\n     *  loadSync for namespaced relPaths). Skips corrupt files, `.tmp-*`\n     *  orphans, and records whose filename does not match their id — one\n     *  bad file never blocks boot. Never throws. */\n    async loadAll(): Promise<Map<string, PersistedEnvelope<T>>> {\n        const out = new Map<string, PersistedEnvelope<T>>();\n        if (!this.enabled) return out;\n        const files = await this.walkJsonFiles(this.dir);\n        for (const file of files) {\n            const envelope = this.readEnvelope(file);\n            if (!envelope) continue;\n            const base = path.basename(file);\n            const relBase = path.basename(this.relPathOf(envelope.id, envelope.payload));\n            const flatBase = flatFileNameFor(envelope.id);\n            // A file is a valid record for its envelope id when its name is the\n            // canonical name OR a spill (`.fb`) of the canonical name. This lets\n            // a spilled record (written while the canonical was locked) be\n            // discovered and reconciled against the canonical by savedAt.\n            let owner: string | null = null;\n            if (base === relBase || base === flatBase) {\n                owner = envelope.id;\n            } else if (base.endsWith(\".fb.json\")) {\n                const canonicalBase = `${base.slice(0, -\".fb.json\".length)}.json`;\n                if (canonicalBase === relBase || canonicalBase === flatBase) {\n                    owner = envelope.id;\n                }\n            }\n            if (owner === null) {\n                this.log(\"warn\", `[persist] skipping ${rel(file, this.dir)}: filename does not match record id`);\n                continue;\n            }\n            const existing = out.get(owner);\n            if (!existing || envelope.savedAt >= existing.savedAt) {\n                out.set(owner, envelope);\n                this.discovered.set(owner, file);\n            }\n        }\n        return out;\n    }\n\n    /** Whether a debounced write is pending for an id. */\n    hasPending(id: string): boolean {\n        return this.timers.has(id);\n    }\n\n    /** Ids with a pending debounced write. */\n    pendingIds(): string[] {\n        return [...this.timers.keys()];\n    }\n\n    /** Flush every pending debounced write immediately, then drain in-flight\n     *  writes. For graceful shutdown (SIGTERM/SIGINT). Never rejects. */\n    async flushAll(): Promise<void> {\n        const ids = this.pendingIds();\n        for (const timer of this.timers.values()) clearTimeout(timer);\n        this.timers.clear();\n        const builders = new Map<string, () => T>();\n        for (const id of ids) {\n            const build = this.pending.get(id);\n            if (build) builders.set(id, build);\n            this.pending.delete(id);\n        }\n        await Promise.all(\n            [...builders.entries()].map(([id, build]) =>\n                this.writeNow(id, build).catch((e) => {\n                    this.log(\"error\", `[persist] shutdown flush failed for ${id}: ${errText(e)}`);\n                }),\n            ),\n        );\n        // Drain writes whose timer fired earlier but are still mid-flight.\n        await Promise.allSettled([...this.writeChains.values()]);\n    }\n\n    /** Cancel all pending debounced writes without flushing (tests). */\n    cancelAll(): void {\n        for (const timer of this.timers.values()) clearTimeout(timer);\n        this.timers.clear();\n        this.pending.clear();\n    }\n\n    private async writeInner(id: string, build: () => T): Promise<void> {\n        let payload: T;\n        try {\n            payload = build();\n        } catch (e) {\n            this.log(\"error\", `[persist] builder failed for ${id}: ${errText(e)}`);\n            throw e;\n        }\n        const file = this.resolvePath(id, payload);\n        const data = this.serialize(id, payload);\n        let lastErr: unknown;\n        for (let attempt = 0; attempt < this.retryAttempts; attempt++) {\n            // Fresh temp name per attempt: on Windows a failed cleanup can\n            // leave the previous name delete-pending, and creating over a\n            // tombstoned name fails immediately — reusing it would burn every\n            // remaining attempt before the write even happens. mkdir runs per\n            // attempt too: a sweeper may have deleted the directory after the\n            // previous cycle created it.\n            const tmp = this.tempPath(file);\n            try {\n                await fsp.mkdir(path.dirname(file), { recursive: true });\n                await fsp.writeFile(tmp, data);\n                await fsp.rename(tmp, file);\n                this.discovered.set(id, file);\n                this.clearFailure(id);\n                await this.removeSpill(file);\n                return;\n            } catch (e) {\n                lastErr = e;\n                // Clean up the .tmp orphan so the next write doesn't collide\n                // with it.\n                await fsp.unlink(tmp).catch(() => {});\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                const { promise, resolve } = Promise.withResolvers<void>();\n                setTimeout(resolve, this.backoffMs(attempt));\n                await promise;\n            }\n        }\n        // The canonical write outlived the retry window (Windows lock held\n        // by AV/indexer/SMB, or a sweeper keeps deleting the fresh temp).\n        // Spill to a side file so the data still lands on disk instead of\n        // being dropped — loadAll picks the freshest of the canonical and\n        // the spill. The spill write gets its own transient retry window for\n        // the same reason (observed failing with ENOENT alongside the\n        // canonical on CI Windows runners).\n        const spill = this.spillPathFor(file);\n        let spillPath: string | null = null;\n        for (let attempt = 0; attempt < this.retryAttempts && spillPath === null; attempt++) {\n            try {\n                await fsp.mkdir(path.dirname(spill), { recursive: true });\n                await fsp.writeFile(spill, data);\n                spillPath = spill;\n            } catch (e) {\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                const { promise, resolve } = Promise.withResolvers<void>();\n                setTimeout(resolve, this.backoffMs(attempt));\n                await promise;\n            }\n        }\n        if (spillPath) this.discovered.set(id, spillPath);\n        this.recordFailure(id, lastErr, spillPath);\n        throw lastErr;\n    }\n\n    private envelope(id: string, payload: T): PersistedEnvelope<T> {\n        return { version: this.version, savedAt: Date.now(), id, payload };\n    }\n\n    /** Serialize an envelope for disk, applying the optional codec. Strings\n     *  are written as UTF-8 (the fs default); Buffer results pass through as\n     *  raw bytes. */\n    private serialize(id: string, payload: T): Buffer | string {\n        const json = JSON.stringify(this.envelope(id, payload));\n        return this.codec ? this.codec.encode(json) : json;\n    }\n\n    /** Absolute path for a record: custom relPath (guarded against path\n     *  escape) or the flat hash default. */\n    private resolvePath(id: string, payload: T): string {\n        return path.join(this.dir, this.relPathOf(id, payload));\n    }\n\n    private relPathOf(id: string, payload: T): string {\n        const custom = this.relPathFn?.(id, payload);\n        if (!custom) return flatFileNameFor(id);\n        const rel = path.normalize(custom);\n        if (path.isAbsolute(rel) || rel.split(/[\\\\/]+/).includes(\"..\")) {\n            this.log(\"warn\", `[persist] relPath for ${id} escapes dir; using flat name`);\n            return flatFileNameFor(id);\n        }\n        return rel;\n    }\n\n    /** Unique temp file next to the destination (same dir ⇒ same volume ⇒\n     *  rename is atomic). Prefixed `.tmp-` so loadAll skips orphans. */\n    private tempPath(dest: string): string {\n        const seq = this.tmpSeq++;\n        return path.join(path.dirname(dest), `.tmp-${path.basename(dest, \".json\")}-${process.pid}-${seq}`);\n    }\n\n    private backoffMs(attempt: number): number {\n        return Math.min(this.retryBaseMs * 2 ** attempt, this.retryMaxMs);\n    }\n\n    /** Side file for a record whose canonical write keeps failing: the\n     *  canonical name with a `.fb` (fallback) infix, e.g. `a.json` →\n     *  `a.fb.json`. One slot per id, overwritten on each spill, so a stuck\n     *  lock never accumulates files. Ends in `.json` so loadAll discovers it. */\n    private spillPathFor(file: string): string {\n        const base = path.basename(file);\n        const dot = base.lastIndexOf(\".\");\n        const stem = dot > 0 ? base.slice(0, dot) : base;\n        const ext = dot > 0 ? base.slice(dot) : \".json\";\n        return path.join(path.dirname(file), `${stem}.fb${ext}`);\n    }\n\n    /** Remove a stale spill after a successful canonical write (best-effort). */\n    private async removeSpill(file: string): Promise<void> {\n        await fsp.unlink(this.spillPathFor(file)).catch(() => {});\n    }\n\n    private removeSpillSync(file: string): void {\n        try {\n            fs.unlinkSync(this.spillPathFor(file));\n        } catch {\n            // no spill or still locked — loadAll reconciles by savedAt\n        }\n    }\n\n    /** Rate-limited failure alerting: log on the first failure and at each\n     *  power-of-two count (1,2,4,8,…), so a long lock yields ~log2(N) lines\n     *  instead of one per write. Includes the spill path so the operator can\n     *  see where the data landed. */\n    private recordFailure(id: string, err: unknown, spillPath: string | null): void {\n        const count = (this.failCounts.get(id) ?? 0) + 1;\n        this.failCounts.set(id, count);\n        const alertAt = count === 1 || (count >= 2 && (count & (count - 1)) === 0);\n        if (!alertAt) return;\n        const where = spillPath\n            ? `; data spilled to ${rel(spillPath, this.dir)}`\n            : \"; SPILLOVER ALSO FAILED — data at risk\";\n        this.log(count === 1 ? \"error\" : \"warn\", `[persist] write failed for ${id} (total ${count}x): ${errText(err)}${where}`);\n    }\n\n    private clearFailure(id: string): void {\n        this.failCounts.delete(id);\n    }\n\n    /** Parse + validate one file. Corrupt or invalid records return null\n     *  (logged) instead of throwing — load paths must never block boot. */\n    private readEnvelope(file: string): PersistedEnvelope<T> | null {\n        let parsed: unknown;\n        try {\n            const buf = fs.readFileSync(file);\n            const text = this.codec ? this.codec.decode(buf) : buf.toString(\"utf8\");\n            parsed = JSON.parse(text);\n        } catch (e) {\n            // A missing candidate path is an expected miss (loadSync probes);\n            // only genuinely unreadable/corrupt files get logged.\n            if ((e as NodeJS.ErrnoException).code !== \"ENOENT\") {\n                this.log(\"warn\", `[persist] skipping corrupt file ${rel(file, this.dir)}: ${errText(e)}`);\n            }\n            return null;\n        }\n        if (isEnvelopeLike(parsed)) {\n            if (!this.validateFn(parsed as PersistedEnvelope<T>)) {\n                this.log(\"warn\", `[persist] skipping invalid record ${rel(file, this.dir)}`);\n                return null;\n            }\n            return parsed as PersistedEnvelope<T>;\n        }\n        const adopted = this.adoptLegacy(parsed);\n        if (adopted) return adopted;\n        this.log(\"warn\", `[persist] skipping invalid record ${rel(file, this.dir)}`);\n        return null;\n    }\n\n    /** Wrap a legacy (pre-envelope) record as an envelope via the `legacy`\n     *  hook, then validate the adopted payload like any other. */\n    private adoptLegacy(parsed: unknown): PersistedEnvelope<T> | null {\n        const adoption = this.legacyFn ? this.legacyFn(parsed) : null;\n        if (!adoption || typeof adoption.id !== \"string\" || adoption.id.length === 0 || adoption.payload == null) {\n            return null;\n        }\n        const source = parsed as Partial<PersistedEnvelope<T>>;\n        const envelope: PersistedEnvelope<T> = {\n            version: adoption.version ?? source.version ?? this.version,\n            savedAt: adoption.savedAt ?? source.savedAt ?? 0,\n            id: adoption.id,\n            payload: adoption.payload,\n        };\n        if (!this.validateFn(envelope)) return null;\n        return envelope;\n    }\n\n    /** Iterative recursive walk (no readdir-recursive dependency), skipping\n     *  `.tmp-*` names and non-.json files. */\n    private async walkJsonFiles(root: string): Promise<string[]> {\n        const out: string[] = [];\n        const queue: string[] = [root];\n        while (queue.length > 0) {\n            const dir = queue.pop()!;\n            let dirents: fs.Dirent[];\n            try {\n                dirents = await fsp.readdir(dir, { withFileTypes: true });\n            } catch {\n                continue; // missing dir → no records yet\n            }\n            for (const d of dirents) {\n                if (d.name.startsWith(\".tmp-\")) continue;\n                const full = path.join(dir, d.name);\n                if (d.isDirectory()) queue.push(full);\n                else if (d.isFile() && d.name.endsWith(\".json\")) out.push(full);\n            }\n        }\n        return out;\n    }\n}\n\nfunction defaultValidate<T>(envelope: PersistedEnvelope<T>): boolean {\n    return typeof envelope.id === \"string\" && envelope.id.length > 0 && envelope.payload != null;\n}\n\nfunction isEnvelopeLike(value: unknown): value is PersistedEnvelope<unknown> {\n    if (!value || typeof value !== \"object\") return false;\n    const v = value as Partial<PersistedEnvelope<unknown>>;\n    return typeof v.id === \"string\" && \"payload\" in v;\n}\n\n/** Deterministic flat filename: `<sha256(id)[:24]>.json`. Truncated hash —\n *  96 bits keeps collisions unreachable for realistic id counts, and short\n *  names stay greppable. */\nexport function flatFileNameFor(id: string): string {\n    return createHash(\"sha256\").update(id, \"utf8\").digest(\"hex\").slice(0, 24) + \".json\";\n}\n\n/** Transient fs failure codes worth retrying the whole write cycle for:\n *  - EPERM/EBUSY/EACCES — a lock held on the file/dir (AV scan, search\n *    indexer, SMB); releases within the backoff window.\n *  - ENOENT/ENOTDIR — the temp file or its directory VANISHED between\n *    create and rename (a sweeper deleting fresh files under %TEMP%, seen\n *    on CI Windows runners), or a delete-pending tombstone from the same\n *    sweep. Recreating the dir + rewriting a fresh temp heals it. */\nfunction isTransientFsError(e: unknown): boolean {\n    const code = (e as NodeJS.ErrnoException).code;\n    return code === \"EPERM\" || code === \"EBUSY\" || code === \"EACCES\" || code === \"ENOENT\" || code === \"ENOTDIR\";\n}\n\nfunction errText(e: unknown): string {\n    return e instanceof Error ? e.message : String(e);\n}\n\n\nfunction rel(p: string, base: string): string {\n    const r = path.relative(base, p);\n    return r && !r.startsWith(\"..\") ? r : p;\n}\n","import type { CompressionState } from \"../types.js\";\nimport { createInitialState } from \"../state.js\";\n\n/**\n * Forward-compat: merge a parsed state with a fresh one so fields added in\n * later kernel versions get sane defaults instead of `undefined`. Nested\n * groups (nudge, stats) are shallow-merged per field so older snapshots\n * keep their values while newer counters default in.\n *\n * Lifted verbatim in behavior from billion-context's proxy mergeState.\n */\nexport function mergeCompressionState(parsed: CompressionState): CompressionState {\n  const fresh = createInitialState();\n  return {\n    blocks: parsed.blocks ?? fresh.blocks,\n    messageRefs: parsed.messageRefs ?? fresh.messageRefs,\n    nudge: { ...fresh.nudge, ...(parsed.nudge ?? {}) },\n    stats: { ...fresh.stats, ...(parsed.stats ?? {}) },\n    nextBlockId: parsed.nextBlockId ?? fresh.nextBlockId,\n    nextRunId: parsed.nextRunId ?? fresh.nextRunId,\n    tokenSnapshot: parsed.tokenSnapshot ?? fresh.tokenSnapshot,\n    absorbed: parsed.absorbed ?? fresh.absorbed,\n  };\n}\n"],"mappings":"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","names":["rel"]}
+{"version":3,"sources":["../../src/persist/store.ts","../../src/persist/state-merge.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport fsp from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Logger callback. Downstream routes it wherever it wants (file, stderr). */\nexport type PersistLogger = (level: \"info\" | \"warn\" | \"error\", msg: string) => void;\n\n/**\n * On-disk record shape. The store owns the envelope (version stamp, save\n * time, id) so atomicity and discovery can rely on it; the payload schema\n * is entirely downstream-owned. `payload` must be JSON-serializable.\n */\nexport interface PersistedEnvelope<T> {\n    version: number;\n    savedAt: number;\n    id: string;\n    payload: T;\n}\n\n/** A legacy (pre-envelope) record adopted on load. `version`/`savedAt`\n * preserve the source record's own stamps when present. */\nexport interface LegacyAdoption<T> {\n    id: string;\n    payload: T;\n    version?: number;\n    savedAt?: number;\n}\n\n/**\n * Optional record codec: transforms serialized envelopes between the store\n * and disk (e.g. compress and/or encrypt at rest). The store is\n * codec-agnostic — it hands `encode` the exact JSON string it would have\n * written and passes raw file bytes to `decode`, which must return that same\n * JSON string or throw, in which case the file is treated as corrupt\n * (skipped + logged) like any unreadable record. Format detection (magic\n * bytes, plaintext fallback for unencoded legacy files) is the codec's job,\n * so mixed trees of legacy plaintext and encoded files load fine.\n */\nexport interface StateStoreCodec {\n    encode(data: string): Buffer | string;\n    decode(buf: Buffer): string;\n}\n\nexport interface StateStoreOptions<T> {\n    /**\n     * Storage root. The kernel deliberately has NO default location: the\n     * downstream decides where state lives (CLI dir, XDG data dir, plugin\n     * dir, temp dir in tests). All records live under this directory.\n     */\n    dir: string;\n    /**\n     * Schema version stamped into every envelope. Owned by the downstream;\n     * bump it when the payload shape changes. The store itself never\n     * rejects a record over its version — migration policy belongs to the\n     * reader.\n     */\n    version: number;\n    /** Debounce window for scheduleSave, ms. Default 500. */\n    debounceMs?: number;\n    /** Default true. When false, all writes are silent no-ops and loads\n     *  return empty results. */\n    enabled?: boolean;\n    log?: PersistLogger;\n    /**\n     * Relative path (under `dir`) for a record, possibly namespaced into\n     * subdirectories (e.g. `openai/host-hash.json`). Default: flat\n     * `<sha256(id)[:24]>.json`.\n     *\n     * Because the path may depend on payload fields the store only learns\n     * at write time, single-record loads resolve namespaced files only\n     * after loadAll() has discovered them (or the store itself wrote\n     * them). The flat default name is always checked as a fallback, so\n     * downstreams using a custom relPath should call loadAll() at boot.\n     */\n    relPath?: (id: string, payload: T) => string;\n    /**\n     * Adopt records written by an older, pre-envelope schema. Receives the\n     * parsed JSON of any file that failed the envelope-shape check; return\n     * an adoption to load it as an envelope, or null to skip it. Adopted\n     * records are re-persisted in the current envelope format on the next\n     * dirty write — files migrate organically, and old files keep loading\n     * (same policy billion-context's proxy used for its v1→v3 migration).\n     */\n    legacy?: (parsed: unknown) => LegacyAdoption<T> | null;\n    /**\n     * Payload validation on load. Return false to skip a record (foreign\n     * schema, corrupt content). Default: envelope-shape check only\n     * (string id, non-null payload).\n     */\n    validate?: (envelope: PersistedEnvelope<T>) => boolean;\n    /**\n     * Optional codec applied around every write (canonical + spill) and\n     * read. See StateStoreCodec. Default: none — files are plain UTF-8 JSON.\n     */\n    codec?: StateStoreCodec;\n    /**\n     * Transient-write retry policy (Windows + hostile temp environments).\n     * The whole write cycle — mkdir, temp write, rename — is retried with\n     * exponential backoff when it fails with a TRANSIENT code: EPERM/EBUSY/\n     * EACCES (a lock held by AV scan, search indexer, SMB) or ENOENT/ENOTDIR\n     * (the temp file or its directory vanished between create and rename —\n     * observed on CI Windows runners where a sweeper deletes freshly\n     * created files under %TEMP%). The delay after attempt i is\n     * min(retryBaseMs * 2^i, retryMaxMs). Defaults (6 attempts, 50ms base,\n     * 1600ms cap) give a ~1.5s window per write path — long enough for most\n     * locks to release, short enough not to stall a sync flush. When the\n     * window is exhausted the write spills to a side file (see spillPath)\n     * instead of dropping the data.\n     */\n    retryAttempts?: number;\n    retryBaseMs?: number;\n    retryMaxMs?: number;\n}\n\n/**\n * Crash-safe, debounce-coalescing JSON state store. Mechanism only — lifted\n * from billion-context's proxy SessionStore and generalized:\n *\n * - atomic writes: temp file + rename, so a crash mid-write never leaves a\n *   truncated record (readers see either the old or the new file)\n * - whole-cycle retries with exponential backoff on transient fs failures:\n *   Windows locks (EPERM/EBUSY/EACCES from AV/indexer/SMB) and vanishing\n *   files/dirs (ENOENT/ENOTDIR — a sweeper deleting fresh temp files, seen\n *   on CI Windows runners); when the window is exhausted the record spills\n *   to a side file (`<name>.fb.json`) instead of being dropped, so a lock\n *   held by AV/indexer/SMB never silently loses session data\n * - per-id serialization so concurrent writeNow calls never interleave\n *   temp-file names or reorders writes\n * - debounced scheduleSave coalesces bursts into one write; the record is\n *   built at WRITE time from a builder, so late mutations are picked up\n * - optional record codec (compress/encrypt at rest): encode on every write,\n *   decode on every read; a decode failure is corrupt-file semantics\n * - loadAll skips `.tmp-*` orphans, corrupt JSON, and records whose\n *   filename does not match their id — one bad file never blocks boot; it\n *   reconciles a canonical record against its spill by savedAt (freshest wins)\n *\n * The store never deletes a record's data. On a successful canonical write it\n * removes a now-stale spill of the SAME id (a duplicate, not distinct data).\n * Session cleanup is a downstream policy decision (kernel position: persisted\n * state should not be deleted opportunistically).\n */\nexport class StateStore<T> {\n    readonly enabled: boolean;\n    private readonly dir: string;\n    private readonly version: number;\n    private readonly debounceMs: number;\n    private readonly log: PersistLogger;\n    private readonly legacyFn?: (parsed: unknown) => LegacyAdoption<T> | null;\n    private readonly relPathFn?: (id: string, payload: T) => string;\n    private readonly validateFn: (envelope: PersistedEnvelope<T>) => boolean;\n    private readonly codec?: StateStoreCodec;\n    private readonly retryAttempts: number;\n    private readonly retryBaseMs: number;\n    private readonly retryMaxMs: number;\n    private readonly timers = new Map<string, NodeJS.Timeout>();\n    private readonly pending = new Map<string, () => T>();\n    private readonly writeChains = new Map<string, Promise<void>>();\n    /** id → absolute path, populated by writes and loadAll. */\n    private readonly discovered = new Map<string, string>();\n    /** id → cumulative write-failure count, for rate-limited alerting. */\n    private readonly failCounts = new Map<string, number>();\n    /** Monotonic counter for unique temp filenames within a process. */\n    private tmpSeq = 0;\n\n    constructor(opts: StateStoreOptions<T>) {\n        this.dir = opts.dir;\n        this.version = opts.version;\n        this.debounceMs = opts.debounceMs ?? 500;\n        this.enabled = opts.enabled ?? true;\n        this.log = opts.log ?? ((_level, _msg) => {});\n        this.relPathFn = opts.relPath;\n        this.legacyFn = opts.legacy;\n        this.validateFn = opts.validate ?? defaultValidate;\n        this.codec = opts.codec;\n        this.retryAttempts = Math.max(1, opts.retryAttempts ?? 6);\n        this.retryBaseMs = Math.max(1, opts.retryBaseMs ?? 50);\n        this.retryMaxMs = Math.max(this.retryBaseMs, opts.retryMaxMs ?? 1600);\n    }\n\n    /** Debounced save. Coalesces bursts; the builder runs at write time, so\n     *  the freshest state is always persisted. Never throws. */\n    scheduleSave(id: string, build: () => T): void {\n        if (!this.enabled) return;\n        this.pending.set(id, build);\n        const existing = this.timers.get(id);\n        if (existing) return;\n        const timer = setTimeout(() => {\n            this.timers.delete(id);\n            const builder = this.pending.get(id);\n            this.pending.delete(id);\n            if (!builder) return;\n            // Errors are logged inside writeInner; swallowing here keeps a\n            // failed timer write from becoming an unhandledRejection.\n            void this.writeNow(id, builder).catch(() => {});\n        }, this.debounceMs);\n        timer.unref?.();\n        this.timers.set(id, timer);\n    }\n\n    /** Immediate save, serialized per id. Rejects on write failure; a\n     *  failing write never breaks the chain for the next one. */\n    async writeNow(id: string, build: () => T): Promise<void> {\n        if (!this.enabled) return;\n        // The previous promise may reject (disk full, EPERM) — catch so our\n        // chain doesn't break, then run our own write.\n        const prev = this.writeChains.get(id) ?? Promise.resolve();\n        const next = prev.catch(() => {}).then(() => this.writeInner(id, build));\n        this.writeChains.set(id, next);\n        // Clean up the chain entry once settled so the Map doesn't grow. The\n        // .catch() is load-bearing: .finally() returns a derived promise that\n        // nobody else holds — when the chain rejects it would surface as an\n        // unhandledRejection and crash the host on default Node settings.\n        next\n            .finally(() => {\n                if (this.writeChains.get(id) === next) this.writeChains.delete(id);\n            })\n            .catch(() => {});\n        return next;\n    }\n\n    /** Synchronous flush for one id. Used where the caller cannot await\n     *  (memory eviction, sync shutdown paths). Cancels any pending debounce\n     *  timer. Returns true on success, false on failure — callers that use\n     *  the result to drop in-memory state must NOT drop it on failure. */\n    flushSync(id: string, build: () => T): boolean {\n        if (!this.enabled) return true;\n        const timer = this.timers.get(id);\n        if (timer) {\n            clearTimeout(timer);\n            this.timers.delete(id);\n            this.pending.delete(id);\n        }\n        let payload: T;\n        try {\n            payload = build();\n        } catch (e) {\n            this.log(\"error\", `[persist] builder failed for ${id}: ${errText(e)}`);\n            return false;\n        }\n        const file = this.resolvePath(id, payload);\n        const data = this.serialize(id, payload);\n        let lastErr: unknown;\n        for (let attempt = 0; attempt < this.retryAttempts; attempt++) {\n            // Fresh temp name + mkdir per attempt — same reasoning as the\n            // async writeInner loop (delete-pending tombstones, swept dirs).\n            const tmp = this.tempPath(file);\n            try {\n                fs.mkdirSync(path.dirname(file), { recursive: true });\n                fs.writeFileSync(tmp, data);\n                fs.renameSync(tmp, file);\n                lastErr = undefined;\n                break;\n            } catch (e) {\n                lastErr = e;\n                try {\n                    fs.unlinkSync(tmp);\n                } catch {\n                    // temp never created or already gone\n                }\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                // sync sleep (Atomics.wait) — backoff grows per attempt\n                Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, this.backoffMs(attempt));\n            }\n        }\n        if (!lastErr) {\n            this.discovered.set(id, file);\n            this.clearFailure(id);\n            this.removeSpillSync(file);\n            return true;\n        }\n        // The canonical write outlived the retry window (Windows lock held by\n        // AV/indexer/SMB). Spill to a side file so the data still lands on\n        // disk instead of being dropped — loadAll picks the freshest of the\n        // canonical and the spill, with its own transient retry window.\n        const spill = this.spillPathFor(file);\n        let spillPath: string | null = null;\n        for (let attempt = 0; attempt < this.retryAttempts && spillPath === null; attempt++) {\n            try {\n                fs.mkdirSync(path.dirname(spill), { recursive: true });\n                fs.writeFileSync(spill, data);\n                spillPath = spill;\n            } catch (e) {\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, this.backoffMs(attempt));\n            }\n        }\n        if (spillPath) this.discovered.set(id, spillPath);\n        this.recordFailure(id, lastErr, spillPath);\n        return spillPath !== null;\n    }\n\n    /** Load one record. Checks the discovered path (from a prior\n     *  write/loadAll), an optional relative-path hint, and the flat default\n     *  name. Returns null when absent, disabled, corrupt, or rejected by\n     *  validate. The hint covers namespaced records the store has not\n     *  discovered (e.g. an evicted session re-requested with its meta,\n     *  where the path depends on data the store cannot reconstruct from\n     *  the id alone). */\n    loadSync(id: string, hint?: string): PersistedEnvelope<T> | null {\n        if (!this.enabled) return null;\n        const candidates = [\n            this.discovered.get(id),\n            hint ? path.join(this.dir, hint) : undefined,\n            path.join(this.dir, flatFileNameFor(id)),\n        ];\n        for (const file of candidates) {\n            if (!file) continue;\n            const envelope = this.readEnvelope(file);\n            if (envelope && envelope.id === id) return envelope;\n        }\n        return null;\n    }\n\n    /** Load every record under dir. Populates the discovery map (enables\n     *  loadSync for namespaced relPaths). Skips corrupt files, `.tmp-*`\n     *  orphans, and records whose filename does not match their id — one\n     *  bad file never blocks boot. Never throws. */\n    async loadAll(): Promise<Map<string, PersistedEnvelope<T>>> {\n        const out = new Map<string, PersistedEnvelope<T>>();\n        if (!this.enabled) return out;\n        const files = await this.walkJsonFiles(this.dir);\n        for (const file of files) {\n            const envelope = this.readEnvelope(file);\n            if (!envelope) continue;\n            const base = path.basename(file);\n            const relBase = path.basename(this.relPathOf(envelope.id, envelope.payload));\n            const flatBase = flatFileNameFor(envelope.id);\n            // A file is a valid record for its envelope id when its name is the\n            // canonical name OR a spill (`.fb`) of the canonical name. This lets\n            // a spilled record (written while the canonical was locked) be\n            // discovered and reconciled against the canonical by savedAt.\n            let owner: string | null = null;\n            if (base === relBase || base === flatBase) {\n                owner = envelope.id;\n            } else if (base.endsWith(\".fb.json\")) {\n                const canonicalBase = `${base.slice(0, -\".fb.json\".length)}.json`;\n                if (canonicalBase === relBase || canonicalBase === flatBase) {\n                    owner = envelope.id;\n                }\n            }\n            if (owner === null) {\n                this.log(\"warn\", `[persist] skipping ${rel(file, this.dir)}: filename does not match record id`);\n                continue;\n            }\n            const existing = out.get(owner);\n            if (!existing || envelope.savedAt >= existing.savedAt) {\n                out.set(owner, envelope);\n                this.discovered.set(owner, file);\n            }\n        }\n        return out;\n    }\n\n    /** Whether a debounced write is pending for an id. */\n    hasPending(id: string): boolean {\n        return this.timers.has(id);\n    }\n\n    /** Ids with a pending debounced write. */\n    pendingIds(): string[] {\n        return [...this.timers.keys()];\n    }\n\n    /** Flush every pending debounced write immediately, then drain in-flight\n     *  writes. For graceful shutdown (SIGTERM/SIGINT). Never rejects. */\n    async flushAll(): Promise<void> {\n        const ids = this.pendingIds();\n        for (const timer of this.timers.values()) clearTimeout(timer);\n        this.timers.clear();\n        const builders = new Map<string, () => T>();\n        for (const id of ids) {\n            const build = this.pending.get(id);\n            if (build) builders.set(id, build);\n            this.pending.delete(id);\n        }\n        await Promise.all(\n            [...builders.entries()].map(([id, build]) =>\n                this.writeNow(id, build).catch((e) => {\n                    this.log(\"error\", `[persist] shutdown flush failed for ${id}: ${errText(e)}`);\n                }),\n            ),\n        );\n        // Drain writes whose timer fired earlier but are still mid-flight.\n        await Promise.allSettled([...this.writeChains.values()]);\n    }\n\n    /** Cancel all pending debounced writes without flushing (tests). */\n    cancelAll(): void {\n        for (const timer of this.timers.values()) clearTimeout(timer);\n        this.timers.clear();\n        this.pending.clear();\n    }\n\n    private async writeInner(id: string, build: () => T): Promise<void> {\n        let payload: T;\n        try {\n            payload = build();\n        } catch (e) {\n            this.log(\"error\", `[persist] builder failed for ${id}: ${errText(e)}`);\n            throw e;\n        }\n        const file = this.resolvePath(id, payload);\n        const data = this.serialize(id, payload);\n        let lastErr: unknown;\n        for (let attempt = 0; attempt < this.retryAttempts; attempt++) {\n            // Fresh temp name per attempt: on Windows a failed cleanup can\n            // leave the previous name delete-pending, and creating over a\n            // tombstoned name fails immediately — reusing it would burn every\n            // remaining attempt before the write even happens. mkdir runs per\n            // attempt too: a sweeper may have deleted the directory after the\n            // previous cycle created it.\n            const tmp = this.tempPath(file);\n            try {\n                await fsp.mkdir(path.dirname(file), { recursive: true });\n                await fsp.writeFile(tmp, data);\n                await fsp.rename(tmp, file);\n                this.discovered.set(id, file);\n                this.clearFailure(id);\n                await this.removeSpill(file);\n                return;\n            } catch (e) {\n                lastErr = e;\n                // Clean up the .tmp orphan so the next write doesn't collide\n                // with it.\n                await fsp.unlink(tmp).catch(() => {});\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                const { promise, resolve } = Promise.withResolvers<void>();\n                setTimeout(resolve, this.backoffMs(attempt));\n                await promise;\n            }\n        }\n        // The canonical write outlived the retry window (Windows lock held\n        // by AV/indexer/SMB, or a sweeper keeps deleting the fresh temp).\n        // Spill to a side file so the data still lands on disk instead of\n        // being dropped — loadAll picks the freshest of the canonical and\n        // the spill. The spill write gets its own transient retry window for\n        // the same reason (observed failing with ENOENT alongside the\n        // canonical on CI Windows runners).\n        const spill = this.spillPathFor(file);\n        let spillPath: string | null = null;\n        for (let attempt = 0; attempt < this.retryAttempts && spillPath === null; attempt++) {\n            try {\n                await fsp.mkdir(path.dirname(spill), { recursive: true });\n                await fsp.writeFile(spill, data);\n                spillPath = spill;\n            } catch (e) {\n                if (!isTransientFsError(e) || attempt === this.retryAttempts - 1) break;\n                const { promise, resolve } = Promise.withResolvers<void>();\n                setTimeout(resolve, this.backoffMs(attempt));\n                await promise;\n            }\n        }\n        if (spillPath) this.discovered.set(id, spillPath);\n        this.recordFailure(id, lastErr, spillPath);\n        throw lastErr;\n    }\n\n    private envelope(id: string, payload: T): PersistedEnvelope<T> {\n        return { version: this.version, savedAt: Date.now(), id, payload };\n    }\n\n    /** Serialize an envelope for disk, applying the optional codec. Strings\n     *  are written as UTF-8 (the fs default); Buffer results pass through as\n     *  raw bytes. */\n    private serialize(id: string, payload: T): Buffer | string {\n        const json = JSON.stringify(this.envelope(id, payload));\n        return this.codec ? this.codec.encode(json) : json;\n    }\n\n    /** Absolute path for a record: custom relPath (guarded against path\n     *  escape) or the flat hash default. */\n    private resolvePath(id: string, payload: T): string {\n        return path.join(this.dir, this.relPathOf(id, payload));\n    }\n\n    private relPathOf(id: string, payload: T): string {\n        const custom = this.relPathFn?.(id, payload);\n        if (!custom) return flatFileNameFor(id);\n        const rel = path.normalize(custom);\n        if (path.isAbsolute(rel) || rel.split(/[\\\\/]+/).includes(\"..\")) {\n            this.log(\"warn\", `[persist] relPath for ${id} escapes dir; using flat name`);\n            return flatFileNameFor(id);\n        }\n        return rel;\n    }\n\n    /** Unique temp file next to the destination (same dir ⇒ same volume ⇒\n     *  rename is atomic). Prefixed `.tmp-` so loadAll skips orphans. */\n    private tempPath(dest: string): string {\n        const seq = this.tmpSeq++;\n        return path.join(path.dirname(dest), `.tmp-${path.basename(dest, \".json\")}-${process.pid}-${seq}`);\n    }\n\n    private backoffMs(attempt: number): number {\n        return Math.min(this.retryBaseMs * 2 ** attempt, this.retryMaxMs);\n    }\n\n    /** Side file for a record whose canonical write keeps failing: the\n     *  canonical name with a `.fb` (fallback) infix, e.g. `a.json` →\n     *  `a.fb.json`. One slot per id, overwritten on each spill, so a stuck\n     *  lock never accumulates files. Ends in `.json` so loadAll discovers it. */\n    private spillPathFor(file: string): string {\n        const base = path.basename(file);\n        const dot = base.lastIndexOf(\".\");\n        const stem = dot > 0 ? base.slice(0, dot) : base;\n        const ext = dot > 0 ? base.slice(dot) : \".json\";\n        return path.join(path.dirname(file), `${stem}.fb${ext}`);\n    }\n\n    /** Remove a stale spill after a successful canonical write (best-effort). */\n    private async removeSpill(file: string): Promise<void> {\n        await fsp.unlink(this.spillPathFor(file)).catch(() => {});\n    }\n\n    private removeSpillSync(file: string): void {\n        try {\n            fs.unlinkSync(this.spillPathFor(file));\n        } catch {\n            // no spill or still locked — loadAll reconciles by savedAt\n        }\n    }\n\n    /** Rate-limited failure alerting: log on the first failure and at each\n     *  power-of-two count (1,2,4,8,…), so a long lock yields ~log2(N) lines\n     *  instead of one per write. Includes the spill path so the operator can\n     *  see where the data landed. */\n    private recordFailure(id: string, err: unknown, spillPath: string | null): void {\n        const count = (this.failCounts.get(id) ?? 0) + 1;\n        this.failCounts.set(id, count);\n        const alertAt = count === 1 || (count >= 2 && (count & (count - 1)) === 0);\n        if (!alertAt) return;\n        const where = spillPath\n            ? `; data spilled to ${rel(spillPath, this.dir)}`\n            : \"; SPILLOVER ALSO FAILED — data at risk\";\n        this.log(count === 1 ? \"error\" : \"warn\", `[persist] write failed for ${id} (total ${count}x): ${errText(err)}${where}`);\n    }\n\n    private clearFailure(id: string): void {\n        this.failCounts.delete(id);\n    }\n\n    /** Parse + validate one file. Corrupt or invalid records return null\n     *  (logged) instead of throwing — load paths must never block boot. */\n    private readEnvelope(file: string): PersistedEnvelope<T> | null {\n        let parsed: unknown;\n        try {\n            const buf = fs.readFileSync(file);\n            const text = this.codec ? this.codec.decode(buf) : buf.toString(\"utf8\");\n            parsed = JSON.parse(text);\n        } catch (e) {\n            // A missing candidate path is an expected miss (loadSync probes);\n            // only genuinely unreadable/corrupt files get logged.\n            if ((e as NodeJS.ErrnoException).code !== \"ENOENT\") {\n                this.log(\"warn\", `[persist] skipping corrupt file ${rel(file, this.dir)}: ${errText(e)}`);\n            }\n            return null;\n        }\n        if (isEnvelopeLike(parsed)) {\n            if (!this.validateFn(parsed as PersistedEnvelope<T>)) {\n                this.log(\"warn\", `[persist] skipping invalid record ${rel(file, this.dir)}`);\n                return null;\n            }\n            return parsed as PersistedEnvelope<T>;\n        }\n        const adopted = this.adoptLegacy(parsed);\n        if (adopted) return adopted;\n        this.log(\"warn\", `[persist] skipping invalid record ${rel(file, this.dir)}`);\n        return null;\n    }\n\n    /** Wrap a legacy (pre-envelope) record as an envelope via the `legacy`\n     *  hook, then validate the adopted payload like any other. */\n    private adoptLegacy(parsed: unknown): PersistedEnvelope<T> | null {\n        const adoption = this.legacyFn ? this.legacyFn(parsed) : null;\n        if (!adoption || typeof adoption.id !== \"string\" || adoption.id.length === 0 || adoption.payload == null) {\n            return null;\n        }\n        const source = parsed as Partial<PersistedEnvelope<T>>;\n        const envelope: PersistedEnvelope<T> = {\n            version: adoption.version ?? source.version ?? this.version,\n            savedAt: adoption.savedAt ?? source.savedAt ?? 0,\n            id: adoption.id,\n            payload: adoption.payload,\n        };\n        if (!this.validateFn(envelope)) return null;\n        return envelope;\n    }\n\n    /** Iterative recursive walk (no readdir-recursive dependency), skipping\n     *  `.tmp-*` names and non-.json files. */\n    private async walkJsonFiles(root: string): Promise<string[]> {\n        const out: string[] = [];\n        const queue: string[] = [root];\n        while (queue.length > 0) {\n            const dir = queue.pop()!;\n            let dirents: fs.Dirent[];\n            try {\n                dirents = await fsp.readdir(dir, { withFileTypes: true });\n            } catch {\n                continue; // missing dir → no records yet\n            }\n            for (const d of dirents) {\n                if (d.name.startsWith(\".tmp-\")) continue;\n                const full = path.join(dir, d.name);\n                if (d.isDirectory()) queue.push(full);\n                else if (d.isFile() && d.name.endsWith(\".json\")) out.push(full);\n            }\n        }\n        return out;\n    }\n}\n\nfunction defaultValidate<T>(envelope: PersistedEnvelope<T>): boolean {\n    return typeof envelope.id === \"string\" && envelope.id.length > 0 && envelope.payload != null;\n}\n\nfunction isEnvelopeLike(value: unknown): value is PersistedEnvelope<unknown> {\n    if (!value || typeof value !== \"object\") return false;\n    const v = value as Partial<PersistedEnvelope<unknown>>;\n    return typeof v.id === \"string\" && \"payload\" in v;\n}\n\n/** Deterministic flat filename: `<sha256(id)[:24]>.json`. Truncated hash —\n *  96 bits keeps collisions unreachable for realistic id counts, and short\n *  names stay greppable. */\nexport function flatFileNameFor(id: string): string {\n    return createHash(\"sha256\").update(id, \"utf8\").digest(\"hex\").slice(0, 24) + \".json\";\n}\n\n/** Transient fs failure codes worth retrying the whole write cycle for:\n *  - EPERM/EBUSY/EACCES — a lock held on the file/dir (AV scan, search\n *    indexer, SMB); releases within the backoff window.\n *  - ENOENT/ENOTDIR — the temp file or its directory VANISHED between\n *    create and rename (a sweeper deleting fresh files under %TEMP%, seen\n *    on CI Windows runners), or a delete-pending tombstone from the same\n *    sweep. Recreating the dir + rewriting a fresh temp heals it. */\nfunction isTransientFsError(e: unknown): boolean {\n    const code = (e as NodeJS.ErrnoException).code;\n    return code === \"EPERM\" || code === \"EBUSY\" || code === \"EACCES\" || code === \"ENOENT\" || code === \"ENOTDIR\";\n}\n\nfunction errText(e: unknown): string {\n    return e instanceof Error ? e.message : String(e);\n}\n\n\nfunction rel(p: string, base: string): string {\n    const r = path.relative(base, p);\n    return r && !r.startsWith(\"..\") ? r : p;\n}\n","import type { CompressionState } from \"../types.js\";\nimport { createInitialState } from \"../state.js\";\n\n/**\n * Forward-compat: merge a parsed state with a fresh one so fields added in\n * later kernel versions get sane defaults instead of `undefined`. Nested\n * groups (nudge, stats) are shallow-merged per field so older snapshots\n * keep their values while newer counters default in.\n *\n * Lifted verbatim in behavior from billion-context's proxy mergeState.\n */\nexport function mergeCompressionState(parsed: CompressionState): CompressionState {\n  const fresh = createInitialState();\n  return {\n    blocks: parsed.blocks ?? fresh.blocks,\n    messageRefs: parsed.messageRefs ?? fresh.messageRefs,\n    nudge: { ...fresh.nudge, ...(parsed.nudge ?? {}) },\n    stats: { ...fresh.stats, ...(parsed.stats ?? {}) },\n    nextBlockId: parsed.nextBlockId ?? fresh.nextBlockId,\n    nextRunId: parsed.nextRunId ?? fresh.nextRunId,\n    tokenSnapshot: parsed.tokenSnapshot ?? fresh.tokenSnapshot,\n    absorbed: parsed.absorbed ?? fresh.absorbed,\n    terminalStreak: parsed.terminalStreak,\n  };\n}\n"],"mappings":"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","names":["rel"]}

package/dist/persist/state-merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-merge.d.ts","sourceRoot":"","sources":["../../src/persist/state-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAYhF"}
+{"version":3,"file":"state-merge.d.ts","sourceRoot":"","sources":["../../src/persist/state-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAahF"}

package/dist/pipeline.d.ts

@@ -8,6 +8,8 @@ export interface NodeEffects {
     nudge?: NudgeDecision;
     recommendation?: import("./types.js").Recommendation;
     truncatedCount?: number;
+    terminalEscape?: import("./types.js").TerminalEscapeSignal;
+    truncationSkipped?: string;
     readonly [key: string]: unknown;
 }
 export interface NodeIO {

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,YAAY,EAAE,cAAc,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;CACzD;AAED,wBAAgB,MAAM,CACpB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,WAAgB,GACxB,MAAM,CAER;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,eAAe,GACnB,MAAM,CAOR"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,YAAY,EAAE,cAAc,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,YAAY,EAAE,oBAAoB,CAAC;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;CACzD;AAED,wBAAgB,MAAM,CACpB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,WAAgB,GACxB,MAAM,CAER;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,eAAe,GACnB,MAAM,CAOR"}

package/dist/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,GACtB,UAAU,CA8EZ"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,gBAAgB,GACtB,UAAU,CA+EZ"}

package/dist/truncate-tools.d.ts

@@ -4,11 +4,18 @@ export interface TruncateOptions {
     keepPrefixChars?: number;
     keepSuffixChars?: number;
     protectRecentMessages?: number;
+    /** Also consider user/assistant text messages as LAST-RESORT candidates,
+     *  applied only after tool-result truncation fails to reach the target
+     *  (#300). Rendered block summaries are never touched. */
+    includeTextMessages?: boolean;
 }
 export interface TruncateResult {
     messages: CoreMessage[];
     truncatedCount: number;
     savedTokens: number;
+    /** Size-qualified candidates found (pre-truncation). 0 explains a silent
+     *  no-op at/above threshold — hosts should warn-log (#300). */
+    candidatesFound: number;
 }
 export declare function truncateLargeToolOutputs(messages: CoreMessage[], tokenCount: number, config: Config, countTokens: (text: string) => number, options?: TruncateOptions): TruncateResult;
 //# sourceMappingURL=truncate-tools.d.ts.map

package/dist/truncate-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"truncate-tools.d.ts","sourceRoot":"","sources":["../src/truncate-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACvB;AAUD,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,OAAO,GAAE,eAAoB,GAC9B,cAAc,CAmDhB"}
+{"version":3,"file":"truncate-tools.d.ts","sourceRoot":"","sources":["../src/truncate-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtD,MAAM,WAAW,eAAe;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;8DAE0D;IAC1D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB;mEAC+D;IAC/D,eAAe,EAAE,MAAM,CAAC;CAC3B;AAWD,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACrC,OAAO,GAAE,eAAoB,GAC9B,cAAc,CAiFhB"}

package/dist/types.d.ts

@@ -96,6 +96,23 @@ export interface AbsorbConfig {
     /** Tool-name patterns (glob suffix allowed) never absorbable, independent of protectedTools. */
     excludeTools: string[];
 }
+/** Emitted when the session's irreducible floor (system prompt + block
+ *  summaries + protected zones + small uncompressible tail) exceeds
+ *  modelContextLimit: usage stayed at/above truncate.threshold for N
+ *  consecutive events while no tier could reclaim the benefit floor AND
+ *  emergency truncation saved nothing (#300). Hosts surface this ONCE (UI +
+ *  one-time model-side message) instead of repeating the emergency nudge
+ *  forever — the kernel keeps emitting it every event while the condition
+ *  holds; deduplication is the host's job. */
+export interface TerminalEscapeSignal {
+    /** Model/host-facing guidance text. */
+    message: string;
+    usage: number;
+    tokenCount: number;
+    modelContextLimit: number;
+    /** Consecutive events the terminal condition has held. */
+    stuckEvents: number;
+}
 export interface CompressionState {
     blocks: CompressionBlock[];
     messageRefs: MessageRefMap;
@@ -109,6 +126,12 @@ export interface CompressionState {
     stats: CompressionStats;
     /** Instant tool-result absorption records. Optional: pre-absorb persisted states lack it. */
     absorbed?: AbsorbRecord[];
+    /** Consecutive processTurn events at/above truncate.threshold where no tier
+     *  could reclaim the benefit floor AND emergency truncation saved nothing
+     *  (#300). Drives the terminalEscape signal; reset by usage dropping below
+     *  threshold, viable compression appearing, truncation savings, or a
+     *  successful applyCompression. Optional for pre-existing persisted states. */
+    terminalStreak?: number;
     nextBlockId: number;
     nextRunId: number;
 }
@@ -153,6 +176,10 @@ export interface NudgeConfig {
 }
 export interface TruncateConfig {
     threshold: number;
+    /** Consecutive processTurn events at/above threshold with no viable
+     *  compression and zero truncation savings before terminalEscape fires
+     *  (#300). Default 3. Set 0 to disable the signal. */
+    terminalEscapeAfter?: number;
 }
 export interface CompressValidationConfig {
     /** Minimum total chars of original messages in a range to allow compression. 0 = disabled. Default 5000. */
@@ -275,6 +302,9 @@ export interface NudgeBreakdown {
     pendingT1: number;
     pendingT2: number;
     pendingT3: number;
+    /** Max pending across all tiers — compared against minPressureBenefit by the
+     *  emergency-truncate node to detect a terminal floor (#300). */
+    maxPending: number;
     [key: string]: number;
 }
 export interface ResolvedBoundary {
@@ -298,6 +328,13 @@ export interface ProcessTurnResult {
     messages: CoreMessage[];
     state: CompressionState;
     nudge?: NudgeDecision;
+    /** Terminal floor detected (#300): compression and truncation are both
+     *  exhausted while usage stays at/above truncate.threshold. Emitted every
+     *  event while the condition holds; hosts surface it once. */
+    terminalEscape?: TerminalEscapeSignal;
+    /** Set when emergency truncation ran at/above its threshold but reclaimed
+     *  nothing — hosts should warn-log this (it was silent before, #300). */
+    truncationSkipped?: string;
 }
 export interface StatusReport {
     contextUsage: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAC5B,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;uDAMmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8FAA8F;IAC9F,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB;;;;oBAIgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;;yBAIqB;IACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oHAAoH;IACpH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;4DAE4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,aAAa,CAAC;IAC3B;;;;6CAIyC;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB;;iFAE6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB;sBACkB;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,0HAA0H;IAC1H,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uHAAuH;IACvH,cAAc,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,cAAc,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;uBAEmB;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;oEAKgE;IAChE,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAK7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,4GAA4G;IAC5G,gBAAgB,EAAE,MAAM,CAAC;IACzB,+IAA+I;IAC/I,gBAAgB,EAAE,MAAM,CAAC;IACzB,uGAAuG;IACvG,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IAGnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACxE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,mBAAmB,EAAE,oBAAoB,CAAC;CACnE;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;6DAOyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;+EAG2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IACvC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC;;;;6BAIyB;IACzB,gBAAgB,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/B;qEACiE;IACjE,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;0BAG0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB;;wDAEgD;QAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/wire/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/wire/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACzF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3F,MAAM,MAAM,cAAc,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,GACd,iBAAiB,CAAC;AAExB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACvC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAGF,wBAAgB,aAAa,CAAC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAI5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,kBAAkB,EAAE,CAMjH;AAED,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAiFhE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,EAAE,CA0DjH;AAED;;;;yBAIyB;AACzB,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,oBAAoB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpG"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/wire/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACzF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3F,MAAM,MAAM,cAAc,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,GACd,iBAAiB,CAAC;AAExB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACvC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAGF,wBAAgB,aAAa,CAAC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAI5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,kBAAkB,EAAE,CAMjH;AAED,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAiFhE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,EAAE,CA0DjH;AAED;;;;yBAIyB;AACzB,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,oBAAoB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpG"}

package/dist/wire/index.js

@@ -169,7 +169,8 @@ function coreToAnthropic(messages, cacheControls) {
 }
 function conversationSignalAnthropic(body, headerValue) {
   if (headerValue && headerValue.trim()) return headerValue.trim();
-  const firstUser = body.messages.find((m) => m.role === "user");
+  const msgs = Array.isArray(body?.messages) ? body.messages : [];
+  const firstUser = msgs.find((m) => m?.role === "user");
   const seed = firstUser ? JSON.stringify(firstUser.content) : "default";
   return hashId(seed);
 }
@@ -414,7 +415,8 @@ ${extra}` : extra;
 }
 function conversationSignalOpenai(body, headerValue) {
   if (headerValue && headerValue.trim()) return headerValue.trim();
-  const firstUser = body.messages.find((m) => m.role === "user");
+  const msgs = Array.isArray(body?.messages) ? body.messages : [];
+  const firstUser = msgs.find((m) => m?.role === "user");
   const seed = firstUser ? stringContent(firstUser.content) : "default";
   return hashId(seed);
 }