@mastra/chroma 1.1.3-alpha.0 → 1.1.3-alpha.1

package/README.md

@@ -8,62 +8,21 @@ Vector store implementation for Chroma using the official `chromadb` client with
 npm install @mastra/chroma
 ```
 
-## Instantiation
-
-### Local or Self-Deployments
-
-To run a Chroma server, use the [Chroma CLI](https://docs.trychroma.com/docs/cli/db). It is available to you when you install this package.
-
-```shell
-chroma run
-```
-
-You will now have a Chroma server running on `localhost:8000`.
-
-```typescript
-import { ChromaVector } from '@mastra/chroma';
-
-const vectorStore = new ChromaVector();
-```
-
-If you run a Chroma server locally with a different configuration, or [deploy](https://docs.trychroma.com/guides/deploy/client-server-mode) a Chroma server yourself, you can configure your `ChromaVector` instantiation with specific connection details:
-
-```typescript
-import { ChromaVector } from '@mastra/chroma';
-
-const vectorStore = new ChromaVector({
-  host: 'your-host-address',
-  port: 8000,
-  ssl: false,
-  headers: {}, // any HTTP headers to send,
-});
-```
-
-### Chroma Cloud
-
-Provide your Chroma Cloud API key, tenant, and database.
-
-You can use the [Chroma CLI](https://docs.trychroma.com/docs/cli/db) to set these as environment variables: `chroma db connect [DB-NAME] --env-file`.
+## Usage
 
 ```typescript
 import { ChromaVector } from '@mastra/chroma';
 
-const vectorStore = new ChromaVector({
-  apiKey: process.env.CHROMA_API_KEY,
-  tenant: process.env.CHROMA_TENANT,
-  database: process.env.CHROMA_DATABASE,
-});
-```
-
-## Usage
-
-```typescript
+const vectorStore = new ChromaVector({ id: 'chroma-vectors' });
 
 // Create a new collection
-await vectorStore.createIndex({ indexName: 'myCollection', dimension: 1536, metric: 'cosine' });
+await vectorStore.createIndex({ indexName: 'myCollection', dimension: 3, metric: 'cosine' });
 
 // Add vectors with documents
-const vectors = [[0.1, 0.2, ...], [0.3, 0.4, ...]];
+const vectors = [
+  [0.1, 0.2, 0.3],
+  [0.3, 0.4, 0.5],
+];
 const metadata = [{ text: 'doc1' }, { text: 'doc2' }];
 const documents = ['full text 1', 'full text 2'];
 const ids = await vectorStore.upsert({
@@ -76,50 +35,22 @@ const ids = await vectorStore.upsert({
 // Query vectors with document filtering
 const results = await vectorStore.query({
   indexName: 'myCollection',
-  queryVector: [0.1, 0.2, ...],
+  queryVector: [0.1, 0.2, 0.3],
   topK: 10, // topK
   filter: { text: { $eq: 'doc1' } }, // metadata filter
   includeVector: false, // includeVector
-  documentFilter: { $contains: 'specific text' } // document content filter
+  documentFilter: { $contains: 'specific text' }, // document content filter
 });
 ```
 
-## Features
-
-- Vector similarity search with cosine, euclidean, and dot product metrics
-- Document storage and retrieval
-- Document content filtering
-- Strict vector dimension validation
-- Collection-based organization
-- Metadata filtering support
-- Optional vector inclusion in query results
-- Automatic UUID generation for vectors
-- Built-in collection caching for performance
-- Built on top of chromadb client
-
-## Methods
-
-- `createIndex({ indexName, dimension, metric? })`: Create a new collection
-- `upsert({ indexName, vectors, metadata?, ids?, documents? })`: Add or update vectors with optional document storage
-- `query({ indexName, queryVector, topK?, filter?, includeVector?, documentFilter? })`: Search for similar vectors with optional document filtering
-- `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
-- `deleteVector({ indexName, id })`: Delete a single vector by ID
-- `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
-- `listIndexes()`: List all collections
-- `describeIndex(indexName)`: Get collection statistics
-- `deleteIndex(indexName)`: Delete a collection
+## Documentation
 
-## Query Response Format
+- [@mastra/chroma documentation](https://mastra.ai/reference/vectors/chroma)
 
-Query results include:
+## Changelog
 
-- `id`: Vector ID
-- `score`: Distance/similarity score
-- `metadata`: Associated metadata
-- `document`: Original document text (if stored)
-- `vector`: Original vector (if includeVector is true)
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/chroma/CHANGELOG.md) for version history and release notes.
 
-## Related Links
+## Support
 
-- [Chroma Documentation](https://docs.trychroma.com/)
-- [Chroma API Reference](https://docs.trychroma.com/api/client)
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-chroma
 description: Documentation for @mastra/chroma. Use when working with @mastra/chroma APIs, configuration, or implementation.
 metadata:
   package: "@mastra/chroma"
-  version: "1.1.3-alpha.0"
+  version: "1.1.3-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.3-alpha.0",
+  "version": "1.1.3-alpha.1",
   "package": "@mastra/chroma",
   "exports": {},
   "modules": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/chroma",
-  "version": "1.1.3-alpha.0",
+  "version": "1.1.3-alpha.1",
   "description": "Chroma vector store provider for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -31,10 +31,10 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/storage-test-utils": "0.0.125",
     "@internal/lint": "0.0.129",
+    "@internal/storage-test-utils": "0.0.125",
     "@internal/types-builder": "0.0.104",
-    "@mastra/core": "1.64.0-alpha.2"
+    "@mastra/core": "1.64.0-alpha.7"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"