@dakera-ai/dakera 0.7.2 → 0.7.3

package/dist/index.d.mts

@@ -402,8 +402,14 @@ interface StoreMemoryRequest {
     importance?: number;
     /** Optional metadata */
     metadata?: Record<string, unknown>;
-    /** TTL in seconds */
+    /** TTL in seconds — memory is hard-deleted after this many seconds from creation */
     ttl_seconds?: number;
+    /**
+     * Explicit expiry as a Unix timestamp (seconds).
+     * Takes precedence over `ttl_seconds` when both are provided.
+     * The memory is hard-deleted by the decay engine on expiry (DECAY-3).
+     */
+    expires_at?: number;
     /** Associated session ID */
     session_id?: string;
     /** Pre-computed embedding */
@@ -1106,6 +1112,50 @@ interface AutoPilotTriggerResponse {
     consolidation?: AutoPilotConsolidationResult;
     message: string;
 }
+/** Response from GET /v1/admin/decay/config (DECAY-1) */
+interface DecayConfigResponse {
+    /** Decay strategy: "exponential", "linear", or "step" */
+    strategy: 'exponential' | 'linear' | 'step';
+    /** Half-life in hours */
+    half_life_hours: number;
+    /** Minimum importance threshold; memories below are hard-deleted on next cycle */
+    min_importance: number;
+}
+/** Request for PUT /v1/admin/decay/config (DECAY-1) */
+interface DecayConfigUpdateRequest {
+    /** Decay strategy: "exponential", "linear", or "step" */
+    strategy?: 'exponential' | 'linear' | 'step';
+    /** Half-life in hours (must be > 0) */
+    half_life_hours?: number;
+    /** Minimum importance threshold 0.0–1.0 */
+    min_importance?: number;
+}
+/** Response from PUT /v1/admin/decay/config (DECAY-1) */
+interface DecayConfigUpdateResponse {
+    success: boolean;
+    config: DecayConfigResponse;
+    message: string;
+}
+/** Stats from a single decay cycle */
+interface LastDecayCycleStats {
+    namespaces_processed: number;
+    memories_processed: number;
+    memories_decayed: number;
+    memories_deleted: number;
+}
+/** Response from GET /v1/admin/decay/stats (DECAY-2) */
+interface DecayStatsResponse {
+    /** Total memories whose importance was lowered by decay (all-time) */
+    total_decayed: number;
+    /** Total memories hard-deleted by decay or TTL expiry (all-time) */
+    total_deleted: number;
+    /** Unix timestamp of the last decay cycle (undefined if never run) */
+    last_run_at?: number;
+    /** Number of decay cycles completed since startup */
+    cycles_run: number;
+    /** Stats from the most recent decay cycle (undefined if never run) */
+    last_cycle?: LastDecayCycleStats;
+}
 /** API key */
 interface ApiKey {
     id: string;
@@ -1876,6 +1926,16 @@ declare class DakeraClient {
     autopilotUpdateConfig(request: AutoPilotConfigRequest): Promise<AutoPilotConfigResponse>;
     /** Manually trigger an AutoPilot dedup or consolidation cycle (PILOT-3) */
     autopilotTrigger(action: AutoPilotTriggerAction): Promise<AutoPilotTriggerResponse>;
+    /** Get current decay engine configuration (DECAY-1). Requires Admin scope. */
+    decayConfig(): Promise<DecayConfigResponse>;
+    /**
+     * Update decay engine configuration at runtime (DECAY-1). Requires Admin scope.
+     * Changes take effect on the next decay cycle — no restart required.
+     * All fields are optional; omit any to keep its current value.
+     */
+    decayUpdateConfig(request: DecayConfigUpdateRequest): Promise<DecayConfigUpdateResponse>;
+    /** Get decay activity counters and last-cycle snapshot (DECAY-2). Requires Admin scope. */
+    decayStats(): Promise<DecayStatsResponse>;
     /** Create a new API key */
     createKey(request: CreateKeyRequest): Promise<ApiKey>;
     /** List all API keys */
@@ -2034,4 +2094,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.d.ts

@@ -402,8 +402,14 @@ interface StoreMemoryRequest {
     importance?: number;
     /** Optional metadata */
     metadata?: Record<string, unknown>;
-    /** TTL in seconds */
+    /** TTL in seconds — memory is hard-deleted after this many seconds from creation */
     ttl_seconds?: number;
+    /**
+     * Explicit expiry as a Unix timestamp (seconds).
+     * Takes precedence over `ttl_seconds` when both are provided.
+     * The memory is hard-deleted by the decay engine on expiry (DECAY-3).
+     */
+    expires_at?: number;
     /** Associated session ID */
     session_id?: string;
     /** Pre-computed embedding */
@@ -1106,6 +1112,50 @@ interface AutoPilotTriggerResponse {
     consolidation?: AutoPilotConsolidationResult;
     message: string;
 }
+/** Response from GET /v1/admin/decay/config (DECAY-1) */
+interface DecayConfigResponse {
+    /** Decay strategy: "exponential", "linear", or "step" */
+    strategy: 'exponential' | 'linear' | 'step';
+    /** Half-life in hours */
+    half_life_hours: number;
+    /** Minimum importance threshold; memories below are hard-deleted on next cycle */
+    min_importance: number;
+}
+/** Request for PUT /v1/admin/decay/config (DECAY-1) */
+interface DecayConfigUpdateRequest {
+    /** Decay strategy: "exponential", "linear", or "step" */
+    strategy?: 'exponential' | 'linear' | 'step';
+    /** Half-life in hours (must be > 0) */
+    half_life_hours?: number;
+    /** Minimum importance threshold 0.0–1.0 */
+    min_importance?: number;
+}
+/** Response from PUT /v1/admin/decay/config (DECAY-1) */
+interface DecayConfigUpdateResponse {
+    success: boolean;
+    config: DecayConfigResponse;
+    message: string;
+}
+/** Stats from a single decay cycle */
+interface LastDecayCycleStats {
+    namespaces_processed: number;
+    memories_processed: number;
+    memories_decayed: number;
+    memories_deleted: number;
+}
+/** Response from GET /v1/admin/decay/stats (DECAY-2) */
+interface DecayStatsResponse {
+    /** Total memories whose importance was lowered by decay (all-time) */
+    total_decayed: number;
+    /** Total memories hard-deleted by decay or TTL expiry (all-time) */
+    total_deleted: number;
+    /** Unix timestamp of the last decay cycle (undefined if never run) */
+    last_run_at?: number;
+    /** Number of decay cycles completed since startup */
+    cycles_run: number;
+    /** Stats from the most recent decay cycle (undefined if never run) */
+    last_cycle?: LastDecayCycleStats;
+}
 /** API key */
 interface ApiKey {
     id: string;
@@ -1876,6 +1926,16 @@ declare class DakeraClient {
     autopilotUpdateConfig(request: AutoPilotConfigRequest): Promise<AutoPilotConfigResponse>;
     /** Manually trigger an AutoPilot dedup or consolidation cycle (PILOT-3) */
     autopilotTrigger(action: AutoPilotTriggerAction): Promise<AutoPilotTriggerResponse>;
+    /** Get current decay engine configuration (DECAY-1). Requires Admin scope. */
+    decayConfig(): Promise<DecayConfigResponse>;
+    /**
+     * Update decay engine configuration at runtime (DECAY-1). Requires Admin scope.
+     * Changes take effect on the next decay cycle — no restart required.
+     * All fields are optional; omit any to keep its current value.
+     */
+    decayUpdateConfig(request: DecayConfigUpdateRequest): Promise<DecayConfigUpdateResponse>;
+    /** Get decay activity counters and last-cycle snapshot (DECAY-2). Requires Admin scope. */
+    decayStats(): Promise<DecayStatsResponse>;
     /** Create a new API key */
     createKey(request: CreateKeyRequest): Promise<ApiKey>;
     /** List all API keys */
@@ -2034,4 +2094,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type AutoPilotConfig, type AutoPilotConfigRequest, type AutoPilotConfigResponse, type AutoPilotConsolidationResult, type AutoPilotDedupResult, type AutoPilotStatusResponse, type AutoPilotTriggerAction, type AutoPilotTriggerResponse, type BackupInfo, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationResultSnapshot, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DecayConfigResponse, type DecayConfigUpdateRequest, type DecayConfigUpdateResponse, type DecayStatsResponse, type DedupResultSnapshot, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type RateLimitHeaders, type ReadConsistency, type RecallRequest, type RecalledMemory, type RetryConfig, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.js

@@ -1345,6 +1345,22 @@ var DakeraClient = class {
   async autopilotTrigger(action) {
     return this.request("POST", "/v1/admin/autopilot/trigger", { action });
   }
+  /** Get current decay engine configuration (DECAY-1). Requires Admin scope. */
+  async decayConfig() {
+    return this.request("GET", "/v1/admin/decay/config");
+  }
+  /**
+   * Update decay engine configuration at runtime (DECAY-1). Requires Admin scope.
+   * Changes take effect on the next decay cycle — no restart required.
+   * All fields are optional; omit any to keep its current value.
+   */
+  async decayUpdateConfig(request) {
+    return this.request("PUT", "/v1/admin/decay/config", request);
+  }
+  /** Get decay activity counters and last-cycle snapshot (DECAY-2). Requires Admin scope. */
+  async decayStats() {
+    return this.request("GET", "/v1/admin/decay/stats");
+  }
   // ===========================================================================
   // API Key Operations
   // ===========================================================================

package/dist/index.mjs

@@ -1305,6 +1305,22 @@ var DakeraClient = class {
   async autopilotTrigger(action) {
     return this.request("POST", "/v1/admin/autopilot/trigger", { action });
   }
+  /** Get current decay engine configuration (DECAY-1). Requires Admin scope. */
+  async decayConfig() {
+    return this.request("GET", "/v1/admin/decay/config");
+  }
+  /**
+   * Update decay engine configuration at runtime (DECAY-1). Requires Admin scope.
+   * Changes take effect on the next decay cycle — no restart required.
+   * All fields are optional; omit any to keep its current value.
+   */
+  async decayUpdateConfig(request) {
+    return this.request("PUT", "/v1/admin/decay/config", request);
+  }
+  /** Get decay activity counters and last-cycle snapshot (DECAY-2). Requires Admin scope. */
+  async decayStats() {
+    return this.request("GET", "/v1/admin/decay/stats");
+  }
   // ===========================================================================
   // API Key Operations
   // ===========================================================================

package/package.json

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