claude-code-infinite 1.0.11 → 1.0.16

package/dist/route-fallback.d.ts

@@ -0,0 +1,67 @@
+/** After attempting compression at the soft budget, forward input that fits
+ * the model's native context together with its output reservation (the full
+ * max_tokens, or a floor on Claude 4.5+: see outputReservation). */
+export declare function fitsFallbackBudget(inputTokens: number, outputTokens: number, budgetTokens: number, contextTokens: number, model?: string): boolean;
+export interface RouteFallbackError {
+    status: 503 | 400;
+    attempt: number;
+    headers: Record<string, string>;
+    body: {
+        type: "error";
+        error: {
+            type: string;
+            message: string;
+        };
+    };
+}
+/** How long a lane may wait for MemTree to finish indexing before refusing. */
+export declare const INDEX_WAIT_DEADLINE_MS: number;
+/** Seconds Claude Code waits between retries while the index catches up. */
+export declare const INDEX_WAIT_RETRY_AFTER_SECONDS = 30;
+export declare const FINAL_REFUSAL_MESSAGE: string;
+export interface FallbackFailureContext {
+    /**
+     * This request's compress result did not fit only because MemTree's index
+     * is behind the conversation (most of it still verbatim). Retries then wait
+     * for indexing instead of spending the strike budget.
+     */
+    awaitingIndex?: boolean;
+    now?: number;
+}
+/**
+ * Claude Code 2.1.288 retries 503 itself, even with SDK maxRetries=0.
+ * 529 has extra overload handling (including indefinite watchdog retries).
+ * Use ordinary 503 retries and bound the episode in the proxy itself.
+ * Successful delivery ends an episode; hook events and elapsed time do not.
+ * An episode waiting on the index is bounded by wall clock instead of strikes.
+ */
+export declare class RouteFallbackFailures {
+    private readonly capacity;
+    private readonly indexWaitMs;
+    private readonly failures;
+    /** Lane -> when its index wait began (its deadline is fixed from then). */
+    private readonly indexWaits;
+    constructor(capacity?: number, indexWaitMs?: number);
+    fail(lane: string, context?: FallbackFailureContext): RouteFallbackError;
+    succeeded(lane: string): void;
+    /** The bounded three-strike episode: 503, 503, then 400 until delivery. */
+    private strike;
+    /**
+     * A 503 while the lane's wait is within its deadline; a 400 once it passes.
+     * The deadline is fixed when the wait starts and only a delivery clears it:
+     * an expired wait becomes a terminal strike state, and an active wait is
+     * never evicted. A lane already refused, or arriving while every wait slot
+     * is active, gets no wait (undefined) and falls back to the strikes.
+     */
+    private waitForIndex;
+    private indexWaitError;
+    /** Free the slots of waits past their deadline, keeping them refused. */
+    private retireExpiredWaits;
+    /**
+     * An expired wait's lane moves to the terminal strike state. If the strike
+     * table is full the wait keeps its slot instead (still expired, still
+     * refused), so no lane can be re-admitted with a fresh deadline.
+     */
+    private retire;
+}
+//# sourceMappingURL=route-fallback.d.ts.map

package/dist/route-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-fallback.d.ts","sourceRoot":"","sources":["../src/route-fallback.ts"],"names":[],"mappings":"AAGA;;oEAEoE;AACpE,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAKT;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACnE;AAED,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAClD,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,eAAO,MAAM,qBAAqB,QAI+B,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAM9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;gBAGrC,QAAQ,SAAM,EACd,WAAW,SAAyB;IAGvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,kBAAkB;IAQ5E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,2EAA2E;IAC3E,OAAO,CAAC,MAAM;IAYd;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,cAAc;IAKtB,yEAAyE;IACzE,OAAO,CAAC,kBAAkB;IAM1B;;;;OAIG;IACH,OAAO,CAAC,MAAM;CAKf"}

package/dist/route-fallback.js

