@anuma/sdk 3.3.1 → 3.5.0

package/dist/expo/index.d.mts

@@ -4885,6 +4885,10 @@ interface VaultSearchResult {
      * real timestamps. Omitted when an item lacks the field upstream. */
     createdAt?: Date;
     updatedAt?: Date;
+    /** Times this fact has been re-observed — for C2 trend labels. */
+    proofCount?: number | null;
+    /** C3 re-observation watermark (Unix ms) — for C2 trends + C4 CE dates. */
+    lastObservedAt?: number | null;
     /** W6 temporal-lane anchors carried through to downstream `RankedMemory`
      * so the recall executor can surface dates to the answer model without
      * a second per-fact DB lookup + decrypt. Unix ms; null when the fact
@@ -4926,6 +4930,55 @@ declare function searchVaultMemories(query: string, vaultCtx: VaultMemoryOperati
  */
 declare function createMemoryVaultSearchTool(vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): ToolConfig;
 
+/**
+ * C2 — Observation trend labels.
+ *
+ * Algorithmic (no LLM) classification of how a vault fact's evidence has
+ * been evolving, derived from the C3 re-observation watermark
+ * (`lastObservedAt`), `proofCount`, and `createdAt` over 30/90-day windows.
+ *
+ * We do not store a full observation-timestamp series — only first-seen,
+ * last-seen, and count — so density is approximated from that triple.
+ * Good enough for profile signals ("interests trending up") and vault
+ * hygiene badges; not a substitute for an observations tier (C5).
+ */
+/** Recent window — observations inside this count as "active". */
+declare const TREND_RECENT_WINDOW_DAYS = 30;
+/** Beyond this since last observation → stale. */
+declare const TREND_STALE_WINDOW_DAYS = 90;
+/**
+ * How a fact's evidence has been evolving.
+ *
+ * - `new` — first seen inside the recent window, few proofs yet.
+ * - `strengthening` — established fact re-observed recently (rising density).
+ * - `stable` — known for a while, still observed inside the stale window.
+ * - `weakening` — quiet for ≥30 and <90 days after having been observed.
+ * - `stale` — no observation in ≥90 days.
+ */
+type ObservationTrend = "new" | "strengthening" | "stable" | "weakening" | "stale";
+interface ObservationTrendInput {
+    createdAt: Date | number;
+    /**
+     * C3 re-observation watermark (Unix ms). When null/undefined, the fact
+     * has never been merged-into since the column landed — treat `createdAt`
+     * as last-seen.
+     */
+    lastObservedAt?: number | null;
+    /** Times this fact has been retained/merged. Defaults to 1. */
+    proofCount?: number | null;
+}
+/**
+ * Classify a vault fact's observation trend from its evidence timestamps.
+ *
+ * Pure + deterministic. Pass `now` for back-dated eval harnesses.
+ */
+declare function classifyObservationTrend(input: ObservationTrendInput, now?: number): ObservationTrend;
+/**
+ * Summarize trend counts over a set of facts — handy for profile synthesis
+ * ("N interests strengthening") without another LLM pass.
+ */
+declare function summarizeObservationTrends(inputs: readonly ObservationTrendInput[], now?: number): Record<ObservationTrend, number>;
+
 /**
  * Unified memory layer types — the Recall / Retain API.
  *
@@ -4975,6 +5028,16 @@ interface RankedMemory {
     proofCount?: number;
     source?: string;
     folderId?: string | null;
+    /**
+     * C3 re-observation watermark (Unix ms). Null/undefined when the fact
+     * has never been merge-reinforced since the column landed.
+     */
+    lastObservedAt?: number | null;
+    /**
+     * C2 observation-trend label derived from createdAt / lastObservedAt /
+     * proofCount over 30/90-day windows. Fact-only; omitted for chunks.
+     */
+    observationTrend?: ObservationTrend;
     /**
      * Anchored event-time for the fact (the date the underlying event
      * occurred, not the write time). When present, the recall executor
@@ -7228,6 +7291,12 @@ interface ProfileDoc {
     vaultWatermark: number;
     /** The config that produced this doc — see {@link ProfileConfigFingerprint}. */
     config: ProfileConfigFingerprint;
+    /**
+     * C2 — counts of observation-trend labels over live vault facts at
+     * synthesis time. Lets People Nearby surface "interests trending up"
+     * without another LLM pass. Recomputed every synthesis (not delta-cached).
+     */
+    observationTrends: Record<ObservationTrend, number>;
     /** Unix ms this doc was produced. */
     generatedAt: number;
 }
