chattercatcher 0.1.28 → 0.1.30

package/dist/index.d.ts

@@ -221,6 +221,7 @@ interface GenerateCronJobMessageInput {
     model: ChatModel;
     tools: RagSearchTool[];
     now: Date;
+    memberPrompt?: string;
     maxModelTurns?: number;
     maxToolCalls?: number;
 }
@@ -239,6 +240,9 @@ interface CronJobRecord {
     schedule: string;
     prompt: string;
     imageFileName?: string;
+    mentionTargetName?: string;
+    mentionOpenId?: string;
+    mentionUserId?: string;
     status: CronJobStatus;
     lastRunAt?: string;
     nextRunAt: string;
@@ -259,6 +263,9 @@ declare class CronJobRepository {
         schedule: string;
         prompt: string;
         imageFileName?: string;
+        mentionTargetName?: string;
+        mentionOpenId?: string;
+        mentionUserId?: string;
     }): CronJobRecord;
     get(id: string): CronJobRecord | null;
     list(limit?: number): CronJobRecord[];
@@ -274,6 +281,98 @@ declare function isValidCronSchedule(schedule: string): boolean;
 declare function matchesCronSchedule(schedule: string, date: Date): boolean;
 declare function getNextCronRun(schedule: string, after: Date): Date | null;
 
