@dakera-ai/dakera 0.11.54 → 0.11.56

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.
@@ -505,11 +537,11 @@ var DakeraClient = class {
    *
    * When `vector` is omitted the server falls back to BM25-only full-text
    * search. When provided, results are blended with vector similarity
-   * according to `alpha`.
+   * according to `vectorWeight`.
    *
    * @param namespace - Target namespace
    * @param query - Text query
-   * @param options - Search options: vector (optional), topK, alpha, filter
+   * @param options - Search options: vector (optional), topK, vectorWeight, filter
    * @returns Hybrid search results
    *
    * @example
@@ -518,7 +550,7 @@ var DakeraClient = class {
    * const results = await client.hybridSearch('my-namespace', 'machine learning', {
    *   vector: [0.1, 0.2, 0.3],
    *   topK: 10,
-   *   alpha: 0.7, // 70% text, 30% vector
+   *   vectorWeight: 0.7, // 70% vector, 30% text
    * });
    * // BM25-only (no vector)
    * const results = await client.hybridSearch('my-namespace', 'machine learning');
@@ -526,9 +558,9 @@ var DakeraClient = class {
    */
   async hybridSearch(namespace, query, options = {}) {
     const body = {
-      query,
+      text: query,
       top_k: options.topK ?? 10,
-      alpha: options.alpha ?? 0.5
+      vector_weight: options.vectorWeight ?? 0.5
     };
     if (options.vector != null) {
       body["vector"] = options.vector;
@@ -556,7 +588,7 @@ var DakeraClient = class {
       "GET",
       "/v1/namespaces"
     );
-    return response.namespaces;
+    return response.namespaces.map((ns) => ({ namespace: ns, vector_count: 0 }));
   }
   /**
    * Get namespace information.
@@ -575,11 +607,16 @@ var DakeraClient = class {
    * @returns Created namespace info
    */
   async createNamespace(namespace, options = {}) {
-    const body = { name: namespace };
-    if (options.dimensions) body.dimensions = options.dimensions;
+    const body = {};
+    if (options.dimensions) body.dimension = options.dimensions;
     if (options.indexType) body.index_type = options.indexType;
     if (options.metadata) body.metadata = options.metadata;
-    return this.request("POST", "/v1/namespaces", body);
+    const response = await this.request(
+      "PUT",
+      `/v1/namespaces/${namespace}`,
+      body
+    );
+    return { namespace: response.namespace, vector_count: 0, dimension: response.dimension };
   }
   /**
    * Create or update a namespace configuration (upsert semantics).
@@ -613,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.
    *
@@ -1064,7 +1109,7 @@ var DakeraClient = class {
   // ===========================================================================
   /** Store a memory for an agent */
   async storeMemory(agentId2, request) {
-    return this.request("POST", `/v1/agents/${agentId2}/memories`, request);
+    return this.request("POST", "/v1/memory/store", { ...request, agent_id: agentId2 });
   }
   /**
    * Recall memories for an agent.
@@ -1097,19 +1142,23 @@ 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/agents/${agentId2}/memories/recall`, body);
+    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) {
-    return this.request("GET", `/v1/agents/${agentId2}/memories/${memoryId2}`);
+    return this.request("GET", `/v1/memory/get/${memoryId2}?agent_id=${encodeURIComponent(agentId2)}`);
   }
   /** Update an existing memory */
-  async updateMemory(agentId2, memoryId2, request) {
-    return this.request("PUT", `/v1/agents/${agentId2}/memories/${memoryId2}`, request);
+  async updateMemory(_agentId, memoryId2, request) {
+    return this.request("PUT", `/v1/memory/update/${memoryId2}`, request);
   }
   /** Delete a memory */
   async forget(agentId2, memoryId2) {
-    return this.request("DELETE", `/v1/agents/${agentId2}/memories/${memoryId2}`);
+    return this.request("POST", "/v1/memory/forget", { agent_id: agentId2, memory_ids: [memoryId2] });
   }
   /**
    * Bulk-recall memories using filter predicates (CE-2).
@@ -1155,20 +1204,45 @@ var DakeraClient = class {
     if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
     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/agents/${agentId2}/memories/search`, body);
-    return result.memories ?? result;
+    const result = await this.request("POST", "/v1/memory/search", { ...body, agent_id: agentId2 });
+    const items = result.memories ?? result;
+    return (Array.isArray(items) ? items : []).map(flattenRecalledMemory);
   }
   /** Update importance of memories */
   async updateImportance(agentId2, request) {
-    return this.request("PUT", `/v1/agents/${agentId2}/memories/importance`, request);
+    let result = { status: "ok" };
+    for (const memoryId2 of request.memory_ids) {
+      result = await this.request("POST", "/v1/memory/importance", {
+        agent_id: agentId2,
+        memory_id: memoryId2,
+        importance: request.importance
+      });
+    }
+    return result;
   }
   /** Consolidate memories for an agent */
   async consolidate(agentId2, request) {
-    return this.request("POST", `/v1/agents/${agentId2}/memories/consolidate`, 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/agents/${agentId2}/memories/feedback`, request);
+    return this.request("POST", "/v1/memory/feedback", { ...request, agent_id: agentId2 });
   }
   // ===========================================================================
   // Memory Feedback Loop — INT-1
@@ -1288,6 +1362,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.
    *
@@ -1314,7 +1396,7 @@ var DakeraClient = class {
    * @note Requires CE-4 (GLiNER) on the server.
    */
   async extractEntities(text, entityTypes) {
-    const body = { text };
+    const body = { content: text };
     if (entityTypes !== void 0) {
       body["entity_types"] = entityTypes;
     }
@@ -1341,7 +1423,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) {
@@ -2243,6 +2325,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