@@ -8724,4 +8793,4 @@ declare function refreshNotionAccessToken(params: NotionRefreshTokenParams): Pro
  */
 declare function createNotionTools(getAccessToken: () => string | null, requestNotionAccess: () => Promise<string>): ToolConfig[];
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, 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, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hardDeleteDecayedOp, hasEncryptionKey, injectionSignatureCatalog, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, 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, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hardDeleteDecayedOp, hasEncryptionKey, injectionSignatureCatalog, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };

package/dist/expo/index.d.ts

@@ -4885,6 +4885,10 @@ interface VaultSearchResult {
      * real timestamps. Omitted when an item lacks the field upstream. */
     createdAt?: Date;
     updatedAt?: Date;
+    /** Times this fact has been re-observed — for C2 trend labels. */
+    proofCount?: number | null;
+    /** C3 re-observation watermark (Unix ms) — for C2 trends + C4 CE dates. */
+    lastObservedAt?: number | null;
     /** W6 temporal-lane anchors carried through to downstream `RankedMemory`
      * so the recall executor can surface dates to the answer model without
      * a second per-fact DB lookup + decrypt. Unix ms; null when the fact
@@ -4926,6 +4930,55 @@ declare function searchVaultMemories(query: string, vaultCtx: VaultMemoryOperati
  */
 declare function createMemoryVaultSearchTool(vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): ToolConfig;
 
+/**
+ * C2 — Observation trend labels.
+ *
+ * Algorithmic (no LLM) classification of how a vault fact's evidence has
+ * been evolving, derived from the C3 re-observation watermark
+ * (`lastObservedAt`), `proofCount`, and `createdAt` over 30/90-day windows.
+ *
+ * We do not store a full observation-timestamp series — only first-seen,
+ * last-seen, and count — so density is approximated from that triple.
+ * Good enough for profile signals ("interests trending up") and vault
+ * hygiene badges; not a substitute for an observations tier (C5).
+ */
+/** Recent window — observations inside this count as "active". */
+declare const TREND_RECENT_WINDOW_DAYS = 30;
+/** Beyond this since last observation → stale. */
+declare const TREND_STALE_WINDOW_DAYS = 90;
+/**
+ * How a fact's evidence has been evolving.
+ *
+ * - `new` — first seen inside the recent window, few proofs yet.
+ * - `strengthening` — established fact re-observed recently (rising density).
+ * - `stable` — known for a while, still observed inside the stale window.
+ * - `weakening` — quiet for ≥30 and <90 days after having been observed.
+ * - `stale` — no observation in ≥90 days.
+ */
+type ObservationTrend = "new" | "strengthening" | "stable" | "weakening" | "stale";
+interface ObservationTrendInput {
+    createdAt: Date | number;
+    /**
+     * C3 re-observation watermark (Unix ms). When null/undefined, the fact
+     * has never been merged-into since the column landed — treat `createdAt`
+     * as last-seen.
+     */
+    lastObservedAt?: number | null;
+    /** Times this fact has been retained/merged. Defaults to 1. */
+    proofCount?: number | null;
+}
+/**
+ * Classify a vault fact's observation trend from its evidence timestamps.
+ *
+ * Pure + deterministic. Pass `now` for back-dated eval harnesses.
+ */
+declare function classifyObservationTrend(input: ObservationTrendInput, now?: number): ObservationTrend;
+/**
+ * Summarize trend counts over a set of facts — handy for profile synthesis
+ * ("N interests strengthening") without another LLM pass.
+ */
+declare function summarizeObservationTrends(inputs: readonly ObservationTrendInput[], now?: number): Record<ObservationTrend, number>;
+
 /**
  * Unified memory layer types — the Recall / Retain API.
  *
@@ -4975,6 +5028,16 @@ interface RankedMemory {
     proofCount?: number;
     source?: string;
     folderId?: string | null;
+    /**
+     * C3 re-observation watermark (Unix ms). Null/undefined when the fact
+     * has never been merge-reinforced since the column landed.
+     */
+    lastObservedAt?: number | null;
+    /**
+     * C2 observation-trend label derived from createdAt / lastObservedAt /
+     * proofCount over 30/90-day windows. Fact-only; omitted for chunks.
+     */
+    observationTrend?: ObservationTrend;
     /**
      * Anchored event-time for the fact (the date the underlying event
      * occurred, not the write time). When present, the recall executor
@@ -7228,6 +7291,12 @@ interface ProfileDoc {
     vaultWatermark: number;
     /** The config that produced this doc — see {@link ProfileConfigFingerprint}. */
     config: ProfileConfigFingerprint;
+    /**
+     * C2 — counts of observation-trend labels over live vault facts at
+     * synthesis time. Lets People Nearby surface "interests trending up"
+     * without another LLM pass. Recomputed every synthesis (not delta-cached).
+     */
+    observationTrends: Record<ObservationTrend, number>;
     /** Unix ms this doc was produced. */
     generatedAt: number;
 }
