@nexus-cortex/core 4.124.45 → 4.124.47

package/dist/orchestrator/appendOnlyHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appendOnlyHistory.d.ts","sourceRoot":"","sources":["../../src/orchestrator/appendOnlyHistory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEjF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEpF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEpF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEvF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wGAAwG;AACxG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CASzE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOnE"}
+{"version":3,"file":"appendOnlyHistory.d.ts","sourceRoot":"","sources":["../../src/orchestrator/appendOnlyHistory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEjF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEpF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEpF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEvF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wGAAwG;AACxG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CASzE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAUnE"}

package/dist/orchestrator/appendOnlyHistory.js

@@ -70,6 +70,10 @@ export function isPreviousResponseUnavailable(err) {
         .filter((x) => typeof x === 'string').join(' ');
     if (/previous[_ ]?response/i.test(text) && /not[_ ]?found|expired|invalid|does not exist|unavailable|no longer|not stored|unknown/i.test(text))
         return true;
+    // xAI (live probe 2026-10-02): 404 {"code":"not-found","error":"Response with id=resp_… not found"}; APIClient throws it as plain text
+    // ("XAI Responses API error 404: …") with no status field, so match the body wording itself.
+    if (/response with id\s*=?\s*['"]?resp_\S*['"]? not[ _-]?found/i.test(text))
+        return true;
     return status === 404 && /\bresponse\b/i.test(text);
 }
 //# sourceMappingURL=appendOnlyHistory.js.map

package/dist/orchestrator/appendOnlyHistory.js.map

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

package/dist/orchestrator/geminiExplicitCache.d.ts

@@ -0,0 +1,79 @@
+export declare function isGeminiExplicitCacheEnabled(): boolean;
+export declare function geminiCacheTtlSeconds(): number;
+export declare function geminiCacheResnapshotTokens(): number;
+/**
+ * Minimum cacheable input tokens (ai.google.dev/gemini-api/docs/caching, read 2026-10-03: Gemini 3.5–3.8 Flash
+ * and 3.1 Pro Preview 4,096; 2.5 Flash / 2.5 Pro 2,048; gemini-3-flash-preview not listed → 4,096 assumed).
+ * CORTEX_GEMINI_CACHE_MIN_TOKENS overrides.
+ */
+export declare function geminiMinCacheTokens(modelId: string): number;
+/** Rough token estimate used for every threshold (chars / 4 of the JSON wire form). */
+export declare function estimateTokens(value: unknown): number;
+/** Body field names: REST (snake_case, top level) vs @google/genai SDK (camelCase, inside config). */
+export type GeminiBodyFlavor = 'rest' | 'sdk';
+export interface GeminiCachePlan {
+    slotKey: string;
+    name: string;
+    prefixLen: number;
+    /** 'created' (new snapshot this request) | 'reused' */
+    mode: 'created' | 'reused';
+}
+export interface GeminiCacheContext {
+    sessionId?: string;
+    /** bare model id (no models/ prefix, no -sdk suffix) */
+    modelId: string;
+    /** API key + header used for the cachedContents REST calls */
+    apiKey: string;
+    /** v1beta base, e.g. https://generativelanguage.googleapis.com/v1beta */
+    baseUrl?: string;
+}
+type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<any>;
+}>;
+export declare const GEMINI_V1BETA_BASE = "https://generativelanguage.googleapis.com/v1beta";
+/** `https://…/v1beta/models` (card endpoint) → `https://…/v1beta`. */
+export declare function geminiBaseFromEndpoint(endpoint: string | undefined): string;
+export declare class GeminiExplicitCacheManager {
+    private slots;
+    private fetchImpl;
+    private now;
+    constructor(opts?: {
+        fetchImpl?: FetchLike;
+        now?: () => number;
+    });
+    /** Live snapshot names (tests / telemetry). */
+    liveNames(): string[];
+    /**
+     * Decide + (if needed) create the snapshot for this request. Returns the plan and the rewritten body, or null
+     * (send the original body unchanged). Never throws.
+     *
+     * @param holder the object that carries system/tools/toolConfig (REST: the body; SDK: body.config)
+     */
+    prepare(ctx: GeminiCacheContext, flavor: GeminiBodyFlavor, body: Record<string, any>): Promise<{
+        plan: GeminiCachePlan;
+        body: Record<string, any>;
+    } | null>;
+    private prepareInner;
+    /** Body for a cached request: no system/tools/toolConfig, cachedContent + the uncached tail. Never mutates the input. */
+    rewrite(flavor: GeminiBodyFlavor, body: Record<string, any>, name: string, prefixLen: number): Record<string, any>;
+    /** The cached request failed: drop the snapshot so the caller's full-request retry (and later turns) start clean. */
+    invalidate(plan: GeminiCachePlan, reason: string, ctx?: GeminiCacheContext): void;
+    /** Telemetry for a completed cached request. */
+    recordUsage(plan: GeminiCachePlan, usage: any): void;
+    private maybeExtend;
+    private deleteRemote;
+    private evict;
+    /** Best-effort DELETE of every live snapshot (session end). */
+    disposeAll(apiKey: string | undefined, baseUrl?: string): Promise<void>;
+}
+/** HTTP statuses on a cached request that mean "the cache is the problem" → invalidate + full retry once. */
+export declare function isCacheUseFailure(status: number | undefined): boolean;
+export {};
+//# sourceMappingURL=geminiExplicitCache.d.ts.map

package/dist/orchestrator/geminiExplicitCache.d.ts.map

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

package/dist/orchestrator/geminiExplicitCache.js

@@ -0,0 +1,324 @@
+/**
+ * HB-GEMINI-EXPLICIT-CACHE (DARK, CORTEX_GEMINI_EXPLICIT_CACHE; 2026-10-03).
+ *
+ * Gemini implicit caching is partial on gemini-3-flash-preview (a fixed ~12K head, the growing conversation is
+ * not cached) and absent on gemini-3.8-flash (.cortex/research/stack-portability-2026-10-02.md §"GEMINI
+ * CHAT/COMPLETIONS"). Explicit `cachedContents` caches cached 13,405/13,414 prompt tokens on both (§"GEMINI
+ * EXPLICIT cachedContents FEASIBILITY"). This module turns that into an append-only cache for the tool loop:
+ *
+ * - HEAD = (model, systemInstruction, tools, toolConfig) as the request body would have sent them. A SLOT per
+ *   (session, head) holds at most one live snapshot {name, prefixLen, prefixHash, expiresAt}. Several heads per
+ *   session coexist (a helper call with its own system prompt does not evict the main loop's snapshot); LRU cap.
+ * - SNAPSHOT = cachedContents.create(head + contents[0..prefixLen)), prefixLen = contents.length - 1 (the newest
+ *   turn is always sent live). Created the first time head+prefix is estimated (chars/4) at or above the model's
+ *   minimum cache size; re-created when the uncached tail (contents after prefixLen, newest turn excluded) exceeds
+ *   CORTEX_GEMINI_CACHE_RESNAPSHOT_TOKENS, or when the snapshot is (nearly) expired. The superseded snapshot is
+ *   DELETEd. A head change (system/tools/toolConfig change — e.g. the anchor lift) is a new slot = new snapshot
+ *   (the one intended bust).
+ * - USE: the request drops systemInstruction/tools/toolConfig (Gemini 400s when they are set beside
+ *   cachedContent — they live in the cache) and sends cachedContent + contents.slice(prefixLen). The prefix is
+ *   verified by hash before every use; a rewritten history (compaction, prune, wall drop, image TTL) fails the
+ *   hash → re-snapshot (or full request when too small).
+ * - TTL: CORTEX_GEMINI_CACHE_TTL_S (default 300); PATCHed (fire-and-forget) when used in the second half of its
+ *   life. disposeAll() DELETEs every live snapshot (orchestrator cleanup).
+ * - FALLBACK: cache management never blocks a request. A create failure sends the normal full request and backs
+ *   off re-creating until the prefix has grown by another resnapshot threshold; a 400/403/404 on a cached request
+ *   invalidates the slot and the caller re-sends the normal full request once.
+ * - A request carrying a forced toolConfig (per-turn tool_choice) bypasses the cache: Gemini cannot take
+ *   toolConfig beside cachedContent, and a per-turn snapshot would cost a full-price creation for one request.
+ *
+ * Off (unset) = callers never construct a plan → byte-identical requests.
+ */
+import { createHash } from 'crypto';
+function flagOn(raw) {
+    const v = String(raw ?? '').trim().toLowerCase();
+    return v === 'on' || v === 'true' || v === '1';
+}
+export function isGeminiExplicitCacheEnabled() {
+    return flagOn(process.env.CORTEX_GEMINI_EXPLICIT_CACHE);
+}
+function intEnv(name, dflt, min) {
+    const n = Number.parseInt(String(process.env[name] ?? '').trim(), 10);
+    return Number.isFinite(n) && n >= min ? n : dflt;
+}
+export function geminiCacheTtlSeconds() {
+    return intEnv('CORTEX_GEMINI_CACHE_TTL_S', 300, 60);
+}
+export function geminiCacheResnapshotTokens() {
+    return intEnv('CORTEX_GEMINI_CACHE_RESNAPSHOT_TOKENS', 16000, 1024);
+}
+/**
+ * Minimum cacheable input tokens (ai.google.dev/gemini-api/docs/caching, read 2026-10-03: Gemini 3.5–3.8 Flash
+ * and 3.1 Pro Preview 4,096; 2.5 Flash / 2.5 Pro 2,048; gemini-3-flash-preview not listed → 4,096 assumed).
+ * CORTEX_GEMINI_CACHE_MIN_TOKENS overrides.
+ */
+export function geminiMinCacheTokens(modelId) {
+    const o = intEnv('CORTEX_GEMINI_CACHE_MIN_TOKENS', 0, 1);
+    if (o > 0)
+        return o;
+    return /gemini-2\.5/.test(modelId) ? 2048 : 4096;
+}
+/** Rough token estimate used for every threshold (chars / 4 of the JSON wire form). */
+export function estimateTokens(value) {
+    if (value === undefined || value === null)
+        return 0;
+    return Math.ceil(JSON.stringify(value).length / 4);
+}
+function sha(value) {
+    return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex');
+}
+const FIELDS = {
+    rest: { system: 'system_instruction', tools: 'tools', toolConfig: 'tool_config', cached: 'cachedContent' },
+    sdk: { system: 'systemInstruction', tools: 'tools', toolConfig: 'toolConfig', cached: 'cachedContent' },
+};
+export const GEMINI_V1BETA_BASE = 'https://generativelanguage.googleapis.com/v1beta';
+/** `https://…/v1beta/models` (card endpoint) → `https://…/v1beta`. */
+export function geminiBaseFromEndpoint(endpoint) {
+    if (!endpoint)
+        return GEMINI_V1BETA_BASE;
+    return endpoint.replace(/\/+$/, '').replace(/\/models$/, '');
+}
+function toContent(system) {
+    // REST system_instruction is already a Content; the SDK accepts a bare string.
+    if (typeof system === 'string')
+        return { parts: [{ text: system }] };
+    return system;
+}
+function log(msg) {
+    // One line per cache event; quiet unless the lever is on (callers only reach here with it on).
+    if (process.env.CORTEX_GEMINI_CACHE_QUIET === 'true')
+        return;
+    console.error(`[gemini-cache] ${msg}`);
+}
+const MAX_SLOTS = 8;
+const EXPIRY_SAFETY_MS = 15_000;
+export class GeminiExplicitCacheManager {
+    slots = new Map();
+    fetchImpl;
+    now;
+    constructor(opts = {}) {
+        this.fetchImpl = opts.fetchImpl ?? ((url, init) => globalThis.fetch(url, init));
+        this.now = opts.now ?? (() => Date.now());
+    }
+    /** Live snapshot names (tests / telemetry). */
+    liveNames() {
+        return [...this.slots.values()].map((s) => s.name).filter((n) => !!n);
+    }
+    /**
+     * Decide + (if needed) create the snapshot for this request. Returns the plan and the rewritten body, or null
+     * (send the original body unchanged). Never throws.
+     *
+     * @param holder the object that carries system/tools/toolConfig (REST: the body; SDK: body.config)
+     */
+    async prepare(ctx, flavor, body) {
+        try {
+            return await this.prepareInner(ctx, flavor, body);
+        }
+        catch (e) {
+            log(`fallback reason=prepare_error ${String(e?.message ?? e).slice(0, 200)}`);
+            return null;
+        }
+    }
+    async prepareInner(ctx, flavor, body) {
+        const f = FIELDS[flavor];
+        const holder = flavor === 'sdk' ? (body.config ?? {}) : body;
+        // SDK legacy path (CORTEX_GEMINI_SYSTEM_FIX off) sets a top-level systemInstruction the SDK drops; mirror what is
+        // actually sent (config.systemInstruction only), so the cached head equals the uncached request's head.
+        const contents = Array.isArray(body.contents) ? body.contents : [];
+        if (contents.length < 2)
+            return null; // nothing to cache before the newest turn
+        if (holder.tool_config !== undefined || holder.toolConfig !== undefined) {
+            log(`bypass reason=tool_config (forced tool_choice is per-turn; cannot ride a cache)`);
+            return null;
+        }
+        const system = holder[f.system];
+        const tools = holder[f.tools];
+        const headHash = sha({ m: ctx.modelId, s: system ?? null, t: tools ?? null, c: null });
+        const slotKey = `${ctx.sessionId ?? 'default'}|${headHash}`;
+        const base = ctx.baseUrl ?? GEMINI_V1BETA_BASE;
+        const now = this.now();
+        let slot = this.slots.get(slotKey);
+        const prefixLenWanted = contents.length - 1;
+        // 1. Is the live snapshot usable as-is?
+        if (slot?.name) {
+            const valid = slot.prefixLen <= prefixLenWanted &&
+                slot.expiresAt - EXPIRY_SAFETY_MS > now &&
+                sha(contents.slice(0, slot.prefixLen)) === slot.prefixHash;
+            if (!valid) {
+                const why = slot.expiresAt - EXPIRY_SAFETY_MS <= now ? 'expired' : 'prefix_changed';
+                log(`invalidate reason=${why} name=${slot.name}`);
+                this.deleteRemote(base, ctx.apiKey, slot.name);
+                slot.name = undefined;
+            }
+            else {
+                const tailTokens = estimateTokens(contents.slice(slot.prefixLen, prefixLenWanted));
+                if (tailTokens <= geminiCacheResnapshotTokens()) {
+                    slot.lastUsed = now;
+                    this.maybeExtend(base, ctx.apiKey, slot);
+                    return { plan: { slotKey, name: slot.name, prefixLen: slot.prefixLen, mode: 'reused' }, body: this.rewrite(flavor, body, slot.name, slot.prefixLen) };
+                }
+                log(`resnapshot reason=tail_tokens~${tailTokens} name=${slot.name}`);
+                // fall through: create a longer snapshot, then delete the old one
+            }
+        }
+        // 2. Create (or re-create) a snapshot of head + contents[0..prefixLenWanted).
+        const prefix = contents.slice(0, prefixLenWanted);
+        const est = estimateTokens(system) + estimateTokens(tools) + estimateTokens(prefix);
+        const min = geminiMinCacheTokens(ctx.modelId);
+        if (est < min) {
+            // Still usable old snapshot (tail-threshold path)? keep using it.
+            if (slot?.name)
+                return { plan: { slotKey, name: slot.name, prefixLen: slot.prefixLen, mode: 'reused' }, body: this.rewrite(flavor, body, slot.name, slot.prefixLen) };
+            return null;
+        }
+        if (slot?.createFailedAtTokens !== undefined && est < slot.createFailedAtTokens + geminiCacheResnapshotTokens()) {
+            if (slot.name)
+                return { plan: { slotKey, name: slot.name, prefixLen: slot.prefixLen, mode: 'reused' }, body: this.rewrite(flavor, body, slot.name, slot.prefixLen) };
+            return null; // backoff after a failed create
+        }
+        const ttl = geminiCacheTtlSeconds();
+        const createBody = { model: `models/${ctx.modelId}`, contents: prefix, ttl: `${ttl}s` };
+        if (system !== undefined)
+            createBody.systemInstruction = toContent(system);
+        if (tools !== undefined)
+            createBody.tools = tools;
+        const res = await this.fetchImpl(`${base}/cachedContents`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'x-goog-api-key': ctx.apiKey },
+            body: JSON.stringify(createBody),
+        });
+        if (!res.ok) {
+            const txt = await res.text().catch(() => '');
+            log(`fallback reason=create_${res.status} est~${est} ${txt.replace(/\s+/g, ' ').slice(0, 200)}`);
+            if (!slot) {
+                slot = { key: slotKey, prefixLen: 0, prefixHash: '', expiresAt: 0, lastUsed: now };
+                this.slots.set(slotKey, slot);
+            }
+            slot.createFailedAtTokens = est;
+            if (slot.name)
+                return { plan: { slotKey, name: slot.name, prefixLen: slot.prefixLen, mode: 'reused' }, body: this.rewrite(flavor, body, slot.name, slot.prefixLen) };
+            return null;
+        }
+        const created = await res.json();
+        const name = created?.name;
+        if (!name) {
+            log('fallback reason=create_no_name');
+            return null;
+        }
+        const old = slot?.name;
+        const expireMs = Date.parse(created?.expireTime ?? '');
+        const fresh = {
+            key: slotKey,
+            name,
+            prefixLen: prefixLenWanted,
+            prefixHash: sha(prefix),
+            expiresAt: Number.isFinite(expireMs) ? expireMs : now + ttl * 1000,
+            lastUsed: now,
+        };
+        this.slots.delete(slotKey);
+        this.slots.set(slotKey, fresh);
+        log(`created name=${name} model=${ctx.modelId} prefixLen=${prefixLenWanted} est~${est} tokens=${created?.usageMetadata?.totalTokenCount ?? '?'} ttl=${ttl}s`);
+        if (old)
+            this.deleteRemote(base, ctx.apiKey, old);
+        this.evict(base, ctx.apiKey);
+        return { plan: { slotKey, name, prefixLen: prefixLenWanted, mode: 'created' }, body: this.rewrite(flavor, body, name, prefixLenWanted) };
+    }
+    /** Body for a cached request: no system/tools/toolConfig, cachedContent + the uncached tail. Never mutates the input. */
+    rewrite(flavor, body, name, prefixLen) {
+        const f = FIELDS[flavor];
+        const out = { ...body, contents: body.contents.slice(prefixLen) };
+        if (flavor === 'sdk') {
+            const config = { ...(body.config ?? {}) };
+            delete config[f.system];
+            delete config[f.tools];
+            delete config[f.toolConfig];
+            config[f.cached] = name;
+            out.config = config;
+            delete out.systemInstruction; // legacy top-level slot (never valid beside a cache)
+        }
+        else {
+            delete out[f.system];
+            delete out.systemInstruction;
+            delete out[f.tools];
+            delete out[f.toolConfig];
+            delete out.toolConfig;
+            out[f.cached] = name;
+        }
+        return out;
+    }
+    /** The cached request failed: drop the snapshot so the caller's full-request retry (and later turns) start clean. */
+    invalidate(plan, reason, ctx) {
+        const slot = this.slots.get(plan.slotKey);
+        log(`fallback reason=${reason} name=${plan.name}`);
+        if (slot && slot.name === plan.name) {
+            slot.name = undefined;
+            if (ctx)
+                this.deleteRemote(ctx.baseUrl ?? GEMINI_V1BETA_BASE, ctx.apiKey, plan.name);
+        }
+    }
+    /** Telemetry for a completed cached request. */
+    recordUsage(plan, usage) {
+        const cached = usage?.cachedContentTokenCount ?? 0;
+        const prompt = usage?.promptTokenCount ?? 0;
+        log(`${plan.mode === 'created' ? 'used(new)' : 'reused'} name=${plan.name} prefixLen=${plan.prefixLen} cachedContentTokenCount=${cached} promptTokenCount=${prompt}`);
+    }
+    maybeExtend(base, apiKey, slot) {
+        const ttl = geminiCacheTtlSeconds();
+        if (slot.extending || slot.expiresAt - this.now() > (ttl * 1000) / 2 || !slot.name)
+            return;
+        slot.extending = true;
+        const name = slot.name;
+        void this.fetchImpl(`${base}/${name}?updateMask=ttl`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json', 'x-goog-api-key': apiKey },
+            body: JSON.stringify({ ttl: `${ttl}s` }),
+        })
+            .then(async (r) => {
+            if (r.ok) {
+                const j = await r.json().catch(() => ({}));
+                const e = Date.parse(j?.expireTime ?? '');
+                if (slot.name === name)
+                    slot.expiresAt = Number.isFinite(e) ? e : this.now() + ttl * 1000;
+                log(`extended name=${name} ttl=${ttl}s`);
+            }
+            else {
+                log(`extend_failed status=${r.status} name=${name}`);
+            }
+        })
+            .catch((e) => log(`extend_failed ${String(e?.message ?? e).slice(0, 120)}`))
+            .finally(() => { slot.extending = false; });
+    }
+    deleteRemote(base, apiKey, name) {
+        void this.fetchImpl(`${base}/${name}`, { method: 'DELETE', headers: { 'x-goog-api-key': apiKey } })
+            .then((r) => log(`deleted name=${name} status=${r.status}`))
+            .catch((e) => log(`delete_failed name=${name} ${String(e?.message ?? e).slice(0, 120)}`));
+    }
+    evict(base, apiKey) {
+        while (this.slots.size > MAX_SLOTS) {
+            let oldest;
+            for (const s of this.slots.values())
+                if (!oldest || s.lastUsed < oldest.lastUsed)
+                    oldest = s;
+            if (!oldest)
+                return;
+            if (oldest.name)
+                this.deleteRemote(base, apiKey, oldest.name);
+            this.slots.delete(oldest.key);
+        }
+    }
+    /** Best-effort DELETE of every live snapshot (session end). */
+    async disposeAll(apiKey, baseUrl = GEMINI_V1BETA_BASE) {
+        const names = this.liveNames();
+        this.slots.clear();
+        if (!apiKey || names.length === 0)
+            return;
+        await Promise.all(names.map((name) => this.fetchImpl(`${baseUrl}/${name}`, { method: 'DELETE', headers: { 'x-goog-api-key': apiKey } })
+            .then((r) => log(`deleted name=${name} status=${r.status} (dispose)`))
+            .catch(() => undefined)));
+    }
+}
+/** HTTP statuses on a cached request that mean "the cache is the problem" → invalidate + full retry once. */
+export function isCacheUseFailure(status) {
+    return status === 400 || status === 403 || status === 404;
+}
+//# sourceMappingURL=geminiExplicitCache.js.map

