langsmith 0.4.3 → 0.4.4

package/dist/client.cjs

@@ -46,7 +46,6 @@ const _uuid_js_1 = require("./utils/_uuid.cjs");
 const warn_js_1 = require("./utils/warn.cjs");
 const prompts_js_1 = require("./utils/prompts.cjs");
 const error_js_1 = require("./utils/error.cjs");
-const prompts_cache_js_1 = require("./utils/prompts_cache.cjs");
 const fetch_js_1 = require("./singletons/fetch.cjs");
 const index_js_2 = require("./utils/fast-safe-stringify/index.cjs");
 function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo) {
@@ -411,12 +410,6 @@ class Client {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "_promptCache", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         Object.defineProperty(this, "multipartStreamingDisabled", {
             enumerable: true,
             configurable: true,
@@ -488,27 +481,6 @@ class Client {
         }
         // Cache metadata env vars once during construction to avoid repeatedly scanning process.env
         this.cachedLSEnvVarsForMetadata = (0, env_js_1.getLangSmithEnvVarsMetadata)();
-        // Initialize prompt cache
-        const cacheEnabled = config.promptCacheEnabled ??
-            (0, env_js_1.getLangSmithEnvironmentVariable)("PROMPT_CACHE_ENABLED") === "true";
-        if (cacheEnabled) {
-            this._promptCache = new prompts_cache_js_1.PromptCache({
-                maxSize: config.promptCacheMaxSize ??
-                    parseInt((0, env_js_1.getLangSmithEnvironmentVariable)("PROMPT_CACHE_MAX_SIZE") ?? "100", 10),
-                ttlSeconds: config.promptCacheTtlSeconds ??
-                    parseFloat((0, env_js_1.getLangSmithEnvironmentVariable)("PROMPT_CACHE_TTL_SECONDS") ??
-                        "3600"),
-                refreshIntervalSeconds: config.promptCacheRefreshIntervalSeconds ??
-                    parseFloat((0, env_js_1.getLangSmithEnvironmentVariable)("PROMPT_CACHE_REFRESH_INTERVAL_SECONDS") ?? "60"),
-                fetchFunc: this._makeFetchPromptFunc(),
-            });
-            // Load from file if path provided
-            const cachePath = config.promptCachePath ??
-                (0, env_js_1.getLangSmithEnvironmentVariable)("PROMPT_CACHE_PATH");
-            if (cachePath) {
-                this._promptCache.load(cachePath);
-            }
-        }
     }
     static getDefaultClientConfig() {
         const apiKey = (0, env_js_1.getLangSmithEnvironmentVariable)("API_KEY");
@@ -3812,29 +3784,7 @@ class Client {
         });
         return response.json();
     }
-    /**
-     * Generate a cache key for a prompt.
-     * Format: "{identifier}" or "{identifier}:with_model"
-     */
-    _getPromptCacheKey(promptIdentifier, includeModel) {
-        const suffix = includeModel ? ":with_model" : "";
-        return `${promptIdentifier}${suffix}`;
-    }
-    /**
-     * Create a fetch function for the prompt cache to use for background refresh.
-     */
-    _makeFetchPromptFunc() {
-        return async (key) => {
-            // Parse the cache key back to identifier and options
-            const includeModel = key.endsWith(":with_model");
-            const identifier = includeModel ? key.slice(0, -11) : key; // Remove ":with_model"
-            return this._fetchPromptFromApi(identifier, { includeModel });
-        };
-    }
-    /**
-     * Fetch a prompt commit directly from the API (bypassing cache).
-     */
-    async _fetchPromptFromApi(promptIdentifier, options) {
+    async pullPromptCommit(promptIdentifier, options) {
         const [owner, promptName, commitHash] = (0, prompts_js_1.parsePromptIdentifier)(promptIdentifier);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/commits/${owner}/${promptName}/${commitHash}${options?.includeModel ? "?include_model=true" : ""}`, {
@@ -3855,22 +3805,6 @@ class Client {
             examples: result.examples,
         };
     }
-    async pullPromptCommit(promptIdentifier, options) {
-        // Check cache first if not skipped
-        if (!options?.skipCache && this._promptCache) {
-            const cacheKey = this._getPromptCacheKey(promptIdentifier, options?.includeModel);
-            const cached = this._promptCache.get(cacheKey);
-            if (cached) {
-                return cached;
-            }
-            // Cache miss - fetch from API and cache it
-            const result = await this._fetchPromptFromApi(promptIdentifier, options);
-            this._promptCache.set(cacheKey, result);
-            return result;
-        }
-        // No cache or skip cache - fetch directly
-        return this._fetchPromptFromApi(promptIdentifier, options);
-    }
     /**
      * This method should not be used directly, use `import { pull } from "langchain/hub"` instead.
      * Using this method directly returns the JSON string of the prompt rather than a LangChain object.
@@ -3879,7 +3813,6 @@ class Client {
     async _pullPrompt(promptIdentifier, options) {
         const promptObject = await this.pullPromptCommit(promptIdentifier, {
             includeModel: options?.includeModel,
-            skipCache: options?.skipCache,
         });
         const prompt = JSON.stringify(promptObject.manifest);
         return prompt;
@@ -3994,22 +3927,6 @@ class Client {
             throw new Error(`Invalid public ${kind} URL or token: ${urlOrToken}`);
         }
     }
-    /**
-     * Get the prompt cache instance, if caching is enabled.
-     * Useful for accessing cache metrics or manually managing the cache.
-     */
-    get promptCache() {
-        return this._promptCache;
-    }
-    /**
-     * Cleanup resources held by the client.
-     * Stops the prompt cache's background refresh timer.
-     */
-    cleanup() {
-        if (this._promptCache) {
-            this._promptCache.stop();
-        }
-    }
     /**
      * Awaits all pending trace batches. Useful for environments where
      * you need to be sure that all tracing requests finish before execution ends,

package/dist/client.d.ts

@@ -2,7 +2,6 @@ import type { OTELContext } from "./experimental/otel/types.js";
 import { AsyncCallerParams } from "./utils/async_caller.js";
 import { ComparativeExperiment, DataType, Dataset, DatasetDiffInfo, DatasetShareSchema, Example, ExampleCreate, ExampleUpdate, ExampleUpdateWithoutId, Feedback, FeedbackConfig, FeedbackIngestToken, KVMap, LangChainBaseMessage, LangSmithSettings, LikePromptResponse, Prompt, PromptCommit, PromptSortField, Run, RunCreate, RunUpdate, ScoreType, ExampleSearch, TimeDelta, TracerSession, TracerSessionResult, ValueType, AnnotationQueue, RunWithAnnotationQueueInfo, Attachments, UploadExamplesResponse, UpdateExamplesResponse, DatasetVersion, AnnotationQueueWithDetails } from "./schemas.js";
 import { EvaluationResult, EvaluationResults } from "./evaluation/evaluator.js";
-import { PromptCache } from "./utils/prompts_cache.js";
 export interface ClientConfig {
     apiUrl?: string;
     apiKey?: string;
@@ -50,29 +49,6 @@ export interface ClientConfig {
      * Custom fetch implementation. Useful for testing.
      */
     fetchImplementation?: typeof fetch;
-    /**
-     * Whether to enable prompt caching. Defaults to false.
-     */
-    promptCacheEnabled?: boolean;
-    /**
-     * Maximum number of prompts to cache. Defaults to 100.
-     */
-    promptCacheMaxSize?: number;
-    /**
-     * Time-to-live for cached prompts in seconds. After this time, cached prompts
-     * are considered stale and will be refreshed in the background.
-     * Set to null for infinite TTL (offline mode). Defaults to 3600 (1 hour).
-     */
-    promptCacheTtlSeconds?: number | null;
-    /**
-     * How often to check for stale cache entries in seconds. Defaults to 60.
-     */
-    promptCacheRefreshIntervalSeconds?: number;
-    /**
-     * Path to a JSON file to load cached prompts from on initialization.
-     * Useful for offline mode.
-     */
-    promptCachePath?: string;
 }
 /**
  * Represents the parameters for listing runs (spans) from the Langsmith server.
@@ -375,7 +351,6 @@ export declare class Client implements LangSmithTracingClientInterface {
     private langSmithToOTELTranslator?;
     private fetchImplementation?;
     private cachedLSEnvVarsForMetadata?;
-    private _promptCache?;
     private get _fetch();
     private multipartStreamingDisabled;
     private _multipartDisabled;
@@ -1020,22 +995,8 @@ export declare class Client implements LangSmithTracingClientInterface {
         isArchived?: boolean;
     }): Promise<Record<string, any>>;
     deletePrompt(promptIdentifier: string): Promise<void>;
-    /**
-     * Generate a cache key for a prompt.
-     * Format: "{identifier}" or "{identifier}:with_model"
-     */
-    private _getPromptCacheKey;
-    /**
-     * Create a fetch function for the prompt cache to use for background refresh.
-     */
-    private _makeFetchPromptFunc;
-    /**
-     * Fetch a prompt commit directly from the API (bypassing cache).
-     */
-    private _fetchPromptFromApi;
     pullPromptCommit(promptIdentifier: string, options?: {
         includeModel?: boolean;
-        skipCache?: boolean;
     }): Promise<PromptCommit>;
     /**
      * This method should not be used directly, use `import { pull } from "langchain/hub"` instead.
@@ -1044,7 +1005,6 @@ export declare class Client implements LangSmithTracingClientInterface {
      */
     _pullPrompt(promptIdentifier: string, options?: {
         includeModel?: boolean;
-        skipCache?: boolean;
     }): Promise<any>;
     pushPrompt(promptIdentifier: string, options?: {
         object?: any;
@@ -1070,16 +1030,6 @@ export declare class Client implements LangSmithTracingClientInterface {
         datasetName?: string;
     }): Promise<void>;
     private parseTokenOrUrl;
-    /**
-     * Get the prompt cache instance, if caching is enabled.
-     * Useful for accessing cache metrics or manually managing the cache.
-     */
-    get promptCache(): PromptCache | undefined;
-    /**
-     * Cleanup resources held by the client.
-     * Stops the prompt cache's background refresh timer.
-     */
-    cleanup(): void;
     /**
      * Awaits all pending trace batches. Useful for environments where
      * you need to be sure that all tracing requests finish before execution ends,

package/dist/client.js

@@ -9,7 +9,6 @@ import { assertUuid } from "./utils/_uuid.js";
 import { warnOnce } from "./utils/warn.js";
 import { parsePromptIdentifier } from "./utils/prompts.js";
 import { raiseForStatus, isLangSmithNotFoundError } from "./utils/error.js";
-import { PromptCache } from "./utils/prompts_cache.js";
 import { _globalFetchImplementationIsNodeFetch, _getFetchImplementation, } from "./singletons/fetch.js";
 import { serialize as serializePayloadForTracing } from "./utils/fast-safe-stringify/index.js";
 export function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo) {
@@ -373,12 +372,6 @@ export class Client {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "_promptCache", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         Object.defineProperty(this, "multipartStreamingDisabled", {
             enumerable: true,
             configurable: true,
@@ -450,27 +443,6 @@ export class Client {
         }
         // Cache metadata env vars once during construction to avoid repeatedly scanning process.env
         this.cachedLSEnvVarsForMetadata = getLangSmithEnvVarsMetadata();
-        // Initialize prompt cache
-        const cacheEnabled = config.promptCacheEnabled ??
-            getLangSmithEnvironmentVariable("PROMPT_CACHE_ENABLED") === "true";
-        if (cacheEnabled) {
-            this._promptCache = new PromptCache({
-                maxSize: config.promptCacheMaxSize ??
-                    parseInt(getLangSmithEnvironmentVariable("PROMPT_CACHE_MAX_SIZE") ?? "100", 10),
-                ttlSeconds: config.promptCacheTtlSeconds ??
-                    parseFloat(getLangSmithEnvironmentVariable("PROMPT_CACHE_TTL_SECONDS") ??
-                        "3600"),
-                refreshIntervalSeconds: config.promptCacheRefreshIntervalSeconds ??
-                    parseFloat(getLangSmithEnvironmentVariable("PROMPT_CACHE_REFRESH_INTERVAL_SECONDS") ?? "60"),
-                fetchFunc: this._makeFetchPromptFunc(),
-            });
-            // Load from file if path provided
-            const cachePath = config.promptCachePath ??
-                getLangSmithEnvironmentVariable("PROMPT_CACHE_PATH");
-            if (cachePath) {
-                this._promptCache.load(cachePath);
-            }
-        }
     }
     static getDefaultClientConfig() {
         const apiKey = getLangSmithEnvironmentVariable("API_KEY");
@@ -3774,29 +3746,7 @@ export class Client {
         });
         return response.json();
     }
-    /**
-     * Generate a cache key for a prompt.
-     * Format: "{identifier}" or "{identifier}:with_model"
-     */
-    _getPromptCacheKey(promptIdentifier, includeModel) {
-        const suffix = includeModel ? ":with_model" : "";
-        return `${promptIdentifier}${suffix}`;
-    }
-    /**
-     * Create a fetch function for the prompt cache to use for background refresh.
-     */
-    _makeFetchPromptFunc() {
-        return async (key) => {
-            // Parse the cache key back to identifier and options
-            const includeModel = key.endsWith(":with_model");
-            const identifier = includeModel ? key.slice(0, -11) : key; // Remove ":with_model"
-            return this._fetchPromptFromApi(identifier, { includeModel });
-        };
-    }
-    /**
-     * Fetch a prompt commit directly from the API (bypassing cache).
-     */
-    async _fetchPromptFromApi(promptIdentifier, options) {
+    async pullPromptCommit(promptIdentifier, options) {
         const [owner, promptName, commitHash] = parsePromptIdentifier(promptIdentifier);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/commits/${owner}/${promptName}/${commitHash}${options?.includeModel ? "?include_model=true" : ""}`, {
@@ -3817,22 +3767,6 @@ export class Client {
             examples: result.examples,
         };
     }
-    async pullPromptCommit(promptIdentifier, options) {
-        // Check cache first if not skipped
-        if (!options?.skipCache && this._promptCache) {
-            const cacheKey = this._getPromptCacheKey(promptIdentifier, options?.includeModel);
-            const cached = this._promptCache.get(cacheKey);
-            if (cached) {
-                return cached;
-            }
-            // Cache miss - fetch from API and cache it
-            const result = await this._fetchPromptFromApi(promptIdentifier, options);
-            this._promptCache.set(cacheKey, result);
-            return result;
-        }
-        // No cache or skip cache - fetch directly
-        return this._fetchPromptFromApi(promptIdentifier, options);
-    }
     /**
      * This method should not be used directly, use `import { pull } from "langchain/hub"` instead.
      * Using this method directly returns the JSON string of the prompt rather than a LangChain object.
@@ -3841,7 +3775,6 @@ export class Client {
     async _pullPrompt(promptIdentifier, options) {
         const promptObject = await this.pullPromptCommit(promptIdentifier, {
             includeModel: options?.includeModel,
-            skipCache: options?.skipCache,
         });
         const prompt = JSON.stringify(promptObject.manifest);
         return prompt;
@@ -3956,22 +3889,6 @@ export class Client {
             throw new Error(`Invalid public ${kind} URL or token: ${urlOrToken}`);
         }
     }
-    /**
-     * Get the prompt cache instance, if caching is enabled.
-     * Useful for accessing cache metrics or manually managing the cache.
-     */
-    get promptCache() {
-        return this._promptCache;
-    }
-    /**
-     * Cleanup resources held by the client.
-     * Stops the prompt cache's background refresh timer.
-     */
-    cleanup() {
-        if (this._promptCache) {
-            this._promptCache.stop();
-        }
-    }
     /**
      * Awaits all pending trace batches. Useful for environments where
      * you need to be sure that all tracing requests finish before execution ends,

package/dist/index.cjs

@@ -13,4 +13,4 @@ var uuid_js_1 = require("./uuid.cjs");
 Object.defineProperty(exports, "uuid7", { enumerable: true, get: function () { return uuid_js_1.uuid7; } });
 Object.defineProperty(exports, "uuid7FromTime", { enumerable: true, get: function () { return uuid_js_1.uuid7FromTime; } });
 // Update using yarn bump-version
-exports.__version__ = "0.4.3";
+exports.__version__ = "0.4.4";

package/dist/index.d.ts

@@ -4,4 +4,4 @@ export { RunTree, type RunTreeConfig } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
-export declare const __version__ = "0.4.3";
+export declare const __version__ = "0.4.4";

package/dist/index.js

@@ -4,4 +4,4 @@ export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
 // Update using yarn bump-version
-export const __version__ = "0.4.3";
+export const __version__ = "0.4.4";

package/dist/run_trees.cjs

@@ -616,15 +616,14 @@ class RunTree {
                 }
             }
         }
-        // Remap IDs for the replica using uuid7Deterministic
-        // This ensures consistency across runs in the same replica while
-        // preserving UUID7 properties (time-ordering, monotonicity)
+        // Remap IDs for the replica using uuid5 (deterministic)
+        // This ensures consistency across runs in the same replica
         const oldId = baseRun.id;
-        const newId = (0, _uuid_js_1.uuid7Deterministic)(oldId, projectName);
+        const newId = (0, uuid_1.v5)(`${oldId}:${projectName}`, UUID_NAMESPACE_DNS);
         // Remap trace_id
         let newTraceId;
         if (baseRun.trace_id) {
-            newTraceId = (0, _uuid_js_1.uuid7Deterministic)(baseRun.trace_id, projectName);
+            newTraceId = (0, uuid_1.v5)(`${baseRun.trace_id}:${projectName}`, UUID_NAMESPACE_DNS);
         }
         else {
             newTraceId = newId;
@@ -632,7 +631,7 @@ class RunTree {
         // Remap parent_run_id
         let newParentId;
         if (baseRun.parent_run_id) {
-            newParentId = (0, _uuid_js_1.uuid7Deterministic)(baseRun.parent_run_id, projectName);
+            newParentId = (0, uuid_1.v5)(`${baseRun.parent_run_id}:${projectName}`, UUID_NAMESPACE_DNS);
         }
         // Remap dotted_order segments
         let newDottedOrder;
@@ -641,7 +640,7 @@ class RunTree {
             const remappedSegs = segs.map((seg) => {
                 // Extract the UUID from the segment (last TIMESTAMP_LENGTH characters)
                 const segId = seg.slice(-TIMESTAMP_LENGTH);
-                const remappedId = (0, _uuid_js_1.uuid7Deterministic)(segId, projectName);
+                const remappedId = (0, uuid_1.v5)(`${segId}:${projectName}`, UUID_NAMESPACE_DNS);
                 // Replace the UUID part while keeping the timestamp prefix
                 return seg.slice(0, -TIMESTAMP_LENGTH) + remappedId;
             });

package/dist/run_trees.js

@@ -7,7 +7,7 @@ import { getEnvironmentVariable, getRuntimeEnvironment, } from "./utils/env.js";
 import { getDefaultProjectName } from "./utils/project.js";
 import { getLangSmithEnvironmentVariable } from "./utils/env.js";
 import { warnOnce } from "./utils/warn.js";
-import { uuid7FromTime, uuid7Deterministic } from "./utils/_uuid.js";
+import { uuid7FromTime } from "./utils/_uuid.js";
 import { v5 as uuidv5 } from "uuid";
 const TIMESTAMP_LENGTH = 36;
 // DNS namespace for UUID v5 (same as Python's uuid.NAMESPACE_DNS)
@@ -610,15 +610,14 @@ export class RunTree {
                 }
             }
         }
-        // Remap IDs for the replica using uuid7Deterministic
-        // This ensures consistency across runs in the same replica while
-        // preserving UUID7 properties (time-ordering, monotonicity)
+        // Remap IDs for the replica using uuid5 (deterministic)
+        // This ensures consistency across runs in the same replica
         const oldId = baseRun.id;
-        const newId = uuid7Deterministic(oldId, projectName);
+        const newId = uuidv5(`${oldId}:${projectName}`, UUID_NAMESPACE_DNS);
         // Remap trace_id
         let newTraceId;
         if (baseRun.trace_id) {
-            newTraceId = uuid7Deterministic(baseRun.trace_id, projectName);
+            newTraceId = uuidv5(`${baseRun.trace_id}:${projectName}`, UUID_NAMESPACE_DNS);
         }
         else {
             newTraceId = newId;
@@ -626,7 +625,7 @@ export class RunTree {
         // Remap parent_run_id
         let newParentId;
         if (baseRun.parent_run_id) {
-            newParentId = uuid7Deterministic(baseRun.parent_run_id, projectName);
+            newParentId = uuidv5(`${baseRun.parent_run_id}:${projectName}`, UUID_NAMESPACE_DNS);
         }
         // Remap dotted_order segments
         let newDottedOrder;
@@ -635,7 +634,7 @@ export class RunTree {
             const remappedSegs = segs.map((seg) => {
                 // Extract the UUID from the segment (last TIMESTAMP_LENGTH characters)
                 const segId = seg.slice(-TIMESTAMP_LENGTH);
-                const remappedId = uuid7Deterministic(segId, projectName);
+                const remappedId = uuidv5(`${segId}:${projectName}`, UUID_NAMESPACE_DNS);
                 // Replace the UUID part while keeping the timestamp prefix
                 return seg.slice(0, -TIMESTAMP_LENGTH) + remappedId;
             });

package/dist/utils/_uuid.cjs

@@ -4,10 +4,8 @@ exports.assertUuid = assertUuid;
 exports.uuid7FromTime = uuid7FromTime;
 exports.getUuidVersion = getUuidVersion;
 exports.warnIfNotUuidV7 = warnIfNotUuidV7;
-exports.uuid7Deterministic = uuid7Deterministic;
 // Relaxed UUID validation regex (allows any valid UUID format including nil UUIDs)
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const crypto_1 = require("crypto");
 const uuid_1 = require("uuid");
 const warn_js_1 = require("./warn.cjs");
 let UUID7_WARNING_EMITTED = false;
@@ -66,88 +64,3 @@ function warnIfNotUuidV7(uuidStr, _idType) {
             `Future versions will require UUID v7.`);
     }
 }
-/**
- * Convert a UUID string to its 16-byte representation.
- * @param uuidStr - The UUID string (with or without dashes)
- * @returns A Buffer containing the 16 bytes of the UUID
- */
-function uuidToBytes(uuidStr) {
-    const hex = uuidStr.replace(/-/g, "");
-    return Buffer.from(hex, "hex");
-}
-/**
- * Convert 16 bytes to a UUID string.
- * @param bytes - A Buffer containing 16 bytes
- * @returns A UUID string in standard format
- */
-function bytesToUuid(bytes) {
-    const hex = bytes.toString("hex");
-    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-/**
- * Generate a deterministic UUID v7 derived from an original UUID and a key.
- *
- * This function creates a new UUID that:
- * - Preserves the timestamp from the original UUID if it's UUID v7
- * - Uses current time if the original is not UUID v7
- * - Uses deterministic "random" bits derived from hashing the original + key
- * - Is valid UUID v7 format
- *
- * This is used for creating replica IDs that maintain time-ordering properties
- * while being deterministic across distributed systems.
- *
- * @param originalId - The source UUID string (ideally UUID v7 to preserve timestamp)
- * @param key - A string key used for deterministic derivation (e.g., project name)
- * @returns A new UUID v7 string with preserved timestamp (if original is v7) and
- *          deterministic random bits
- *
- * @example
- * ```typescript
- * const original = uuidv7();
- * const replicaId = uuid7Deterministic(original, "replica-project");
- * // Same inputs always produce same output
- * assert(uuid7Deterministic(original, "replica-project") === replicaId);
- * ```
- */
-function uuid7Deterministic(originalId, key) {
-    // Generate deterministic bytes from hash of original + key
-    const hashInput = `${originalId}:${key}`;
-    const h = (0, crypto_1.createHash)("sha256").update(hashInput).digest();
-    // Build new UUID7:
-    // UUID7 structure (RFC 9562):
-    // [0-5]  48 bits: unix_ts_ms (timestamp in milliseconds)
-    // [6]    4 bits: version (0111 = 7) + 4 bits rand_a
-    // [7]    8 bits: rand_a (continued)
-    // [8]    2 bits: variant (10) + 6 bits rand_b
-    // [9-15] 56 bits: rand_b (continued)
-    const b = Buffer.alloc(16);
-    // Check if original is UUID v7 - if so, preserve its timestamp
-    // If not, use current time to ensure the derived UUID has a valid timestamp
-    const version = getUuidVersion(originalId);
-    if (version === 7) {
-        // Preserve timestamp from original UUID7 (bytes 0-5)
-        const originalBytes = uuidToBytes(originalId);
-        originalBytes.copy(b, 0, 0, 6);
-    }
-    else {
-        // Generate fresh timestamp for non-UUID7 inputs
-        // This matches the uuid npm package's v7 implementation:
-        // https://github.com/uuidjs/uuid/blob/main/src/v7.ts
-        const msecs = Date.now();
-        b[0] = (msecs / 0x10000000000) & 0xff;
-        b[1] = (msecs / 0x100000000) & 0xff;
-        b[2] = (msecs / 0x1000000) & 0xff;
-        b[3] = (msecs / 0x10000) & 0xff;
-        b[4] = (msecs / 0x100) & 0xff;
-        b[5] = msecs & 0xff;
-    }
-    // Set version 7 (0111) in high nibble + 4 bits from hash
-    b[6] = 0x70 | (h[0] & 0x0f);
-    // rand_a continued (8 bits from hash)
-    b[7] = h[1];
-    // Set variant (10) in high 2 bits + 6 bits from hash
-    b[8] = 0x80 | (h[2] & 0x3f);
-    // rand_b (56 bits = 7 bytes from hash)
-    h.copy(b, 9, 3, 10);
-    return bytesToUuid(b);
-}

package/dist/utils/_uuid.d.ts

@@ -19,29 +19,3 @@ export declare function getUuidVersion(uuidStr: string): number | null;
  * @param idType - The type of ID (e.g., "run_id", "trace_id") for the warning message
  */
 export declare function warnIfNotUuidV7(uuidStr: string, _idType: string): void;
-/**
- * Generate a deterministic UUID v7 derived from an original UUID and a key.
- *
- * This function creates a new UUID that:
- * - Preserves the timestamp from the original UUID if it's UUID v7
- * - Uses current time if the original is not UUID v7
- * - Uses deterministic "random" bits derived from hashing the original + key
- * - Is valid UUID v7 format
- *
- * This is used for creating replica IDs that maintain time-ordering properties
- * while being deterministic across distributed systems.
- *
- * @param originalId - The source UUID string (ideally UUID v7 to preserve timestamp)
- * @param key - A string key used for deterministic derivation (e.g., project name)
- * @returns A new UUID v7 string with preserved timestamp (if original is v7) and
- *          deterministic random bits
- *
- * @example
- * ```typescript
- * const original = uuidv7();
- * const replicaId = uuid7Deterministic(original, "replica-project");
- * // Same inputs always produce same output
- * assert(uuid7Deterministic(original, "replica-project") === replicaId);
- * ```
- */
-export declare function uuid7Deterministic(originalId: string, key: string): string;