@@ -0,0 +1,126 @@
+import { fitsNative, outputReservation } from "./request-sizing.js";
+import { MEMTREE_COMPACT_COMMAND, MEMTREE_VIEW_COMMAND, SESSION_PLUGIN_NAME } from "./hooks.js";
+/** After attempting compression at the soft budget, forward input that fits
+ * the model's native context together with its output reservation (the full
+ * max_tokens, or a floor on Claude 4.5+: see outputReservation). */
+export function fitsFallbackBudget(inputTokens, outputTokens, budgetTokens, contextTokens, model) {
+    return [inputTokens, outputTokens, budgetTokens, contextTokens].every((value) => Number.isFinite(value) && value >= 0) && fitsNative(inputTokens, { budget: budgetTokens, context: contextTokens,
+        output: outputReservation(model, outputTokens) });
+}
+/** How long a lane may wait for MemTree to finish indexing before refusing. */
+export const INDEX_WAIT_DEADLINE_MS = 10 * 60_000;
+/** Seconds Claude Code waits between retries while the index catches up. */
+export const INDEX_WAIT_RETRY_AFTER_SECONDS = 30;
+export const FINAL_REFUSAL_MESSAGE = "MemTree couldn't fit this request in the model's context window. If MemTree is " +
+    `still indexing a recent change (see the session link from /${SESSION_PLUGIN_NAME}:` +
+    `${MEMTREE_VIEW_COMMAND}), wait a minute and retry; otherwise run ` +
+    `/${SESSION_PLUGIN_NAME}:${MEMTREE_COMPACT_COMMAND} or /clear.`;
+/**
+ * Claude Code 2.1.288 retries 503 itself, even with SDK maxRetries=0.
+ * 529 has extra overload handling (including indefinite watchdog retries).
+ * Use ordinary 503 retries and bound the episode in the proxy itself.
+ * Successful delivery ends an episode; hook events and elapsed time do not.
+ * An episode waiting on the index is bounded by wall clock instead of strikes.
+ */
+export class RouteFallbackFailures {
+    capacity;
+    indexWaitMs;
+    failures = new Map();
+    /** Lane -> when its index wait began (its deadline is fixed from then). */
+    indexWaits = new Map();
+    constructor(capacity = 128, indexWaitMs = INDEX_WAIT_DEADLINE_MS) {
+        this.capacity = capacity;
+        this.indexWaitMs = indexWaitMs;
+    }
+    fail(lane, context = {}) {
+        if (context.awaitingIndex) {
+            const waiting = this.waitForIndex(lane, context.now ?? Date.now());
+            if (waiting)
+                return waiting;
+        }
+        return this.strike(lane);
+    }
+    succeeded(lane) {
+        this.failures.delete(lane);
+        this.indexWaits.delete(lane);
+    }
+    /** The bounded three-strike episode: 503, 503, then 400 until delivery. */
+    strike(lane) {
+        const previous = this.failures.get(lane);
+        // Fail closed when full rather than evicting a lane and granting it
+        // another retry budget. A successful lane frees its slot.
+        const attempt = previous === undefined && this.failures.size >= this.capacity
+            ? 3 : Math.min((previous ?? 0) + 1, 3);
+        if (previous !== undefined || this.failures.size < this.capacity) {
+            this.failures.set(lane, attempt);
+        }
+        return attempt <= 2 ? retryError(attempt, "1", RETRY_MESSAGE) : refusal(attempt);
+    }
+    /**
+     * A 503 while the lane's wait is within its deadline; a 400 once it passes.
+     * The deadline is fixed when the wait starts and only a delivery clears it:
+     * an expired wait becomes a terminal strike state, and an active wait is
+     * never evicted. A lane already refused, or arriving while every wait slot
+     * is active, gets no wait (undefined) and falls back to the strikes.
+     */
+    waitForIndex(lane, now) {
+        const wait = this.indexWaits.get(lane);
+        if (wait === undefined) {
+            if ((this.failures.get(lane) ?? 0) >= 3)
+                return undefined;
+            this.retireExpiredWaits(now);
+            if (this.indexWaits.size >= this.capacity)
+                return undefined;
+            this.indexWaits.set(lane, now);
+            return this.indexWaitError(lane);
+        }
+        if (now - wait < this.indexWaitMs)
+            return this.indexWaitError(lane);
+        this.retire(lane);
+        return refusal(3);
+    }
+    indexWaitError(lane) {
+        return retryError(this.failures.get(lane) ?? 0, String(INDEX_WAIT_RETRY_AFTER_SECONDS), INDEX_WAIT_MESSAGE);
+    }
+    /** Free the slots of waits past their deadline, keeping them refused. */
+    retireExpiredWaits(now) {
+        for (const [lane, started] of this.indexWaits) {
+            if (now - started >= this.indexWaitMs)
+                this.retire(lane);
+        }
+    }
+    /**
+     * An expired wait's lane moves to the terminal strike state. If the strike
+     * table is full the wait keeps its slot instead (still expired, still
+     * refused), so no lane can be re-admitted with a fresh deadline.
+     */
+    retire(lane) {
+        if (!this.failures.has(lane) && this.failures.size >= this.capacity)
+            return;
+        this.failures.set(lane, 3);
+        this.indexWaits.delete(lane);
+    }
+}
+const RETRY_MESSAGE = "MemTree could not produce a usable compressed request; retrying within a bounded limit.";
+const INDEX_WAIT_MESSAGE = "MemTree is still indexing this conversation, so it does not fit the model's context " +
+    "window yet; retrying once indexing catches up.";
+function retryError(attempt, retryAfter, message) {
+    return {
+        status: 503,
+        attempt,
+        headers: { "retry-after": retryAfter, "x-should-retry": "true" },
+        body: { type: "error", error: { type: "api_error", message } },
+    };
+}
+function refusal(attempt) {
+    return {
+        status: 400,
+        attempt,
+        headers: { "x-should-retry": "false" },
+        body: {
+            type: "error",
+            error: { type: "invalid_request_error", message: FINAL_REFUSAL_MESSAGE },
+        },
+    };
+}
+//# sourceMappingURL=route-fallback.js.map

