langsmith 0.8.9 → 0.8.11

package/dist/client.cjs

@@ -893,7 +893,8 @@ class Client {
             config.hideInputs ?? config.anonymizer ?? defaultConfig.hideInputs;
         this.hideOutputs =
             config.hideOutputs ?? config.anonymizer ?? defaultConfig.hideOutputs;
-        this.hideMetadata = config.hideMetadata ?? defaultConfig.hideMetadata;
+        this.hideMetadata =
+            config.hideMetadata ?? config.anonymizer ?? defaultConfig.hideMetadata;
         this.anonymizer = config.anonymizer;
         this.omitTracedRuntimeInfo = config.omitTracedRuntimeInfo ?? false;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
@@ -1555,6 +1556,9 @@ class Client {
         const batchSizeBytes = batch.reduce((sum, item) => sum + (item.size ?? 0), 0);
         try {
             if (this.langSmithToOTELTranslator !== undefined) {
+                for (const item of batch) {
+                    item.item = await this._maskRunMetadata(item.item);
+                }
                 this._sendBatchToOTELTranslator(batch);
             }
             else {
@@ -1635,6 +1639,25 @@ class Client {
             this.langSmithToOTELTranslator.exportBatch(operations, otelContextMap);
         }
     }
+    async _maskRunMetadata(run) {
+        if (run.extra?.metadata == null) {
+            return run;
+        }
+        return {
+            ...run,
+            extra: {
+                ...run.extra,
+                metadata: await this.processMetadata(run.extra.metadata),
+            },
+        };
+    }
+    async _mergeRuntimeEnvAndMaskMetadata(run) {
+        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        if (this.omitTracedRuntimeInfo) {
+            return merged;
+        }
+        return this._maskRunMetadata(merged);
+    }
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
@@ -1791,7 +1814,7 @@ class Client {
             }).catch(console.error);
             return;
         }
-        const mergedRunCreateParam = mergeRuntimeEnvIntoRun(runCreate, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        const mergedRunCreateParam = await this._mergeRuntimeEnvAndMaskMetadata(runCreate);
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
@@ -2980,7 +3003,7 @@ class Client {
             _hostUrl: this.getHostUrl(),
         }));
     }
