@dakera-ai/dakera 0.9.0 → 0.9.3

package/dist/index.d.mts

@@ -1364,6 +1364,109 @@ interface MemoryEntitiesResponse {
     memory_id: string;
     entities: ExtractedEntity[];
 }
+/**
+ * Feedback signal for memory active learning (INT-1).
+ *
+ * - `upvote`: Boost importance ×1.15, capped at 1.0.
+ * - `downvote`: Penalise importance ×0.85, floor 0.0.
+ * - `flag`: Mark as irrelevant — sets `decay_flag=true`, no immediate importance change.
+ * - `positive`: Backward-compatible alias for `upvote`.
+ * - `negative`: Backward-compatible alias for `downvote`.
+ */
+type FeedbackSignal = 'upvote' | 'downvote' | 'flag' | 'positive' | 'negative';
+/** A single recorded feedback event stored in memory metadata (INT-1). */
+interface FeedbackHistoryEntry {
+    /** Feedback signal that was applied. */
+    signal: FeedbackSignal;
+    /** Unix timestamp (seconds) when feedback was submitted. */
+    timestamp: number;
+    /** Memory importance before this feedback was applied. */
+    old_importance: number;
+    /** Memory importance after this feedback was applied. */
+    new_importance: number;
+}
+/** Request body for POST /v1/memories/:id/feedback (INT-1). */
+interface MemoryFeedbackBodyRequest {
+    agent_id: string;
+    signal: FeedbackSignal;
+}
+/** Request body for PATCH /v1/memories/:id/importance (INT-1). */
+interface MemoryImportancePatchRequest {
+    agent_id: string;
+    importance: number;
+}
+/** Response from POST /v1/memories/:id/feedback and PATCH /v1/memories/:id/importance (INT-1). */
+interface FeedbackResponse {
+    /** ID of the memory that was updated. */
+    memory_id: string;
+    /** New importance score after the feedback was applied (0.0–1.0). */
+    new_importance: number;
+    /** The feedback signal that was recorded. */
+    signal: FeedbackSignal;
+}
+/** Response from GET /v1/memories/:id/feedback (INT-1). */
+interface FeedbackHistoryResponse {
+    memory_id: string;
+    /** Ordered list of feedback events (oldest first, capped at 100). */
+    entries: FeedbackHistoryEntry[];
+}
+/** Response from GET /v1/agents/:id/feedback/summary (INT-1). */
+interface AgentFeedbackSummary {
+    agent_id: string;
+    upvotes: number;
+    downvotes: number;
+    flags: number;
+    total_feedback: number;
+    /** Weighted-average importance across all non-expired memories (0.0–1.0). */
+    health_score: number;
+}
+/** Response from GET /v1/feedback/health (INT-1). */
+interface FeedbackHealthResponse {
+    agent_id: string;
+    /** Mean importance of all non-expired memories (0.0–1.0). Higher = healthier. */
+    health_score: number;
+    memory_count: number;
+    avg_importance: number;
+}
+/** Namespace-scoped API key metadata (no secret). Returned by listNamespaceKeys (SEC-1). */
+interface NamespaceKeyInfo {
+    key_id: string;
+    name: string;
+    namespace: string;
+    created_at: number;
+    active: boolean;
+    expires_at?: number;
+}
+/**
+ * Response from POST /v1/namespaces/:namespace/keys (SEC-1).
+ * The `key` field is shown **only once** — store it securely.
+ */
+interface CreateNamespaceKeyResponse {
+    key_id: string;
+    /** The raw API key. Shown only on creation — cannot be retrieved again. */
+    key: string;
+    name: string;
+    namespace: string;
+    created_at: number;
+    expires_at?: number;
+    warning: string;
+}
+/** Response from GET /v1/namespaces/:namespace/keys (SEC-1). */
+interface ListNamespaceKeysResponse {
+    namespace: string;
+    keys: NamespaceKeyInfo[];
+    total: number;
+}
+/** Response from GET /v1/namespaces/:namespace/keys/:key_id/usage (SEC-1). */
+interface NamespaceKeyUsageResponse {
+    key_id: string;
+    namespace: string;
+    total_requests: number;
+    successful_requests: number;
+    failed_requests: number;
+    bytes_transferred: number;
+    avg_latency_ms: number;
+}
 
 /**
  * Dakera Client
@@ -1940,6 +2043,47 @@ declare class DakeraClient {
     consolidate(agentId: string, request?: ConsolidateRequest): Promise<ConsolidateResponse>;
     /** Submit feedback on a memory recall */
     memoryFeedback(agentId: string, request: MemoryFeedbackRequest): Promise<MemoryFeedbackResponse>;
