@dakera-ai/dakera 0.3.0 → 0.5.0

package/dist/index.d.mts

@@ -823,6 +823,138 @@ interface ColumnUpsertRequest {
     /** Expected dimension */
     dimension?: number;
 }
+/** Operation status for ``operation_progress`` events. */
+type OpStatus = 'pending' | 'running' | 'completed' | 'failed';
+/** Vector mutation operation type for ``vectors_mutated`` events. */
+type VectorMutationOp = 'upserted' | 'deleted';
+/** A namespace was created. */
+interface NamespaceCreatedEvent {
+    type: 'namespace_created';
+    namespace: string;
+    dimension: number;
+}
+/** A namespace was deleted. */
+interface NamespaceDeletedEvent {
+    type: 'namespace_deleted';
+    namespace: string;
+}
+/** Progress update for a long-running operation (0–100). */
+interface OperationProgressEvent {
+    type: 'operation_progress';
+    operation_id: string;
+    namespace?: string;
+    op_type: string;
+    /** Progress percentage 0–100 */
+    progress: number;
+    status: OpStatus;
+    message?: string;
+    /** Unix milliseconds */
+    updated_at: number;
+}
+/** A background job changed status. */
+interface JobProgressEvent {
+    type: 'job_progress';
+    job_id: string;
+    job_type: string;
+    namespace?: string;
+    progress: number;
+    status: string;
+}
+/** Vectors were upserted or deleted in bulk (threshold: >100 vectors). */
+interface VectorsMutatedEvent {
+    type: 'vectors_mutated';
+    namespace: string;
+    op: VectorMutationOp;
+    count: number;
+}
+/**
+ * Subscriber fell too far behind — some events were dropped.
+ * Reconnect to resume the stream.
+ */
+interface StreamLaggedEvent {
+    type: 'stream_lagged';
+    dropped: number;
+    hint: string;
+}
+/** Union of all Dakera SSE event types. */
+type DakeraEvent = NamespaceCreatedEvent | NamespaceDeletedEvent | OperationProgressEvent | JobProgressEvent | VectorsMutatedEvent | StreamLaggedEvent;
+/**
+ * A memory lifecycle event emitted on the agent memory SSE stream.
+ *
+ * event_type values:
+ *   stored | recalled | forgotten | consolidated |
+ *   importance_updated | session_started | session_ended
+ */
+interface MemoryEvent {
+    /** Memory lifecycle event type */
+    event_type: string;
+    /** Agent that owns the memory */
+    agent_id: string;
+    /** Unix milliseconds */
+    timestamp: number;
+    /** Memory ID (present for most event types) */
+    memory_id?: string;
+    /** Memory content snapshot */
+    content?: string;
+    /** Importance score at the time of the event */
+    importance?: number;
+    /** Tags associated with the memory */
+    tags?: string[];
+    /** Session ID (present for session_started / session_ended events) */
+    session_id?: string;
+}
+/** Summary info for one agent in the cross-agent network */
+interface AgentNetworkInfo {
+    agent_id: string;
+    memory_count: number;
+    avg_importance: number;
+}
+/** A node in the cross-agent memory network graph */
+interface AgentNetworkNode {
+    id: string;
+    agent_id: string;
+    content: string;
+    importance: number;
+    tags: string[];
+    memory_type: string;
+    /** Unix milliseconds */
+    created_at: number;
+}
+/** A cross-agent similarity edge */
+interface AgentNetworkEdge {
+    source: string;
+    target: string;
+    source_agent: string;
+    target_agent: string;
+    similarity: number;
+}
+/** Aggregate statistics for the cross-agent network */
+interface AgentNetworkStats {
+    total_agents: number;
+    total_nodes: number;
+    total_cross_edges: number;
+    density: number;
+}
+/** Response from the cross-agent network endpoint */
+interface CrossAgentNetworkResponse {
+    agents: AgentNetworkInfo[];
+    nodes: AgentNetworkNode[];
+    edges: AgentNetworkEdge[];
+    stats: AgentNetworkStats;
+}
+/** Request body for POST /v1/knowledge/network/cross-agent */
+interface CrossAgentNetworkRequest {
+    /** Agent IDs to include — undefined means all agents */
+    agent_ids?: string[];
+    /** Minimum similarity threshold for edges (default 0.3) */
+    min_similarity?: number;
+    /** Maximum nodes to include per agent (default 50) */
+    max_nodes_per_agent?: number;
+    /** Minimum importance for a node to be included (default 0.0) */
+    min_importance?: number;
+    /** Maximum cross-agent edges to return (default 200) */
+    max_cross_edges?: number;
+}
 /** Cluster status response */
 interface ClusterStatus {
     status: string;
@@ -1435,6 +1567,22 @@ declare class DakeraClient {
     summarize(request: SummarizeRequest): Promise<SummarizeResponse>;
     /** Deduplicate memories */
     deduplicate(request: DeduplicateRequest): Promise<DeduplicateResponse>;
+    /**
+     * Build a cross-agent memory network graph (DASH-A).
+     *
+     * Calls `POST /v1/knowledge/network/cross-agent` and returns a graph
+     * containing every agent's nodes and the cross-agent similarity edges that
+     * connect them.
+     *
+     * Requires an Admin-scoped API key.
+     *
+     * @example
+     * ```ts
+     * const network = await client.crossAgentNetwork({ min_similarity: 0.5 });
+     * console.log(`${network.stats.total_cross_edges} cross-agent edges`);
+     * ```
+     */
+    crossAgentNetwork(req?: CrossAgentNetworkRequest): Promise<CrossAgentNetworkResponse>;
     /** Get analytics overview */
     analyticsOverview(options?: AnalyticsOptions): Promise<AnalyticsOverview>;
     /** Get latency analytics */
@@ -1506,6 +1654,74 @@ declare class DakeraClient {
     rotateKey(keyId: string): Promise<ApiKey>;
     /** Get usage statistics for an API key */
     keyUsage(keyId: string): Promise<KeyUsage>;
+    /**
+     * Stream SSE events scoped to a namespace.
+     *
+     * Opens a long-lived connection to `GET /v1/namespaces/{namespace}/events`
+     * and yields {@link DakeraEvent} objects as they arrive.  The async
+     * generator runs until the connection closes or the caller breaks the loop.
+     *
+     * Requires a Read-scoped API key.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.streamNamespaceEvents('my-ns')) {
+     *   if (event.type === 'vectors_mutated') {
+     *     console.log(`${event.count} vectors ${event.op} in ${event.namespace}`);
+     *   }
+     * }
+     * ```
+     */
+    streamNamespaceEvents(namespace: string): AsyncGenerator<DakeraEvent>;
+    /**
+     * Stream all system events from the global event bus.
+     *
+     * Opens a long-lived connection to `GET /ops/events` and yields
+     * {@link DakeraEvent} objects as they arrive.
+     *
+     * Requires an Admin-scoped API key.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.streamGlobalEvents()) {
+     *   console.log(event.type, event);
+     * }
+     * ```
+     */
+    streamGlobalEvents(): AsyncGenerator<DakeraEvent>;
+    /**
+     * Stream memory lifecycle events for all agents (DASH-B).
+     *
+     * Opens a long-lived connection to `GET /v1/events/stream` and yields
+     * {@link MemoryEvent} objects as they arrive.  Each SSE frame uses the
+     * `event:` field for the event_type and a JSON `data:` payload.
+     *
+     * Requires a Read-scoped API key.
+     *
+     * @example
+     * ```ts
+     * for await (const ev of client.streamMemoryEvents()) {
+     *   if (ev.event_type === 'stored') {
+     *     console.log(`Memory stored for agent ${ev.agent_id}: ${ev.content}`);
+     *   }
+     * }
+     * ```
+     */
+    streamMemoryEvents(): AsyncGenerator<MemoryEvent>;
+    /** Low-level SSE streaming helper — parses the SSE wire format. */
+    private _streamSse;
+    /** Parse a single SSE event block into a {@link DakeraEvent}. */
+    private _parseSseBlock;
+    /**
+     * Low-level SSE streaming helper for the memory event stream.
+     *
+     * The memory event stream sets the SSE `event:` field to the event_type
+     * and the `data:` field to the JSON payload.  This helper merges the two
+     * so callers receive a fully-populated {@link MemoryEvent}.
+     */
+    private _streamSseMemory;
+    /** Parse a single SSE event block into a {@link MemoryEvent}. */
+    private _parseSseMemoryBlock;
 }
 
 /**
@@ -1547,4 +1763,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, DakeraClient, DakeraError, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceInfo, NotFoundError, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, 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 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, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, 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 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 QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, 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

@@ -823,6 +823,138 @@ interface ColumnUpsertRequest {
     /** Expected dimension */
     dimension?: number;
 }
+/** Operation status for ``operation_progress`` events. */
+type OpStatus = 'pending' | 'running' | 'completed' | 'failed';
+/** Vector mutation operation type for ``vectors_mutated`` events. */
+type VectorMutationOp = 'upserted' | 'deleted';
+/** A namespace was created. */
+interface NamespaceCreatedEvent {
+    type: 'namespace_created';
+    namespace: string;
+    dimension: number;
+}
+/** A namespace was deleted. */
+interface NamespaceDeletedEvent {
+    type: 'namespace_deleted';
+    namespace: string;
+}
+/** Progress update for a long-running operation (0–100). */
+interface OperationProgressEvent {
+    type: 'operation_progress';
+    operation_id: string;
+    namespace?: string;
+    op_type: string;
+    /** Progress percentage 0–100 */
+    progress: number;
+    status: OpStatus;
+    message?: string;
+    /** Unix milliseconds */
+    updated_at: number;
+}
+/** A background job changed status. */
+interface JobProgressEvent {
+    type: 'job_progress';
+    job_id: string;
+    job_type: string;
+    namespace?: string;
+    progress: number;
+    status: string;
+}
+/** Vectors were upserted or deleted in bulk (threshold: >100 vectors). */
+interface VectorsMutatedEvent {
+    type: 'vectors_mutated';
+    namespace: string;
+    op: VectorMutationOp;
+    count: number;
+}
+/**
+ * Subscriber fell too far behind — some events were dropped.
+ * Reconnect to resume the stream.
+ */
+interface StreamLaggedEvent {
+    type: 'stream_lagged';
+    dropped: number;
+    hint: string;
+}
+/** Union of all Dakera SSE event types. */
+type DakeraEvent = NamespaceCreatedEvent | NamespaceDeletedEvent | OperationProgressEvent | JobProgressEvent | VectorsMutatedEvent | StreamLaggedEvent;
+/**
+ * A memory lifecycle event emitted on the agent memory SSE stream.
+ *
+ * event_type values:
+ *   stored | recalled | forgotten | consolidated |
+ *   importance_updated | session_started | session_ended
+ */
+interface MemoryEvent {
+    /** Memory lifecycle event type */
+    event_type: string;
+    /** Agent that owns the memory */
+    agent_id: string;
+    /** Unix milliseconds */
+    timestamp: number;
+    /** Memory ID (present for most event types) */
+    memory_id?: string;
+    /** Memory content snapshot */
+    content?: string;
+    /** Importance score at the time of the event */
+    importance?: number;
+    /** Tags associated with the memory */
+    tags?: string[];
+    /** Session ID (present for session_started / session_ended events) */
+    session_id?: string;
+}
+/** Summary info for one agent in the cross-agent network */
+interface AgentNetworkInfo {
+    agent_id: string;
+    memory_count: number;
+    avg_importance: number;
+}
+/** A node in the cross-agent memory network graph */
+interface AgentNetworkNode {
+    id: string;
+    agent_id: string;
+    content: string;
+    importance: number;
+    tags: string[];
+    memory_type: string;
+    /** Unix milliseconds */
+    created_at: number;
+}
+/** A cross-agent similarity edge */
+interface AgentNetworkEdge {
+    source: string;
+    target: string;
+    source_agent: string;
+    target_agent: string;
+    similarity: number;
+}
+/** Aggregate statistics for the cross-agent network */
+interface AgentNetworkStats {
+    total_agents: number;
+    total_nodes: number;
+    total_cross_edges: number;
+    density: number;
+}
+/** Response from the cross-agent network endpoint */
+interface CrossAgentNetworkResponse {
+    agents: AgentNetworkInfo[];
+    nodes: AgentNetworkNode[];
+    edges: AgentNetworkEdge[];
+    stats: AgentNetworkStats;
+}
+/** Request body for POST /v1/knowledge/network/cross-agent */
+interface CrossAgentNetworkRequest {
+    /** Agent IDs to include — undefined means all agents */
+    agent_ids?: string[];
+    /** Minimum similarity threshold for edges (default 0.3) */
+    min_similarity?: number;
+    /** Maximum nodes to include per agent (default 50) */
+    max_nodes_per_agent?: number;
+    /** Minimum importance for a node to be included (default 0.0) */
+    min_importance?: number;
+    /** Maximum cross-agent edges to return (default 200) */
+    max_cross_edges?: number;
+}
 /** Cluster status response */
 interface ClusterStatus {
     status: string;
@@ -1435,6 +1567,22 @@ declare class DakeraClient {
     summarize(request: SummarizeRequest): Promise<SummarizeResponse>;
     /** Deduplicate memories */
     deduplicate(request: DeduplicateRequest): Promise<DeduplicateResponse>;
+    /**
+     * Build a cross-agent memory network graph (DASH-A).
+     *
+     * Calls `POST /v1/knowledge/network/cross-agent` and returns a graph
+     * containing every agent's nodes and the cross-agent similarity edges that
+     * connect them.
+     *
+     * Requires an Admin-scoped API key.
+     *
+     * @example
+     * ```ts
+     * const network = await client.crossAgentNetwork({ min_similarity: 0.5 });
+     * console.log(`${network.stats.total_cross_edges} cross-agent edges`);
+     * ```
+     */
+    crossAgentNetwork(req?: CrossAgentNetworkRequest): Promise<CrossAgentNetworkResponse>;
     /** Get analytics overview */
     analyticsOverview(options?: AnalyticsOptions): Promise<AnalyticsOverview>;
     /** Get latency analytics */
@@ -1506,6 +1654,74 @@ declare class DakeraClient {
     rotateKey(keyId: string): Promise<ApiKey>;
     /** Get usage statistics for an API key */
     keyUsage(keyId: string): Promise<KeyUsage>;
+    /**
+     * Stream SSE events scoped to a namespace.
+     *
+     * Opens a long-lived connection to `GET /v1/namespaces/{namespace}/events`
+     * and yields {@link DakeraEvent} objects as they arrive.  The async
+     * generator runs until the connection closes or the caller breaks the loop.
+     *
+     * Requires a Read-scoped API key.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.streamNamespaceEvents('my-ns')) {
+     *   if (event.type === 'vectors_mutated') {
+     *     console.log(`${event.count} vectors ${event.op} in ${event.namespace}`);
+     *   }
+     * }
+     * ```
+     */
+    streamNamespaceEvents(namespace: string): AsyncGenerator<DakeraEvent>;
+    /**
+     * Stream all system events from the global event bus.
+     *
+     * Opens a long-lived connection to `GET /ops/events` and yields
+     * {@link DakeraEvent} objects as they arrive.
+     *
+     * Requires an Admin-scoped API key.
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.streamGlobalEvents()) {
+     *   console.log(event.type, event);
+     * }
+     * ```
+     */
+    streamGlobalEvents(): AsyncGenerator<DakeraEvent>;
+    /**
+     * Stream memory lifecycle events for all agents (DASH-B).
+     *
+     * Opens a long-lived connection to `GET /v1/events/stream` and yields
+     * {@link MemoryEvent} objects as they arrive.  Each SSE frame uses the
+     * `event:` field for the event_type and a JSON `data:` payload.
+     *
+     * Requires a Read-scoped API key.
+     *
+     * @example
+     * ```ts
+     * for await (const ev of client.streamMemoryEvents()) {
+     *   if (ev.event_type === 'stored') {
+     *     console.log(`Memory stored for agent ${ev.agent_id}: ${ev.content}`);
+     *   }
+     * }
+     * ```
+     */
+    streamMemoryEvents(): AsyncGenerator<MemoryEvent>;
+    /** Low-level SSE streaming helper — parses the SSE wire format. */
+    private _streamSse;
+    /** Parse a single SSE event block into a {@link DakeraEvent}. */
+    private _parseSseBlock;
+    /**
+     * Low-level SSE streaming helper for the memory event stream.
+     *
+     * The memory event stream sets the SSE `event:` field to the event_type
+     * and the `data:` field to the JSON payload.  This helper merges the two
+     * so callers receive a fully-populated {@link MemoryEvent}.
+     */
+    private _streamSseMemory;
+    /** Parse a single SSE event block into a {@link MemoryEvent}. */
+    private _parseSseMemoryBlock;
 }
 
 /**
@@ -1547,4 +1763,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, DakeraClient, DakeraError, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceInfo, NotFoundError, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, 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 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, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, 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 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 QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, 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

@@ -1056,6 +1056,28 @@ var DakeraClient = class {
   async deduplicate(request) {
     return this.request("POST", "/v1/knowledge/deduplicate", request);
   }
+  /**
+   * Build a cross-agent memory network graph (DASH-A).
+   *
+   * Calls `POST /v1/knowledge/network/cross-agent` and returns a graph
+   * containing every agent's nodes and the cross-agent similarity edges that
+   * connect them.
+   *
+   * Requires an Admin-scoped API key.
+   *
+   * @example
+   * ```ts
+   * const network = await client.crossAgentNetwork({ min_similarity: 0.5 });
+   * console.log(`${network.stats.total_cross_edges} cross-agent edges`);
+   * ```
+   */
+  async crossAgentNetwork(req) {
+    return this.request(
+      "POST",
+      "/v1/knowledge/network/cross-agent",
+      req ?? {}
+    );
+  }
   // ===========================================================================
   // Analytics Operations
   // ===========================================================================
@@ -1199,6 +1221,178 @@ var DakeraClient = class {
   async keyUsage(keyId) {
     return this.request("GET", `/v1/keys/${keyId}/usage`);
   }
+  // ===========================================================================
+  // SSE Streaming (CE-1)
+  // ===========================================================================
+  /**
+   * Stream SSE events scoped to a namespace.
+   *
+   * Opens a long-lived connection to `GET /v1/namespaces/{namespace}/events`
+   * and yields {@link DakeraEvent} objects as they arrive.  The async
+   * generator runs until the connection closes or the caller breaks the loop.
+   *
+   * Requires a Read-scoped API key.
+   *
+   * @example
+   * ```ts
+   * for await (const event of client.streamNamespaceEvents('my-ns')) {
+   *   if (event.type === 'vectors_mutated') {
+   *     console.log(`${event.count} vectors ${event.op} in ${event.namespace}`);
+   *   }
+   * }
+   * ```
+   */
+  async *streamNamespaceEvents(namespace) {
+    const url = `${this.baseUrl}/v1/namespaces/${encodeURIComponent(namespace)}/events`;
+    yield* this._streamSse(url);
+  }
+  /**
+   * Stream all system events from the global event bus.
+   *
+   * Opens a long-lived connection to `GET /ops/events` and yields
+   * {@link DakeraEvent} objects as they arrive.
+   *
+   * Requires an Admin-scoped API key.
+   *
+   * @example
+   * ```ts
+   * for await (const event of client.streamGlobalEvents()) {
+   *   console.log(event.type, event);
+   * }
+   * ```
+   */
+  async *streamGlobalEvents() {
+    const url = `${this.baseUrl}/ops/events`;
+    yield* this._streamSse(url);
+  }
+  /**
+   * Stream memory lifecycle events for all agents (DASH-B).
+   *
+   * Opens a long-lived connection to `GET /v1/events/stream` and yields
+   * {@link MemoryEvent} objects as they arrive.  Each SSE frame uses the
+   * `event:` field for the event_type and a JSON `data:` payload.
+   *
+   * Requires a Read-scoped API key.
+   *
+   * @example
+   * ```ts
+   * for await (const ev of client.streamMemoryEvents()) {
+   *   if (ev.event_type === 'stored') {
+   *     console.log(`Memory stored for agent ${ev.agent_id}: ${ev.content}`);
+   *   }
+   * }
+   * ```
+   */
+  async *streamMemoryEvents() {
+    const url = `${this.baseUrl}/v1/events/stream`;
+    yield* this._streamSseMemory(url);
+  }
+  /** Low-level SSE streaming helper — parses the SSE wire format. */
+  async *_streamSse(url) {
+    const headers = {
+      ...this.headers,
+      // includes Authorization and any custom headers
+      Accept: "text/event-stream",
+      "Cache-Control": "no-cache"
+    };
+    const response = await fetch(url, { headers });
+    if (!response.ok || !response.body) {
+      throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let boundary;
+        while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+          const block = buffer.slice(0, boundary);
+          buffer = buffer.slice(boundary + 2);
+          const event = this._parseSseBlock(block);
+          if (event !== null) yield event;
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /** Parse a single SSE event block into a {@link DakeraEvent}. */
+  _parseSseBlock(block) {
+    const dataLines = [];
+    for (const line of block.split("\n")) {
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("data:")) dataLines.push(line.slice(5).trimStart());
+    }
+    if (dataLines.length === 0) return null;
+    try {
+      return JSON.parse(dataLines.join("\n"));
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Low-level SSE streaming helper for the memory event stream.
+   *
+   * The memory event stream sets the SSE `event:` field to the event_type
+   * and the `data:` field to the JSON payload.  This helper merges the two
+   * so callers receive a fully-populated {@link MemoryEvent}.
+   */
+  async *_streamSseMemory(url) {
+    const headers = {
+      ...this.headers,
+      Accept: "text/event-stream",
+      "Cache-Control": "no-cache"
+    };
+    const response = await fetch(url, { headers });
+    if (!response.ok || !response.body) {
+      throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let boundary;
+        while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+          const block = buffer.slice(0, boundary);
+          buffer = buffer.slice(boundary + 2);
+          const event = this._parseSseMemoryBlock(block);
+          if (event !== null) yield event;
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /** Parse a single SSE event block into a {@link MemoryEvent}. */
+  _parseSseMemoryBlock(block) {
+    let eventType;
+    const dataLines = [];
+    for (const line of block.split("\n")) {
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("event:")) {
+        eventType = line.slice(6).trim();
+      } else if (line.startsWith("data:")) {
+        dataLines.push(line.slice(5).trimStart());
+      }
+    }
+    if (dataLines.length === 0) return null;
+    try {
+      const parsed = JSON.parse(dataLines.join("\n"));
+      if (eventType && !parsed.event_type) {
+        parsed.event_type = eventType;
+      }
+      return parsed;
+    } catch {
+      return null;
+    }
+  }
 };
 
 // src/types.ts

package/dist/index.mjs

@@ -1018,6 +1018,28 @@ var DakeraClient = class {
   async deduplicate(request) {
     return this.request("POST", "/v1/knowledge/deduplicate", request);
   }
+  /**
+   * Build a cross-agent memory network graph (DASH-A).
+   *
+   * Calls `POST /v1/knowledge/network/cross-agent` and returns a graph
+   * containing every agent's nodes and the cross-agent similarity edges that
+   * connect them.
+   *
+   * Requires an Admin-scoped API key.
+   *
+   * @example
+   * ```ts
+   * const network = await client.crossAgentNetwork({ min_similarity: 0.5 });
+   * console.log(`${network.stats.total_cross_edges} cross-agent edges`);
+   * ```
+   */
+  async crossAgentNetwork(req) {
+    return this.request(
+      "POST",
+      "/v1/knowledge/network/cross-agent",
+      req ?? {}
+    );
+  }
   // ===========================================================================
   // Analytics Operations
   // ===========================================================================
@@ -1161,6 +1183,178 @@ var DakeraClient = class {
   async keyUsage(keyId) {
     return this.request("GET", `/v1/keys/${keyId}/usage`);
   }
+  // ===========================================================================
+  // SSE Streaming (CE-1)
+  // ===========================================================================
+  /**
+   * Stream SSE events scoped to a namespace.
+   *
+   * Opens a long-lived connection to `GET /v1/namespaces/{namespace}/events`
+   * and yields {@link DakeraEvent} objects as they arrive.  The async
+   * generator runs until the connection closes or the caller breaks the loop.
+   *
+   * Requires a Read-scoped API key.
+   *
+   * @example
+   * ```ts
+   * for await (const event of client.streamNamespaceEvents('my-ns')) {
+   *   if (event.type === 'vectors_mutated') {
+   *     console.log(`${event.count} vectors ${event.op} in ${event.namespace}`);
+   *   }
+   * }
+   * ```
+   */
+  async *streamNamespaceEvents(namespace) {
+    const url = `${this.baseUrl}/v1/namespaces/${encodeURIComponent(namespace)}/events`;
+    yield* this._streamSse(url);
+  }
+  /**
+   * Stream all system events from the global event bus.
+   *
+   * Opens a long-lived connection to `GET /ops/events` and yields
+   * {@link DakeraEvent} objects as they arrive.
+   *
+   * Requires an Admin-scoped API key.
+   *
+   * @example
+   * ```ts
+   * for await (const event of client.streamGlobalEvents()) {
+   *   console.log(event.type, event);
+   * }
+   * ```
+   */
+  async *streamGlobalEvents() {
+    const url = `${this.baseUrl}/ops/events`;
+    yield* this._streamSse(url);
+  }
+  /**
+   * Stream memory lifecycle events for all agents (DASH-B).
+   *
+   * Opens a long-lived connection to `GET /v1/events/stream` and yields
+   * {@link MemoryEvent} objects as they arrive.  Each SSE frame uses the
+   * `event:` field for the event_type and a JSON `data:` payload.
+   *
+   * Requires a Read-scoped API key.
+   *
+   * @example
+   * ```ts
+   * for await (const ev of client.streamMemoryEvents()) {
+   *   if (ev.event_type === 'stored') {
+   *     console.log(`Memory stored for agent ${ev.agent_id}: ${ev.content}`);
+   *   }
+   * }
+   * ```
+   */
+  async *streamMemoryEvents() {
+    const url = `${this.baseUrl}/v1/events/stream`;
+    yield* this._streamSseMemory(url);
+  }
+  /** Low-level SSE streaming helper — parses the SSE wire format. */
+  async *_streamSse(url) {
+    const headers = {
+      ...this.headers,
+      // includes Authorization and any custom headers
+      Accept: "text/event-stream",
+      "Cache-Control": "no-cache"
+    };
+    const response = await fetch(url, { headers });
+    if (!response.ok || !response.body) {
+      throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let boundary;
+        while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+          const block = buffer.slice(0, boundary);
+          buffer = buffer.slice(boundary + 2);
+          const event = this._parseSseBlock(block);
+          if (event !== null) yield event;
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /** Parse a single SSE event block into a {@link DakeraEvent}. */
+  _parseSseBlock(block) {
+    const dataLines = [];
+    for (const line of block.split("\n")) {
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("data:")) dataLines.push(line.slice(5).trimStart());
+    }
+    if (dataLines.length === 0) return null;
+    try {
+      return JSON.parse(dataLines.join("\n"));
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Low-level SSE streaming helper for the memory event stream.
+   *
+   * The memory event stream sets the SSE `event:` field to the event_type
+   * and the `data:` field to the JSON payload.  This helper merges the two
+   * so callers receive a fully-populated {@link MemoryEvent}.
+   */
+  async *_streamSseMemory(url) {
+    const headers = {
+      ...this.headers,
+      Accept: "text/event-stream",
+      "Cache-Control": "no-cache"
+    };
+    const response = await fetch(url, { headers });
+    if (!response.ok || !response.body) {
+      throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let boundary;
+        while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+          const block = buffer.slice(0, boundary);
+          buffer = buffer.slice(boundary + 2);
+          const event = this._parseSseMemoryBlock(block);
+          if (event !== null) yield event;
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /** Parse a single SSE event block into a {@link MemoryEvent}. */
+  _parseSseMemoryBlock(block) {
+    let eventType;
+    const dataLines = [];
+    for (const line of block.split("\n")) {
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("event:")) {
+        eventType = line.slice(6).trim();
+      } else if (line.startsWith("data:")) {
+        dataLines.push(line.slice(5).trimStart());
+      }
+    }
+    if (dataLines.length === 0) return null;
+    try {
+      const parsed = JSON.parse(dataLines.join("\n"));
+      if (eventType && !parsed.event_type) {
+        parsed.event_type = eventType;
+      }
+      return parsed;
+    } catch {
+      return null;
+    }
+  }
 };
 
 // src/types.ts

package/package.json

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