@anuma/sdk 6.37.0 → 6.38.0

package/dist/expo/index.d.ts

@@ -7065,6 +7065,10 @@ interface RankableVaultMemory {
      * required. `vaultMemoryRawToRankable` still always sets it. */
     lastObservedAt?: number | null;
 }
+/** @public */
+interface VaultMemoryProjection extends RankableVaultMemory {
+    topicsUserManaged: boolean;
+}
 /**
  * A photo a server-extracted memory came from, as
  * GET /api/memories/published returns it in `media[]`.
@@ -9090,7 +9094,7 @@ interface MemoryListOptions {
  * passing provenance, trust or publication metadata through manual creation.
  * @public
  */
-type MemoryCreate = Pick<CreateVaultMemoryOptions, "content" | "scope" | "factType" | "eventTime" | "embedding" | "embeddingModel" | "geohash">;
+type MemoryCreate = Pick<CreateVaultMemoryOptions, "content" | "scope" | "factType" | "eventTime" | "embedding" | "embeddingModel" | "geohash" | "kind" | "kindValue" | "level">;
 /**
  * The edits an app makes to an existing memory. Deliberately narrower than
  * {@link UpdateVaultMemoryOptions}: the re-observation knobs (`proofCountIncrement`,
@@ -9106,7 +9110,7 @@ type MemoryCreate = Pick<CreateVaultMemoryOptions, "content" | "scope" | "factTy
  * `embedding` (with `embeddingModel`) only when you already have the new one.
  * @public
  */
-type MemoryUpdate = Pick<UpdateVaultMemoryOptions, "content" | "scope" | "factType" | "eventTime" | "embedding" | "embeddingModel">;
+type MemoryUpdate = Pick<UpdateVaultMemoryOptions, "content" | "scope" | "factType" | "eventTime" | "embedding" | "embeddingModel" | "kind" | "kindValue" | "level">;
 /**
  * Fact-only recall. Conversation chunks are message storage, not memory, so
  * the chunk-lane knobs are not part of this surface; nor is `folderId` (see
@@ -9132,6 +9136,15 @@ type MemoryRecallOptions = Omit<RecallOptions, "types" | "includeChunks" | "conv
  * @public
  */
 type MemoryRetainOptions = Omit<RetainOptions, "folderId">;
