@j0hanz/fetch-url-mcp 1.11.5 → 1.11.6

package/dist/http/health.js

@@ -1,7 +1,7 @@
 import { freemem, hostname, totalmem } from 'node:os';
 import { monitorEventLoopDelay, performance } from 'node:perf_hooks';
 import process from 'node:process';
-import { keys as cacheKeys } from '../lib/core.js';
+import { keys as cacheKeys } from '../lib/cache.js';
 import { config, serverVersion } from '../lib/core.js';
 import { getTransformPoolStats } from '../transform/transform.js';
 import { sendJson } from './helpers.js';

package/dist/http/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/http/native.ts"],"names":[],"mappings":"AAooCA,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CA0DD"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/http/native.ts"],"names":[],"mappings":"AAmoCA,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CA0DD"}

package/dist/http/native.js

@@ -7,14 +7,10 @@ import { hostname } from 'node:os';
 import process from 'node:process';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
-import { config, enableHttpMode } from '../lib/core.js';
-import { logError, logInfo, registerMcpSessionServer, runWithRequestContext, } from '../lib/core.js';
-import { composeCloseHandlers, createSessionStore, createSlotTracker, ensureSessionCapacity, reserveSessionSlot, startSessionCleanupLoop, } from '../lib/core.js';
+import { composeCloseHandlers, config, createSessionStore, createSlotTracker, enableHttpMode, ensureSessionCapacity, logError, logInfo, registerMcpSessionServer, reserveSessionSlot, runWithRequestContext, startSessionCleanupLoop, } from '../lib/core.js';
 import { handleDownload } from '../lib/http.js';
 import { acceptsEventStream, acceptsJsonAndEventStream, isJsonRpcBatchRequest, isMcpMessageBody, isMcpRequestBody, } from '../lib/mcp-interop.js';
-import { toError } from '../lib/utils.js';
-import { applyHttpServerTuning, drainConnectionsOnShutdown, } from '../lib/utils.js';
-import { isObject } from '../lib/utils.js';
+import { applyHttpServerTuning, drainConnectionsOnShutdown, isObject, toError, } from '../lib/utils.js';
 import { createMcpServerForHttpSession } from '../server.js';
 import { applyInsufficientScopeAuthHeaders, applyUnauthorizedAuthHeaders, assertHttpModeConfiguration, authService, buildAuthFingerprint, buildProtectedResourceMetadataDocument, corsPolicy, DEFAULT_MCP_PROTOCOL_VERSION, ensureMcpProtocolVersion, hostOriginPolicy, isInsufficientScopeError, isOAuthMetadataEnabled, isProtectedResourceMetadataPath, SUPPORTED_MCP_PROTOCOL_VERSIONS, } from './auth.js';
 import { disableEventLoopMonitoring, isVerboseHealthRequest, resetEventLoopMonitoring, sendHealthRouteResponse, shouldHandleHealthRoute, } from './health.js';

package/dist/lib/cache.d.ts

@@ -0,0 +1,48 @@
+export declare function toCacheScopeId(sessionId?: string): string;
+interface CacheEntry {
+    url: string;
+    title?: string;
+    content: string;
+    fetchedAt: string;
+    expiresAt: string;
+    scopeIds?: string[];
+}
+interface CacheKeyParts {
+    namespace: string;
+    urlHash: string;
+}
+interface CacheSetOptions {
+    force?: boolean;
+}
+interface CacheGetOptions {
+    force?: boolean;
+    scopeId?: string;
+}
+interface CacheEntryMetadata {
+    url: string;
+    title?: string;
+    scopeIds?: string[];
+}
+interface CacheUpdateEvent {
+    cacheKey: string;
+    namespace: string;
+    urlHash: string;
+    listChanged: boolean;
+    scopeIds: string[];
+}
+type CacheUpdateListener = (event: CacheUpdateEvent) => unknown;
+export declare function createCacheKey(namespace: string, url: string, vary?: Record<string, unknown> | string): string | null;
+export declare function parseCacheKey(cacheKey: string): CacheKeyParts | null;
+export declare function onCacheUpdate(listener: CacheUpdateListener): () => void;
+export declare function get(cacheKey: string | null, options?: CacheGetOptions): CacheEntry | undefined;
+export declare function set(cacheKey: string | null, content: string, metadata: CacheEntryMetadata, options?: CacheSetOptions): void;
+export declare function keys(): readonly string[];
+export declare function getEntryMeta(cacheKey: string): {
+    url: string;
+    title?: string;
+    fetchedAt?: string;
+    scopeIds: string[];
+} | undefined;
+export declare function isEnabled(): boolean;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/lib/cache.ts"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD;AAYD,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AACD,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AACD,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAID,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAEhE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GACtC,MAAM,GAAG,IAAI,CAyBf;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CASpE;AA0OD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAEvE;AACD,wBAAgB,GAAG,CACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,UAAU,GAAG,SAAS,CAExB;AACD,wBAAgB,GAAG,CACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CAEN;AACD,wBAAgB,IAAI,IAAI,SAAS,MAAM,EAAE,CAExC;AACD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,GAEd;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACvE,SAAS,CASZ;AACD,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/lib/cache.js