package/dist/route-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-fallback.js","sourceRoot":"","sources":["../src/route-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEhG;;oEAEoE;AACpE,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,YAAoB,EACpB,YAAoB,EACpB,aAAqB,EACrB,KAAc;IAEd,OAAO,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,KAAK,CACnE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAChD,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa;QACzE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AASD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,MAAM,CAAC;AAClD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAChC,iFAAiF;IACjF,8DAA8D,mBAAmB,GAAG;IACpF,GAAG,oBAAoB,4CAA4C;IACnE,IAAI,mBAAmB,IAAI,uBAAuB,aAAa,CAAC;AAYlE;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IAMb;IACA;IANF,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtD,2EAA2E;IAC1D,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExD,YACmB,WAAW,GAAG,EACd,cAAc,sBAAsB;QADpC,aAAQ,GAAR,QAAQ,CAAM;QACd,gBAAW,GAAX,WAAW,CAAyB;IACpD,CAAC;IAEJ,IAAI,CAAC,IAAY,EAAE,UAAkC,EAAE;QACrD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACnE,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,2EAA2E;IACnE,MAAM,CAAC,IAAY;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,oEAAoE;QACpE,0DAA0D;QAC1D,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;YAC3E,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,IAAY,EAAE,GAAW;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC1D,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,8BAA8B,CAAC,EACpF,kBAAkB,CAAC,CAAC;IACxB,CAAC;IAED,yEAAyE;IACjE,kBAAkB,CAAC,GAAW;QACpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,IAAI,GAAG,GAAG,OAAO,IAAI,IAAI,CAAC,WAAW;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC5E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,aAAa,GACjB,yFAAyF,CAAC;AAC5F,MAAM,kBAAkB,GACtB,sFAAsF;IACtF,gDAAgD,CAAC;AAEnD,SAAS,UAAU,CAAC,OAAe,EAAE,UAAkB,EAAE,OAAe;IACtE,OAAO;QACL,MAAM,EAAE,GAAG;QACX,OAAO;QACP,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE;QAChE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;KAC/D,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO;QACL,MAAM,EAAE,GAAG;QACX,OAAO;QACP,OAAO,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE;QACtC,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,qBAAqB,EAAE;SACzE;KACF,CAAC;AACJ,CAAC"}

