@anuma/sdk 6.20.0 → 6.21.0

package/dist/server/index.d.ts

@@ -5696,7 +5696,25 @@ type RecallDegradation =
  *  failing back to the single-query path, or a row batch failing while other
  *  rows keep usable vectors) — those are logged, not reported, so this stays a
  *  reliable outage signal rather than a general embedding-error counter. */
- | "embeddings-unavailable";
+ | "embeddings-unavailable"
+/** The W5 graph (entity) side lane threw and was dropped. Auxiliary, so recall
+ *  still returned — but its RRF signal is missing from the ranking, and until
+ *  this existed the drop was a log line and nothing else. */
+ | "graph-lane-failed"
+/** The W6 temporal side lane threw and was dropped. Same posture as the graph
+ *  lane: recall still returned, ranked without the temporal signal. */
+ | "temporal-lane-failed";
+/**
+ * Why a recall returned nothing. `""` when it returned something, so the field
+ * is always present and groupable rather than being absent on the healthy path.
+ *
+ * The four are different problems: an empty query is a caller bug, no-lanes is a
+ * context wiring bug (the requested kinds have no store), vault-empty is a new
+ * user, and no-candidates is the only one that is about retrieval quality. They
+ * were previously indistinguishable from outside — every one reported
+ * `candidateCount: 0`.
+ */
+type RecallEmptyReason = "" | "empty-query" | "no-lanes" | "vault-empty" | "no-candidates";
 /**
  * Per-call recall observability payload (see {@link RecallOptions.onDiagnostics}).
  * All timings are wall-clock milliseconds. Lane counts are post-dedupe,
@@ -5747,6 +5765,50 @@ interface RecallDiagnostics {
     factCount: number;
     /** Chunks the chunk lane returned (post-dedupe, pre-fusion). */
     chunkCount: number;
+    /**
+     * Memories actually RETURNED — `memories.length` after fusion, cross-lane
+     * dedup and the `limit` slice.
+     *
+     * `candidateCount` is what was considered; this is what the caller got, and
+     * the two are routinely far apart (the fact lane pulls `limit * 2` when fusing).
+     * Every consumer that wanted "how many memories did this turn actually get"
+     * was reading `candidateCount` and overcounting.
+     */
+    admittedCount: number;
+    /** Highest score among the returned memories; -1 when none were returned. */
+    topScore: number;
+    /** Lowest score among the returned memories; -1 when none were returned. */
+    lowestAdmittedScore: number;
+    /**
+     * The similarity floor the lane that produced these scores actually applied:
+     * the fact lane's when it RETURNED results, otherwise the chunk lane's, and
+     * **-1 when neither ran** (empty query, unwired context). Gated on results
+     * rather than on the lane running, because a fact lane that ran and came
+     * back empty filtered none of the scores in the payload — reporting its
+     * 0.1 default against chunks that cleared 0.5 corrupted the telemetry.
+     * When NOTHING was admitted, the floor a lane did apply is still reported:
+     * "searched at this floor, found nothing" is the useful reading.
+     *
+     * Per-lane rather than one constant because the two defaults differ (0.1 fact
+     * / 0.5 chunk), so a single seeded value reported a floor that a chunk-only
+     * recall never applied. Reported next to the scores because the scores alone
+     * cannot say what they cleared.
+     */
+    minScoreApplied: number;
+    /**
+     * Whether the `limit` cut an ELIGIBLE result — recorded at the cut, not
+     * derived from `candidateCount > limit`. In the fused path `candidateCount`
+     * counts before provenance suppression, so a recall whose suppressed chunks
+     * brought it under the limit would otherwise report a truncation that never
+     * happened.
+     */
+    truncated: boolean;
+    /** Memory ids the W5 graph (entity) side lane contributed to the fusion. */
+    graphLaneCount: number;
+    /** Memory ids the W6 temporal side lane contributed to the fusion. */
+    temporalLaneCount: number;
+    /** Why nothing came back — see {@link RecallEmptyReason}. `""` when something did. */
+    emptyReason: RecallEmptyReason;
     /** Wall-clock phase timings (ms). */
     timings: {
         /** Whole `recall()` call. */
@@ -10841,4 +10903,4 @@ declare function sanitizeQuotes(s: string): string;
 declare function renderTemplate(value: string | null | undefined, template: string): string | null;
 declare function buildSystemPrompt(ctx: PromptContext, options?: BuildPromptOptions): BuildPromptResult;
 
-export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationAction, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, Message, type MessageChunk, type MessageFeedback, type MessageOrigin, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PhotoIngestResult, type PhotoMediaRef, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type PublishedPhotoMemory, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunTerminalState, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TopicSkipReason, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createMessageSourceResolver, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isDegradedTopicSkip, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, parseMedia, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, relinkMemoryTopicsOp, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, seedEncryptionKeys, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp, verifyMemoriesForPublish };
+export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationAction, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, Message, type MessageChunk, type MessageFeedback, type MessageOrigin, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PhotoIngestResult, type PhotoMediaRef, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type PublishedPhotoMemory, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallEmptyReason, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunTerminalState, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TopicSkipReason, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createMessageSourceResolver, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isDegradedTopicSkip, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, parseMedia, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, relinkMemoryTopicsOp, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, seedEncryptionKeys, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp, verifyMemoriesForPublish };

