langsmith 0.5.15 → 0.5.17

package/dist/client.js

@@ -430,6 +430,12 @@ export class Client {
             writable: true,
             value: 100 * 1024 * 1024
         });
+        Object.defineProperty(this, "_customHeaders", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
         Object.defineProperty(this, "debug", {
             enumerable: true,
             configurable: true,
@@ -526,6 +532,8 @@ export class Client {
             // Use the global singleton instance
             this._promptCache = promptCacheSingleton;
         }
+        // Initialize custom headers
+        this._customHeaders = config.headers ?? {};
     }
     static getDefaultClientConfig() {
         const apiKey = getLangSmithEnvironmentVariable("API_KEY");
@@ -565,6 +573,10 @@ export class Client {
             this.webUrl = "https://eu.smith.langchain.com";
             return this.webUrl;
         }
+        else if (this.apiUrl.split(".", 1)[0].includes("aws")) {
+            this.webUrl = "https://aws.smith.langchain.com";
+            return this.webUrl;
+        }
         else if (this.apiUrl.split(".", 1)[0].includes("beta")) {
             this.webUrl = "https://beta.smith.langchain.com";
             return this.webUrl;
@@ -574,10 +586,13 @@ export class Client {
             return this.webUrl;
         }
     }
-    get headers() {
+    get _mergedHeaders() {
+        // Start with custom headers so they don't override required headers
         const headers = {
             "User-Agent": `langsmith-js/${__version__}`,
+            ...this._customHeaders,
         };
+        // Required headers that should not be overridden
         if (this.apiKey) {
             headers["x-api-key"] = `${this.apiKey}`;
         }
@@ -586,6 +601,17 @@ export class Client {
         }
         return headers;
     }
+    /**
+     * Get or set custom headers for the client.
+     * Custom headers are merged with default headers (User-Agent, x-api-key, x-tenant-id).
+     * Custom headers will not override the default required headers.
+     */
+    get headers() {
+        return this._customHeaders;
+    }
+    set headers(value) {
+        this._customHeaders = value ?? {};
+    }
     _getPlatformEndpointPath(path) {
         // Check if apiUrl already ends with /v1 or /v1/ to avoid double /v1/v1/ paths
         const needsV1Prefix = this.apiUrl.slice(-3) !== "/v1" && this.apiUrl.slice(-4) !== "/v1/";
@@ -631,7 +657,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(url, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -654,7 +680,7 @@ export class Client {
             const response = await this.caller.call(async () => {
                 const res = await this._fetch(url, {
                     method: "GET",
-                    headers: this.headers,
+                    headers: this._mergedHeaders,
                     signal: AbortSignal.timeout(this.timeout_ms),
                     ...this.fetchOptions,
                 });
@@ -681,7 +707,10 @@ export class Client {
             const response = await this.caller.call(async () => {
                 const res = await this._fetch(`${this.apiUrl}${path}`, {
                     method: requestMethod,
-                    headers: { ...this.headers, "Content-Type": "application/json" },
+                    headers: {
+                        ...this._mergedHeaders,
+                        "Content-Type": "application/json",
+                    },
                     signal: AbortSignal.timeout(this.timeout_ms),
                     ...this.fetchOptions,
                     body,
@@ -1058,7 +1087,7 @@ export class Client {
             return;
         }
         const headers = {
-            ...this.headers,
+            ...this._mergedHeaders,
             "Content-Type": "application/json",
         };
         const session_name = run.project_name;
@@ -1165,7 +1194,7 @@ export class Client {
     }
     async _postBatchIngestRuns(body, options) {
         const headers = {
-            ...this.headers,
+            ...this._mergedHeaders,
             "Content-Type": "application/json",
             Accept: "application/json",
         };
@@ -1389,7 +1418,7 @@ export class Client {
             return this.batchIngestCaller.callWithOptions({ sizeBytes: options?.sizeBytes }, async () => {
                 const body = await bodyFactory();
                 const headers = {
-                    ...this.headers,
+                    ...this._mergedHeaders,
                     "Content-Type": `multipart/form-data; boundary=${boundary}`,
                 };
                 if (options?.apiKey !== undefined) {
@@ -1500,7 +1529,7 @@ export class Client {
             return;
         }
         const headers = {
-            ...this.headers,
+            ...this._mergedHeaders,
             "Content-Type": "application/json",
         };
         if (options?.apiKey !== undefined) {
@@ -1786,7 +1815,10 @@ export class Client {
             const response = await this.caller.call(async () => {
                 const res = await this._fetch(url, {
                     method: "POST",
-                    headers: { ...this.headers, "Content-Type": "application/json" },
+                    headers: {
+                        ...this._mergedHeaders,
+                        "Content-Type": "application/json",
+                    },
                     signal: AbortSignal.timeout(this.timeout_ms),
                     ...this.fetchOptions,
                     body,
@@ -1962,7 +1994,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/runs/stats`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -1983,7 +2015,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/runs/${runId}/share`, {
                 method: "PUT",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -2002,7 +2034,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/runs/${runId}/share`, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2015,7 +2047,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/runs/${runId}/share`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2041,7 +2073,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/public/${shareToken}/runs${queryParams}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2063,7 +2095,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${datasetId}/share`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2090,7 +2122,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${datasetId}/share`, {
                 method: "PUT",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -2107,7 +2139,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${datasetId}/share`, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2120,7 +2152,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/public/${shareToken}/datasets`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2155,7 +2187,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/public/${shareToken}/examples?${urlParams.toString()}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2195,7 +2227,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(endpoint, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: serializedBody,
@@ -2221,7 +2253,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(endpoint, {
                 method: "PATCH",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -2252,7 +2284,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}${path}?${params}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2392,7 +2424,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/sessions/${projectId_}`, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2423,7 +2455,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(url, {
                 method: "POST",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: formData,
@@ -2453,7 +2485,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: serializedBody,
@@ -2589,7 +2621,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${_datasetId}`, {
                 method: "PATCH",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -2628,7 +2660,10 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${_datasetId}/tags`, {
                 method: "PUT",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: {
+                    ...this._mergedHeaders,
+                    "Content-Type": "application/json",
+                },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -2657,7 +2692,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(this.apiUrl + path, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2665,90 +2700,6 @@ export class Client {
             return res;
         });
     }
-    async indexDataset({ datasetId, datasetName, tag, }) {
-        let datasetId_ = datasetId;
-        if (!datasetId_ && !datasetName) {
-            throw new Error("Must provide either datasetName or datasetId");
-        }
-        else if (datasetId_ && datasetName) {
-            throw new Error("Must provide either datasetName or datasetId, not both");
-        }
-        else if (!datasetId_) {
-            const dataset = await this.readDataset({ datasetName });
-            datasetId_ = dataset.id;
-        }
-        assertUuid(datasetId_);
-        const data = {
-            tag: tag,
-        };
-        const body = JSON.stringify(data);
-        const response = await this.caller.call(async () => {
-            const res = await this._fetch(`${this.apiUrl}/datasets/${datasetId_}/index`, {
-                method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
-                signal: AbortSignal.timeout(this.timeout_ms),
-                ...this.fetchOptions,
-                body,
-            });
-            await raiseForStatus(res, "index dataset");
-            return res;
-        });
-        await response.json();
-    }
-    /**
-     * Lets you run a similarity search query on a dataset.
-     *
-     * Requires the dataset to be indexed. Please see the `indexDataset` method to set up indexing.
-     *
-     * @param inputs      The input on which to run the similarity search. Must have the
-     *                    same schema as the dataset.
-     *
-     * @param datasetId   The dataset to search for similar examples.
-     *
-     * @param limit       The maximum number of examples to return. Will return the top `limit` most
-     *                    similar examples in order of most similar to least similar. If no similar
-     *                    examples are found, random examples will be returned.
-     *
-     * @param filter      A filter string to apply to the search. Only examples will be returned that
-     *                    match the filter string. Some examples of filters
-     *
-     *                    - eq(metadata.mykey, "value")
-     *                    - and(neq(metadata.my.nested.key, "value"), neq(metadata.mykey, "value"))
-     *                    - or(eq(metadata.mykey, "value"), eq(metadata.mykey, "othervalue"))
-     *
-     * @returns           A list of similar examples.
-     *
-     *
-     * @example
-     * dataset_id = "123e4567-e89b-12d3-a456-426614174000"
-     * inputs = {"text": "How many people live in Berlin?"}
-     * limit = 5
-     * examples = await client.similarExamples(inputs, dataset_id, limit)
-     */
-    async similarExamples(inputs, datasetId, limit, { filter, } = {}) {
-        const data = {
-            limit: limit,
-            inputs: inputs,
-        };
-        if (filter !== undefined) {
-            data["filter"] = filter;
-        }
-        assertUuid(datasetId);
-        const body = JSON.stringify(data);
-        const response = await this.caller.call(async () => {
-            const res = await this._fetch(`${this.apiUrl}/datasets/${datasetId}/search`, {
-                headers: { ...this.headers, "Content-Type": "application/json" },
-                signal: AbortSignal.timeout(this.timeout_ms),
-                ...this.fetchOptions,
-                method: "POST",
-                body,
-            });
-            await raiseForStatus(res, "fetch similar examples");
-            return res;
-        });
-        const result = await response.json();
-        return result["examples"];
-    }
     async createExample(inputsOrUpdate, outputs, options) {
         if (isExampleCreate(inputsOrUpdate)) {
             if (outputs !== undefined || options !== undefined) {
@@ -2960,7 +2911,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(this.apiUrl + path, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -2983,7 +2934,10 @@ export class Client {
             await this.caller.call(async () => {
                 const res = await this._fetch(`${this.apiUrl}${path}`, {
                     method: "POST",
-                    headers: { ...this.headers, "Content-Type": "application/json" },
+                    headers: {
+                        ...this._mergedHeaders,
+                        "Content-Type": "application/json",
+                    },
                     body: JSON.stringify({
                         example_ids: exampleIds,
                         hard_delete: true,
@@ -3002,7 +2956,7 @@ export class Client {
             await this.caller.call(async () => {
                 const res = await this._fetch(`${this.apiUrl}/examples?${params.toString()}`, {
                     method: "DELETE",
-                    headers: this.headers,
+                    headers: this._mergedHeaders,
                     signal: AbortSignal.timeout(this.timeout_ms),
                     ...this.fetchOptions,
                 });
@@ -3084,7 +3038,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${resolvedDatasetId}/version?${params.toString()}`, {
                 method: "GET",
-                headers: { ...this.headers },
+                headers: { ...this._mergedHeaders },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3149,7 +3103,10 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/${datasetId_}/splits`, {
                 method: "PUT",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: {
+                    ...this._mergedHeaders,
+                    "Content-Type": "application/json",
+                },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -3197,7 +3154,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(url, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -3226,7 +3183,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/feedback/${feedbackId}`, {
                 method: "PATCH",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -3247,7 +3204,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(this.apiUrl + path, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3315,7 +3272,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/feedback/tokens`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: serializedBody,
@@ -3352,7 +3309,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets/comparative`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: serializedBody,
@@ -3446,7 +3403,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/feedback-configs`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: JSON.stringify(body),
@@ -3503,7 +3460,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/feedback-configs`, {
                 method: "PATCH",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: JSON.stringify(body),
@@ -3522,7 +3479,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/feedback-configs?${params}`, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3585,7 +3542,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: serializedBody,
@@ -3604,7 +3561,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${assertUuid(queueId, "queueId")}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3635,7 +3592,10 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${assertUuid(queueId, "queueId")}`, {
                 method: "PATCH",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: {
+                    ...this._mergedHeaders,
+                    "Content-Type": "application/json",
+                },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -3652,7 +3612,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${assertUuid(queueId, "queueId")}`, {
                 method: "DELETE",
-                headers: { ...this.headers, Accept: "application/json" },
+                headers: { ...this._mergedHeaders, Accept: "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3670,7 +3630,10 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${assertUuid(queueId, "queueId")}/runs`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: {
+                    ...this._mergedHeaders,
+                    "Content-Type": "application/json",
+                },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -3691,7 +3654,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}${baseUrl}/${index}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3710,7 +3673,7 @@ export class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${assertUuid(queueId, "queueId")}/runs/${assertUuid(queueRunId, "queueRunId")}`, {
                 method: "DELETE",
-                headers: { ...this.headers, Accept: "application/json" },
+                headers: { ...this._mergedHeaders, Accept: "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3726,7 +3689,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${assertUuid(queueId, "queueId")}/size`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3749,7 +3712,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/commits/${promptOwnerAndName}/?limit=${1}&offset=${0}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3768,7 +3731,10 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/likes/${owner}/${promptName}`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: {
+                    ...this._mergedHeaders,
+                    "Content-Type": "application/json",
+                },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -3938,7 +3904,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/repos/${owner}/${promptName}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -4006,7 +3972,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/repos/`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: { ...this._mergedHeaders, "Content-Type": "application/json" },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -4057,12 +4023,18 @@ export class Client {
         const payload = {
             manifest: JSON.parse(JSON.stringify(object)),
             parent_commit: resolvedParentCommitHash,
+            ...(options?.description !== undefined && {
+                description: options.description,
+            }),
         };
         const body = JSON.stringify(payload);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/commits/${owner}/${promptName}`, {
                 method: "POST",
-                headers: { ...this.headers, "Content-Type": "application/json" },
+                headers: {
+                    ...this._mergedHeaders,
+                    "Content-Type": "application/json",
+                },
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body,
@@ -4145,7 +4117,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}${this._getPlatformEndpointPath(`datasets/${datasetIdToUse}/examples`)}`, {
                 method: "PATCH",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: formData,
@@ -4228,7 +4200,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}${this._getPlatformEndpointPath(`datasets/${datasetId}/examples`)}`, {
                 method: "POST",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
                 body: formData,
@@ -4266,7 +4238,7 @@ export class Client {
             const res = await this._fetch(`${this.apiUrl}/repos/${owner}/${promptName}`, {
                 method: "PATCH",
                 headers: {
-                    ...this.headers,
+                    ...this._mergedHeaders,
                     "Content-Type": "application/json",
                 },
                 signal: AbortSignal.timeout(this.timeout_ms),
@@ -4289,7 +4261,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/repos/${owner}/${promptName}`, {
                 method: "DELETE",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -4314,7 +4286,7 @@ export class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/commits/${owner}/${promptName}/${commitHash}${options?.includeModel ? "?include_model=true" : ""}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -4386,6 +4358,7 @@ export class Client {
         // Create a commit with the new manifest
         const url = await this.createCommit(promptIdentifier, options?.object, {
             parentCommitHash: options?.parentCommitHash,
+            description: options?.commitDescription,
         });
         return url;
     }