langsmith 0.5.15 → 0.5.17

package/dist/client.cjs

@@ -468,6 +468,12 @@ 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,
@@ -564,6 +570,8 @@ class Client {
             // Use the global singleton instance
             this._promptCache = index_js_2.promptCacheSingleton;
         }
+        // Initialize custom headers
+        this._customHeaders = config.headers ?? {};
     }
     static getDefaultClientConfig() {
         const apiKey = (0, env_js_1.getLangSmithEnvironmentVariable)("API_KEY");
@@ -603,6 +611,10 @@ 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;
@@ -612,10 +624,13 @@ 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/${index_js_1.__version__}`,
+            ...this._customHeaders,
         };
+        // Required headers that should not be overridden
         if (this.apiKey) {
             headers["x-api-key"] = `${this.apiKey}`;
         }
@@ -624,6 +639,17 @@ 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/";
@@ -669,7 +695,7 @@ 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,
             });
@@ -692,7 +718,7 @@ 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,
                 });
@@ -719,7 +745,10 @@ 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,
@@ -1096,7 +1125,7 @@ class Client {
             return;
         }
         const headers = {
-            ...this.headers,
+            ...this._mergedHeaders,
             "Content-Type": "application/json",
         };
         const session_name = run.project_name;
@@ -1203,7 +1232,7 @@ class Client {
     }
     async _postBatchIngestRuns(body, options) {
         const headers = {
-            ...this.headers,
+            ...this._mergedHeaders,
             "Content-Type": "application/json",
             Accept: "application/json",
         };
@@ -1427,7 +1456,7 @@ 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) {
@@ -1538,7 +1567,7 @@ class Client {
             return;
         }
         const headers = {
-            ...this.headers,
+            ...this._mergedHeaders,
             "Content-Type": "application/json",
         };
         if (options?.apiKey !== undefined) {
@@ -1824,7 +1853,10 @@ 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,
@@ -2000,7 +2032,7 @@ 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,
@@ -2021,7 +2053,7 @@ 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,
@@ -2040,7 +2072,7 @@ 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,
             });
@@ -2053,7 +2085,7 @@ 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,
             });
@@ -2079,7 +2111,7 @@ 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,
             });
@@ -2101,7 +2133,7 @@ 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,
             });
@@ -2128,7 +2160,7 @@ 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,
@@ -2145,7 +2177,7 @@ 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,
             });
@@ -2158,7 +2190,7 @@ 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,
             });
@@ -2193,7 +2225,7 @@ 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,
             });
@@ -2233,7 +2265,7 @@ 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,
@@ -2259,7 +2291,7 @@ 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,
@@ -2290,7 +2322,7 @@ 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,
             });
@@ -2430,7 +2462,7 @@ 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,
             });
@@ -2461,7 +2493,7 @@ 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,
@@ -2491,7 +2523,7 @@ 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,
@@ -2627,7 +2659,7 @@ 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,
@@ -2666,7 +2698,10 @@ 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,
@@ -2695,7 +2730,7 @@ 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,
             });
@@ -2703,90 +2738,6 @@ 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;
-        }
-        (0, _uuid_js_1.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 (0, error_js_1.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;
-        }
-        (0, _uuid_js_1.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 (0, error_js_1.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) {
@@ -2998,7 +2949,7 @@ 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,
             });
@@ -3021,7 +2972,10 @@ 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,
@@ -3040,7 +2994,7 @@ 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,
                 });
@@ -3122,7 +3076,7 @@ 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,
             });
@@ -3187,7 +3141,10 @@ 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,
@@ -3235,7 +3192,7 @@ 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,
@@ -3264,7 +3221,7 @@ 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,
@@ -3285,7 +3242,7 @@ 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,
             });
@@ -3353,7 +3310,7 @@ 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,
@@ -3390,7 +3347,7 @@ 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,
@@ -3484,7 +3441,7 @@ 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),
@@ -3541,7 +3498,7 @@ 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),
@@ -3560,7 +3517,7 @@ 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,
             });
@@ -3623,7 +3580,7 @@ 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,
@@ -3642,7 +3599,7 @@ class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.assertUuid)(queueId, "queueId")}`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3673,7 +3630,10 @@ class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.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,
@@ -3690,7 +3650,7 @@ class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.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,
             });
@@ -3708,7 +3668,10 @@ class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.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,
@@ -3729,7 +3692,7 @@ 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,
             });
@@ -3748,7 +3711,7 @@ class Client {
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.assertUuid)(queueId, "queueId")}/runs/${(0, _uuid_js_1.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,
             });
@@ -3764,7 +3727,7 @@ class Client {
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.assertUuid)(queueId, "queueId")}/size`, {
                 method: "GET",
-                headers: this.headers,
+                headers: this._mergedHeaders,
                 signal: AbortSignal.timeout(this.timeout_ms),
                 ...this.fetchOptions,
             });
@@ -3787,7 +3750,7 @@ 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,
             });
@@ -3806,7 +3769,10 @@ 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,
@@ -3976,7 +3942,7 @@ 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,
             });
@@ -4044,7 +4010,7 @@ 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,
@@ -4095,12 +4061,18 @@ 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,
@@ -4183,7 +4155,7 @@ 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,
@@ -4266,7 +4238,7 @@ 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,
@@ -4304,7 +4276,7 @@ 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),
@@ -4327,7 +4299,7 @@ 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,
             });
@@ -4352,7 +4324,7 @@ 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,
             });
@@ -4424,6 +4396,7 @@ 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;
     }