@dakera-ai/dakera 0.9.7 → 0.9.8

package/dist/index.d.mts

@@ -454,6 +454,13 @@ interface RecalledMemory {
     /** Creation timestamp */
     created_at?: string;
 }
+/** COG-2: Response from the recall endpoint with optional associative memories */
+interface RecallResponse {
+    /** Primary recalled memories */
+    memories: RecalledMemory[];
+    /** COG-2: KG depth-1 associated memories (only present when include_associated was true) */
+    associated_memories?: RecalledMemory[];
+}
 /** Response from storing a memory */
 interface StoreMemoryResponse {
     /** Created memory ID */
@@ -1619,6 +1626,48 @@ interface ExtractEntitiesResponse {
     /** Wall-clock time taken by the ODE sidecar in milliseconds. */
     processing_time_ms: number;
 }
+/**
+ * Decay strategy name.  The COG-1 variants (power_law, logarithmic, flat) are
+ * only valid inside MemoryPolicy per-type fields; the global DecayConfig
+ * endpoint still accepts only "exponential" | "linear" | "step".
+ */
+type DecayStrategyName = 'exponential' | 'linear' | 'step' | 'power_law' | 'logarithmic' | 'flat';
+/**
+ * Per-namespace memory lifecycle policy (COG-1).
+ *
+ * Controls type-specific TTLs, decay curves, and spaced repetition behaviour.
+ * All fields are optional and have sensible server-side defaults; only set the
+ * ones you want to override.
+ *
+ * Used by {@link DakeraClient.getMemoryPolicy} and
+ * {@link DakeraClient.setMemoryPolicy}.
+ */
+interface MemoryPolicy {
+    /** Default TTL for `working` memories in seconds (default: 14 400 = 4 h). */
+    working_ttl_seconds?: number;
+    /** Default TTL for `episodic` memories in seconds (default: 2 592 000 = 30 d). */
+    episodic_ttl_seconds?: number;
+    /** Default TTL for `semantic` memories in seconds (default: 31 536 000 = 365 d). */
+    semantic_ttl_seconds?: number;
+    /** Default TTL for `procedural` memories in seconds (default: 63 072 000 = 730 d). */
+    procedural_ttl_seconds?: number;
+    /** Decay strategy for `working` memories (default: `"exponential"`). */
+    working_decay?: DecayStrategyName;
+    /** Decay strategy for `episodic` memories (default: `"power_law"`). */
+    episodic_decay?: DecayStrategyName;
+    /** Decay strategy for `semantic` memories (default: `"logarithmic"`). */
+    semantic_decay?: DecayStrategyName;
+    /** Decay strategy for `procedural` memories (default: `"flat"` — no decay). */
+    procedural_decay?: DecayStrategyName;
+    /**
+     * Multiplier for the TTL extension on each recall hit.
+     * Extension = `access_count × sr_factor × sr_base_interval_seconds`.
+     * Set to 0 to disable. Default: 1.0.
+     */
+    spaced_repetition_factor?: number;
+    /** Base interval in seconds for spaced repetition (default: 86 400 = 1 d). */
+    spaced_repetition_base_interval_seconds?: number;
+}
 
 /**
  * Dakera Client
@@ -2137,12 +2186,27 @@ declare class DakeraClient {
     batchQueryText(namespace: string, queries: string[], options?: BatchTextQueryOptions): Promise<BatchTextQueryResponse>;
     /** Store a memory for an agent */
     storeMemory(agentId: string, request: StoreMemoryRequest): Promise<StoreMemoryResponse>;
-    /** Recall memories for an agent */
+    /**
+     * Recall memories for an agent.
+     *
+     * @param agentId - Agent identifier
+     * @param query - Semantic query text
+     * @param options - Optional recall parameters
+     * @param options.top_k - Number of primary results (default: 5)
+     * @param options.memory_type - Filter by memory type
+     * @param options.min_importance - Minimum importance threshold
+     * @param options.include_associated - COG-2: traverse KG depth-1 and include
+     *   associatively linked memories in `associated_memories` (default: false)
+     * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
+     * @returns RecallResponse with `memories` and optionally `associated_memories`
+     */
     recall(agentId: string, query: string, options?: {
         top_k?: number;
         memory_type?: string;
         min_importance?: number;
-    }): Promise<RecalledMemory[]>;
+        include_associated?: boolean;
+        associated_memories_cap?: number;
+    }): Promise<RecallResponse>;
     /** Get a specific memory */
     getMemory(agentId: string, memoryId: string): Promise<Memory>;
     /** Update an existing memory */