package/dist/route-identity.d.ts

@@ -0,0 +1,6 @@
+import { type Message } from "./turns.js";
+/** Hash each incoming message once, then reuse it across route candidates/checks. */
+export declare function routeMessageHash(message: Message): string;
+/** Stable prefixes span turns in which Claude can omit earlier thinking blocks. */
+export declare function stablePrefixMessageHash(message: Message): string;
+//# sourceMappingURL=route-identity.d.ts.map

package/dist/route-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-identity.d.ts","sourceRoot":"","sources":["../src/route-identity.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAOnE,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAKhE"}

package/dist/route-identity.js

@@ -0,0 +1,100 @@
+import { createHash } from "node:crypto";
+import { stripSystemReminderText } from "./turns.js";
+// Request messages are immutable snapshots. Weak keys retain no completed request.
+// Route installation stores these digests, not the original megabytes of history.
+const routeHashes = new WeakMap();
+const stableHashes = new WeakMap();
+/** Hash each incoming message once, then reuse it across route candidates/checks. */
+export function routeMessageHash(message) {
+    return messageHash(message, false);
+}
+/** Stable prefixes span turns in which Claude can omit earlier thinking blocks. */
+export function stablePrefixMessageHash(message) {
+    if (message.role !== "assistant" || !Array.isArray(message.content)) {
+        return routeMessageHash(message);
+    }
+    return messageHash(message, true);
+}
+function messageHash(message, stable) {
+    const cache = stable ? stableHashes : routeHashes;
+    const cached = cache.get(message);
+    if (cached !== undefined)
+        return cached;
+    let content = message.content;
+    if (stable && Array.isArray(content)) {
+        content = content.filter((part) => part?.type !== "thinking" && part?.type !== "redacted_thinking");
+    }
+    const blocks = typeof content === "string" ? [{ type: "text", text: content }] : content;
+    const normalized = { ...message, content: stripBlockCache(normalizeReminders(blocks)) };
+    const hash = createHash("sha256");
+    updateCanonical(hash, normalized);
+    const digest = hash.digest("hex");
+    cache.set(message, digest);
+    return digest;
+}
+/** Same transform for stored and incoming messages, including nested tool results. */
+function normalizeReminders(content) {
+    if (typeof content === "string")
+        return stripSystemReminderText(content);
+    if (!Array.isArray(content))
+        return content;
+    return content.map((part) => {
+        if (typeof part === "string")
+            return stripSystemReminderText(part);
+        if (!part || typeof part !== "object")
+            return part;
+        if (part.type === "text" && typeof part.text === "string") {
+            return { ...part, text: stripSystemReminderText(part.text) };
+        }
+        if (part.type === "tool_result") {
+            return { ...part, content: normalizeReminders(part.content) };
+        }
+        return part;
+    });
+}
+/** Cache metadata on blocks is incidental; identically named tool input keys aren't. */
+function stripBlockCache(content) {
+    if (Array.isArray(content))
+        return content.map(stripBlockCache);
+    if (!content || typeof content !== "object")
+        return content;
+    const { cache_control: _ignored, ...block } = content;
+    return block;
+}
+/**
+ * Typed, length-framed canonical encoding avoids serializing large strings twice.
+ * UTF-16 preserves lone surrogates too; UTF-8 would equate them with U+FFFD.
+ * This is a process-local identity digest, not a wire-format hash.
+ */
+function updateCanonical(hash, value) {
+    if (value === null || value === undefined) {
+        hash.update("n");
+    }
+    else if (typeof value === "string") {
+        hash.update(`s${value.length}:`).update(value, "utf16le");
+    }
+    else if (typeof value === "number") {
+        hash.update(Number.isFinite(value) ? `d${String(value)};` : "n");
+    }
+    else if (typeof value === "boolean") {
+        hash.update(value ? "t" : "f");
+    }
+    else if (Array.isArray(value)) {
+        hash.update(`a${value.length}:`);
+        for (const item of value)
+            updateCanonical(hash, item);
+    }
+    else if (typeof value === "object") {
+        const object = value;
+        const keys = Object.keys(object).filter((key) => object[key] !== undefined).sort();
+        hash.update(`o${keys.length}:`);
+        for (const key of keys) {
+            updateCanonical(hash, key);
+            updateCanonical(hash, object[key]);
+        }
+    }
+    else {
+        throw new TypeError("Route identity requires JSON message data");
+    }
+}
+//# sourceMappingURL=route-identity.js.map

