@dakera-ai/dakera 0.9.9 → 0.9.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -453,12 +453,14 @@ interface RecalledMemory {
453
453
  metadata?: Record<string, unknown>;
454
454
  /** Creation timestamp */
455
455
  created_at?: string;
456
+ /** KG-3: hop depth at which this memory was found (only set on associated memories) */
457
+ depth?: number;
456
458
  }
457
- /** COG-2: Response from the recall endpoint with optional associative memories */
459
+ /** COG-2 / KG-3: Response from the recall endpoint with optional associative memories */
458
460
  interface RecallResponse {
459
461
  /** Primary recalled memories */
460
462
  memories: RecalledMemory[];
461
- /** COG-2: KG depth-1 associated memories (only present when include_associated was true) */
463
+ /** COG-2 / KG-3: KG associated memories at configurable depth (only present when include_associated was true) */
462
464
  associated_memories?: RecalledMemory[];
463
465
  }
464
466
  /** Response from storing a memory */
@@ -491,6 +493,10 @@ interface RecallRequest {
491
493
  since?: string;
492
494
  /** CE-7: only recall memories created at or before this ISO-8601 timestamp */
493
495
  until?: string;
496
+ /** KG-3: traversal depth 1–3 (default: 1); requires include_associated */
497
+ associated_memories_depth?: number;
498
+ /** KG-3: minimum edge weight for KG traversal (default: 0.0) */
499
+ associated_memories_min_weight?: number;
494
500
  }
495
501
  /** Request to update importance */
