@dakera-ai/dakera 0.9.8 → 0.9.10

package/dist/index.d.mts

@@ -453,12 +453,14 @@ interface RecalledMemory {
     metadata?: Record<string, unknown>;
     /** Creation timestamp */
     created_at?: string;
+    /** KG-3: hop depth at which this memory was found (only set on associated memories) */
+    depth?: number;
 }
-/** COG-2: Response from the recall endpoint with optional associative memories */
+/** COG-2 / KG-3: Response from the recall endpoint with optional associative memories */
 interface RecallResponse {
     /** Primary recalled memories */
     memories: RecalledMemory[];
-    /** COG-2: KG depth-1 associated memories (only present when include_associated was true) */
+    /** COG-2 / KG-3: KG associated memories at configurable depth (only present when include_associated was true) */
     associated_memories?: RecalledMemory[];
 }
 /** Response from storing a memory */
@@ -487,6 +489,14 @@ interface RecallRequest {
     memory_type?: string;
     /** Minimum importance threshold */
     min_importance?: number;
+    /** CE-7: only recall memories created at or after this ISO-8601 timestamp */
+    since?: string;
+    /** CE-7: only recall memories created at or before this ISO-8601 timestamp */
+    until?: string;
+    /** KG-3: traversal depth 1–3 (default: 1); requires include_associated */
+    associated_memories_depth?: number;
+    /** KG-3: minimum edge weight for KG traversal (default: 0.0) */
+    associated_memories_min_weight?: number;
 }
 /** Request to update importance */
 interface UpdateImportanceRequest {
@@ -1667,6 +1677,27 @@ interface MemoryPolicy {
     spaced_repetition_factor?: number;
     /** Base interval in seconds for spaced repetition (default: 86 400 = 1 d). */
     spaced_repetition_base_interval_seconds?: number;
+    /**
+     * Enable background DBSCAN deduplication for this namespace.
+     * When `true` the server merges semantically near-duplicate memories every
+     * `consolidation_interval_hours` hours. Default: `false`.
+     */
+    consolidation_enabled?: boolean;
+    /**
+     * DBSCAN epsilon — cosine-similarity threshold to consider two memories
+     * duplicates (default: `0.92`; higher = only merge very close neighbours).
+     */
+    consolidation_threshold?: number;
+    /**
+     * How often (in hours) the background consolidation job runs for this
+     * namespace (default: `24`).
+     */
+    consolidation_interval_hours?: number;
+    /**
+     * **Read-only.** Lifetime count of memories merged by the consolidation
+     * engine. The server manages this field; any value you send is ignored.
+     */
+    consolidated_count?: number;
 }
 
 /**
@@ -2195,10 +2226,14 @@ declare class DakeraClient {
      * @param options.top_k - Number of primary results (default: 5)
      * @param options.memory_type - Filter by memory type
      * @param options.min_importance - Minimum importance threshold
-     * @param options.include_associated - COG-2: traverse KG depth-1 and include
+     * @param options.include_associated - COG-2: traverse KG and include
      *   associatively linked memories in `associated_memories` (default: false)
      * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
-     * @returns RecallResponse with `memories` and optionally `associated_memories`
+     * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
+     * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
+     * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
+     * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
+     * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
      */
     recall(agentId: string, query: string, options?: {
         top_k?: number;
@@ -2206,6 +2241,10 @@ declare class DakeraClient {
         min_importance?: number;
         include_associated?: boolean;
         associated_memories_cap?: number;
+        associated_memories_depth?: number;
+        associated_memories_min_weight?: number;
+        since?: string;
+        until?: string;
     }): Promise<RecallResponse>;
     /** Get a specific memory */
     getMemory(agentId: string, memoryId: string): Promise<Memory>;

package/dist/index.d.ts

@@ -453,12 +453,14 @@ interface RecalledMemory {
     metadata?: Record<string, unknown>;
     /** Creation timestamp */
     created_at?: string;
+    /** KG-3: hop depth at which this memory was found (only set on associated memories) */
+    depth?: number;
 }
-/** COG-2: Response from the recall endpoint with optional associative memories */
+/** COG-2 / KG-3: Response from the recall endpoint with optional associative memories */
 interface RecallResponse {
     /** Primary recalled memories */
     memories: RecalledMemory[];
-    /** COG-2: KG depth-1 associated memories (only present when include_associated was true) */
+    /** COG-2 / KG-3: KG associated memories at configurable depth (only present when include_associated was true) */
     associated_memories?: RecalledMemory[];
 }
 /** Response from storing a memory */
@@ -487,6 +489,14 @@ interface RecallRequest {
     memory_type?: string;
     /** Minimum importance threshold */
     min_importance?: number;
+    /** CE-7: only recall memories created at or after this ISO-8601 timestamp */
+    since?: string;
+    /** CE-7: only recall memories created at or before this ISO-8601 timestamp */
+    until?: string;
+    /** KG-3: traversal depth 1–3 (default: 1); requires include_associated */
+    associated_memories_depth?: number;
+    /** KG-3: minimum edge weight for KG traversal (default: 0.0) */
+    associated_memories_min_weight?: number;
 }
 /** Request to update importance */
 interface UpdateImportanceRequest {
@@ -1667,6 +1677,27 @@ interface MemoryPolicy {
     spaced_repetition_factor?: number;
     /** Base interval in seconds for spaced repetition (default: 86 400 = 1 d). */
     spaced_repetition_base_interval_seconds?: number;
+    /**
+     * Enable background DBSCAN deduplication for this namespace.
+     * When `true` the server merges semantically near-duplicate memories every
+     * `consolidation_interval_hours` hours. Default: `false`.
+     */
+    consolidation_enabled?: boolean;
+    /**
+     * DBSCAN epsilon — cosine-similarity threshold to consider two memories
+     * duplicates (default: `0.92`; higher = only merge very close neighbours).
+     */
+    consolidation_threshold?: number;
+    /**
+     * How often (in hours) the background consolidation job runs for this
+     * namespace (default: `24`).
+     */
+    consolidation_interval_hours?: number;
+    /**
+     * **Read-only.** Lifetime count of memories merged by the consolidation
+     * engine. The server manages this field; any value you send is ignored.
+     */
+    consolidated_count?: number;
 }
 
 /**
@@ -2195,10 +2226,14 @@ declare class DakeraClient {
      * @param options.top_k - Number of primary results (default: 5)
      * @param options.memory_type - Filter by memory type
      * @param options.min_importance - Minimum importance threshold
-     * @param options.include_associated - COG-2: traverse KG depth-1 and include
+     * @param options.include_associated - COG-2: traverse KG and include
      *   associatively linked memories in `associated_memories` (default: false)
      * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
-     * @returns RecallResponse with `memories` and optionally `associated_memories`
+     * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
+     * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
+     * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
+     * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
+     * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
      */
     recall(agentId: string, query: string, options?: {
         top_k?: number;
@@ -2206,6 +2241,10 @@ declare class DakeraClient {
         min_importance?: number;
         include_associated?: boolean;
         associated_memories_cap?: number;
+        associated_memories_depth?: number;
+        associated_memories_min_weight?: number;
+        since?: string;
+        until?: string;
     }): Promise<RecallResponse>;
     /** Get a specific memory */
     getMemory(agentId: string, memoryId: string): Promise<Memory>;

package/dist/index.js

@@ -1075,10 +1075,14 @@ var DakeraClient = class {
    * @param options.top_k - Number of primary results (default: 5)
    * @param options.memory_type - Filter by memory type
    * @param options.min_importance - Minimum importance threshold
-   * @param options.include_associated - COG-2: traverse KG depth-1 and include
+   * @param options.include_associated - COG-2: traverse KG and include
    *   associatively linked memories in `associated_memories` (default: false)
    * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
-   * @returns RecallResponse with `memories` and optionally `associated_memories`
+   * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
+   * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
+   * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
+   * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
+   * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
    */
   async recall(agentId2, query, options) {
     const body = { query };
@@ -1087,6 +1091,10 @@ var DakeraClient = class {
     if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
     if (options?.include_associated) body["include_associated"] = true;
     if (options?.associated_memories_cap !== void 0) body["associated_memories_cap"] = options.associated_memories_cap;
+    if (options?.associated_memories_depth !== void 0) body["associated_memories_depth"] = options.associated_memories_depth;
+    if (options?.associated_memories_min_weight !== void 0) body["associated_memories_min_weight"] = options.associated_memories_min_weight;
+    if (options?.since !== void 0) body["since"] = options.since;
+    if (options?.until !== void 0) body["until"] = options.until;
     return this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
   }
   /** Get a specific memory */

package/dist/index.mjs

@@ -1035,10 +1035,14 @@ var DakeraClient = class {
    * @param options.top_k - Number of primary results (default: 5)
    * @param options.memory_type - Filter by memory type
    * @param options.min_importance - Minimum importance threshold
-   * @param options.include_associated - COG-2: traverse KG depth-1 and include
+   * @param options.include_associated - COG-2: traverse KG and include
    *   associatively linked memories in `associated_memories` (default: false)
    * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
-   * @returns RecallResponse with `memories` and optionally `associated_memories`
+   * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
+   * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
+   * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
+   * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
+   * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
    */
   async recall(agentId2, query, options) {
     const body = { query };
@@ -1047,6 +1051,10 @@ var DakeraClient = class {
     if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
     if (options?.include_associated) body["include_associated"] = true;
     if (options?.associated_memories_cap !== void 0) body["associated_memories_cap"] = options.associated_memories_cap;
+    if (options?.associated_memories_depth !== void 0) body["associated_memories_depth"] = options.associated_memories_depth;
+    if (options?.associated_memories_min_weight !== void 0) body["associated_memories_min_weight"] = options.associated_memories_min_weight;
+    if (options?.since !== void 0) body["since"] = options.since;
+    if (options?.until !== void 0) body["until"] = options.until;
     return this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
   }
   /** Get a specific memory */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakera-ai/dakera",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",