@dakera-ai/dakera 0.8.6 → 0.9.2

package/dist/index.mjs

@@ -1096,6 +1096,167 @@ var DakeraClient = class {
     return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
+  // Memory Feedback Loop — INT-1
+  // ===========================================================================
+  /**
+   * Submit upvote/downvote/flag feedback on a memory (INT-1).
+   *
+   * - `upvote`: boosts importance ×1.15 (capped at 1.0).
+   * - `downvote`: penalises importance ×0.85 (floor 0.0).
+   * - `flag`: marks as irrelevant — accelerates decay on next cycle.
+   *
+   * @param memoryId  The memory to give feedback on.
+   * @param agentId   The agent that owns the memory.
+   * @param signal    Feedback signal.
+   */
+  async feedbackMemory(memoryId2, agentId2, signal) {
+    return this.request("POST", `/v1/memories/${memoryId2}/feedback`, { agent_id: agentId2, signal });
+  }
+  /**
+   * Get the full feedback history for a memory (INT-1).
+   *
+   * @param memoryId  The memory whose feedback history to retrieve.
+   */
+  async getMemoryFeedbackHistory(memoryId2) {
+    return this.request("GET", `/v1/memories/${memoryId2}/feedback`);
+  }
+  /**
+   * Get aggregate feedback counts and health score for an agent (INT-1).
+   *
+   * @param agentId  The agent to summarise feedback for.
+   */
+  async getAgentFeedbackSummary(agentId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/feedback/summary`);
+  }
+  /**
+   * Directly override a memory's importance score (INT-1).
+   *
+   * @param memoryId    The memory to update.
+   * @param agentId     The agent that owns the memory.
+   * @param importance  New importance value (0.0–1.0).
+   */
+  async patchMemoryImportance(memoryId2, agentId2, importance) {
+    return this.request("PATCH", `/v1/memories/${memoryId2}/importance`, { agent_id: agentId2, importance });
+  }
+  /**
+   * Get overall feedback health score for an agent (INT-1).
+   *
+   * The health score is the mean importance of all non-expired memories (0.0–1.0).
+   * A higher score indicates a healthier, more relevant memory store.
+   *
+   * @param agentId  The agent to get health score for.
+   */
+  async getFeedbackHealth(agentId2) {
+    const params = new URLSearchParams({ agent_id: agentId2 });
+    return this.request("GET", `/v1/feedback/health?${params}`);
+  }
+  // ===========================================================================
+  // Memory Knowledge Graph Operations (CE-5 / SDK-9)
+  // ===========================================================================
+  /**
+   * Traverse the knowledge graph from a memory node.
+   *
+   * Requires CE-5 (Memory Knowledge Graph) on the server.
+   *
+   * @param memoryId  Root memory ID to start traversal from.
+   * @param options   `depth` (default 1, max 3) and optional `types` filter.
+   *
+   * @example
+   * const graph = await client.memories.graph(memoryId, { depth: 2 });
+   * console.log(`${graph.nodes.length} nodes, ${graph.edges.length} edges`);
+   */
+  async memoryGraph(memoryId2, options) {
+    const params = new URLSearchParams();
+    params.set("depth", String(options?.depth ?? 1));
+    if (options?.types?.length) {
+      params.set("types", options.types.join(","));
+    }
+    return this.request("GET", `/v1/memories/${memoryId2}/graph?${params}`);
+  }
+  /**
+   * Find the shortest path between two memories in the knowledge graph.
+   *
+   * Requires CE-5 (Memory Knowledge Graph) on the server.
+   *
+   * @param sourceId  Starting memory ID.
+   * @param targetId  Destination memory ID.
+   */
+  async memoryPath(sourceId, targetId) {
+    return this.request("GET", `/v1/memories/${sourceId}/path?target=${encodeURIComponent(targetId)}`);
+  }
+  /**
+   * Create an explicit edge between two memories.
+   *
+   * Requires CE-5 (Memory Knowledge Graph) on the server.
+   *
+   * @param sourceId  Source memory ID.
+   * @param targetId  Target memory ID.
+   * @param edgeType  Edge type — must be `"linked_by"` for explicit links.
+   */
+  async memoryLink(sourceId, targetId, edgeType = "linked_by") {
+    return this.request("POST", `/v1/memories/${sourceId}/links`, {
+      target_id: targetId,
+      edge_type: edgeType
+    });
+  }
+  /**
+   * Export the full knowledge graph for an agent.
+   *
+   * Requires CE-5 (Memory Knowledge Graph) on the server.
+   *
+   * @param agentId  Agent whose graph to export.
+   * @param format   Export format — `"json"` (default), `"graphml"`, or `"csv"`.
+   */
+  async agentGraphExport(agentId2, format = "json") {
+    return this.request("GET", `/v1/agents/${agentId2}/graph/export?format=${format}`);
+  }
+  // =========================================================================
+  // Entity Extraction Operations (CE-4)
+  // =========================================================================
+  /**
+   * Configure entity extraction for a namespace.
+   *
+   * @param namespace - Target namespace
+   * @param config - NER configuration (extract_entities flag + entity_types)
+   * @returns Updated namespace config
+   *
+   * @note Requires CE-4 (GLiNER) on the server.
+   */
+  async configureNamespaceNer(namespace, config) {
+    return this.request(
+      "PATCH",
+      `/v1/namespaces/${namespace}/config`,
+      config
+    );
+  }
+  /**
+   * Extract entities from arbitrary text without storing a memory.
+   *
+   * @param text - Text to extract entities from
+   * @param entityTypes - Entity types to extract (defaults to server defaults)
+   * @returns EntityExtractionResponse with extracted entities
+   *
+   * @note Requires CE-4 (GLiNER) on the server.
+   */
+  async extractEntities(text, entityTypes) {
+    const body = { text };
+    if (entityTypes !== void 0) {
+      body["entity_types"] = entityTypes;
+    }
+    return this.request("POST", "/v1/memories/extract", body);
+  }
+  /**
+   * Get entity tags attached to a stored memory.
+   *
+   * @param memoryId - Memory ID to fetch entities for
+   * @returns MemoryEntitiesResponse with entity list
+   *
+   * @note Requires CE-4 (GLiNER) on the server.
+   */
+  async memoryEntities(memoryId2) {
+    return this.request("GET", `/v1/memory/entities/${memoryId2}`);
+  }
+  // ===========================================================================
   // Session Operations
   // ===========================================================================
   /** Start a new session */
@@ -1434,6 +1595,49 @@ var DakeraClient = class {
     const url = `${this.baseUrl}/v1/events/stream`;
     yield* this._streamSseMemory(url);
   }
+  /**
+   * Subscribe to real-time memory lifecycle events for a specific agent.
+   *
+   * Wraps `GET /v1/events/stream`, filtering events by `agentId` and
+   * optional `tags`.  Reconnects automatically on connection drop when
+   * `reconnect` is `true`.
+   *
+   * Requires a Read-scoped API key.
+   *
+   * @param agentId - Agent whose events to receive.
+   * @param options.tags - Optional tag filter: only events whose tags overlap
+   *   this array are yielded.
+   * @param options.reconnect - Auto-reconnect on connection drop. Default `true`.
+   * @param options.reconnectDelay - Milliseconds to wait between reconnection
+   *   attempts. Default `1000`.
+   *
+   * @example
+   * ```ts
+   * for await (const event of client.subscribeAgentMemories('my-bot', { tags: ['important'] })) {
+   *   console.log(event.event_type, event.memory_id);
+   * }
+   * ```
+   */
+  async *subscribeAgentMemories(agentId2, options = {}) {
+    const { tags, reconnect = true, reconnectDelay = 1e3 } = options;
+    while (true) {
+      try {
+        for await (const event of this.streamMemoryEvents()) {
+          if (event.event_type === "connected") continue;
+          if (event.agent_id !== agentId2) continue;
+          if (tags && tags.length > 0) {
+            const eventTags = event.tags ?? [];
+            if (!tags.some((t) => eventTags.includes(t))) continue;
+          }
+          yield event;
+        }
+        if (!reconnect) return;
+      } catch (err) {
+        if (!reconnect) throw err;
+      }
+      await new Promise((r) => setTimeout(r, reconnectDelay));
+    }
+  }
   /**
    * Return a URL with `?api_key=<key>` appended for use with browser-native
    * `EventSource`, which cannot send custom request headers.
@@ -1561,6 +1765,49 @@ var DakeraClient = class {
       return null;
     }
   }
+  // ===========================================================================
+  // Namespace API Keys — SEC-1
+  // ===========================================================================
+  /**
+   * Create a namespace-scoped API key (SEC-1).
+   *
+   * The `key` field in the response is shown **only once** — store it securely.
+   *
+   * @param namespace     The namespace to scope this key to.
+   * @param name          Human-readable label for the key.
+   * @param expiresInDays Optional expiry in days from now.
+   */
+  async createNamespaceKey(namespace, name, expiresInDays) {
+    const body = { name };
+    if (expiresInDays !== void 0) body.expires_in_days = expiresInDays;
+    return this.request("POST", `/v1/namespaces/${namespace}/keys`, body);
+  }
+  /**
+   * List all API keys scoped to a namespace (SEC-1).
+   *
+   * @param namespace  The namespace whose keys to list.
+   */
+  async listNamespaceKeys(namespace) {
+    return this.request("GET", `/v1/namespaces/${namespace}/keys`);
+  }
+  /**
+   * Revoke a namespace-scoped API key (SEC-1).
+   *
+   * @param namespace  The namespace the key belongs to.
+   * @param keyId      The key to revoke.
+   */
+  async deleteNamespaceKey(namespace, keyId) {
+    return this.request("DELETE", `/v1/namespaces/${namespace}/keys/${keyId}`);
+  }
+  /**
+   * Get usage statistics for a namespace-scoped API key (SEC-1).
+   *
+   * @param namespace  The namespace the key belongs to.
+   * @param keyId      The key whose usage to retrieve.
+   */
+  async getNamespaceKeyUsage(namespace, keyId) {
+    return this.request("GET", `/v1/namespaces/${namespace}/keys/${keyId}/usage`);
+  }
 };
 
 // src/types.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakera-ai/dakera",
-  "version": "0.8.6",
+  "version": "0.9.2",
   "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -51,7 +51,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "eslint": "^8.55.0",
+    "eslint": "^10.1.0",
     "tsup": "^8.0.1",
     "typescript": "^5.3.0",
     "vitest": "^4.1.0"