+/**
+ * A topic and how many memories link to it.
+ * @public
+ */
+interface MemoryTopic {
+    name: string;
+    kind: string | null;
+    memoryCount: number;
+}
 /** @public */
 interface MemorySubscribeOptions {
     /**
@@ -9213,6 +9226,10 @@ interface MemoryStore {
     memoriesByTopics(names: readonly string[]): Promise<Map<string, Set<string>>>;
     /** Memory id → its canonical (lowercased) topic names. Unlinked ids are absent. */
     topicsByMemories(memoryIds: readonly string[]): Promise<Map<string, Set<string>>>;
+    /** Every topic by canonical name, with its kind and linked-memory count. */
+    listTopics(): Promise<MemoryTopic[]>;
+    /** The memories {@link MemoryStore.list} would return, without decrypting content. */
+    listProjections(options?: MemoryListOptions): Promise<VaultMemoryProjection[]>;
     /** Manual save; missing embeddings are filled in the background. */
     create(input: MemoryCreate): Promise<StoredVaultMemory>;
     /** One write for a batch of manual saves; migration/restore uses lower-level operations. */
@@ -9400,6 +9417,15 @@ interface RemoteMemoryQueryOptions extends RemoteMemoryReadFilters {
 interface RemoteMemoryQueryPage extends RemoteMemoryPage {
     changes_cursor?: string;
 }
+interface RemoteMemoryMetadataRecord {
+    memory: Omit<RemoteMemoryRow, "content" | "kind_value">;
+    version: number;
+    server_updated_at: string;
+}
+interface RemoteMemoryMetadataPage {
+    items: RemoteMemoryMetadataRecord[];
+    next_cursor?: string;
+}
 interface RemoteMemoryCandidateOptions extends RemoteMemoryReadFilters {
     scopes?: string[];
     memory_ids?: string[];
@@ -9444,6 +9470,10 @@ interface RemoteMemoryPersistence {
     /** One stable memory-id page; follow next_cursor to enumerate. Embeddings are opt-in. */
     list(options?: RemoteMemoryListOptions): Promise<RemoteMemoryPage>;
     query(options?: RemoteMemoryQueryOptions): Promise<RemoteMemoryQueryPage>;
+    /** Same page as `query`, with content and kind_value dropped instead of decrypted. */
+    queryMetadata(options?: Omit<RemoteMemoryQueryOptions, "order"> & {
+        order?: "created" | "updated" | "archived";
+    }): Promise<RemoteMemoryMetadataPage>;
     /** Whole-row write. Pass a returned snapshot to avoid GET; a number retains the read-before-write path. Version 0 creates. is_deleted writes a tombstone. */
     put(memory: RemoteMemoryRow, expectedVersion: number | RemoteMemoryRecord, signal?: AbortSignal): Promise<RemoteMemoryRecord>;
     /** 1–50 writes in one server transaction; never split or replay a batch. */
@@ -11108,4 +11138,4 @@ interface UseChatStorageResult extends BaseUseChatStorageResult {
  */
 declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageResult;
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, CHUNKS_DISCARDED_ORIGIN, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationAction, 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, type DurableAutoExtractorOptions, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, type FactType, type FileMetadata, type FileProcessingReason, type FileProcessingStatus, 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 LocalMemoryStoreOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, MEMORY_KINDS, MEMORY_LEVELS, type ManualFactType, type MemoriesNeedingTopicExtraction, type MemoryContextItem, type MemoryContextLane, type MemoryContextOptions, type MemoryContextResult, type MemoryCreate, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, MemoryKeyError, type MemoryKeyRing, type MemoryKind, type MemoryLevel, MemoryLevelError, type MemoryListOptions, type MemoryMaintenance, type MemoryQuarantinedEvent, type MemoryRecallOptions, type MemoryRetainOptions, type MemoryStore, type MemorySubscribeOptions, type MemoryToVerify, type MemoryUpdate, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionMcpCaller, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PhotoIngestResult, type PhotoMediaRef, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type PublishedPhotoMemory, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankableVaultMemory, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallEmptyReason, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type RemoteMemoryCandidateOptions, type RemoteMemoryDecodeFailure, RemoteMemoryError, type RemoteMemoryListOptions, type RemoteMemoryPage, RemoteMemoryPartialCreateError, type RemoteMemoryPersistence, type RemoteMemoryPersistenceOptions, type RemoteMemoryPipeline, type RemoteMemoryPipelineOptions, type RemoteMemoryQueryOptions, type RemoteMemoryQueryPage, type RemoteMemoryReadFilters, type RemoteMemoryRecord, type RemoteMemoryRow, type RemoteMemoryStoreOptions, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ReservationReceipt, 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 StreamSmoothingConfig, type SynthesizeProfileOptions, TOOL_RESULT_ORIGIN, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TopicSkipReason, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultEmbeddingExpectation, type VaultFolderOperationsContext, type VaultMemoryKind, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultMemoryWriter, type VaultSaveOperation, type VaultSearchResult, type VaultWriteAction, type VaultWriteInput, type VaultWriteOutcome, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, assembleMemoryContext, attachFileContextToLastUserMessage, backfillMemoryTopicsOp, buildAttachedFilesText, 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, createDurableAutoExtractor, createLlmDecayClassifier, createLlmNeighborRefiner, createLocalMemoryStore, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionProxyTools, createNotionTools, createPlatformCursorStore, createRecallTool, createRemoteMemoryPersistence, createRemoteMemoryPipeline, createRemoteMemoryStore, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteMessageOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, deriveKeyFromSignatureBytes, deriveMemoryKeyRing, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, encodeChunkVector, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, extractReservationReceipts, formatFileProcessingNotes, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoriesByIdsOp, getVaultMemoryOp, getVaultRankingProjectionsOp, hardDeleteDecayedOp, hasEncryptionKey, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isAttachedFilesText, isDegradedTopicSkip, isEncrypted, isPiiRedactor, isRerankerAvailable, maskScopedEmbeddingCache, memoryCipher, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, parseMedia, preEmbedVaultMemories, quantizeEmbedding, queueManager, rankProfileCandidates, recall, reencryptMemoryField, reflect, refreshEncryptionKeyIfMatches, refreshNotionAccessToken, registerNotionClient, relinkMemoryTopicsOp, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, seedEncryptionKeys, setLogger, setMemoryVisibilityOp, shouldChunkMessage, shouldRecallMemory, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, stripLegacyChunkTextOp, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, CHUNKS_DISCARDED_ORIGIN, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationAction, 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, type DurableAutoExtractorOptions, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, type FactType, type FileMetadata, type FileProcessingReason, type FileProcessingStatus, 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 LocalMemoryStoreOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, MEMORY_KINDS, MEMORY_LEVELS, type ManualFactType, type MemoriesNeedingTopicExtraction, type MemoryContextItem, type MemoryContextLane, type MemoryContextOptions, type MemoryContextResult, type MemoryCreate, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, MemoryKeyError, type MemoryKeyRing, type MemoryKind, type MemoryLevel, MemoryLevelError, type MemoryListOptions, type MemoryMaintenance, type MemoryQuarantinedEvent, type MemoryRecallOptions, type MemoryRetainOptions, type MemoryStore, type MemorySubscribeOptions, type MemoryToVerify, type MemoryTopic, type MemoryUpdate, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionMcpCaller, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PhotoIngestResult, type PhotoMediaRef, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type PublishedPhotoMemory, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankableVaultMemory, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallEmptyReason, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type RemoteMemoryCandidateOptions, type RemoteMemoryDecodeFailure, RemoteMemoryError, type RemoteMemoryListOptions, type RemoteMemoryMetadataPage, type RemoteMemoryMetadataRecord, type RemoteMemoryPage, RemoteMemoryPartialCreateError, type RemoteMemoryPersistence, type RemoteMemoryPersistenceOptions, type RemoteMemoryPipeline, type RemoteMemoryPipelineOptions, type RemoteMemoryQueryOptions, type RemoteMemoryQueryPage, type RemoteMemoryReadFilters, type RemoteMemoryRecord, type RemoteMemoryRow, type RemoteMemoryStoreOptions, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ReservationReceipt, 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 StreamSmoothingConfig, type SynthesizeProfileOptions, TOOL_RESULT_ORIGIN, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TopicSkipReason, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultEmbeddingExpectation, type VaultFolderOperationsContext, type VaultMemoryKind, type VaultMemoryOperationsContext, type VaultMemoryProjection, type VaultMemoryVisibility, type VaultMemoryWriter, type VaultSaveOperation, type VaultSearchResult, type VaultWriteAction, type VaultWriteInput, type VaultWriteOutcome, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, assembleMemoryContext, attachFileContextToLastUserMessage, backfillMemoryTopicsOp, buildAttachedFilesText, 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, createDurableAutoExtractor, createLlmDecayClassifier, createLlmNeighborRefiner, createLocalMemoryStore, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionProxyTools, createNotionTools, createPlatformCursorStore, createRecallTool, createRemoteMemoryPersistence, createRemoteMemoryPipeline, createRemoteMemoryStore, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteMessageOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, deriveKeyFromSignatureBytes, deriveMemoryKeyRing, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, encodeChunkVector, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, extractReservationReceipts, formatFileProcessingNotes, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoriesByIdsOp, getVaultMemoryOp, getVaultRankingProjectionsOp, hardDeleteDecayedOp, hasEncryptionKey, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isAttachedFilesText, isDegradedTopicSkip, isEncrypted, isPiiRedactor, isRerankerAvailable, maskScopedEmbeddingCache, memoryCipher, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, parseMedia, preEmbedVaultMemories, quantizeEmbedding, queueManager, rankProfileCandidates, recall, reencryptMemoryField, reflect, refreshEncryptionKeyIfMatches, refreshNotionAccessToken, registerNotionClient, relinkMemoryTopicsOp, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, seedEncryptionKeys, setLogger, setMemoryVisibilityOp, shouldChunkMessage, shouldRecallMemory, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, stripLegacyChunkTextOp, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };

package/dist/expo/index.mjs

@@ -1788,7 +1788,7 @@ function extractUserMessageFromMessages(messages) {
 }
 
 // src/lib/db/chat/operations.ts
-function messageToStoredRaw(message, projection) {
+function messageToStoredRaw(message, projection2) {
   const convId = String(message._getRaw("conversation_id"));
   const parseJsonField = (rawValue) => {
     if (!rawValue) return void 0;
@@ -1802,7 +1802,7 @@ function messageToStoredRaw(message, projection) {
     }
     return rawValue;
   };
-  const skipEmbeddings = projection?.skipEmbeddings === true;
+  const skipEmbeddings = projection2?.skipEmbeddings === true;
   const sourcesRaw = message._getRaw("sources");
   const vectorRaw = skipEmbeddings ? null : message._getRaw("vector");
   const chunksRaw = skipEmbeddings ? null : message._getRaw("chunks");
@@ -1836,8 +1836,8 @@ function messageToStoredRaw(message, projection) {
     origin: message.origin
   };
 }
-async function messageToStored(message, walletAddress, signMessage, embeddedWalletSigner, projection) {
-  const baseMessage = messageToStoredRaw(message, projection);
+async function messageToStored(message, walletAddress, signMessage, embeddedWalletSigner, projection2) {
+  const baseMessage = messageToStoredRaw(message, projection2);
   if (walletAddress) {
     return await decryptMessageFields(
       baseMessage,
@@ -1851,7 +1851,7 @@ async function messageToStored(message, walletAddress, signMessage, embeddedWall
 function rawDate(value) {
   return new Date(typeof value === "number" ? value : 0);
 }
-function messageRawToStoredRaw(raw, projection) {
+function messageRawToStoredRaw(raw, projection2) {
   const parseJsonField = (rawValue) => {
     if (!rawValue) return void 0;
     if (typeof rawValue === "string") {
@@ -1864,7 +1864,7 @@ function messageRawToStoredRaw(raw, projection) {
     }
     return rawValue;
   };
-  const skipEmbeddings = projection?.skipEmbeddings === true;
+  const skipEmbeddings = projection2?.skipEmbeddings === true;
   const vectorRaw = skipEmbeddings ? null : raw.vector;
   const chunksRaw = skipEmbeddings ? null : raw.chunks;
   return {
@@ -1895,8 +1895,8 @@ function messageRawToStoredRaw(raw, projection) {
     origin: raw.origin
   };
 }
-async function messageRawToStored(raw, walletAddress, signMessage, embeddedWalletSigner, projection) {
-  const baseMessage = messageRawToStoredRaw(raw, projection);
+async function messageRawToStored(raw, walletAddress, signMessage, embeddedWalletSigner, projection2) {
+  const baseMessage = messageRawToStoredRaw(raw, projection2);
   if (walletAddress) {
     return await decryptMessageFields(
       baseMessage,
@@ -11413,22 +11413,35 @@ async function vaultMemoryRawToStored(raw, walletAddress, signMessage, embeddedW
   return stored2;
 }
 async function getAllVaultMemoriesOp(ctx, options) {
-  const conditions = [
+  const results = await ctx.vaultMemoryCollection.query(...vaultListConditions(ctx, options), ...vaultListOrder(options)).unsafeFetchRaw();
+  return mapInBatches(
+    results,
+    (raw) => vaultMemoryRawToStored(raw, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner)
+  );
+}
+function vaultListConditions(ctx, options) {
+  return [
     ...baseVaultConditions(ctx, options),
     ...options?.scopes?.length ? [Q5.where("scope", Q5.oneOf(options.scopes))] : [],
     ...visibilityConditions(options?.visibility),
     ...levelConditions(options?.levels),
     ...options?.kinds?.length ? [Q5.where("kind", Q5.oneOf(options.kinds))] : [],
     ...options?.folderId !== void 0 ? [Q5.where("folder_id", options.folderId)] : [],
-    ...options?.factTypes?.length ? [Q5.where("fact_type", Q5.oneOf(options.factTypes))] : [],
+    ...options?.factTypes?.length ? [Q5.where("fact_type", Q5.oneOf(options.factTypes))] : []
+  ];
+}
+function vaultListOrder(options) {
+  return [
     Q5.sortBy(options?.since ? "updated_at" : "created_at", Q5.desc),
     ...options?.limit !== null && options?.limit !== void 0 && options.limit > 0 ? [Q5.take(options.limit)] : []
   ];
-  const results = await ctx.vaultMemoryCollection.query(...conditions).unsafeFetchRaw();
-  return mapInBatches(
-    results,
-    (raw) => vaultMemoryRawToStored(raw, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner)
-  );
+}
+async function getVaultMemoryProjectionsOp(ctx, options) {
+  const results = await ctx.vaultMemoryCollection.query(...vaultListConditions(ctx, options), ...vaultListOrder(options)).unsafeFetchRaw();
+  return results.map((raw) => ({
+    ...vaultMemoryRawToRankable(raw),
+    topicsUserManaged: raw.topics_user_managed === true || raw.topics_user_managed === 1
+  }));
 }
 function vaultMemoryRawToRankable(raw) {
   return {
@@ -18064,6 +18077,7 @@ function createLocalMemoryStore(options) {
   };
   const vaultCache = options.vaultCache ?? createVaultEmbeddingCache();
   const ownedBy = userId !== void 0 ? [Q8.where("user_id", userId)] : [];
+  const linksOwnedBy = userId === void 0 ? [] : options.allowUnscopedRows ? [Q8.or(Q8.where("user_id", userId), Q8.where("user_id", null))] : [Q8.where("user_id", userId)];
   const watchedColumns = [
     "content",
     "scope",
@@ -18106,6 +18120,29 @@ function createLocalMemoryStore(options) {
     },
     memoriesByTopics: (names) => getMemoriesByEntityNamesOp(entityCtx, names),
     topicsByMemories: (memoryIds) => getEntitiesByMemoryIdsOp(entityCtx, memoryIds),
+    listTopics: async () => {
+      const links = await entityCtx.memoryEntityCollection.query(...linksOwnedBy).fetch();
+      const members = /* @__PURE__ */ new Map();
+      for (const link of links) {
+        const entityId = String(link.entityId);
+        const set = members.get(entityId) ?? /* @__PURE__ */ new Set();
+        set.add(String(link.memoryId));
+        members.set(entityId, set);
+      }
+      const entities = userId === void 0 ? await entityCtx.entityCollection.query().fetch() : members.size ? await entityCtx.entityCollection.query(Q8.where("id", Q8.oneOf([...members.keys()]))).fetch() : [];
+      const byName = /* @__PURE__ */ new Map();
+      for (const entity of entities) {
+        const count2 = members.get(entity.id)?.size ?? 0;
+        const existing = byName.get(entity.canonicalName);
+        byName.set(entity.canonicalName, {
+          name: entity.canonicalName,
+          kind: existing?.kind ?? entity.kind ?? null,
+          memoryCount: (existing?.memoryCount ?? 0) + count2
+        });
+      }
+      return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    },
+    listProjections: (listOptions) => getVaultMemoryProjectionsOp(vaultCtx, listOptions),
     create: async (input) => {
       const created = await createVaultMemoryOp(vaultCtx, input);
       if (input.embedding === void 0) embedInBackground(created);
@@ -18167,7 +18204,6 @@ function createLocalMemoryStore(options) {
       );
       const subscriptions = [memories.subscribe(afterFirst())];
       if (subscribeOptions?.topics) {
-        const linksOwnedBy = userId === void 0 ? [] : options.allowUnscopedRows ? [Q8.or(Q8.where("user_id", userId), Q8.where("user_id", null))] : [Q8.where("user_id", userId)];
         subscriptions.push(
           entityCtx.memoryEntityCollection.query(...linksOwnedBy).observe().subscribe(afterFirst())
         );
@@ -18577,6 +18613,31 @@ async function createRemoteMemoryPersistence(options) {
       throw new Error("Invalid nearby candidate response");
     return result;
   };
+  const fetchQueryPage = async (queryOptions) => {
+    const { signal, ...query } = queryOptions;
+    if (query.limit !== void 0 && (!Number.isInteger(query.limit) || query.limit < 1 || query.limit > 200))
+      throw new Error("Page limit must be 1\u2013200");
+    for (const [key, max] of queryListLimits) {
+      const values = query[key];
+      if (values && values.length > max)
+        throw new Error(`Query ${key} accepts at most ${max} entries (got ${values.length})`);
+    }
+    const page = await request(
+      "/memories/query",
+      {
+        method: "POST",
+        body: JSON.stringify(
+          Object.fromEntries(
+            queryFields.filter((key) => query[key] !== void 0).map((key) => [key, query[key]])
+          )
+        )
+      },
+      signal
+    );
+    if (!record(page) || !Array.isArray(page.items) || page.next_cursor !== void 0 && typeof page.next_cursor !== "string" || page.changes_cursor !== void 0 && typeof page.changes_cursor !== "string")
+      throw new Error("Invalid nearby private-memory page");
+    return page;
+  };
   const candidateSet = async (embedding, candidateOptions = {}) => {
     const result = await fetchCandidates(embedding, candidateOptions, true);
     if (!Number.isSafeInteger(result.total_count) || result.total_count < 0 || !Number.isSafeInteger(result.unavailable_count) || result.unavailable_count < 0)
@@ -18655,34 +18716,27 @@ async function createRemoteMemoryPersistence(options) {
       return Promise.all(result.items.map((item, i) => decodeCommitted(item, prepared[i])));
     },
     query: async (queryOptions = {}) => {
-      const { signal, ...query } = queryOptions;
-      if (query.limit !== void 0 && (!Number.isInteger(query.limit) || query.limit < 1 || query.limit > 200))
-        throw new Error("Page limit must be 1\u2013200");
-      for (const [key, max] of queryListLimits) {
-        const values = query[key];
-        if (values && values.length > max)
-          throw new Error(`Query ${key} accepts at most ${max} entries (got ${values.length})`);
-      }
-      const page = await request(
-        "/memories/query",
-        {
-          method: "POST",
-          body: JSON.stringify(
-            Object.fromEntries(
-              queryFields.filter((key) => query[key] !== void 0).map((key) => [key, query[key]])
-            )
-          )
-        },
-        signal
-      );
-      if (!record(page) || !Array.isArray(page.items) || page.next_cursor !== void 0 && typeof page.next_cursor !== "string" || page.changes_cursor !== void 0 && typeof page.changes_cursor !== "string")
-        throw new Error("Invalid nearby private-memory page");
+      const page = await fetchQueryPage(queryOptions);
       return {
         ...await decodeAll(page.items),
         ...page.next_cursor !== void 0 && { next_cursor: page.next_cursor },
         ...page.changes_cursor !== void 0 && { changes_cursor: page.changes_cursor }
       };
     },
+    queryMetadata: async (queryOptions = {}) => {
+      const page = await fetchQueryPage(queryOptions);
+      return {
+        items: page.items.map((item) => {
+          const {
+            memory: { content: _content, kind_value: _kindValue, ...memory },
+            version,
+            server_updated_at
+          } = memoryRecord(item);
+          return { memory, version, server_updated_at };
+        }),
+        ...page.next_cursor !== void 0 && { next_cursor: page.next_cursor }
+      };
+    },
     candidateSet,
     candidates: async (embedding, candidateOptions = {}) => decodeAll((await fetchCandidates(embedding, candidateOptions, false)).items)
   };
@@ -19073,6 +19127,19 @@ function createRemoteMemoryPipeline(options) {
 
 // src/lib/memory/store/remoteStore.ts
 import { v7 as uuidv75 } from "uuid";
+function projection({ memory }) {
+  return {
+    uniqueId: memory.memory_id,
+    scope: memory.scope,
+    folderId: memory.folder_id ?? null,
+    embedding: memory.embedding?.length ? JSON.stringify(memory.embedding) : null,
+    embeddingModel: memory.embedding_model ?? null,
+    createdAt: new Date(memory.created_at),
+    updatedAt: new Date(memory.updated_at),
+    lastObservedAt: memory.last_observed_at ?? null,
+    topicsUserManaged: memory.topics_user_managed ?? false
+  };
+}
 function relevant(change, options) {
   return options.includeDeleted ? change === "membership" : change !== "embedding" || !!options.embeddings;
 }
@@ -19107,6 +19174,9 @@ function bounded(filters, key) {
   if (!values || values.length <= MAX_QUERY_FILTER) return [filters];
   return chunks(values, MAX_QUERY_FILTER).map((chunk) => ({ ...filters, [key]: chunk }));
 }
+function maxOf(options) {
+  return options.limit && options.limit > 0 ? options.limit : Infinity;
+}
 function chunks(values, size) {
   const out = [];
   for (let i = 0; i < values.length; i += size) out.push(values.slice(i, i + size));
@@ -19178,26 +19248,49 @@ function createRemoteMemoryStore(options) {
     for (const subscriber of [...subscribers])
       if (relevant(change, subscriber.options)) safely(subscriber.onChange);
   };
-  const enumerate = async (filters, max = Infinity) => {
+  const pages = async (read, filters, max = Infinity) => {
     const records = [];
     let cursor2;
     do {
-      const page = await persistence.query({
+      const page = await read({
         ...filters,
         limit: Math.min(200, Math.max(1, max - records.length)),
         ...cursor2 && { cursor: cursor2 }
       });
-      warnFailed(page.failed);
+      if (page.failed) warnFailed(page.failed);
       records.push(...page.items);
       cursor2 = page.next_cursor;
     } while (cursor2 && records.length < max);
     return records.slice(0, max);
   };
-  const enumerateIds = async (ids, filters) => (await Promise.all(
+  const decrypted = (options2) => persistence.query(options2);
+  const metadata = (options2) => persistence.queryMetadata(options2);
+  const enumerate = (filters, max = Infinity) => pages(decrypted, filters, max);
+  const enumerateIds = async (read, ids, filters) => (await Promise.all(
     chunks([...new Set(ids)], MAX_QUERY_IDS).map(
-      (memory_ids) => enumerate({ ...filters, memory_ids })
+      (memory_ids) => pages(read, { ...filters, memory_ids })
     )
   )).flat();
+  const listFilters = (listOptions) => ({
+    ...stateFilters(listOptions),
+    include_embeddings: true,
+    order: listOptions.since ? "updated" : "created",
+    ...listOptions.scopes?.length && { scopes: listOptions.scopes },
+    ...listOptions.factTypes?.length && { fact_types: listOptions.factTypes },
+    ...listOptions.visibility?.length && { visibility: listOptions.visibility },
+    ...listOptions.since && { updated_after: listOptions.since.getTime() }
+  });
+  const listRows = async (read, listOptions, filters, max) => {
+    const variants = bounded(filters, "scopes").flatMap((f) => bounded(f, "fact_types"));
+    if (!listOptions.memoryIds && variants.length === 1) return pages(read, filters, max);
+    const fetched = await Promise.all(
+      variants.map(
+        (variant) => listOptions.memoryIds ? enumerateIds(read, listOptions.memoryIds, variant) : pages(read, variant, max)
+      )
+    );
+    const time = (row) => filters.order === "updated" ? row.memory.updated_at : row.memory.created_at;
+    return [...new Map(fetched.flat().map((r) => [r.memory.memory_id, r])).values()].sort((a, b) => time(b) - time(a) || (a.memory.memory_id < b.memory.memory_id ? 1 : -1)).slice(0, max);
+  };
   const queues = /* @__PURE__ */ new Map();
   const serialized = (id, task) => {
     const run = (queues.get(id) ?? Promise.resolve()).then(task, task);
@@ -19239,12 +19332,15 @@ function createRemoteMemoryStore(options) {
   };
   const newRow = (input) => {
     const now = Date.now();
-    const scope = input.scope ?? "private";
+    const { level, scope } = resolveCreateLevel(input);
+    assertValidKindLevel(input.kind, level);
     return {
       memory_id: uuidv75(),
       content: input.content,
       scope,
-      level: levelFromScope(scope),
+      level,
+      ...input.kind !== void 0 && input.kind !== null && { kind: input.kind },
+      ...typeof input.kindValue === "string" && { kind_value: input.kindValue },
       created_at: now,
       updated_at: now,
       is_deleted: false,
@@ -19273,6 +19369,30 @@ function createRemoteMemoryStore(options) {
     return records.map((record2) => stored(record2.memory));
   };
   const asStored = (record2) => record2 ? stored(record2.memory) : null;
+  const withKnownKinds = async (topics) => {
+    const unkinded = [
+      ...new Set(topics.filter((t) => !t.kind).map((t) => normalizeEntityName(t.name)))
+    ];
+    if (unkinded.length === 0) return topics;
+    const kinds = /* @__PURE__ */ new Map();
+    for (const names of chunks(unkinded, MAX_QUERY_TOPICS)) {
+      for (const { memory } of await pages(metadata, {
+        topics: names,
+        include_archived: true,
+        include_quarantined: true,
+        include_superseded: true
+      })) {
+        for (const topic of parseTopics(memory.topics) ?? []) {
+          const name = normalizeEntityName(topic.name);
+          if (topic.kind && !kinds.has(name)) kinds.set(name, topic.kind);
+        }
+      }
+    }
+    return topics.map((topic) => {
+      const kind = topic.kind ?? kinds.get(normalizeEntityName(topic.name));
+      return kind ? { ...topic, kind } : topic;
+    });
+  };
   const everyState = {
     include_deleted: true,
     include_archived: true,
@@ -19349,30 +19469,34 @@ function createRemoteMemoryStore(options) {
     });
   };
   return {
-    list: async (listOptions = {}) => {
-      const order = listOptions.since ? "updated" : "created";
-      const filters = {
-        ...stateFilters(listOptions),
-        include_embeddings: true,
-        order,
-        ...listOptions.scopes?.length && { scopes: listOptions.scopes },
-        ...listOptions.factTypes?.length && { fact_types: listOptions.factTypes },
-        ...listOptions.visibility?.length && { visibility: listOptions.visibility },
-        ...listOptions.since && { updated_after: listOptions.since.getTime() }
-      };
-      const max = listOptions.limit && listOptions.limit > 0 ? listOptions.limit : Infinity;
-      const variants = bounded(filters, "scopes").flatMap((f) => bounded(f, "fact_types"));
-      if (!listOptions.memoryIds && variants.length === 1)
-        return (await enumerate(filters, max)).map((r) => stored(r.memory));
-      const fetched = await Promise.all(
-        variants.map(
-          (variant) => listOptions.memoryIds ? enumerateIds(listOptions.memoryIds, variant) : enumerate(variant, max)
-        )
-      );
-      const rows = [...new Map(fetched.flat().map((r) => [r.memory.memory_id, r])).values()].map((record2) => stored(record2.memory)).sort(
-        (a, b) => order === "updated" ? b.updatedAt.getTime() - a.updatedAt.getTime() || (a.uniqueId < b.uniqueId ? 1 : -1) : b.createdAt.getTime() - a.createdAt.getTime() || (a.uniqueId < b.uniqueId ? 1 : -1)
-      );
-      return rows.slice(0, max);
+    list: async (listOptions = {}) => (await listRows(decrypted, listOptions, listFilters(listOptions), maxOf(listOptions))).map(
+      (r) => stored(r.memory)
+    ),
+    listProjections: async (listOptions = {}) => (await listRows(metadata, listOptions, listFilters(listOptions), maxOf(listOptions))).map(
+      projection
+    ),
+    listTopics: async () => {
+      const topics = /* @__PURE__ */ new Map();
+      for (const { memory } of await pages(metadata, {
+        include_archived: true,
+        include_quarantined: true,
+        include_superseded: true
+      })) {
+        for (const topic of parseTopics(memory.topics) ?? []) {
+          const name = normalizeEntityName(topic.name);
+          if (!name) continue;
+          const entry = topics.get(name) ?? {
+            name,
+            kind: null,
+            memoryCount: 0,
+            members: /* @__PURE__ */ new Set()
+          };
+          entry.kind ?? (entry.kind = topic.kind ?? null);
+          entry.members.add(memory.memory_id);
+          topics.set(name, entry);
+        }
+      }
+      return [...topics.values()].map(({ members, ...topic }) => ({ ...topic, memoryCount: members.size })).sort((a, b) => a.name.localeCompare(b.name));
     },
     get: async (id) => asStored(await live(id)),
     listArchived: async () => (await enumerate({ archived_only: true, order: "archived", include_embeddings: true })).map(
@@ -19381,10 +19505,10 @@ function createRemoteMemoryStore(options) {
     memoriesByTopics: async (names) => {
       const wanted = new Set(names.map(normalizeEntityName).filter(Boolean));
       const out = /* @__PURE__ */ new Map();
-      const pages = await Promise.all(
+      const pages2 = await Promise.all(
         chunks([...wanted], MAX_QUERY_TOPICS).map((topics) => enumerate({ topics }))
       );
-      for (const { memory } of pages.flat()) {
+      for (const { memory } of pages2.flat()) {
         const matched = [...canonicalTopics(memory)].filter((name) => wanted.has(name));
         if (matched.length) out.set(memory.memory_id, new Set(matched));
       }
@@ -19392,7 +19516,7 @@ function createRemoteMemoryStore(options) {
     },
     topicsByMemories: async (memoryIds) => {
       const out = /* @__PURE__ */ new Map();
-      for (const { memory } of await enumerateIds(memoryIds, {
+      for (const { memory } of await enumerateIds(decrypted, memoryIds, {
         include_archived: true,
         include_superseded: true,
         include_quarantined: true
@@ -19425,15 +19549,26 @@ function createRemoteMemoryStore(options) {
     update: async (id, patch) => {
       const saved = await mutate(id, "edit", (memory) => {
         if (memory.superseded_by) return null;
+        const level = patch.level !== void 0 ? patch.level : patch.scope !== void 0 ? levelForScopeChange({ level: memory.level, scope: memory.scope }, patch.scope) : resolveMemoryLevel(memory.level, memory.scope);
+        const kind = patch.kind !== void 0 ? patch.kind : memory.kind;
+        assertValidKindLevel(kind, level);
         memory.content = patch.content;
         memory.updated_at = Date.now();
-        if (patch.scope !== void 0) {
-          memory.level = levelForScopeChange(
-            { level: memory.level, scope: memory.scope },
-            patch.scope
-          );
+        if (patch.level !== void 0) {
+          memory.level = level;
+          memory.scope = scopeForLevel(level);
+        } else if (patch.scope !== void 0) {
+          memory.level = level;
           memory.scope = patch.scope;
         }
+        if (patch.kind !== void 0) {
+          if (patch.kind === null) delete memory.kind;
+          else memory.kind = patch.kind;
+        }
+        if (patch.kindValue !== void 0) {
+          if (patch.kindValue === null) delete memory.kind_value;
+          else memory.kind_value = patch.kindValue;
+        }
         if (patch.factType !== void 0) memory.fact_type = patch.factType ?? void 0;
         if (patch.eventTime !== void 0) {
           memory.event_time_start = patch.eventTime?.start ?? void 0;
@@ -19488,16 +19623,19 @@ function createRemoteMemoryStore(options) {
       notify("edit", [await persistence.put(memory, record2)]);
       return true;
     }),
-    setTopics: async (memoryId, topics) => asStored(
-      await mutate(memoryId, "edit", (memory) => ({
-        ...memory,
-        topics: serializeTopics(mergeTopics([], topicInputs(topics, "user"))),
-        topics_user_managed: true,
-        topics_updated_at: Date.now()
-      }))
-    ),
+    setTopics: async (memoryId, topics) => {
+      const chosen = await withKnownKinds(topicInputs(topics, "user"));
+      return asStored(
+        await mutate(memoryId, "edit", (memory) => ({
+          ...memory,
+          topics: serializeTopics(mergeTopics([], chosen)),
+          topics_user_managed: true,
+          topics_updated_at: Date.now()
+        }))
+      );
+    },
     addTopics: async (memoryId, topics) => {
-      const added = topicInputs(topics, "auto");
+      const added = await withKnownKinds(topicInputs(topics, "auto"));
       const saved = await mutate(memoryId, "edit", (memory) => ({
         ...memory,
         topics: serializeTopics(mergeTopics(parseTopics(memory.topics) ?? [], added)),