@lumi0/sdk 0.0.5 → 0.0.7

package/README.md

@@ -450,7 +450,7 @@ The client accepts configuration options:
 ```ts
 const client = new Lumi0({
     apiKey: process.env.LUMI0_API_KEY!,
-    baseUrl: "https://api.lumi0.com/api/v1",
+    baseUrl: "https://api.lumi0.com/memory/v1",
     timeout: 30_000,
 });
 ```
@@ -470,7 +470,7 @@ The Lumi0 API endpoint.
 Default:
 
 ```text
-https://api.lumi0.com/api/v1
+https://api.lumi0.com/memory/v1
 ```
 
 You can override it:
@@ -478,7 +478,7 @@ You can override it:
 ```ts
 const client = new Lumi0({
     apiKey: process.env.LUMI0_API_KEY!,
-    baseUrl: "https://api.lumi0.com/api/v1",
+    baseUrl: "https://api.lumi0.com/memory/v1",
 });
 ```
 

package/dist/index.d.mts

@@ -23,20 +23,28 @@ interface StoreMemoryInput {
   content: string;
   dedupeThreshold?: number;
   id: string;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface BuildContextInput {
   id: string;
   query: string;
   limit?: number;
   minSimilarity?: number;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface UploadFileInput {
   id: string;
   url: string;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface MemoryRollbackInput {
   memoryId: string;
   version: number;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface SearchMemoryInput {
   query: string;
@@ -44,10 +52,14 @@ interface SearchMemoryInput {
   minSimilarity?: number;
   memoryType?: string;
   id: string;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface GetMemoryInput {
   id: string;
   version?: number;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface CompressMemoryInput {
   content: string;
@@ -85,6 +97,8 @@ interface Compress {
 }
 interface ForgetMemoryInput {
   id: string;
+  /** Required for universal (org-wide) API keys. */
+  collectionId?: string;
 }
 interface Context {
   data: string;
@@ -110,11 +124,11 @@ declare class HttpClient {
   private readonly options;
   constructor(options: HttpClientOptions);
   request<T>(path: string, init?: RequestInit): Promise<T>;
-  get<T>(path: string): Promise<T>;
-  post<T>(path: string, body?: unknown): Promise<T>;
+  get<T>(path: string, init?: RequestInit): Promise<T>;
+  post<T>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
   put<T>(path: string, body?: unknown): Promise<T>;
   patch<T>(path: string, body?: unknown): Promise<T>;
-  delete<T>(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<T>;
+  delete<T>(path: string, query?: Record<string, string | number | boolean | undefined>, init?: RequestInit): Promise<T>;
   private parseError;
 }
 //#endregion
@@ -122,7 +136,15 @@ declare class HttpClient {
 declare class MemoryApi {
   private readonly http;
   constructor(http: HttpClient);
-  history(id: string): Promise<MemoryVersion[]>;
+  store(input: StoreMemoryInput): Promise<unknown>;
+  search(input: SearchMemoryInput): Promise<Search>;
+  get(input: GetMemoryInput): Promise<Search>;
+  forget(input: ForgetMemoryInput): Promise<unknown>;
+  batch(input: StoreMemoryInput[]): Promise<unknown>;
+  context(input: BuildContextInput): Promise<Context>;
+  files(input: UploadFileInput): Promise<unknown>;
+  compress(input: CompressMemoryInput): Promise<Compress>;
+  history(id: string, collectionId?: string): Promise<MemoryVersion[]>;
   rollback(input: MemoryRollbackInput): Promise<unknown>;
 }
 //#endregion
@@ -141,4 +163,4 @@ declare class Lumi0 {
   compress(input: CompressMemoryInput): Promise<Compress>;
 }
 //#endregion
-export { BuildContextInput, Compress, CompressMemoryInput, Context, ErrorResponse, ForgetMemoryInput, GetMemoryInput, HttpClientOptions, IPostBody, Lumi0, Lumi0Options, MemoryRollbackInput, MemoryVersion, PostBody, Search, SearchMemoryInput, StoreMemoryInput, UploadFileInput };
+export { BuildContextInput, Compress, CompressMemoryInput, Context, ErrorResponse, ForgetMemoryInput, GetMemoryInput, HttpClient, HttpClientOptions, IPostBody, Lumi0, Lumi0Options, MemoryApi, MemoryRollbackInput, MemoryVersion, PostBody, Search, SearchMemoryInput, StoreMemoryInput, UploadFileInput };

package/dist/index.mjs

@@ -27,11 +27,12 @@ var HttpClient = class {
 			clearTimeout(timeout);
 		}
 	}
-	get(path) {
-		return this.request(path);
+	get(path, init) {
+		return this.request(path, init);
 	}
-	post(path, body) {
+	post(path, body, init) {
 		return this.request(path, {
+			...init,
 			method: "POST",
 			body: body ? JSON.stringify(body) : void 0
 		});
@@ -48,13 +49,16 @@ var HttpClient = class {
 			body: body ? JSON.stringify(body) : void 0
 		});
 	}
-	delete(path, query) {
+	delete(path, query, init) {
 		const params = new URLSearchParams();
 		if (query) {
 			for (const [key, value] of Object.entries(query)) if (value !== void 0) params.append(key, String(value));
 		}
 		const url = params.toString() ? `${path}?${params}` : path;
-		return this.request(url, { method: "DELETE" });
+		return this.request(url, {
+			...init,
+			method: "DELETE"
+		});
 	}
 	async parseError(response) {
 		let message = response.statusText;
@@ -67,16 +71,62 @@ var HttpClient = class {
 };
 //#endregion
 //#region src/memory.ts
+/**
+* Universal (org-wide) API keys must target a collection per request. The
+* memory service reads it from the `X-Collection-Id` header for routes
+* without a body channel (`DELETE /memory/:id`, history, rollback), so the
+* SDK sends it as a header instead of a query param.
+*/
+function collectionHeader(collectionId) {
+	return collectionId ? { headers: { "X-Collection-Id": collectionId } } : void 0;
+}
 var MemoryApi = class {
 	http;
 	constructor(http) {
 		this.http = http;
 	}
-	history(id) {
-		return this.http.get(`/memories/history/${id}`).then((response) => response.data);
+	store(input) {
+		return this.http.post("/memory", {
+			...input,
+			externalId: input.id
+		});
+	}
+	search(input) {
+		return this.http.post("/memory/search", {
+			...input,
+			externalId: input.id
+		}).then((res) => res.data);
+	}
+	get(input) {
+		return this.http.post("/memory/get", input).then((res) => res.data);
+	}
+	forget(input) {
+		return this.http.delete(`/memory/${input.id}`, void 0, collectionHeader(input.collectionId));
+	}
+	batch(input) {
+		return this.http.post("/memory/batch", input.map((item) => ({ ...item })));
+	}
+	context(input) {
+		return this.http.post("/memory/context", {
+			...input,
+			externalId: input.id
+		}).then((res) => res.data);
+	}
+	files(input) {
+		return this.http.post("/file/uploads", {
+			url: input.url,
+			id: input.id,
+			collectionId: input.collectionId
+		});
+	}
+	compress(input) {
+		return this.http.post("/compress", input).then((res) => res.data);
+	}
+	history(id, collectionId) {
+		return this.http.get(`/memories/history/${id}`, collectionHeader(collectionId)).then((response) => response.data);
 	}
 	rollback(input) {
-		return this.http.post(`/memories/${input.memoryId}/versions/${input.version}/rollback`);
+		return this.http.post(`/memories/${input.memoryId}/versions/${input.version}/rollback`, void 0, collectionHeader(input.collectionId));
 	}
 };
 //#endregion
@@ -87,48 +137,36 @@ var Lumi0 = class {
 	constructor(option) {
 		const apiKey = option.apiKey;
 		this.http = new HttpClient({
-			baseUrl: option.baseUrl ?? "https://api.lumi0.com/api/v1",
+			baseUrl: option.baseUrl ?? "https://api.lumi0.com/memory/v1",
 			apiKey,
 			timeout: option.timeout ?? 3e4
 		});
 		this.mem = new MemoryApi(this.http);
 	}
 	store(input) {
-		return this.http.post("/memory", {
-			...input,
-			externalId: input.id
-		});
+		return this.mem.store(input);
 	}
 	search(input) {
-		return this.http.post("/memory/search", {
-			...input,
-			externalId: input.id
-		}).then((res) => res.data);
+		return this.mem.search(input);
 	}
 	get(input) {
-		return this.http.post("/memory/get", input).then((res) => res.data);
+		return this.mem.get(input);
 	}
 	forget(input) {
-		return this.http.delete(`/memory/${input.id}`);
+		return this.mem.forget(input);
 	}
 	batch(input) {
-		return this.http.post("/memory/batch", input.map((item) => ({ ...item })));
+		return this.mem.batch(input);
 	}
 	context(input) {
-		return this.http.post("/memory/context", {
-			...input,
-			externalId: input.id
-		}).then((res) => res.data);
+		return this.mem.context(input);
 	}
 	files(input) {
-		return this.http.post("/memory/batch", {
-			...input,
-			externalId: input.id
-		});
+		return this.mem.files(input);
 	}
 	compress(input) {
-		return this.http.post("/compress", input).then((res) => res.data);
+		return this.mem.compress(input);
 	}
 };
 //#endregion
-export { Lumi0 };
+export { HttpClient, Lumi0, MemoryApi };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lumi0/sdk",
-	"version": "0.0.5",
+	"version": "0.0.7",
 	"description": "Official TypeScript SDK for Lumi0",
 	"type": "module",
 	"license": "MIT",
@@ -33,6 +33,7 @@
 	"scripts": {
 		"build": "tsdown index.ts",
 		"dev": "bun --watch index.ts",
+		"test": "bun test",
 		"typecheck": "tsc --noEmit",
 		"prepublishOnly": "bun run typecheck && bun run build"
 	},