+    /**
+     * Submit upvote/downvote/flag feedback on a memory (INT-1).
+     *
+     * - `upvote`: boosts importance ×1.15 (capped at 1.0).
+     * - `downvote`: penalises importance ×0.85 (floor 0.0).
+     * - `flag`: marks as irrelevant — accelerates decay on next cycle.
+     *
+     * @param memoryId  The memory to give feedback on.
+     * @param agentId   The agent that owns the memory.
+     * @param signal    Feedback signal.
+     */
+    feedbackMemory(memoryId: string, agentId: string, signal: FeedbackSignal): Promise<FeedbackResponse>;
+    /**
+     * Get the full feedback history for a memory (INT-1).
+     *
+     * @param memoryId  The memory whose feedback history to retrieve.
+     */
+    getMemoryFeedbackHistory(memoryId: string): Promise<FeedbackHistoryResponse>;
+    /**
+     * Get aggregate feedback counts and health score for an agent (INT-1).
+     *
+     * @param agentId  The agent to summarise feedback for.
+     */
+    getAgentFeedbackSummary(agentId: string): Promise<AgentFeedbackSummary>;
+    /**
+     * Directly override a memory's importance score (INT-1).
+     *
+     * @param memoryId    The memory to update.
+     * @param agentId     The agent that owns the memory.
+     * @param importance  New importance value (0.0–1.0).
+     */
+    patchMemoryImportance(memoryId: string, agentId: string, importance: number): Promise<FeedbackResponse>;
+    /**
+     * Get overall feedback health score for an agent (INT-1).
+     *
+     * The health score is the mean importance of all non-expired memories (0.0–1.0).
+     * A higher score indicates a healthier, more relevant memory store.
+     *
+     * @param agentId  The agent to get health score for.
+     */
+    getFeedbackHealth(agentId: string): Promise<FeedbackHealthResponse>;
     /**
      * Traverse the knowledge graph from a memory node.
      *
@@ -2071,6 +2215,10 @@ declare class DakeraClient {
     /** Get server stats (version, total_vectors, namespace_count, uptime_seconds, timestamp).
      *  Requires Read scope — works with read-only API keys, unlike clusterStatus. */
     opsStats(): Promise<OpsStats>;
+    /** Get Prometheus metrics in text exposition format (INFRA-3).
+     *  Requires Admin scope. Returns the raw Prometheus text exposition
+     *  format string suitable for scraping by a Prometheus server. */
+    opsMetrics(): Promise<string>;
     /** Get cluster status */
     clusterStatus(): Promise<ClusterStatus>;
     /** Get cluster nodes */
