@juspay/neurolink 9.88.12 → 9.90.0

package/dist/types/rag.d.ts

@@ -419,6 +419,36 @@ export type VectorStore = {
         includeVectors?: boolean;
     }): Promise<VectorQueryResult[]>;
 };
+/** Minimal shape of a query result, satisfied by both `pg` and `pglite`. */
+export type PgQueryResult<T = unknown> = {
+    rows: T[];
+};
+/**
+ * Minimal structural interface a caller-supplied Postgres client must
+ * satisfy. Both `pg.Pool` (`node-postgres`) and `@electric-sql/pglite`
+ * instances already expose a compatible `query(text, values?)` method —
+ * neither is a dependency of this package. Callers construct and own the
+ * client; `PgVectorStore` only ever calls `query()` on it.
+ */
+export type PgClientLike = {
+    query(text: string, values?: unknown[]): Promise<PgQueryResult>;
+};
+/** Construction options for `PgVectorStore`. */
+export type PgVectorStoreOptions = {
+    /**
+     * Prefix prepended to `indexName` to derive the backing table name.
+     * Must itself be a valid, unquoted Postgres identifier.
+     * @default "neurolink_vs_"
+     */
+    tablePrefix?: string;
+};
+/** Row shape returned by `PgVectorStore`'s SELECT queries. */
+export type PgVectorStoreRow = {
+    id: string;
+    metadata: unknown;
+    score: unknown;
+    embedding?: unknown;
+};
 /**
  * Document loader options
  */