package/dist/orchestrator/geminiExplicitCache.js.map

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

package/dist/orchestrator/transportEffortFixes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Transport reasoning-effort fixes (2026-10-02; stack-portability map
+ * .cortex/research/stack-portability-2026-10-02.md, note N1). Each is DARK behind its own env flag; with the flag off
+ * every caller takes its pre-existing code path unchanged (byte-identical requests).
+ *
+ * - CORTEX_OPENAI_TOOLS_REASONING: the gateway forwards the request/action effort for OpenAI reasoning cards even though they
+ *   do not declare `reasoning.toggleable`, so CORTEX_ACTION_EFFORT reaches `reasoning.effort` on the RESPONSES API. Chat/completions
+ *   is unchanged: R19b's drop stays because OpenAI still rejects reasoning_effort + function tools there (live probe 2026-10-03:
+ *   gpt-5.4-nano + gpt-5.6-luna → 400 "use /v1/responses"); Responses accepts it with tools (200 on both).
+ * - CORTEX_ANTHROPIC_EFFORT: Anthropic adaptive-thinking families (claude-4.7 / 4.8 / claude-5 / claude-fable-5) got
+ *   `thinking:{type:'adaptive'}` only, so the action effort never reached the wire. On: `output_config.effort` = the
+ *   effort (low|medium|high|xhigh|max; GA, no beta header). Non-adaptive families: `max` was not in the budget map and
+ *   fell to 10000; on, `max` maps to a large budget clamped below max_tokens (budget_tokens must be < max_tokens, >= 1024).
+ * - CORTEX_GEMINI_TOOLS_THINKING: Gemini thinkingConfig was never sent with tools (the @google/genai builders skipped
+ *   it — "cannot coexist", a Gemini 2.0-era observation) and the REST builder only ever sent a card-level thinkingLevel.
+ *   On: the action effort maps to generationConfig.thinkingConfig — `thinkingLevel` on Gemini 3.x, `thinkingBudget` on
+ *   2.5 and older — on REST and SDK, with or without tools.
+ *
+ * Pure helpers — no client state. Flags are resolved per call so tests/benches can flip them.
+ */
+export declare function isOpenAIToolsReasoningEnabled(): boolean;
+export declare function isAnthropicEffortEnabled(): boolean;
+export declare function isGeminiToolsThinkingEnabled(): boolean;
+/**
+ * `output_config.effort` value for an adaptive-thinking family, or undefined (send nothing → provider default).
+ * 'none' / unknown values send nothing (adaptive families have no "off" effort).
+ */
+export declare function anthropicOutputEffort(reasoningEffort: string | undefined): string | undefined;
+/** Target thinking budget for effort `max` on budget_tokens families (before the max_tokens clamp). */
+export declare const ANTHROPIC_MAX_EFFORT_BUDGET = 120000;
+/** Visible-output room kept below max_tokens when clamping the `max` budget. */
+export declare const ANTHROPIC_MAX_EFFORT_OUTPUT_ROOM = 1024;
+/**
+ * budget_tokens for effort `max` on a non-adaptive family: ANTHROPIC_MAX_EFFORT_BUDGET clamped to
+ * max_tokens - ANTHROPIC_MAX_EFFORT_OUTPUT_ROOM (the API requires budget_tokens < max_tokens and >= 1024).
+ * Returns undefined when max_tokens is too small to honour the floor — the caller keeps its legacy value.
+ */
+export declare function anthropicMaxEffortBudget(maxTokens: number | undefined): number | undefined;
+/** Gemini 3.x takes `thinkingLevel`; 2.5 and older take `thinkingBudget` (sending both is a 400). */
+export declare function isGeminiThinkingLevelModel(modelId: string): boolean;
+/** thinkingBudget per effort for Gemini 2.5 (Flash range 0-24576; Pro 128-32768 — every value here is valid on both). */
+export declare const GEMINI_BUDGET_BY_EFFORT: Record<string, number>;
+/** thinkingLevel per effort for Gemini 3.x (levels low|medium|high; xhigh/max clamp to high). */
+export declare const GEMINI_LEVEL_BY_EFFORT: Record<string, string>;
+/**
+ * The generationConfig.thinkingConfig for an effort, or undefined (none / unknown effort → send nothing, API default).
+ */
+export declare function geminiThinkingConfigForEffort(modelId: string, reasoningEffort: string | undefined): {
+    thinkingLevel: string;
+} | {
+    thinkingBudget: number;
+} | undefined;
+/**
+ * CORTEX_ACTION_EFFORT is filled into the request params AFTER the first request of each user turn is built
+ * (CortexOrchestrator initialPrepOpts vs the `??=` in the loop setup), so request 0 ran at the card default and
+ * requests 1+ at the action effort. On DeepSeek that is harmless (card 'medium' is coerced to 'high' server-side and
+ * the anchor-lift bust lands on the same boundary); on other providers it sends a different effort on request 0 and
+ * costs one extra cache break per user turn. DARK: CORTEX_ACTION_EFFORT_FIRST=on → request 0 gets the action effort
+ * when no ramp / request param set one. Off → undefined (byte-identical).
+ */
+export declare function firstRequestActionEffort(env?: NodeJS.ProcessEnv): string | undefined;
+//# sourceMappingURL=transportEffortFixes.d.ts.map

package/dist/orchestrator/transportEffortFixes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transportEffortFixes.d.ts","sourceRoot":"","sources":["../../src/orchestrator/transportEffortFixes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AACD,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AACD,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG7F;AAED,uGAAuG;AACvG,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAClD,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK1F;AAMD,qGAAqG;AACrG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,yHAAyH;AACzH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM1D,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMzD,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQpE;AAMD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAIjG"}