package/dist/route-identity.js.map

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

package/dist/transcript-usage.d.ts

@@ -0,0 +1,57 @@
+import type { Message } from "./turns.js";
+export interface ResponseUsage {
+    output_tokens: number;
+    thinking_tokens: number;
+    input_tokens?: number;
+    cache_read_input_tokens?: number;
+    cache_creation_input_tokens?: number;
+}
+/** Keyed by the assistant message's position in the list sent to MemTree. */
+export type MessageUsage = Record<string, ResponseUsage>;
+/** ISO 8601 time of each message the transcript knows, keyed like MessageUsage. */
+export type MessageTimes = Record<string, string>;
+export interface TranscriptUsageSource {
+    /** Usage for each assistant message in `messages` that the transcript knows. */
+    usageFor(sessionId: string, messages: Message[], agentId?: string): MessageUsage;
+    /**
+     * When Claude Code wrote each message in `messages` that the transcript
+     * knows; a subagent's (`agentId`) from its own transcript.
+     */
+    timesFor?(sessionId: string, messages: Message[], agentId?: string): MessageTimes;
+    /**
+     * The session's last assistant reply when it made no tool call (the answer
+     * a turn ended with), as a message; read to the transcript's end.
+     */
+    finalReply?(sessionId: string): Message | undefined;
+    finalReplyAsync?(sessionId: string, signal?: AbortSignal): Promise<Message | undefined>;
+}
+/**
+ * Reads transcripts incrementally: each session's file is opened once and
+ * only the bytes appended since the last call are parsed.
+ */
+export declare class ClaudeTranscriptUsage implements TranscriptUsageSource {
+    private readonly projectsDir;
+    private readonly sessions;
+    constructor(projectsDir?: string);
+    usageFor(sessionId: string, messages: Message[], agentId?: string): MessageUsage;
+    /**
+     * Reads a session's transcript to its end now, off the request path. A
+     * lookup reads one bounded chunk, so without this the first requests after
+     * resuming a long session see only its oldest responses and undercount the
+     * thinking MemTree's budget check relies on. Best effort: never throws.
+     */
+    catchUp(sessionId: string): void;
+    timesFor(sessionId: string, messages: Message[], agentId?: string): MessageTimes;
+    finalReply(sessionId: string): Message | undefined;
+    finalReplyAsync(sessionId: string, signal?: AbortSignal): Promise<Message | undefined>;
+    private indexFor;
+}
+/** `$CLAUDE_CONFIG_DIR/projects`, else `~/.claude/projects`. */
+export declare function defaultProjectsDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * The session's transcript in whichever project directory holds it, or with
+ * `agentId`, that subagent's. The id is accepted with or without its `agent-`
+ * file prefix.
+ */
+export declare function findTranscript(projectsDir: string, sessionId: string, agentId?: string): string | undefined;
+//# sourceMappingURL=transcript-usage.d.ts.map

package/dist/transcript-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-usage.d.ts","sourceRoot":"","sources":["../src/transcript-usage.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAKzD,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAYlD,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACjF;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAClF;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACpD,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;CACzF;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,qBAAqB;IAI/D,OAAO,CAAC,QAAQ,CAAC,WAAW;IAH9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;gBAG5C,WAAW,GAAE,MAA6B;IAG7D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IAWhF;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAchC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IAWhF,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAgB5C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAoB5F,OAAO,CAAC,QAAQ;CAYjB;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG/E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAgBpB"}