langgraph-ui-components 0.0.4 → 0.0.7

package/dist/index.es184.js

@@ -1,246 +1,93 @@
-import { dumpCache, loadCache } from "./index.es189.js";
-function isStale(entry, ttlSeconds) {
-  if (ttlSeconds === null) {
-    return false;
-  }
-  const ageMs = Date.now() - entry.createdAt;
-  return ageMs > ttlSeconds * 1e3;
-}
-class Cache {
-  constructor(config = {}) {
-    Object.defineProperty(this, "cache", {
-      enumerable: true,
-      configurable: true,
-      writable: true,
-      value: /* @__PURE__ */ new Map()
-    });
-    Object.defineProperty(this, "maxSize", {
+class LangSmithConflictError extends Error {
+  constructor(message) {
+    super(message);
+    Object.defineProperty(this, "status", {
       enumerable: true,
       configurable: true,
       writable: true,
       value: void 0
     });
-    Object.defineProperty(this, "ttlSeconds", {
-      enumerable: true,
-      configurable: true,
-      writable: true,
-      value: void 0
-    });
-    Object.defineProperty(this, "refreshIntervalSeconds", {
-      enumerable: true,
-      configurable: true,
-      writable: true,
-      value: void 0
-    });
-    Object.defineProperty(this, "fetchFunc", {
-      enumerable: true,
-      configurable: true,
-      writable: true,
-      value: void 0
-    });
-    Object.defineProperty(this, "refreshTimer", {
+    this.name = "LangSmithConflictError";
+    this.status = 409;
+  }
+}
+class LangSmithNotFoundError extends Error {
+  constructor(message) {
+    super(message);
+    Object.defineProperty(this, "status", {
       enumerable: true,
       configurable: true,
       writable: true,
       value: void 0
     });
-    Object.defineProperty(this, "_metrics", {
-      enumerable: true,
-      configurable: true,
-      writable: true,
-      value: {
-        hits: 0,
-        misses: 0,
-        refreshes: 0,
-        refreshErrors: 0
-      }
-    });
-    this.maxSize = config.maxSize ?? 100;
-    this.ttlSeconds = config.ttlSeconds ?? 3600;
-    this.refreshIntervalSeconds = config.refreshIntervalSeconds ?? 60;
-    this.fetchFunc = config.fetchFunc;
-    if (this.fetchFunc && this.ttlSeconds !== null) {
-      this.startRefreshLoop();
-    }
+    this.name = "LangSmithNotFoundError";
+    this.status = 404;
   }
-  /**
-   * Get cache performance metrics.
-   */
-  get metrics() {
-    return { ...this._metrics };
-  }
-  /**
-   * Get total cache requests (hits + misses).
-   */
-  get totalRequests() {
-    return this._metrics.hits + this._metrics.misses;
-  }
-  /**
-   * Get cache hit rate (0.0 to 1.0).
-   */
-  get hitRate() {
-    const total = this.totalRequests;
-    return total > 0 ? this._metrics.hits / total : 0;
-  }
-  /**
-   * Reset all metrics to zero.
-   */
-  resetMetrics() {
-    this._metrics = {
-      hits: 0,
-      misses: 0,
-      refreshes: 0,
-      refreshErrors: 0
-    };
-  }
-  /**
-   * Get a value from cache.
-   *
-   * Returns the cached value or undefined if not found.
-   * Stale entries are still returned (background refresh handles updates).
-   */
-  get(key) {
-    const entry = this.cache.get(key);
-    if (!entry) {
-      this._metrics.misses += 1;
-      return void 0;
+}
+function isLangSmithNotFoundError(error) {
+  return error != null && typeof error === "object" && "name" in error && error?.name === "LangSmithNotFoundError";
+}
+async function raiseForStatus(response, context, consumeOnSuccess) {
+  let errorBody;
+  if (response.ok) {
+    if (consumeOnSuccess) {
+      errorBody = await response.text();
     }
-    this.cache.delete(key);
-    this.cache.set(key, entry);
-    this._metrics.hits += 1;
-    return entry.value;
-  }
-  /**
-   * Set a value in the cache.
-   */
-  set(key, value) {
-    if (!this.cache.has(key) && this.cache.size >= this.maxSize) {
-      const oldestKey = this.cache.keys().next().value;
-      if (oldestKey !== void 0) {
-        this.cache.delete(oldestKey);
+    return;
+  }
+  if (response.status === 403) {
+    try {
+      const errorData = await response.json();
+      const errorCode = errorData?.error;
+      if (errorCode === "org_scoped_key_requires_workspace") {
+        errorBody = "This API key is org-scoped and requires workspace specification. Please provide 'workspaceId' parameter, or set LANGSMITH_WORKSPACE_ID environment variable.";
       }
+    } catch (e) {
+      const errorWithStatus = new Error(`${response.status} ${response.statusText}`);
+      errorWithStatus.status = response?.status;
+      throw errorWithStatus;
     }
-    const entry = {
-      value,
-      createdAt: Date.now()
-    };
-    this.cache.delete(key);
-    this.cache.set(key, entry);
-  }
-  /**
-   * Remove a specific entry from cache.
-   */
-  invalidate(key) {
-    this.cache.delete(key);
   }
-  /**
-   * Clear all cache entries.
-   */
-  clear() {
-    this.cache.clear();
-  }
-  /**
-   * Get the number of entries in the cache.
-   */
-  get size() {
-    return this.cache.size;
-  }
-  /**
-   * Stop background refresh.
-   * Should be called when the client is being cleaned up.
-   */
-  stop() {
-    if (this.refreshTimer) {
-      clearInterval(this.refreshTimer);
-      this.refreshTimer = void 0;
+  if (errorBody === void 0) {
+    try {
+      errorBody = await response.text();
+    } catch (e) {
+      errorBody = "";
     }
   }
-  /**
-   * Dump cache contents to a JSON file for offline use.
-   */
-  dump(filePath) {
-    for (const [key, entry] of this.cache.entries()) {
-      entry.value;
-    }
-    dumpCache();
+  const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Message: ${errorBody}`;
+  if (response.status === 404) {
+    throw new LangSmithNotFoundError(fullMessage);
   }
-  /**
-   * Load cache contents from a JSON file.
-   *
-   * Loaded entries get a fresh TTL starting from load time.
-   *
-   * @returns Number of entries loaded.
-   */
-  load(filePath) {
-    const entries = loadCache();
-    if (!entries) {
-      return 0;
-    }
-    let loaded = 0;
-    const now = Date.now();
-    for (const [key, value] of Object.entries(entries)) {
-      if (this.cache.size >= this.maxSize) {
-        break;
-      }
-      const entry = {
-        value,
-        createdAt: now
-        // Fresh TTL from load time
-      };
-      this.cache.set(key, entry);
-      loaded += 1;
-    }
-    return loaded;
+  if (response.status === 409) {
+    throw new LangSmithConflictError(fullMessage);
   }
-  /**
-   * Start the background refresh loop.
-   */
-  startRefreshLoop() {
-    this.refreshTimer = setInterval(() => {
-      this.refreshStaleEntries().catch((e) => {
-        console.warn("Unexpected error in cache refresh loop:", e);
-      });
-    }, this.refreshIntervalSeconds * 1e3);
-    if (this.refreshTimer.unref) {
-      this.refreshTimer.unref();
-    }
-  }
-  /**
-   * Get list of stale cache keys.
-   */
-  getStaleKeys() {
-    const staleKeys = [];
-    for (const [key, entry] of this.cache.entries()) {
-      if (isStale(entry, this.ttlSeconds)) {
-        staleKeys.push(key);
-      }
-    }
-    return staleKeys;
-  }
-  /**
-   * Check for stale entries and refresh them.
-   */
-  async refreshStaleEntries() {
-    if (!this.fetchFunc) {
-      return;
-    }
-    const staleKeys = this.getStaleKeys();
-    if (staleKeys.length === 0) {
-      return;
-    }
-    for (const key of staleKeys) {
-      try {
-        const newValue = await this.fetchFunc(key);
-        this.set(key, newValue);
-        this._metrics.refreshes += 1;
-      } catch (e) {
-        this._metrics.refreshErrors += 1;
-        console.warn(`Failed to refresh cache entry ${key}:`, e);
-      }
-    }
+  const err = new Error(fullMessage);
+  err.status = response.status;
+  throw err;
+}
+const ERR_CONFLICTING_ENDPOINTS = "ERR_CONFLICTING_ENDPOINTS";
+class ConflictingEndpointsError extends Error {
+  constructor() {
+    super("You cannot provide both LANGSMITH_ENDPOINT / LANGCHAIN_ENDPOINT and LANGSMITH_RUNS_ENDPOINTS.");
+    Object.defineProperty(this, "code", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: ERR_CONFLICTING_ENDPOINTS
+    });
+    this.name = "ConflictingEndpointsError";
   }
 }
+function isConflictingEndpointsError(err) {
+  return typeof err === "object" && err !== null && err.code === ERR_CONFLICTING_ENDPOINTS;
+}
 export {
-  Cache
+  ConflictingEndpointsError,
+  LangSmithConflictError,
+  LangSmithNotFoundError,
+  isConflictingEndpointsError,
+  isLangSmithNotFoundError,
+  raiseForStatus
 };
 //# sourceMappingURL=index.es184.js.map

package/dist/index.es184.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es184.js","sources":["../node_modules/.pnpm/langsmith@0.4.6_openai@6.16.0_zod@4.3.5_/node_modules/langsmith/dist/utils/prompts_cache.js"],"sourcesContent":["/**\n * Prompt caching module for LangSmith SDK.\n *\n * Provides an LRU cache with background refresh for prompt caching.\n * Uses stale-while-revalidate pattern for optimal performance.\n *\n * Works in all environments. File operations (dump/load) use helpers\n * that are swapped for browser builds via package.json browser field.\n */\nimport { dumpCache, loadCache } from \"./prompts_cache_fs.js\";\n/**\n * Check if a cache entry is stale based on TTL.\n */\nfunction isStale(entry, ttlSeconds) {\n    if (ttlSeconds === null) {\n        return false; // Infinite TTL, never stale\n    }\n    const ageMs = Date.now() - entry.createdAt;\n    return ageMs > ttlSeconds * 1000;\n}\n/**\n * LRU cache with background refresh for prompts.\n *\n * Features:\n * - In-memory LRU cache with configurable max size\n * - Background refresh using setInterval\n * - Stale-while-revalidate: returns stale data while refresh happens\n * - JSON dump/load for offline use\n *\n * @example\n * ```typescript\n * const cache = new Cache({\n *   maxSize: 100,\n *   ttlSeconds: 3600,\n *   fetchFunc: async (key) => client.pullPromptCommit(key),\n * });\n *\n * // Use the cache\n * cache.set(\"my-prompt:latest\", promptCommit);\n * const cached = cache.get(\"my-prompt:latest\");\n *\n * // Cleanup\n * cache.stop();\n * ```\n */\nexport class Cache {\n    constructor(config = {}) {\n        Object.defineProperty(this, \"cache\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: new Map()\n        });\n        Object.defineProperty(this, \"maxSize\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"ttlSeconds\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"refreshIntervalSeconds\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"fetchFunc\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"refreshTimer\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"_metrics\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: {\n                hits: 0,\n                misses: 0,\n                refreshes: 0,\n                refreshErrors: 0,\n            }\n        });\n        this.maxSize = config.maxSize ?? 100;\n        this.ttlSeconds = config.ttlSeconds ?? 3600;\n        this.refreshIntervalSeconds = config.refreshIntervalSeconds ?? 60;\n        this.fetchFunc = config.fetchFunc;\n        // Start background refresh if fetch function provided and TTL is set\n        if (this.fetchFunc && this.ttlSeconds !== null) {\n            this.startRefreshLoop();\n        }\n    }\n    /**\n     * Get cache performance metrics.\n     */\n    get metrics() {\n        return { ...this._metrics };\n    }\n    /**\n     * Get total cache requests (hits + misses).\n     */\n    get totalRequests() {\n        return this._metrics.hits + this._metrics.misses;\n    }\n    /**\n     * Get cache hit rate (0.0 to 1.0).\n     */\n    get hitRate() {\n        const total = this.totalRequests;\n        return total > 0 ? this._metrics.hits / total : 0;\n    }\n    /**\n     * Reset all metrics to zero.\n     */\n    resetMetrics() {\n        this._metrics = {\n            hits: 0,\n            misses: 0,\n            refreshes: 0,\n            refreshErrors: 0,\n        };\n    }\n    /**\n     * Get a value from cache.\n     *\n     * Returns the cached value or undefined if not found.\n     * Stale entries are still returned (background refresh handles updates).\n     */\n    get(key) {\n        const entry = this.cache.get(key);\n        if (!entry) {\n            this._metrics.misses += 1;\n            return undefined;\n        }\n        // Move to end for LRU (delete and re-add)\n        this.cache.delete(key);\n        this.cache.set(key, entry);\n        this._metrics.hits += 1;\n        return entry.value;\n    }\n    /**\n     * Set a value in the cache.\n     */\n    set(key, value) {\n        // Check if we need to evict (and key is new)\n        if (!this.cache.has(key) && this.cache.size >= this.maxSize) {\n            // Evict oldest (first item in Map)\n            const oldestKey = this.cache.keys().next().value;\n            if (oldestKey !== undefined) {\n                this.cache.delete(oldestKey);\n            }\n        }\n        const entry = {\n            value,\n            createdAt: Date.now(),\n        };\n        // Delete first to ensure it's at the end\n        this.cache.delete(key);\n        this.cache.set(key, entry);\n    }\n    /**\n     * Remove a specific entry from cache.\n     */\n    invalidate(key) {\n        this.cache.delete(key);\n    }\n    /**\n     * Clear all cache entries.\n     */\n    clear() {\n        this.cache.clear();\n    }\n    /**\n     * Get the number of entries in the cache.\n     */\n    get size() {\n        return this.cache.size;\n    }\n    /**\n     * Stop background refresh.\n     * Should be called when the client is being cleaned up.\n     */\n    stop() {\n        if (this.refreshTimer) {\n            clearInterval(this.refreshTimer);\n            this.refreshTimer = undefined;\n        }\n    }\n    /**\n     * Dump cache contents to a JSON file for offline use.\n     */\n    dump(filePath) {\n        const entries = {};\n        for (const [key, entry] of this.cache.entries()) {\n            entries[key] = entry.value;\n        }\n        dumpCache(filePath, entries);\n    }\n    /**\n     * Load cache contents from a JSON file.\n     *\n     * Loaded entries get a fresh TTL starting from load time.\n     *\n     * @returns Number of entries loaded.\n     */\n    load(filePath) {\n        const entries = loadCache(filePath);\n        if (!entries) {\n            return 0;\n        }\n        let loaded = 0;\n        const now = Date.now();\n        for (const [key, value] of Object.entries(entries)) {\n            if (this.cache.size >= this.maxSize) {\n                break;\n            }\n            const entry = {\n                value: value,\n                createdAt: now, // Fresh TTL from load time\n            };\n            this.cache.set(key, entry);\n            loaded += 1;\n        }\n        return loaded;\n    }\n    /**\n     * Start the background refresh loop.\n     */\n    startRefreshLoop() {\n        this.refreshTimer = setInterval(() => {\n            this.refreshStaleEntries().catch((e) => {\n                // Log but don't die - keep the refresh loop running\n                console.warn(\"Unexpected error in cache refresh loop:\", e);\n            });\n        }, this.refreshIntervalSeconds * 1000);\n        // Don't block Node.js from exiting\n        if (this.refreshTimer.unref) {\n            this.refreshTimer.unref();\n        }\n    }\n    /**\n     * Get list of stale cache keys.\n     */\n    getStaleKeys() {\n        const staleKeys = [];\n        for (const [key, entry] of this.cache.entries()) {\n            if (isStale(entry, this.ttlSeconds)) {\n                staleKeys.push(key);\n            }\n        }\n        return staleKeys;\n    }\n    /**\n     * Check for stale entries and refresh them.\n     */\n    async refreshStaleEntries() {\n        if (!this.fetchFunc) {\n            return;\n        }\n        const staleKeys = this.getStaleKeys();\n        if (staleKeys.length === 0) {\n            return;\n        }\n        for (const key of staleKeys) {\n            try {\n                const newValue = await this.fetchFunc(key);\n                this.set(key, newValue);\n                this._metrics.refreshes += 1;\n            }\n            catch (e) {\n                // Keep stale data on refresh failure\n                this._metrics.refreshErrors += 1;\n                console.warn(`Failed to refresh cache entry ${key}:`, e);\n            }\n        }\n    }\n}\n"],"names":[],"mappings":"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","x_google_ignoreList":[0]}
+{"version":3,"file":"index.es184.js","sources":["../node_modules/.pnpm/langsmith@0.4.6_openai@6.16.0_zod@4.3.5_/node_modules/langsmith/dist/utils/error.js"],"sourcesContent":["function getErrorStackTrace(e) {\n    if (typeof e !== \"object\" || e == null)\n        return undefined;\n    if (!(\"stack\" in e) || typeof e.stack !== \"string\")\n        return undefined;\n    let stack = e.stack;\n    const prevLine = `${e}`;\n    if (stack.startsWith(prevLine)) {\n        stack = stack.slice(prevLine.length);\n    }\n    if (stack.startsWith(\"\\n\")) {\n        stack = stack.slice(1);\n    }\n    return stack;\n}\nexport function printErrorStackTrace(e) {\n    const stack = getErrorStackTrace(e);\n    if (stack == null)\n        return;\n    console.error(stack);\n}\n/**\n * LangSmithConflictError\n *\n * Represents an error that occurs when there's a conflict during an operation,\n * typically corresponding to HTTP 409 status code responses.\n *\n * This error is thrown when an attempt to create or modify a resource conflicts\n * with the current state of the resource on the server. Common scenarios include:\n * - Attempting to create a resource that already exists\n * - Trying to update a resource that has been modified by another process\n * - Violating a uniqueness constraint in the data\n *\n * @extends Error\n *\n * @example\n * try {\n *   await createProject(\"existingProject\");\n * } catch (error) {\n *   if (error instanceof ConflictError) {\n *     console.log(\"A conflict occurred:\", error.message);\n *     // Handle the conflict, e.g., by suggesting a different project name\n *   } else {\n *     // Handle other types of errors\n *   }\n * }\n *\n * @property {string} name - Always set to 'ConflictError' for easy identification\n * @property {string} message - Detailed error message including server response\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409\n */\nexport class LangSmithConflictError extends Error {\n    constructor(message) {\n        super(message);\n        Object.defineProperty(this, \"status\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        this.name = \"LangSmithConflictError\";\n        this.status = 409;\n    }\n}\n/**\n * LangSmithNotFoundError\n *\n * Represents an error that occurs when a requested resource is not found,\n * typically corresponding to HTTP 404 status code responses.\n *\n * @extends Error\n */\nexport class LangSmithNotFoundError extends Error {\n    constructor(message) {\n        super(message);\n        Object.defineProperty(this, \"status\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        this.name = \"LangSmithNotFoundError\";\n        this.status = 404;\n    }\n}\nexport function isLangSmithNotFoundError(error) {\n    return (error != null &&\n        typeof error === \"object\" &&\n        \"name\" in error &&\n        error?.name === \"LangSmithNotFoundError\");\n}\n/**\n * Throws an appropriate error based on the response status and body.\n *\n * @param response - The fetch Response object\n * @param context - Additional context to include in the error message (e.g., operation being performed)\n * @throws {LangSmithConflictError} When the response status is 409\n * @throws {Error} For all other non-ok responses\n */\nexport async function raiseForStatus(response, context, consumeOnSuccess) {\n    let errorBody;\n    if (response.ok) {\n        // consume the response body to release the connection\n        // https://undici.nodejs.org/#/?id=garbage-collection\n        if (consumeOnSuccess) {\n            errorBody = await response.text();\n        }\n        return;\n    }\n    if (response.status === 403) {\n        try {\n            const errorData = await response.json();\n            const errorCode = errorData?.error;\n            if (errorCode === \"org_scoped_key_requires_workspace\") {\n                errorBody =\n                    \"This API key is org-scoped and requires workspace specification. \" +\n                        \"Please provide 'workspaceId' parameter, \" +\n                        \"or set LANGSMITH_WORKSPACE_ID environment variable.\";\n            }\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        }\n        catch (e) {\n            const errorWithStatus = new Error(`${response.status} ${response.statusText}`);\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            errorWithStatus.status = response?.status;\n            throw errorWithStatus;\n        }\n    }\n    if (errorBody === undefined) {\n        try {\n            errorBody = await response.text();\n            // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        }\n        catch (e) {\n            errorBody = \"\";\n        }\n    }\n    const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Message: ${errorBody}`;\n    if (response.status === 404) {\n        throw new LangSmithNotFoundError(fullMessage);\n    }\n    if (response.status === 409) {\n        throw new LangSmithConflictError(fullMessage);\n    }\n    const err = new Error(fullMessage);\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    err.status = response.status;\n    throw err;\n}\nconst ERR_CONFLICTING_ENDPOINTS = \"ERR_CONFLICTING_ENDPOINTS\";\nexport class ConflictingEndpointsError extends Error {\n    constructor() {\n        super(\"You cannot provide both LANGSMITH_ENDPOINT / LANGCHAIN_ENDPOINT \" +\n            \"and LANGSMITH_RUNS_ENDPOINTS.\");\n        Object.defineProperty(this, \"code\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: ERR_CONFLICTING_ENDPOINTS\n        });\n        this.name = \"ConflictingEndpointsError\"; // helpful in logs\n    }\n}\nexport function isConflictingEndpointsError(err) {\n    return (typeof err === \"object\" &&\n        err !== null &&\n        err.code === ERR_CONFLICTING_ENDPOINTS);\n}\n"],"names":[],"mappings":"AAoDO,MAAM,+BAA+B,MAAM;AAAA,EAC9C,YAAY,SAAS;AACjB,UAAM,OAAO;AACb,WAAO,eAAe,MAAM,UAAU;AAAA,MAClC,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,UAAU;AAAA,MACV,OAAO;AAAA,IACnB,CAAS;AACD,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAClB;AACJ;AASO,MAAM,+BAA+B,MAAM;AAAA,EAC9C,YAAY,SAAS;AACjB,UAAM,OAAO;AACb,WAAO,eAAe,MAAM,UAAU;AAAA,MAClC,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,UAAU;AAAA,MACV,OAAO;AAAA,IACnB,CAAS;AACD,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAClB;AACJ;AACO,SAAS,yBAAyB,OAAO;AAC5C,SAAQ,SAAS,QACb,OAAO,UAAU,YACjB,UAAU,SACV,OAAO,SAAS;AACxB;AASO,eAAe,eAAe,UAAU,SAAS,kBAAkB;AACtE,MAAI;AACJ,MAAI,SAAS,IAAI;AAGb,QAAI,kBAAkB;AAClB,kBAAY,MAAM,SAAS,KAAI;AAAA,IACnC;AACA;AAAA,EACJ;AACA,MAAI,SAAS,WAAW,KAAK;AACzB,QAAI;AACA,YAAM,YAAY,MAAM,SAAS,KAAI;AACrC,YAAM,YAAY,WAAW;AAC7B,UAAI,cAAc,qCAAqC;AACnD,oBACI;AAAA,MAGR;AAAA,IAEJ,SACO,GAAG;AACN,YAAM,kBAAkB,IAAI,MAAM,GAAG,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAE7E,sBAAgB,SAAS,UAAU;AACnC,YAAM;AAAA,IACV;AAAA,EACJ;AACA,MAAI,cAAc,QAAW;AACzB,QAAI;AACA,kBAAY,MAAM,SAAS,KAAI;AAAA,IAEnC,SACO,GAAG;AACN,kBAAY;AAAA,IAChB;AAAA,EACJ;AACA,QAAM,cAAc,aAAa,OAAO,sBAAsB,SAAS,MAAM,MAAM,SAAS,UAAU,cAAc,SAAS;AAC7H,MAAI,SAAS,WAAW,KAAK;AACzB,UAAM,IAAI,uBAAuB,WAAW;AAAA,EAChD;AACA,MAAI,SAAS,WAAW,KAAK;AACzB,UAAM,IAAI,uBAAuB,WAAW;AAAA,EAChD;AACA,QAAM,MAAM,IAAI,MAAM,WAAW;AAEjC,MAAI,SAAS,SAAS;AACtB,QAAM;AACV;AACA,MAAM,4BAA4B;AAC3B,MAAM,kCAAkC,MAAM;AAAA,EACjD,cAAc;AACV,UAAM,+FAC6B;AACnC,WAAO,eAAe,MAAM,QAAQ;AAAA,MAChC,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,UAAU;AAAA,MACV,OAAO;AAAA,IACnB,CAAS;AACD,SAAK,OAAO;AAAA,EAChB;AACJ;AACO,SAAS,4BAA4B,KAAK;AAC7C,SAAQ,OAAO,QAAQ,YACnB,QAAQ,QACR,IAAI,SAAS;AACrB;","x_google_ignoreList":[0]}

package/dist/index.es185.js

@@ -1,27 +1,246 @@
-import { getLangSmithEnvironmentVariable } from "./index.es179.js";
-const DEFAULT_FETCH_IMPLEMENTATION = (...args) => fetch(...args);
-const LANGSMITH_FETCH_IMPLEMENTATION_KEY = /* @__PURE__ */ Symbol.for("ls:fetch_implementation");
-const _globalFetchImplementationIsNodeFetch = () => {
-  const fetchImpl = globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY];
-  if (!fetchImpl)
+import { dumpCache, loadCache } from "./index.es190.js";
+function isStale(entry, ttlSeconds) {
+  if (ttlSeconds === null) {
     return false;
-  return typeof fetchImpl === "function" && "Headers" in fetchImpl && "Request" in fetchImpl && "Response" in fetchImpl;
-};
-const _getFetchImplementation = (debug) => {
-  return async (...args) => {
-    if (debug || getLangSmithEnvironmentVariable("DEBUG") === "true") {
-      const [url, options] = args;
-      console.log(`→ ${options?.method || "GET"} ${url}`);
-    }
-    const res = await (globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ?? DEFAULT_FETCH_IMPLEMENTATION)(...args);
-    if (debug || getLangSmithEnvironmentVariable("DEBUG") === "true") {
-      console.log(`← ${res.status} ${res.statusText} ${res.url}`);
-    }
-    return res;
-  };
-};
+  }
+  const ageMs = Date.now() - entry.createdAt;
+  return ageMs > ttlSeconds * 1e3;
+}
+class Cache {
+  constructor(config = {}) {
+    Object.defineProperty(this, "cache", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: /* @__PURE__ */ new Map()
+    });
+    Object.defineProperty(this, "maxSize", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "ttlSeconds", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "refreshIntervalSeconds", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "fetchFunc", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "refreshTimer", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, "_metrics", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: {
+        hits: 0,
+        misses: 0,
+        refreshes: 0,
+        refreshErrors: 0
+      }
+    });
+    this.maxSize = config.maxSize ?? 100;
+    this.ttlSeconds = config.ttlSeconds ?? 3600;
+    this.refreshIntervalSeconds = config.refreshIntervalSeconds ?? 60;
+    this.fetchFunc = config.fetchFunc;
+    if (this.fetchFunc && this.ttlSeconds !== null) {
+      this.startRefreshLoop();
+    }
+  }
+  /**
+   * Get cache performance metrics.
+   */
+  get metrics() {
+    return { ...this._metrics };
+  }
+  /**
+   * Get total cache requests (hits + misses).
+   */
+  get totalRequests() {
+    return this._metrics.hits + this._metrics.misses;
+  }
+  /**
+   * Get cache hit rate (0.0 to 1.0).
+   */
+  get hitRate() {
+    const total = this.totalRequests;
+    return total > 0 ? this._metrics.hits / total : 0;
+  }
+  /**
+   * Reset all metrics to zero.
+   */
+  resetMetrics() {
+    this._metrics = {
+      hits: 0,
+      misses: 0,
+      refreshes: 0,
+      refreshErrors: 0
+    };
+  }
+  /**
+   * Get a value from cache.
+   *
+   * Returns the cached value or undefined if not found.
+   * Stale entries are still returned (background refresh handles updates).
+   */
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      this._metrics.misses += 1;
+      return void 0;
+    }
+    this.cache.delete(key);
+    this.cache.set(key, entry);
+    this._metrics.hits += 1;
+    return entry.value;
+  }
+  /**
+   * Set a value in the cache.
+   */
+  set(key, value) {
+    if (!this.cache.has(key) && this.cache.size >= this.maxSize) {
+      const oldestKey = this.cache.keys().next().value;
+      if (oldestKey !== void 0) {
+        this.cache.delete(oldestKey);
+      }
+    }
+    const entry = {
+      value,
+      createdAt: Date.now()
+    };
+    this.cache.delete(key);
+    this.cache.set(key, entry);
+  }
+  /**
+   * Remove a specific entry from cache.
+   */
+  invalidate(key) {
+    this.cache.delete(key);
+  }
+  /**
+   * Clear all cache entries.
+   */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Get the number of entries in the cache.
+   */
+  get size() {
+    return this.cache.size;
+  }
+  /**
+   * Stop background refresh.
+   * Should be called when the client is being cleaned up.
+   */
+  stop() {
+    if (this.refreshTimer) {
+      clearInterval(this.refreshTimer);
+      this.refreshTimer = void 0;
+    }
+  }
+  /**
+   * Dump cache contents to a JSON file for offline use.
+   */
+  dump(filePath) {
+    for (const [key, entry] of this.cache.entries()) {
+      entry.value;
+    }
+    dumpCache();
+  }
+  /**
+   * Load cache contents from a JSON file.
+   *
+   * Loaded entries get a fresh TTL starting from load time.
+   *
+   * @returns Number of entries loaded.
+   */
+  load(filePath) {
+    const entries = loadCache();
+    if (!entries) {
+      return 0;
+    }
+    let loaded = 0;
+    const now = Date.now();
+    for (const [key, value] of Object.entries(entries)) {
+      if (this.cache.size >= this.maxSize) {
+        break;
+      }
+      const entry = {
+        value,
+        createdAt: now
+        // Fresh TTL from load time
+      };
+      this.cache.set(key, entry);
+      loaded += 1;
+    }
+    return loaded;
+  }
+  /**
+   * Start the background refresh loop.
+   */
+  startRefreshLoop() {
+    this.refreshTimer = setInterval(() => {
+      this.refreshStaleEntries().catch((e) => {
+        console.warn("Unexpected error in cache refresh loop:", e);
+      });
+    }, this.refreshIntervalSeconds * 1e3);
+    if (this.refreshTimer.unref) {
+      this.refreshTimer.unref();
+    }
+  }
+  /**
+   * Get list of stale cache keys.
+   */
+  getStaleKeys() {
+    const staleKeys = [];
+    for (const [key, entry] of this.cache.entries()) {
+      if (isStale(entry, this.ttlSeconds)) {
+        staleKeys.push(key);
+      }
+    }
+    return staleKeys;
+  }
+  /**
+   * Check for stale entries and refresh them.
+   */
+  async refreshStaleEntries() {
+    if (!this.fetchFunc) {
+      return;
+    }
+    const staleKeys = this.getStaleKeys();
+    if (staleKeys.length === 0) {
+      return;
+    }
+    for (const key of staleKeys) {
+      try {
+        const newValue = await this.fetchFunc(key);
+        this.set(key, newValue);
+        this._metrics.refreshes += 1;
+      } catch (e) {
+        this._metrics.refreshErrors += 1;
+        console.warn(`Failed to refresh cache entry ${key}:`, e);
+      }
+    }
+  }
+}
 export {
-  _getFetchImplementation,
-  _globalFetchImplementationIsNodeFetch
+  Cache
 };
 //# sourceMappingURL=index.es185.js.map

package/dist/index.es185.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es185.js","sources":["../node_modules/.pnpm/langsmith@0.4.6_openai@6.16.0_zod@4.3.5_/node_modules/langsmith/dist/singletons/fetch.js"],"sourcesContent":["import { getLangSmithEnvironmentVariable } from \"../utils/env.js\";\n// Wrap the default fetch call due to issues with illegal invocations\n// in some environments:\n// https://stackoverflow.com/questions/69876859/why-does-bind-fix-failed-to-execute-fetch-on-window-illegal-invocation-err\n// @ts-expect-error Broad typing to support a range of fetch implementations\nconst DEFAULT_FETCH_IMPLEMENTATION = (...args) => fetch(...args);\nconst LANGSMITH_FETCH_IMPLEMENTATION_KEY = Symbol.for(\"ls:fetch_implementation\");\n/**\n * Overrides the fetch implementation used for LangSmith calls.\n * You should use this if you need to use an implementation of fetch\n * other than the default global (e.g. for dealing with proxies).\n * @param fetch The new fetch functino to use.\n */\nexport const overrideFetchImplementation = (fetch) => {\n    globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] = fetch;\n};\nexport const clearFetchImplementation = () => {\n    delete globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY];\n};\nexport const _globalFetchImplementationIsNodeFetch = () => {\n    const fetchImpl = globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY];\n    if (!fetchImpl)\n        return false;\n    // Check if the implementation has node-fetch specific properties\n    return (typeof fetchImpl === \"function\" &&\n        \"Headers\" in fetchImpl &&\n        \"Request\" in fetchImpl &&\n        \"Response\" in fetchImpl);\n};\n/**\n * @internal\n */\nexport const _getFetchImplementation = (debug) => {\n    return async (...args) => {\n        if (debug || getLangSmithEnvironmentVariable(\"DEBUG\") === \"true\") {\n            const [url, options] = args;\n            console.log(`→ ${options?.method || \"GET\"} ${url}`);\n        }\n        const res = await (globalThis[LANGSMITH_FETCH_IMPLEMENTATION_KEY] ??\n            DEFAULT_FETCH_IMPLEMENTATION)(...args);\n        if (debug || getLangSmithEnvironmentVariable(\"DEBUG\") === \"true\") {\n            console.log(`← ${res.status} ${res.statusText} ${res.url}`);\n        }\n        return res;\n    };\n};\n"],"names":[],"mappings":";AAKA,MAAM,+BAA+B,IAAI,SAAS,MAAM,GAAG,IAAI;AAC/D,MAAM,qCAAqC,uBAAO,IAAI,yBAAyB;AAanE,MAAC,wCAAwC,MAAM;AACvD,QAAM,YAAY,WAAW,kCAAkC;AAC/D,MAAI,CAAC;AACD,WAAO;AAEX,SAAQ,OAAO,cAAc,cACzB,aAAa,aACb,aAAa,aACb,cAAc;AACtB;AAIY,MAAC,0BAA0B,CAAC,UAAU;AAC9C,SAAO,UAAU,SAAS;AACtB,QAAI,SAAS,gCAAgC,OAAO,MAAM,QAAQ;AAC9D,YAAM,CAAC,KAAK,OAAO,IAAI;AACvB,cAAQ,IAAI,KAAK,SAAS,UAAU,KAAK,IAAI,GAAG,EAAE;AAAA,IACtD;AACA,UAAM,MAAM,OAAO,WAAW,kCAAkC,KAC5D,8BAA8B,GAAG,IAAI;AACzC,QAAI,SAAS,gCAAgC,OAAO,MAAM,QAAQ;AAC9D,cAAQ,IAAI,KAAK,IAAI,MAAM,IAAI,IAAI,UAAU,IAAI,IAAI,GAAG,EAAE;AAAA,IAC9D;AACA,WAAO;AAAA,EACX;AACJ;","x_google_ignoreList":[0]}
+{"version":3,"file":"index.es185.js","sources":["../node_modules/.pnpm/langsmith@0.4.6_openai@6.16.0_zod@4.3.5_/node_modules/langsmith/dist/utils/prompts_cache.js"],"sourcesContent":["/**\n * Prompt caching module for LangSmith SDK.\n *\n * Provides an LRU cache with background refresh for prompt caching.\n * Uses stale-while-revalidate pattern for optimal performance.\n *\n * Works in all environments. File operations (dump/load) use helpers\n * that are swapped for browser builds via package.json browser field.\n */\nimport { dumpCache, loadCache } from \"./prompts_cache_fs.js\";\n/**\n * Check if a cache entry is stale based on TTL.\n */\nfunction isStale(entry, ttlSeconds) {\n    if (ttlSeconds === null) {\n        return false; // Infinite TTL, never stale\n    }\n    const ageMs = Date.now() - entry.createdAt;\n    return ageMs > ttlSeconds * 1000;\n}\n/**\n * LRU cache with background refresh for prompts.\n *\n * Features:\n * - In-memory LRU cache with configurable max size\n * - Background refresh using setInterval\n * - Stale-while-revalidate: returns stale data while refresh happens\n * - JSON dump/load for offline use\n *\n * @example\n * ```typescript\n * const cache = new Cache({\n *   maxSize: 100,\n *   ttlSeconds: 3600,\n *   fetchFunc: async (key) => client.pullPromptCommit(key),\n * });\n *\n * // Use the cache\n * cache.set(\"my-prompt:latest\", promptCommit);\n * const cached = cache.get(\"my-prompt:latest\");\n *\n * // Cleanup\n * cache.stop();\n * ```\n */\nexport class Cache {\n    constructor(config = {}) {\n        Object.defineProperty(this, \"cache\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: new Map()\n        });\n        Object.defineProperty(this, \"maxSize\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"ttlSeconds\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"refreshIntervalSeconds\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"fetchFunc\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"refreshTimer\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: void 0\n        });\n        Object.defineProperty(this, \"_metrics\", {\n            enumerable: true,\n            configurable: true,\n            writable: true,\n            value: {\n                hits: 0,\n                misses: 0,\n                refreshes: 0,\n                refreshErrors: 0,\n            }\n        });\n        this.maxSize = config.maxSize ?? 100;\n        this.ttlSeconds = config.ttlSeconds ?? 3600;\n        this.refreshIntervalSeconds = config.refreshIntervalSeconds ?? 60;\n        this.fetchFunc = config.fetchFunc;\n        // Start background refresh if fetch function provided and TTL is set\n        if (this.fetchFunc && this.ttlSeconds !== null) {\n            this.startRefreshLoop();\n        }\n    }\n    /**\n     * Get cache performance metrics.\n     */\n    get metrics() {\n        return { ...this._metrics };\n    }\n    /**\n     * Get total cache requests (hits + misses).\n     */\n    get totalRequests() {\n        return this._metrics.hits + this._metrics.misses;\n    }\n    /**\n     * Get cache hit rate (0.0 to 1.0).\n     */\n    get hitRate() {\n        const total = this.totalRequests;\n        return total > 0 ? this._metrics.hits / total : 0;\n    }\n    /**\n     * Reset all metrics to zero.\n     */\n    resetMetrics() {\n        this._metrics = {\n            hits: 0,\n            misses: 0,\n            refreshes: 0,\n            refreshErrors: 0,\n        };\n    }\n    /**\n     * Get a value from cache.\n     *\n     * Returns the cached value or undefined if not found.\n     * Stale entries are still returned (background refresh handles updates).\n     */\n    get(key) {\n        const entry = this.cache.get(key);\n        if (!entry) {\n            this._metrics.misses += 1;\n            return undefined;\n        }\n        // Move to end for LRU (delete and re-add)\n        this.cache.delete(key);\n        this.cache.set(key, entry);\n        this._metrics.hits += 1;\n        return entry.value;\n    }\n    /**\n     * Set a value in the cache.\n     */\n    set(key, value) {\n        // Check if we need to evict (and key is new)\n        if (!this.cache.has(key) && this.cache.size >= this.maxSize) {\n            // Evict oldest (first item in Map)\n            const oldestKey = this.cache.keys().next().value;\n            if (oldestKey !== undefined) {\n                this.cache.delete(oldestKey);\n            }\n        }\n        const entry = {\n            value,\n            createdAt: Date.now(),\n        };\n        // Delete first to ensure it's at the end\n        this.cache.delete(key);\n        this.cache.set(key, entry);\n    }\n    /**\n     * Remove a specific entry from cache.\n     */\n    invalidate(key) {\n        this.cache.delete(key);\n    }\n    /**\n     * Clear all cache entries.\n     */\n    clear() {\n        this.cache.clear();\n    }\n    /**\n     * Get the number of entries in the cache.\n     */\n    get size() {\n        return this.cache.size;\n    }\n    /**\n     * Stop background refresh.\n     * Should be called when the client is being cleaned up.\n     */\n    stop() {\n        if (this.refreshTimer) {\n            clearInterval(this.refreshTimer);\n            this.refreshTimer = undefined;\n        }\n    }\n    /**\n     * Dump cache contents to a JSON file for offline use.\n     */\n    dump(filePath) {\n        const entries = {};\n        for (const [key, entry] of this.cache.entries()) {\n            entries[key] = entry.value;\n        }\n        dumpCache(filePath, entries);\n    }\n    /**\n     * Load cache contents from a JSON file.\n     *\n     * Loaded entries get a fresh TTL starting from load time.\n     *\n     * @returns Number of entries loaded.\n     */\n    load(filePath) {\n        const entries = loadCache(filePath);\n        if (!entries) {\n            return 0;\n        }\n        let loaded = 0;\n        const now = Date.now();\n        for (const [key, value] of Object.entries(entries)) {\n            if (this.cache.size >= this.maxSize) {\n                break;\n            }\n            const entry = {\n                value: value,\n                createdAt: now, // Fresh TTL from load time\n            };\n            this.cache.set(key, entry);\n            loaded += 1;\n        }\n        return loaded;\n    }\n    /**\n     * Start the background refresh loop.\n     */\n    startRefreshLoop() {\n        this.refreshTimer = setInterval(() => {\n            this.refreshStaleEntries().catch((e) => {\n                // Log but don't die - keep the refresh loop running\n                console.warn(\"Unexpected error in cache refresh loop:\", e);\n            });\n        }, this.refreshIntervalSeconds * 1000);\n        // Don't block Node.js from exiting\n        if (this.refreshTimer.unref) {\n            this.refreshTimer.unref();\n        }\n    }\n    /**\n     * Get list of stale cache keys.\n     */\n    getStaleKeys() {\n        const staleKeys = [];\n        for (const [key, entry] of this.cache.entries()) {\n            if (isStale(entry, this.ttlSeconds)) {\n                staleKeys.push(key);\n            }\n        }\n        return staleKeys;\n    }\n    /**\n     * Check for stale entries and refresh them.\n     */\n    async refreshStaleEntries() {\n        if (!this.fetchFunc) {\n            return;\n        }\n        const staleKeys = this.getStaleKeys();\n        if (staleKeys.length === 0) {\n            return;\n        }\n        for (const key of staleKeys) {\n            try {\n                const newValue = await this.fetchFunc(key);\n                this.set(key, newValue);\n                this._metrics.refreshes += 1;\n            }\n            catch (e) {\n                // Keep stale data on refresh failure\n                this._metrics.refreshErrors += 1;\n                console.warn(`Failed to refresh cache entry ${key}:`, e);\n            }\n        }\n    }\n}\n"],"names":[],"mappings":"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","x_google_ignoreList":[0]}