@dakera-ai/dakera 0.11.55 → 0.11.57

package/dist/index.js

@@ -136,6 +136,12 @@ function parseErrorCode(raw) {
   }
   return "UNKNOWN" /* UNKNOWN */;
 }
+function flattenRecalledMemory(item) {
+  if (item && typeof item === "object" && item.memory && typeof item.memory === "object") {
+    return { ...item.memory, score: item.score, depth: item.depth };
+  }
+  return item;
+}
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_MAX_RETRIES = 3;
 var DEFAULT_BASE_DELAY = 100;
@@ -393,7 +399,33 @@ var DakeraClient = class {
     if (options.ids) body.ids = options.ids;
     if (options.filter) body.filter = options.filter;
     if (options.deleteAll) body.delete_all = true;
-    return this.request("POST", `/v1/namespaces/${namespace}/delete`, body);
+    return this.request("POST", `/v1/namespaces/${namespace}/vectors/delete`, body);
+  }
+  /** Bulk update vector metadata matching a filter. */
+  async bulkUpdateVectors(namespace, filter, update) {
+    return this.request(
+      "POST",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/vectors/bulk-update`,
+      { filter, update }
+    );
+  }
+  /** Bulk delete vectors matching a filter. */
+  async bulkDeleteVectors(namespace, filter) {
+    return this.request(
+      "POST",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/vectors/bulk-delete`,
+      { filter }
+    );
+  }
+  /** Count vectors in a namespace, optionally filtered. */
+  async countVectors(namespace, filter) {
+    const body = {};
+    if (filter) body.filter = filter;
+    return this.request(
+      "POST",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/vectors/count`,
+      body
+    );
   }
   /**
    * Fetch vectors by ID.
@@ -618,6 +650,14 @@ var DakeraClient = class {
   async health() {
     return this.request("GET", "/health");
   }
+  /** K8s readiness probe — checks storage and dependencies. */
+  async healthReady() {
+    return this.request("GET", "/health/ready");
+  }
+  /** K8s liveness probe — checks process is alive. */
+  async healthLive() {
+    return this.request("GET", "/health/live");
+  }
   /**
    * Get index statistics for a namespace.
    *
@@ -1102,7 +1142,11 @@ var DakeraClient = class {
     if (options?.until !== void 0) body["until"] = options.until;
     if (options?.routing !== void 0) body["routing"] = options.routing;
     if (options?.rerank !== void 0) body["rerank"] = options.rerank;
-    return this.request("POST", "/v1/memory/recall", { ...body, agent_id: agentId2 });
+    const raw = await this.request("POST", "/v1/memory/recall", { ...body, agent_id: agentId2 });
+    return {
+      memories: (raw.memories ?? []).map(flattenRecalledMemory),
+      ...raw.associated_memories ? { associated_memories: raw.associated_memories.map(flattenRecalledMemory) } : {}
+    };
   }
   /** Get a specific memory */
   async getMemory(agentId2, memoryId2) {
@@ -1152,6 +1196,28 @@ var DakeraClient = class {
   async batchForget(request) {
     return this.request("DELETE", "/v1/memories/forget/batch", request);
   }
+  /**
+   * Store multiple memories in a single request (DAK-5508).
+   *
+   * Uses `POST /v1/memories/store/batch`. The server embeds all contents in a
+   * single ONNX inference pass, yielding ≥100× throughput vs. N sequential
+   * single-store calls. Accepts up to 1 000 memories per call.
+   *
+   * @example
+   * ```ts
+   * const resp = await client.storeMemoriesBatch({
+   *   agent_id: 'agent-1',
+   *   memories: [
+   *     { content: 'The user prefers dark mode', importance: 0.8 },
+   *     { content: 'The user is based in Berlin', importance: 0.7 },
+   *   ],
+   * });
+   * console.log(`Stored ${resp.stored_count} memories`);
+   * ```
+   */
+  async storeMemoriesBatch(request) {
+    return this.request("POST", "/v1/memories/store/batch", request);
+  }
   /** Search memories for an agent */
   async searchMemories(agentId2, query, options) {
     const body = { query };
@@ -1161,7 +1227,8 @@ var DakeraClient = class {
     if (options?.routing !== void 0) body["routing"] = options.routing;
     if (options?.rerank !== void 0) body["rerank"] = options.rerank;
     const result = await this.request("POST", "/v1/memory/search", { ...body, agent_id: agentId2 });
-    return result.memories ?? result;
+    const items = result.memories ?? result;
+    return (Array.isArray(items) ? items : []).map(flattenRecalledMemory);
   }
   /** Update importance of memories */
   async updateImportance(agentId2, request) {
@@ -1179,6 +1246,22 @@ var DakeraClient = class {
   async consolidate(agentId2, request) {
     return this.request("POST", "/v1/memory/consolidate", { ...request ?? {}, agent_id: agentId2 });
   }
+  /** Consolidate memories directly for an agent (DBSCAN clustering). */
+  async consolidateAgent(agentId2) {
+    return this.request("POST", `/v1/agents/${encodeURIComponent(agentId2)}/consolidate`);
+  }
+  /** Get the consolidation execution log for an agent. */
+  async getConsolidationLog(agentId2) {
+    return this.request("GET", `/v1/agents/${encodeURIComponent(agentId2)}/consolidation/log`);
+  }
+  /** Update the consolidation configuration for an agent. */
+  async patchConsolidationConfig(agentId2, config) {
+    return this.request(
+      "PATCH",
+      `/v1/agents/${encodeURIComponent(agentId2)}/consolidation/config`,
+      config
+    );
+  }
   /** Submit feedback on a memory recall */
   async memoryFeedback(agentId2, request) {
     return this.request("POST", "/v1/memory/feedback", { ...request, agent_id: agentId2 });
@@ -1301,6 +1384,14 @@ var DakeraClient = class {
   // =========================================================================
   // Entity Extraction Operations (CE-4)
   // =========================================================================
+  /** Get entity extraction configuration for a namespace. */
+  async getNamespaceEntityConfig(namespace) {
+    return this.request("GET", `/v1/namespaces/${encodeURIComponent(namespace)}/config`);
+  }
+  /** Get the extractor provider configuration for a namespace. */
+  async getNamespaceExtractor(namespace) {
+    return this.request("GET", `/v1/namespaces/${encodeURIComponent(namespace)}/extractor`);
+  }
   /**
    * Configure entity extraction for a namespace.
    *
@@ -1354,7 +1445,7 @@ var DakeraClient = class {
   }
   /** End a session. Returns the session state and total memory count at close. */
   async endSession(sessionId2) {
-    return this.request("POST", `/v1/sessions/${sessionId2}/end`);
+    return this.request("POST", `/v1/sessions/${sessionId2}/end`, {});
   }
   /** Get session details */
   async getSession(sessionId2) {
@@ -2256,6 +2347,226 @@ var DakeraClient = class {
     const body = namespace ? { namespace } : {};
     return this.request("POST", "/admin/fulltext/reindex", body);
   }
+  // ---------------------------------------------------------------------------
+  // Admin — Cluster & Maintenance
+  // ---------------------------------------------------------------------------
+  /** GET /admin/cluster/replication — cluster replication status. */
+  async adminClusterReplication() {
+    return this.request("GET", "/admin/cluster/replication");
+  }
+  /** GET /admin/cluster/shards — list shards. */
+  async adminListShards() {
+    return this.request("GET", "/admin/cluster/shards");
+  }
+  /** POST /admin/cluster/shards/rebalance — rebalance shards. */
+  async adminRebalanceShards(request) {
+    return this.request("POST", "/admin/cluster/shards/rebalance", request ?? {});
+  }
+  /** GET /admin/cluster/maintenance — maintenance mode status. */
+  async adminMaintenanceStatus() {
+    return this.request("GET", "/admin/cluster/maintenance");
+  }
+  /** POST /admin/cluster/maintenance/enable — enable maintenance mode. */
+  async adminEnableMaintenance(request) {
+    return this.request("POST", "/admin/cluster/maintenance/enable", request);
+  }
+  /** POST /admin/cluster/maintenance/disable — disable maintenance mode. */
+  async adminDisableMaintenance(request) {
+    return this.request("POST", "/admin/cluster/maintenance/disable", request ?? {});
+  }
+  // ---------------------------------------------------------------------------
+  // Admin — Quotas
+  // ---------------------------------------------------------------------------
+  /** GET /admin/quotas — list all namespace quotas. */
+  async adminListQuotas() {
+    return this.request("GET", "/admin/quotas");
+  }
+  /** GET /admin/quotas/default — get default quota configuration. */
+  async adminGetDefaultQuota() {
+    return this.request("GET", "/admin/quotas/default");
+  }
+  /** PUT /admin/quotas/default — set default quota configuration. */
+  async adminSetDefaultQuota(request) {
+    return this.request("PUT", "/admin/quotas/default", request);
+  }
+  /** GET /admin/quotas/{namespace} — get namespace quota. */
+  async adminGetQuota(namespace) {
+    return this.request("GET", `/admin/quotas/${namespace}`);
+  }
+  /** PUT /admin/quotas/{namespace} — set namespace quota. */
+  async adminSetQuota(namespace, request) {
+    return this.request("PUT", `/admin/quotas/${namespace}`, request);
+  }
+  /** DELETE /admin/quotas/{namespace} — remove namespace quota. */
+  async adminDeleteQuota(namespace) {
+    return this.request("DELETE", `/admin/quotas/${namespace}`);
+  }
+  /** POST /admin/quotas/{namespace}/check — check if operation would exceed quota. */
+  async adminCheckQuota(namespace, request) {
+    return this.request("POST", `/admin/quotas/${namespace}/check`, request);
+  }
+  // ---------------------------------------------------------------------------
+  // Admin — Slow Queries
+  // ---------------------------------------------------------------------------
+  /** GET /admin/slow-queries — list recent slow queries. */
+  async adminListSlowQueries(params) {
+    const qs = params ? new URLSearchParams(Object.entries(params).filter(([, v]) => v !== void 0).map(([k, v]) => [k, String(v)])).toString() : "";
+    const path = qs ? `/admin/slow-queries?${qs}` : "/admin/slow-queries";
+    return this.request("GET", path);
+  }
+  /** GET /admin/slow-queries/summary — slow query summary. */
+  async adminSlowQuerySummary() {
+    return this.request("GET", "/admin/slow-queries/summary");
+  }
+  /** DELETE /admin/slow-queries — clear slow query log. */
+  async adminClearSlowQueries(namespace) {
+    const path = namespace ? `/admin/slow-queries?namespace=${encodeURIComponent(namespace)}` : "/admin/slow-queries";
+    return this.request("DELETE", path);
+  }
+  /** PATCH /admin/slow-queries/config — update slow query configuration. */
+  async adminUpdateSlowQueryConfig(config) {
+    return this.request("PATCH", "/admin/slow-queries/config", config);
+  }
+  // ---------------------------------------------------------------------------
+  // Admin — Backups
+  // ---------------------------------------------------------------------------
+  /** GET /admin/backups — list all backups. */
+  async adminListBackups() {
+    return this.request("GET", "/admin/backups");
+  }
+  /** POST /admin/backups — create a new backup. */
+  async adminCreateBackup(request) {
+    return this.request("POST", "/admin/backups", request);
+  }
+  /** GET /admin/backups/{id} — get backup details. */
+  async adminGetBackup(backupId) {
+    return this.request("GET", `/admin/backups/${backupId}`);
+  }
+  /** DELETE /admin/backups/{id} — delete a backup. */
+  async adminDeleteBackup(backupId) {
+    return this.request("DELETE", `/admin/backups/${backupId}`);
+  }
+  /** GET /admin/backups/schedule — get backup schedule. */
+  async adminGetBackupSchedule() {
+    return this.request("GET", "/admin/backups/schedule");
+  }
+  /** POST /admin/backups/schedule — update backup schedule. */
+  async adminUpdateBackupSchedule(request) {
+    return this.request("POST", "/admin/backups/schedule", request);
+  }
+  /** POST /admin/backups/restore — restore from backup. */
+  async adminRestoreBackup(request) {
+    return this.request("POST", "/admin/backups/restore", request);
+  }
+  /** GET /admin/backups/restore/{id} — restore operation status. */
+  async adminGetRestoreStatus(restoreId) {
+    return this.request("GET", `/admin/backups/restore/${restoreId}`);
+  }
+  // ---------------------------------------------------------------------------
+  // Ops — Diagnostics & Jobs
+  // ---------------------------------------------------------------------------
+  /** GET /ops/diagnostics — system diagnostics. */
+  async opsDiagnostics() {
+    return this.request("GET", "/ops/diagnostics");
+  }
+  /** GET /ops/jobs — list background jobs. */
+  async opsListJobs() {
+    return this.request("GET", "/ops/jobs");
+  }
+  /** GET /ops/jobs/{id} — get job status. */
+  async opsGetJob(jobId) {
+    return this.request("GET", `/ops/jobs/${jobId}`);
+  }
+  /** POST /ops/compact — trigger compaction. */
+  async opsCompact(request) {
+    return this.request("POST", "/ops/compact", request ?? {});
+  }
+  /** POST /ops/shutdown — request graceful shutdown. */
+  async opsShutdown() {
+    return this.request("POST", "/ops/shutdown");
+  }
+  // ────────────────────────────────────────────────────────────
+  // Phase 3 — Engine Parity
+  // ────────────────────────────────────────────────────────────
+  /** GET /v1/namespaces/{namespace}/fulltext/stats — full-text index statistics. */
+  async fulltextStats(namespace) {
+    return this.request(
+      "GET",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/fulltext/stats`
+    );
+  }
+  /** POST /v1/namespaces/{namespace}/fulltext/delete — delete documents from full-text index. */
+  async fulltextDelete(namespace, ids) {
+    return this.request(
+      "POST",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/fulltext/delete`,
+      { ids }
+    );
+  }
+  /** GET /admin/ttl/stats — TTL statistics across all namespaces. */
+  async adminTtlStats() {
+    return this.request("GET", "/admin/ttl/stats");
+  }
+  /** POST /v1/route — route a query to the best-matching namespace(s). */
+  async routeQuery(request) {
+    return this.request("POST", "/v1/route", request);
+  }
+  /** GET /v1/import/{job_id}/status — check import job progress. */
+  async importJobStatus(jobId) {
+    return this.request(
+      "GET",
+      `/v1/import/${encodeURIComponent(jobId)}/status`
+    );
+  }
+  /** GET /admin/backups/{id}/download — download a backup as binary data. */
+  async adminDownloadBackup(backupId) {
+    const url = `${this.baseUrl}/admin/backups/${encodeURIComponent(backupId)}/download`;
+    const response = await fetch(url, {
+      headers: { ...this.headers, Accept: "application/octet-stream" }
+    });
+    if (!response.ok) {
+      throw new Error(`Download failed: ${response.status}`);
+    }
+    return response.arrayBuffer();
+  }
+  /** POST /admin/backups/upload — upload a backup archive. */
+  async adminUploadBackup(data) {
+    const url = `${this.baseUrl}/admin/backups/upload`;
+    const headers = {};
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    headers["Content-Type"] = "application/gzip";
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: data instanceof ArrayBuffer ? data : data
+    });
+    if (!response.ok) {
+      throw new Error(`Upload failed: ${response.status}`);
+    }
+    return response.json();
+  }
+  /** GET /admin/storage/tiers — storage tier overview. */
+  async adminStorageTierOverview() {
+    return this.request("GET", "/admin/storage/tiers");
+  }
+  /** GET /admin/background-activity — current background activity. */
+  async adminBackgroundActivity() {
+    return this.request("GET", "/admin/background-activity");
+  }
+  /** GET /admin/memory-type-stats — memory type distribution statistics. */
+  async adminMemoryTypeStats() {
+    return this.request("GET", "/admin/memory-type-stats");
+  }
+  /** POST /admin/namespaces/migrate-dimensions — migrate namespace embedding dimensions. */
+  async adminMigrateNamespaceDimensions(request) {
+    return this.request(
+      "POST",
+      "/admin/namespaces/migrate-dimensions",
+      request ?? {}
+    );
+  }
 };
 
 // src/types.ts