@dakera-ai/dakera 0.9.13 → 0.9.15

package/README.md

@@ -1,20 +1,15 @@
-# Dakera TypeScript SDK
+# ⚡ dakera-js
 
-[![CI](https://github.com/dakera-ai/dakera-js/actions/workflows/ci.yml/badge.svg)](https://github.com/dakera-ai/dakera-js/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/dakera)](https://www.npmjs.com/package/dakera)
-[![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/)
+TypeScript SDK for Dakera AI — store, recall, and search agent memories against a Dakera instance.
 
-Official TypeScript/JavaScript SDK for [Dakera](https://dakera.ai) — the AI agent memory platform. Persistent, session-aware, cross-agent memory for your AI agents.
+Part of [Dakera AI](https://dakera.ai) — the memory engine for AI agents.
 
-## Installation
+---
+
+## Install
 
 ```bash
 npm install dakera
-# or
-yarn add dakera
-# or
-pnpm add dakera
 ```
 
 ## Quick Start
@@ -22,316 +17,60 @@ pnpm add dakera
 ```typescript
 import { DakeraClient } from 'dakera';
 
-// Connect to Dakera
-const client = new DakeraClient('http://localhost:3000');
-
-// Upsert vectors
-await client.upsert('my-namespace', [
-  { id: 'vec1', values: [0.1, 0.2, 0.3], metadata: { label: 'a' } },
-  { id: 'vec2', values: [0.4, 0.5, 0.6], metadata: { label: 'b' } },
-]);
-
-// Query similar vectors
-const results = await client.query('my-namespace', [0.1, 0.2, 0.3], {
-  topK: 10,
-});
-
-for (const result of results.results) {
-  console.log(`${result.id}: ${result.score}`);
-}
-```
-
-## 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
-
-## Usage Examples
-
-### Vector Operations
-
-```typescript
-import { DakeraClient } from 'dakera';
-
 const client = new DakeraClient({
-  baseUrl: 'http://localhost:3000',
-  apiKey: 'your-api-key', // optional
-  timeout: 30000,
+  baseUrl: 'http://localhost:3300',
+  apiKey: 'your-key',
 });
 
-// Upsert vectors
-await client.upsert('my-namespace', [
-  { id: 'vec1', values: [0.1, 0.2, 0.3], metadata: { category: 'A' } },
-  { id: 'vec2', values: [0.4, 0.5, 0.6], metadata: { category: 'B' } },
-]);
-
-// Query with metadata filter
-const results = await client.query('my-namespace', [0.1, 0.2, 0.3], {
-  topK: 5,
-  filter: { category: { $eq: 'A' } },
-  includeMetadata: true,
-});
-
-// Batch query
-const batchResults = await client.batchQuery('my-namespace', [
-  { vector: [0.1, 0.2, 0.3], topK: 5 },
-  { vector: [0.4, 0.5, 0.6], topK: 3 },
-]);
-
-// Fetch vectors by ID
-const vectors = await client.fetch('my-namespace', ['vec1', 'vec2']);
-
-// Delete vectors
-await client.delete('my-namespace', { ids: ['vec1', 'vec2'] });
-await client.delete('my-namespace', { filter: { category: { $eq: 'obsolete' } } });
-```
-
-### Full-Text Search
-
-```typescript
-// Index documents
-await client.indexDocuments('my-namespace', [
-  { id: 'doc1', content: 'Machine learning is transforming industries' },
-  { id: 'doc2', content: 'Vector databases enable semantic search' },
-]);
-
-// Search
-const results = await client.fulltextSearch('my-namespace', 'machine learning', {
-  topK: 10,
+// Store a vector
+await client.vectors.upsert({
+  id: 'vec-001',
+  values: [0.1, 0.2, 0.3],
+  metadata: { text: 'agent completed task', agentId: 'my-agent' },
 });
 
-for (const result of results) {
-  console.log(`${result.id}: ${result.score}`);
-}
-```
-
-### Hybrid Search
+// Full-text search
+const results = await client.fulltext.search({ query: 'completed task', topK: 5 });
+results.forEach(r => console.log(r.id, r.score));
 
-```typescript
-// Combine vector and text search
-const results = await client.hybridSearch(
-  'my-namespace',
-  [0.1, 0.2, 0.3], // Query vector
-  'machine learning', // Text query
-  {
-    topK: 10,
-    alpha: 0.7, // 0 = pure vector, 1 = pure text
-  }
-);
-
-for (const result of results) {
-  console.log(`${result.id}: score=${result.score}, vector=${result.vectorScore}, text=${result.textScore}`);
-}
-```
-
-### Namespace Management
-
-```typescript
-// Create namespace
-await client.createNamespace('embeddings', {
-  dimensions: 384,
-  indexType: 'hnsw',
+// Store an agent memory
+await client.memories.store({
+  agentId: 'my-agent',
+  content: 'User prefers concise responses',
+  importance: 0.8,
+  tags: ['preference', 'ux'],
 });
-
-// List namespaces
-const namespaces = await client.listNamespaces();
-for (const ns of namespaces) {
-  console.log(`${ns.name}: ${ns.vectorCount} vectors`);
-}
-
-// Get namespace info
-const info = await client.getNamespace('embeddings');
-console.log(`Dimensions: ${info.dimensions}, Index: ${info.indexType}`);
-
-// Delete namespace
-await client.deleteNamespace('old-namespace');
 ```
 
-### Metadata Filtering
-
-Dakera supports rich metadata filtering:
+## Connect to Dakera
 
 ```typescript
-// Equality
-const filter1 = { status: { $eq: 'active' } };
-
-// Comparison
-const filter2 = { price: { $gt: 100, $lt: 500 } };
-
-// In list
-const filter3 = { category: { $in: ['electronics', 'books'] } };
-
-// Logical operators
-const filter4 = {
-  $and: [
-    { status: { $eq: 'active' } },
-    { price: { $lt: 1000 } },
-  ],
-};
-
-const results = await client.query('products', queryVector, {
-  filter: filter4,
-  topK: 20,
-});
-```
-
-### Error Handling
-
-```typescript
-import {
-  DakeraClient,
-  NotFoundError,
-  ValidationError,
-  RateLimitError,
-  ServerError,
-} from 'dakera';
-
-const client = new DakeraClient('http://localhost:3000');
-
-try {
-  const results = await client.query('nonexistent', [0.1, 0.2]);
-} catch (error) {
-  if (error instanceof NotFoundError) {
-    console.log(`Namespace not found: ${error.message}`);
-  } else if (error instanceof ValidationError) {
-    console.log(`Invalid request: ${error.message}`);
-  } else if (error instanceof RateLimitError) {
-    console.log(`Rate limited, retry after ${error.retryAfter} seconds`);
-  } else if (error instanceof ServerError) {
-    console.log(`Server error: ${error.message}`);
-  }
-}
-```
-
-## Configuration
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `baseUrl` | string | required | Dakera server URL |
-| `apiKey` | string | undefined | API key for authentication |
-| `timeout` | number | 30000 | Request timeout in milliseconds |
-| `maxRetries` | number | 3 | Max retries for failed requests |
-| `headers` | object | undefined | Additional HTTP headers |
-
-## API Reference
-
-### DakeraClient
-
-#### Vector Operations
-- `upsert(namespace, vectors)` - Insert or update vectors
-- `query(namespace, vector, options?)` - Query similar vectors
-- `delete(namespace, options)` - Delete vectors
-- `fetch(namespace, ids, options?)` - Fetch vectors by ID
-- `batchQuery(namespace, queries)` - Execute multiple queries
-
-#### Full-Text Operations
-- `indexDocuments(namespace, documents)` - Index documents
-- `fulltextSearch(namespace, query, options?)` - Text search
-- `hybridSearch(namespace, vector, query, options?)` - Hybrid search
-
-#### Namespace Operations
-- `listNamespaces()` - List all namespaces
-- `getNamespace(namespace)` - Get namespace info
-- `createNamespace(namespace, options?)` - Create namespace
-- `deleteNamespace(namespace)` - Delete namespace
-
-#### Admin Operations
-- `health()` - Check server health
-- `getIndexStats(namespace)` - Get index statistics
-- `compact(namespace)` - Trigger compaction
-- `flush(namespace)` - Flush pending writes
-
-## TypeScript Types
-
-All types are exported for use in your application:
-
-```typescript
-import type {
-  Vector,
-  VectorInput,
-  QueryResult,
-  SearchResult,
-  NamespaceInfo,
-  IndexStats,
-  Document,
-  FilterExpression,
-  QueryOptions,
-  ClientOptions,
-} 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');
+import { DakeraClient } from 'dakera';
 
-// TypeScript catches cross-assignment mistakes:
-//   const bad: VectorId = agentId('x');  // TS error ✓
+// Self-hosted
+const client = new DakeraClient({ baseUrl: 'http://your-server:3300', apiKey: 'your-key' });
 
-// 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] },
-]);
+// Cloud (early access)
+const client = new DakeraClient({ baseUrl: 'https://api.dakera.ai', apiKey: 'your-key' });
 ```
 
-## Browser Support
-
-This SDK uses the Fetch API and works in:
-- Node.js 18+
-- Modern browsers (Chrome, Firefox, Safari, Edge)
-- Deno
-- Bun
-
-## Development
-
-```bash
-# Install dependencies
-npm install
+## Documentation
 
-# Build
-npm run build
-
-# Run tests
-npm test
-
-# Type check
-npm run typecheck
-
-# Lint
-npm run lint
-```
+→ [Full docs](https://dakera.ai/docs)  
+→ [API reference](https://dakera.ai/docs/api)  
+→ [TypeScript SDK reference](https://dakera.ai/docs/sdk/typescript)
 
-## Related Repositories
+## Related
 
-| Repository | Description |
-|------------|-------------|
-| [dakera](https://github.com/dakera-ai/dakera) | Core AI agent memory engine (Rust) |
+| Repo | What it is |
+|---|---|
 | [dakera-py](https://github.com/dakera-ai/dakera-py) | Python SDK |
 | [dakera-go](https://github.com/dakera-ai/dakera-go) | Go SDK |
-| [dakera-rs](https://github.com/dakera-ai/dakera-rs) | Rust SDK |
-| [dakera-cli](https://github.com/dakera-ai/dakera-cli) | Command-line interface |
-| [dakera-mcp](https://github.com/dakera-ai/dakera-mcp) | MCP Server for AI agent memory |
-| [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-rs](https://github.com/dakera-ai/dakera-rs) | Rust client |
+| [dakera-cli](https://github.com/dakera-ai/dakera-cli) | CLI |
+| [dakera-mcp](https://github.com/dakera-ai/dakera-mcp) | MCP server · 83 tools |
+| [dakera-deploy](https://github.com/dakera-ai/dakera-deploy) | Self-host Dakera |
 
-## License
+---
 
-MIT License - see [LICENSE](LICENSE) for details.
+*Part of the Dakera AI open core. The engine is proprietary. The tools are yours.*

package/dist/index.d.mts

@@ -617,6 +617,30 @@ interface AgentStats {
     /** Newest memory timestamp */
     newest_memory_at?: string;
 }
+/** Options for `getWakeUpContext` (DAK-1690) */
+interface WakeUpOptions {
+    /** Maximum number of memories to return (default 20, max 100) */
+    top_n?: number;
+    /** Only return memories with importance ≥ this value (default 0.0) */
+    min_importance?: number;
+}
+/**
+ * Response from `GET /v1/agents/{agent_id}/wake-up` (DAK-1690).
+ *
+ * Returns top-N memories ranked by `importance × exp(-ln2 × age / 14d)` for
+ * fast agent start-up context loading. No embedding inference — served from
+ * the metadata index for sub-millisecond latency.
+ *
+ * Requires Read scope on the agent namespace.
+ */
+interface WakeUpResponse {
+    /** The agent whose memories are returned */
+    agent_id: AgentId;
+    /** Top-N memories ranked by recency-weighted importance */
+    memories: Memory[];
+    /** Total memories available before top_n cap was applied */
+    total_available: number;
+}
 /** Request to build a knowledge graph */
 interface KnowledgeGraphRequest {
     agent_id: AgentId;
@@ -2480,6 +2504,19 @@ declare class DakeraClient {
         active_only?: boolean;
         limit?: number;
     }): Promise<Session[]>;
+    /**
+     * Return top-N wake-up context memories for an agent (DAK-1690).
+     *
+     * Calls `GET /v1/agents/{agentId}/wake-up`. Returns memories ranked by
+     * `importance × exp(-ln2 × age / 14d)` — no embedding inference, served
+     * from the metadata index for sub-millisecond latency.
+     *
+     * Requires Read scope on the agent namespace.
+     *
+     * @param agentId - Agent identifier.
+     * @param options - Optional `top_n` (default 20, max 100) and `min_importance` (default 0.0).
+     */
+    getWakeUpContext(agentId: string, options?: WakeUpOptions): Promise<WakeUpResponse>;
     /** Build a knowledge graph from a seed memory */
     knowledgeGraph(request: KnowledgeGraphRequest): Promise<KnowledgeGraphResponse>;
     /** Build a full knowledge graph for an agent */
@@ -2993,4 +3030,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DecayStrategyName, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryPolicy, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecallResponse, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DecayStrategyName, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryPolicy, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecallResponse, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, 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 WakeUpOptions, type WakeUpResponse, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.d.ts

@@ -617,6 +617,30 @@ interface AgentStats {
     /** Newest memory timestamp */
     newest_memory_at?: string;
 }
+/** Options for `getWakeUpContext` (DAK-1690) */
+interface WakeUpOptions {
+    /** Maximum number of memories to return (default 20, max 100) */
+    top_n?: number;
+    /** Only return memories with importance ≥ this value (default 0.0) */
+    min_importance?: number;
+}
+/**
+ * Response from `GET /v1/agents/{agent_id}/wake-up` (DAK-1690).
+ *
+ * Returns top-N memories ranked by `importance × exp(-ln2 × age / 14d)` for
+ * fast agent start-up context loading. No embedding inference — served from
+ * the metadata index for sub-millisecond latency.
+ *
+ * Requires Read scope on the agent namespace.
+ */
+interface WakeUpResponse {
+    /** The agent whose memories are returned */
+    agent_id: AgentId;
+    /** Top-N memories ranked by recency-weighted importance */
+    memories: Memory[];
+    /** Total memories available before top_n cap was applied */
+    total_available: number;
+}
 /** Request to build a knowledge graph */
 interface KnowledgeGraphRequest {
     agent_id: AgentId;
@@ -2480,6 +2504,19 @@ declare class DakeraClient {
         active_only?: boolean;
         limit?: number;
     }): Promise<Session[]>;
+    /**
+     * Return top-N wake-up context memories for an agent (DAK-1690).
+     *
+     * Calls `GET /v1/agents/{agentId}/wake-up`. Returns memories ranked by
+     * `importance × exp(-ln2 × age / 14d)` — no embedding inference, served
+     * from the metadata index for sub-millisecond latency.
+     *
+     * Requires Read scope on the agent namespace.
+     *
+     * @param agentId - Agent identifier.
+     * @param options - Optional `top_n` (default 20, max 100) and `min_importance` (default 0.0).
+     */
+    getWakeUpContext(agentId: string, options?: WakeUpOptions): Promise<WakeUpResponse>;
     /** Build a knowledge graph from a seed memory */
     knowledgeGraph(request: KnowledgeGraphRequest): Promise<KnowledgeGraphResponse>;
     /** Build a full knowledge graph for an agent */
@@ -2993,4 +3030,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DecayStrategyName, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryPolicy, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecallResponse, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentFeedbackSummary, 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, type AuditEvent, type AuditExportResponse, type AuditListResponse, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CreateKeyRequest, type CreateNamespaceKeyResponse, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DecayStrategyName, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EdgeType, type EmbeddingModel, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryExportResponse, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportResponse, type MemoryImportancePatchRequest, type MemoryPolicy, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecallResponse, type RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, 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 WakeUpOptions, type WakeUpResponse, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.js

@@ -1381,6 +1381,25 @@ var DakeraClient = class {
     const qs = params.toString();
     return this.request("GET", `/v1/agents/${agentId2}/sessions${qs ? `?${qs}` : ""}`);
   }
+  /**
+   * Return top-N wake-up context memories for an agent (DAK-1690).
+   *
+   * Calls `GET /v1/agents/{agentId}/wake-up`. Returns memories ranked by
+   * `importance × exp(-ln2 × age / 14d)` — no embedding inference, served
+   * from the metadata index for sub-millisecond latency.
+   *
+   * Requires Read scope on the agent namespace.
+   *
+   * @param agentId - Agent identifier.
+   * @param options - Optional `top_n` (default 20, max 100) and `min_importance` (default 0.0).
+   */
+  async getWakeUpContext(agentId2, options) {
+    const params = new URLSearchParams();
+    if (options?.top_n !== void 0) params.set("top_n", String(options.top_n));
+    if (options?.min_importance !== void 0) params.set("min_importance", String(options.min_importance));
+    const qs = params.toString();
+    return this.request("GET", `/v1/agents/${agentId2}/wake-up${qs ? `?${qs}` : ""}`);
+  }
   // ===========================================================================
   // Knowledge Graph Operations
   // ===========================================================================

package/dist/index.mjs

@@ -1341,6 +1341,25 @@ var DakeraClient = class {
     const qs = params.toString();
     return this.request("GET", `/v1/agents/${agentId2}/sessions${qs ? `?${qs}` : ""}`);
   }
+  /**
+   * Return top-N wake-up context memories for an agent (DAK-1690).
+   *
+   * Calls `GET /v1/agents/{agentId}/wake-up`. Returns memories ranked by
+   * `importance × exp(-ln2 × age / 14d)` — no embedding inference, served
+   * from the metadata index for sub-millisecond latency.
+   *
+   * Requires Read scope on the agent namespace.
+   *
+   * @param agentId - Agent identifier.
+   * @param options - Optional `top_n` (default 20, max 100) and `min_importance` (default 0.0).
+   */
+  async getWakeUpContext(agentId2, options) {
+    const params = new URLSearchParams();
+    if (options?.top_n !== void 0) params.set("top_n", String(options.top_n));
+    if (options?.min_importance !== void 0) params.set("min_importance", String(options.min_importance));
+    const qs = params.toString();
+    return this.request("GET", `/v1/agents/${agentId2}/wake-up${qs ? `?${qs}` : ""}`);
+  }
   // ===========================================================================
   // Knowledge Graph Operations
   // ===========================================================================

package/package.json

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