@dakera-ai/dakera 0.2.0 → 0.4.0

package/README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue)](https://www.typescriptlang.org/)
 
-Official TypeScript/JavaScript client for [Dakera](https://github.com/dakera/dakera) - a high-performance vector database.
+Official TypeScript/JavaScript client for [Dakera](https://dakera.ai) — a high-performance vector database for AI agent memory.
 
 ## Installation
 
@@ -44,10 +44,12 @@ for (const result of results.results) {
 ## Features
 
 - **Full TypeScript Support**: Complete type definitions for all operations
+- **Branded ID Types**: `VectorId`, `AgentId`, `MemoryId`, `SessionId` prevent cross-assignment bugs
 - **Vector Operations**: Upsert, query, delete, fetch vectors
 - **Full-Text Search**: Index documents and perform BM25 search
 - **Hybrid Search**: Combine vector and text search with configurable weights
 - **Namespace Management**: Create, list, delete namespaces
+- **Agent Memory**: Store, recall, and manage memories for AI agents
 - **Metadata Filtering**: Filter queries by metadata fields
 - **Automatic Retries**: Built-in retry logic with exponential backoff
 - **Error Handling**: Typed exceptions for different error scenarios
@@ -266,6 +268,29 @@ import type {
 } from 'dakera';
 ```
 
+### Branded ID Types
+
+v0.3.0 introduced branded string types to prevent accidental cross-assignment of IDs at compile time:
+
+```typescript
+import {
+  vectorId, agentId, memoryId, sessionId,
+  type VectorId, type AgentId, type MemoryId, type SessionId,
+} from 'dakera';
+
+// Factory helpers narrow plain strings to branded types
+const vid: VectorId = vectorId('vec-001');
+const aid: AgentId  = agentId('my-agent');
+
+// TypeScript catches cross-assignment mistakes:
+//   const bad: VectorId = agentId('x');  // TS error ✓
+
+// All SDK methods accept both branded and plain strings for convenience
+await client.upsert('my-namespace', [
+  { id: vid, values: [0.1, 0.2, 0.3] },
+]);
+```
+
 ## Browser Support
 
 This SDK uses the Fetch API and works in:
@@ -306,7 +331,6 @@ npm run lint
 | [dakera-dashboard](https://github.com/dakera-ai/dakera-dashboard) | Admin dashboard (Leptos/WASM) |
 | [dakera-docs](https://github.com/dakera-ai/dakera-docs) | Documentation |
 | [dakera-deploy](https://github.com/dakera-ai/dakera-deploy) | Deployment configs and Docker Compose |
-| [dakera-cortex](https://github.com/dakera-ai/dakera-cortex) | Flagship demo with AI agents |
 
 ## License
 

package/dist/index.d.mts

@@ -1,6 +1,28 @@
 /**
  * Dakera TypeScript SDK Types
  */
+declare const __brand: unique symbol;
+type Brand<B> = {
+    readonly [__brand]: B;
+};
+/** A branded string type — T is the nominal tag that prevents cross-assignment. */
+type Branded<T extends string, B> = T & Brand<B>;
+/** Opaque ID for a stored vector. */
+type VectorId = Branded<string, 'VectorId'>;
+/** Opaque ID for an agent. */
+type AgentId = Branded<string, 'AgentId'>;
+/** Opaque ID for a memory entry. */
+type MemoryId = Branded<string, 'MemoryId'>;
+/** Opaque ID for a session. */
+type SessionId = Branded<string, 'SessionId'>;
+/** Create a VectorId from a plain string. */
+declare function vectorId(id: string): VectorId;
+/** Create an AgentId from a plain string. */
+declare function agentId(id: string): AgentId;
+/** Create a MemoryId from a plain string. */
+declare function memoryId(id: string): MemoryId;
+/** Create a SessionId from a plain string. */
+declare function sessionId(id: string): SessionId;
 /** Read consistency level for queries */
 type ReadConsistency = 'strong' | 'eventual' | 'bounded_staleness';
 /** Distance metric for similarity search */
@@ -58,19 +80,19 @@ interface WarmCacheResponse {
 }
 /** Vector with ID, values, and optional metadata */
 interface Vector {
-    id: string;
+    id: VectorId;
     values: number[];
     metadata?: Record<string, unknown>;
 }
 /** Input for vector operations - can be Vector object or plain object */
 type VectorInput = Vector | {
-    id: string;
+    id: VectorId | string;
     values: number[];
     metadata?: Record<string, unknown>;
 };
 /** Result from a vector query */
 interface QueryResult {
-    id: string;
+    id: VectorId;
     score: number;
     vector?: number[];
     metadata?: Record<string, unknown>;
@@ -104,25 +126,25 @@ interface IndexStats {
 }
 /** Document for full-text search */
 interface Document {
-    id: string;
+    id: VectorId;
     content: string;
     metadata?: Record<string, unknown>;
 }
 /** Input for document operations */
 type DocumentInput = Document | {
-    id: string;
+    id: VectorId | string;
     content: string;
     metadata?: Record<string, unknown>;
 };
 /** Result from full-text search */
 interface FullTextSearchResult {
-    id: string;
+    id: VectorId;
     score: number;
     metadata?: Record<string, unknown>;
 }
 /** Result from hybrid search */
 interface HybridSearchResult {
-    id: string;
+    id: VectorId;
     /** Combined score */
     score: number;
     /** Vector similarity score (normalized 0-1) */
@@ -277,7 +299,7 @@ interface TextQueryOptions {
  */
 interface TextSearchResult {
     /** Document ID */
-    id: string;
+    id: VectorId;
     /** Similarity score */
     score: number;
     /** Original text (if includeText was true) */
@@ -348,7 +370,7 @@ interface StoreMemoryRequest {
 /** A stored memory */
 interface Memory {
     /** Memory ID */
-    id: string;
+    id: MemoryId;
     /** Memory content */
     content: string;
     /** Memory type */
@@ -367,7 +389,7 @@ interface Memory {
 /** A recalled memory with similarity score */
 interface RecalledMemory {
     /** Memory ID */
-    id: string;
+    id: MemoryId;
     /** Memory content */
     content: string;
     /** Memory type */
@@ -384,7 +406,7 @@ interface RecalledMemory {
 /** Response from storing a memory */
 interface StoreMemoryResponse {
     /** Created memory ID */
-    memory_id: string;
+    memory_id: MemoryId;
     /** Status */
     status: string;
 }
@@ -411,7 +433,7 @@ interface RecallRequest {
 /** Request to update importance */
 interface UpdateImportanceRequest {
     /** Memory IDs to update */
-    memory_ids: string[];
+    memory_ids: MemoryId[];
     /** New importance value */
     importance: number;
 }
@@ -431,12 +453,12 @@ interface ConsolidateResponse {
     /** Number of memories removed */
     removed_count: number;
     /** IDs of new consolidated memories */
-    new_memories: string[];
+    new_memories: MemoryId[];
 }
 /** Request for memory feedback */
 interface MemoryFeedbackRequest {
     /** Memory ID */
-    memory_id: string;
+    memory_id: MemoryId;
     /** Feedback text */
     feedback: string;
     /** Optional relevance score */
@@ -452,16 +474,16 @@ interface MemoryFeedbackResponse {
 /** Request to start a session */
 interface StartSessionRequest {
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Optional session metadata */
     metadata?: Record<string, unknown>;
 }
 /** A session */
 interface Session {
     /** Session ID */
-    session_id: string;
+    session_id: SessionId;
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Start timestamp */
     started_at?: string;
     /** End timestamp */
@@ -483,7 +505,7 @@ interface ListSessionsOptions {
 /** Summary info for an agent */
 interface AgentSummary {
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Total memory count */
     memory_count: number;
     /** Total session count */
@@ -494,7 +516,7 @@ interface AgentSummary {
 /** Detailed stats for an agent */
 interface AgentStats {
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Total memory count */
     total_memories: number;
     /** Memories grouped by type */
@@ -512,14 +534,14 @@ interface AgentStats {
 }
 /** Request to build a knowledge graph */
 interface KnowledgeGraphRequest {
-    agent_id: string;
-    memory_id?: string;
+    agent_id: AgentId;
+    memory_id?: MemoryId;
     depth?: number;
     min_similarity?: number;
 }
 /** A node in the knowledge graph */
 interface KnowledgeNode {
-    id: string;
+    id: MemoryId;
     content: string;
     memory_type?: string;
     importance?: number;
@@ -527,8 +549,8 @@ interface KnowledgeNode {
 }
 /** An edge in the knowledge graph */
 interface KnowledgeEdge {
-    source: string;
-    target: string;
+    source: MemoryId;
+    target: MemoryId;
     similarity: number;
     relationship?: string;
 }
@@ -540,7 +562,7 @@ interface KnowledgeGraphResponse {
 }
 /** Request for full knowledge graph */
 interface FullKnowledgeGraphRequest {
-    agent_id: string;
+    agent_id: AgentId;
     max_nodes?: number;
     min_similarity?: number;
     cluster_threshold?: number;
@@ -548,8 +570,8 @@ interface FullKnowledgeGraphRequest {
 }
 /** Request to summarize memories */
 interface SummarizeRequest {
-    agent_id: string;
-    memory_ids?: string[];
+    agent_id: AgentId;
+    memory_ids?: MemoryId[];
     target_type?: string;
     dry_run?: boolean;
 }
@@ -557,11 +579,11 @@ interface SummarizeRequest {
 interface SummarizeResponse {
     summary: string;
     source_count: number;
-    new_memory_id?: string;
+    new_memory_id?: MemoryId;
 }
 /** Request to deduplicate memories */
 interface DeduplicateRequest {
-    agent_id: string;
+    agent_id: AgentId;
     threshold?: number;
     memory_type?: string;
     dry_run?: boolean;
@@ -801,6 +823,61 @@ 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;
 /** Cluster status response */
 interface ClusterStatus {
     status: string;
@@ -1484,6 +1561,45 @@ 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>;
+    /** Low-level SSE streaming helper — parses the SSE wire format. */
+    private _streamSse;
+    /** Parse a single SSE event block into a {@link DakeraEvent}. */
+    private _parseSseBlock;
 }
 
 /**
@@ -1525,4 +1641,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, 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 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 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 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 VectorInput, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier };
+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 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 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

@@ -1,6 +1,28 @@
 /**
  * Dakera TypeScript SDK Types
  */
+declare const __brand: unique symbol;
+type Brand<B> = {
+    readonly [__brand]: B;
+};
+/** A branded string type — T is the nominal tag that prevents cross-assignment. */
+type Branded<T extends string, B> = T & Brand<B>;
+/** Opaque ID for a stored vector. */
+type VectorId = Branded<string, 'VectorId'>;
+/** Opaque ID for an agent. */
+type AgentId = Branded<string, 'AgentId'>;
+/** Opaque ID for a memory entry. */
+type MemoryId = Branded<string, 'MemoryId'>;
+/** Opaque ID for a session. */
+type SessionId = Branded<string, 'SessionId'>;
+/** Create a VectorId from a plain string. */
+declare function vectorId(id: string): VectorId;
+/** Create an AgentId from a plain string. */
+declare function agentId(id: string): AgentId;
+/** Create a MemoryId from a plain string. */
+declare function memoryId(id: string): MemoryId;
+/** Create a SessionId from a plain string. */
+declare function sessionId(id: string): SessionId;
 /** Read consistency level for queries */
 type ReadConsistency = 'strong' | 'eventual' | 'bounded_staleness';
 /** Distance metric for similarity search */
@@ -58,19 +80,19 @@ interface WarmCacheResponse {
 }
 /** Vector with ID, values, and optional metadata */
 interface Vector {
-    id: string;
+    id: VectorId;
     values: number[];
     metadata?: Record<string, unknown>;
 }
 /** Input for vector operations - can be Vector object or plain object */
 type VectorInput = Vector | {
-    id: string;
+    id: VectorId | string;
     values: number[];
     metadata?: Record<string, unknown>;
 };
 /** Result from a vector query */
 interface QueryResult {
-    id: string;
+    id: VectorId;
     score: number;
     vector?: number[];
     metadata?: Record<string, unknown>;
@@ -104,25 +126,25 @@ interface IndexStats {
 }
 /** Document for full-text search */
 interface Document {
-    id: string;
+    id: VectorId;
     content: string;
     metadata?: Record<string, unknown>;
 }
 /** Input for document operations */
 type DocumentInput = Document | {
-    id: string;
+    id: VectorId | string;
     content: string;
     metadata?: Record<string, unknown>;
 };
 /** Result from full-text search */
 interface FullTextSearchResult {
-    id: string;
+    id: VectorId;
     score: number;
     metadata?: Record<string, unknown>;
 }
 /** Result from hybrid search */
 interface HybridSearchResult {
-    id: string;
+    id: VectorId;
     /** Combined score */
     score: number;
     /** Vector similarity score (normalized 0-1) */
@@ -277,7 +299,7 @@ interface TextQueryOptions {
  */
 interface TextSearchResult {
     /** Document ID */
-    id: string;
+    id: VectorId;
     /** Similarity score */
     score: number;
     /** Original text (if includeText was true) */
@@ -348,7 +370,7 @@ interface StoreMemoryRequest {
 /** A stored memory */
 interface Memory {
     /** Memory ID */
-    id: string;
+    id: MemoryId;
     /** Memory content */
     content: string;
     /** Memory type */
@@ -367,7 +389,7 @@ interface Memory {
 /** A recalled memory with similarity score */
 interface RecalledMemory {
     /** Memory ID */
-    id: string;
+    id: MemoryId;
     /** Memory content */
     content: string;
     /** Memory type */
@@ -384,7 +406,7 @@ interface RecalledMemory {
 /** Response from storing a memory */
 interface StoreMemoryResponse {
     /** Created memory ID */
-    memory_id: string;
+    memory_id: MemoryId;
     /** Status */
     status: string;
 }
@@ -411,7 +433,7 @@ interface RecallRequest {
 /** Request to update importance */
 interface UpdateImportanceRequest {
     /** Memory IDs to update */
-    memory_ids: string[];
+    memory_ids: MemoryId[];
     /** New importance value */
     importance: number;
 }
@@ -431,12 +453,12 @@ interface ConsolidateResponse {
     /** Number of memories removed */
     removed_count: number;
     /** IDs of new consolidated memories */
-    new_memories: string[];
+    new_memories: MemoryId[];
 }
 /** Request for memory feedback */
 interface MemoryFeedbackRequest {
     /** Memory ID */
-    memory_id: string;
+    memory_id: MemoryId;
     /** Feedback text */
     feedback: string;
     /** Optional relevance score */
@@ -452,16 +474,16 @@ interface MemoryFeedbackResponse {
 /** Request to start a session */
 interface StartSessionRequest {
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Optional session metadata */
     metadata?: Record<string, unknown>;
 }
 /** A session */
 interface Session {
     /** Session ID */
-    session_id: string;
+    session_id: SessionId;
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Start timestamp */
     started_at?: string;
     /** End timestamp */
@@ -483,7 +505,7 @@ interface ListSessionsOptions {
 /** Summary info for an agent */
 interface AgentSummary {
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Total memory count */
     memory_count: number;
     /** Total session count */
@@ -494,7 +516,7 @@ interface AgentSummary {
 /** Detailed stats for an agent */
 interface AgentStats {
     /** Agent ID */
-    agent_id: string;
+    agent_id: AgentId;
     /** Total memory count */
     total_memories: number;
     /** Memories grouped by type */
@@ -512,14 +534,14 @@ interface AgentStats {
 }
 /** Request to build a knowledge graph */
 interface KnowledgeGraphRequest {
-    agent_id: string;
-    memory_id?: string;
+    agent_id: AgentId;
+    memory_id?: MemoryId;
     depth?: number;
     min_similarity?: number;
 }
 /** A node in the knowledge graph */
 interface KnowledgeNode {
-    id: string;
+    id: MemoryId;
     content: string;
     memory_type?: string;
     importance?: number;
@@ -527,8 +549,8 @@ interface KnowledgeNode {
 }
 /** An edge in the knowledge graph */
 interface KnowledgeEdge {
-    source: string;
-    target: string;
+    source: MemoryId;
+    target: MemoryId;
     similarity: number;
     relationship?: string;
 }
@@ -540,7 +562,7 @@ interface KnowledgeGraphResponse {
 }
 /** Request for full knowledge graph */
 interface FullKnowledgeGraphRequest {
-    agent_id: string;
+    agent_id: AgentId;
     max_nodes?: number;
     min_similarity?: number;
     cluster_threshold?: number;
@@ -548,8 +570,8 @@ interface FullKnowledgeGraphRequest {
 }
 /** Request to summarize memories */
 interface SummarizeRequest {
-    agent_id: string;
-    memory_ids?: string[];
+    agent_id: AgentId;
+    memory_ids?: MemoryId[];
     target_type?: string;
     dry_run?: boolean;
 }
@@ -557,11 +579,11 @@ interface SummarizeRequest {
 interface SummarizeResponse {
     summary: string;
     source_count: number;
-    new_memory_id?: string;
+    new_memory_id?: MemoryId;
 }
 /** Request to deduplicate memories */
 interface DeduplicateRequest {
-    agent_id: string;
+    agent_id: AgentId;
     threshold?: number;
     memory_type?: string;
     dry_run?: boolean;
@@ -801,6 +823,61 @@ 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;
 /** Cluster status response */
 interface ClusterStatus {
     status: string;
@@ -1484,6 +1561,45 @@ 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>;
+    /** Low-level SSE streaming helper — parses the SSE wire format. */
+    private _streamSse;
+    /** Parse a single SSE event block into a {@link DakeraEvent}. */
+    private _parseSseBlock;
 }
 
 /**
@@ -1525,4 +1641,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, 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 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 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 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 VectorInput, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier };
+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 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 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

@@ -28,7 +28,11 @@ __export(index_exports, {
   RateLimitError: () => RateLimitError,
   ServerError: () => ServerError,
   TimeoutError: () => TimeoutError,
-  ValidationError: () => ValidationError
+  ValidationError: () => ValidationError,
+  agentId: () => agentId,
+  memoryId: () => memoryId,
+  sessionId: () => sessionId,
+  vectorId: () => vectorId
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -938,59 +942,59 @@ var DakeraClient = class {
   // Memory Operations
   // ===========================================================================
   /** Store a memory for an agent */
-  async storeMemory(agentId, request) {
-    return this.request("POST", `/v1/agents/${agentId}/memories`, request);
+  async storeMemory(agentId2, request) {
+    return this.request("POST", `/v1/agents/${agentId2}/memories`, request);
   }
   /** Recall memories for an agent */
-  async recall(agentId, query, options) {
+  async recall(agentId2, query, options) {
     const body = { query, ...options };
-    const result = await this.request("POST", `/v1/agents/${agentId}/memories/recall`, body);
+    const result = await this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
     return result.memories ?? result;
   }
   /** Get a specific memory */
-  async getMemory(agentId, memoryId) {
-    return this.request("GET", `/v1/agents/${agentId}/memories/${memoryId}`);
+  async getMemory(agentId2, memoryId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/memories/${memoryId2}`);
   }
   /** Update an existing memory */
-  async updateMemory(agentId, memoryId, request) {
-    return this.request("PUT", `/v1/agents/${agentId}/memories/${memoryId}`, request);
+  async updateMemory(agentId2, memoryId2, request) {
+    return this.request("PUT", `/v1/agents/${agentId2}/memories/${memoryId2}`, request);
   }
   /** Delete a memory */
-  async forget(agentId, memoryId) {
-    return this.request("DELETE", `/v1/agents/${agentId}/memories/${memoryId}`);
+  async forget(agentId2, memoryId2) {
+    return this.request("DELETE", `/v1/agents/${agentId2}/memories/${memoryId2}`);
   }
   /** Search memories for an agent */
-  async searchMemories(agentId, query, options) {
+  async searchMemories(agentId2, query, options) {
     const body = { query, ...options };
-    const result = await this.request("POST", `/v1/agents/${agentId}/memories/search`, body);
+    const result = await this.request("POST", `/v1/agents/${agentId2}/memories/search`, body);
     return result.memories ?? result;
   }
   /** Update importance of memories */
-  async updateImportance(agentId, request) {
-    return this.request("PUT", `/v1/agents/${agentId}/memories/importance`, request);
+  async updateImportance(agentId2, request) {
+    return this.request("PUT", `/v1/agents/${agentId2}/memories/importance`, request);
   }
   /** Consolidate memories for an agent */
-  async consolidate(agentId, request) {
-    return this.request("POST", `/v1/agents/${agentId}/memories/consolidate`, request ?? {});
+  async consolidate(agentId2, request) {
+    return this.request("POST", `/v1/agents/${agentId2}/memories/consolidate`, request ?? {});
   }
   /** Submit feedback on a memory recall */
-  async memoryFeedback(agentId, request) {
-    return this.request("POST", `/v1/agents/${agentId}/memories/feedback`, request);
+  async memoryFeedback(agentId2, request) {
+    return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
   // Session Operations
   // ===========================================================================
   /** Start a new session */
-  async startSession(agentId, metadata) {
-    return this.request("POST", "/v1/sessions/start", { agent_id: agentId, metadata });
+  async startSession(agentId2, metadata) {
+    return this.request("POST", "/v1/sessions/start", { agent_id: agentId2, metadata });
   }
   /** End a session */
-  async endSession(sessionId) {
-    return this.request("POST", `/v1/sessions/${sessionId}/end`);
+  async endSession(sessionId2) {
+    return this.request("POST", `/v1/sessions/${sessionId2}/end`);
   }
   /** Get session details */
-  async getSession(sessionId) {
-    return this.request("GET", `/v1/sessions/${sessionId}`);
+  async getSession(sessionId2) {
+    return this.request("GET", `/v1/sessions/${sessionId2}`);
   }
   /** List sessions */
   async listSessions(options) {
@@ -1003,8 +1007,8 @@ var DakeraClient = class {
     return this.request("GET", `/v1/sessions${qs ? `?${qs}` : ""}`);
   }
   /** Get memories for a session */
-  async sessionMemories(sessionId) {
-    return this.request("GET", `/v1/sessions/${sessionId}/memories`);
+  async sessionMemories(sessionId2) {
+    return this.request("GET", `/v1/sessions/${sessionId2}/memories`);
   }
   // ===========================================================================
   // Agent Operations
@@ -1014,24 +1018,24 @@ var DakeraClient = class {
     return this.request("GET", "/v1/agents");
   }
   /** Get memories for an agent */
-  async agentMemories(agentId, options) {
+  async agentMemories(agentId2, options) {
     const params = new URLSearchParams();
     if (options?.memory_type) params.set("memory_type", options.memory_type);
     if (options?.limit !== void 0) params.set("limit", String(options.limit));
     const qs = params.toString();
-    return this.request("GET", `/v1/agents/${agentId}/memories${qs ? `?${qs}` : ""}`);
+    return this.request("GET", `/v1/agents/${agentId2}/memories${qs ? `?${qs}` : ""}`);
   }
   /** Get stats for an agent */
-  async agentStats(agentId) {
-    return this.request("GET", `/v1/agents/${agentId}/stats`);
+  async agentStats(agentId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/stats`);
   }
   /** Get sessions for an agent */
-  async agentSessions(agentId, options) {
+  async agentSessions(agentId2, options) {
     const params = new URLSearchParams();
     if (options?.active_only !== void 0) params.set("active_only", String(options.active_only));
     if (options?.limit !== void 0) params.set("limit", String(options.limit));
     const qs = params.toString();
-    return this.request("GET", `/v1/agents/${agentId}/sessions${qs ? `?${qs}` : ""}`);
+    return this.request("GET", `/v1/agents/${agentId2}/sessions${qs ? `?${qs}` : ""}`);
   }
   // ===========================================================================
   // Knowledge Graph Operations
@@ -1195,7 +1199,111 @@ 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);
+  }
+  /** 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;
+    }
+  }
 };
+
+// src/types.ts
+function vectorId(id) {
+  return id;
+}
+function agentId(id) {
+  return id;
+}
+function memoryId(id) {
+  return id;
+}
+function sessionId(id) {
+  return id;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
@@ -1206,5 +1314,9 @@ var DakeraClient = class {
   RateLimitError,
   ServerError,
   TimeoutError,
-  ValidationError
+  ValidationError,
+  agentId,
+  memoryId,
+  sessionId,
+  vectorId
 });

package/dist/index.mjs

@@ -904,59 +904,59 @@ var DakeraClient = class {
   // Memory Operations
   // ===========================================================================
   /** Store a memory for an agent */
-  async storeMemory(agentId, request) {
-    return this.request("POST", `/v1/agents/${agentId}/memories`, request);
+  async storeMemory(agentId2, request) {
+    return this.request("POST", `/v1/agents/${agentId2}/memories`, request);
   }
   /** Recall memories for an agent */
-  async recall(agentId, query, options) {
+  async recall(agentId2, query, options) {
     const body = { query, ...options };
-    const result = await this.request("POST", `/v1/agents/${agentId}/memories/recall`, body);
+    const result = await this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
     return result.memories ?? result;
   }
   /** Get a specific memory */
-  async getMemory(agentId, memoryId) {
-    return this.request("GET", `/v1/agents/${agentId}/memories/${memoryId}`);
+  async getMemory(agentId2, memoryId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/memories/${memoryId2}`);
   }
   /** Update an existing memory */
-  async updateMemory(agentId, memoryId, request) {
-    return this.request("PUT", `/v1/agents/${agentId}/memories/${memoryId}`, request);
+  async updateMemory(agentId2, memoryId2, request) {
+    return this.request("PUT", `/v1/agents/${agentId2}/memories/${memoryId2}`, request);
   }
   /** Delete a memory */
-  async forget(agentId, memoryId) {
-    return this.request("DELETE", `/v1/agents/${agentId}/memories/${memoryId}`);
+  async forget(agentId2, memoryId2) {
+    return this.request("DELETE", `/v1/agents/${agentId2}/memories/${memoryId2}`);
   }
   /** Search memories for an agent */
-  async searchMemories(agentId, query, options) {
+  async searchMemories(agentId2, query, options) {
     const body = { query, ...options };
-    const result = await this.request("POST", `/v1/agents/${agentId}/memories/search`, body);
+    const result = await this.request("POST", `/v1/agents/${agentId2}/memories/search`, body);
     return result.memories ?? result;
   }
   /** Update importance of memories */
-  async updateImportance(agentId, request) {
-    return this.request("PUT", `/v1/agents/${agentId}/memories/importance`, request);
+  async updateImportance(agentId2, request) {
+    return this.request("PUT", `/v1/agents/${agentId2}/memories/importance`, request);
   }
   /** Consolidate memories for an agent */
-  async consolidate(agentId, request) {
-    return this.request("POST", `/v1/agents/${agentId}/memories/consolidate`, request ?? {});
+  async consolidate(agentId2, request) {
+    return this.request("POST", `/v1/agents/${agentId2}/memories/consolidate`, request ?? {});
   }
   /** Submit feedback on a memory recall */
-  async memoryFeedback(agentId, request) {
-    return this.request("POST", `/v1/agents/${agentId}/memories/feedback`, request);
+  async memoryFeedback(agentId2, request) {
+    return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
   // Session Operations
   // ===========================================================================
   /** Start a new session */
-  async startSession(agentId, metadata) {
-    return this.request("POST", "/v1/sessions/start", { agent_id: agentId, metadata });
+  async startSession(agentId2, metadata) {
+    return this.request("POST", "/v1/sessions/start", { agent_id: agentId2, metadata });
   }
   /** End a session */
-  async endSession(sessionId) {
-    return this.request("POST", `/v1/sessions/${sessionId}/end`);
+  async endSession(sessionId2) {
+    return this.request("POST", `/v1/sessions/${sessionId2}/end`);
   }
   /** Get session details */
-  async getSession(sessionId) {
-    return this.request("GET", `/v1/sessions/${sessionId}`);
+  async getSession(sessionId2) {
+    return this.request("GET", `/v1/sessions/${sessionId2}`);
   }
   /** List sessions */
   async listSessions(options) {
@@ -969,8 +969,8 @@ var DakeraClient = class {
     return this.request("GET", `/v1/sessions${qs ? `?${qs}` : ""}`);
   }
   /** Get memories for a session */
-  async sessionMemories(sessionId) {
-    return this.request("GET", `/v1/sessions/${sessionId}/memories`);
+  async sessionMemories(sessionId2) {
+    return this.request("GET", `/v1/sessions/${sessionId2}/memories`);
   }
   // ===========================================================================
   // Agent Operations
@@ -980,24 +980,24 @@ var DakeraClient = class {
     return this.request("GET", "/v1/agents");
   }
   /** Get memories for an agent */
-  async agentMemories(agentId, options) {
+  async agentMemories(agentId2, options) {
     const params = new URLSearchParams();
     if (options?.memory_type) params.set("memory_type", options.memory_type);
     if (options?.limit !== void 0) params.set("limit", String(options.limit));
     const qs = params.toString();
-    return this.request("GET", `/v1/agents/${agentId}/memories${qs ? `?${qs}` : ""}`);
+    return this.request("GET", `/v1/agents/${agentId2}/memories${qs ? `?${qs}` : ""}`);
   }
   /** Get stats for an agent */
-  async agentStats(agentId) {
-    return this.request("GET", `/v1/agents/${agentId}/stats`);
+  async agentStats(agentId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/stats`);
   }
   /** Get sessions for an agent */
-  async agentSessions(agentId, options) {
+  async agentSessions(agentId2, options) {
     const params = new URLSearchParams();
     if (options?.active_only !== void 0) params.set("active_only", String(options.active_only));
     if (options?.limit !== void 0) params.set("limit", String(options.limit));
     const qs = params.toString();
-    return this.request("GET", `/v1/agents/${agentId}/sessions${qs ? `?${qs}` : ""}`);
+    return this.request("GET", `/v1/agents/${agentId2}/sessions${qs ? `?${qs}` : ""}`);
   }
   // ===========================================================================
   // Knowledge Graph Operations
@@ -1161,7 +1161,111 @@ 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);
+  }
+  /** 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;
+    }
+  }
 };
+
+// src/types.ts
+function vectorId(id) {
+  return id;
+}
+function agentId(id) {
+  return id;
+}
+function memoryId(id) {
+  return id;
+}
+function sessionId(id) {
+  return id;
+}
 export {
   AuthenticationError,
   ConnectionError,
@@ -1171,5 +1275,9 @@ export {
   RateLimitError,
   ServerError,
   TimeoutError,
-  ValidationError
+  ValidationError,
+  agentId,
+  memoryId,
+  sessionId,
+  vectorId
 };

package/package.json

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