@dakera-ai/dakera 0.11.83 → 0.11.90

package/LICENSE

@@ -1,6 +1,9 @@
+SPDX-License-Identifier: MIT
+
 MIT License
 
 Copyright (c) 2025 Dakera AI
+Author: Mohamed Amine Ferhi (https://orcid.org/0009-0007-2641-7727)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -127,6 +127,7 @@ for await (const event of stream) {
 - **Text Auto-Embedding** — server-side embedding generation (no local model needed)
 - **Namespaces** — isolated vector stores per project, tenant, or use case
 - **Feedback Loop** — upvote/downvote/flag memories to improve recall quality
+- **T-I-F Reliability** — `TifScore` type and `evaluateTif()` for Truth-Indeterminacy-Falsity scoring of memory reliability
 - **Entity Extraction** — GLiNER NER for automatic entity detection
 - **SSE Streaming** — async generator event subscriptions, browser-compatible
 - **Branded Types** — `VectorId`, `AgentId`, `MemoryId`, `SessionId` for compile-time safety

package/dist/index.d.mts

@@ -159,6 +159,8 @@ interface HealthResponse {
     status: string;
     version?: string;
     uptime?: number;
+    /** Git commit SHA baked into the binary at build time. Available since server v0.11.84. */
+    build_sha?: string;
 }
 /** Filter operators for metadata queries */
 interface FilterOperators {
@@ -2454,6 +2456,45 @@ interface DrainReembedResponse {
     /** True if the drain stopped on the timeout rather than reaching zero. */
     timed_out: boolean;
 }
+/** Classification labels from a TifScore. */
+type TifClassification = 'surface_contradiction' | 'ask_clarification' | 'confident_reuse' | 'verify_before_use';
+/**
+ * Truth-Indeterminacy-Falsity reliability score for a memory (T-I-F RFC Phase 3).
+ *
+ * All three proportions (truth / indeterminacy / falsity) sum to 1.0.
+ * Build via {@link computeTifScore} from a {@link FeedbackHistoryResponse}, or
+ * deserialise from stored metadata with {@link tifScoreFromMetadata}.
+ */
+interface TifScore {
+    /** Proportion of positive feedback signals (upvote / positive). */
+    truth: number;
+    /** Proportion of uncertainty signals (flag). */
+    indeterminacy: number;
+    /** Proportion of negative feedback signals (downvote / negative). */
+    falsity: number;
+    /** Total feedback events used to compute this score. */
+    feedbackCount: number;
+    /** Human-readable reliability classification derived from the proportions. */
+    classification: TifClassification;
+}
+/**
+ * Compute a {@link TifScore} from a memory's {@link FeedbackHistoryResponse}.
+ *
+ * Signals bucketed as:
+ * - `upvote` / `positive`   → truth
+ * - `downvote` / `negative` → falsity
+ * - `flag`                  → indeterminacy
+ *
+ * When there is no feedback the score is
+ * `{ truth: 0, indeterminacy: 1, falsity: 0, feedbackCount: 0 }`.
+ */
+declare function computeTifScore(history: FeedbackHistoryResponse): TifScore;
+/**
+ * Deserialise a {@link TifScore} from a `metadata.reliability` object.
+ *
+ * Expected keys: `truth`, `indeterminacy`, `falsity`, `feedback_count` (snake_case as stored).
+ */
+declare function tifScoreFromMetadata(data: Record<string, unknown>): TifScore;
 
 /**
  * Dakera client for interacting with the AI memory platform.
@@ -3107,6 +3148,16 @@ declare class DakeraClient {
      * @param memoryId  The memory whose feedback history to retrieve.
      */
     getMemoryFeedbackHistory(memoryId: string): Promise<FeedbackHistoryResponse>;
+    /**
+     * Compute a T-I-F reliability score for a memory (T-I-F RFC Phase 3).
+     *
+     * Fetches the memory's full feedback history and reduces it to a
+     * {@link TifScore} with truth/indeterminacy/falsity proportions and a
+     * human-readable {@link TifScore.classification}.
+     *
+     * @param memoryId  The memory to score.
+     */
+    evaluateTif(memoryId: string): Promise<TifScore>;
     /**
      * Get aggregate feedback counts and health score for an agent (INT-1).
      *
@@ -3874,4 +3925,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentConsolidateResponse, type AgentConsolidationConfig, type AgentConsolidationLogEntry, 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 BackupListResponse, type BackupSchedule, type BackupStatus, type BackupType, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchStoreMemoryItem, type BatchStoreMemoryRequest, type BatchStoreMemoryResponse, type BatchStoredMemory, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type CompactionRequest, type CompactionResponse, type CompressResponse, type CompressionType, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationConfigPatch, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CountVectorsRequest, type CountVectorsResponse, type CreateBackupRequest, type CreateBackupResponse, 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 DefaultQuotaResponse, type DeleteOptions, type DeleteResponse, type DisableMaintenanceRequest, type DistanceMetric, type Document, type DocumentInput, type DrainReembedRequest, type DrainReembedResponse, type EdgeType, type EmbeddingModel, type EnableMaintenanceRequest, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type ExtractorConfig, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextIndexStats, type FullTextSearchResult, type FulltextDeleteRequest, type FulltextDeleteResponse, type FulltextReindexNamespaceResult, type FulltextReindexResponse, type FusionStrategy, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type ImportJobStatus, type IndexStats, type JobInfo, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type LivenessResponse, type MaintenanceStatus, 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 MemoryTypeStatsResponse, type MigrateDimensionsResponse, type MigrateNamespaceDimensionsRequest, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceEntityConfig, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceMigrationResult, type NamespaceNerConfig, type NodeReplicationLag, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, type QuotaCheckRequest, type QuotaCheckResult, type QuotaConfig, type QuotaListResponse, type QuotaStatus, type QuotaUsage, RateLimitError, type RateLimitHeaders, type ReadConsistency, type ReadinessResponse, type RecallRequest, type RecallResponse, type RecalledMemory, type ReplicationStatus, type RestoreBackupRequest, type RestoreBackupResponse, type RestoreStatus, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type RouteMatch, type RouteRequest, type RouteResponse, type RoutingMode, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, type SetDefaultQuotaRequest, type SetQuotaRequest, type SetQuotaResponse, type ShardInfo, type ShardListResponse, type ShardRebalanceRequest, type ShardRebalanceResponse, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StorageTierOverview, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type SystemDiagnostics, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, type TierActivity, type TierConfig, type TierInfo, TimeoutError, type TtlConfig, type TtlNamespaceStats, type TtlStatsResponse, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateBackupScheduleRequest, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WakeUpOptions, type WakeUpResponse, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentConsolidateResponse, type AgentConsolidationConfig, type AgentConsolidationLogEntry, 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 BackupListResponse, type BackupSchedule, type BackupStatus, type BackupType, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchStoreMemoryItem, type BatchStoreMemoryRequest, type BatchStoreMemoryResponse, type BatchStoredMemory, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type CompactionRequest, type CompactionResponse, type CompressResponse, type CompressionType, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationConfigPatch, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CountVectorsRequest, type CountVectorsResponse, type CreateBackupRequest, type CreateBackupResponse, 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 DefaultQuotaResponse, type DeleteOptions, type DeleteResponse, type DisableMaintenanceRequest, type DistanceMetric, type Document, type DocumentInput, type DrainReembedRequest, type DrainReembedResponse, type EdgeType, type EmbeddingModel, type EnableMaintenanceRequest, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type ExtractorConfig, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextIndexStats, type FullTextSearchResult, type FulltextDeleteRequest, type FulltextDeleteResponse, type FulltextReindexNamespaceResult, type FulltextReindexResponse, type FusionStrategy, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type ImportJobStatus, type IndexStats, type JobInfo, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type LivenessResponse, type MaintenanceStatus, 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 MemoryTypeStatsResponse, type MigrateDimensionsResponse, type MigrateNamespaceDimensionsRequest, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceEntityConfig, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceMigrationResult, type NamespaceNerConfig, type NodeReplicationLag, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, type QuotaCheckRequest, type QuotaCheckResult, type QuotaConfig, type QuotaListResponse, type QuotaStatus, type QuotaUsage, RateLimitError, type RateLimitHeaders, type ReadConsistency, type ReadinessResponse, type RecallRequest, type RecallResponse, type RecalledMemory, type ReplicationStatus, type RestoreBackupRequest, type RestoreBackupResponse, type RestoreStatus, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type RouteMatch, type RouteRequest, type RouteResponse, type RoutingMode, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, type SetDefaultQuotaRequest, type SetQuotaRequest, type SetQuotaResponse, type ShardInfo, type ShardListResponse, type ShardRebalanceRequest, type ShardRebalanceResponse, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StorageTierOverview, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type SystemDiagnostics, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, type TierActivity, type TierConfig, type TierInfo, type TifClassification, type TifScore, TimeoutError, type TtlConfig, type TtlNamespaceStats, type TtlStatsResponse, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateBackupScheduleRequest, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WakeUpOptions, type WakeUpResponse, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, computeTifScore, memoryId, sessionId, tifScoreFromMetadata, vectorId };

package/dist/index.d.ts

@@ -159,6 +159,8 @@ interface HealthResponse {
     status: string;
     version?: string;
     uptime?: number;
+    /** Git commit SHA baked into the binary at build time. Available since server v0.11.84. */
+    build_sha?: string;
 }
 /** Filter operators for metadata queries */
 interface FilterOperators {
@@ -2454,6 +2456,45 @@ interface DrainReembedResponse {
     /** True if the drain stopped on the timeout rather than reaching zero. */
     timed_out: boolean;
 }
+/** Classification labels from a TifScore. */
+type TifClassification = 'surface_contradiction' | 'ask_clarification' | 'confident_reuse' | 'verify_before_use';
+/**
+ * Truth-Indeterminacy-Falsity reliability score for a memory (T-I-F RFC Phase 3).
+ *
+ * All three proportions (truth / indeterminacy / falsity) sum to 1.0.
+ * Build via {@link computeTifScore} from a {@link FeedbackHistoryResponse}, or
+ * deserialise from stored metadata with {@link tifScoreFromMetadata}.
+ */
+interface TifScore {
+    /** Proportion of positive feedback signals (upvote / positive). */
+    truth: number;
+    /** Proportion of uncertainty signals (flag). */
+    indeterminacy: number;
+    /** Proportion of negative feedback signals (downvote / negative). */
+    falsity: number;
+    /** Total feedback events used to compute this score. */
+    feedbackCount: number;
+    /** Human-readable reliability classification derived from the proportions. */
+    classification: TifClassification;
+}
+/**
+ * Compute a {@link TifScore} from a memory's {@link FeedbackHistoryResponse}.
+ *
+ * Signals bucketed as:
+ * - `upvote` / `positive`   → truth
+ * - `downvote` / `negative` → falsity
+ * - `flag`                  → indeterminacy
+ *
+ * When there is no feedback the score is
+ * `{ truth: 0, indeterminacy: 1, falsity: 0, feedbackCount: 0 }`.
+ */
+declare function computeTifScore(history: FeedbackHistoryResponse): TifScore;
+/**
+ * Deserialise a {@link TifScore} from a `metadata.reliability` object.
+ *
+ * Expected keys: `truth`, `indeterminacy`, `falsity`, `feedback_count` (snake_case as stored).
+ */
+declare function tifScoreFromMetadata(data: Record<string, unknown>): TifScore;
 
 /**
  * Dakera client for interacting with the AI memory platform.
@@ -3107,6 +3148,16 @@ declare class DakeraClient {
      * @param memoryId  The memory whose feedback history to retrieve.
      */
     getMemoryFeedbackHistory(memoryId: string): Promise<FeedbackHistoryResponse>;
+    /**
+     * Compute a T-I-F reliability score for a memory (T-I-F RFC Phase 3).
+     *
+     * Fetches the memory's full feedback history and reduces it to a
+     * {@link TifScore} with truth/indeterminacy/falsity proportions and a
+     * human-readable {@link TifScore.classification}.
+     *
+     * @param memoryId  The memory to score.
+     */
+    evaluateTif(memoryId: string): Promise<TifScore>;
     /**
      * Get aggregate feedback counts and health score for an agent (INT-1).
      *
@@ -3874,4 +3925,4 @@ declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentConsolidateResponse, type AgentConsolidationConfig, type AgentConsolidationLogEntry, 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 BackupListResponse, type BackupSchedule, type BackupStatus, type BackupType, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchStoreMemoryItem, type BatchStoreMemoryRequest, type BatchStoreMemoryResponse, type BatchStoredMemory, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type CompactionRequest, type CompactionResponse, type CompressResponse, type CompressionType, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationConfigPatch, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CountVectorsRequest, type CountVectorsResponse, type CreateBackupRequest, type CreateBackupResponse, 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 DefaultQuotaResponse, type DeleteOptions, type DeleteResponse, type DisableMaintenanceRequest, type DistanceMetric, type Document, type DocumentInput, type DrainReembedRequest, type DrainReembedResponse, type EdgeType, type EmbeddingModel, type EnableMaintenanceRequest, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type ExtractorConfig, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextIndexStats, type FullTextSearchResult, type FulltextDeleteRequest, type FulltextDeleteResponse, type FulltextReindexNamespaceResult, type FulltextReindexResponse, type FusionStrategy, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type ImportJobStatus, type IndexStats, type JobInfo, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type LivenessResponse, type MaintenanceStatus, 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 MemoryTypeStatsResponse, type MigrateDimensionsResponse, type MigrateNamespaceDimensionsRequest, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceEntityConfig, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceMigrationResult, type NamespaceNerConfig, type NodeReplicationLag, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, type QuotaCheckRequest, type QuotaCheckResult, type QuotaConfig, type QuotaListResponse, type QuotaStatus, type QuotaUsage, RateLimitError, type RateLimitHeaders, type ReadConsistency, type ReadinessResponse, type RecallRequest, type RecallResponse, type RecalledMemory, type ReplicationStatus, type RestoreBackupRequest, type RestoreBackupResponse, type RestoreStatus, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type RouteMatch, type RouteRequest, type RouteResponse, type RoutingMode, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, type SetDefaultQuotaRequest, type SetQuotaRequest, type SetQuotaResponse, type ShardInfo, type ShardListResponse, type ShardRebalanceRequest, type ShardRebalanceResponse, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StorageTierOverview, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type SystemDiagnostics, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, type TierActivity, type TierConfig, type TierInfo, TimeoutError, type TtlConfig, type TtlNamespaceStats, type TtlStatsResponse, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateBackupScheduleRequest, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WakeUpOptions, type WakeUpResponse, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentConsolidateResponse, type AgentConsolidationConfig, type AgentConsolidationLogEntry, 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 BackupListResponse, type BackupSchedule, type BackupStatus, type BackupType, type BatchForgetRequest, type BatchForgetResponse, type BatchMemoryFilter, type BatchQuerySpec, type BatchRecallRequest, type BatchRecallResponse, type BatchStoreMemoryItem, type BatchStoreMemoryRequest, type BatchStoreMemoryResponse, type BatchStoredMemory, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type CompactionRequest, type CompactionResponse, type CompressResponse, type CompressionType, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type ConsolidationConfig, type ConsolidationConfigPatch, type ConsolidationLogEntry, type ConsolidationResultSnapshot, type CountVectorsRequest, type CountVectorsResponse, type CreateBackupRequest, type CreateBackupResponse, 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 DefaultQuotaResponse, type DeleteOptions, type DeleteResponse, type DisableMaintenanceRequest, type DistanceMetric, type Document, type DocumentInput, type DrainReembedRequest, type DrainReembedResponse, type EdgeType, type EmbeddingModel, type EnableMaintenanceRequest, type EntityExtractionResponse, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type ExtractEntitiesRequest, type ExtractEntitiesResponse, type ExtractedEntity, type ExtractionProviderInfo, type ExtractionResult, type ExtractorConfig, type FeedbackHealthResponse, type FeedbackHistoryEntry, type FeedbackHistoryResponse, type FeedbackResponse, type FeedbackSignal, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextIndexStats, type FullTextSearchResult, type FulltextDeleteRequest, type FulltextDeleteResponse, type FulltextReindexNamespaceResult, type FulltextReindexResponse, type FusionStrategy, type GraphEdge, type GraphExport, type GraphLinkResponse, type GraphNode, type GraphPath, type HealthResponse, type HybridSearchResult, type ImportJobStatus, type IndexStats, type JobInfo, type JobProgressEvent, type KeyUsage, type KgExportResponse, type KgPathResponse, type KgQueryResponse, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type KpiSnapshot, type LastDecayCycleStats, type LatencyAnalytics, type ListNamespaceKeysResponse, type ListSessionsOptions, type LivenessResponse, type MaintenanceStatus, 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 MemoryTypeStatsResponse, type MigrateDimensionsResponse, type MigrateNamespaceDimensionsRequest, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceEntityConfig, type NamespaceInfo, type NamespaceKeyInfo, type NamespaceKeyUsageResponse, type NamespaceMigrationResult, type NamespaceNerConfig, type NodeReplicationLag, NotFoundError, type OdeEntity, type OpStatus, type OperationProgressEvent, type OpsStats, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, type QuotaCheckRequest, type QuotaCheckResult, type QuotaConfig, type QuotaListResponse, type QuotaStatus, type QuotaUsage, RateLimitError, type RateLimitHeaders, type ReadConsistency, type ReadinessResponse, type RecallRequest, type RecallResponse, type RecalledMemory, type ReplicationStatus, type RestoreBackupRequest, type RestoreBackupResponse, type RestoreStatus, type RetryConfig, type RotateEncryptionKeyRequest, type RotateEncryptionKeyResponse, type RouteMatch, type RouteRequest, type RouteResponse, type RoutingMode, type SearchResult, ServerError, type Session, type SessionEndResponse, type SessionId, type SessionStartResponse, type SetDefaultQuotaRequest, type SetQuotaRequest, type SetQuotaResponse, type ShardInfo, type ShardListResponse, type ShardRebalanceRequest, type ShardRebalanceResponse, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StorageTierOverview, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type SystemDiagnostics, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, type TierActivity, type TierConfig, type TierInfo, type TifClassification, type TifScore, TimeoutError, type TtlConfig, type TtlNamespaceStats, type TtlStatsResponse, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateBackupScheduleRequest, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WakeUpOptions, type WakeUpResponse, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, computeTifScore, memoryId, sessionId, tifScoreFromMetadata, vectorId };

package/dist/index.js

@@ -129,6 +129,49 @@ var TimeoutError = class _TimeoutError extends DakeraError {
   }
 };
 
+// src/types.ts
+function vectorId(id) {
+  return id;
+}
+function agentId(id) {
+  return id;
+}
+function memoryId(id) {
+  return id;
+}
+function sessionId(id) {
+  return id;
+}
+function classifyTif(truth, indeterminacy, falsity) {
+  if (falsity >= 0.5) return "surface_contradiction";
+  if (indeterminacy >= 0.5) return "ask_clarification";
+  if (truth >= 0.7) return "confident_reuse";
+  return "verify_before_use";
+}
+function computeTifScore(history) {
+  let upvotes = 0;
+  let downvotes = 0;
+  let flags = 0;
+  for (const entry of history.entries) {
+    if (entry.signal === "upvote" || entry.signal === "positive") upvotes++;
+    else if (entry.signal === "downvote" || entry.signal === "negative") downvotes++;
+    else if (entry.signal === "flag") flags++;
+  }
+  const total = upvotes + downvotes + flags;
+  if (total === 0) {
+    return { truth: 0, indeterminacy: 1, falsity: 0, feedbackCount: 0, classification: "ask_clarification" };
+  }
+  const baseIndeterminacy = total < 3 ? (3 - total) * 0.25 : 0;
+  let truth = upvotes / total;
+  let falsity = downvotes / total;
+  let indeterminacy = flags / total + baseIndeterminacy;
+  const sum = truth + falsity + indeterminacy;
+  truth /= sum;
+  falsity /= sum;
+  indeterminacy /= sum;
+  return { truth, indeterminacy, falsity, feedbackCount: total, classification: classifyTif(truth, indeterminacy, falsity) };
+}
+
 // src/client.ts
 function parseErrorCode(raw) {
   if (typeof raw === "string" && raw in ErrorCode) {
@@ -1291,6 +1334,19 @@ var DakeraClient = class {
   async getMemoryFeedbackHistory(memoryId2) {
     return this.request("GET", `/v1/memories/${memoryId2}/feedback`);
   }
+  /**
+   * Compute a T-I-F reliability score for a memory (T-I-F RFC Phase 3).
+   *
+   * Fetches the memory's full feedback history and reduces it to a
+   * {@link TifScore} with truth/indeterminacy/falsity proportions and a
+   * human-readable {@link TifScore.classification}.
+   *
+   * @param memoryId  The memory to score.
+   */
+  async evaluateTif(memoryId2) {
+    const history = await this.getMemoryFeedbackHistory(memoryId2);
+    return computeTifScore(history);
+  }
   /**
    * Get aggregate feedback counts and health score for an agent (INT-1).
    *
@@ -2580,20 +2636,6 @@ var DakeraClient = class {
     return this.request("POST", "/admin/reembed/drain", request ?? {});
   }
 };
-
-// src/types.ts
-function vectorId(id) {
-  return id;
-}
-function agentId(id) {
-  return id;
-}
-function memoryId(id) {
-  return id;
-}
-function sessionId(id) {
-  return id;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,

package/dist/index.mjs

@@ -89,6 +89,49 @@ var TimeoutError = class _TimeoutError extends DakeraError {
   }
 };
 
+// src/types.ts
+function vectorId(id) {
+  return id;
+}
+function agentId(id) {
+  return id;
+}
+function memoryId(id) {
+  return id;
+}
+function sessionId(id) {
+  return id;
+}
+function classifyTif(truth, indeterminacy, falsity) {
+  if (falsity >= 0.5) return "surface_contradiction";
+  if (indeterminacy >= 0.5) return "ask_clarification";
+  if (truth >= 0.7) return "confident_reuse";
+  return "verify_before_use";
+}
+function computeTifScore(history) {
+  let upvotes = 0;
+  let downvotes = 0;
+  let flags = 0;
+  for (const entry of history.entries) {
+    if (entry.signal === "upvote" || entry.signal === "positive") upvotes++;
+    else if (entry.signal === "downvote" || entry.signal === "negative") downvotes++;
+    else if (entry.signal === "flag") flags++;
+  }
+  const total = upvotes + downvotes + flags;
+  if (total === 0) {
+    return { truth: 0, indeterminacy: 1, falsity: 0, feedbackCount: 0, classification: "ask_clarification" };
+  }
+  const baseIndeterminacy = total < 3 ? (3 - total) * 0.25 : 0;
+  let truth = upvotes / total;
+  let falsity = downvotes / total;
+  let indeterminacy = flags / total + baseIndeterminacy;
+  const sum = truth + falsity + indeterminacy;
+  truth /= sum;
+  falsity /= sum;
+  indeterminacy /= sum;
+  return { truth, indeterminacy, falsity, feedbackCount: total, classification: classifyTif(truth, indeterminacy, falsity) };
+}
+
 // src/client.ts
 function parseErrorCode(raw) {
   if (typeof raw === "string" && raw in ErrorCode) {
@@ -1251,6 +1294,19 @@ var DakeraClient = class {
   async getMemoryFeedbackHistory(memoryId2) {
     return this.request("GET", `/v1/memories/${memoryId2}/feedback`);
   }
+  /**
+   * Compute a T-I-F reliability score for a memory (T-I-F RFC Phase 3).
+   *
+   * Fetches the memory's full feedback history and reduces it to a
+   * {@link TifScore} with truth/indeterminacy/falsity proportions and a
+   * human-readable {@link TifScore.classification}.
+   *
+   * @param memoryId  The memory to score.
+   */
+  async evaluateTif(memoryId2) {
+    const history = await this.getMemoryFeedbackHistory(memoryId2);
+    return computeTifScore(history);
+  }
   /**
    * Get aggregate feedback counts and health score for an agent (INT-1).
    *
@@ -2540,20 +2596,6 @@ var DakeraClient = class {
     return this.request("POST", "/admin/reembed/drain", request ?? {});
   }
 };
-
-// src/types.ts
-function vectorId(id) {
-  return id;
-}
-function agentId(id) {
-  return id;
-}
-function memoryId(id) {
-  return id;
-}
-function sessionId(id) {
-  return id;
-}
 export {
   AuthenticationError,
   AuthorizationError,

package/package.json

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