@@ -8724,4 +8793,4 @@ declare function refreshNotionAccessToken(params: NotionRefreshTokenParams): Pro
  */
 declare function createNotionTools(getAccessToken: () => string | null, requestNotionAccess: () => Promise<string>): ToolConfig[];
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, 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, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hardDeleteDecayedOp, hasEncryptionKey, injectionSignatureCatalog, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, 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, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hardDeleteDecayedOp, hasEncryptionKey, injectionSignatureCatalog, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };

package/dist/expo/index.mjs

@@ -12,6 +12,8 @@ import {
   NODE_BUDGET,
   RerankerUnavailableError,
   TOPICS_EXTRACTION_VERSION,
+  TREND_RECENT_WINDOW_DAYS,
+  TREND_STALE_WINDOW_DAYS,
   VAULT_SIZE_HOP_CAP,
   archiveVaultMemoryOp,
   assertVaultScopeForSweep,
@@ -19,6 +21,7 @@ import {
   chunkAndEmbedAllMessages,
   chunkAndEmbedMessage,
   chunkText,
+  classifyObservationTrend,
   clearAllEncryptionKeys,
   clearAllEncryptionState,
   clearEncryptionKey,
@@ -87,6 +90,7 @@ import {
   shouldChunkMessage,
   stampTopicsExtractedAtOp,
   stripToolCalls,
+  summarizeObservationTrends,
   supersedeVaultMemoryOp,
   traverseGraphLane,
   updateConversationPinnedOp,
@@ -99,7 +103,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-EIHIZ5L4.mjs";
+} from "./chunk-7TATXBC5.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,
@@ -8604,6 +8608,13 @@ async function synthesizeProfile(ctx, options = {}) {
     includeSuperseded: true
   });
   const watermark = computeVaultWatermark(memories);
+  const observationTrends = summarizeObservationTrends(
+    memories.filter((m) => !m.isDeleted && m.supersededBy === null).map((m) => ({
+      createdAt: m.createdAt,
+      lastObservedAt: m.lastObservedAt,
+      proofCount: m.proofCount
+    }))
+  );
   const presentIds = new Set(memories.map((m) => m.uniqueId));
   const hasStaleSections = previous?.sections.some((s) => s.stale);
   const citesMissingFact = previous?.sections.some(
@@ -8611,10 +8622,14 @@ async function synthesizeProfile(ctx, options = {}) {
   );
   if (previous && previous.vaultWatermark === watermark && !hasStaleSections && !citesMissingFact) {
     const sameOrder = previous.sections.length === facets.length && facets.every((f, i) => previous.sections[i]?.key === f.key);
-    if (sameOrder) return previous;
+    if (sameOrder) {
+      if (trendsEqual(previous.observationTrends, observationTrends)) return previous;
+      return { ...previous, observationTrends };
+    }
     return {
       ...previous,
-      sections: facets.map((f) => previous.sections.find((s) => s.key === f.key))
+      sections: facets.map((f) => previous.sections.find((s) => s.key === f.key)),
+      observationTrends
     };
   }
   const staleKeys = await computeStaleFacetKeys(ctx, memories, facets, previous, watermark);
@@ -8647,6 +8662,7 @@ async function synthesizeProfile(ctx, options = {}) {
     sections,
     vaultWatermark: watermark,
     config,
+    observationTrends,
     generatedAt: Date.now()
   };
 }
@@ -8657,6 +8673,10 @@ function configMatches(a, b) {
 function facetsSignature(facets) {
   return facets.map((f) => JSON.stringify([f.key, f.label, f.query, f.guidance])).sort().join("\n");
 }
+function trendsEqual(a, b) {
+  if (!a) return false;
+  return a.new === b.new && a.strengthening === b.strengthening && a.stable === b.stable && a.weakening === b.weakening && a.stale === b.stale;
+}
 function changeTime(m) {
   return Math.max(m.updatedAt.getTime(), m.supersededAt ?? 0, m.lastObservedAt ?? 0);
 }
@@ -14375,6 +14395,8 @@ export {
   StreamExpiredError,
   TOPICS_EXTRACTION_VERSION,
   TOPIC_EXTRACTION_BATCH_SIZE,
+  TREND_RECENT_WINDOW_DAYS,
+  TREND_STALE_WINDOW_DAYS,
   VAULT_SIZE_HOP_CAP,
   WalletPoller,
   addConversationMemoriesOp,
@@ -14390,6 +14412,7 @@ export {
   classifyCryptoPriceBatch,
   classifyDecay,
   classifyInjectionCandidates,
+  classifyObservationTrend,
   classifyStockPrice,
   classifyStockPriceBatch,
   classifyWeather,
@@ -14489,6 +14512,7 @@ export {
   stampTopicsExtractedAtOp,
   streamCancelPath,
   streamReplayPath,
+  summarizeObservationTrends,
   supersedeVaultMemoryOp,
   synthesizeProfile,
   traverseGraphLane,

package/dist/expo/{recall-C3LJ5R2E.mjs → recall-IO4KJ5W7.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-EIHIZ5L4.mjs";
+} from "./chunk-7TATXBC5.mjs";
 import "./chunk-DFVCS3QQ.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {

package/dist/react/{chunk-PWTWECXY.mjs → chunk-DDHTJGZN.mjs}

@@ -3564,11 +3564,20 @@ async function getModel() {
 function sigmoid(x) {
   return 1 / (1 + Math.exp(-x));
 }
+function formatRerankDoc(content, dateMs) {
+  if (dateMs === null || dateMs === void 0 || !Number.isFinite(dateMs)) return content;
+  const d = new Date(dateMs);
+  if (!Number.isFinite(d.getTime())) return content;
+  const yyyy = d.getFullYear();
+  const mm = String(d.getMonth() + 1).padStart(2, "0");
+  const dd = String(d.getDate()).padStart(2, "0");
+  return `[Date: ${yyyy}-${mm}-${dd}] ${content}`;
+}
 async function rerankPairs(query, items) {
   if (items.length === 0 || !query) return [];
   const { tokenizer, model } = await getModel();
   const queries = items.map(() => query);
-  const docs = items.map((i) => i.content);
+  const docs = items.map((i) => formatRerankDoc(i.content, i.dateMs));
   const tokenize2 = tokenizer;
   const inputs = tokenize2(queries, { text_pair: docs, padding: true, truncation: true });
   const forward = model;
@@ -3917,6 +3926,23 @@ function createVaultEmbeddingCache(maxSize = DEFAULT_VAULT_CACHE_SIZE) {
 function normalizeEventTimeKind(kind) {
   return kind === "point" || kind === "range" || kind === "ongoing" ? kind : null;
 }
+function rerankDateMs(item) {
+  if (item.eventTimeStart !== null && item.eventTimeStart !== void 0 && Number.isFinite(item.eventTimeStart) && item.eventTimeStart > 0) {
+    return item.eventTimeStart;
+  }
+  if (item.lastObservedAt !== null && item.lastObservedAt !== void 0 && Number.isFinite(item.lastObservedAt) && item.lastObservedAt > 0) {
+    return item.lastObservedAt;
+  }
+  const updatedMs = item.updatedAt?.getTime();
+  if (updatedMs !== null && updatedMs !== void 0 && Number.isFinite(updatedMs) && updatedMs > 0) {
+    return updatedMs;
+  }
+  const createdMs = item.createdAt?.getTime();
+  if (createdMs !== null && createdMs !== void 0 && Number.isFinite(createdMs) && createdMs > 0) {
+    return createdMs;
+  }
+  return void 0;
+}
 var SUPERSESSION_SIMILARITY_THRESHOLD = 0.7;
 var SUPERSESSION_MIN_AGE_GAP_MS = 30 * 24 * 60 * 60 * 1e3;
 var SUPERSESSION_BOOST_FACTOR = 0.8;
@@ -4123,6 +4149,7 @@ async function rankFusedVaultMemoriesAsync(query, queryEmbedding, items, options
   }
   let combined;
   let tailSlice = [];
+  const itemById = new Map(items.map((i) => [i.id, i]));
   if (options?.rerank) {
     const rerankTopN = options.rerankTopN ?? 30;
     const ceWeight = options.ceWeight ?? 0.1;
@@ -4130,7 +4157,12 @@ async function rankFusedVaultMemoriesAsync(query, queryEmbedding, items, options
     try {
       const reranked = await rerankPairs(
         query,
-        headSlice.map((r) => ({ id: r.uniqueId, content: r.content }))
+        headSlice.map((r) => ({
+          id: r.uniqueId,
+          content: r.content,
+          // C4: date-prefix the CE doc so temporal alignment influences rank.
+          dateMs: rerankDateMs(itemById.get(r.uniqueId) ?? r)
+        }))
       );
       tailSlice = v2Ranked.slice(rerankTopN);
       const v2ScoreById = new Map(headSlice.map((r) => [r.uniqueId, r.similarity]));
@@ -4165,11 +4197,11 @@ async function rankFusedVaultMemoriesAsync(query, queryEmbedding, items, options
     const fused = rrfFuse([headIds, headIds, ...sideLanesAsync], options?.rrfK);
     const fusedHead = combined.map((r) => ({ ...r, similarity: fused.get(r.uniqueId) ?? r.similarity })).sort((a, b) => b.similarity - a.similarity);
     const seen = new Set(combined.map((r) => r.uniqueId));
-    const itemById = new Map(items.map((i) => [i.id, i]));
+    const itemById2 = new Map(items.map((i) => [i.id, i]));
     for (const lane of sideLanesAsync) {
       for (const id of lane) {
         if (seen.has(id)) continue;
-        const it = itemById.get(id);
+        const it = itemById2.get(id);
         if (!it) continue;
         fusedHead.push({
           uniqueId: id,
@@ -4188,11 +4220,11 @@ async function rankFusedVaultMemoriesAsync(query, queryEmbedding, items, options
   if (options?.mmr) {
     const lambda = options.mmrLambda ?? 0.7;
     const mmrTopN = options.mmrTopN ?? 20;
-    const itemById = new Map(items.map((i) => [i.id, i]));
+    const itemById2 = new Map(items.map((i) => [i.id, i]));
     const mmrCandidates = combined.slice(0, mmrTopN).map((r) => ({
       id: r.uniqueId,
       score: r.similarity,
-      embedding: itemById.get(r.uniqueId)?.embedding ?? [],
+      embedding: itemById2.get(r.uniqueId)?.embedding ?? [],
       content: r.content
     }));
     const picked = applyMMR(mmrCandidates, limit, lambda);
@@ -4314,7 +4346,12 @@ async function rankComposite(originalQuery, originalQueryEmbedding, subQueries,
     try {
       const reranked = await rerankPairs(
         originalQuery,
-        headSlice.map((r) => ({ id: r.uniqueId, content: r.content }))
+        headSlice.map((r) => ({
+          id: r.uniqueId,
+          content: r.content,
+          // C4: date-prefix the CE doc so temporal alignment influences rank.
+          dateMs: rerankDateMs(itemById.get(r.uniqueId) ?? r)
+        }))
       );
       const ceById = new Map(reranked.map((r) => [r.id, r.score]));
       const head = headSlice.map((r) => ({
@@ -4501,6 +4538,7 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
     createdAt: m.createdAt,
     updatedAt: m.updatedAt,
     proofCount: m.proofCount,
+    lastObservedAt: m.lastObservedAt,
     eventTimeStart: m.eventTimeStart,
     sourceChunkIds: m.sourceChunkIds,
     eventTimeEnd: m.eventTimeEnd,
@@ -4517,13 +4555,27 @@ async function searchVaultMemoriesWithSize(query, vaultCtx, embeddingOptions, ca
       );
     }
   }
-  const timestampById = new Map(
-    memories.map((m) => [m.uniqueId, { createdAt: m.createdAt, updatedAt: m.updatedAt }])
+  const metaById = new Map(
+    memories.map((m) => [
+      m.uniqueId,
+      {
+        createdAt: m.createdAt,
+        updatedAt: m.updatedAt,
+        proofCount: m.proofCount,
+        lastObservedAt: m.lastObservedAt
+      }
+    ])
   );
   const stampTimestamps = (out) => {
     const results2 = out.results.map((r) => {
-      const ts = timestampById.get(r.uniqueId);
-      return ts ? { ...r, createdAt: ts.createdAt, updatedAt: ts.updatedAt } : r;
+      const meta = metaById.get(r.uniqueId);
+      return meta ? {
+        ...r,
+        createdAt: meta.createdAt,
+        updatedAt: meta.updatedAt,
+        proofCount: meta.proofCount,
+        lastObservedAt: meta.lastObservedAt
+      } : r;
     });
     return {
       results: results2,
@@ -4717,7 +4769,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-FZVV5XUU.mjs");
+        const { recall: recall2 } = await import("./recall-OPKHWKZX.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },
@@ -4981,6 +5033,42 @@ Which should be expanded?`,
   };
 }
 
+// src/lib/memory/observationTrend.ts
+var DAY_MS2 = 1e3 * 60 * 60 * 24;
+var TREND_RECENT_WINDOW_DAYS = 30;
+var TREND_STALE_WINDOW_DAYS = 90;
+function toMs(value) {
+  return value instanceof Date ? value.getTime() : value;
+}
+function classifyObservationTrend(input, now = Date.now()) {
+  const createdMs = toMs(input.createdAt);
+  if (!Number.isFinite(createdMs) || !Number.isFinite(now)) return "stable";
+  const lastMsRaw = input.lastObservedAt;
+  const lastMs = lastMsRaw !== null && lastMsRaw !== void 0 && Number.isFinite(lastMsRaw) ? Math.max(createdMs, lastMsRaw) : createdMs;
+  const proofs = Math.max(1, input.proofCount ?? 1);
+  const ageDays = Math.max(0, (now - createdMs) / DAY_MS2);
+  const daysSinceLast = Math.max(0, (now - lastMs) / DAY_MS2);
+  if (daysSinceLast >= TREND_STALE_WINDOW_DAYS) return "stale";
+  if (daysSinceLast >= TREND_RECENT_WINDOW_DAYS) return "weakening";
+  if (ageDays <= TREND_RECENT_WINDOW_DAYS && proofs <= 2) return "new";
+  if (proofs >= 3) return "strengthening";
+  if (proofs >= 2 && ageDays > TREND_RECENT_WINDOW_DAYS) return "strengthening";
+  return "stable";
+}
+function summarizeObservationTrends(inputs, now = Date.now()) {
+  const counts = {
+    new: 0,
+    strengthening: 0,
+    stable: 0,
+    weakening: 0,
+    stale: 0
+  };
+  for (const input of inputs) {
+    counts[classifyObservationTrend(input, now)]++;
+  }
+  return counts;
+}
+
 // src/lib/memory/queryTemporal.ts
 var RELATIVE_DAY_ENTRIES = [
   [/\btoday\b/, "today", 0],
@@ -5375,7 +5463,7 @@ async function recall(query, ctx, options = {}) {
   const fuseStart = nowMs();
   if (types.length === 1 || factResults.length === 0 || chunkResults.length === 0) {
     const memories2 = [
-      ...factResults.map(toFactMemory),
+      ...factResults.map((r) => toFactMemory(r, options.now)),
       ...chunkResults.map(toChunkMemory)
     ];
     memories2.sort((a, b) => b.score - a.score);
@@ -5396,7 +5484,7 @@ async function recall(query, ctx, options = {}) {
   const fused = rrfFuse([factRanking, chunkRanking], options.rrfK);
   const byId = /* @__PURE__ */ new Map();
   for (const r of factResults) {
-    const m = toFactMemory(r);
+    const m = toFactMemory(r, options.now);
     m.score = fused.get(`fact:${r.uniqueId}`) ?? 0;
     if (!m.scoreBreakdown) m.scoreBreakdown = {};
     m.scoreBreakdown.fused = r.similarity;
@@ -5445,7 +5533,10 @@ async function recall(query, ctx, options = {}) {
     ...vaultSize !== void 0 && { vaultSize }
   };
 }
-function toFactMemory(r) {
+function toFactMemory(r, now) {
+  const createdAt = r.createdAt ?? /* @__PURE__ */ new Date(0);
+  const proofCount = r.proofCount ?? void 0;
+  const lastObservedAt = r.lastObservedAt ?? null;
   return {
     id: r.uniqueId,
     kind: "fact",
@@ -5461,6 +5552,18 @@ function toFactMemory(r) {
     // (and UI reading them) carry the fact's type. Undefined when untyped.
     ...r.factType !== void 0 && { factType: r.factType },
     ...r.sourceChunkIds !== void 0 && r.sourceChunkIds !== null && { sourceChunkIds: r.sourceChunkIds },
+    ...proofCount !== void 0 && proofCount !== null && { proofCount },
+    ...lastObservedAt !== null && { lastObservedAt },
+    // C2 — algorithmic trend from evidence timestamps (no LLM). Honor
+    // RecallOptions.now so back-dated eval harnesses get consistent labels.
+    observationTrend: classifyObservationTrend(
+      {
+        createdAt,
+        lastObservedAt,
+        proofCount
+      },
+      now ?? Date.now()
+    ),
     // r.similarity from searchVaultMemoriesWithSize is the fused score
     // (cosine + BM25 + RRF + recency + proof) when useFusion=true (the
     // default) and pure cosine when useFusion=false. The breakdown
@@ -5469,7 +5572,7 @@ function toFactMemory(r) {
     content: r.content,
     score: r.similarity,
     scoreBreakdown: { fused: r.similarity },
-    createdAt: r.createdAt ?? /* @__PURE__ */ new Date(0),
+    createdAt,
     updatedAt: r.updatedAt ?? /* @__PURE__ */ new Date(0)
   };
 }
@@ -5663,6 +5766,10 @@ export {
   capHopsForDensity,
   traverseGraphLane,
   createLlmNeighborRefiner,
+  TREND_RECENT_WINDOW_DAYS,
+  TREND_STALE_WINDOW_DAYS,
+  classifyObservationTrend,
+  summarizeObservationTrends,
   recall,
   preEmbedVaultMemories,
   eagerEmbedContent,