@dakera-ai/dakera 0.8.5 → 0.9.0

package/dist/index.d.mts

@@ -1016,6 +1016,7 @@ interface OpsStats {
     namespace_count: number;
     uptime_seconds: number;
     timestamp: number;
+    state: string;
 }
 /** Cluster status response */
 interface ClusterStatus {
@@ -1259,6 +1260,110 @@ interface BatchForgetRequest {
 interface BatchForgetResponse {
     deleted_count: number;
 }
+/**
+ * Edge type for memory knowledge graph relationships (CE-5).
+ *
+ * - `related_to`: Cosine similarity ≥ 0.85 between two memories.
+ * - `shares_entity`: Both memories reference the same named entity (CE-4).
+ * - `precedes`: Temporal ordering — source was created before target.
+ * - `linked_by`: Explicit user/agent-created link.
+ */
+type EdgeType = 'related_to' | 'shares_entity' | 'precedes' | 'linked_by';
+/** A directed edge in the memory knowledge graph. */
+interface GraphEdge {
+    /** Unique edge identifier. */
+    id: string;
+    /** Source memory ID. */
+    source_id: string;
+    /** Target memory ID. */
+    target_id: string;
+    /** Relationship type between the two memories. */
+    edge_type: EdgeType;
+    /** Edge weight (0.0–1.0). For `related_to` this is the cosine similarity score. */
+    weight: number;
+    /** Unix timestamp of edge creation. */
+    created_at: number;
+}
+/** A node (memory) in the knowledge graph traversal result. */
+interface GraphNode {
+    /** Memory identifier. */
+    memory_id: string;
+    /** First 200 characters of memory content. */
+    content_preview: string;
+    /** Memory importance score. */
+    importance: number;
+    /** Traversal depth from the root node (root = 0). */
+    depth: number;
+}
+/** Graph traversal result from `GET /v1/memories/{id}/graph`. */
+interface MemoryGraph {
+    /** The root memory ID from which traversal started. */
+    root_id: string;
+    /** Maximum traversal depth used. */
+    depth: number;
+    /** All memory nodes reachable within the requested depth. */
+    nodes: GraphNode[];
+    /** All edges connecting the returned nodes. */
+    edges: GraphEdge[];
+}
+/** Shortest path result from `GET /v1/memories/{id}/path`. */
+interface GraphPath {
+    /** Starting memory ID. */
+    source_id: string;
+    /** Destination memory ID. */
+    target_id: string;
+    /** Ordered list of memory IDs from source to target (inclusive). */
+    path: string[];
+    /** Number of edges traversed (`path.length - 1`). -1 if no path exists. */
+    hops: number;
+    /** Edges along the path, in traversal order. */
+    edges: GraphEdge[];
+}
+/** Response from `POST /v1/memories/{id}/links`. */
+interface GraphLinkResponse {
+    /** The newly created edge. */
+    edge: GraphEdge;
+}
+/** Agent graph export from `GET /v1/agents/{id}/graph/export`. */
+interface GraphExport {
+    /** Agent whose graph was exported. */
+    agent_id: string;
+    /** Export format: `json`, `graphml`, or `csv`. */
+    format: 'json' | 'graphml' | 'csv';
+    /** Serialised graph in the requested format. */
+    data: string;
+    /** Total number of memory nodes in the export. */
+    node_count: number;
+    /** Total number of edges in the export. */
+    edge_count: number;
+}
+/** Options for `client.memories.graph()`. */
+interface MemoryGraphOptions {
+    /** Maximum traversal depth (default: 1, max: 3). */
+    depth?: number;
+    /** Filter by edge types. `undefined` returns all types. */
+    types?: EdgeType[];
+}
+/** Configuration for namespace-level entity extraction (CE-4). */
+interface NamespaceNerConfig {
+    extract_entities: boolean;
+    entity_types?: string[];
+}
+/** A single extracted entity from GLiNER or rule-based pipeline. */
+interface ExtractedEntity {
+    entity_type: string;
+    value: string;
+    score: number;
+}
+/** Response from POST /v1/memories/extract */
+interface EntityExtractionResponse {
+    entities: ExtractedEntity[];
+}
+/** Response from GET /v1/memory/entities/:id */
+interface MemoryEntitiesResponse {
+    memory_id: string;
+    entities: ExtractedEntity[];
+}
 
 /**
  * Dakera Client
@@ -1835,6 +1940,76 @@ declare class DakeraClient {
     consolidate(agentId: string, request?: ConsolidateRequest): Promise<ConsolidateResponse>;
     /** Submit feedback on a memory recall */
     memoryFeedback(agentId: string, request: MemoryFeedbackRequest): Promise<MemoryFeedbackResponse>;
+    /**
+     * 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`);
+     */
+    memoryGraph(memoryId: string, options?: MemoryGraphOptions): Promise<MemoryGraph>;
+    /**
+     * 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.
+     */
+    memoryPath(sourceId: string, targetId: string): Promise<GraphPath>;
+    /**
+     * 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.
+     */
+    memoryLink(sourceId: string, targetId: string, edgeType?: EdgeType): Promise<GraphLinkResponse>;
+    /**
+     * 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"`.
+     */
+    agentGraphExport(agentId: string, format?: 'json' | 'graphml' | 'csv'): Promise<GraphExport>;
+    /**
+     * 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.
+     */
+    configureNamespaceNer(namespace: string, config: NamespaceNerConfig): Promise<Record<string, unknown>>;
+    /**
+     * 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.
+     */
+    extractEntities(text: string, entityTypes?: string[]): Promise<EntityExtractionResponse>;
+    /**
+     * 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.
+     */
+    memoryEntities(memoryId: string): Promise<MemoryEntitiesResponse>;
     /** Start a new session */
     startSession(agentId: string, metadata?: Record<string, unknown>): Promise<Session>;
     /** End a session */
@@ -2029,6 +2204,34 @@ declare class DakeraClient {
      * ```
      */
     streamMemoryEvents(): AsyncGenerator<MemoryEvent>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    subscribeAgentMemories(agentId: string, options?: {
+        tags?: string[];
+        reconnect?: boolean;
+        reconnectDelay?: number;
+    }): AsyncGenerator<MemoryEvent>;
     /**
      * Return a URL with `?api_key=<key>` appended for use with browser-native
      * `EventSource`, which cannot send custom request headers.
@@ -2117,4 +2320,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractedEntity, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceNerConfig, NotFoundError, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.d.ts

@@ -1016,6 +1016,7 @@ interface OpsStats {
     namespace_count: number;
     uptime_seconds: number;
     timestamp: number;
+    state: string;
 }
 /** Cluster status response */
 interface ClusterStatus {
@@ -1259,6 +1260,110 @@ interface BatchForgetRequest {
 interface BatchForgetResponse {
     deleted_count: number;
 }
+/**
+ * Edge type for memory knowledge graph relationships (CE-5).
+ *
+ * - `related_to`: Cosine similarity ≥ 0.85 between two memories.
+ * - `shares_entity`: Both memories reference the same named entity (CE-4).
+ * - `precedes`: Temporal ordering — source was created before target.
+ * - `linked_by`: Explicit user/agent-created link.
+ */
+type EdgeType = 'related_to' | 'shares_entity' | 'precedes' | 'linked_by';
+/** A directed edge in the memory knowledge graph. */
+interface GraphEdge {
+    /** Unique edge identifier. */
+    id: string;
+    /** Source memory ID. */
+    source_id: string;
+    /** Target memory ID. */
+    target_id: string;
+    /** Relationship type between the two memories. */
+    edge_type: EdgeType;
+    /** Edge weight (0.0–1.0). For `related_to` this is the cosine similarity score. */
+    weight: number;
+    /** Unix timestamp of edge creation. */
+    created_at: number;
+}
+/** A node (memory) in the knowledge graph traversal result. */
+interface GraphNode {
+    /** Memory identifier. */
+    memory_id: string;
+    /** First 200 characters of memory content. */
+    content_preview: string;
+    /** Memory importance score. */
+    importance: number;
+    /** Traversal depth from the root node (root = 0). */
+    depth: number;
+}
+/** Graph traversal result from `GET /v1/memories/{id}/graph`. */
+interface MemoryGraph {
+    /** The root memory ID from which traversal started. */
+    root_id: string;
+    /** Maximum traversal depth used. */
+    depth: number;
+    /** All memory nodes reachable within the requested depth. */
+    nodes: GraphNode[];
+    /** All edges connecting the returned nodes. */
+    edges: GraphEdge[];
+}
+/** Shortest path result from `GET /v1/memories/{id}/path`. */
+interface GraphPath {
+    /** Starting memory ID. */
+    source_id: string;
+    /** Destination memory ID. */
+    target_id: string;
+    /** Ordered list of memory IDs from source to target (inclusive). */
+    path: string[];
+    /** Number of edges traversed (`path.length - 1`). -1 if no path exists. */
+    hops: number;
+    /** Edges along the path, in traversal order. */
+    edges: GraphEdge[];
+}
+/** Response from `POST /v1/memories/{id}/links`. */
+interface GraphLinkResponse {
+    /** The newly created edge. */
+    edge: GraphEdge;
+}
+/** Agent graph export from `GET /v1/agents/{id}/graph/export`. */
+interface GraphExport {
+    /** Agent whose graph was exported. */
+    agent_id: string;
+    /** Export format: `json`, `graphml`, or `csv`. */
+    format: 'json' | 'graphml' | 'csv';
+    /** Serialised graph in the requested format. */
+    data: string;
+    /** Total number of memory nodes in the export. */
+    node_count: number;
+    /** Total number of edges in the export. */
+    edge_count: number;
+}
+/** Options for `client.memories.graph()`. */
+interface MemoryGraphOptions {
+    /** Maximum traversal depth (default: 1, max: 3). */
+    depth?: number;
+    /** Filter by edge types. `undefined` returns all types. */
+    types?: EdgeType[];
+}
+/** Configuration for namespace-level entity extraction (CE-4). */
+interface NamespaceNerConfig {
+    extract_entities: boolean;
+    entity_types?: string[];
+}
+/** A single extracted entity from GLiNER or rule-based pipeline. */
+interface ExtractedEntity {
+    entity_type: string;
+    value: string;
+    score: number;
+}
+/** Response from POST /v1/memories/extract */
+interface EntityExtractionResponse {
+    entities: ExtractedEntity[];
+}
+/** Response from GET /v1/memory/entities/:id */
+interface MemoryEntitiesResponse {
+    memory_id: string;
+    entities: ExtractedEntity[];
+}
 
 /**
  * Dakera Client
@@ -1835,6 +1940,76 @@ declare class DakeraClient {
     consolidate(agentId: string, request?: ConsolidateRequest): Promise<ConsolidateResponse>;
     /** Submit feedback on a memory recall */
     memoryFeedback(agentId: string, request: MemoryFeedbackRequest): Promise<MemoryFeedbackResponse>;
+    /**
+     * 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`);
+     */
+    memoryGraph(memoryId: string, options?: MemoryGraphOptions): Promise<MemoryGraph>;
+    /**
+     * 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.
+     */
+    memoryPath(sourceId: string, targetId: string): Promise<GraphPath>;
+    /**
+     * 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.
+     */
+    memoryLink(sourceId: string, targetId: string, edgeType?: EdgeType): Promise<GraphLinkResponse>;
+    /**
+     * 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"`.
+     */
+    agentGraphExport(agentId: string, format?: 'json' | 'graphml' | 'csv'): Promise<GraphExport>;
+    /**
+     * 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.
+     */
+    configureNamespaceNer(namespace: string, config: NamespaceNerConfig): Promise<Record<string, unknown>>;
+    /**
+     * 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.
+     */
+    extractEntities(text: string, entityTypes?: string[]): Promise<EntityExtractionResponse>;
+    /**
+     * 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.
+     */
+    memoryEntities(memoryId: string): Promise<MemoryEntitiesResponse>;
     /** Start a new session */
     startSession(agentId: string, metadata?: Record<string, unknown>): Promise<Session>;
     /** End a session */
@@ -2029,6 +2204,34 @@ declare class DakeraClient {
      * ```
      */
     streamMemoryEvents(): AsyncGenerator<MemoryEvent>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    subscribeAgentMemories(agentId: string, options?: {
+        tags?: string[];
+        reconnect?: boolean;
+        reconnectDelay?: number;
+    }): AsyncGenerator<MemoryEvent>;
     /**
      * Return a URL with `?api_key=<key>` appended for use with browser-native
      * `EventSource`, which cannot send custom request headers.
@@ -2117,4 +2320,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractedEntity, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceNerConfig, NotFoundError, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.js

@@ -1136,6 +1136,112 @@ var DakeraClient = class {
     return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
+  // 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 */
@@ -1474,6 +1580,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.

package/dist/index.mjs

@@ -1096,6 +1096,112 @@ var DakeraClient = class {
     return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
+  // 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 +1540,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.

package/package.json

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