@@ -0,0 +1,273 @@
+import { EventEmitter } from 'node:events';
+import { config } from './config.js';
+import { logWarn } from './core.js';
+import { getErrorMessage, sha256Hex, stableStringify as stableJsonStringify, } from './utils.js';
+const PRIMARY_HASH_LENGTH = 32;
+const VARY_HASH_LENGTH = 16;
+const STDIO_CACHE_SCOPE_ID = 'stdio';
+export function toCacheScopeId(sessionId) {
+    return sessionId ? `session:${sessionId}` : STDIO_CACHE_SCOPE_ID;
+}
+function normalizeScopeIds(scopeIds) {
+    const normalized = (scopeIds ?? [STDIO_CACHE_SCOPE_ID]).filter((value) => typeof value === 'string' && value.length > 0);
+    return normalized.length > 0
+        ? [...new Set(normalized)]
+        : [STDIO_CACHE_SCOPE_ID];
+}
+export function createCacheKey(namespace, url, vary) {
+    if (!namespace || !url)
+        return null;
+    const urlHash = sha256Hex(url).substring(0, PRIMARY_HASH_LENGTH);
+    if (!vary)
+        return `${namespace}:${urlHash}`;
+    const varyString = typeof vary === 'string'
+        ? vary
+        : (() => {
+            try {
+                return stableJsonStringify(vary);
+            }
+            catch {
+                return null;
+            }
+        })();
+    if (varyString === null)
+        return null;
+    const varyHash = varyString
+        ? sha256Hex(varyString).substring(0, VARY_HASH_LENGTH)
+        : undefined;
+    return varyHash
+        ? `${namespace}:${urlHash}.${varyHash}`
+        : `${namespace}:${urlHash}`;
+}
+export function parseCacheKey(cacheKey) {
+    if (!cacheKey)
+        return null;
+    const separatorIndex = cacheKey.indexOf(':');
+    if (separatorIndex === -1)
+        return null;
+    const namespace = cacheKey.slice(0, separatorIndex);
+    const urlHash = cacheKey.slice(separatorIndex + 1);
+    if (!namespace || !urlHash)
+        return null;
+    return { namespace, urlHash };
+}
+class InMemoryCacheStore {
+    max = config.cache.maxKeys;
+    maxBytes = config.cache.maxSizeBytes;
+    ttlMs = config.cache.ttl * 1000;
+    entries = new Map();
+    updateEmitter = new EventEmitter();
+    currentBytes = 0;
+    isEnabled() {
+        return config.cache.enabled;
+    }
+    isExpired(entry, now = Date.now()) {
+        return entry.expiresAtMs <= now;
+    }
+    keys() {
+        if (!this.isEnabled())
+            return [];
+        const now = Date.now();
+        const result = [];
+        for (const [key, entry] of this.entries) {
+            if (!this.isExpired(entry, now))
+                result.push(key);
+        }
+        return result;
+    }
+    onUpdate(listener) {
+        const wrapped = (event) => {
+            try {
+                const result = listener(event);
+                if (result instanceof Promise) {
+                    void result.catch((error) => {
+                        this.logError('Cache update listener failed (async)', event.cacheKey, error);
+                    });
+                }
+            }
+            catch (error) {
+                this.logError('Cache update listener failed', event.cacheKey, error);
+            }
+        };
+        this.updateEmitter.on('update', wrapped);
+        return () => {
+            this.updateEmitter.off('update', wrapped);
+        };
+    }
+    get(cacheKey, options) {
+        if (!cacheKey || (!this.isEnabled() && !options?.force))
+            return undefined;
+        const entry = this.entries.get(cacheKey);
+        if (!entry)
+            return undefined;
+        const now = Date.now();
+        if (this.isExpired(entry, now)) {
+            const removed = this.delete(cacheKey);
+            // listChanged=false: lazy eviction on read is silent — only writes change
+            // the list. Clients must not rely on list-changed events from reads.
+            this.notify(cacheKey, false, removed?.scopeIds);
+            return undefined;
+        }
+        const scopeId = options?.scopeId;
+        if (scopeId && !normalizeScopeIds(entry.scopeIds).includes(scopeId)) {
+            entry.scopeIds = normalizeScopeIds([
+                ...normalizeScopeIds(entry.scopeIds),
+                scopeId,
+            ]);
+            this.notify(cacheKey, true, [scopeId]);
+        }
+        // Refresh LRU position
+        this.entries.delete(cacheKey);
+        this.entries.set(cacheKey, entry);
+        return entry;
+    }
+    delete(cacheKey) {
+        const entry = this.entries.get(cacheKey);
+        if (entry) {
+            this.currentBytes -= entry.content.length;
+            this.entries.delete(cacheKey);
+            return entry;
+        }
+        return undefined;
+    }
+    evictOldestEntry() {
+        const firstKey = this.entries.keys().next();
+        return !firstKey.done ? this.delete(firstKey.value) : undefined;
+    }
+    ensureCapacity(cacheKey, entrySize) {
+        if (entrySize > this.maxBytes) {
+            logWarn('Cache entry exceeds max size', {
+                key: cacheKey,
+                size: entrySize,
+                max: this.maxBytes,
+            });
+            return { ok: false, listChanged: false, scopeIds: [] };
+        }
+        let listChanged = false;
+        const scopeIds = new Set();
+        while (this.currentBytes + entrySize > this.maxBytes) {
+            const evicted = this.evictOldestEntry();
+            if (evicted) {
+                listChanged = true;
+                for (const scopeId of normalizeScopeIds(evicted.scopeIds)) {
+                    scopeIds.add(scopeId);
+                }
+            }
+            else {
+                break;
+            }
+        }
+        return { ok: true, listChanged, scopeIds: [...scopeIds] };
+    }
+    set(cacheKey, content, metadata, options) {
+        if (!cacheKey || !content)
+            return;
+        if (!this.isEnabled() && !options?.force)
+            return;
+        const now = Date.now();
+        const expiresAtMs = now + this.ttlMs;
+        const entrySize = content.length;
+        // Reject oversized entries before deleting the old one to avoid data loss
+        if (entrySize > this.maxBytes) {
+            logWarn('Cache entry exceeds max size', {
+                key: cacheKey,
+                size: entrySize,
+                max: this.maxBytes,
+            });
+            return;
+        }
+        const existingEntry = this.entries.get(cacheKey);
+        const isUpdate = existingEntry !== undefined;
+        const existingScopeIds = normalizeScopeIds(existingEntry?.scopeIds);
+        if (isUpdate) {
+            this.delete(cacheKey);
+        }
+        const capacity = this.ensureCapacity(cacheKey, entrySize);
+        if (!capacity.ok)
+            return;
+        let listChanged = !isUpdate || capacity.listChanged;
+        const nextScopeIds = normalizeScopeIds([
+            ...existingScopeIds,
+            ...normalizeScopeIds(metadata.scopeIds),
+        ]);
+        const entry = {
+            url: metadata.url,
+            content,
+            fetchedAt: new Date(now).toISOString(),
+            expiresAt: new Date(expiresAtMs).toISOString(),
+            expiresAtMs,
+            scopeIds: nextScopeIds,
+            ...(metadata.title ? { title: metadata.title } : {}),
+        };
+        this.entries.set(cacheKey, entry);
+        this.currentBytes += entrySize;
+        // Eviction (LRU: first insertion-order key) - Count based
+        if (this.entries.size > this.max && this.evictOldestEntry()) {
+            listChanged = true;
+        }
+        this.notify(cacheKey, listChanged, [
+            ...new Set([...capacity.scopeIds, ...nextScopeIds]),
+        ]);
+    }
+    notify(cacheKey, listChanged, scopeIds) {
+        if (this.updateEmitter.listenerCount('update') === 0)
+            return;
+        const parts = parseCacheKey(cacheKey);
+        if (!parts)
+            return;
+        this.updateEmitter.emit('update', {
+            cacheKey,
+            ...parts,
+            listChanged,
+            scopeIds: normalizeScopeIds(scopeIds),
+        });
+    }
+    /**
+     * Read an entry without updating its LRU position.
+     * Use this for metadata access (e.g. resource listing) to avoid polluting the
+     * eviction order; expired entries are treated as absent but not evicted here.
+     */
+    peek(cacheKey) {
+        if (!cacheKey)
+            return undefined;
+        const entry = this.entries.get(cacheKey);
+        if (!entry)
+            return undefined;
+        if (this.isExpired(entry))
+            return undefined;
+        return entry;
+    }
+    logError(message, cacheKey, error) {
+        logWarn(message, {
+            key: cacheKey.length > 100 ? cacheKey.slice(0, 100) : cacheKey,
+            error: getErrorMessage(error),
+        });
+    }
+}
+const store = new InMemoryCacheStore();
+export function onCacheUpdate(listener) {
+    return store.onUpdate(listener);
+}
+export function get(cacheKey, options) {
+    return store.get(cacheKey, options);
+}
+export function set(cacheKey, content, metadata, options) {
+    store.set(cacheKey, content, metadata, options);
+}
+export function keys() {
+    return store.keys();
+}
+export function getEntryMeta(cacheKey) {
+    const entry = store.peek(cacheKey);
+    if (!entry)
+        return undefined;
+    return {
+        url: entry.url,
+        scopeIds: normalizeScopeIds(entry.scopeIds),
+        ...(entry.title !== undefined ? { title: entry.title } : {}),
+        ...(entry.fetchedAt ? { fetchedAt: entry.fetchedAt } : {}),
+    };
+}
+export function isEnabled() {
+    return store.isEnabled();
+}