496
502
  interface UpdateImportanceRequest {
@@ -1692,6 +1698,12 @@ interface MemoryPolicy {
1692
1698
  * engine. The server manages this field; any value you send is ignored.
1693
1699
  */
1694
1700
  consolidated_count?: number;
1701
+ /** Enable per-namespace store/recall rate limiting (default: `false`). */
1702
+ rate_limit_enabled?: boolean;
1703
+ /** Max store operations per minute for this namespace. `undefined` = unlimited (default). */
1704
+ rate_limit_stores_per_minute?: number;
1705
+ /** Max recall operations per minute for this namespace. `undefined` = unlimited (default). */
1706
+ rate_limit_recalls_per_minute?: number;
1695
1707
  }
1696
1708
 
1697
1709
  /**
@@ -2220,12 +2232,14 @@ declare class DakeraClient {
2220
2232
  * @param options.top_k - Number of primary results (default: 5)
2221
2233
  * @param options.memory_type - Filter by memory type
2222
2234
  * @param options.min_importance - Minimum importance threshold
2223
- * @param options.include_associated - COG-2: traverse KG depth-1 and include
2235
+ * @param options.include_associated - COG-2: traverse KG and include
2224
2236
  * associatively linked memories in `associated_memories` (default: false)
2225
2237
  * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
2238
+ * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
2239
+ * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
2226
2240
  * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
2227
2241
  * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
2228
- * @returns RecallResponse with `memories` and optionally `associated_memories`
2242
+ * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
2229
2243
  */
2230
2244
  recall(agentId: string, query: string, options?: {
2231
2245
  top_k?: number;
@@ -2233,6 +2247,8 @@ declare class DakeraClient {
2233
2247
  min_importance?: number;
2234
2248
  include_associated?: boolean;
2235
2249
  associated_memories_cap?: number;
2250
+ associated_memories_depth?: number;
2251
+ associated_memories_min_weight?: number;
2236
2252
  since?: string;
2237
2253
  until?: string;
2238
2254
  }): Promise<RecallResponse>;
package/dist/index.d.ts CHANGED
@@ -453,12 +453,14 @@ interface RecalledMemory {
453
453
  metadata?: Record<string, unknown>;
454
454
  /** Creation timestamp */
455
455
  created_at?: string;
456
+ /** KG-3: hop depth at which this memory was found (only set on associated memories) */
457
+ depth?: number;
456
458
  }
457
- /** COG-2: Response from the recall endpoint with optional associative memories */
459
+ /** COG-2 / KG-3: Response from the recall endpoint with optional associative memories */
458
460
  interface RecallResponse {
459
461
  /** Primary recalled memories */
460
462
  memories: RecalledMemory[];
461
- /** COG-2: KG depth-1 associated memories (only present when include_associated was true) */
463
+ /** COG-2 / KG-3: KG associated memories at configurable depth (only present when include_associated was true) */
462
464
  associated_memories?: RecalledMemory[];
463
465
  }
464
466
  /** Response from storing a memory */
@@ -491,6 +493,10 @@ interface RecallRequest {
491
493
  since?: string;
492
494
  /** CE-7: only recall memories created at or before this ISO-8601 timestamp */
493
495
  until?: string;
496
+ /** KG-3: traversal depth 1–3 (default: 1); requires include_associated */
497
+ associated_memories_depth?: number;
498
+ /** KG-3: minimum edge weight for KG traversal (default: 0.0) */
499
+ associated_memories_min_weight?: number;
494
500
  }
495
501
  /** Request to update importance */
496
502
  interface UpdateImportanceRequest {
@@ -1692,6 +1698,12 @@ interface MemoryPolicy {
1692
1698
  * engine. The server manages this field; any value you send is ignored.
1693
1699
  */
1694
1700
  consolidated_count?: number;
1701
+ /** Enable per-namespace store/recall rate limiting (default: `false`). */
1702
+ rate_limit_enabled?: boolean;
1703
+ /** Max store operations per minute for this namespace. `undefined` = unlimited (default). */
1704
+ rate_limit_stores_per_minute?: number;
1705
+ /** Max recall operations per minute for this namespace. `undefined` = unlimited (default). */
1706
+ rate_limit_recalls_per_minute?: number;
1695
1707
  }
1696
1708
 
1697
1709
  /**
@@ -2220,12 +2232,14 @@ declare class DakeraClient {
2220
2232
  * @param options.top_k - Number of primary results (default: 5)
2221
2233
  * @param options.memory_type - Filter by memory type
2222
2234
  * @param options.min_importance - Minimum importance threshold
2223
- * @param options.include_associated - COG-2: traverse KG depth-1 and include
2235
+ * @param options.include_associated - COG-2: traverse KG and include
2224
2236
  * associatively linked memories in `associated_memories` (default: false)
2225
2237
  * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
2238
+ * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
2239
+ * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
2226
2240
  * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
2227
2241
  * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
2228
- * @returns RecallResponse with `memories` and optionally `associated_memories`
2242
+ * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
2229
2243
  */
2230
2244
  recall(agentId: string, query: string, options?: {
2231
2245
  top_k?: number;
@@ -2233,6 +2247,8 @@ declare class DakeraClient {
2233
2247
  min_importance?: number;
2234
2248
  include_associated?: boolean;
2235
2249
  associated_memories_cap?: number;
2250
+ associated_memories_depth?: number;
2251
+ associated_memories_min_weight?: number;
2236
2252
  since?: string;
2237
2253
  until?: string;
2238
2254
  }): Promise<RecallResponse>;
package/dist/index.js CHANGED
@@ -1075,12 +1075,14 @@ var DakeraClient = class {
1075
1075
  * @param options.top_k - Number of primary results (default: 5)
1076
1076
  * @param options.memory_type - Filter by memory type
1077
1077
  * @param options.min_importance - Minimum importance threshold
1078
- * @param options.include_associated - COG-2: traverse KG depth-1 and include
1078
+ * @param options.include_associated - COG-2: traverse KG and include
1079
1079
  * associatively linked memories in `associated_memories` (default: false)
1080
1080
  * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
1081
+ * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
1082
+ * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
1081
1083
  * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
1082
1084
  * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
1083
- * @returns RecallResponse with `memories` and optionally `associated_memories`
1085
+ * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
1084
1086
  */
1085
1087
  async recall(agentId2, query, options) {
1086
1088
  const body = { query };
@@ -1089,6 +1091,8 @@ var DakeraClient = class {
1089
1091
  if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
1090
1092
  if (options?.include_associated) body["include_associated"] = true;
1091
1093
  if (options?.associated_memories_cap !== void 0) body["associated_memories_cap"] = options.associated_memories_cap;
1094
+ if (options?.associated_memories_depth !== void 0) body["associated_memories_depth"] = options.associated_memories_depth;
1095
+ if (options?.associated_memories_min_weight !== void 0) body["associated_memories_min_weight"] = options.associated_memories_min_weight;
1092
1096
  if (options?.since !== void 0) body["since"] = options.since;
1093
1097
  if (options?.until !== void 0) body["until"] = options.until;
1094
1098
  return this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
package/dist/index.mjs CHANGED
@@ -1035,12 +1035,14 @@ var DakeraClient = class {
1035
1035
  * @param options.top_k - Number of primary results (default: 5)
1036
1036
  * @param options.memory_type - Filter by memory type
1037
1037
  * @param options.min_importance - Minimum importance threshold
1038
- * @param options.include_associated - COG-2: traverse KG depth-1 and include
1038
+ * @param options.include_associated - COG-2: traverse KG and include
1039
1039
  * associatively linked memories in `associated_memories` (default: false)
1040
1040
  * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
1041
+ * @param options.associated_memories_depth - KG-3: traversal depth 1–3 (default: 1); requires include_associated
1042
+ * @param options.associated_memories_min_weight - KG-3: minimum edge weight for KG traversal (default: 0.0)
1041
1043
  * @param options.since - CE-7: only recall memories created at or after this ISO-8601 timestamp
1042
1044
  * @param options.until - CE-7: only recall memories created at or before this ISO-8601 timestamp
1043
- * @returns RecallResponse with `memories` and optionally `associated_memories`
1045
+ * @returns RecallResponse with `memories` and optionally `associated_memories` (each with `depth` field)
1044
1046
  */
1045
1047
  async recall(agentId2, query, options) {
1046
1048
  const body = { query };
@@ -1049,6 +1051,8 @@ var DakeraClient = class {
1049
1051
  if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
1050
1052
  if (options?.include_associated) body["include_associated"] = true;
1051
1053
  if (options?.associated_memories_cap !== void 0) body["associated_memories_cap"] = options.associated_memories_cap;
1054
+ if (options?.associated_memories_depth !== void 0) body["associated_memories_depth"] = options.associated_memories_depth;
1055
+ if (options?.associated_memories_min_weight !== void 0) body["associated_memories_min_weight"] = options.associated_memories_min_weight;
1052
1056
  if (options?.since !== void 0) body["since"] = options.since;
1053
1057
  if (options?.until !== void 0) body["until"] = options.until;
1054
1058
  return this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dakera-ai/dakera",
3
- "version": "0.9.9",
3
+ "version": "0.9.11",
4
4
  "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",