@@ -2256,6 +2404,39 @@ declare class DakeraClient {
     private _streamSseMemory;
     /** Parse a single SSE event block into a {@link MemoryEvent}. */
     private _parseSseMemoryBlock;
+    /**
+     * Create a namespace-scoped API key (SEC-1).
+     *
+     * The `key` field in the response is shown **only once** — store it securely.
+     *
+     * @param namespace     The namespace to scope this key to.
+     * @param name          Human-readable label for the key.
+     * @param expiresInDays Optional expiry in days from now.
+     */
+    createNamespaceKey(namespace: string, name: string, expiresInDays?: number): Promise<CreateNamespaceKeyResponse>;
+    /**
+     * List all API keys scoped to a namespace (SEC-1).
+     *
+     * @param namespace  The namespace whose keys to list.
+     */
+    listNamespaceKeys(namespace: string): Promise<ListNamespaceKeysResponse>;
+    /**
+     * Revoke a namespace-scoped API key (SEC-1).
+     *
+     * @param namespace  The namespace the key belongs to.
+     * @param keyId      The key to revoke.
+     */
+    deleteNamespaceKey(namespace: string, keyId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Get usage statistics for a namespace-scoped API key (SEC-1).
+     *
+     * @param namespace  The namespace the key belongs to.
+     * @param keyId      The key whose usage to retrieve.
+     */
+    getNamespaceKeyUsage(namespace: string, keyId: string): Promise<NamespaceKeyUsageResponse>;
 }
 
 /**
@@ -2320,4 +2501,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 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 ExtractedEntity, 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 KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceNerConfig, NotFoundError, 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 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, 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 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 ExtractedEntity, 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 KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportancePatchRequest, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, 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 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

@@ -1364,6 +1364,109 @@ interface MemoryEntitiesResponse {
     memory_id: string;
     entities: ExtractedEntity[];
 }
+/**
+ * Feedback signal for memory active learning (INT-1).
+ *
+ * - `upvote`: Boost importance ×1.15, capped at 1.0.
+ * - `downvote`: Penalise importance ×0.85, floor 0.0.
+ * - `flag`: Mark as irrelevant — sets `decay_flag=true`, no immediate importance change.
+ * - `positive`: Backward-compatible alias for `upvote`.
+ * - `negative`: Backward-compatible alias for `downvote`.
+ */
+type FeedbackSignal = 'upvote' | 'downvote' | 'flag' | 'positive' | 'negative';
+/** A single recorded feedback event stored in memory metadata (INT-1). */
+interface FeedbackHistoryEntry {
+    /** Feedback signal that was applied. */
+    signal: FeedbackSignal;
+    /** Unix timestamp (seconds) when feedback was submitted. */
+    timestamp: number;
+    /** Memory importance before this feedback was applied. */
+    old_importance: number;
+    /** Memory importance after this feedback was applied. */
+    new_importance: number;
+}
+/** Request body for POST /v1/memories/:id/feedback (INT-1). */
+interface MemoryFeedbackBodyRequest {
+    agent_id: string;
+    signal: FeedbackSignal;
+}
+/** Request body for PATCH /v1/memories/:id/importance (INT-1). */
+interface MemoryImportancePatchRequest {
+    agent_id: string;
+    importance: number;
+}
+/** Response from POST /v1/memories/:id/feedback and PATCH /v1/memories/:id/importance (INT-1). */
+interface FeedbackResponse {
+    /** ID of the memory that was updated. */
+    memory_id: string;
+    /** New importance score after the feedback was applied (0.0–1.0). */
+    new_importance: number;
+    /** The feedback signal that was recorded. */
+    signal: FeedbackSignal;
+}
+/** Response from GET /v1/memories/:id/feedback (INT-1). */
+interface FeedbackHistoryResponse {
+    memory_id: string;
+    /** Ordered list of feedback events (oldest first, capped at 100). */
+    entries: FeedbackHistoryEntry[];
+}
+/** Response from GET /v1/agents/:id/feedback/summary (INT-1). */
+interface AgentFeedbackSummary {
+    agent_id: string;
+    upvotes: number;
+    downvotes: number;
+    flags: number;
+    total_feedback: number;
+    /** Weighted-average importance across all non-expired memories (0.0–1.0). */
+    health_score: number;
+}
+/** Response from GET /v1/feedback/health (INT-1). */
+interface FeedbackHealthResponse {
+    agent_id: string;
+    /** Mean importance of all non-expired memories (0.0–1.0). Higher = healthier. */
+    health_score: number;
+    memory_count: number;
+    avg_importance: number;
+}
+/** Namespace-scoped API key metadata (no secret). Returned by listNamespaceKeys (SEC-1). */
+interface NamespaceKeyInfo {
+    key_id: string;
+    name: string;
+    namespace: string;
+    created_at: number;
+    active: boolean;
+    expires_at?: number;
+}
+/**
+ * Response from POST /v1/namespaces/:namespace/keys (SEC-1).
+ * The `key` field is shown **only once** — store it securely.
+ */
+interface CreateNamespaceKeyResponse {
+    key_id: string;
+    /** The raw API key. Shown only on creation — cannot be retrieved again. */
+    key: string;
+    name: string;
+    namespace: string;
+    created_at: number;
+    expires_at?: number;
+    warning: string;
+}
+/** Response from GET /v1/namespaces/:namespace/keys (SEC-1). */
+interface ListNamespaceKeysResponse {
+    namespace: string;
+    keys: NamespaceKeyInfo[];
+    total: number;
+}
+/** Response from GET /v1/namespaces/:namespace/keys/:key_id/usage (SEC-1). */
+interface NamespaceKeyUsageResponse {
+    key_id: string;
+    namespace: string;
+    total_requests: number;
+    successful_requests: number;
+    failed_requests: number;
+    bytes_transferred: number;
+    avg_latency_ms: number;
+}
 
 /**
  * Dakera Client
@@ -1940,6 +2043,47 @@ declare class DakeraClient {
     consolidate(agentId: string, request?: ConsolidateRequest): Promise<ConsolidateResponse>;
     /** Submit feedback on a memory recall */
     memoryFeedback(agentId: string, request: MemoryFeedbackRequest): Promise<MemoryFeedbackResponse>;
+    /**
+     * Submit upvote/downvote/flag feedback on a memory (INT-1).
+     *
+     * - `upvote`: boosts importance ×1.15 (capped at 1.0).
+     * - `downvote`: penalises importance ×0.85 (floor 0.0).
+     * - `flag`: marks as irrelevant — accelerates decay on next cycle.
+     *
+     * @param memoryId  The memory to give feedback on.
+     * @param agentId   The agent that owns the memory.
+     * @param signal    Feedback signal.
+     */
+    feedbackMemory(memoryId: string, agentId: string, signal: FeedbackSignal): Promise<FeedbackResponse>;
+    /**
+     * Get the full feedback history for a memory (INT-1).
+     *
+     * @param memoryId  The memory whose feedback history to retrieve.
+     */
+    getMemoryFeedbackHistory(memoryId: string): Promise<FeedbackHistoryResponse>;
+    /**
+     * Get aggregate feedback counts and health score for an agent (INT-1).
+     *
+     * @param agentId  The agent to summarise feedback for.
+     */
+    getAgentFeedbackSummary(agentId: string): Promise<AgentFeedbackSummary>;
+    /**
+     * Directly override a memory's importance score (INT-1).
+     *
+     * @param memoryId    The memory to update.
+     * @param agentId     The agent that owns the memory.
+     * @param importance  New importance value (0.0–1.0).
+     */
+    patchMemoryImportance(memoryId: string, agentId: string, importance: number): Promise<FeedbackResponse>;
+    /**
+     * Get overall feedback health score for an agent (INT-1).
+     *
+     * The health score is the mean importance of all non-expired memories (0.0–1.0).
+     * A higher score indicates a healthier, more relevant memory store.
+     *
+     * @param agentId  The agent to get health score for.
+     */
+    getFeedbackHealth(agentId: string): Promise<FeedbackHealthResponse>;
     /**
      * Traverse the knowledge graph from a memory node.
      *
@@ -2071,6 +2215,10 @@ declare class DakeraClient {
     /** Get server stats (version, total_vectors, namespace_count, uptime_seconds, timestamp).
      *  Requires Read scope — works with read-only API keys, unlike clusterStatus. */
     opsStats(): Promise<OpsStats>;
+    /** Get Prometheus metrics in text exposition format (INFRA-3).
+     *  Requires Admin scope. Returns the raw Prometheus text exposition
+     *  format string suitable for scraping by a Prometheus server. */
+    opsMetrics(): Promise<string>;
     /** Get cluster status */
     clusterStatus(): Promise<ClusterStatus>;
     /** Get cluster nodes */
@@ -2256,6 +2404,39 @@ declare class DakeraClient {
     private _streamSseMemory;
     /** Parse a single SSE event block into a {@link MemoryEvent}. */
     private _parseSseMemoryBlock;
+    /**
+     * Create a namespace-scoped API key (SEC-1).
+     *
+     * The `key` field in the response is shown **only once** — store it securely.
+     *
+     * @param namespace     The namespace to scope this key to.
+     * @param name          Human-readable label for the key.
+     * @param expiresInDays Optional expiry in days from now.
+     */
+    createNamespaceKey(namespace: string, name: string, expiresInDays?: number): Promise<CreateNamespaceKeyResponse>;
+    /**
+     * List all API keys scoped to a namespace (SEC-1).
+     *
+     * @param namespace  The namespace whose keys to list.
+     */
+    listNamespaceKeys(namespace: string): Promise<ListNamespaceKeysResponse>;
+    /**
+     * Revoke a namespace-scoped API key (SEC-1).
+     *
+     * @param namespace  The namespace the key belongs to.
+     * @param keyId      The key to revoke.
+     */
+    deleteNamespaceKey(namespace: string, keyId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Get usage statistics for a namespace-scoped API key (SEC-1).
+     *
+     * @param namespace  The namespace the key belongs to.
+     * @param keyId      The key whose usage to retrieve.
+     */
+    getNamespaceKeyUsage(namespace: string, keyId: string): Promise<NamespaceKeyUsageResponse>;
 }
 
 /**
@@ -2320,4 +2501,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 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 ExtractedEntity, 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 KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceNerConfig, NotFoundError, 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 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, 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 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 ExtractedEntity, 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 KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type Memory, type MemoryEntitiesResponse, type MemoryEvent, type MemoryFeedbackBodyRequest, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryGraph, type MemoryGraphOptions, type MemoryId, type MemoryImportancePatchRequest, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceNerConfig, NotFoundError, 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 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

@@ -1136,6 +1136,61 @@ var DakeraClient = class {
     return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
+  // Memory Feedback Loop — INT-1
+  // ===========================================================================
+  /**
+   * Submit upvote/downvote/flag feedback on a memory (INT-1).
+   *
+   * - `upvote`: boosts importance ×1.15 (capped at 1.0).
+   * - `downvote`: penalises importance ×0.85 (floor 0.0).
+   * - `flag`: marks as irrelevant — accelerates decay on next cycle.
+   *
+   * @param memoryId  The memory to give feedback on.
+   * @param agentId   The agent that owns the memory.
+   * @param signal    Feedback signal.
+   */
+  async feedbackMemory(memoryId2, agentId2, signal) {
+    return this.request("POST", `/v1/memories/${memoryId2}/feedback`, { agent_id: agentId2, signal });
+  }
+  /**
+   * Get the full feedback history for a memory (INT-1).
+   *
+   * @param memoryId  The memory whose feedback history to retrieve.
+   */
+  async getMemoryFeedbackHistory(memoryId2) {
+    return this.request("GET", `/v1/memories/${memoryId2}/feedback`);
+  }
+  /**
+   * Get aggregate feedback counts and health score for an agent (INT-1).
+   *
+   * @param agentId  The agent to summarise feedback for.
+   */
+  async getAgentFeedbackSummary(agentId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/feedback/summary`);
+  }
+  /**
+   * Directly override a memory's importance score (INT-1).
+   *
+   * @param memoryId    The memory to update.
+   * @param agentId     The agent that owns the memory.
+   * @param importance  New importance value (0.0–1.0).
+   */
+  async patchMemoryImportance(memoryId2, agentId2, importance) {
+    return this.request("PATCH", `/v1/memories/${memoryId2}/importance`, { agent_id: agentId2, importance });
+  }
+  /**
+   * Get overall feedback health score for an agent (INT-1).
+   *
+   * The health score is the mean importance of all non-expired memories (0.0–1.0).
+   * A higher score indicates a healthier, more relevant memory store.
+   *
+   * @param agentId  The agent to get health score for.
+   */
+  async getFeedbackHealth(agentId2) {
+    const params = new URLSearchParams({ agent_id: agentId2 });
+    return this.request("GET", `/v1/feedback/health?${params}`);
+  }
+  // ===========================================================================
   // Memory Knowledge Graph Operations (CE-5 / SDK-9)
   // ===========================================================================
   /**
@@ -1380,6 +1435,12 @@ var DakeraClient = class {
   async opsStats() {
     return this.request("GET", "/v1/ops/stats");
   }
+  /** Get Prometheus metrics in text exposition format (INFRA-3).
+   *  Requires Admin scope. Returns the raw Prometheus text exposition
+   *  format string suitable for scraping by a Prometheus server. */
+  async opsMetrics() {
+    return this.request("GET", "/v1/ops/metrics");
+  }
   /** Get cluster status */
   async clusterStatus() {
     return this.request("GET", "/v1/admin/cluster/status");
@@ -1750,6 +1811,49 @@ var DakeraClient = class {
       return null;
     }
   }
+  // ===========================================================================
+  // Namespace API Keys — SEC-1
+  // ===========================================================================
+  /**
+   * Create a namespace-scoped API key (SEC-1).
+   *
+   * The `key` field in the response is shown **only once** — store it securely.
+   *
+   * @param namespace     The namespace to scope this key to.
+   * @param name          Human-readable label for the key.
+   * @param expiresInDays Optional expiry in days from now.
+   */
+  async createNamespaceKey(namespace, name, expiresInDays) {
+    const body = { name };
+    if (expiresInDays !== void 0) body.expires_in_days = expiresInDays;
+    return this.request("POST", `/v1/namespaces/${namespace}/keys`, body);
+  }
+  /**
+   * List all API keys scoped to a namespace (SEC-1).
+   *
+   * @param namespace  The namespace whose keys to list.
+   */
+  async listNamespaceKeys(namespace) {
+    return this.request("GET", `/v1/namespaces/${namespace}/keys`);
+  }
+  /**
+   * Revoke a namespace-scoped API key (SEC-1).
+   *
+   * @param namespace  The namespace the key belongs to.
+   * @param keyId      The key to revoke.
+   */
+  async deleteNamespaceKey(namespace, keyId) {
+    return this.request("DELETE", `/v1/namespaces/${namespace}/keys/${keyId}`);
+  }
+  /**
+   * Get usage statistics for a namespace-scoped API key (SEC-1).
+   *
+   * @param namespace  The namespace the key belongs to.
+   * @param keyId      The key whose usage to retrieve.
+   */
+  async getNamespaceKeyUsage(namespace, keyId) {
+    return this.request("GET", `/v1/namespaces/${namespace}/keys/${keyId}/usage`);
+  }
 };
 
 // src/types.ts

package/dist/index.mjs

@@ -1096,6 +1096,61 @@ var DakeraClient = class {
     return this.request("POST", `/v1/agents/${agentId2}/memories/feedback`, request);
   }
   // ===========================================================================
+  // Memory Feedback Loop — INT-1
+  // ===========================================================================
+  /**
+   * Submit upvote/downvote/flag feedback on a memory (INT-1).
+   *
+   * - `upvote`: boosts importance ×1.15 (capped at 1.0).
+   * - `downvote`: penalises importance ×0.85 (floor 0.0).
+   * - `flag`: marks as irrelevant — accelerates decay on next cycle.
+   *
+   * @param memoryId  The memory to give feedback on.
+   * @param agentId   The agent that owns the memory.
+   * @param signal    Feedback signal.
+   */
+  async feedbackMemory(memoryId2, agentId2, signal) {
+    return this.request("POST", `/v1/memories/${memoryId2}/feedback`, { agent_id: agentId2, signal });
+  }
+  /**
+   * Get the full feedback history for a memory (INT-1).
+   *
+   * @param memoryId  The memory whose feedback history to retrieve.
+   */
+  async getMemoryFeedbackHistory(memoryId2) {
+    return this.request("GET", `/v1/memories/${memoryId2}/feedback`);
+  }
+  /**
+   * Get aggregate feedback counts and health score for an agent (INT-1).
+   *
+   * @param agentId  The agent to summarise feedback for.
+   */
+  async getAgentFeedbackSummary(agentId2) {
+    return this.request("GET", `/v1/agents/${agentId2}/feedback/summary`);
+  }
+  /**
+   * Directly override a memory's importance score (INT-1).
+   *
+   * @param memoryId    The memory to update.
+   * @param agentId     The agent that owns the memory.
+   * @param importance  New importance value (0.0–1.0).
+   */
+  async patchMemoryImportance(memoryId2, agentId2, importance) {
+    return this.request("PATCH", `/v1/memories/${memoryId2}/importance`, { agent_id: agentId2, importance });
+  }
+  /**
+   * Get overall feedback health score for an agent (INT-1).
+   *
+   * The health score is the mean importance of all non-expired memories (0.0–1.0).
+   * A higher score indicates a healthier, more relevant memory store.
+   *
+   * @param agentId  The agent to get health score for.
+   */
+  async getFeedbackHealth(agentId2) {
+    const params = new URLSearchParams({ agent_id: agentId2 });
+    return this.request("GET", `/v1/feedback/health?${params}`);
+  }
+  // ===========================================================================
   // Memory Knowledge Graph Operations (CE-5 / SDK-9)
   // ===========================================================================
   /**
@@ -1340,6 +1395,12 @@ var DakeraClient = class {
   async opsStats() {
     return this.request("GET", "/v1/ops/stats");
   }
+  /** Get Prometheus metrics in text exposition format (INFRA-3).
+   *  Requires Admin scope. Returns the raw Prometheus text exposition
+   *  format string suitable for scraping by a Prometheus server. */
+  async opsMetrics() {
+    return this.request("GET", "/v1/ops/metrics");
+  }
   /** Get cluster status */
   async clusterStatus() {
     return this.request("GET", "/v1/admin/cluster/status");
@@ -1710,6 +1771,49 @@ var DakeraClient = class {
       return null;
     }
   }
+  // ===========================================================================
+  // Namespace API Keys — SEC-1
+  // ===========================================================================
+  /**
+   * Create a namespace-scoped API key (SEC-1).
+   *
+   * The `key` field in the response is shown **only once** — store it securely.
+   *
+   * @param namespace     The namespace to scope this key to.
+   * @param name          Human-readable label for the key.
+   * @param expiresInDays Optional expiry in days from now.
+   */
+  async createNamespaceKey(namespace, name, expiresInDays) {
+    const body = { name };
+    if (expiresInDays !== void 0) body.expires_in_days = expiresInDays;
+    return this.request("POST", `/v1/namespaces/${namespace}/keys`, body);
+  }
+  /**
+   * List all API keys scoped to a namespace (SEC-1).
+   *
+   * @param namespace  The namespace whose keys to list.
+   */
+  async listNamespaceKeys(namespace) {
+    return this.request("GET", `/v1/namespaces/${namespace}/keys`);
+  }
+  /**
+   * Revoke a namespace-scoped API key (SEC-1).
+   *
+   * @param namespace  The namespace the key belongs to.
+   * @param keyId      The key to revoke.
+   */
+  async deleteNamespaceKey(namespace, keyId) {
+    return this.request("DELETE", `/v1/namespaces/${namespace}/keys/${keyId}`);
+  }
+  /**
+   * Get usage statistics for a namespace-scoped API key (SEC-1).
+   *
+   * @param namespace  The namespace the key belongs to.
+   * @param keyId      The key whose usage to retrieve.
+   */
+  async getNamespaceKeyUsage(namespace, keyId) {
+    return this.request("GET", `/v1/namespaces/${namespace}/keys/${keyId}/usage`);
+  }
 };
 
 // src/types.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakera-ai/dakera",
-  "version": "0.9.0",
+  "version": "0.9.3",
   "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -51,7 +51,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "eslint": "^8.55.0",
+    "eslint": "^10.1.0",
     "tsup": "^8.0.1",
     "typescript": "^5.3.0",
     "vitest": "^4.1.0"