@@ -2749,6 +2813,32 @@ declare class DakeraClient {
      * @throws {Error} If `odeUrl` is not configured.
      */
     odeExtractEntities(content: string, agentId: string, memoryId?: string, entityTypes?: string[]): Promise<ExtractEntitiesResponse>;
+    /**
+     * Return the memory lifecycle policy for a namespace (COG-1).
+     *
+     * `GET /v1/namespaces/{namespace}/memory_policy`
+     *
+     * When no explicit policy has been configured the server returns COG-1
+     * defaults: working=4 h, episodic=30 d, semantic=365 d, procedural=730 d;
+     * exponential / power_law / logarithmic / flat decay; SR factor 1.0.
+     *
+     * @param namespace  Namespace to inspect.
+     */
+    getMemoryPolicy(namespace: string): Promise<MemoryPolicy>;
+    /**
+     * Set the memory lifecycle policy for a namespace (COG-1).
+     *
+     * `PUT /v1/namespaces/{namespace}/memory_policy`
+     *
+     * The policy is persisted in namespace config and applied immediately to
+     * the decay engine background task.  Only populate the fields you want to
+     * override — all fields have safe server-side defaults.
+     *
+     * @param namespace  Namespace to configure.
+     * @param policy     {@link MemoryPolicy} with the desired settings.
+     * @returns          The updated policy as confirmed by the server.
+     */
+    setMemoryPolicy(namespace: string, policy: MemoryPolicy): Promise<MemoryPolicy>;
 }
 
 /**
@@ -2813,4 +2903,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 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 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 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 RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type 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 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 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

@@ -454,6 +454,13 @@ interface RecalledMemory {
     /** Creation timestamp */
     created_at?: string;
 }
+/** COG-2: Response from the recall endpoint with optional associative memories */
+interface RecallResponse {
+    /** Primary recalled memories */
+    memories: RecalledMemory[];
+    /** COG-2: KG depth-1 associated memories (only present when include_associated was true) */
+    associated_memories?: RecalledMemory[];
+}
 /** Response from storing a memory */
 interface StoreMemoryResponse {
     /** Created memory ID */
@@ -1619,6 +1626,48 @@ interface ExtractEntitiesResponse {
     /** Wall-clock time taken by the ODE sidecar in milliseconds. */
     processing_time_ms: number;
 }
+/**
+ * Decay strategy name.  The COG-1 variants (power_law, logarithmic, flat) are
+ * only valid inside MemoryPolicy per-type fields; the global DecayConfig
+ * endpoint still accepts only "exponential" | "linear" | "step".
+ */
+type DecayStrategyName = 'exponential' | 'linear' | 'step' | 'power_law' | 'logarithmic' | 'flat';
+/**
+ * Per-namespace memory lifecycle policy (COG-1).
+ *
+ * Controls type-specific TTLs, decay curves, and spaced repetition behaviour.
+ * All fields are optional and have sensible server-side defaults; only set the
+ * ones you want to override.
+ *
+ * Used by {@link DakeraClient.getMemoryPolicy} and
+ * {@link DakeraClient.setMemoryPolicy}.
+ */
+interface MemoryPolicy {
+    /** Default TTL for `working` memories in seconds (default: 14 400 = 4 h). */
+    working_ttl_seconds?: number;
+    /** Default TTL for `episodic` memories in seconds (default: 2 592 000 = 30 d). */
+    episodic_ttl_seconds?: number;
+    /** Default TTL for `semantic` memories in seconds (default: 31 536 000 = 365 d). */
+    semantic_ttl_seconds?: number;
+    /** Default TTL for `procedural` memories in seconds (default: 63 072 000 = 730 d). */
+    procedural_ttl_seconds?: number;
+    /** Decay strategy for `working` memories (default: `"exponential"`). */
+    working_decay?: DecayStrategyName;
+    /** Decay strategy for `episodic` memories (default: `"power_law"`). */
+    episodic_decay?: DecayStrategyName;
+    /** Decay strategy for `semantic` memories (default: `"logarithmic"`). */
+    semantic_decay?: DecayStrategyName;
+    /** Decay strategy for `procedural` memories (default: `"flat"` — no decay). */
+    procedural_decay?: DecayStrategyName;
+    /**
+     * Multiplier for the TTL extension on each recall hit.
+     * Extension = `access_count × sr_factor × sr_base_interval_seconds`.
+     * Set to 0 to disable. Default: 1.0.
+     */
+    spaced_repetition_factor?: number;
+    /** Base interval in seconds for spaced repetition (default: 86 400 = 1 d). */
+    spaced_repetition_base_interval_seconds?: number;
+}
 
 /**
  * Dakera Client
@@ -2137,12 +2186,27 @@ declare class DakeraClient {
     batchQueryText(namespace: string, queries: string[], options?: BatchTextQueryOptions): Promise<BatchTextQueryResponse>;
     /** Store a memory for an agent */
     storeMemory(agentId: string, request: StoreMemoryRequest): Promise<StoreMemoryResponse>;
-    /** Recall memories for an agent */
+    /**
+     * Recall memories for an agent.
+     *
+     * @param agentId - Agent identifier
+     * @param query - Semantic query text
+     * @param options - Optional recall parameters
+     * @param options.top_k - Number of primary results (default: 5)
+     * @param options.memory_type - Filter by memory type
+     * @param options.min_importance - Minimum importance threshold
+     * @param options.include_associated - COG-2: traverse KG depth-1 and include
+     *   associatively linked memories in `associated_memories` (default: false)
+     * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
+     * @returns RecallResponse with `memories` and optionally `associated_memories`
+     */
     recall(agentId: string, query: string, options?: {
         top_k?: number;
         memory_type?: string;
         min_importance?: number;
-    }): Promise<RecalledMemory[]>;
+        include_associated?: boolean;
+        associated_memories_cap?: number;
+    }): Promise<RecallResponse>;
     /** Get a specific memory */
     getMemory(agentId: string, memoryId: string): Promise<Memory>;
     /** Update an existing memory */
