@anuma/sdk 3.4.0 → 3.6.0

package/dist/expo/index.d.ts

@@ -4887,7 +4887,7 @@ interface VaultSearchResult {
     updatedAt?: Date;
     /** Times this fact has been re-observed — for C2 trend labels. */
     proofCount?: number | null;
-    /** C3 re-observation watermark (Unix ms) — for C2 trend labels. */
+    /** 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
@@ -7001,6 +7001,66 @@ interface LlmNeighborRefinerOptions extends PortalLlmAuth {
  */
 declare function createLlmNeighborRefiner(options: LlmNeighborRefinerOptions): NeighborRefiner;
 
+/**
+ * Profile salience — profile-worthiness scoring for vault facts (#706).
+ *
+ * Distinct from query-time relevance (`recall` fusion). Answers: "is this
+ * fact worth putting on a shareable profile?" using durable type, proof
+ * density, and C2 observation trend. Pure + deterministic — no LLM, no DB.
+ *
+ * Used by:
+ * - `synthesizeProfile` facet recall (default factTypeWeights)
+ * - Publish-review UIs via {@link rankProfileCandidates} (nearby / client)
+ *
+ * Persisted `importance` is deferred until publish flow proves the need.
+ */
+
+/** Proof-count curve weight inside {@link scoreProfileSalience}. */
+declare const DEFAULT_PROFILE_PROOF_ALPHA = 0.2;
+/**
+ * Per-FactType multipliers for profile synthesis / salience.
+ * Durable identity-class types (never age-archive in decay) rank higher;
+ * ephemeral plan/ongoing_context rank lower. Untyped / `other` stay neutral.
+ */
+declare const DEFAULT_PROFILE_FACT_TYPE_WEIGHTS: Partial<Record<FactType, number>>;
+/** C2 trend multipliers for profile-worthiness. */
+declare const DEFAULT_PROFILE_TREND_MULTIPLIERS: Record<ObservationTrend, number>;
+interface ProfileSalienceInput extends ObservationTrendInput {
+    /** Vault memory id — required for {@link rankProfileCandidates}. */
+    id: string;
+    /** Extractor FactType; null/undefined → neutral weight (1.0). */
+    factType?: string | null;
+}
+interface RankedProfileCandidate {
+    id: string;
+    score: number;
+    trend: ObservationTrend;
+    factType?: string | null;
+    proofCount: number;
+}
+interface ScoreProfileSalienceOptions {
+    /** Override type weights (merged over {@link DEFAULT_PROFILE_FACT_TYPE_WEIGHTS}). */
+    factTypeWeights?: Partial<Record<FactType, number>>;
+    /** Override trend multipliers. */
+    trendMultipliers?: Partial<Record<ObservationTrend, number>>;
+    /** Proof-count α. Default: {@link DEFAULT_PROFILE_PROOF_ALPHA}. */
+    proofCountAlpha?: number;
+}
+/**
+ * Score a vault fact for profile-worthiness.
+ *
+ * `typeWeight * (1 + α·log(1+proofCount) − α·log(2)) * trendMultiplier`
+ *
+ * The proof term mirrors vault fusion's log curve (neutral at proofCount=1).
+ * Pass `now` for deterministic evals.
+ */
+declare function scoreProfileSalience(input: ProfileSalienceInput, now?: number, options?: ScoreProfileSalienceOptions): number;
+/**
+ * Rank vault facts by profile-worthiness (descending score).
+ * Ties broken by higher proofCount, then id ascending for stability.
+ */
+declare function rankProfileCandidates(inputs: readonly ProfileSalienceInput[], now?: number, options?: ScoreProfileSalienceOptions): RankedProfileCandidate[];
+
 /**
  * Unified Recall API — single retrieval surface above vault + engine.
  *
@@ -7138,6 +7198,12 @@ interface ReflectOptions extends RecallOptions, PortalLlmAuth {
     fetchFn?: typeof fetch;
     /** Optional JSON Schema to coerce structured outputs. */
     responseSchema?: Record<string, unknown>;
+    /**
+     * Skip Stage-1 {@link recall} and synthesize from these memories instead.
+     * Used by `synthesizeProfile` after intersecting recall with a
+     * `reviewedMemoryIds` gate so the LLM never sees unreviewed evidence.
+     */
+    memories?: RankedMemory[];
 }
 interface ReflectResult {
     /** The synthesized answer text. */
@@ -7261,8 +7327,9 @@ interface ProfileSection {
 /** Fingerprint of the config that produced a {@link ProfileDoc}. Delta reuse
  * (both the wholesale fast path and per-section reuse) is only valid when the
  * current call's config matches — otherwise reused sections could carry the
- * wrong scope's evidence, un-redacted text under a now-present redactor, or an
- * old section shape. */
+ * wrong scope's evidence, un-redacted text under a now-present redactor, an
+ * old section shape, or text grounded in memory ids that are no longer in the
+ * publish-review set. */
 interface ProfileConfigFingerprint {
     /** Facet keys present in the doc, sorted. */
     facetKeys: ProfileFacetKey[];
@@ -7277,6 +7344,14 @@ interface ProfileConfigFingerprint {
     /** Whether a PII redactor gated the section text. Reusing un-gated text under
      * a now-present redactor would leak PII, so this flips the fingerprint. */
     redacted: boolean;
+    /**
+     * Order-independent digest of {@link SynthesizeProfileOptions.reviewedMemoryIds}.
+     * Empty string when the review gate is off (omit / empty array). Changing the
+     * set must invalidate reuse — otherwise a narrowed review keeps text grounded
+     * in unreviewed ids, and a widened review leaves previously-cleared sections
+     * empty.
+     */
+    reviewedMemoryIdsSignature: string;
 }
 /** A synthesized profile. Server-authoritative once published; the client
  * caches it and passes it back as {@link SynthesizeProfileOptions.previous}. */
@@ -7322,6 +7397,24 @@ interface SynthesizeProfileOptions extends PortalLlmAuth {
      * Omit only when the caller redacts downstream — `nearby` also moderates
      * server-side, but the client should never publish un-gated text. */
     redactor?: PiiRedactor;
+    /**
+     * Per-FactType score multipliers for facet recall. Default:
+     * {@link DEFAULT_PROFILE_FACT_TYPE_WEIGHTS} (durable types boosted).
+     * Does not change global chat `recall()` defaults.
+     */
+    factTypeWeights?: Partial<Record<FactType, number>>;
+    /**
+     * Proof-count α for facet recall. Default: {@link DEFAULT_PROFILE_PROOF_ALPHA}
+     * (0.2). Chat recall stays at 0.1.
+     */
+    proofCountAlpha?: number;
+    /**
+     * When non-empty, intersect each facet's recalled evidence with this id set
+     * before the LLM runs (publish-review gate). Empty intersection → empty
+     * section (legitimate no-evidence), not a stale fallback. Omit / empty →
+     * no gate.
+     */
+    reviewedMemoryIds?: readonly string[];
 }
 /**
  * Synthesize a shareable {@link ProfileDoc} from the user's vault, on-device.
@@ -8793,4 +8886,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, 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 };
+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_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, 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 ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, 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 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 ScoreProfileSalienceOptions, 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, rankProfileCandidates, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, 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

@@ -103,7 +103,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-C7PGRFBG.mjs";
+} from "./chunk-7TATXBC5.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,
@@ -8174,6 +8174,61 @@ function createDecaySweeper(options) {
   };
 }
 
+// src/lib/memory/profileSalience.ts
+var DEFAULT_PROFILE_PROOF_ALPHA = 0.2;
+var DEFAULT_PROFILE_FACT_TYPE_WEIGHTS = {
+  identity: 1.5,
+  preference: 1.5,
+  relationship: 1.5,
+  constraint: 1.5,
+  other: 1,
+  plan: 0.6,
+  ongoing_context: 0.6
+};
+var DEFAULT_PROFILE_TREND_MULTIPLIERS = {
+  strengthening: 1.25,
+  new: 1.1,
+  stable: 1,
+  weakening: 0.75,
+  stale: 0.5
+};
+function typeWeight(factType, weights) {
+  if (!factType) return 1;
+  const w = weights[factType];
+  if (w !== void 0 && Number.isFinite(w) && w > 0) return w;
+  return 1;
+}
+function scoreProfileSalience(input, now = Date.now(), options = {}) {
+  const alpha = options.proofCountAlpha ?? DEFAULT_PROFILE_PROOF_ALPHA;
+  const typeWeights = { ...DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, ...options.factTypeWeights };
+  const trendMults = { ...DEFAULT_PROFILE_TREND_MULTIPLIERS, ...options.trendMultipliers };
+  const proofs = Math.max(1, input.proofCount ?? 1);
+  const proofBoost = 1 + alpha * Math.log(1 + proofs) - alpha * Math.log(2);
+  const trend = classifyObservationTrend(input, now);
+  const tw = typeWeight(input.factType, typeWeights);
+  const tm = trendMults[trend] ?? 1;
+  const score = tw * proofBoost * tm;
+  return Number.isFinite(score) ? score : 0;
+}
+function rankProfileCandidates(inputs, now = Date.now(), options = {}) {
+  const ranked = inputs.map((input) => {
+    const proofs = Math.max(1, input.proofCount ?? 1);
+    return {
+      id: input.id,
+      score: scoreProfileSalience(input, now, options),
+      trend: classifyObservationTrend(input, now),
+      factType: input.factType ?? null,
+      proofCount: proofs
+    };
+  });
+  ranked.sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    if (b.proofCount !== a.proofCount) return b.proofCount - a.proofCount;
+    return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  });
+  return ranked;
+}
+
 // src/lib/memory/recallConstants.ts
 var RECALL_TOOL_NAME = "recall_memory";
 var RECALL_MAX_LIMIT = 50;
@@ -8398,18 +8453,18 @@ async function reflect(query, ctx, options) {
     usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 }
   };
   if (trimmed.length === 0) return empty;
-  const { maxTokens: _llmMaxTokens, ...recallOptions } = options;
-  const recalled = await recall(trimmed, ctx, recallOptions);
-  const memoryIds = recalled.memories.map((m) => m.id);
+  const { maxTokens: _llmMaxTokens, memories: providedMemories, ...recallOptions } = options;
+  const recalledMemories = providedMemories !== void 0 ? providedMemories : (await recall(trimmed, ctx, recallOptions)).memories;
+  const memoryIds = recalledMemories.map((m) => m.id);
   const baseResult = {
     text: "",
     basedOn: { memoryIds },
     usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 }
   };
-  if (recalled.memories.length === 0) {
+  if (recalledMemories.length === 0) {
     return baseResult;
   }
-  const evidence = recalled.memories.map((m, i) => `[${i + 1}] (id: ${m.id}, kind: ${m.kind})
+  const evidence = recalledMemories.map((m, i) => `[${i + 1}] (id: ${m.id}, kind: ${m.kind})
 ${m.content}`).join("\n\n");
   const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
   const model = options.llmModel ?? DEFAULT_MODEL3;
@@ -8595,7 +8650,8 @@ async function synthesizeProfile(ctx, options = {}) {
     facetKeys: facets.map((f) => f.key).sort(),
     facetsSignature: facetsSignature(facets),
     scopes: [...scopes].sort(),
-    redacted: options.redactor !== void 0
+    redacted: options.redactor !== void 0,
+    reviewedMemoryIdsSignature: reviewedMemoryIdsSignature(options.reviewedMemoryIds)
   };
   const previous = options.previous && options.previous.version === PROFILE_DOC_VERSION && configMatches(options.previous.config, config) ? options.previous : void 0;
   const memories = await getAllVaultMemoriesOp(ctx.vaultCtx, {
@@ -8668,7 +8724,11 @@ async function synthesizeProfile(ctx, options = {}) {
 }
 function configMatches(a, b) {
   if (!a) return false;
-  return a.redacted === b.redacted && a.facetsSignature === b.facetsSignature && a.scopes.length === b.scopes.length && a.scopes.every((s, i) => s === b.scopes[i]);
+  return a.redacted === b.redacted && a.facetsSignature === b.facetsSignature && (a.reviewedMemoryIdsSignature ?? "") === b.reviewedMemoryIdsSignature && a.scopes.length === b.scopes.length && a.scopes.every((s, i) => s === b.scopes[i]);
+}
+function reviewedMemoryIdsSignature(ids) {
+  if (ids === void 0 || ids.length === 0) return "";
+  return [...new Set(ids)].sort().join("\n");
 }
 function facetsSignature(facets) {
   return facets.map((f) => JSON.stringify([f.key, f.label, f.query, f.guidance])).sort().join("\n");
@@ -8772,18 +8832,46 @@ async function attributeFacts(ctx, candidates, facets) {
   return keys;
 }
 async function synthesizeFacet(facet, ctx, options, prior) {
+  const scopes = options.scopes ?? DEFAULT_SCOPES;
+  const limit = options.limit ?? DEFAULT_FACET_RECALL_LIMIT;
+  const factTypeWeights = { ...DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, ...options.factTypeWeights };
+  const proofCountAlpha = options.proofCountAlpha ?? DEFAULT_PROFILE_PROOF_ALPHA;
+  const reviewed = options.reviewedMemoryIds;
+  const hasReviewGate = reviewed !== void 0 && reviewed.length > 0;
+  const recalled = await recall(facet.query, ctx, {
+    scopes,
+    limit: hasReviewGate ? RECALL_MAX_LIMIT : limit,
+    types: ["fact"],
+    factTypeWeights,
+    proofCountAlpha
+  });
+  let memories = recalled.memories;
+  if (hasReviewGate) {
+    const allowed = new Set(reviewed);
+    memories = memories.filter((m) => allowed.has(m.id)).slice(0, limit);
+  }
+  if (memories.length === 0) {
+    return {
+      key: facet.key,
+      label: facet.label,
+      text: "",
+      sourceMemoryIds: [],
+      generatedAt: Date.now()
+    };
+  }
   const result = await reflect(facet.query, ctx, {
     apiKey: options.apiKey,
     getToken: options.getToken,
     llmModel: options.llmModel ?? DEFAULT_SYNTHESIS_MODEL,
     baseUrl: options.baseUrl,
     fetchFn: options.fetchFn,
-    scopes: options.scopes ?? DEFAULT_SCOPES,
-    limit: options.limit ?? DEFAULT_FACET_RECALL_LIMIT,
+    scopes,
+    limit,
     types: ["fact"],
     maxTokens: DEFAULT_FACET_MAX_TOKENS,
     systemPrompt: buildFacetSystemPrompt(facet),
-    responseSchema: FACET_RESPONSE_SCHEMA
+    responseSchema: FACET_RESPONSE_SCHEMA,
+    memories
   });
   const noEvidence = result.basedOn.memoryIds.length === 0;
   const { text: text12, legitimateEmpty } = extractFacetText(result.structuredOutput);
@@ -14368,6 +14456,9 @@ export {
   DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP,
   DEFAULT_MIN_CHUNK_SIZE,
   DEFAULT_PROFILE_FACETS,
+  DEFAULT_PROFILE_FACT_TYPE_WEIGHTS,
+  DEFAULT_PROFILE_PROOF_ALPHA,
+  DEFAULT_PROFILE_TREND_MULTIPLIERS,
   DEFAULT_VAULT_CACHE_SIZE,
   DatabaseManager,
   ENTITY_FANOUT,
@@ -14493,6 +14584,7 @@ export {
   preEmbedVaultMemories,
   quantizeEmbedding,
   queueManager,
+  rankProfileCandidates,
   recall,
   reflect,
   refreshNotionAccessToken,
@@ -14502,6 +14594,7 @@ export {
   restoreVaultMemoryOp,
   resumeStream,
   retain,
+  scoreProfileSalience,
   screenCandidatesForInjection,
   sdkMigrations,
   sdkModelClasses,

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

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

package/dist/react/{chunk-CGC3UJHM.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) => ({
@@ -4732,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-OTUNGQHQ.mjs");
+        const { recall: recall2 } = await import("./recall-OPKHWKZX.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },