chromadb 3.4.2 → 3.5.0

package/dist/cjs/chromadb.d.cts

@@ -55,8 +55,21 @@ type FloatListValueType$1 = {
 type FloatValueType$1 = {
     float_inverted_index?: null | FloatInvertedIndexType$1;
 };
+/**
+ * Full-text search index algorithm.
+ *
+ * Controls which index format and query pipeline are used for
+ * document substring search within a collection.
+ */
+type FtsAlgorithm = 'trigram' | 'token_bitmap';
 type FtsIndexConfig$1 = {
-    [key: string]: never;
+    /**
+     * FTS index algorithm.
+     * Omitted from JSON when set to the default (Trigram) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: FtsAlgorithm;
 };
 type FtsIndexType$1 = {
     config: FtsIndexConfig$1;
@@ -209,10 +222,6 @@ type Schema$1 = {
     keys: {
         [key: string]: ValueTypes$1;
     };
-    /**
-     * ID of the attached function that created this output collection (if applicable)
-     */
-    source_attached_function_id?: string | null;
 };
 type SearchPayload = {
     filter?: {
@@ -284,6 +293,13 @@ type SpannIndexConfig = {
     write_rng_epsilon?: number | null;
     write_rng_factor?: number | null;
 };
+/**
+ * Sparse vector index algorithm.
+ *
+ * Controls which posting list format and query engine are used for
+ * sparse vector search within a collection.
+ */
+type SparseIndexAlgorithm = 'wand' | 'max_score';
 /**
  * Represents a sparse vector using parallel arrays for indices and values.
  *
@@ -307,6 +323,13 @@ type SparseVector = {
     values: Array<number>;
 };
 type SparseVectorIndexConfig$1 = {
+    /**
+     * Sparse index algorithm (cloud-only, tenant-gated).
+     * Omitted from JSON when set to the default (Wand) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: SparseIndexAlgorithm;
     /**
      * Whether this embedding is BM25
      */
@@ -396,10 +419,13 @@ type UserIdentity = GetUserIdentityResponse;
  *   All committed writes will be visible. This is the default.
  * - INDEX_ONLY: Read only from the compacted index, skipping the WAL.
  *   Recent writes that haven't been compacted may not be visible, but queries are faster.
+ * - INDEX_AND_BOUNDED_WAL: Read from the index and up to a server-configured number of
+ *   WAL entries for bounded query latency.
  */
 declare const ReadLevel: {
     readonly INDEX_AND_WAL: "index_and_wal";
     readonly INDEX_ONLY: "index_only";
+    readonly INDEX_AND_BOUNDED_WAL: "index_and_bounded_wal";
 };
 type ReadLevel = (typeof ReadLevel)[keyof typeof ReadLevel];
 
@@ -1290,7 +1316,6 @@ declare class Schema {
     private setIndexForKey;
     private enableAllIndexesForKey;
     private disableAllIndexesForKey;
-    private validateSingleSparseVectorIndex;
     private validateSparseVectorConfig;
     private initializeDefaults;
     private initializeKeys;
@@ -1492,6 +1517,13 @@ declare class ChromaClient {
      * @throws Error if the collection does not exist
      */
     getCollectionByCrn(crn: string): Promise<Collection>;
+    /**
+     * Retrieves an existing collection by its ID.
+     * @param id - The UUID of the collection to retrieve
+     * @returns Promise resolving to the Collection instance
+     * @throws Error if the collection does not exist
+     */
+    getCollectionById(id: string): Promise<Collection>;
     /**
      * Retrieves multiple collections by name.
      * @param items - Array of collection names or objects with name and optional embedding function (should match the ones used to create the collections)
@@ -1594,6 +1626,7 @@ interface Collection {
          * Controls whether to read from the write-ahead log.
          * - ReadLevel.INDEX_AND_WAL: Read from both index and WAL (default)
          * - ReadLevel.INDEX_ONLY: Read only from index, faster but recent writes may not be visible
+         * - ReadLevel.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
          */
         readLevel?: ReadLevel;
     }): Promise<number>;
@@ -1747,6 +1780,7 @@ interface Collection {
          * Controls whether to read from the write-ahead log.
          * - ReadLevel.INDEX_AND_WAL: Read from both index and WAL (default)
          * - ReadLevel.INDEX_ONLY: Read only from index, faster but recent writes may not be visible
+         * - ReadLevel.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
          */
         readLevel?: ReadLevel;
     }): Promise<SearchResult>;

package/dist/cjs/cli.cjs

@@ -104,6 +104,9 @@ var main = async () => {
     await update();
     return;
   }
+  process.on("SIGINT", () => {
+    process.exit(0);
+  });
   bindings_default.cli(["chroma", ...args]);
 };
 main().finally();

package/dist/cjs/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli.ts","../../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oBAAmB;;;ACDnB,oBAA8B;AAC9B,gBAAe;AADf;AAGA,IAAMA,eAAU,6BAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,UAAAC,QAAG,SAAS;AAC7B,IAAM,OAAO,UAAAA,QAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUD,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,cAAAE,QAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require","os","semver"]}
+{"version":3,"sources":["../../src/cli.ts","../../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  process.on(\"SIGINT\", () => {\n    process.exit(0);\n  });\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oBAAmB;;;ACDnB,oBAA8B;AAC9B,gBAAe;AADf;AAGA,IAAMA,eAAU,6BAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,UAAAC,QAAG,SAAS;AAC7B,IAAM,OAAO,UAAAA,QAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUD,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,cAAAE,QAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,UAAQ,GAAG,UAAU,MAAM;AACzB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require","os","semver"]}

package/dist/cli.mjs

@@ -81,6 +81,9 @@ var main = async () => {
     await update();
     return;
   }
+  process.on("SIGINT", () => {
+    process.exit(0);
+  });
   bindings_default.cli(["chroma", ...args]);
 };
 main().finally();

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;AACA,OAAO,YAAY;;;ACDnB,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AAEf,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,GAAG,SAAS;AAC7B,IAAM,OAAO,GAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,OAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require"]}
+{"version":3,"sources":["../src/cli.ts","../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  process.on(\"SIGINT\", () => {\n    process.exit(0);\n  });\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;AACA,OAAO,YAAY;;;ACDnB,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AAEf,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,GAAG,SAAS;AAC7B,IAAM,OAAO,GAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,OAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,UAAQ,GAAG,UAAU,MAAM;AACzB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromadb",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "description": "A JavaScript interface for chroma",
   "keywords": [
     "chroma",
@@ -30,10 +30,24 @@
     "src",
     "dist"
   ],
+  "scripts": {
+    "test": "jest --runInBand",
+    "test:functional": "jest --runInBand --testPathIgnorePatterns=test/auth.*.test.ts",
+    "test:update": "jest --runInBand --updateSnapshot",
+    "prebuild": "rimraf dist",
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "genapi": "node --loader ts-node/esm scripts/gen-api.ts",
+    "prettier": "prettier --write .",
+    "release": "run-s build test && npm publish",
+    "release_alpha": "run-s build test && npm publish --tag alpha",
+    "release_dev": "run-s build test && npm version ${NEW_VERSION} --no-git-tag-version && npm publish"
+  },
   "dependencies": {
     "semver": "^7.7.1"
   },
   "devDependencies": {
+    "@chroma-core/default-embed": "workspace:^",
     "@hey-api/client-fetch": "^0.10.0",
     "@hey-api/openapi-ts": "^0.67.3",
     "@jest/globals": "^29.7.0",
@@ -56,33 +70,19 @@
     "tsd": "^0.28.1",
     "tsup": "^8.3.5",
     "typescript": "^5.0.4",
-    "wait-on": "^8.0.3",
-    "@chroma-core/default-embed": "^0.1.9"
+    "wait-on": "^8.0.3"
   },
   "optionalDependencies": {
-    "chromadb-js-bindings-darwin-arm64": "^1.3.2",
-    "chromadb-js-bindings-darwin-x64": "^1.3.2",
-    "chromadb-js-bindings-linux-arm64-gnu": "^1.3.2",
-    "chromadb-js-bindings-linux-x64-gnu": "^1.3.2",
-    "chromadb-js-bindings-win32-x64-msvc": "^1.3.2"
+    "chromadb-js-bindings-darwin-arm64": "^1.3.4",
+    "chromadb-js-bindings-darwin-x64": "^1.3.4",
+    "chromadb-js-bindings-linux-arm64-gnu": "^1.3.4",
+    "chromadb-js-bindings-linux-x64-gnu": "^1.3.4",
+    "chromadb-js-bindings-win32-x64-msvc": "^1.3.4"
   },
   "engines": {
     "node": ">=20"
   },
   "bin": {
     "chroma": "dist/cli.mjs"
-  },
-  "scripts": {
-    "test": "jest --runInBand",
-    "test:functional": "jest --runInBand --testPathIgnorePatterns=test/auth.*.test.ts",
-    "test:update": "jest --runInBand --updateSnapshot",
-    "prebuild": "rimraf dist",
-    "build": "tsup",
-    "watch": "tsup --watch",
-    "genapi": "node --loader ts-node/esm scripts/gen-api.ts",
-    "prettier": "prettier --write .",
-    "release": "run-s build test && npm publish",
-    "release_alpha": "run-s build test && npm publish --tag alpha",
-    "release_dev": "run-s build test && npm version ${NEW_VERSION} --no-git-tag-version && npm publish"
   }
-}
+}

package/src/api/sdk.gen.ts

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { GetUserIdentityData, GetUserIdentityResponse2, GetUserIdentityError, GetCollectionByCrnData, GetCollectionByCrnResponse, GetCollectionByCrnError, HealthcheckData, HealthcheckResponse, HealthcheckError, HeartbeatData, HeartbeatResponse2, HeartbeatError, PreFlightChecksData, PreFlightChecksResponse, PreFlightChecksError, ResetData, ResetResponse, ResetError, CreateTenantData, CreateTenantResponse2, CreateTenantError, GetTenantData, GetTenantResponse2, GetTenantError, UpdateTenantData, UpdateTenantResponse2, UpdateTenantError, ListDatabasesData, ListDatabasesResponse, ListDatabasesError, CreateDatabaseData, CreateDatabaseResponse2, CreateDatabaseError, DeleteDatabaseData, DeleteDatabaseResponse2, DeleteDatabaseError, GetDatabaseData, GetDatabaseResponse, GetDatabaseError, ListCollectionsData, ListCollectionsResponse, ListCollectionsError, CreateCollectionData, CreateCollectionResponse, CreateCollectionError, DeleteCollectionData, DeleteCollectionResponse2, DeleteCollectionError, GetCollectionData, GetCollectionResponse, GetCollectionError, UpdateCollectionData, UpdateCollectionResponse2, UpdateCollectionError, CollectionAddData, CollectionAddResponse, DetachFunctionData, DetachFunctionResponse2, DetachFunctionError, CollectionCountData, CollectionCountResponse, CollectionCountError, CollectionDeleteData, CollectionDeleteResponse, CollectionDeleteError, ForkCollectionData, ForkCollectionResponse, ForkCollectionError, ForkCountData, ForkCountResponse2, ForkCountError, AttachFunctionData, AttachFunctionResponse2, AttachFunctionError, GetAttachedFunctionData, GetAttachedFunctionResponse2, GetAttachedFunctionError, CollectionGetData, CollectionGetResponse, CollectionGetError, IndexingStatusData, IndexingStatusResponse, IndexingStatusError, CollectionQueryData, CollectionQueryResponse, CollectionQueryError, CollectionSearchData, CollectionSearchResponse, CollectionSearchError, CollectionUpdateData, CollectionUpdateResponse, CollectionUpsertData, CollectionUpsertResponse, CollectionUpsertError, CountCollectionsData, CountCollectionsResponse, CountCollectionsError, VersionData, VersionResponse } from './types.gen';
+import type { GetUserIdentityData, GetUserIdentityResponse2, GetUserIdentityError, GetCollectionByCrnData, GetCollectionByCrnResponse, GetCollectionByCrnError, HealthcheckData, HealthcheckResponse, HealthcheckError, HeartbeatData, HeartbeatResponse2, HeartbeatError, PreFlightChecksData, PreFlightChecksResponse, PreFlightChecksError, ResetData, ResetResponse, ResetError, CreateTenantData, CreateTenantResponse2, CreateTenantError, GetTenantData, GetTenantResponse2, GetTenantError, UpdateTenantData, UpdateTenantResponse2, UpdateTenantError, ListDatabasesData, ListDatabasesResponse, ListDatabasesError, CreateDatabaseData, CreateDatabaseResponse2, CreateDatabaseError, DeleteDatabaseData, DeleteDatabaseResponse2, DeleteDatabaseError, GetDatabaseData, GetDatabaseResponse, GetDatabaseError, ListCollectionsData, ListCollectionsResponse, ListCollectionsError, CreateCollectionData, CreateCollectionResponse, CreateCollectionError, GetCollectionByIdData, GetCollectionByIdResponse, GetCollectionByIdError, DeleteCollectionData, DeleteCollectionResponse2, DeleteCollectionError, GetCollectionData, GetCollectionResponse, GetCollectionError, UpdateCollectionData, UpdateCollectionResponse2, UpdateCollectionError, CollectionAddData, CollectionAddResponse, AddAttachedFunctionInputData, AddAttachedFunctionInputResponse2, AddAttachedFunctionInputError, DetachFunctionData, DetachFunctionResponse2, DetachFunctionError, CollectionCountData, CollectionCountResponse, CollectionCountError, CollectionDeleteData, CollectionDeleteResponse, CollectionDeleteError, ForkCollectionData, ForkCollectionResponse, ForkCollectionError, ForkCountData, ForkCountResponse2, ForkCountError, AttachFunctionData, AttachFunctionResponse2, AttachFunctionError, GetAttachedFunctionData, GetAttachedFunctionResponse2, GetAttachedFunctionError, CollectionGetData, CollectionGetResponse, CollectionGetError, IndexingStatusData, IndexingStatusResponse, IndexingStatusError, CollectionQueryData, CollectionQueryResponse, CollectionQueryError, CollectionSearchData, CollectionSearchResponse, CollectionSearchError, CollectionUpdateData, CollectionUpdateResponse, CollectionUpsertData, CollectionUpsertResponse, CollectionUpsertError, CountCollectionsData, CountCollectionsResponse, CountCollectionsError, VersionData, VersionResponse } from './types.gen';
 import { client as _heyApiClient } from './client.gen';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
@@ -94,6 +94,23 @@ export class CollectionService {
         });
     }
     
+    /**
+     * Get collection by ID
+     * Returns a collection by its UUID within a specific tenant and database.
+     */
+    public static getCollectionById<ThrowOnError extends boolean = true>(options: Options<GetCollectionByIdData, ThrowOnError>) {
+        return (options.client ?? _heyApiClient).get<GetCollectionByIdResponse, GetCollectionByIdError, ThrowOnError>({
+            security: [
+                {
+                    name: 'x-chroma-token',
+                    type: 'apiKey'
+                }
+            ],
+            url: '/api/v2/tenants/{tenant}/databases/{database}/collections/by-id/{collection_id}',
+            ...options
+        });
+    }
+    
     /**
      * Delete collection
      * Deletes a collection in a database.
@@ -592,6 +609,27 @@ export class RecordService {
 }
 
 export class FunctionService {
+    /**
+     * Add attached function input
+     * Adds a new input collection to an existing async attached function.
+     */
+    public static addAttachedFunctionInput<ThrowOnError extends boolean = true>(options: Options<AddAttachedFunctionInputData, ThrowOnError>) {
+        return (options.client ?? _heyApiClient).post<AddAttachedFunctionInputResponse2, AddAttachedFunctionInputError, ThrowOnError>({
+            security: [
+                {
+                    name: 'x-chroma-token',
+                    type: 'apiKey'
+                }
+            ],
+            url: '/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/attached_functions/{name}/add_input',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers
+            }
+        });
+    }
+    
     /**
      * Detach function
      * Detaches a function from a collection.

package/src/api/types.gen.ts

@@ -1,5 +1,14 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
+export type AddAttachedFunctionInputRequest = {
+    input_collection_id: CollectionUuid;
+};
+
+export type AddAttachedFunctionInputResponse = {
+    attached_function: AttachedFunctionApiResponse;
+    created: boolean;
+};
+
 /**
  * Payload for adding records to a collection.
  *
@@ -270,8 +279,22 @@ export type ForkCountResponse = {
     count: number;
 };
 
+/**
+ * Full-text search index algorithm.
+ *
+ * Controls which index format and query pipeline are used for
+ * document substring search within a collection.
+ */
+export type FtsAlgorithm = 'trigram' | 'token_bitmap';
+
 export type FtsIndexConfig = {
-    [key: string]: never;
+    /**
+     * FTS index algorithm.
+     * Omitted from JSON when set to the default (Trigram) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: FtsAlgorithm;
 };
 
 export type FtsIndexType = {
@@ -478,7 +501,7 @@ export type RawWhereFields = {
     where_document?: unknown;
 };
 
-export type ReadLevel = 'index_and_wal' | 'index_only';
+export type ReadLevel = 'index_and_wal' | 'index_only' | 'index_and_bounded_wal';
 
 /**
  * Schema representation for collection index configurations
@@ -503,10 +526,6 @@ export type Schema = {
     keys: {
         [key: string]: ValueTypes;
     };
-    /**
-     * ID of the attached function that created this output collection (if applicable)
-     */
-    source_attached_function_id?: string | null;
 };
 
 export type SearchPayload = {
@@ -592,6 +611,14 @@ export type SpannIndexConfig = {
     write_rng_factor?: number | null;
 };
 
+/**
+ * Sparse vector index algorithm.
+ *
+ * Controls which posting list format and query engine are used for
+ * sparse vector search within a collection.
+ */
+export type SparseIndexAlgorithm = 'wand' | 'max_score';
+
 /**
  * Represents a sparse vector using parallel arrays for indices and values.
  *
@@ -616,6 +643,13 @@ export type SparseVector = {
 };
 
 export type SparseVectorIndexConfig = {
+    /**
+     * Sparse index algorithm (cloud-only, tenant-gated).
+     * Omitted from JSON when set to the default (Wand) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: SparseIndexAlgorithm;
     /**
      * Whether this embedding is BM25
      */
@@ -1307,6 +1341,52 @@ export type CreateCollectionResponses = {
 
 export type CreateCollectionResponse = CreateCollectionResponses[keyof CreateCollectionResponses];
 
+export type GetCollectionByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Tenant ID
+         */
+        tenant: string;
+        /**
+         * Database name
+         */
+        database: string;
+        /**
+         * Collection UUID
+         */
+        collection_id: string;
+    };
+    query?: never;
+    url: '/api/v2/tenants/{tenant}/databases/{database}/collections/by-id/{collection_id}';
+};
+
+export type GetCollectionByIdErrors = {
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Collection not found
+     */
+    404: ErrorResponse;
+    /**
+     * Server error
+     */
+    500: ErrorResponse;
+};
+
+export type GetCollectionByIdError = GetCollectionByIdErrors[keyof GetCollectionByIdErrors];
+
+export type GetCollectionByIdResponses = {
+    /**
+     * Collection found
+     */
+    200: Collection;
+};
+
+export type GetCollectionByIdResponse = GetCollectionByIdResponses[keyof GetCollectionByIdResponses];
+
 export type DeleteCollectionData = {
     body?: never;
     path: {
@@ -1484,6 +1564,52 @@ export type CollectionAddResponses = {
 
 export type CollectionAddResponse = CollectionAddResponses[keyof CollectionAddResponses];
 
+export type AddAttachedFunctionInputData = {
+    body: AddAttachedFunctionInputRequest;
+    path: {
+        /**
+         * Tenant UUID
+         */
+        tenant: string;
+        /**
+         * Database name
+         */
+        database: string;
+        /**
+         * Collection UUID
+         */
+        collection_id: string;
+        /**
+         * Function name
+         */
+        name: string;
+    };
+    query?: never;
+    url: '/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/attached_functions/{name}/add_input';
+};
+
+export type AddAttachedFunctionInputErrors = {
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Server error
+     */
+    500: ErrorResponse;
+};
+
+export type AddAttachedFunctionInputError = AddAttachedFunctionInputErrors[keyof AddAttachedFunctionInputErrors];
+
+export type AddAttachedFunctionInputResponses = {
+    /**
+     * Attached function input added successfully
+     */
+    200: AddAttachedFunctionInputResponse;
+};
+
+export type AddAttachedFunctionInputResponse2 = AddAttachedFunctionInputResponses[keyof AddAttachedFunctionInputResponses];
+
 export type DetachFunctionData = {
     body: DetachFunctionRequest;
     path: {

package/src/chroma-client.ts

@@ -440,6 +440,38 @@ export class ChromaClient {
     });
   }
 
+  /**
+   * Retrieves an existing collection by its ID.
+   * @param id - The UUID of the collection to retrieve
+   * @returns Promise resolving to the Collection instance
+   * @throws Error if the collection does not exist
+   */
+  public async getCollectionById(id: string): Promise<Collection> {
+    const { data } = await CollectionService.getCollectionById({
+      client: this.apiClient,
+      path: { ...(await this._path()), collection_id: id },
+    });
+    const schema = await Schema.deserializeFromJSON(data.schema ?? null, this);
+    const schemaEmbeddingFunction = resolveSchemaEmbeddingFunction(schema);
+    const resolvedEmbeddingFunction =
+      (await getEmbeddingFunction({
+        efConfig: data.configuration_json.embedding_function ?? undefined,
+        client: this,
+      })) ?? schemaEmbeddingFunction;
+    return new CollectionImpl({
+      chromaClient: this,
+      apiClient: this.apiClient,
+      name: data.name,
+      tenant: data.tenant,
+      database: data.database,
+      configuration: data.configuration_json,
+      metadata: deserializeMetadata(data.metadata ?? undefined) ?? undefined,
+      embeddingFunction: resolvedEmbeddingFunction,
+      id: data.id,
+      schema,
+    });
+  }
+
   /**
    * Retrieves multiple collections by name.
    * @param items - Array of collection names or objects with name and optional embedding function (should match the ones used to create the collections)

package/src/cli.ts

@@ -53,6 +53,10 @@ const main = async () => {
     return;
   }
 
+  process.on("SIGINT", () => {
+    process.exit(0);
+  });
+
   binding.cli(["chroma", ...args]);
 };
 

package/src/collection.ts

@@ -80,6 +80,7 @@ export interface Collection {
      * Controls whether to read from the write-ahead log.
      * - ReadLevel.INDEX_AND_WAL: Read from both index and WAL (default)
      * - ReadLevel.INDEX_ONLY: Read only from index, faster but recent writes may not be visible
+     * - ReadLevel.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
      */
     readLevel?: ReadLevel;
   }): Promise<number>;
@@ -231,6 +232,7 @@ export interface Collection {
        * Controls whether to read from the write-ahead log.
        * - ReadLevel.INDEX_AND_WAL: Read from both index and WAL (default)
        * - ReadLevel.INDEX_ONLY: Read only from index, faster but recent writes may not be visible
+       * - ReadLevel.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
        */
       readLevel?: ReadLevel;
     },