unimemory 1.0.2 → 2.0.0

package/README.md

@@ -37,7 +37,7 @@ Create a new UniMemory client.
 ```typescript
 const client = new UniMemory({
   apiKey: 'um_live_xxx...',
-  baseUrl: 'https://api.unimemory.ai/api/v1' // optional
+  baseUrl: 'https://unimemory.up.railway.app/api/v1' // optional, defaults to production API
 });
 ```
 

package/dist/index.d.mts

@@ -1,62 +1,106 @@
 /**
- * UniMemory SDK
- * AI memory management for your applications
+ * UniMemory SDK v2
+ * The memory layer for AI applications
+ *
+ * Core API:    POST/GET/PATCH/DELETE /memories, POST /search
+ * Ingest API:  POST /ingest/text, /ingest/chat, /ingest/document
  */
 interface UniMemoryConfig {
     apiKey: string;
     baseUrl?: string;
 }
-interface AddMemoryOptions {
+interface CreateMemoryOptions {
     content: string;
-    sourceApp?: string;
     userId?: string;
+    appId?: string;
+    tags?: string[];
     metadata?: Record<string, unknown>;
+    projectId?: string;
 }
-interface AddMemoryResponse {
-    wasWorthRemembering: boolean;
-    reason?: string;
-    extractedCount: number;
-    memories?: Array<{
-        id: string;
-        wasDeduplicated: boolean;
-    }>;
+interface CreateMemoryResponse {
+    id: string;
+    createdAt: string;
+}
+interface Memory {
+    id: string;
+    content: string;
+    userId: string;
+    tags: string[];
+    salience: number;
+    createdAt: string;
+}
+interface ListMemoriesOptions {
+    limit?: number;
+    offset?: number;
+    userId?: string;
+    sector?: string;
+}
+interface ListMemoriesResponse {
+    memories: Memory[];
+    total: number;
+}
+interface UpdateMemoryOptions {
+    tags?: string[];
+    salience?: number;
+    metadata?: Record<string, unknown>;
 }
 interface SearchOptions {
     limit?: number;
     userId?: string;
     minSalience?: number;
-    debug?: boolean;
+    projectId?: string;
 }
 interface SearchResult {
     id: string;
     content: string;
-    sector?: string;
-    salience: number;
-    score: number;
     tags: string[];
+    salience: number;
+    createdAt?: string;
 }
 interface SearchResponse {
     results: SearchResult[];
     total: number;
     query: string;
 }
-interface Memory {
-    id: string;
+interface IngestTextOptions {
     content: string;
-    sector?: string;
-    salience: number;
-    tags: string[];
-    createdAt: string;
+    userId?: string;
+    appId?: string;
+    sourceId?: string;
+    projectId?: string;
+    createSource?: boolean;
 }
-interface ListMemoriesOptions {
-    limit?: number;
-    offset?: number;
+interface IngestChatOptions {
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
     userId?: string;
-    sector?: string;
+    appId?: string;
+    sourceId?: string;
+    projectId?: string;
+    sourceMetadata?: Record<string, unknown>;
 }
-interface ListMemoriesResponse {
-    memories: Memory[];
-    total: number;
+interface IngestDocumentOptions {
+    content: string;
+    title?: string;
+    userId?: string;
+    appId?: string;
+    sourceId?: string;
+    projectId?: string;
+}
+interface IngestResponse {
+    stored: number;
+    skipped: number;
+    memoryIds: string[];
+    tokensUsed: number;
+    sourceId?: string;
+    sourceTitle?: string;
+}
+declare class UniMemoryError extends Error {
+    status?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
 }
 declare class UniMemory {
     private apiKey;
@@ -64,23 +108,45 @@ declare class UniMemory {
     constructor(config: UniMemoryConfig);
     private request;
     /**
-     * Add a memory to UniMemory
+     * Store an explicit memory (deterministic, no LLM).
      */
-    addMemory(options: AddMemoryOptions): Promise<AddMemoryResponse>;
+    add(options: CreateMemoryOptions): Promise<CreateMemoryResponse>;
     /**
-     * Search memories
+     * List memories with optional filters.
      */
-    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    list(options?: ListMemoriesOptions): Promise<ListMemoriesResponse>;
+    /**
+     * Get a single memory by ID.
+     */
+    get(memoryId: string): Promise<Memory>;
     /**
-     * List memories
+     * Update a memory (tags, salience, metadata only — content cannot be changed).
      */
-    listMemories(options?: ListMemoriesOptions): Promise<ListMemoriesResponse>;
+    update(memoryId: string, options: UpdateMemoryOptions): Promise<Memory>;
     /**
-     * Delete a memory
+     * Delete a memory.
      */
-    deleteMemory(memoryId: string): Promise<{
+    delete(memoryId: string): Promise<{
         success: boolean;
+        id: string;
     }>;
+    /**
+     * Semantic search across memories.
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Ingest raw text — LLM extracts memories in the background.
+     */
+    ingestText(options: IngestTextOptions): Promise<IngestResponse>;
+    /**
+     * Ingest chat messages — LLM extracts memories in the background.
+     */
+    ingestChat(options: IngestChatOptions): Promise<IngestResponse>;
+    /**
+     * Ingest a document — LLM extracts memories in the background.
+     */
+    ingestDocument(options: IngestDocumentOptions): Promise<IngestResponse>;
+    private ingestRequest;
 }
 
-export { type AddMemoryOptions, type AddMemoryResponse, type ListMemoriesOptions, type ListMemoriesResponse, type Memory, type SearchOptions, type SearchResponse, type SearchResult, UniMemory, type UniMemoryConfig, UniMemory as default };
+export { type CreateMemoryOptions, type CreateMemoryResponse, type IngestChatOptions, type IngestDocumentOptions, type IngestResponse, type IngestTextOptions, type ListMemoriesOptions, type ListMemoriesResponse, type Memory, type SearchOptions, type SearchResponse, type SearchResult, UniMemory, type UniMemoryConfig, UniMemoryError, type UpdateMemoryOptions, UniMemory as default };

package/dist/index.d.ts

@@ -1,62 +1,106 @@
 /**
- * UniMemory SDK
- * AI memory management for your applications
+ * UniMemory SDK v2
+ * The memory layer for AI applications
+ *
+ * Core API:    POST/GET/PATCH/DELETE /memories, POST /search
+ * Ingest API:  POST /ingest/text, /ingest/chat, /ingest/document
  */
 interface UniMemoryConfig {
     apiKey: string;
     baseUrl?: string;
 }
-interface AddMemoryOptions {
+interface CreateMemoryOptions {
     content: string;
-    sourceApp?: string;
     userId?: string;
+    appId?: string;
+    tags?: string[];
     metadata?: Record<string, unknown>;
+    projectId?: string;
 }
-interface AddMemoryResponse {
-    wasWorthRemembering: boolean;
-    reason?: string;
-    extractedCount: number;
-    memories?: Array<{
-        id: string;
-        wasDeduplicated: boolean;
-    }>;
+interface CreateMemoryResponse {
+    id: string;
+    createdAt: string;
+}
+interface Memory {
+    id: string;
+    content: string;
+    userId: string;
+    tags: string[];
+    salience: number;
+    createdAt: string;
+}
+interface ListMemoriesOptions {
+    limit?: number;
+    offset?: number;
+    userId?: string;
+    sector?: string;
+}
+interface ListMemoriesResponse {
+    memories: Memory[];
+    total: number;
+}
+interface UpdateMemoryOptions {
+    tags?: string[];
+    salience?: number;
+    metadata?: Record<string, unknown>;
 }
 interface SearchOptions {
     limit?: number;
     userId?: string;
     minSalience?: number;
-    debug?: boolean;
+    projectId?: string;
 }
 interface SearchResult {
     id: string;
     content: string;
-    sector?: string;
-    salience: number;
-    score: number;
     tags: string[];
+    salience: number;
+    createdAt?: string;
 }
 interface SearchResponse {
     results: SearchResult[];
     total: number;
     query: string;
 }
-interface Memory {
-    id: string;
+interface IngestTextOptions {
     content: string;
-    sector?: string;
-    salience: number;
-    tags: string[];
-    createdAt: string;
+    userId?: string;
+    appId?: string;
+    sourceId?: string;
+    projectId?: string;
+    createSource?: boolean;
 }
-interface ListMemoriesOptions {
-    limit?: number;
-    offset?: number;
+interface IngestChatOptions {
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
     userId?: string;
-    sector?: string;
+    appId?: string;
+    sourceId?: string;
+    projectId?: string;
+    sourceMetadata?: Record<string, unknown>;
 }
-interface ListMemoriesResponse {
-    memories: Memory[];
-    total: number;
+interface IngestDocumentOptions {
+    content: string;
+    title?: string;
+    userId?: string;
+    appId?: string;
+    sourceId?: string;
+    projectId?: string;
+}
+interface IngestResponse {
+    stored: number;
+    skipped: number;
+    memoryIds: string[];
+    tokensUsed: number;
+    sourceId?: string;
+    sourceTitle?: string;
+}
+declare class UniMemoryError extends Error {
+    status?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
 }
 declare class UniMemory {
     private apiKey;
@@ -64,23 +108,45 @@ declare class UniMemory {
     constructor(config: UniMemoryConfig);
     private request;
     /**
-     * Add a memory to UniMemory
+     * Store an explicit memory (deterministic, no LLM).
      */
-    addMemory(options: AddMemoryOptions): Promise<AddMemoryResponse>;
+    add(options: CreateMemoryOptions): Promise<CreateMemoryResponse>;
     /**
-     * Search memories
+     * List memories with optional filters.
      */
-    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    list(options?: ListMemoriesOptions): Promise<ListMemoriesResponse>;
+    /**
+     * Get a single memory by ID.
+     */
+    get(memoryId: string): Promise<Memory>;
     /**
-     * List memories
+     * Update a memory (tags, salience, metadata only — content cannot be changed).
      */
-    listMemories(options?: ListMemoriesOptions): Promise<ListMemoriesResponse>;
+    update(memoryId: string, options: UpdateMemoryOptions): Promise<Memory>;
     /**
-     * Delete a memory
+     * Delete a memory.
      */
-    deleteMemory(memoryId: string): Promise<{
+    delete(memoryId: string): Promise<{
         success: boolean;
+        id: string;
     }>;
+    /**
+     * Semantic search across memories.
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Ingest raw text — LLM extracts memories in the background.
+     */
+    ingestText(options: IngestTextOptions): Promise<IngestResponse>;
+    /**
+     * Ingest chat messages — LLM extracts memories in the background.
+     */
+    ingestChat(options: IngestChatOptions): Promise<IngestResponse>;
+    /**
+     * Ingest a document — LLM extracts memories in the background.
+     */
+    ingestDocument(options: IngestDocumentOptions): Promise<IngestResponse>;
+    private ingestRequest;
 }
 
-export { type AddMemoryOptions, type AddMemoryResponse, type ListMemoriesOptions, type ListMemoriesResponse, type Memory, type SearchOptions, type SearchResponse, type SearchResult, UniMemory, type UniMemoryConfig, UniMemory as default };
+export { type CreateMemoryOptions, type CreateMemoryResponse, type IngestChatOptions, type IngestDocumentOptions, type IngestResponse, type IngestTextOptions, type ListMemoriesOptions, type ListMemoriesResponse, type Memory, type SearchOptions, type SearchResponse, type SearchResult, UniMemory, type UniMemoryConfig, UniMemoryError, type UpdateMemoryOptions, UniMemory as default };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   UniMemory: () => UniMemory,
+  UniMemoryError: () => UniMemoryError,
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
@@ -38,102 +39,192 @@ var UniMemory = class {
       throw new UniMemoryError("API key is required");
     }
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl || "https://api.unimemory.ai/api/v1";
+    this.baseUrl = (config.baseUrl || "https://unimemory.up.railway.app/api/v1").replace(/\/$/, "");
   }
   async request(method, path, body) {
-    const url = `${this.baseUrl}${path}`;
     const headers = {
       "Content-Type": "application/json",
       "X-API-Key": this.apiKey
     };
-    const options = {
-      method,
-      headers
-    };
-    if (body) {
-      options.body = JSON.stringify(body);
-    }
-    const response = await fetch(url, options);
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
+    const init = { method, headers };
+    if (body) init.body = JSON.stringify(body);
+    const res = await fetch(`${this.baseUrl}${path}`, init);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
       throw new UniMemoryError(
-        error.detail || `Request failed with status ${response.status}`,
-        response.status,
-        error.code
+        err.detail || `Request failed with status ${res.status}`,
+        res.status,
+        err.code
       );
     }
-    return response.json();
+    if (res.status === 204) return {};
+    return res.json();
   }
+  // -------------------------------------------------------------------------
+  // Core Memory API
+  // -------------------------------------------------------------------------
   /**
-   * Add a memory to UniMemory
+   * Store an explicit memory (deterministic, no LLM).
    */
-  async addMemory(options) {
-    const response = await this.request("POST", "/memories/add", {
-      content: options.content,
-      source_app: options.sourceApp,
-      user_id: options.userId,
+  async add(options) {
+    const res = await this.request(
+      "POST",
+      "/memories",
+      {
+        content: options.content,
+        user_id: options.userId,
+        app_id: options.appId,
+        tags: options.tags,
+        metadata: options.metadata,
+        project_id: options.projectId
+      }
+    );
+    return { id: res.id, createdAt: res.created_at };
+  }
+  /**
+   * List memories with optional filters.
+   */
+  async list(options) {
+    const p = new URLSearchParams();
+    if (options?.limit) p.set("limit", String(options.limit));
+    if (options?.offset) p.set("offset", String(options.offset));
+    if (options?.userId) p.set("user_id", options.userId);
+    if (options?.sector) p.set("sector", options.sector);
+    const qs = p.toString();
+    const res = await this.request("GET", `/memories${qs ? `?${qs}` : ""}`);
+    return {
+      memories: res.memories.map((m) => ({
+        id: m.id,
+        content: m.content,
+        userId: m.user_id,
+        tags: m.tags,
+        salience: m.salience,
+        createdAt: m.created_at
+      })),
+      total: res.total
+    };
+  }
+  /**
+   * Get a single memory by ID.
+   */
+  async get(memoryId) {
+    const m = await this.request("GET", `/memories/${memoryId}`);
+    return {
+      id: m.id,
+      content: m.content,
+      userId: m.user_id,
+      tags: m.tags,
+      salience: m.salience,
+      createdAt: m.created_at
+    };
+  }
+  /**
+   * Update a memory (tags, salience, metadata only — content cannot be changed).
+   */
+  async update(memoryId, options) {
+    const m = await this.request("PATCH", `/memories/${memoryId}`, {
+      tags: options.tags,
+      salience: options.salience,
       metadata: options.metadata
     });
     return {
-      wasWorthRemembering: response.was_worth_remembering,
-      reason: response.reason,
-      extractedCount: response.extracted_count,
-      memories: response.memories?.map((m) => ({
-        id: m.id,
-        wasDeduplicated: m.was_deduplicated
-      }))
+      id: m.id,
+      content: m.content,
+      userId: m.user_id,
+      tags: m.tags,
+      salience: m.salience,
+      createdAt: m.created_at
     };
   }
   /**
-   * Search memories
+   * Delete a memory.
+   */
+  async delete(memoryId) {
+    return this.request("DELETE", `/memories/${memoryId}`);
+  }
+  // -------------------------------------------------------------------------
+  // Search API
+  // -------------------------------------------------------------------------
+  /**
+   * Semantic search across memories.
    */
   async search(query, options) {
-    const response = await this.request("POST", "/search", {
+    const res = await this.request("POST", "/search", {
       query,
       limit: options?.limit,
       user_id: options?.userId,
       min_salience: options?.minSalience,
-      debug: options?.debug
+      project_id: options?.projectId
     });
     return {
-      results: response.results,
-      total: response.total,
-      query: response.query
+      results: res.results.map((r) => ({
+        id: r.id,
+        content: r.content,
+        tags: r.tags,
+        salience: r.salience,
+        createdAt: r.created_at
+      })),
+      total: res.total,
+      query: res.query
     };
   }
+  // -------------------------------------------------------------------------
+  // Ingest API (LLM-powered, background processing)
+  // -------------------------------------------------------------------------
   /**
-   * List memories
+   * Ingest raw text — LLM extracts memories in the background.
    */
-  async listMemories(options) {
-    const params = new URLSearchParams();
-    if (options?.limit) params.set("limit", options.limit.toString());
-    if (options?.offset) params.set("offset", options.offset.toString());
-    if (options?.userId) params.set("user_id", options.userId);
-    if (options?.sector) params.set("sector", options.sector);
-    const queryString = params.toString();
-    const path = `/memories${queryString ? `?${queryString}` : ""}`;
-    const response = await this.request("GET", path);
-    return {
-      memories: response.memories.map((m) => ({
-        id: m.id,
-        content: m.content,
-        sector: m.sector,
-        salience: m.salience,
-        tags: m.tags,
-        createdAt: m.created_at
-      })),
-      total: response.total
-    };
+  async ingestText(options) {
+    return this.ingestRequest("/ingest/text", {
+      content: options.content,
+      user_id: options.userId,
+      app_id: options.appId,
+      source_id: options.sourceId,
+      project_id: options.projectId,
+      create_source: options.createSource
+    });
   }
   /**
-   * Delete a memory
+   * Ingest chat messages — LLM extracts memories in the background.
    */
-  async deleteMemory(memoryId) {
-    return this.request("DELETE", `/memories/${memoryId}`);
+  async ingestChat(options) {
+    return this.ingestRequest("/ingest/chat", {
+      messages: options.messages,
+      user_id: options.userId,
+      app_id: options.appId,
+      source_id: options.sourceId,
+      project_id: options.projectId,
+      source_metadata: options.sourceMetadata
+    });
+  }
+  /**
+   * Ingest a document — LLM extracts memories in the background.
+   */
+  async ingestDocument(options) {
+    return this.ingestRequest("/ingest/document", {
+      content: options.content,
+      title: options.title,
+      user_id: options.userId,
+      app_id: options.appId,
+      source_id: options.sourceId,
+      project_id: options.projectId
+    });
+  }
+  async ingestRequest(path, body) {
+    const res = await this.request("POST", path, body);
+    return {
+      stored: res.stored,
+      skipped: res.skipped,
+      memoryIds: res.memory_ids,
+      tokensUsed: res.tokens_used,
+      sourceId: res.source_id,
+      sourceTitle: res.source_title
+    };
   }
 };
 var index_default = UniMemory;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  UniMemory
+  UniMemory,
+  UniMemoryError
 });

package/dist/index.mjs

@@ -13,102 +13,192 @@ var UniMemory = class {
       throw new UniMemoryError("API key is required");
     }
     this.apiKey = config.apiKey;
-    this.baseUrl = config.baseUrl || "https://api.unimemory.ai/api/v1";
+    this.baseUrl = (config.baseUrl || "https://unimemory.up.railway.app/api/v1").replace(/\/$/, "");
   }
   async request(method, path, body) {
-    const url = `${this.baseUrl}${path}`;
     const headers = {
       "Content-Type": "application/json",
       "X-API-Key": this.apiKey
     };
-    const options = {
-      method,
-      headers
-    };
-    if (body) {
-      options.body = JSON.stringify(body);
-    }
-    const response = await fetch(url, options);
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
+    const init = { method, headers };
+    if (body) init.body = JSON.stringify(body);
+    const res = await fetch(`${this.baseUrl}${path}`, init);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
       throw new UniMemoryError(
-        error.detail || `Request failed with status ${response.status}`,
-        response.status,
-        error.code
+        err.detail || `Request failed with status ${res.status}`,
+        res.status,
+        err.code
       );
     }
-    return response.json();
+    if (res.status === 204) return {};
+    return res.json();
   }
+  // -------------------------------------------------------------------------
+  // Core Memory API
+  // -------------------------------------------------------------------------
   /**
-   * Add a memory to UniMemory
+   * Store an explicit memory (deterministic, no LLM).
    */
-  async addMemory(options) {
-    const response = await this.request("POST", "/memories/add", {
-      content: options.content,
-      source_app: options.sourceApp,
-      user_id: options.userId,
+  async add(options) {
+    const res = await this.request(
+      "POST",
+      "/memories",
+      {
+        content: options.content,
+        user_id: options.userId,
+        app_id: options.appId,
+        tags: options.tags,
+        metadata: options.metadata,
+        project_id: options.projectId
+      }
+    );
+    return { id: res.id, createdAt: res.created_at };
+  }
+  /**
+   * List memories with optional filters.
+   */
+  async list(options) {
+    const p = new URLSearchParams();
+    if (options?.limit) p.set("limit", String(options.limit));
+    if (options?.offset) p.set("offset", String(options.offset));
+    if (options?.userId) p.set("user_id", options.userId);
+    if (options?.sector) p.set("sector", options.sector);
+    const qs = p.toString();
+    const res = await this.request("GET", `/memories${qs ? `?${qs}` : ""}`);
+    return {
+      memories: res.memories.map((m) => ({
+        id: m.id,
+        content: m.content,
+        userId: m.user_id,
+        tags: m.tags,
+        salience: m.salience,
+        createdAt: m.created_at
+      })),
+      total: res.total
+    };
+  }
+  /**
+   * Get a single memory by ID.
+   */
+  async get(memoryId) {
+    const m = await this.request("GET", `/memories/${memoryId}`);
+    return {
+      id: m.id,
+      content: m.content,
+      userId: m.user_id,
+      tags: m.tags,
+      salience: m.salience,
+      createdAt: m.created_at
+    };
+  }
+  /**
+   * Update a memory (tags, salience, metadata only — content cannot be changed).
+   */
+  async update(memoryId, options) {
+    const m = await this.request("PATCH", `/memories/${memoryId}`, {
+      tags: options.tags,
+      salience: options.salience,
       metadata: options.metadata
     });
     return {
-      wasWorthRemembering: response.was_worth_remembering,
-      reason: response.reason,
-      extractedCount: response.extracted_count,
-      memories: response.memories?.map((m) => ({
-        id: m.id,
-        wasDeduplicated: m.was_deduplicated
-      }))
+      id: m.id,
+      content: m.content,
+      userId: m.user_id,
+      tags: m.tags,
+      salience: m.salience,
+      createdAt: m.created_at
     };
   }
   /**
-   * Search memories
+   * Delete a memory.
+   */
+  async delete(memoryId) {
+    return this.request("DELETE", `/memories/${memoryId}`);
+  }
+  // -------------------------------------------------------------------------
+  // Search API
+  // -------------------------------------------------------------------------
+  /**
+   * Semantic search across memories.
    */
   async search(query, options) {
-    const response = await this.request("POST", "/search", {
+    const res = await this.request("POST", "/search", {
       query,
       limit: options?.limit,
       user_id: options?.userId,
       min_salience: options?.minSalience,
-      debug: options?.debug
+      project_id: options?.projectId
     });
     return {
-      results: response.results,
-      total: response.total,
-      query: response.query
+      results: res.results.map((r) => ({
+        id: r.id,
+        content: r.content,
+        tags: r.tags,
+        salience: r.salience,
+        createdAt: r.created_at
+      })),
+      total: res.total,
+      query: res.query
     };
   }
+  // -------------------------------------------------------------------------
+  // Ingest API (LLM-powered, background processing)
+  // -------------------------------------------------------------------------
   /**
-   * List memories
+   * Ingest raw text — LLM extracts memories in the background.
    */
-  async listMemories(options) {
-    const params = new URLSearchParams();
-    if (options?.limit) params.set("limit", options.limit.toString());
-    if (options?.offset) params.set("offset", options.offset.toString());
-    if (options?.userId) params.set("user_id", options.userId);
-    if (options?.sector) params.set("sector", options.sector);
-    const queryString = params.toString();
-    const path = `/memories${queryString ? `?${queryString}` : ""}`;
-    const response = await this.request("GET", path);
-    return {
-      memories: response.memories.map((m) => ({
-        id: m.id,
-        content: m.content,
-        sector: m.sector,
-        salience: m.salience,
-        tags: m.tags,
-        createdAt: m.created_at
-      })),
-      total: response.total
-    };
+  async ingestText(options) {
+    return this.ingestRequest("/ingest/text", {
+      content: options.content,
+      user_id: options.userId,
+      app_id: options.appId,
+      source_id: options.sourceId,
+      project_id: options.projectId,
+      create_source: options.createSource
+    });
   }
   /**
-   * Delete a memory
+   * Ingest chat messages — LLM extracts memories in the background.
    */
-  async deleteMemory(memoryId) {
-    return this.request("DELETE", `/memories/${memoryId}`);
+  async ingestChat(options) {
+    return this.ingestRequest("/ingest/chat", {
+      messages: options.messages,
+      user_id: options.userId,
+      app_id: options.appId,
+      source_id: options.sourceId,
+      project_id: options.projectId,
+      source_metadata: options.sourceMetadata
+    });
+  }
+  /**
+   * Ingest a document — LLM extracts memories in the background.
+   */
+  async ingestDocument(options) {
+    return this.ingestRequest("/ingest/document", {
+      content: options.content,
+      title: options.title,
+      user_id: options.userId,
+      app_id: options.appId,
+      source_id: options.sourceId,
+      project_id: options.projectId
+    });
+  }
+  async ingestRequest(path, body) {
+    const res = await this.request("POST", path, body);
+    return {
+      stored: res.stored,
+      skipped: res.skipped,
+      memoryIds: res.memory_ids,
+      tokensUsed: res.tokens_used,
+      sourceId: res.source_id,
+      sourceTitle: res.source_title
+    };
   }
 };
 var index_default = UniMemory;
 export {
   UniMemory,
+  UniMemoryError,
   index_default as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unimemory",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "UniMemory SDK - The memory layer for your AI apps.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",