@@ -2749,6 +2813,32 @@ declare class DakeraClient {
      * @throws {Error} If `odeUrl` is not configured.
      */
     odeExtractEntities(content: string, agentId: string, memoryId?: string, entityTypes?: string[]): Promise<ExtractEntitiesResponse>;
+    /**
+     * Return the memory lifecycle policy for a namespace (COG-1).
+     *
+     * `GET /v1/namespaces/{namespace}/memory_policy`
+     *
+     * When no explicit policy has been configured the server returns COG-1
+     * defaults: working=4 h, episodic=30 d, semantic=365 d, procedural=730 d;
+     * exponential / power_law / logarithmic / flat decay; SR factor 1.0.
+     *
+     * @param namespace  Namespace to inspect.
+     */
+    getMemoryPolicy(namespace: string): Promise<MemoryPolicy>;
+    /**
+     * Set the memory lifecycle policy for a namespace (COG-1).
+     *
+     * `PUT /v1/namespaces/{namespace}/memory_policy`
+     *
+     * The policy is persisted in namespace config and applied immediately to
+     * the decay engine background task.  Only populate the fields you want to
+     * override — all fields have safe server-side defaults.
+     *
+     * @param namespace  Namespace to configure.
+     * @param policy     {@link MemoryPolicy} with the desired settings.
+     * @returns          The updated policy as confirmed by the server.
+     */
+    setMemoryPolicy(namespace: string, policy: MemoryPolicy): Promise<MemoryPolicy>;
 }
 
 /**
@@ -2813,4 +2903,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 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 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 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 RecalledMemory, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type 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 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 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

@@ -1066,11 +1066,28 @@ var DakeraClient = class {
   async storeMemory(agentId2, request) {
     return this.request("POST", `/v1/agents/${agentId2}/memories`, request);
   }
-  /** Recall memories for an agent */
+  /**
+   * Recall memories for an agent.
+   *
+   * @param agentId - Agent identifier
+   * @param query - Semantic query text
+   * @param options - Optional recall parameters
+   * @param options.top_k - Number of primary results (default: 5)
+   * @param options.memory_type - Filter by memory type
+   * @param options.min_importance - Minimum importance threshold
+   * @param options.include_associated - COG-2: traverse KG depth-1 and include
+   *   associatively linked memories in `associated_memories` (default: false)
+   * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
+   * @returns RecallResponse with `memories` and optionally `associated_memories`
+   */
   async recall(agentId2, query, options) {
-    const body = { query, ...options };
-    const result = await this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
-    return result.memories ?? result;
+    const body = { query };
+    if (options?.top_k !== void 0) body["top_k"] = options.top_k;
+    if (options?.memory_type !== void 0) body["memory_type"] = options.memory_type;
+    if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
+    if (options?.include_associated) body["include_associated"] = true;
+    if (options?.associated_memories_cap !== void 0) body["associated_memories_cap"] = options.associated_memories_cap;
+    return this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
   }
   /** Get a specific memory */
   async getMemory(agentId2, memoryId2) {
@@ -2112,6 +2129,46 @@ var DakeraClient = class {
       clearTimeout(timer);
     }
   }