-    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, }) {
+    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, tagValueIds = null, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;
         const extra = projectExtra || {};
@@ -3004,6 +3027,9 @@ class Client {
         if (evaluatorKeys != null && evaluatorKeys.length > 0) {
             body["evaluator_keys"] = evaluatorKeys;
         }
+        if (tagValueIds !== null) {
+            body["tag_value_ids"] = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(endpoint, {
@@ -3247,7 +3273,7 @@ class Client {
         const result = await response.json();
         return result;
     }
-    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, } = {}) {
+    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, tagValueIds, } = {}) {
         const body = {
             name,
             description,
@@ -3262,6 +3288,9 @@ class Client {
         if (outputsSchema) {
             body.outputs_schema_definition = outputsSchema;
         }
+        if (tagValueIds !== undefined) {
+            body.tag_value_ids = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets`, {

package/dist/client.d.ts

@@ -20,11 +20,11 @@ export interface ClientConfig {
     timeout_ms?: number;
     webUrl?: string;
     /**
-     * A function applied for masking serialized run inputs and outputs,
-     * before sending to the API. Can be called with raw inputs, raw
-     * outputs, or a nested `{ error: string }` object for errors.
+     * A function applied for masking serialized run inputs, outputs and
+     * metadata, before sending to the API. Can be called with raw inputs, raw
+     * outputs, raw metadata, or a nested `{ error: string }` object for errors.
      *
-     * If a `hideInputs` or `hideOutputs` function is present,
+     * If a `hideInputs`, `hideOutputs` or `hideMetadata` function is present,
      * the client will call it instead of the anonymizer as appropriate.
      */
     anonymizer?: (values: KVMap) => KVMap | Promise<KVMap>;
@@ -413,6 +413,7 @@ export type CreateProjectParams = {
     numExamples?: number | null;
     numRepetitions?: number | null;
     evaluatorKeys?: string[] | null;
+    tagValueIds?: string[] | null;
 };
 type AutoBatchQueueItem = {
     action: "create" | "update";
@@ -670,6 +671,8 @@ export declare class Client implements LangSmithTracingClientInterface {
     private static _writeTraceToFallbackDir;
     private _processBatch;
     private _sendBatchToOTELTranslator;
+    private _maskRunMetadata;
+    private _mergeRuntimeEnvAndMaskMetadata;
     private processRunOperation;
     protected _getServerInfo(): Promise<any>;
     private _checkStainlessVersion;
@@ -872,7 +875,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     listSharedExamples(shareToken: string, options?: {
         exampleIds?: string[];
     }): Promise<Example[]>;
-    createProject({ projectName, description, metadata, upsert, projectExtra, referenceDatasetId, numExamples, numRepetitions, evaluatorKeys, }: CreateProjectParams): Promise<TracerSession>;
+    createProject({ projectName, description, metadata, upsert, projectExtra, referenceDatasetId, numExamples, numRepetitions, evaluatorKeys, tagValueIds, }: CreateProjectParams): Promise<TracerSession>;
     updateProject(projectId: string, { name, description, metadata, projectExtra, endTime, }: {
         name?: string | null;
         description?: string | null;
@@ -914,12 +917,13 @@ export declare class Client implements LangSmithTracingClientInterface {
         projectName?: string;
     }): Promise<void>;
     uploadCsv({ csvFile, fileName, inputKeys, outputKeys, description, dataType, name, }: UploadCSVParams): Promise<Dataset>;
-    createDataset(name: string, { description, dataType, inputsSchema, outputsSchema, metadata, }?: {
+    createDataset(name: string, { description, dataType, inputsSchema, outputsSchema, metadata, tagValueIds, }?: {
         description?: string;
         dataType?: DataType;
         inputsSchema?: KVMap;
         outputsSchema?: KVMap;
         metadata?: RecordStringAny;
+        tagValueIds?: string[];
     }): Promise<Dataset>;
     readDataset({ datasetId, datasetName, }: {
         datasetId?: string;

package/dist/client.js

@@ -854,7 +854,8 @@ export class Client {
             config.hideInputs ?? config.anonymizer ?? defaultConfig.hideInputs;
         this.hideOutputs =
             config.hideOutputs ?? config.anonymizer ?? defaultConfig.hideOutputs;
-        this.hideMetadata = config.hideMetadata ?? defaultConfig.hideMetadata;
+        this.hideMetadata =
+            config.hideMetadata ?? config.anonymizer ?? defaultConfig.hideMetadata;
         this.anonymizer = config.anonymizer;
         this.omitTracedRuntimeInfo = config.omitTracedRuntimeInfo ?? false;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
@@ -1516,6 +1517,9 @@ export class Client {
         const batchSizeBytes = batch.reduce((sum, item) => sum + (item.size ?? 0), 0);
         try {
             if (this.langSmithToOTELTranslator !== undefined) {
+                for (const item of batch) {
+                    item.item = await this._maskRunMetadata(item.item);
+                }
                 this._sendBatchToOTELTranslator(batch);
             }
             else {
@@ -1596,6 +1600,25 @@ export class Client {
             this.langSmithToOTELTranslator.exportBatch(operations, otelContextMap);
         }
     }
+    async _maskRunMetadata(run) {
+        if (run.extra?.metadata == null) {
+            return run;
+        }
+        return {
+            ...run,
+            extra: {
+                ...run.extra,
+                metadata: await this.processMetadata(run.extra.metadata),
+            },
+        };
+    }
+    async _mergeRuntimeEnvAndMaskMetadata(run) {
+        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        if (this.omitTracedRuntimeInfo) {
+            return merged;
+        }
+        return this._maskRunMetadata(merged);
+    }
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
@@ -1752,7 +1775,7 @@ export class Client {
             }).catch(console.error);
             return;
         }
-        const mergedRunCreateParam = mergeRuntimeEnvIntoRun(runCreate, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        const mergedRunCreateParam = await this._mergeRuntimeEnvAndMaskMetadata(runCreate);
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
@@ -2941,7 +2964,7 @@ export class Client {
             _hostUrl: this.getHostUrl(),
         }));
     }
-    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, }) {
+    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, tagValueIds = null, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;
         const extra = projectExtra || {};
@@ -2965,6 +2988,9 @@ export class Client {
         if (evaluatorKeys != null && evaluatorKeys.length > 0) {
             body["evaluator_keys"] = evaluatorKeys;
         }
+        if (tagValueIds !== null) {
+            body["tag_value_ids"] = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(endpoint, {
@@ -3208,7 +3234,7 @@ export class Client {
         const result = await response.json();
         return result;
     }
-    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, } = {}) {
+    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, tagValueIds, } = {}) {
         const body = {
             name,
             description,
@@ -3223,6 +3249,9 @@ export class Client {
         if (outputsSchema) {
             body.outputs_schema_definition = outputsSchema;
         }
+        if (tagValueIds !== undefined) {
+            body.tag_value_ids = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets`, {

package/dist/experimental/vercel/_agent_type.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVercelLsAgentType = resolveVercelLsAgentType;
+exports.vercelLsAgentTypeMetadata = vercelLsAgentTypeMetadata;
+const run_trees_js_1 = require("../../run_trees.cjs");
+const traceable_js_1 = require("../../singletons/traceable.cjs");
+const ls_agent_type_js_1 = require("../../utils/ls_agent_type.cjs");
+// Vercel builds its traceable's `metadata` config eagerly, before traceable
+// itself runs — this resolver stamps `ls_agent_type` at that moment.
+// Traceable's own propagation would carry a parent's middleware/subagent/
+// compaction/"root" tag down on its own. This resolver is needed
+// for correct default tagging of the root `ls_agent_type` == root
+// and tagging of subagents.
+function resolveVercelLsAgentType(parentRunTree) {
+    const parent = parentRunTree ?? (0, traceable_js_1.getCurrentRunTree)(true);
+    if (!(0, run_trees_js_1.isRunTree)(parent))
+        return (0, ls_agent_type_js_1.resolveDefaultLsAgentType)(parent);
+    const parentTag = parent.extra?.metadata?.ls_agent_type;
+    if (typeof parentTag === "string" && ls_agent_type_js_1.NON_ROOT_LS_AGENT_TYPES.has(parentTag)) {
+        return parentTag;
+    }
+    if (parent.run_type === "tool")
+        return "subagent";
+    if (parentTag === "root")
+        return "root";
+    return undefined;
+}
+function vercelLsAgentTypeMetadata(parentRunTree) {
+    return (0, ls_agent_type_js_1.lsAgentTypeMetadata)(resolveVercelLsAgentType(parentRunTree));
+}

package/dist/experimental/vercel/_agent_type.d.ts

@@ -0,0 +1,5 @@
+import { LsAgentType } from "../../utils/ls_agent_type.js";
+export declare function resolveVercelLsAgentType(parentRunTree?: unknown): LsAgentType | undefined;
+export declare function vercelLsAgentTypeMetadata(parentRunTree?: unknown): {
+    ls_agent_type?: LsAgentType;
+};

package/dist/experimental/vercel/_agent_type.js

@@ -0,0 +1,26 @@
+import { isRunTree } from "../../run_trees.js";
+import { getCurrentRunTree } from "../../singletons/traceable.js";
+import { NON_ROOT_LS_AGENT_TYPES, lsAgentTypeMetadata, resolveDefaultLsAgentType, } from "../../utils/ls_agent_type.js";
+// Vercel builds its traceable's `metadata` config eagerly, before traceable
+// itself runs — this resolver stamps `ls_agent_type` at that moment.
+// Traceable's own propagation would carry a parent's middleware/subagent/
+// compaction/"root" tag down on its own. This resolver is needed
+// for correct default tagging of the root `ls_agent_type` == root
+// and tagging of subagents.
+export function resolveVercelLsAgentType(parentRunTree) {
+    const parent = parentRunTree ?? getCurrentRunTree(true);
+    if (!isRunTree(parent))
+        return resolveDefaultLsAgentType(parent);
+    const parentTag = parent.extra?.metadata?.ls_agent_type;
+    if (typeof parentTag === "string" && NON_ROOT_LS_AGENT_TYPES.has(parentTag)) {
+        return parentTag;
+    }
+    if (parent.run_type === "tool")
+        return "subagent";
+    if (parentTag === "root")
+        return "root";
+    return undefined;
+}
+export function vercelLsAgentTypeMetadata(parentRunTree) {
+    return lsAgentTypeMetadata(resolveVercelLsAgentType(parentRunTree));
+}

package/dist/experimental/vercel/telemetry.cjs

@@ -7,6 +7,7 @@ const env_js_1 = require("../../env.cjs");
 const utils_js_1 = require("./utils.cjs");
 const utils_js_2 = require("./utils.cjs");
 const types_js_1 = require("../../utils/types.cjs");
+const _agent_type_js_1 = require("./_agent_type.cjs");
 function _formatMessages(messages) {
     if (!Array.isArray(messages))
         return messages;
@@ -52,12 +53,6 @@ event, traceRawHttp) {
     }
     return (0, utils_js_1.convertMessageToTracedFormat)(output);
 }
-function _getLsAgentType(parentRunTree) {
-    if ((0, run_trees_js_1.isRunTree)(parentRunTree) && parentRunTree.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-}
 function _hasNonzeroUsageMetadata(runTree) {
     const usageMetadata = runTree.extra?.metadata?.usage_metadata;
     if (!(0, types_js_1.isRecord)(usageMetadata))
@@ -200,7 +195,7 @@ function LangSmithTelemetry(config) {
                 metadata: {
                     ...customMetadata,
                     ai_sdk_method: event.operationId,
-                    ls_agent_type: _getLsAgentType(parentRunTree),
+                    ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(parentRunTree),
                     ls_model_name: event.modelId,
                     ls_integration: "vercel-ai-sdk-telemetry",
                 },

package/dist/experimental/vercel/telemetry.js

@@ -4,6 +4,7 @@ import { isEnvTracingEnabled } from "../../env.js";
 import { convertMessageToTracedFormat } from "./utils.js";
 import { setUsageMetadataOnRunTree } from "./utils.js";
 import { isPrimitive, isRecord } from "../../utils/types.js";
+import { vercelLsAgentTypeMetadata } from "./_agent_type.js";
 function _formatMessages(messages) {
     if (!Array.isArray(messages))
         return messages;
@@ -49,12 +50,6 @@ event, traceRawHttp) {
     }
     return convertMessageToTracedFormat(output);
 }
-function _getLsAgentType(parentRunTree) {
-    if (isRunTree(parentRunTree) && parentRunTree.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-}
 function _hasNonzeroUsageMetadata(runTree) {
     const usageMetadata = runTree.extra?.metadata?.usage_metadata;
     if (!isRecord(usageMetadata))
@@ -197,7 +192,7 @@ export function LangSmithTelemetry(config) {
                 metadata: {
                     ...customMetadata,
                     ai_sdk_method: event.operationId,
-                    ls_agent_type: _getLsAgentType(parentRunTree),
+                    ...vercelLsAgentTypeMetadata(parentRunTree),
                     ls_model_name: event.modelId,
                     ls_integration: "vercel-ai-sdk-telemetry",
                 },

package/dist/experimental/vercel/wrap.cjs

@@ -5,6 +5,7 @@ const middleware_js_1 = require("./middleware.cjs");
 const utils_js_1 = require("./utils.cjs");
 Object.defineProperty(exports, "convertMessageToTracedFormat", { enumerable: true, get: function () { return utils_js_1.convertMessageToTracedFormat; } });
 const traceable_js_1 = require("../../traceable.cjs");
+const _agent_type_js_1 = require("./_agent_type.cjs");
 const _getModelDisplayName = (model) => {
     if (typeof model === "string") {
         return model;
@@ -118,19 +119,12 @@ const _resolveConfigs = (baseLsConfig, runtimeLsConfig) => {
         resolvedToolConfig,
     };
 };
-const _getLsAgentType = () => {
-    const parentRun = (0, traceable_js_1.getCurrentRunTree)(true);
-    if (parentRun != null && parentRun.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-};
 const _getGenerateTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolvedLsConfig, hasExplicitOutput, hasExplicitExperimentalOutput, traceResponseMetadata, }) => {
     return {
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
             ai_sdk_method: aiSdkMethodName ?? "ai.generateText",
             ...resolvedLsConfig?.metadata,
         },
@@ -206,7 +200,7 @@ const _getStreamTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolved
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
             ai_sdk_method: aiSdkMethodName ?? "ai.streamText",
             ...resolvedLsConfig?.metadata,
         },
@@ -409,7 +403,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
                     ai_sdk_method: "ai.generateObject",
                     ...resolvedLsConfig?.metadata,
                 },
@@ -531,7 +525,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
                     ai_sdk_method: "ai.streamObject",
                     ...resolvedLsConfig?.metadata,
                 },

package/dist/experimental/vercel/wrap.js

@@ -1,6 +1,7 @@
 import { LangSmithMiddleware, } from "./middleware.js";
 import { convertMessageToTracedFormat } from "./utils.js";
-import { isTraceableFunction, traceable, getCurrentRunTree, } from "../../traceable.js";
+import { isTraceableFunction, traceable } from "../../traceable.js";
+import { vercelLsAgentTypeMetadata } from "./_agent_type.js";
 const _getModelDisplayName = (model) => {
     if (typeof model === "string") {
         return model;
@@ -114,19 +115,12 @@ const _resolveConfigs = (baseLsConfig, runtimeLsConfig) => {
         resolvedToolConfig,
     };
 };
-const _getLsAgentType = () => {
-    const parentRun = getCurrentRunTree(true);
-    if (parentRun != null && parentRun.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-};
 const _getGenerateTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolvedLsConfig, hasExplicitOutput, hasExplicitExperimentalOutput, traceResponseMetadata, }) => {
     return {
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...vercelLsAgentTypeMetadata(),
             ai_sdk_method: aiSdkMethodName ?? "ai.generateText",
             ...resolvedLsConfig?.metadata,
         },
@@ -202,7 +196,7 @@ const _getStreamTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolved
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...vercelLsAgentTypeMetadata(),
             ai_sdk_method: aiSdkMethodName ?? "ai.streamText",
             ...resolvedLsConfig?.metadata,
         },
@@ -404,7 +398,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...vercelLsAgentTypeMetadata(),
                     ai_sdk_method: "ai.generateObject",
                     ...resolvedLsConfig?.metadata,
                 },
@@ -526,7 +520,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...vercelLsAgentTypeMetadata(),
                     ai_sdk_method: "ai.streamObject",
                     ...resolvedLsConfig?.metadata,
                 },

package/dist/index.cjs

@@ -35,6 +35,6 @@ Object.defineProperty(exports, "UnprocessableEntityError", { enumerable: true, g
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return error_js_1.RateLimitError; } });
 Object.defineProperty(exports, "InternalServerError", { enumerable: true, get: function () { return error_js_1.InternalServerError; } });
 // Update using pnpm bump-version
-exports.__version__ = "0.8.9";
+exports.__version__ = "0.8.11";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 exports.LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { computeRunIdForSecondaryReplica, uuid7, uuid7FromTime, } from "./uuid.j
 export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, type CacheConfig, type CacheMetrics, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 export { LangsmithError, APIError, APIUserAbortError, APIConnectionError, APIConnectionTimeoutError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./_openapi_client/core/error.js";
-export declare const __version__ = "0.8.9";
+export declare const __version__ = "0.8.11";
 export declare const LS_MESSAGE_VIEW_EXCLUDE: "ls_message_view_exclude";

package/dist/index.js

@@ -7,6 +7,6 @@ export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 export { LangsmithError, APIError, APIUserAbortError, APIConnectionError, APIConnectionTimeoutError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./_openapi_client/core/error.js";
 // Update using pnpm bump-version
-export const __version__ = "0.8.9";
+export const __version__ = "0.8.11";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 export const LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/sandbox/client.cjs

@@ -698,13 +698,19 @@ class SandboxClient {
      *
      * @param name - Snapshot name.
      * @param dockerfile - Local Dockerfile path, relative to context by default.
-     * @param fsCapacityBytes - Filesystem capacity in bytes.
-     * @param options - Build context, args, target, build log callback, builder
-     *   vCPUs/memory, timeout.
+     * @param fsCapacityBytesOrOptions - Optional filesystem capacity in bytes, or
+     *   build options. When omitted, the server applies its default capacity.
+     * @param options - Build options when capacity is passed separately.
      * @returns Snapshot in "ready" status.
      */
-    async createSnapshotFromDockerfile(name, dockerfile, fsCapacityBytes, options = {}) {
-        const { context = ".", buildArgs, target, onBuildLog, vCpus, memBytes, timeout = 60, } = options;
+    async createSnapshotFromDockerfile(name, dockerfile, fsCapacityBytesOrOptions, options = {}) {
+        const fsCapacityBytes = typeof fsCapacityBytesOrOptions === "number"
+            ? fsCapacityBytesOrOptions
+            : undefined;
+        const resolvedOptions = typeof fsCapacityBytesOrOptions === "number"
+            ? options
+            : (fsCapacityBytesOrOptions ?? options);
+        const { context = ".", buildArgs, target, onBuildLog, vCpus, memBytes, timeout = 60, } = resolvedOptions;
         const { contextPath, dockerfileRel } = await resolveDockerfileContext(dockerfile, context);
         const builderName = `snapshot-builder-${(0, index_js_2.v4)().replace(/-/g, "").slice(0, 12)}`;
         // Stage the build on the capacity-backed root filesystem, not /tmp.

package/dist/sandbox/client.d.ts

@@ -208,12 +208,12 @@ export declare class SandboxClient {
      *
      * @param name - Snapshot name.
      * @param dockerfile - Local Dockerfile path, relative to context by default.
-     * @param fsCapacityBytes - Filesystem capacity in bytes.
-     * @param options - Build context, args, target, build log callback, builder
-     *   vCPUs/memory, timeout.
+     * @param fsCapacityBytesOrOptions - Optional filesystem capacity in bytes, or
+     *   build options. When omitted, the server applies its default capacity.
+     * @param options - Build options when capacity is passed separately.
      * @returns Snapshot in "ready" status.
      */
-    createSnapshotFromDockerfile(name: string, dockerfile: string, fsCapacityBytes: number, options?: CreateDockerfileSnapshotOptions): Promise<Snapshot>;
+    createSnapshotFromDockerfile(name: string, dockerfile: string, fsCapacityBytesOrOptions?: number | CreateDockerfileSnapshotOptions, options?: CreateDockerfileSnapshotOptions): Promise<Snapshot>;
     /**
      * Capture a snapshot from a running sandbox.
      *

package/dist/sandbox/client.js

@@ -695,13 +695,19 @@ export class SandboxClient {
      *
      * @param name - Snapshot name.
      * @param dockerfile - Local Dockerfile path, relative to context by default.
-     * @param fsCapacityBytes - Filesystem capacity in bytes.
-     * @param options - Build context, args, target, build log callback, builder
-     *   vCPUs/memory, timeout.
+     * @param fsCapacityBytesOrOptions - Optional filesystem capacity in bytes, or
+     *   build options. When omitted, the server applies its default capacity.
+     * @param options - Build options when capacity is passed separately.
      * @returns Snapshot in "ready" status.
      */
-    async createSnapshotFromDockerfile(name, dockerfile, fsCapacityBytes, options = {}) {
-        const { context = ".", buildArgs, target, onBuildLog, vCpus, memBytes, timeout = 60, } = options;
+    async createSnapshotFromDockerfile(name, dockerfile, fsCapacityBytesOrOptions, options = {}) {
+        const fsCapacityBytes = typeof fsCapacityBytesOrOptions === "number"
+            ? fsCapacityBytesOrOptions
+            : undefined;
+        const resolvedOptions = typeof fsCapacityBytesOrOptions === "number"
+            ? options
+            : (fsCapacityBytesOrOptions ?? options);
+        const { context = ".", buildArgs, target, onBuildLog, vCpus, memBytes, timeout = 60, } = resolvedOptions;
         const { contextPath, dockerfileRel } = await resolveDockerfileContext(dockerfile, context);
         const builderName = `snapshot-builder-${uuidv4().replace(/-/g, "").slice(0, 12)}`;
         // Stage the build on the capacity-backed root filesystem, not /tmp.

package/dist/sandbox/index.cjs

@@ -29,7 +29,7 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LangSmithDataplaneNotConfiguredError = exports.LangSmithCommandTimeoutError = exports.LangSmithSandboxOperationError = exports.LangSmithSandboxNotReadyError = exports.LangSmithSandboxCreationError = exports.LangSmithResourceCreationError = exports.LangSmithQuotaExceededError = exports.LangSmithValidationError = exports.LangSmithResourceNameConflictError = exports.LangSmithResourceAlreadyExistsError = exports.LangSmithResourceInUseError = exports.LangSmithResourceTimeoutError = exports.LangSmithResourceNotFoundError = exports.LangSmithSandboxServerReloadError = exports.LangSmithSandboxConnectTimeoutError = exports.LangSmithSandboxConnectionError = exports.LangSmithSandboxAuthenticationError = exports.LangSmithSandboxAPIError = exports.LangSmithSandboxError = exports.s3Mount = exports.mountConfig = exports.gitMount = exports.gcsMount = exports.workspaceSecret = exports.proxyConfig = exports.opaqueSecret = exports.gcpAuth = exports.awsAuth = exports.CommandHandle = exports.Sandbox = exports.SandboxClient = void 0;
+exports.LangSmithDataplaneNotConfiguredError = exports.LangSmithCommandTimeoutError = exports.LangSmithSandboxOperationError = exports.LangSmithSandboxNotReadyError = exports.LangSmithSandboxCreationError = exports.LangSmithResourceCreationError = exports.LangSmithQuotaExceededError = exports.LangSmithValidationError = exports.LangSmithResourceNameConflictError = exports.LangSmithResourceAlreadyExistsError = exports.LangSmithResourceInUseError = exports.LangSmithResourceTimeoutError = exports.LangSmithResourceNotFoundError = exports.LangSmithSandboxServerReloadError = exports.LangSmithSandboxConnectTimeoutError = exports.LangSmithSandboxConnectionError = exports.LangSmithSandboxAuthenticationError = exports.LangSmithSandboxAPIError = exports.LangSmithSandboxError = exports.s3Mount = exports.mountConfig = exports.gitMount = exports.gcsMount = exports.contextHubMount = exports.workspaceSecret = exports.proxyConfig = exports.opaqueSecret = exports.gcpAuth = exports.awsAuth = exports.CommandHandle = exports.Sandbox = exports.SandboxClient = void 0;
 // Main classes
 var client_js_1 = require("./client.cjs");
 Object.defineProperty(exports, "SandboxClient", { enumerable: true, get: function () { return client_js_1.SandboxClient; } });
@@ -44,6 +44,7 @@ Object.defineProperty(exports, "opaqueSecret", { enumerable: true, get: function
 Object.defineProperty(exports, "proxyConfig", { enumerable: true, get: function () { return proxy_config_js_1.proxyConfig; } });
 Object.defineProperty(exports, "workspaceSecret", { enumerable: true, get: function () { return proxy_config_js_1.workspaceSecret; } });
 var mounts_js_1 = require("./mounts.cjs");
+Object.defineProperty(exports, "contextHubMount", { enumerable: true, get: function () { return mounts_js_1.contextHubMount; } });
 Object.defineProperty(exports, "gcsMount", { enumerable: true, get: function () { return mounts_js_1.gcsMount; } });
 Object.defineProperty(exports, "gitMount", { enumerable: true, get: function () { return mounts_js_1.gitMount; } });
 Object.defineProperty(exports, "mountConfig", { enumerable: true, get: function () { return mounts_js_1.mountConfig; } });

package/dist/sandbox/index.d.ts

@@ -31,6 +31,6 @@ export { SandboxClient } from "./client.js";
 export { Sandbox } from "./sandbox.js";
 export { CommandHandle } from "./command_handle.js";
 export { awsAuth, gcpAuth, opaqueSecret, proxyConfig, workspaceSecret, } from "./proxy_config.js";
-export { gcsMount, gitMount, mountConfig, s3Mount } from "./mounts.js";
-export type { ExecutionResult, OutputChunk, WsMessage, WsRunOptions, ResourceStatus, Snapshot, SandboxData, SandboxClientConfig, RunOptions, CreateSandboxOptions, SandboxAccessControl, SandboxAwsAuthRule, SandboxAwsMountAuthConfig, SandboxGcpAuthRule, SandboxGcpMountAuthConfig, SandboxMountAuth, SandboxMountAuthConfig, SandboxMountConfig, SandboxProxyConfig, SandboxProxyRule, SandboxProxySecret, SandboxMount, MountCacheConfig, GCSMountConfig, GCSMountSpec, GitMountConfig, GitMountRefSpec, GitMountSpec, S3MountConfig, S3MountSpec, CreateSnapshotOptions, CreateDockerfileSnapshotOptions, CaptureSnapshotOptions, ListSnapshotsOptions, WaitForSnapshotOptions, StartSandboxOptions, UpdateSandboxOptions, WaitForSandboxOptions, } from "./types.js";
+export { contextHubMount, gcsMount, gitMount, mountConfig, s3Mount, } from "./mounts.js";
+export type { ExecutionResult, OutputChunk, WsMessage, WsRunOptions, ResourceStatus, Snapshot, SandboxData, SandboxClientConfig, RunOptions, CreateSandboxOptions, SandboxAccessControl, SandboxAwsAuthRule, SandboxAwsMountAuthConfig, SandboxGcpAuthRule, SandboxGcpMountAuthConfig, SandboxMountAuth, SandboxMountAuthConfig, SandboxMountConfig, SandboxProxyConfig, SandboxProxyRule, SandboxProxySecret, SandboxMount, MountCacheConfig, ContextHubMountConfig, ContextHubMountSpec, GCSMountConfig, GCSMountSpec, GitMountConfig, GitMountRefSpec, GitMountSpec, S3MountConfig, S3MountSpec, CreateSnapshotOptions, CreateDockerfileSnapshotOptions, CaptureSnapshotOptions, ListSnapshotsOptions, WaitForSnapshotOptions, StartSandboxOptions, UpdateSandboxOptions, WaitForSandboxOptions, } from "./types.js";
 export { LangSmithSandboxError, LangSmithSandboxAPIError, LangSmithSandboxAuthenticationError, LangSmithSandboxConnectionError, LangSmithSandboxConnectTimeoutError, LangSmithSandboxServerReloadError, LangSmithResourceNotFoundError, LangSmithResourceTimeoutError, LangSmithResourceInUseError, LangSmithResourceAlreadyExistsError, LangSmithResourceNameConflictError, LangSmithValidationError, LangSmithQuotaExceededError, LangSmithResourceCreationError, LangSmithSandboxCreationError, LangSmithSandboxNotReadyError, LangSmithSandboxOperationError, LangSmithCommandTimeoutError, LangSmithDataplaneNotConfiguredError, } from "./errors.js";

package/dist/sandbox/index.js

@@ -32,7 +32,7 @@ export { SandboxClient } from "./client.js";
 export { Sandbox } from "./sandbox.js";
 export { CommandHandle } from "./command_handle.js";
 export { awsAuth, gcpAuth, opaqueSecret, proxyConfig, workspaceSecret, } from "./proxy_config.js";
-export { gcsMount, gitMount, mountConfig, s3Mount } from "./mounts.js";
+export { contextHubMount, gcsMount, gitMount, mountConfig, s3Mount, } from "./mounts.js";
 // Errors
 export { 
 // Base and connection errors