package/dist/types/vectorStoreChroma.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Structural types for the Chroma vector store adapter
+ * (`src/lib/rag/stores/chroma.ts`).
+ *
+ * These mirror the subset of the `chromadb` package's API the adapter
+ * calls (`ChromaClient.getOrCreateCollection`, `Collection.upsert/query/
+ * delete`). NeuroLink has zero runtime dependency on `chromadb` — callers
+ * construct their own client and inject an object satisfying
+ * `ChromaClientLike`.
+ */
+export type ChromaMetadataValue = string | number | boolean;
+export type ChromaMetadata = Record<string, ChromaMetadataValue>;
+/** Chroma's metadata `where` filter payload shape. */
+export type ChromaWhere = Record<string, unknown>;
+export type ChromaIncludeField = "embeddings" | "metadatas" | "documents" | "distances";
+export type ChromaUpsertParams = {
+    ids: string[];
+    embeddings?: number[][];
+    metadatas?: Array<ChromaMetadata | null>;
+    documents?: Array<string | null>;
+};
+export type ChromaQueryParams = {
+    queryEmbeddings: number[][];
+    nResults?: number;
+    where?: ChromaWhere;
+    include?: ChromaIncludeField[];
+};
+export type ChromaQueryResponse = {
+    ids: string[][];
+    embeddings?: Array<Array<number[] | null>> | null;
+    metadatas?: Array<Array<ChromaMetadata | null>> | null;
+    documents?: Array<Array<string | null>> | null;
+    distances?: Array<Array<number | null>> | null;
+};
+export type ChromaDeleteParams = {
+    ids?: string[];
+    where?: ChromaWhere;
+};
+/**
+ * Minimal structural interface for a Chroma collection handle, matching the
+ * subset of `Collection` (from `chromadb`) the adapter calls.
+ */
+export type ChromaCollectionLike = {
+    upsert(params: ChromaUpsertParams): Promise<unknown>;
+    query(params: ChromaQueryParams): Promise<ChromaQueryResponse>;
+    delete(params: ChromaDeleteParams): Promise<unknown>;
+};
+/**
+ * Minimal structural interface for a Chroma client, matching the subset of
+ * `ChromaClient` (from `chromadb`) the adapter calls.
+ */
+export type ChromaClientLike = {
+    getOrCreateCollection(params: {
+        name: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<ChromaCollectionLike>;
+};
+export type ChromaDistanceMetric = "cosine" | "l2" | "ip";
+export type ChromaVectorStoreOptions = {
+    /**
+     * The distance metric configured on the underlying Chroma collection(s)
+     * (Chroma's `hnsw:space`). Used only to convert returned distances into a
+     * `score`; see `src/lib/rag/stores/chroma.ts` module doc comment.
+     * Defaults to `"cosine"`.
+     */
+    distanceMetric?: ChromaDistanceMetric;
+};

package/dist/types/vectorStoreChroma.js

@@ -0,0 +1,11 @@
+/**
+ * Structural types for the Chroma vector store adapter
+ * (`src/lib/rag/stores/chroma.ts`).
+ *
+ * These mirror the subset of the `chromadb` package's API the adapter
+ * calls (`ChromaClient.getOrCreateCollection`, `Collection.upsert/query/
+ * delete`). NeuroLink has zero runtime dependency on `chromadb` — callers
+ * construct their own client and inject an object satisfying
+ * `ChromaClientLike`.
+ */
+export {};

package/dist/types/vectorStorePinecone.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Structural types for the Pinecone vector store adapter
+ * (`src/lib/rag/stores/pinecone.ts`).
+ *
+ * These mirror the subset of the `@pinecone-database/pinecone` package's API
+ * the adapter calls (`Index.query/upsert/deleteMany`, optional
+ * `Index.namespace`). NeuroLink has zero runtime dependency on the Pinecone
+ * SDK — callers construct their own client/index and inject an object
+ * satisfying `PineconeIndexLike`.
+ */
+/** A single scored match as returned by Pinecone's query API. */
+export type PineconeMatch = {
+    id: string;
+    score?: number;
+    values?: number[];
+    metadata?: Record<string, unknown>;
+};
+/** Shape of the response returned by `PineconeIndexLike.query()`. */
+export type PineconeQueryResponse = {
+    matches?: PineconeMatch[];
+};
+/** Request payload accepted by `PineconeIndexLike.query()`. */
+export type PineconeQueryRequest = {
+    vector: number[];
+    topK: number;
+    filter?: Record<string, unknown>;
+    includeMetadata?: boolean;
+    includeValues?: boolean;
+};
+/** A single record accepted by `PineconeIndexLike.upsert()`. */
+export type PineconeUpsertRecord = {
+    id: string;
+    values: number[];
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Minimal structural interface modeled on the `@pinecone-database/pinecone`
+ * `Index` object. Satisfied by the real SDK's `Index` without modification;
+ * callers never need to install the Pinecone SDK as a dependency of this
+ * package — they bring their own already-constructed client instance.
+ */
+export type PineconeIndexLike = {
+    /** Returns a client scoped to the given namespace, if the client supports namespacing. */
+    namespace?(ns: string): PineconeIndexLike;
+    query(request: PineconeQueryRequest): Promise<PineconeQueryResponse>;
+    upsert(records: PineconeUpsertRecord[]): Promise<unknown>;
+    deleteMany(ids: string[]): Promise<unknown>;
+};

package/dist/types/vectorStorePinecone.js

@@ -0,0 +1,11 @@
+/**
+ * Structural types for the Pinecone vector store adapter
+ * (`src/lib/rag/stores/pinecone.ts`).
+ *
+ * These mirror the subset of the `@pinecone-database/pinecone` package's API
+ * the adapter calls (`Index.query/upsert/deleteMany`, optional
+ * `Index.namespace`). NeuroLink has zero runtime dependency on the Pinecone
+ * SDK — callers construct their own client/index and inject an object
+ * satisfying `PineconeIndexLike`.
+ */
+export {};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.88.12",
+  "version": "9.90.0",
   "packageManager": "pnpm@10.15.1",
-  "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (58+ servers), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
+  "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {
     "name": "Juspay Technologies",
     "email": "support@juspay.in",
@@ -93,6 +93,9 @@
     "test:mcp:infra": "npx tsx test/continuous-test-suite-mcp-infra.ts",
     "test:providers-mocked": "npx tsx test/continuous-test-suite-providers-mocked.ts",
     "test:rag": "npx tsx test/continuous-test-suite-rag.ts",
+    "test:vector-pinecone": "npx tsx test/continuous-test-suite-vector-pinecone.ts",
+    "test:vector-pgvector": "npx tsx test/continuous-test-suite-vector-pgvector.ts",
+    "test:vector-chroma": "npx tsx test/continuous-test-suite-vector-chroma.ts",
     "test:skills": "npx tsx test/continuous-test-suite-skills.ts",
     "test:servers": "npx tsx test/continuous-test-suite-servers.ts",
     "test:tool-reliability": "npx tsx test/continuous-test-suite-tool-reliability.ts",
@@ -332,15 +335,9 @@
     "@ai-sdk/provider": "^3.0.8",
     "@anthropic-ai/sdk": "^0.102.0",
     "@anthropic-ai/vertex-sdk": "^0.16.0",
-    "@aws-sdk/client-bedrock": "^3.1000.0",
-    "@aws-sdk/client-bedrock-runtime": "^3.1000.0",
     "@aws-sdk/client-sagemaker-runtime": "^3.1000.0",
-    "@aws-sdk/credential-provider-node": "^3.886.0",
     "@aws-sdk/types": "^3.862.0",
-    "@google-cloud/text-to-speech": "^6.4.0",
-    "@google-cloud/vertexai": "^1.10.0",
     "@google/genai": "^1.43.0",
-    "@huggingface/inference": "^4.13.14",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@opentelemetry/api-logs": "^0.214.0",
     "@opentelemetry/context-async-hooks": "^2.6.1",
@@ -399,10 +396,16 @@
     }
   },
   "optionalDependencies": {
+    "@aws-sdk/client-bedrock": "^3.1000.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.1000.0",
     "@aws-sdk/client-sagemaker": "^3.1000.0",
+    "@aws-sdk/credential-provider-node": "^3.886.0",
     "@fastify/cors": "^11.2.0",
     "@fastify/rate-limit": "^10.3.0",
+    "@google-cloud/text-to-speech": "^6.4.0",
+    "@google-cloud/vertexai": "^1.10.0",
     "@hono/node-server": "^1.19.13",
+    "@huggingface/inference": "^4.13.14",
     "@koa/cors": "^5.0.0",
     "@koa/router": "^15.3.1",
     "@langfuse/otel": "^5.0.1",
@@ -442,6 +445,7 @@
     "@biomejs/biome": "^2.4.4",
     "@changesets/changelog-github": "^0.6.0",
     "@changesets/cli": "^2.29.8",
+    "@electric-sql/pglite": "^0.4.6",
     "@eslint/js": "^10.0.1",
     "@juspay/hippocampus": ">=0.1.7",
     "@opentelemetry/api": "^1.9.0",