package/dist/lib/core.d.ts

@@ -2,47 +2,8 @@ import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { SessionEntry } from './session.js';
 import type { SessionStore } from './session.js';
 export { config, enableHttpMode, serverVersion } from './config.js';
+export { createCacheKey, get, getEntryMeta, isEnabled, keys, onCacheUpdate, parseCacheKey, set, } from './cache.js';
 type McpLogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
-interface CacheEntry {
-    url: string;
-    title?: string;
-    content: string;
-    fetchedAt: string;
-    expiresAt: string;
-}
-interface CacheKeyParts {
-    namespace: string;
-    urlHash: string;
-}
-interface CacheSetOptions {
-    force?: boolean;
-}
-interface CacheGetOptions {
-    force?: boolean;
-}
-interface CacheEntryMetadata {
-    url: string;
-    title?: string;
-}
-interface CacheUpdateEvent {
-    cacheKey: string;
-    namespace: string;
-    urlHash: string;
-    listChanged: boolean;
-}
-type CacheUpdateListener = (event: CacheUpdateEvent) => unknown;
-export declare function createCacheKey(namespace: string, url: string, vary?: Record<string, unknown> | string): string | null;
-export declare function parseCacheKey(cacheKey: string): CacheKeyParts | null;
-export declare function onCacheUpdate(listener: CacheUpdateListener): () => void;
-export declare function get(cacheKey: string | null, options?: CacheGetOptions): CacheEntry | undefined;
-export declare function set(cacheKey: string | null, content: string, metadata: CacheEntryMetadata, options?: CacheSetOptions): void;
-export declare function keys(): readonly string[];
-export declare function getEntryMeta(cacheKey: string): {
-    url: string;
-    title?: string;
-    fetchedAt?: string;
-} | undefined;
-export declare function isEnabled(): boolean;
 type LogMetadata = Record<string, unknown>;
 interface RequestContext {
     readonly requestId: string;

package/dist/lib/core.d.ts.map

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

package/dist/lib/core.js

@@ -1,242 +1,11 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
-import { EventEmitter } from 'node:events';
 import process from 'node:process';
 import { getSystemErrorMessage, inspect, stripVTControlCharacters, } from 'node:util';
 import {} from '@modelcontextprotocol/sdk/server/mcp.js';
 import { config } from './config.js';
-import { getErrorMessage, isAbortError, sha256Hex, stableStringify as stableJsonStringify, startAbortableIntervalLoop, } from './utils.js';
+import { getErrorMessage, isAbortError, startAbortableIntervalLoop, } from './utils.js';
 export { config, enableHttpMode, serverVersion } from './config.js';
-const PRIMARY_HASH_LENGTH = 32;
-const VARY_HASH_LENGTH = 16;
-export function createCacheKey(namespace, url, vary) {
-    if (!namespace || !url)
-        return null;
-    const urlHash = sha256Hex(url).substring(0, PRIMARY_HASH_LENGTH);
-    if (!vary)
-        return `${namespace}:${urlHash}`;
-    const varyString = typeof vary === 'string'
-        ? vary
-        : (() => {
-            try {
-                return stableJsonStringify(vary);
-            }
-            catch {
-                return null;
-            }
-        })();
-    if (varyString === null)
-        return null;
-    const varyHash = varyString
-        ? sha256Hex(varyString).substring(0, VARY_HASH_LENGTH)
-        : undefined;
-    return varyHash
-        ? `${namespace}:${urlHash}.${varyHash}`
-        : `${namespace}:${urlHash}`;
-}
-export function parseCacheKey(cacheKey) {
-    if (!cacheKey)
-        return null;
-    const separatorIndex = cacheKey.indexOf(':');
-    if (separatorIndex === -1)
-        return null;
-    const namespace = cacheKey.slice(0, separatorIndex);
-    const urlHash = cacheKey.slice(separatorIndex + 1);
-    if (!namespace || !urlHash)
-        return null;
-    return { namespace, urlHash };
-}
-class InMemoryCacheStore {
-    max = config.cache.maxKeys;
-    maxBytes = config.cache.maxSizeBytes;
-    ttlMs = config.cache.ttl * 1000;
-    entries = new Map();
-    updateEmitter = new EventEmitter();
-    currentBytes = 0;
-    isEnabled() {
-        return config.cache.enabled;
-    }
-    isExpired(entry, now = Date.now()) {
-        return entry.expiresAtMs <= now;
-    }
-    keys() {
-        if (!this.isEnabled())
-            return [];
-        const now = Date.now();
-        const result = [];
-        for (const [key, entry] of this.entries) {
-            if (!this.isExpired(entry, now))
-                result.push(key);
-        }
-        return result;
-    }
-    onUpdate(listener) {
-        const wrapped = (event) => {
-            try {
-                const result = listener(event);
-                if (result instanceof Promise) {
-                    void result.catch((error) => {
-                        this.logError('Cache update listener failed (async)', event.cacheKey, error);
-                    });
-                }
-            }
-            catch (error) {
-                this.logError('Cache update listener failed', event.cacheKey, error);
-            }
-        };
-        this.updateEmitter.on('update', wrapped);
-        return () => {
-            this.updateEmitter.off('update', wrapped);
-        };
-    }
-    get(cacheKey, options) {
-        if (!cacheKey || (!this.isEnabled() && !options?.force))
-            return undefined;
-        const entry = this.entries.get(cacheKey);
-        if (!entry)
-            return undefined;
-        const now = Date.now();
-        if (this.isExpired(entry, now)) {
-            this.delete(cacheKey);
-            // listChanged=false: lazy eviction on read is silent — only writes change
-            // the list. Clients must not rely on list-changed events from reads.
-            this.notify(cacheKey, false);
-            return undefined;
-        }
-        // Refresh LRU position
-        this.entries.delete(cacheKey);
-        this.entries.set(cacheKey, entry);
-        return entry;
-    }
-    delete(cacheKey) {
-        const entry = this.entries.get(cacheKey);
-        if (entry) {
-            this.currentBytes -= entry.content.length;
-            this.entries.delete(cacheKey);
-            return true;
-        }
-        return false;
-    }
-    evictOldestEntry() {
-        const firstKey = this.entries.keys().next();
-        return !firstKey.done && this.delete(firstKey.value);
-    }
-    ensureCapacity(cacheKey, entrySize) {
-        if (entrySize > this.maxBytes) {
-            logWarn('Cache entry exceeds max size', {
-                key: cacheKey,
-                size: entrySize,
-                max: this.maxBytes,
-            });
-            return { ok: false, listChanged: false };
-        }
-        let listChanged = false;
-        while (this.currentBytes + entrySize > this.maxBytes) {
-            if (this.evictOldestEntry()) {
-                listChanged = true;
-            }
-            else {
-                break;
-            }
-        }
-        return { ok: true, listChanged };
-    }
-    set(cacheKey, content, metadata, options) {
-        if (!cacheKey || !content)
-            return;
-        if (!this.isEnabled() && !options?.force)
-            return;
-        const now = Date.now();
-        const expiresAtMs = now + this.ttlMs;
-        const entrySize = content.length;
-        // Reject oversized entries before deleting the old one to avoid data loss
-        if (entrySize > this.maxBytes) {
-            logWarn('Cache entry exceeds max size', {
-                key: cacheKey,
-                size: entrySize,
-                max: this.maxBytes,
-            });
-            return;
-        }
-        const isUpdate = this.entries.has(cacheKey);
-        if (isUpdate) {
-            this.delete(cacheKey);
-        }
-        const capacity = this.ensureCapacity(cacheKey, entrySize);
-        if (!capacity.ok)
-            return;
-        let listChanged = !isUpdate || capacity.listChanged;
-        const entry = {
-            url: metadata.url,
-            content,
-            fetchedAt: new Date(now).toISOString(),
-            expiresAt: new Date(expiresAtMs).toISOString(),
-            expiresAtMs,
-            ...(metadata.title ? { title: metadata.title } : {}),
-        };
-        this.entries.set(cacheKey, entry);
-        this.currentBytes += entrySize;
-        // Eviction (LRU: first insertion-order key) - Count based
-        if (this.entries.size > this.max && this.evictOldestEntry()) {
-            listChanged = true;
-        }
-        this.notify(cacheKey, listChanged);
-    }
-    notify(cacheKey, listChanged) {
-        if (this.updateEmitter.listenerCount('update') === 0)
-            return;
-        const parts = parseCacheKey(cacheKey);
-        if (!parts)
-            return;
-        this.updateEmitter.emit('update', { cacheKey, ...parts, listChanged });
-    }
-    /**
-     * Read an entry without updating its LRU position.
-     * Use this for metadata access (e.g. resource listing) to avoid polluting the
-     * eviction order; expired entries are treated as absent but not evicted here.
-     */
-    peek(cacheKey) {
-        if (!cacheKey)
-            return undefined;
-        const entry = this.entries.get(cacheKey);
-        if (!entry)
-            return undefined;
-        if (this.isExpired(entry))
-            return undefined;
-        return entry;
-    }
-    logError(message, cacheKey, error) {
-        logWarn(message, {
-            key: cacheKey.length > 100 ? cacheKey.slice(0, 100) : cacheKey,
-            error: getErrorMessage(error),
-        });
-    }
-}
-const store = new InMemoryCacheStore();
-export function onCacheUpdate(listener) {
-    return store.onUpdate(listener);
-}
-export function get(cacheKey, options) {
-    return store.get(cacheKey, options);
-}
-export function set(cacheKey, content, metadata, options) {
-    store.set(cacheKey, content, metadata, options);
-}
-export function keys() {
-    return store.keys();
-}
-export function getEntryMeta(cacheKey) {
-    const entry = store.peek(cacheKey);
-    if (!entry)
-        return undefined;
-    return {
-        url: entry.url,
-        ...(entry.title !== undefined ? { title: entry.title } : {}),
-        ...(entry.fetchedAt ? { fetchedAt: entry.fetchedAt } : {}),
-    };
-}
-export function isEnabled() {
-    return store.isEnabled();
-}
+export { createCacheKey, get, getEntryMeta, isEnabled, keys, onCacheUpdate, parseCacheKey, set, } from './cache.js';
 const requestContext = new AsyncLocalStorage({
     name: 'requestContext',
 });