+interface FeishuTextMention {
+    openId: string;
+    name: string;
+}
+interface SendTextOptions {
+    mentions?: FeishuTextMention[];
+}
+interface MessageSender {
+    sendTextToChat(chatId: string, text: string, options?: SendTextOptions): Promise<void>;
+    sendImageToChat?(chatId: string, imagePath: string): Promise<void>;
+    replyTextToMessage?(messageId: string, text: string): Promise<void>;
+    addReactionToMessage?(messageId: string, emojiType: string): Promise<void>;
+}
+interface FeishuClientLike {
+    im: {
+        v1?: {
+            message: {
+                create(payload: {
+                    data: {
+                        receive_id: string;
+                        msg_type: string;
+                        content: string;
+                    };
+                    params: {
+                        receive_id_type: "chat_id";
+                    };
+                }): Promise<unknown>;
+                reply?: (payload: {
+                    path: {
+                        message_id: string;
+                    };
+                    data: {
+                        msg_type: string;
+                        content: string;
+                    };
+                }) => Promise<unknown>;
+            };
+            image?: {
+                create(payload: {
+                    data: {
+                        image_type: "message";
+                        image: Buffer;
+                    };
+                }): Promise<unknown>;
+            };
+            messageReaction?: {
+                create(payload: {
+                    path: {
+                        message_id: string;
+                    };
+                    data: {
+                        reaction_type: {
+                            emoji_type: string;
+                        };
+                    };
+                }): Promise<unknown>;
+            };
+        };
+        message?: {
+            create(payload: {
+                data: {
+                    receive_id: string;
+                    msg_type: string;
+                    content: string;
+                };
+                params: {
+                    receive_id_type: "chat_id";
+                };
+            }): Promise<unknown>;
+            reply?: (payload: {
+                path: {
+                    message_id: string;
+                };
+                data: {
+                    msg_type: string;
+                    content: string;
+                };
+            }) => Promise<unknown>;
+        };
+    };
+}
+declare function mapDomain(domain: AppConfig["feishu"]["domain"]): lark.Domain;
+declare class FeishuMessageSender implements MessageSender {
+    private readonly client;
+    constructor(client: FeishuClientLike);
+    static fromConfig(config: AppConfig, secrets: AppSecrets): FeishuMessageSender;
+    sendTextToChat(chatId: string, text: string, options?: SendTextOptions): Promise<void>;
+    sendImageToChat(chatId: string, imagePath: string): Promise<void>;
+    replyTextToMessage(messageId: string, text: string): Promise<void>;
+    addReactionToMessage(messageId: string, emojiType: string): Promise<void>;
+}
+
 interface CronJobScheduler {
     start(): void;
     stop(): void;
@@ -282,7 +381,7 @@ interface CronJobScheduler {
 interface CreateCronJobSchedulerOptions {
     repository: Pick<CronJobRepository, "listDue" | "markSuccess" | "markFailure">;
     generateMessage: (job: CronJobRecord, now: Date) => Promise<string>;
-    sendTextToChat: (chatId: string, text: string) => Promise<void>;
+    sendTextToChat: (chatId: string, text: string, options?: SendTextOptions) => Promise<void>;
     sendImageToChat?: (chatId: string, imageFileName: string) => Promise<void>;
     now?: () => Date;
     setIntervalFn?: typeof setInterval;
@@ -291,6 +390,51 @@ interface CreateCronJobSchedulerOptions {
 }
 declare function createCronJobScheduler(options: CreateCronJobSchedulerOptions): CronJobScheduler;
 
+interface FeishuChatMemberRecord {
+    chatId: string;
+    openId: string;
+    userId?: string;
+    userName: string;
+    updatedAt: string;
+}
+interface FeishuChatMemberApiRecord {
+    openId: string;
+    userId?: string;
+    userName: string;
+}
+interface FeishuChatMembersClient {
+    listChatMembers(payload: {
+        chatId: string;
+        memberIdType: "open_id";
+    }): Promise<FeishuChatMemberApiRecord[]>;
+}
+interface FeishuMemberResolverOptions {
+    repository: FeishuMemberRepository;
+    client: FeishuChatMembersClient;
+    logger?: Pick<Console, "warn">;
+    now?: () => Date;
+    ttlMs?: number;
+}
+declare class FeishuMemberRepository {
+    private readonly database;
+    constructor(database: SqliteDatabase);
+    upsert(record: FeishuChatMemberRecord): void;
+    get(chatId: string, openId: string): FeishuChatMemberRecord | null;
+    listByChat(chatId: string): FeishuChatMemberRecord[];
+    findUniqueByName(chatId: string, userName: string): FeishuChatMemberRecord | null;
+}
+declare class FeishuMemberResolver {
+    private readonly options;
+    private readonly now;
+    private readonly ttlMs;
+    private readonly logger?;
+    constructor(options: FeishuMemberResolverOptions);
+    resolveOpenIdName(chatId: string, openId: string): Promise<string>;
+    resolveUniqueName(chatId: string, userName: string): Promise<FeishuChatMemberRecord | null>;
+    private isExpired;
+    private refreshChatMembers;
+}
+
 interface CronJobTool extends ChatTool {
     execute(input: unknown): Promise<string>;
 }
@@ -298,6 +442,7 @@ interface CreateCronJobToolsInput {
     repository: CronJobRepository;
     chatId: string;
     createdByOpenId?: string;
+    memberResolver?: Pick<FeishuMemberResolver, "resolveUniqueName">;
 }
 declare function createCronJobTools(input: CreateCronJobToolsInput): CronJobTool[];
 
@@ -573,11 +718,16 @@ interface GatewayIngestAndDownloadResult extends GatewayIngestResult {
     attachment?: GatewayAttachmentIngestResult;
 }
 declare class GatewayIngestor {
+    readonly database: SqliteDatabase;
     private readonly messages;
     private readonly jobs;
     private readonly imageTasks;
     constructor(database: SqliteDatabase);
     ingestFeishuEvent(payload: FeishuReceiveMessageEvent): GatewayIngestResult;
+    ingestFeishuEventWithMembers(input: {
+        payload: FeishuReceiveMessageEvent;
+        memberResolver: Pick<FeishuMemberResolver, "resolveOpenIdName">;
+    }): Promise<GatewayIngestResult>;
     ingestFeishuEventAndDownloadAttachments(input: {
         payload: FeishuReceiveMessageEvent;
         downloader: FeishuResourceDownloader;
@@ -587,6 +737,7 @@ declare class GatewayIngestor {
             chunks: number;
             vectors: number;
         }>;
+        memberResolver?: Pick<FeishuMemberResolver, "resolveOpenIdName">;
     }): Promise<GatewayIngestAndDownloadResult>;
 }
 
@@ -596,97 +747,14 @@ interface IndexingScheduler {
     runDueNow(): Promise<void>;
 }
 
-interface MessageSender {
-    sendTextToChat(chatId: string, text: string): Promise<void>;
-    sendImageToChat?(chatId: string, imagePath: string): Promise<void>;
-    replyTextToMessage?(messageId: string, text: string): Promise<void>;
-    addReactionToMessage?(messageId: string, emojiType: string): Promise<void>;
-}
-interface FeishuClientLike {
-    im: {
-        v1?: {
-            message: {
-                create(payload: {
-                    data: {
-                        receive_id: string;
-                        msg_type: string;
-                        content: string;
-                    };
-                    params: {
-                        receive_id_type: "chat_id";
-                    };
-                }): Promise<unknown>;
-                reply?: (payload: {
-                    path: {
-                        message_id: string;
-                    };
-                    data: {
-                        msg_type: string;
-                        content: string;
-                    };
-                }) => Promise<unknown>;
-            };
-            image?: {
-                create(payload: {
-                    data: {
-                        image_type: "message";
-                        image: Buffer;
-                    };
-                }): Promise<unknown>;
-            };
-            messageReaction?: {
-                create(payload: {
-                    path: {
-                        message_id: string;
-                    };
-                    data: {
-                        reaction_type: {
-                            emoji_type: string;
-                        };
-                    };
-                }): Promise<unknown>;
-            };
-        };
-        message?: {
-            create(payload: {
-                data: {
-                    receive_id: string;
-                    msg_type: string;
-                    content: string;
-                };
-                params: {
-                    receive_id_type: "chat_id";
-                };
-            }): Promise<unknown>;
-            reply?: (payload: {
-                path: {
-                    message_id: string;
-                };
-                data: {
-                    msg_type: string;
-                    content: string;
-                };
-            }) => Promise<unknown>;
-        };
-    };
-}
-declare function mapDomain(domain: AppConfig["feishu"]["domain"]): lark.Domain;
-declare class FeishuMessageSender implements MessageSender {
-    private readonly client;
-    constructor(client: FeishuClientLike);
-    static fromConfig(config: AppConfig, secrets: AppSecrets): FeishuMessageSender;
-    sendTextToChat(chatId: string, text: string): Promise<void>;
-    sendImageToChat(chatId: string, imagePath: string): Promise<void>;
-    replyTextToMessage(messageId: string, text: string): Promise<void>;
-    addReactionToMessage(messageId: string, emojiType: string): Promise<void>;
-}
-
 interface FeishuQuestionHandlerOptions {
     config: AppConfig;
     secrets: AppSecrets;
     database: SqliteDatabase;
     model: ChatModel;
     sender: MessageSender;
+    memberRepository?: FeishuMemberRepository;
+    memberResolver?: Pick<FeishuMemberResolver, "resolveUniqueName">;
     thinkingEmojiType?: string;
 }
 interface FeishuQuestionDecision {
@@ -699,7 +767,9 @@ declare function isFeishuMessageAddressedToBot(payload: FeishuReceiveMessageEven
 declare function getFeishuQuestionDecision(payload: FeishuReceiveMessageEvent, config: AppConfig): FeishuQuestionDecision;
 declare class FeishuQuestionHandler {
     private readonly options;
+    private memberResolver?;
     constructor(options: FeishuQuestionHandlerOptions);
+    setMemberResolver(memberResolver: Pick<FeishuMemberResolver, "resolveUniqueName">): void;
     private sendResponse;
     private acknowledgeQuestion;
     handle(payload: FeishuReceiveMessageEvent, options?: {
@@ -762,6 +832,7 @@ declare function createFeishuEventDispatcher(options: {
     config: AppConfig;
     secrets: AppSecrets;
     ingestor: GatewayIngestor;
+    memberResolver?: FeishuMemberResolver;
     questionHandler?: FeishuQuestionHandler;
     resourceDownloader?: FeishuResourceDownloader;
     attachmentVectorIndexer?: (messageId: string) => Promise<{
@@ -1105,4 +1176,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 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 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 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 };