chattercatcher 0.2.5 → 0.2.7

package/dist/index.d.ts

@@ -101,6 +101,7 @@ interface MessageRecord {
     chatId: string;
     senderId: string;
     senderName: string;
+    personId?: string;
     messageType: string;
     text: string;
     rawPayloadJson: string;
@@ -126,6 +127,7 @@ interface IngestMessageInput {
     platformMessageId: string;
     senderId: string;
     senderName: string;
+    personId?: string;
     messageType: string;
     text: string;
     rawPayload?: unknown;
@@ -143,6 +145,7 @@ interface CreateImageSummaryMessageInput {
 interface MessageSearchScope {
     platform?: string;
     platformChatId?: string;
+    personId?: string;
 }
 interface MessageSearchResult {
     chunkId: string;
@@ -152,16 +155,21 @@ interface MessageSearchResult {
     score: number;
     messageType: string;
     chatName: string;
+    senderId: string;
     senderName: string;
+    personId?: string;
     sentAt: string;
 }
 
-type SourceType = "message" | "episode" | "file" | "image" | "audio" | "link" | "feishu_doc";
+type SourceType = "message" | "episode" | "file" | "image" | "audio" | "link" | "feishu_doc" | "person_profile";
 interface EvidenceSource {
     type: SourceType;
     label: string;
     timestamp?: string;
     sender?: string;
+    senderId?: string;
+    personId?: string;
+    profileAvailable?: boolean;
     location?: string;
 }
 interface EvidenceBlock {
@@ -698,6 +706,152 @@ interface MultimodalModel {
     describeImage(input: DescribeImageInput): Promise<DescribeImageResult>;
 }
 
+type PersonIdentitySource = "message" | "feishu_member" | "manual" | "inferred";
+type ProfileEntryType = "fact" | "inferred";
+type ProfileEntryStatus = "active" | "superseded" | "deleted";
+type ProfileEntrySource = "dream" | "explicit_user_request" | "manual";
+interface PersonRecord {
+    id: string;
+    primaryName: string;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ResolvePersonInput {
+    platform: string;
+    platformChatId: string;
+    senderId: string;
+    senderName: string;
+    source: PersonIdentitySource;
+    observedAt?: string;
+}
+interface ProfileEvidenceInput {
+    messageId: string;
+    quote: string;
+    reason: string;
+}
+interface UpsertProfileEntryInput {
+    personId: string;
+    category: string;
+    content: string;
+    entryType: ProfileEntryType;
+    confidence: number;
+    source: ProfileEntrySource;
+    evidence: ProfileEvidenceInput[];
+    observedAt?: string;
+}
+interface ProfileEvidenceRecord extends ProfileEvidenceInput {
+    entryId: string;
+}
+interface ProfileEntryRecord {
+    id: string;
+    personId: string;
+    category: string;
+    content: string;
+    entryType: ProfileEntryType;
+    confidence: number;
+    status: ProfileEntryStatus;
+    source: ProfileEntrySource;
+    createdAt: string;
+    updatedAt: string;
+    lastObservedAt: string;
+    evidence?: ProfileEvidenceRecord[];
+}
+interface PersonIdentityRecord {
+    platform: string;
+    platformChatId: string;
+    externalUserId: string;
+    displayName: string;
+    alias?: string;
+    source: PersonIdentitySource;
+    firstSeenAt: string;
+    lastSeenAt: string;
+}
+interface DreamStateRecord {
+    platform: string;
+    platformChatId: string;
+    lastMessageId?: string;
+    lastMessageSentAt?: string;
+    updatedAt?: string;
+}
+interface DreamMessageRecord {
+    messageId: string;
+    personId: string;
+    senderName: string;
+    sentAt: string;
+    text: string;
+}
+interface DreamRunRecord {
+    id: string;
+    platform: string;
+    platformChatId: string;
+    status: "succeeded" | "failed" | "skipped";
+    processedMessageCount: number;
+    generatedEntryCount: number;
+    error?: string;
+    startedAt: string;
+    finishedAt: string;
+}
+interface DreamChatRecord {
+    platform: string;
+    platformChatId: string;
+}
+
+declare class ProfileRepository {
+    private readonly database;
+    constructor(database: SqliteDatabase);
+    resolvePersonForSender(input: ResolvePersonInput): PersonRecord;
+    listPersons(): PersonRecord[];
+    getPersonProfile(personId: string, options?: {
+        includeEvidence?: boolean;
+        includeInferred?: boolean;
+    }): {
+        person: PersonRecord;
+        identities: PersonIdentityRecord[];
+        entries: ProfileEntryRecord[];
+    } | undefined;
+    upsertProfileEntry(input: UpsertProfileEntryInput): string;
+    backfillMessagePersons({ limit }: {
+        limit: number;
+    }): {
+        updatedMessages: number;
+    };
+    getDreamState(platform: string, platformChatId: string): DreamStateRecord | undefined;
+    updateDreamState(input: {
+        platform: string;
+        platformChatId: string;
+        lastMessageId?: string;
+        lastMessageSentAt?: string;
+        updatedAt: string;
+    }): void;
+    listMessagesForDream(input: {
+        platform: string;
+        platformChatId: string;
+        afterSentAt?: string;
+        limit: number;
+    }): DreamMessageRecord[];
+    listChatsWithPendingDreamMessages(): DreamChatRecord[];
+    recordDreamRun(input: Omit<DreamRunRecord, "id"> & {
+        id?: string;
+    }): string;
+    resolvePersonIdForSender(input: {
+        senderId: string;
+        platformChatId: string;
+        platform?: string;
+    }): string | undefined;
+    searchPersonMessages(personId: string, query: string, limit: number, options?: {
+        excludeMessageIds?: string[];
+    }): MessageSearchResult[];
+    getProfileEntry(entryId: string): ProfileEntryRecord | undefined;
+    replaceProfileEntry(input: {
+        supersedeEntryId: string;
+        input: UpsertProfileEntryInput;
+    }): string;
+    markProfileEntryDeleted(entryId: string): void;
+    personExists(personId: string): boolean;
+    private getEvidence;
+}
+
 interface GatewayIngestResult {
     accepted: boolean;
     messageId?: string;
@@ -718,12 +872,17 @@ interface GatewayAttachmentIngestResult {
 interface GatewayIngestAndDownloadResult extends GatewayIngestResult {
     attachment?: GatewayAttachmentIngestResult;
 }
+interface GatewayIngestorOptions {
+    profiles?: ProfileRepository;
+}
 declare class GatewayIngestor {
     readonly database: SqliteDatabase;
+    private readonly options;
     private readonly messages;
     private readonly jobs;
     private readonly imageTasks;
-    constructor(database: SqliteDatabase);
+    constructor(database: SqliteDatabase, options?: GatewayIngestorOptions);
+    private enrichWithPerson;
     ingestFeishuEvent(payload: FeishuReceiveMessageEvent): GatewayIngestResult;
     ingestFeishuEventWithMembers(input: {
         payload: FeishuReceiveMessageEvent;
@@ -1125,6 +1284,7 @@ declare function createAgenticRagSearchTools(input: {
     messages: MessageRepository;
     excludeMessageIds?: string[];
     scope?: MessageSearchScope;
+    profileTools?: RagSearchTool[];
 }): Promise<{
     tools: RagSearchTool[];
     close: () => void;
@@ -1177,4 +1337,4 @@ interface WebAppOptions {
 declare function createWebApp(config: AppConfig, options?: WebAppOptions): FastifyInstance;
 declare function startWebServer(config: AppConfig, options?: WebAppOptions): Promise<void>;
 
-export { type AppConfig, type AppSecrets, type AskWithRagInput, type BuildEvidencePromptInput, type BuildEvidencePromptOptions, type ChatMessage, type ChatModel, type ChatRecord, type ChatTool, type Citation, type CreateImageSummaryMessageInput, type CronJobRecord, CronJobRepository, type CronJobScheduler, type CronJobStatus, type CronJobTool, type DataExportResult, type DataRestoreResult, type DeleteLocalDataResult, type DeleteTargetType, type DoctorCheck, type DoctorOptions, type DoctorStatus, type EmbeddingModel, type EpisodeListItem, type EpisodeMessage, EpisodeRepository, type EpisodeSearchResult, type EpisodeSummaryRecord, type EpisodeWindow, type EvidenceBlock, type EvidencePrompt, type EvidenceSource, type FeishuAttachmentMetadata, type FeishuDownloadResourceInput, type FeishuDownloadedResource, type FeishuGatewayOptions, type FeishuGatewayRuntime, FeishuMessageSender, type FeishuQuestionDecision, FeishuQuestionHandler, type FeishuQuestionHandlerOptions, type FeishuReceiveMessageEvent, FeishuResourceDownloader, type FeishuTextMention, type FileJobRecord, FileJobRepository, type FileJobStatus, type FileRecord, type GatewayAttachmentIngestResult, type GatewayIngestAndDownloadResult, type GatewayIngestResult, GatewayIngestor, type GatewayPidRecord, type GatewayRuntimeState, type GroundedAnswer, HybridRetriever, type HybridRetrieverOptions, type IngestLocalFileResult, type IngestMessageInput, type LogFileInfo, type LogTailResult, type ManualMessageIndexResult, MemoryVectorStore, MessageFtsRetriever, type MessageRecord, MessageRepository, type MessageSearchResult, type MessageSearchScope, type MessageSender, OpenAICompatibleChatModel, type OpenAICompatibleChatOptions, OpenAICompatibleEmbeddingModel, type OpenAICompatibleEmbeddingOptions, type ParsedFile, type ProcessEpisodesResult, type SendTextOptions, type SourceType, type SqliteDatabase, type StopGatewayResult, type TextChunk, type ToolCall, type ToolChatResult, type VectorIndexStats, type VectorRecord, VectorRetriever, type VectorSearchResult, type VectorStore, type WebAppOptions, appConfigSchema, appSecretsSchema, applySecretInput, askWithRag, buildEvidencePrompt, chunkText, cosineSimilarity, createAgenticRagSearchTools, createChatModel, createCronJobScheduler, createCronJobTools, createDefaultConfig, createDefaultSecrets, createEmbeddingModel, createFeishuEventDispatcher, createFeishuGateway, createHybridRetriever, createWebApp, deleteLocalData, describeSupportedParseTypes, ensureConfigFiles, exportLocalData, extractFeishuAttachment, followLogFile, formatCitation, formatCitations, formatDoctorChecks, generateCronJobMessage, generateGroundedAnswer, getDatabasePath, getFeishuQuestionDecision, getGatewayLogPath, getGatewayPidPath, getGatewayRuntimeState, getLogsDirectory, getNextCronRun, hasEmbeddingConfig, indexMessageChunks, ingestLocalFile, isFeishuMessageAddressedToBot, isProcessRunning, isSupportedParseFile, isSupportedTextFile, isValidCronSchedule, listLogFiles, loadConfig, loadSecrets, mapDomain, maskSecret, matchesCronSchedule, migrateDatabase, normalizeFeishuReceiveMessageEvent, normalizeLineCount, openDatabase, parseFileToText, processEpisodesNow, processMessagesNow, rankEvidenceForPrompt, readGatewayPidRecord, readLatestLogTail, readLogTail, removeGatewayPidRecord, resetConfigFiles, resolveEmbeddingApiKey, resolveLogPath, restoreLocalData, runDoctor, sanitizeEpisodeSummary, saveConfig, saveSecrets, startWebServer, stopGatewayProcess, summarizeEpisodeWindow, writeGatewayPidRecord };
+export { type AppConfig, type AppSecrets, type AskWithRagInput, type BuildEvidencePromptInput, type BuildEvidencePromptOptions, type ChatMessage, type ChatModel, type ChatRecord, type ChatTool, type Citation, type CreateImageSummaryMessageInput, type CronJobRecord, CronJobRepository, type CronJobScheduler, type CronJobStatus, type CronJobTool, type DataExportResult, type DataRestoreResult, type DeleteLocalDataResult, type DeleteTargetType, type DoctorCheck, type DoctorOptions, type DoctorStatus, type EmbeddingModel, type EpisodeListItem, type EpisodeMessage, EpisodeRepository, type EpisodeSearchResult, type EpisodeSummaryRecord, type EpisodeWindow, type EvidenceBlock, type EvidencePrompt, type EvidenceSource, type FeishuAttachmentMetadata, type FeishuDownloadResourceInput, type FeishuDownloadedResource, type FeishuGatewayOptions, type FeishuGatewayRuntime, FeishuMessageSender, type FeishuQuestionDecision, FeishuQuestionHandler, type FeishuQuestionHandlerOptions, type FeishuReceiveMessageEvent, FeishuResourceDownloader, type FeishuTextMention, type FileJobRecord, FileJobRepository, type FileJobStatus, type FileRecord, type GatewayAttachmentIngestResult, type GatewayIngestAndDownloadResult, type GatewayIngestResult, GatewayIngestor, type GatewayIngestorOptions, type GatewayPidRecord, type GatewayRuntimeState, type GroundedAnswer, HybridRetriever, type HybridRetrieverOptions, type IngestLocalFileResult, type IngestMessageInput, type LogFileInfo, type LogTailResult, type ManualMessageIndexResult, MemoryVectorStore, MessageFtsRetriever, type MessageRecord, MessageRepository, type MessageSearchResult, type MessageSearchScope, type MessageSender, OpenAICompatibleChatModel, type OpenAICompatibleChatOptions, OpenAICompatibleEmbeddingModel, type OpenAICompatibleEmbeddingOptions, type ParsedFile, type ProcessEpisodesResult, type SendTextOptions, type SourceType, type SqliteDatabase, type StopGatewayResult, type TextChunk, type ToolCall, type ToolChatResult, type VectorIndexStats, type VectorRecord, VectorRetriever, type VectorSearchResult, type VectorStore, type WebAppOptions, appConfigSchema, appSecretsSchema, applySecretInput, askWithRag, buildEvidencePrompt, chunkText, cosineSimilarity, createAgenticRagSearchTools, createChatModel, createCronJobScheduler, createCronJobTools, createDefaultConfig, createDefaultSecrets, createEmbeddingModel, createFeishuEventDispatcher, createFeishuGateway, createHybridRetriever, createWebApp, deleteLocalData, describeSupportedParseTypes, ensureConfigFiles, exportLocalData, extractFeishuAttachment, followLogFile, formatCitation, formatCitations, formatDoctorChecks, generateCronJobMessage, generateGroundedAnswer, getDatabasePath, getFeishuQuestionDecision, getGatewayLogPath, getGatewayPidPath, getGatewayRuntimeState, getLogsDirectory, getNextCronRun, hasEmbeddingConfig, indexMessageChunks, ingestLocalFile, isFeishuMessageAddressedToBot, isProcessRunning, isSupportedParseFile, isSupportedTextFile, isValidCronSchedule, listLogFiles, loadConfig, loadSecrets, mapDomain, maskSecret, matchesCronSchedule, migrateDatabase, normalizeFeishuReceiveMessageEvent, normalizeLineCount, openDatabase, parseFileToText, processEpisodesNow, processMessagesNow, rankEvidenceForPrompt, readGatewayPidRecord, readLatestLogTail, readLogTail, removeGatewayPidRecord, resetConfigFiles, resolveEmbeddingApiKey, resolveLogPath, restoreLocalData, runDoctor, sanitizeEpisodeSummary, saveConfig, saveSecrets, startWebServer, stopGatewayProcess, summarizeEpisodeWindow, writeGatewayPidRecord };