@harshit-sandilya/cortexdb-js 0.2.8

package/README.md

@@ -0,0 +1,165 @@
+# CortexDB JavaScript/TypeScript SDK
+
+Lightweight TypeScript client SDK for [CortexDB](https://github.com/harshit-sandilya/CortexDB) — wraps the REST API with full type safety.
+
+## Requirements
+
+- **Node.js 18+**
+- **npm 9+** (or any compatible package manager)
+
+## Installation
+
+```bash
+npm install cortexdb
+```
+
+## Quick Start
+
+```ts
+import { CortexDB, ConverserRole } from "cortexdb";
+
+const db = new CortexDB("http://localhost:8080");
+
+// 1. Configure LLM provider
+await db.setup.configure("GEMINI", "gemini-2.0-flash", "gemini-embedding-001", "your-api-key");
+
+// 2. Ingest structured document or prompt
+await db.ingest.document(
+  "user-1", "Quantum Computing",
+  "Quantum computing uses qubits to perform computations..."
+);
+await db.ingest.prompt("user-1", ConverserRole.USER, "What are qubits?");
+
+// 3. Search contexts
+const results = await db.query.searchContexts("What is quantum computing?");
+for (const r of results.results) {
+  console.log(`${r.score?.toFixed(2)} — ${r.content}`);
+}
+
+// 4. Entity lookup
+const entity = await db.query.getEntityByName("Google");
+
+// 5. Graph traversal
+const connections = await db.query.getOutgoingConnections(entity!.id!);
+```
+
+## API Overview
+
+### Setup
+
+```ts
+await db.setup.configure(provider, chatModel, embedModel);
+await db.setup.configure(provider, chatModel, embedModel, apiKey);
+await db.setup.configure(provider, chatModel, embedModel, apiKey, baseUrl);
+```
+
+Supported providers: `GEMINI`, `OPENAI`, `ANTHROPIC`, `AZURE`, `OPENROUTER`.
+
+### Ingest
+
+```ts
+await db.ingest.document(uid, documentTitle, documentText);
+await db.ingest.document(uid, documentTitle, documentText, metadata);
+await db.ingest.prompt(uid, converser, text);
+await db.ingest.prompt(uid, converser, text, metadata);
+```
+
+Converser roles: `USER`, `AGENT`, `SYSTEM`.
+
+### Query — Contexts
+
+```ts
+await db.query.searchContexts(query);
+await db.query.searchContexts(query, limit, minRelevance, filters);
+await db.query.getContextsByKb(kbId);
+await db.query.getRecentContexts(days);
+await db.query.searchRecentContexts(query, days);
+await db.query.getSiblingContexts(contextId);
+```
+
+### Query — Entities
+
+```ts
+await db.query.searchEntities(query);
+await db.query.getEntityByName(name);               // returns null if not found
+await db.query.getEntityByNameIgnoreCase(name);
+await db.query.getEntityIdByName(name);
+await db.query.disambiguateEntity(name, context);
+await db.query.getContextsForEntity(entityId);
+await db.query.getEntitiesForContext(contextId);
+await db.query.mergeEntities(sourceId, targetId);
+```
+
+### Query — History
+
+```ts
+await db.query.searchHistory(query);
+await db.query.getHistoryByUser(uid);
+await db.query.getRecentKbs(hours);
+await db.query.getKbsSince(isoTimestamp);
+await db.query.deleteUserData(uid);                  // GDPR
+```
+
+### Query — Graph
+
+```ts
+await db.query.getOutgoingConnections(entityId);
+await db.query.getIncomingConnections(entityId);
+await db.query.getTwoHopConnections(entityId);
+await db.query.getTopRelations(limit);
+await db.query.getRelationsBySource(sourceId);
+await db.query.getRelationsByTarget(targetId);
+await db.query.getRelationsByType(relationType);
+```
+
+### Query — Hybrid Search
+
+```ts
+await db.query.hybridSearch(query);
+await db.query.hybridSearch(query, limit, minRelevance);
+```
+
+## TypeScript Types
+
+All models are fully typed and exported from the package:
+
+```ts
+import {
+  // Enums
+  LLMApiProvider,
+  ConverserRole,
+  // Types
+  type SetupRequest,
+  type SetupResponse,
+  type IngestRequest,
+  type IngestResponse,
+  type KnowledgeBase,
+  type QueryRequest,
+  type QueryResponse,
+  type SearchResult,
+  type Entity,
+  type Relation,
+} from "cortexdb";
+```
+
+## Configuration
+
+| Parameter  | Default                  | Description                        |
+|------------|--------------------------|------------------------------------|
+| `baseUrl`  | `http://localhost:8080`  | CortexDB server URL               |
+| `timeout`  | `30000`                  | Request timeout in milliseconds    |
+
+```ts
+const db = new CortexDB("https://cortex.example.com", 60_000);
+```
+
+## Building
+
+```bash
+cd cortexdb-js
+npm install          # install dependencies
+npm run build        # compile TypeScript
+npm test             # run unit tests
+npm run test:e2e     # run end-to-end tests
+npm run test:all     # run all tests
+```

package/dist/client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Main CortexDB client — entry point for the JavaScript/TypeScript SDK.
+ *
+ * Equivalent to cortexdb-py/cortexdb/client.py
+ *
+ * @example
+ * ```ts
+ * import { CortexDB } from "cortexdb";
+ *
+ * const db = new CortexDB("http://localhost:8080");
+ *
+ * // Configure LLM
+ * await db.setup.configure("GEMINI", "gemini-2.0-flash", "gemini-embedding-001", "your-api-key");
+ *
+ * // Ingest content
+ * await db.ingest.document("user-1", "USER", "Hello world");
+ *
+ * // Query
+ * const results = await db.query.searchContexts("greeting");
+ * ```
+ */
+import { SetupAPI } from "./setup.js";
+import { IngestAPI } from "./ingest.js";
+import { QueryAPI } from "./query.js";
+export declare class CortexDB {
+    /** Setup API — configure LLM providers. */
+    readonly setup: SetupAPI;
+    /** Ingest API — ingest documents into CortexDB. */
+    readonly ingest: IngestAPI;
+    /** Query API — search contexts, entities, history, and graph. */
+    readonly query: QueryAPI;
+    private readonly http;
+    /**
+     * Initialize the CortexDB client.
+     *
+     * @param baseUrl  Base URL of the CortexDB server (default: http://localhost:8080).
+     * @param timeout  Request timeout in milliseconds (default: 30 000).
+     */
+    constructor(baseUrl?: string, timeout?: number);
+    toString(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAa,QAAQ;IACjB,2CAA2C;IAC3C,SAAgB,KAAK,EAAE,QAAQ,CAAC;IAChC,mDAAmD;IACnD,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,iEAAiE;IACjE,SAAgB,KAAK,EAAE,QAAQ,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;;;;OAKG;gBACS,OAAO,GAAE,MAAgC,EAAE,OAAO,GAAE,MAAe;IAQ/E,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/client.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Main CortexDB client — entry point for the JavaScript/TypeScript SDK.
+ *
+ * Equivalent to cortexdb-py/cortexdb/client.py
+ *
+ * @example
+ * ```ts
+ * import { CortexDB } from "cortexdb";
+ *
+ * const db = new CortexDB("http://localhost:8080");
+ *
+ * // Configure LLM
+ * await db.setup.configure("GEMINI", "gemini-2.0-flash", "gemini-embedding-001", "your-api-key");
+ *
+ * // Ingest content
+ * await db.ingest.document("user-1", "USER", "Hello world");
+ *
+ * // Query
+ * const results = await db.query.searchContexts("greeting");
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CortexDB = void 0;
+const httpWrapper_js_1 = require("./httpWrapper.js");
+const setup_js_1 = require("./setup.js");
+const ingest_js_1 = require("./ingest.js");
+const query_js_1 = require("./query.js");
+class CortexDB {
+    /** Setup API — configure LLM providers. */
+    setup;
+    /** Ingest API — ingest documents into CortexDB. */
+    ingest;
+    /** Query API — search contexts, entities, history, and graph. */
+    query;
+    http;
+    /**
+     * Initialize the CortexDB client.
+     *
+     * @param baseUrl  Base URL of the CortexDB server (default: http://localhost:8080).
+     * @param timeout  Request timeout in milliseconds (default: 30 000).
+     */
+    constructor(baseUrl = "http://localhost:8080", timeout = 30_000) {
+        this.http = new httpWrapper_js_1.HttpClient(baseUrl, timeout);
+        this.setup = new setup_js_1.SetupAPI(this.http);
+        this.ingest = new ingest_js_1.IngestAPI(this.http);
+        this.query = new query_js_1.QueryAPI(this.http);
+    }
+    toString() {
+        return `CortexDB(baseUrl="${this.http}")`;
+    }
+}
+exports.CortexDB = CortexDB;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,qDAA8C;AAC9C,yCAAsC;AACtC,2CAAwC;AACxC,yCAAsC;AAEtC,MAAa,QAAQ;IACjB,2CAA2C;IAC3B,KAAK,CAAW;IAChC,mDAAmD;IACnC,MAAM,CAAY;IAClC,iEAAiE;IACjD,KAAK,CAAW;IAEf,IAAI,CAAa;IAElC;;;;;OAKG;IACH,YAAY,UAAkB,uBAAuB,EAAE,UAAkB,MAAM;QAC3E,IAAI,CAAC,IAAI,GAAG,IAAI,2BAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE7C,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ;QACJ,OAAO,qBAAqB,IAAI,CAAC,IAAI,IAAI,CAAC;IAC9C,CAAC;CACJ;AA3BD,4BA2BC"}

package/dist/httpWrapper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Thin HTTP wrapper around the native fetch API.
+ *
+ * Mirrors the role of httpx in the Python SDK — handles base URL
+ * resolution, JSON serialisation, timeout, and error handling so
+ * the API classes stay clean.
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    /**
+     * @param baseUrl  Base URL of the CortexDB server.
+     * @param timeout  Request timeout in milliseconds.
+     */
+    constructor(baseUrl: string, timeout?: number);
+    get<T>(path: string, params?: Record<string, any>): Promise<T>;
+    post<T>(path: string, body?: any, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
+    delete<T>(path: string, params?: Record<string, any>): Promise<T>;
+    request<T>(method: string, path: string, body?: any, params?: Record<string, any>, extraHeaders?: Record<string, string>): Promise<T>;
+}
+//# sourceMappingURL=httpWrapper.d.ts.map

package/dist/httpWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpWrapper.d.ts","sourceRoot":"","sources":["../src/httpWrapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAe;IAQ/C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9D,IAAI,CAAC,CAAC,EACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC;IAIP,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMjE,OAAO,CAAC,CAAC,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC;CAuDhB"}

package/dist/httpWrapper.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Thin HTTP wrapper around the native fetch API.
+ *
+ * Mirrors the role of httpx in the Python SDK — handles base URL
+ * resolution, JSON serialisation, timeout, and error handling so
+ * the API classes stay clean.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+class HttpClient {
+    baseUrl;
+    timeout;
+    /**
+     * @param baseUrl  Base URL of the CortexDB server.
+     * @param timeout  Request timeout in milliseconds.
+     */
+    constructor(baseUrl, timeout = 30_000) {
+        // Strip trailing slash so path concatenation is predictable
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.timeout = timeout;
+    }
+    // ── Convenience methods ──────────────────────────────────────────
+    async get(path, params) {
+        return this.request("GET", path, undefined, params);
+    }
+    async post(path, body, params, headers) {
+        return this.request("POST", path, body, params, headers);
+    }
+    async delete(path, params) {
+        return this.request("DELETE", path, undefined, params);
+    }
+    // ── Core request method ──────────────────────────────────────────
+    async request(method, path, body, params, extraHeaders) {
+        const url = new URL(this.baseUrl + path);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, String(value));
+                }
+            }
+        }
+        const headers = {
+            Accept: "application/json",
+            ...extraHeaders,
+        };
+        let requestBody;
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            requestBody = JSON.stringify(body);
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: requestBody,
+            signal: AbortSignal.timeout(this.timeout),
+        });
+        // 404 → return null (mirrors the Python SDK's pattern)
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            throw new Error(`CortexDB HTTP Error: ${response.status} ${response.statusText}` +
+                (errorBody ? ` — ${errorBody}` : ""));
+        }
+        // 204 No Content
+        if (response.status === 204) {
+            return undefined;
+        }
+        // Some void endpoints respond 200 with no body (e.g. DELETE, merge).
+        // Wrap json() in a try/catch so empty bodies don't throw.
+        try {
+            return await response.json();
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=httpWrapper.js.map

package/dist/httpWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpWrapper.js","sourceRoot":"","sources":["../src/httpWrapper.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CortexDB JavaScript/TypeScript SDK — A RAG-powered memory database client.
+ *
+ * Equivalent to cortexdb-py/cortexdb/__init__.py
+ */
+export { CortexDB } from "./client.js";
+export { SetupAPI } from "./setup.js";
+export { IngestAPI } from "./ingest.js";
+export { QueryAPI } from "./query.js";
+export { HttpClient } from "./httpWrapper.js";
+export { LLMApiProvider, ConverserRole, type SetupRequest, type SetupResponse, type IngestPromptRequest, type IngestDocumentRequest, type KnowledgeBase, type IngestResponse, type QueryRequest, type SearchResult, type QueryResponse, type Entity, type Relation, } from "./models.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAEH,cAAc,EACd,aAAa,EAEb,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAElB,KAAK,MAAM,EACX,KAAK,QAAQ,GAChB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * CortexDB JavaScript/TypeScript SDK — A RAG-powered memory database client.
+ *
+ * Equivalent to cortexdb-py/cortexdb/__init__.py
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConverserRole = exports.LLMApiProvider = exports.HttpClient = exports.QueryAPI = exports.IngestAPI = exports.SetupAPI = exports.CortexDB = void 0;
+// ── Main client ──────────────────────────────────────────────────────
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "CortexDB", { enumerable: true, get: function () { return client_js_1.CortexDB; } });
+// ── Sub-API classes ──────────────────────────────────────────────────
+var setup_js_1 = require("./setup.js");
+Object.defineProperty(exports, "SetupAPI", { enumerable: true, get: function () { return setup_js_1.SetupAPI; } });
+var ingest_js_1 = require("./ingest.js");
+Object.defineProperty(exports, "IngestAPI", { enumerable: true, get: function () { return ingest_js_1.IngestAPI; } });
+var query_js_1 = require("./query.js");
+Object.defineProperty(exports, "QueryAPI", { enumerable: true, get: function () { return query_js_1.QueryAPI; } });
+// ── HTTP layer ───────────────────────────────────────────────────────
+var httpWrapper_js_1 = require("./httpWrapper.js");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return httpWrapper_js_1.HttpClient; } });
+// ── Models & Enums ───────────────────────────────────────────────────
+var models_js_1 = require("./models.js");
+// Enums
+Object.defineProperty(exports, "LLMApiProvider", { enumerable: true, get: function () { return models_js_1.LLMApiProvider; } });
+Object.defineProperty(exports, "ConverserRole", { enumerable: true, get: function () { return models_js_1.ConverserRole; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,wEAAwE;AACxE,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AAEjB,wEAAwE;AACxE,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AAEjB,wEAAwE;AACxE,mDAA8C;AAArC,4GAAA,UAAU,OAAA;AAEnB,wEAAwE;AACxE,yCAmBqB;AAlBjB,QAAQ;AACR,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA"}

package/dist/ingest.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Ingest API wrapper for CortexDB.
+ *
+ * Equivalent to cortexdb-py/cortexdb/ingest.py
+ */
+import { HttpClient } from "./httpWrapper.js";
+import { ConverserRole, type IngestResponse } from "./models.js";
+export declare class IngestAPI {
+    private readonly http;
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Ingest a prompt payload into CortexDB.
+     * The server will perform semantic compression and online synthesis.
+     *
+     * @param uid        User identifier.
+     * @param converser  Role of the converser ("USER", "AGENT", or "SYSTEM").
+     * @param text       The text content to ingest.
+     * @param metadata   Optional metadata dictionary.
+     * @returns IngestResponse with the created KnowledgeBase and processing info.
+     */
+    prompt(uid: string, converser: string | ConverserRole, text: string, metadata?: Record<string, any>): Promise<IngestResponse>;
+    /**
+     * Ingest a large document into CortexDB.
+     * The server will extract a hierarchical page index (document tree).
+     *
+     * @param uid           User identifier.
+     * @param documentTitle Title of the document.
+     * @param documentText  The full text content of the document.
+     * @returns IngestResponse with the created KnowledgeBase and processing info.
+     */
+    document(uid: string, documentTitle: string, documentText: string): Promise<IngestResponse>;
+}
+//# sourceMappingURL=ingest.d.ts.map

package/dist/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACH,aAAa,EAGb,KAAK,cAAc,EACtB,MAAM,aAAa,CAAC;AAErB,qBAAa,SAAS;IAEN,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,gBAAgB;gBACa,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;OASG;IACG,MAAM,CACR,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,aAAa,EACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC;IAiB1B;;;;;;;;OAQG;IACG,QAAQ,CACV,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC;CAS7B"}

package/dist/ingest.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Ingest API wrapper for CortexDB.
+ *
+ * Equivalent to cortexdb-py/cortexdb/ingest.py
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IngestAPI = void 0;
+class IngestAPI {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Ingest a prompt payload into CortexDB.
+     * The server will perform semantic compression and online synthesis.
+     *
+     * @param uid        User identifier.
+     * @param converser  Role of the converser ("USER", "AGENT", or "SYSTEM").
+     * @param text       The text content to ingest.
+     * @param metadata   Optional metadata dictionary.
+     * @returns IngestResponse with the created KnowledgeBase and processing info.
+     */
+    async prompt(uid, converser, text, metadata) {
+        // Normalise string converser to enum value
+        const resolvedConverser = typeof converser === "string"
+            ? converser.toUpperCase()
+            : converser;
+        const request = {
+            uid,
+            converser: resolvedConverser,
+            text,
+            ...(metadata !== undefined && { metadata }),
+        };
+        return this.http.post("/api/v1/memory/ingest/prompt", request);
+    }
+    /**
+     * Ingest a large document into CortexDB.
+     * The server will extract a hierarchical page index (document tree).
+     *
+     * @param uid           User identifier.
+     * @param documentTitle Title of the document.
+     * @param documentText  The full text content of the document.
+     * @returns IngestResponse with the created KnowledgeBase and processing info.
+     */
+    async document(uid, documentTitle, documentText) {
+        const request = {
+            uid,
+            documentTitle,
+            documentText,
+        };
+        return this.http.post("/api/v1/memory/ingest/document", request);
+    }
+}
+exports.IngestAPI = IngestAPI;
+//# sourceMappingURL=ingest.js.map

package/dist/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH,MAAa,SAAS;IAEW;IAD7B,gBAAgB;IAChB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAI,CAAC;IAElD;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CACR,GAAW,EACX,SAAiC,EACjC,IAAY,EACZ,QAA8B;QAE9B,2CAA2C;QAC3C,MAAM,iBAAiB,GACnB,OAAO,SAAS,KAAK,QAAQ;YACzB,CAAC,CAAE,SAAS,CAAC,WAAW,EAAoB;YAC5C,CAAC,CAAC,SAAS,CAAC;QAEpB,MAAM,OAAO,GAAwB;YACjC,GAAG;YACH,SAAS,EAAE,iBAAiB;YAC5B,IAAI;YACJ,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC9C,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,8BAA8B,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CACV,GAAW,EACX,aAAqB,EACrB,YAAoB;QAEpB,MAAM,OAAO,GAA0B;YACnC,GAAG;YACH,aAAa;YACb,YAAY;SACf,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,gCAAgC,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;CACJ;AA1DD,8BA0DC"}

package/dist/models.d.ts

@@ -0,0 +1,99 @@
+/**
+ * TypeScript data models mirroring the Java DTOs.
+ *
+ * Because JavaScript handles JSON objects natively and the Java backend
+ * expects camelCase, we don't need any field aliasing — plain interfaces
+ * map directly to the API payloads.
+ */
+export declare enum LLMApiProvider {
+    GEMINI = "GEMINI",
+    OPENAI = "OPENAI",
+    ANTHROPIC = "ANTHROPIC",
+    AZURE = "AZURE",
+    OPENROUTER = "OPENROUTER"
+}
+export declare enum ConverserRole {
+    /** Represents content from a human user. */
+    USER = "USER",
+    /** Represents content generated by the AI assistant. */
+    AGENT = "AGENT",
+    SYSTEM = "SYSTEM",
+    /** Represents content from a reference document. */
+    DOCUMENT = "DOCUMENT"
+}
+export interface SetupRequest {
+    provider: LLMApiProvider;
+    apiKey?: string;
+    chatModelName: string;
+    embedModelName: string;
+    baseUrl?: string;
+}
+export interface SetupResponse {
+    message: string;
+    success: boolean;
+    configuredProvider?: string;
+    configuredChatModel?: string;
+    configuredEmbedModel?: string;
+    baseUrl?: string;
+    timestamp?: string;
+}
+export interface IngestPromptRequest {
+    uid: string;
+    converser: ConverserRole;
+    text: string;
+    metadata?: Record<string, any>;
+}
+export interface IngestDocumentRequest {
+    uid: string;
+    documentTitle: string;
+    documentText: string;
+}
+export interface KnowledgeBase {
+    /** Simplified KnowledgeBase entity returned in ingest responses. */
+    id?: string;
+    uid?: string;
+    content?: string;
+    createdAt?: string;
+}
+export interface IngestResponse {
+    knowledgeBase?: KnowledgeBase;
+    status?: string;
+    message?: string;
+    processingTimeMs?: number;
+    embeddingTimeMs?: number;
+}
+export interface QueryRequest {
+    query: string;
+    limit: number;
+    minRelevance: number;
+    filters?: Record<string, any>;
+}
+export interface SearchResult {
+    id?: string;
+    content?: string;
+    score?: number;
+    type?: string;
+    metadata?: Record<string, any>;
+}
+export interface QueryResponse {
+    query?: string;
+    results: SearchResult[];
+    processingTimeMs?: number;
+}
+export interface Entity {
+    /** RagEntity returned from entity endpoints. */
+    id?: string;
+    name?: string;
+    type?: string;
+    description?: string;
+    embedding?: number[];
+}
+export interface Relation {
+    /** Relation between two entities. */
+    id?: string;
+    sourceEntityId?: string;
+    targetEntityId?: string;
+    relationType?: string;
+    weight?: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}

package/dist/models.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * TypeScript data models mirroring the Java DTOs.
+ *
+ * Because JavaScript handles JSON objects natively and the Java backend
+ * expects camelCase, we don't need any field aliasing — plain interfaces
+ * map directly to the API payloads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConverserRole = exports.LLMApiProvider = void 0;
+// ─── Enums ───────────────────────────────────────────────────────────
+var LLMApiProvider;
+(function (LLMApiProvider) {
+    LLMApiProvider["GEMINI"] = "GEMINI";
+    LLMApiProvider["OPENAI"] = "OPENAI";
+    LLMApiProvider["ANTHROPIC"] = "ANTHROPIC";
+    LLMApiProvider["AZURE"] = "AZURE";
+    LLMApiProvider["OPENROUTER"] = "OPENROUTER";
+})(LLMApiProvider || (exports.LLMApiProvider = LLMApiProvider = {}));
+var ConverserRole;
+(function (ConverserRole) {
+    /** Represents content from a human user. */
+    ConverserRole["USER"] = "USER";
+    /** Represents content generated by the AI assistant. */
+    ConverserRole["AGENT"] = "AGENT";
+    ConverserRole["SYSTEM"] = "SYSTEM";
+    /** Represents content from a reference document. */
+    ConverserRole["DOCUMENT"] = "DOCUMENT";
+})(ConverserRole || (exports.ConverserRole = ConverserRole = {}));
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,wEAAwE;AAExE,IAAY,cAMX;AAND,WAAY,cAAc;IACtB,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,yCAAuB,CAAA;IACvB,iCAAe,CAAA;IACf,2CAAyB,CAAA;AAC7B,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB;AAED,IAAY,aAQX;AARD,WAAY,aAAa;IACrB,4CAA4C;IAC5C,8BAAa,CAAA;IACb,wDAAwD;IACxD,gCAAe,CAAA;IACf,kCAAiB,CAAA;IACjB,oDAAoD;IACpD,sCAAqB,CAAA;AACzB,CAAC,EARW,aAAa,6BAAb,aAAa,QAQxB"}

package/dist/query.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Query API wrapper for CortexDB.
+ *
+ * Equivalent to cortexdb-py/cortexdb/query.py
+ * Mirrors all 18+ methods across contexts, entities, history,
+ * user-data, graph, and hybrid search endpoints.
+ */
+import { HttpClient } from "./httpWrapper.js";
+import type { Entity, QueryResponse, Relation } from "./models.js";
+export declare class QueryAPI {
+    private readonly http;
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Semantic search on contexts.
+     *
+     * @param query         Search query text.
+     * @param limit         Maximum number of results (default 5).
+     * @param minRelevance  Minimum relevance score 0-1 (default 0.7).
+     * @param filters       Optional filters dict.
+     */
+    searchContexts(query: string, limit?: number, minRelevance?: number, filters?: Record<string, any>): Promise<QueryResponse>;
+    /** Get all contexts for a knowledge base. */
+    getContextsByKb(kbId: string): Promise<QueryResponse>;
+    /** Get recent contexts from the last N days. */
+    getRecentContexts(days?: number): Promise<QueryResponse>;
+    /** Search recent contexts with vector similarity. */
+    searchRecentContexts(query: string, days?: number, limit?: number, minRelevance?: number): Promise<QueryResponse>;
+    /** Get sibling contexts (other chunks from the same document). */
+    getSiblingContexts(contextId: string): Promise<QueryResponse>;
+    /** Semantic search on entities. */
+    searchEntities(query: string, limit?: number, minRelevance?: number): Promise<QueryResponse>;
+    /** Find entity by exact name. Returns null if not found. */
+    getEntityByName(name: string): Promise<Entity | null>;
+    /** Find entity by name (case-insensitive). Returns null if not found. */
+    getEntityByNameIgnoreCase(name: string): Promise<Entity | null>;
+    /** Get entity ID by name. Returns null if not found. */
+    getEntityIdByName(name: string): Promise<string | null>;
+    /** Disambiguate entity using vector similarity with context. */
+    disambiguateEntity(entityName: string, contextText: string): Promise<Entity | null>;
+    /** Get all contexts where an entity is mentioned. */
+    getContextsForEntity(entityId: string): Promise<any[]>;
+    /** Get all entities mentioned in a context. */
+    getEntitiesForContext(contextId: string): Promise<Entity[]>;
+    /** Merge two entities (source into target). */
+    mergeEntities(sourceEntityId: string, targetEntityId: string): Promise<void>;
+    /** Semantic search on knowledge bases (history). */
+    searchHistory(query: string, limit?: number, minRelevance?: number): Promise<QueryResponse>;
+    /** Get all history for a user. */
+    getHistoryByUser(uid: string): Promise<QueryResponse>;
+    /** Get recent knowledge bases from the last N hours. */
+    getRecentKbs(hours?: number): Promise<QueryResponse>;
+    /** Get knowledge bases since a timestamp (ISO-8601). */
+    getKbsSince(since: string): Promise<QueryResponse>;
+    /** Delete all data for a user (GDPR compliance). */
+    deleteUserData(uid: string): Promise<void>;
+    /** Get outgoing relations for an entity. */
+    getOutgoingConnections(entityId: string): Promise<QueryResponse>;
+    /** Get incoming relations for an entity. */
+    getIncomingConnections(entityId: string): Promise<QueryResponse>;
+    /** Get 2-hop connections (entity names reachable in 2 hops). */
+    getTwoHopConnections(entityId: string): Promise<string[]>;
+    /** Get top/strongest relations. */
+    getTopRelations(limit?: number): Promise<Relation[]>;
+    /** Get relations by source entity. */
+    getRelationsBySource(sourceId: string): Promise<Relation[]>;
+    /** Get relations by target entity. */
+    getRelationsByTarget(targetId: string): Promise<Relation[]>;
+    /** Get relations by type. */
+    getRelationsByType(relationType: string): Promise<Relation[]>;
+    /** Hybrid search combining vector and graph results. */
+    hybridSearch(query: string, limit?: number, minRelevance?: number): Promise<QueryResponse>;
+    /** Route a query intelligently based on intent (PROMPT vs DOCUMENT). */
+    routeQuery(query: string): Promise<QueryResponse>;
+    /** @internal Send a POST query request and return the parsed response. */
+    private postQuery;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"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"}

package/dist/query.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Query API wrapper for CortexDB.
+ *
+ * Equivalent to cortexdb-py/cortexdb/query.py
+ * Mirrors all 18+ methods across contexts, entities, history,
+ * user-data, graph, and hybrid search endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryAPI = void 0;
+class QueryAPI {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    // ── Context endpoints ────────────────────────────────────────────
+    /**
+     * Semantic search on contexts.
+     *
+     * @param query         Search query text.
+     * @param limit         Maximum number of results (default 5).
+     * @param minRelevance  Minimum relevance score 0-1 (default 0.7).
+     * @param filters       Optional filters dict.
+     */
+    async searchContexts(query, limit = 5, minRelevance = 0.7, filters) {
+        return this.postQuery("/api/v1/memory/query/contexts", query, limit, minRelevance, filters);
+    }
+    /** Get all contexts for a knowledge base. */
+    async getContextsByKb(kbId) {
+        return this.http.get(`/api/v1/memory/query/contexts/kb/${kbId}`);
+    }
+    /** Get recent contexts from the last N days. */
+    async getRecentContexts(days = 7) {
+        return this.http.get("/api/v1/memory/query/contexts/recent", { days });
+    }
+    /** Search recent contexts with vector similarity. */
+    async searchRecentContexts(query, days = 7, limit = 5, minRelevance = 0.7) {
+        return this.postQuery("/api/v1/memory/query/contexts/recent/search", query, limit, minRelevance, undefined, { days });
+    }
+    /** Get sibling contexts (other chunks from the same document). */
+    async getSiblingContexts(contextId) {
+        return this.http.get(`/api/v1/memory/query/contexts/${contextId}/siblings`);
+    }
+    // ── Entity endpoints ─────────────────────────────────────────────
+    /** Semantic search on entities. */
+    async searchEntities(query, limit = 5, minRelevance = 0.7) {
+        return this.postQuery("/api/v1/memory/query/entities", query, limit, minRelevance);
+    }
+    /** Find entity by exact name. Returns null if not found. */
+    async getEntityByName(name) {
+        return this.http.get(`/api/v1/memory/query/entities/name/${name}`);
+    }
+    /** Find entity by name (case-insensitive). Returns null if not found. */
+    async getEntityByNameIgnoreCase(name) {
+        return this.http.get(`/api/v1/memory/query/entities/name/${name}/ignorecase`);
+    }
+    /** Get entity ID by name. Returns null if not found. */
+    async getEntityIdByName(name) {
+        const data = await this.http.get(`/api/v1/memory/query/entities/id/${name}`);
+        return data?.id ?? null;
+    }
+    /** Disambiguate entity using vector similarity with context. */
+    async disambiguateEntity(entityName, contextText) {
+        return this.http.post("/api/v1/memory/query/entities/disambiguate", contextText, { entityName }, { "Content-Type": "text/plain" });
+    }
+    /** Get all contexts where an entity is mentioned. */
+    async getContextsForEntity(entityId) {
+        return this.http.get(`/api/v1/memory/query/entities/${entityId}/contexts`);
+    }
+    /** Get all entities mentioned in a context. */
+    async getEntitiesForContext(contextId) {
+        return this.http.get(`/api/v1/memory/query/contexts/${contextId}/entities`);
+    }
+    /** Merge two entities (source into target). */
+    async mergeEntities(sourceEntityId, targetEntityId) {
+        await this.http.post("/api/v1/memory/query/entities/merge", undefined, { sourceEntityId, targetEntityId });
+    }
+    // ── History endpoints ────────────────────────────────────────────
+    /** Semantic search on knowledge bases (history). */
+    async searchHistory(query, limit = 5, minRelevance = 0.7) {
+        return this.postQuery("/api/v1/memory/query/history", query, limit, minRelevance);
+    }
+    /** Get all history for a user. */
+    async getHistoryByUser(uid) {
+        return this.http.get(`/api/v1/memory/query/history/user/${uid}`);
+    }
+    /** Get recent knowledge bases from the last N hours. */
+    async getRecentKbs(hours = 24) {
+        return this.http.get("/api/v1/memory/query/history/recent", { hours });
+    }
+    /** Get knowledge bases since a timestamp (ISO-8601). */
+    async getKbsSince(since) {
+        return this.http.get("/api/v1/memory/query/history/since", { since });
+    }
+    // ── User data ────────────────────────────────────────────────────
+    /** Delete all data for a user (GDPR compliance). */
+    async deleteUserData(uid) {
+        await this.http.delete(`/api/v1/memory/query/user/${uid}`);
+    }
+    // ── Graph endpoints ──────────────────────────────────────────────
+    /** Get outgoing relations for an entity. */
+    async getOutgoingConnections(entityId) {
+        return this.http.get(`/api/v1/memory/query/graph/outgoing/${entityId}`);
+    }
+    /** Get incoming relations for an entity. */
+    async getIncomingConnections(entityId) {
+        return this.http.get(`/api/v1/memory/query/graph/incoming/${entityId}`);
+    }
+    /** Get 2-hop connections (entity names reachable in 2 hops). */
+    async getTwoHopConnections(entityId) {
+        return this.http.get(`/api/v1/memory/query/graph/two-hop/${entityId}`);
+    }
+    /** Get top/strongest relations. */
+    async getTopRelations(limit = 10) {
+        return this.http.get("/api/v1/memory/query/graph/top-relations", { limit });
+    }
+    /** Get relations by source entity. */
+    async getRelationsBySource(sourceId) {
+        return this.http.get(`/api/v1/memory/query/graph/relations/source/${sourceId}`);
+    }
+    /** Get relations by target entity. */
+    async getRelationsByTarget(targetId) {
+        return this.http.get(`/api/v1/memory/query/graph/relations/target/${targetId}`);
+    }
+    /** Get relations by type. */
+    async getRelationsByType(relationType) {
+        return this.http.get(`/api/v1/memory/query/graph/relations/type/${relationType}`);
+    }
+    // ── Hybrid search ────────────────────────────────────────────────
+    /** Hybrid search combining vector and graph results. */
+    async hybridSearch(query, limit = 5, minRelevance = 0.7) {
+        return this.postQuery("/api/v1/memory/query/hybrid", query, limit, minRelevance);
+    }
+    // ── Pre-Routing / Agentic endpoints ──────────────────────────────
+    /** Route a query intelligently based on intent (PROMPT vs DOCUMENT). */
+    async routeQuery(query) {
+        return this.http.post("/api/v1/memory/query/route", { query, limit: 5, minRelevance: 0.7 });
+    }
+    // ── Internal helpers ─────────────────────────────────────────────
+    /** @internal Send a POST query request and return the parsed response. */
+    async postQuery(url, query, limit = 5, minRelevance = 0.7, filters, params) {
+        const request = { query, limit, minRelevance };
+        if (filters) {
+            request.filters = filters;
+        }
+        return this.http.post(url, request, params);
+    }
+}
+exports.QueryAPI = QueryAPI;
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"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"}

package/dist/setup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Setup API wrapper for CortexDB.
+ *
+ * Equivalent to cortexdb-py/cortexdb/setup.py
+ */
+import { HttpClient } from "./httpWrapper.js";
+import { LLMApiProvider, type SetupResponse } from "./models.js";
+export declare class SetupAPI {
+    private readonly http;
+    /** @internal */
+    constructor(http: HttpClient);
+    /**
+     * Configure the LLM provider on the CortexDB server.
+     *
+     * @param provider    LLM provider name (e.g. "GEMINI", "OPENAI", "AZURE").
+     * @param chatModel   Name of the chat model.
+     * @param embedModel  Name of the embedding model.
+     * @param apiKey      API key for the provider (optional).
+     * @param baseUrl     Custom base URL (optional).
+     * @returns SetupResponse with configuration details.
+     */
+    configure(provider: string | LLMApiProvider, chatModel: string, embedModel: string, apiKey?: string, baseUrl?: string): Promise<SetupResponse>;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACH,cAAc,EAEd,KAAK,aAAa,EACrB,MAAM,aAAa,CAAC;AAErB,qBAAa,QAAQ;IAEL,OAAO,CAAC,QAAQ,CAAC,IAAI;IADjC,gBAAgB;gBACa,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;OASG;IACG,SAAS,CACX,QAAQ,EAAE,MAAM,GAAG,cAAc,EACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;CAiB5B"}

package/dist/setup.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Setup API wrapper for CortexDB.
+ *
+ * Equivalent to cortexdb-py/cortexdb/setup.py
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetupAPI = void 0;
+class SetupAPI {
+    http;
+    /** @internal */
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Configure the LLM provider on the CortexDB server.
+     *
+     * @param provider    LLM provider name (e.g. "GEMINI", "OPENAI", "AZURE").
+     * @param chatModel   Name of the chat model.
+     * @param embedModel  Name of the embedding model.
+     * @param apiKey      API key for the provider (optional).
+     * @param baseUrl     Custom base URL (optional).
+     * @returns SetupResponse with configuration details.
+     */
+    async configure(provider, chatModel, embedModel, apiKey, baseUrl) {
+        // Normalise string provider to enum value
+        const resolvedProvider = typeof provider === "string"
+            ? provider.toUpperCase()
+            : provider;
+        const request = {
+            provider: resolvedProvider,
+            chatModelName: chatModel,
+            embedModelName: embedModel,
+            ...(apiKey !== undefined && { apiKey }),
+            ...(baseUrl !== undefined && { baseUrl }),
+        };
+        return this.http.post("/api/setup", request);
+    }
+}
+exports.SetupAPI = SetupAPI;
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AASH,MAAa,QAAQ;IAEY;IAD7B,gBAAgB;IAChB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAI,CAAC;IAElD;;;;;;;;;OASG;IACH,KAAK,CAAC,SAAS,CACX,QAAiC,EACjC,SAAiB,EACjB,UAAkB,EAClB,MAAe,EACf,OAAgB;QAEhB,0CAA0C;QAC1C,MAAM,gBAAgB,GAClB,OAAO,QAAQ,KAAK,QAAQ;YACxB,CAAC,CAAE,QAAQ,CAAC,WAAW,EAAqB;YAC5C,CAAC,CAAC,QAAQ,CAAC;QAEnB,MAAM,OAAO,GAAiB;YAC1B,QAAQ,EAAE,gBAAgB;YAC1B,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,UAAU;YAC1B,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;YACvC,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;SAC5C,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAgB,YAAY,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACJ;AArCD,4BAqCC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@harshit-sandilya/cortexdb-js",
+  "version": "0.2.8",
+  "description": "CortexDB JavaScript/TypeScript SDK — A RAG-powered memory database client.",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/harshit-sandilya/CortexDB.git"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsx main.ts",
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "test": "vitest run --config vitest.unit.config.ts",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:all": "vitest run --config vitest.unit.config.ts && vitest run --config vitest.e2e.config.ts",
+    "test:watch": "vitest --config vitest.unit.config.ts"
+  },
+  "keywords": [
+    "cortexdb",
+    "rag",
+    "vector-database",
+    "knowledge-graph",
+    "sdk"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "dotenv": "^17.3.1"
+  }
+}