package/dist/server/index.mjs

@@ -141,7 +141,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-X5EZQFGR.mjs";
+} from "./chunk-4DSDATYG.mjs";
 import {
   createStreamingDeAnonymizer,
   notifyConsolidationFallback,

package/dist/server/{recall-M3KBKU74.mjs → recall-HA4UX4BB.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-X5EZQFGR.mjs";
+} from "./chunk-4DSDATYG.mjs";
 import "./chunk-YXL5VKCO.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 export {

package/dist/telemetry/index.cjs

@@ -213,6 +213,23 @@ function createRecallDiagnosticsHandler(sink) {
       usedBudget: diagnostics.usedBudget,
       reranked: diagnostics.reranked,
       candidateCount: diagnostics.candidateCount,
+      // What the caller actually GOT. `candidateCount` is what was considered,
+      // and the two are routinely far apart — the fact lane pulls `limit * 2`
+      // when fusing — so a consumer reading candidateCount as "memories this
+      // turn received" overcounts.
+      admittedCount: diagnostics.admittedCount,
+      // Both ends of the admitted range, and the lane counts, ride the EVENT as
+      // well as the metrics: a track-only sink is a supported configuration
+      // (the module's own PostHog example is exactly that shape), and it could
+      // otherwise see neither the bottom of the score range nor which side lane
+      // contributed.
+      topScore: diagnostics.topScore,
+      lowestAdmittedScore: diagnostics.lowestAdmittedScore,
+      minScoreApplied: diagnostics.minScoreApplied,
+      truncated: diagnostics.truncated,
+      emptyReason: diagnostics.emptyReason,
+      graphLaneCount: diagnostics.graphLaneCount,
+      temporalLaneCount: diagnostics.temporalLaneCount,
       factCount: diagnostics.factCount,
       chunkCount: diagnostics.chunkCount,
       totalMs: diagnostics.timings.total,
@@ -226,8 +243,11 @@ function createRecallDiagnosticsHandler(sink) {
       metric("recall.duration", ms, { lane });
     }
     metric("recall.candidates", diagnostics.candidateCount, {});
+    metric("recall.admitted", diagnostics.admittedCount, {});
     metric("recall.facts", diagnostics.factCount, {});
     metric("recall.chunks", diagnostics.chunkCount, {});
+    metric("recall.lane.graph", diagnostics.graphLaneCount, {});
+    metric("recall.lane.temporal", diagnostics.temporalLaneCount, {});
     if (diagnostics.vaultSize !== void 0) {
       metric("recall.vault.size", diagnostics.vaultSize, {});
     }

package/dist/telemetry/index.d.mts

@@ -422,7 +422,25 @@ type RecallDegradation =
  *  failing back to the single-query path, or a row batch failing while other
  *  rows keep usable vectors) — those are logged, not reported, so this stays a
  *  reliable outage signal rather than a general embedding-error counter. */
- | "embeddings-unavailable";
+ | "embeddings-unavailable"
+/** The W5 graph (entity) side lane threw and was dropped. Auxiliary, so recall
+ *  still returned — but its RRF signal is missing from the ranking, and until
+ *  this existed the drop was a log line and nothing else. */
+ | "graph-lane-failed"
+/** The W6 temporal side lane threw and was dropped. Same posture as the graph
+ *  lane: recall still returned, ranked without the temporal signal. */
+ | "temporal-lane-failed";
+/**
+ * Why a recall returned nothing. `""` when it returned something, so the field
+ * is always present and groupable rather than being absent on the healthy path.
+ *
+ * The four are different problems: an empty query is a caller bug, no-lanes is a
+ * context wiring bug (the requested kinds have no store), vault-empty is a new
+ * user, and no-candidates is the only one that is about retrieval quality. They
+ * were previously indistinguishable from outside — every one reported
+ * `candidateCount: 0`.
+ */
+type RecallEmptyReason = "" | "empty-query" | "no-lanes" | "vault-empty" | "no-candidates";
 /**
  * Per-call recall observability payload (see {@link RecallOptions.onDiagnostics}).
  * All timings are wall-clock milliseconds. Lane counts are post-dedupe,
@@ -473,6 +491,50 @@ interface RecallDiagnostics {
     factCount: number;
     /** Chunks the chunk lane returned (post-dedupe, pre-fusion). */
     chunkCount: number;
+    /**
+     * Memories actually RETURNED — `memories.length` after fusion, cross-lane
+     * dedup and the `limit` slice.
+     *
+     * `candidateCount` is what was considered; this is what the caller got, and
+     * the two are routinely far apart (the fact lane pulls `limit * 2` when fusing).
+     * Every consumer that wanted "how many memories did this turn actually get"
+     * was reading `candidateCount` and overcounting.
+     */
+    admittedCount: number;
+    /** Highest score among the returned memories; -1 when none were returned. */
+    topScore: number;
+    /** Lowest score among the returned memories; -1 when none were returned. */
+    lowestAdmittedScore: number;
+    /**
+     * The similarity floor the lane that produced these scores actually applied:
+     * the fact lane's when it RETURNED results, otherwise the chunk lane's, and
+     * **-1 when neither ran** (empty query, unwired context). Gated on results
+     * rather than on the lane running, because a fact lane that ran and came
+     * back empty filtered none of the scores in the payload — reporting its
+     * 0.1 default against chunks that cleared 0.5 corrupted the telemetry.
+     * When NOTHING was admitted, the floor a lane did apply is still reported:
+     * "searched at this floor, found nothing" is the useful reading.
+     *
+     * Per-lane rather than one constant because the two defaults differ (0.1 fact
+     * / 0.5 chunk), so a single seeded value reported a floor that a chunk-only
+     * recall never applied. Reported next to the scores because the scores alone
+     * cannot say what they cleared.
+     */
+    minScoreApplied: number;
+    /**
+     * Whether the `limit` cut an ELIGIBLE result — recorded at the cut, not
+     * derived from `candidateCount > limit`. In the fused path `candidateCount`
+     * counts before provenance suppression, so a recall whose suppressed chunks
+     * brought it under the limit would otherwise report a truncation that never
+     * happened.
+     */
+    truncated: boolean;
+    /** Memory ids the W5 graph (entity) side lane contributed to the fusion. */
+    graphLaneCount: number;
+    /** Memory ids the W6 temporal side lane contributed to the fusion. */
+    temporalLaneCount: number;
+    /** Why nothing came back — see {@link RecallEmptyReason}. `""` when something did. */
+    emptyReason: RecallEmptyReason;
     /** Wall-clock phase timings (ms). */
     timings: {
         /** Whole `recall()` call. */

package/dist/telemetry/index.d.ts

@@ -422,7 +422,25 @@ type RecallDegradation =
  *  failing back to the single-query path, or a row batch failing while other
  *  rows keep usable vectors) — those are logged, not reported, so this stays a
  *  reliable outage signal rather than a general embedding-error counter. */
- | "embeddings-unavailable";
+ | "embeddings-unavailable"
+/** The W5 graph (entity) side lane threw and was dropped. Auxiliary, so recall
+ *  still returned — but its RRF signal is missing from the ranking, and until
+ *  this existed the drop was a log line and nothing else. */
+ | "graph-lane-failed"
+/** The W6 temporal side lane threw and was dropped. Same posture as the graph
+ *  lane: recall still returned, ranked without the temporal signal. */
+ | "temporal-lane-failed";
+/**
+ * Why a recall returned nothing. `""` when it returned something, so the field
+ * is always present and groupable rather than being absent on the healthy path.
+ *
+ * The four are different problems: an empty query is a caller bug, no-lanes is a
+ * context wiring bug (the requested kinds have no store), vault-empty is a new
+ * user, and no-candidates is the only one that is about retrieval quality. They
+ * were previously indistinguishable from outside — every one reported
+ * `candidateCount: 0`.
+ */
+type RecallEmptyReason = "" | "empty-query" | "no-lanes" | "vault-empty" | "no-candidates";
 /**
  * Per-call recall observability payload (see {@link RecallOptions.onDiagnostics}).
  * All timings are wall-clock milliseconds. Lane counts are post-dedupe,
@@ -473,6 +491,50 @@ interface RecallDiagnostics {
     factCount: number;
     /** Chunks the chunk lane returned (post-dedupe, pre-fusion). */
     chunkCount: number;
+    /**
+     * Memories actually RETURNED — `memories.length` after fusion, cross-lane
+     * dedup and the `limit` slice.
+     *
+     * `candidateCount` is what was considered; this is what the caller got, and
+     * the two are routinely far apart (the fact lane pulls `limit * 2` when fusing).
+     * Every consumer that wanted "how many memories did this turn actually get"
+     * was reading `candidateCount` and overcounting.
+     */
+    admittedCount: number;
+    /** Highest score among the returned memories; -1 when none were returned. */
+    topScore: number;
+    /** Lowest score among the returned memories; -1 when none were returned. */
+    lowestAdmittedScore: number;
+    /**
+     * The similarity floor the lane that produced these scores actually applied:
+     * the fact lane's when it RETURNED results, otherwise the chunk lane's, and
+     * **-1 when neither ran** (empty query, unwired context). Gated on results
+     * rather than on the lane running, because a fact lane that ran and came
+     * back empty filtered none of the scores in the payload — reporting its
+     * 0.1 default against chunks that cleared 0.5 corrupted the telemetry.
+     * When NOTHING was admitted, the floor a lane did apply is still reported:
+     * "searched at this floor, found nothing" is the useful reading.
+     *
+     * Per-lane rather than one constant because the two defaults differ (0.1 fact
+     * / 0.5 chunk), so a single seeded value reported a floor that a chunk-only
+     * recall never applied. Reported next to the scores because the scores alone
+     * cannot say what they cleared.
+     */
+    minScoreApplied: number;
+    /**
+     * Whether the `limit` cut an ELIGIBLE result — recorded at the cut, not
+     * derived from `candidateCount > limit`. In the fused path `candidateCount`
+     * counts before provenance suppression, so a recall whose suppressed chunks
+     * brought it under the limit would otherwise report a truncation that never
+     * happened.
+     */
+    truncated: boolean;
+    /** Memory ids the W5 graph (entity) side lane contributed to the fusion. */
+    graphLaneCount: number;
+    /** Memory ids the W6 temporal side lane contributed to the fusion. */
+    temporalLaneCount: number;
+    /** Why nothing came back — see {@link RecallEmptyReason}. `""` when something did. */
+    emptyReason: RecallEmptyReason;
     /** Wall-clock phase timings (ms). */
     timings: {
         /** Whole `recall()` call. */

package/dist/telemetry/index.mjs

@@ -185,6 +185,23 @@ function createRecallDiagnosticsHandler(sink) {
       usedBudget: diagnostics.usedBudget,
       reranked: diagnostics.reranked,
       candidateCount: diagnostics.candidateCount,
+      // What the caller actually GOT. `candidateCount` is what was considered,
+      // and the two are routinely far apart — the fact lane pulls `limit * 2`
+      // when fusing — so a consumer reading candidateCount as "memories this
+      // turn received" overcounts.
+      admittedCount: diagnostics.admittedCount,
+      // Both ends of the admitted range, and the lane counts, ride the EVENT as
+      // well as the metrics: a track-only sink is a supported configuration
+      // (the module's own PostHog example is exactly that shape), and it could
+      // otherwise see neither the bottom of the score range nor which side lane
+      // contributed.
+      topScore: diagnostics.topScore,
+      lowestAdmittedScore: diagnostics.lowestAdmittedScore,
+      minScoreApplied: diagnostics.minScoreApplied,
+      truncated: diagnostics.truncated,
+      emptyReason: diagnostics.emptyReason,
+      graphLaneCount: diagnostics.graphLaneCount,
+      temporalLaneCount: diagnostics.temporalLaneCount,
       factCount: diagnostics.factCount,
       chunkCount: diagnostics.chunkCount,
       totalMs: diagnostics.timings.total,
@@ -198,8 +215,11 @@ function createRecallDiagnosticsHandler(sink) {
       metric("recall.duration", ms, { lane });
     }
     metric("recall.candidates", diagnostics.candidateCount, {});
+    metric("recall.admitted", diagnostics.admittedCount, {});
     metric("recall.facts", diagnostics.factCount, {});
     metric("recall.chunks", diagnostics.chunkCount, {});
+    metric("recall.lane.graph", diagnostics.graphLaneCount, {});
+    metric("recall.lane.temporal", diagnostics.temporalLaneCount, {});
     if (diagnostics.vaultSize !== void 0) {
       metric("recall.vault.size", diagnostics.vaultSize, {});
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "6.20.0",
+  "version": "6.21.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",