🌿 Fern Regeneration -- January 23, 2026

.fern/metadata.json

@@ -23,7 +23,7 @@
             "@types/convict": "^6.1.6"
         },
         "extraDependencies": {
-            "readable-stream": "^4.5.2",
+            "readable-stream": "^4.7.0",
             "@aws-sdk/client-sagemaker": "^3.583.0",
             "@aws-sdk/credential-providers": "^3.583.0",
             "@aws-crypto/sha256-js": "^5.2.0",

package.json

@@ -1,6 +1,6 @@
 {
     "name": "cohere-ai",
-    "version": "7.20.0",
+    "version": "7.20.1",
     "private": false,
     "repository": "github:cohere-ai/cohere-typescript",
     "main": "./index.js",
@@ -19,29 +19,29 @@
         "test:wire": "vitest --project wire"
     },
     "dependencies": {
-        "@aws-crypto/sha256-js": "^5.2.0",
+        "readable-stream": "^4.7.0",
         "@aws-sdk/client-sagemaker": "^3.583.0",
         "@aws-sdk/credential-providers": "^3.583.0",
+        "@aws-crypto/sha256-js": "^5.2.0",
         "@smithy/protocol-http": "^5.1.2",
         "@smithy/signature-v4": "^5.1.2",
         "convict": "^6.2.4",
         "form-data": "^4.0.4",
         "form-data-encoder": "^4.1.0",
-        "formdata-node": "^6.0.3",
-        "readable-stream": "^4.7.0"
+        "formdata-node": "^6.0.3"
     },
     "devDependencies": {
-        "@biomejs/biome": "2.3.1",
-        "@types/convict": "^6.1.6",
+        "webpack": "^5.91.0",
+        "ts-loader": "^9.5.1",
+        "vitest": "^3.2.4",
+        "msw": "2.11.2",
         "@types/node": "^18.19.70",
-        "@types/readable-stream": "^4.0.14",
+        "typescript": "~5.7.2",
+        "@biomejs/biome": "2.3.1",
         "jest": "^29.7.0",
-        "msw": "2.11.2",
         "ts-jest": "^29.1.2",
-        "ts-loader": "^9.5.1",
-        "typescript": "~5.7.2",
-        "vitest": "^3.2.4",
-        "webpack": "^5.91.0"
+        "@types/readable-stream": "^4.0.14",
+        "@types/convict": "^6.1.6"
     },
     "browser": {
         "fs": false,

reference.md

@@ -304,7 +304,7 @@ await client.v2.rerank({
     documents: ["Carson City is the capital city of the American state of Nevada.", "The Commonwealth of the Northern Mariana Islands is a group of islands in the Pacific Ocean. Its capital is Saipan.", "Capitalization or capitalisation in English grammar is the use of a capital letter at the start of a word. English usage varies from capitalization in other languages.", "Washington, D.C. (also known as simply Washington or D.C., and officially as the District of Columbia) is the capital of the United States. It is a federal district.", "Capital punishment has existed in the United States since beforethe United States was a country. As of 2017, capital punishment is legal in 30 of the 50 states."],
     query: "What is the capital of the United States?",
     topN: 3,
-    model: "rerank-v3.5"
+    model: "rerank-v4.0-pro"
 });
 
 ```

src/Client.ts

@@ -40,8 +40,8 @@ export class CohereClient {
                     "X-Client-Name": _options?.clientName,
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "cohere-ai",
-                    "X-Fern-SDK-Version": "7.20.0",
-                    "User-Agent": "cohere-ai/7.20.0",
+                    "X-Fern-SDK-Version": "7.20.1",
+                    "User-Agent": "cohere-ai/7.20.1",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
@@ -833,7 +833,7 @@ export class CohereClient {
      *             }],
      *         query: "What is the capital of the United States?",
      *         topN: 3,
-     *         model: "rerank-v3.5"
+     *         model: "rerank-v4.0-pro"
      *     })
      */
     public rerank(

src/api/client/requests/RerankRequest.ts

@@ -18,7 +18,7 @@ import type * as Cohere from "../../index";
  *             }],
  *         query: "What is the capital of the United States?",
  *         topN: 3,
- *         model: "rerank-v3.5"
+ *         model: "rerank-v4.0-pro"
  *     }
  */
 export interface RerankRequest {

src/api/resources/v2/client/Client.ts

@@ -553,7 +553,7 @@ export class V2 {
      *         documents: ["Carson City is the capital city of the American state of Nevada.", "The Commonwealth of the Northern Mariana Islands is a group of islands in the Pacific Ocean. Its capital is Saipan.", "Capitalization or capitalisation in English grammar is the use of a capital letter at the start of a word. English usage varies from capitalization in other languages.", "Washington, D.C. (also known as simply Washington or D.C., and officially as the District of Columbia) is the capital of the United States. It is a federal district.", "Capital punishment has existed in the United States since beforethe United States was a country. As of 2017, capital punishment is legal in 30 of the 50 states."],
      *         query: "What is the capital of the United States?",
      *         topN: 3,
-     *         model: "rerank-v3.5"
+     *         model: "rerank-v4.0-pro"
      *     })
      */
     public rerank(

src/api/resources/v2/client/requests/V2ChatRequest.ts

@@ -195,9 +195,6 @@ export interface V2ChatRequest {
      */
     toolChoice?: Cohere.V2ChatRequestToolChoice;
     thinking?: Cohere.Thinking;
-    /**
-     * The priority of the request (lower means earlier handling; default 0 highest priority).
-     * Higher priority requests are handled first, and dropped last when the system is under load.
-     */
+    /** Controls how early the request is handled. Lower numbers indicate higher priority (default: 0, the highest). When the system is under load, higher-priority requests are processed first and are the least likely to be dropped. */
     priority?: number;
 }

src/api/resources/v2/client/requests/V2ChatStreamRequest.ts

@@ -187,9 +187,6 @@ export interface V2ChatStreamRequest {
      */
     toolChoice?: Cohere.V2ChatStreamRequestToolChoice;
     thinking?: Cohere.Thinking;
-    /**
-     * The priority of the request (lower means earlier handling; default 0 highest priority).
-     * Higher priority requests are handled first, and dropped last when the system is under load.
-     */
+    /** Controls how early the request is handled. Lower numbers indicate higher priority (default: 0, the highest). When the system is under load, higher-priority requests are processed first and are the least likely to be dropped. */
     priority?: number;
 }

src/api/resources/v2/client/requests/V2EmbedRequest.ts

@@ -61,9 +61,6 @@ export interface V2EmbedRequest {
      * If `NONE` is selected, when the input exceeds the maximum input token length an error will be returned.
      */
     truncate?: Cohere.V2EmbedRequestTruncate;
-    /**
-     * The priority of the request (lower means earlier handling; default 0 highest priority).
-     * Higher priority requests are handled first, and dropped last when the system is under load.
-     */
+    /** Controls how early the request is handled. Lower numbers indicate higher priority (default: 0, the highest). When the system is under load, higher-priority requests are processed first and are the least likely to be dropped. */
     priority?: number;
 }

src/api/resources/v2/client/requests/V2RerankRequest.ts

@@ -6,7 +6,7 @@
  *         documents: ["Carson City is the capital city of the American state of Nevada.", "The Commonwealth of the Northern Mariana Islands is a group of islands in the Pacific Ocean. Its capital is Saipan.", "Capitalization or capitalisation in English grammar is the use of a capital letter at the start of a word. English usage varies from capitalization in other languages.", "Washington, D.C. (also known as simply Washington or D.C., and officially as the District of Columbia) is the capital of the United States. It is a federal district.", "Capital punishment has existed in the United States since beforethe United States was a country. As of 2017, capital punishment is legal in 30 of the 50 states."],
  *         query: "What is the capital of the United States?",
  *         topN: 3,
- *         model: "rerank-v3.5"
+ *         model: "rerank-v4.0-pro"
  *     }
  */
 export interface V2RerankRequest {
@@ -27,9 +27,6 @@ export interface V2RerankRequest {
     topN?: number;
     /** Defaults to `4096`. Long documents will be automatically truncated to the specified number of tokens. */
     maxTokensPerDoc?: number;
-    /**
-     * The priority of the request (lower means earlier handling; default 0 highest priority).
-     * Higher priority requests are handled first, and dropped last when the system is under load.
-     */
+    /** Controls how early the request is handled. Lower numbers indicate higher priority (default: 0, the highest). When the system is under load, higher-priority requests are processed first and are the least likely to be dropped. */
     priority?: number;
 }

src/api/types/ApiMetaBilledUnits.ts

@@ -5,6 +5,8 @@ export interface ApiMetaBilledUnits {
     images?: number;
     /** The number of billed input tokens. */
     inputTokens?: number;
+    /** The number of billed image tokens. */
+    imageTokens?: number;
     /** The number of billed output tokens. */
     outputTokens?: number;
     /** The number of billed search units. */

src/core/schemas/builders/primitives/never.ts

@@ -1,5 +1,5 @@
-import { type Schema, SchemaType } from "../../Schema";
-import { createIdentitySchemaCreator } from "../../utils/createIdentitySchemaCreator";
+import { type Schema, SchemaType } from "../../Schema.js";
+import { createIdentitySchemaCreator } from "../../utils/createIdentitySchemaCreator.js";
 
 export const never: () => Schema<never, never> = createIdentitySchemaCreator<never>(
     SchemaType.NEVER,

src/serialization/types/ApiMetaBilledUnits.ts

@@ -10,6 +10,7 @@ export const ApiMetaBilledUnits: core.serialization.ObjectSchema<
 > = core.serialization.object({
     images: core.serialization.number().optional(),
     inputTokens: core.serialization.property("input_tokens", core.serialization.number().optional()),
+    imageTokens: core.serialization.property("image_tokens", core.serialization.number().optional()),
     outputTokens: core.serialization.property("output_tokens", core.serialization.number().optional()),
     searchUnits: core.serialization.property("search_units", core.serialization.number().optional()),
     classifications: core.serialization.number().optional(),
@@ -19,6 +20,7 @@ export declare namespace ApiMetaBilledUnits {
     export interface Raw {
         images?: number | null;
         input_tokens?: number | null;
+        image_tokens?: number | null;
         output_tokens?: number | null;
         search_units?: number | null;
         classifications?: number | null;

src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "7.20.0";
+export const SDK_VERSION = "7.20.1";

tests/wire/datasets.test.ts

@@ -369,6 +369,7 @@
 
         const rawResponseBody = {
             dataset: {
+                parse_info: { separator: "separator", delimiter: "delimiter" },
                 id: "id",
                 name: "name",
                 created_at: "2024-01-15T09:30:00Z",
@@ -386,7 +387,7 @@
         server.mockEndpoint().get("/v1/datasets/id").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
 
         const response = await client.datasets.get("id");
         expect(response).toEqual({
             dataset: {
                 id: "id",
                 name: "name",

tests/wire/embedJobs.test.ts

@@ -197,6 +197,7 @@ describe("EmbedJobs", () => {
                 billed_units: {
                     images: 1.1,
                     input_tokens: 1.1,
+                    image_tokens: 1.1,
                     output_tokens: 1.1,
                     search_units: 1.1,
                     classifications: 1.1,
@@ -231,6 +232,7 @@ describe("EmbedJobs", () => {
                 billedUnits: {
                     images: 1.1,
                     inputTokens: 1.1,
+                    imageTokens: 1.1,
                     outputTokens: 1.1,
                     searchUnits: 1.1,
                     classifications: 1.1,
@@ -539,6 +541,7 @@ describe("EmbedJobs", () => {
                 billed_units: {
                     images: 1.1,
                     input_tokens: 1.1,
+                    image_tokens: 1.1,
                     output_tokens: 1.1,
                     search_units: 1.1,
                     classifications: 1.1,
@@ -569,6 +572,7 @@ describe("EmbedJobs", () => {
                 billedUnits: {
                     images: 1.1,
                     inputTokens: 1.1,
+                    imageTokens: 1.1,
                     outputTokens: 1.1,
                     searchUnits: 1.1,
                     classifications: 1.1,

tests/wire/main.test.ts

@@ -2295,7 +2295,7 @@ describe("CohereClient", () => {
             ],
             query: "What is the capital of the United States?",
             top_n: 3,
-            model: "rerank-v3.5",
+            model: "rerank-v4.0-pro",
         };
         const rawResponseBody = {
             id: "8bc745a3-7871-4597-822e-18c95d5df48c",
@@ -2335,7 +2335,7 @@ describe("CohereClient", () => {
             ],
             query: "What is the capital of the United States?",
             topN: 3,
-            model: "rerank-v3.5",
+            model: "rerank-v4.0-pro",
         });
         expect(response).toEqual({
             id: "8bc745a3-7871-4597-822e-18c95d5df48c",

tests/wire/v2.test.ts

@@ -1580,7 +1580,7 @@ describe("V2", () => {
             meta: {
                 api_version: { version: "2", is_experimental: true },
                 warnings: [
-                    "You are using an experimental version, for more information please refer to https://docs.cohere.com/versioning-reference",
+                    "You are using an experimental version, for more information please refer to https://docs.cohere.com/reference/about",
                 ],
                 billed_units: { input_tokens: 2 },
             },
@@ -1913,7 +1913,7 @@ describe("V2", () => {
                     isExperimental: true,
                 },
                 warnings: [
-                    "You are using an experimental version, for more information please refer to https://docs.cohere.com/versioning-reference",
+                    "You are using an experimental version, for more information please refer to https://docs.cohere.com/reference/about",
                 ],
                 billedUnits: {
                     inputTokens: 2,
@@ -2563,7 +2563,7 @@ describe("V2", () => {
             ],
             query: "What is the capital of the United States?",
             top_n: 3,
-            model: "rerank-v3.5",
+            model: "rerank-v4.0-pro",
         };
         const rawResponseBody = {
             id: "07734bd2-2473-4f07-94e1-0d9f0e6843cf",
@@ -2593,7 +2593,7 @@ describe("V2", () => {
             ],
             query: "What is the capital of the United States?",
             topN: 3,
-            model: "rerank-v3.5",
+            model: "rerank-v4.0-pro",
         });
         expect(response).toEqual({
             id: "07734bd2-2473-4f07-94e1-0d9f0e6843cf",