+  // =========================================================================
+  // COG-1: Per-namespace Memory Lifecycle Policy
+  // =========================================================================
+  /**
+   * Return the memory lifecycle policy for a namespace (COG-1).
+   *
+   * `GET /v1/namespaces/{namespace}/memory_policy`
+   *
+   * When no explicit policy has been configured the server returns COG-1
+   * defaults: working=4 h, episodic=30 d, semantic=365 d, procedural=730 d;
+   * exponential / power_law / logarithmic / flat decay; SR factor 1.0.
+   *
+   * @param namespace  Namespace to inspect.
+   */
+  async getMemoryPolicy(namespace) {
+    return this.request(
+      "GET",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/memory_policy`
+    );
+  }
+  /**
+   * Set the memory lifecycle policy for a namespace (COG-1).
+   *
+   * `PUT /v1/namespaces/{namespace}/memory_policy`
+   *
+   * The policy is persisted in namespace config and applied immediately to
+   * the decay engine background task.  Only populate the fields you want to
+   * override — all fields have safe server-side defaults.
+   *
+   * @param namespace  Namespace to configure.
+   * @param policy     {@link MemoryPolicy} with the desired settings.
+   * @returns          The updated policy as confirmed by the server.
+   */
+  async setMemoryPolicy(namespace, policy) {
+    return this.request(
+      "PUT",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/memory_policy`,
+      policy
+    );
+  }
 };
 
 // src/types.ts

package/dist/index.mjs

@@ -1026,11 +1026,28 @@ var DakeraClient = class {
   async storeMemory(agentId2, request) {
     return this.request("POST", `/v1/agents/${agentId2}/memories`, request);
   }
-  /** Recall memories for an agent */
+  /**
+   * Recall memories for an agent.
+   *
+   * @param agentId - Agent identifier
+   * @param query - Semantic query text
+   * @param options - Optional recall parameters
+   * @param options.top_k - Number of primary results (default: 5)
+   * @param options.memory_type - Filter by memory type
+   * @param options.min_importance - Minimum importance threshold
+   * @param options.include_associated - COG-2: traverse KG depth-1 and include
+   *   associatively linked memories in `associated_memories` (default: false)
+   * @param options.associated_memories_cap - COG-2: max associated memories (default: 10, max: 10)
+   * @returns RecallResponse with `memories` and optionally `associated_memories`
+   */
   async recall(agentId2, query, options) {
-    const body = { query, ...options };
-    const result = await this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
-    return result.memories ?? result;
+    const body = { query };
+    if (options?.top_k !== void 0) body["top_k"] = options.top_k;
+    if (options?.memory_type !== void 0) body["memory_type"] = options.memory_type;
+    if (options?.min_importance !== void 0) body["min_importance"] = options.min_importance;
+    if (options?.include_associated) body["include_associated"] = true;
+    if (options?.associated_memories_cap !== void 0) body["associated_memories_cap"] = options.associated_memories_cap;
+    return this.request("POST", `/v1/agents/${agentId2}/memories/recall`, body);
   }
   /** Get a specific memory */
   async getMemory(agentId2, memoryId2) {
@@ -2072,6 +2089,46 @@ var DakeraClient = class {
       clearTimeout(timer);
     }
   }
+  // =========================================================================
+  // COG-1: Per-namespace Memory Lifecycle Policy
+  // =========================================================================
+  /**
+   * Return the memory lifecycle policy for a namespace (COG-1).
+   *
+   * `GET /v1/namespaces/{namespace}/memory_policy`
+   *
+   * When no explicit policy has been configured the server returns COG-1
+   * defaults: working=4 h, episodic=30 d, semantic=365 d, procedural=730 d;
+   * exponential / power_law / logarithmic / flat decay; SR factor 1.0.
+   *
+   * @param namespace  Namespace to inspect.
+   */
+  async getMemoryPolicy(namespace) {
+    return this.request(
+      "GET",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/memory_policy`
+    );
+  }
+  /**
+   * Set the memory lifecycle policy for a namespace (COG-1).
+   *
+   * `PUT /v1/namespaces/{namespace}/memory_policy`
+   *
+   * The policy is persisted in namespace config and applied immediately to
+   * the decay engine background task.  Only populate the fields you want to
+   * override — all fields have safe server-side defaults.
+   *
+   * @param namespace  Namespace to configure.
+   * @param policy     {@link MemoryPolicy} with the desired settings.
+   * @returns          The updated policy as confirmed by the server.
+   */
+  async setMemoryPolicy(namespace, policy) {
+    return this.request(
+      "PUT",
+      `/v1/namespaces/${encodeURIComponent(namespace)}/memory_policy`,
+      policy
+    );
+  }
 };
 
 // src/types.ts

package/package.json

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