moltbot-channel-feishu 0.0.8

package/src/api/reactions.ts

@@ -0,0 +1,155 @@
+/**
+ * Emoji reactions operations.
+ */
+
+import type { Config } from "../config/schema.js";
+import type { AddReactionParams, RemoveReactionParams, Reaction } from "../types/index.js";
+import { getApiClient } from "./client.js";
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+/**
+ * Common Feishu emoji types for convenience.
+ * @see https://open.feishu.cn/document/server-docs/im-v1/message-reaction/emojis-introduce
+ */
+export const Emoji = {
+  // Common reactions
+  THUMBSUP: "THUMBSUP",
+  THUMBSDOWN: "THUMBSDOWN",
+  HEART: "HEART",
+  SMILE: "SMILE",
+  GRINNING: "GRINNING",
+  LAUGHING: "LAUGHING",
+  CRY: "CRY",
+  ANGRY: "ANGRY",
+  SURPRISED: "SURPRISED",
+  THINKING: "THINKING",
+  CLAP: "CLAP",
+  OK: "OK",
+  FIST: "FIST",
+  PRAY: "PRAY",
+  FIRE: "FIRE",
+  PARTY: "PARTY",
+  CHECK: "CHECK",
+  CROSS: "CROSS",
+  QUESTION: "QUESTION",
+  EXCLAMATION: "EXCLAMATION",
+  // Typing indicator (commonly used)
+  WRITING: "WRITING",
+  EYES: "EYES",
+  TYPING: "Typing",
+} as const;
+
+export type EmojiType = (typeof Emoji)[keyof typeof Emoji];
+
+// ============================================================================
+// API Operations
+// ============================================================================
+
+interface AddReactionResponse {
+  code?: number;
+  msg?: string;
+  data?: { reaction_id?: string };
+}
+
+/**
+ * Add a reaction (emoji) to a message.
+ *
+ * @throws Error if add fails
+ */
+export async function addReaction(config: Config, params: AddReactionParams): Promise<string> {
+  const client = getApiClient(config);
+
+  const response = (await client.im.messageReaction.create({
+    path: { message_id: params.messageId },
+    data: {
+      reaction_type: { emoji_type: params.emojiType },
+    },
+  })) as AddReactionResponse;
+
+  if (response.code !== 0) {
+    throw new Error(`Add reaction failed: ${response.msg ?? `code ${response.code}`}`);
+  }
+
+  const reactionId = response.data?.reaction_id;
+  if (!reactionId) {
+    throw new Error("Add reaction failed: no reaction_id returned");
+  }
+
+  return reactionId;
+}
+
+interface RemoveReactionResponse {
+  code?: number;
+  msg?: string;
+}
+
+/**
+ * Remove a reaction from a message.
+ *
+ * @throws Error if remove fails
+ */
+export async function removeReaction(config: Config, params: RemoveReactionParams): Promise<void> {
+  const client = getApiClient(config);
+
+  const response = (await client.im.messageReaction.delete({
+    path: {
+      message_id: params.messageId,
+      reaction_id: params.reactionId,
+    },
+  })) as RemoveReactionResponse;
+
+  if (response.code !== 0) {
+    throw new Error(`Remove reaction failed: ${response.msg ?? `code ${response.code}`}`);
+  }
+}
+
+interface ListReactionsResponse {
+  code?: number;
+  msg?: string;
+  data?: {
+    items?: {
+      reaction_id?: string;
+      reaction_type?: { emoji_type?: string };
+      operator_type?: string;
+      operator_id?: {
+        open_id?: string;
+        user_id?: string;
+        union_id?: string;
+      };
+    }[];
+  };
+}
+
+/**
+ * List all reactions for a message.
+ *
+ * @throws Error if list fails
+ */
+export async function listReactions(
+  config: Config,
+  messageId: string,
+  emojiType?: string
+): Promise<Reaction[]> {
+  const client = getApiClient(config);
+
+  const response = (await client.im.messageReaction.list({
+    path: { message_id: messageId },
+    params: emojiType ? { reaction_type: emojiType } : undefined,
+  })) as ListReactionsResponse;
+
+  if (response.code !== 0) {
+    throw new Error(`List reactions failed: ${response.msg ?? `code ${response.code}`}`);
+  }
+
+  const items = response.data?.items ?? [];
+  return items.map((item) => ({
+    reactionId: item.reaction_id ?? "",
+    emojiType: item.reaction_type?.emoji_type ?? "",
+    operatorType: item.operator_type === "app" ? ("app" as const) : ("user" as const),
+    operatorId:
+      item.operator_id?.open_id ?? item.operator_id?.user_id ?? item.operator_id?.union_id ?? "",
+  }));
+}

package/src/config/schema.ts

@@ -0,0 +1,183 @@
+/**
+ * Configuration schema definitions using Zod.
+ * All configuration types are derived from schemas via inference.
+ */
+
+import { z } from "zod";
+
+// ============================================================================
+// Enums
+// ============================================================================
+
+export const DmPolicySchema = z.enum(["open", "pairing", "allowlist"]);
+export const GroupPolicySchema = z.enum(["open", "allowlist", "disabled"]);
+export const DomainSchema = z.enum(["feishu", "lark"]);
+export const ConnectionModeSchema = z.literal("websocket");
+export const MarkdownModeSchema = z.enum(["native", "escape", "strip"]);
+export const TableModeSchema = z.enum(["native", "ascii", "simple"]);
+export const ChunkModeSchema = z.enum(["length", "newline"]);
+export const HeartbeatVisibilitySchema = z.enum(["visible", "hidden"]);
+export const ReplyToModeSchema = z.enum(["off", "first", "all"]);
+
+// ============================================================================
+// Sub-schemas
+// ============================================================================
+
+/** Tool policy for groups */
+export const ToolPolicySchema = z
+  .object({
+    allow: z.array(z.string()).optional(),
+    deny: z.array(z.string()).optional(),
+  })
+  .strict()
+  .optional();
+
+/** DM-specific configuration */
+export const DmConfigSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    systemPrompt: z.string().optional(),
+  })
+  .strict()
+  .optional();
+
+/** Markdown rendering options */
+export const MarkdownConfigSchema = z
+  .object({
+    mode: MarkdownModeSchema.optional(),
+    tableMode: TableModeSchema.optional(),
+  })
+  .strict()
+  .optional();
+
+/** Streaming coalesce settings */
+export const StreamingCoalesceSchema = z
+  .object({
+    enabled: z.boolean().optional(),
+    minDelayMs: z.number().int().positive().optional(),
+    maxDelayMs: z.number().int().positive().optional(),
+  })
+  .strict()
+  .optional();
+
+/** Heartbeat visibility settings */
+export const HeartbeatConfigSchema = z
+  .object({
+    visibility: HeartbeatVisibilitySchema.optional(),
+    intervalMs: z.number().int().positive().optional(),
+  })
+  .strict()
+  .optional();
+
+/** Group-specific configuration */
+export const GroupConfigSchema = z
+  .object({
+    requireMention: z.boolean().optional(),
+    tools: ToolPolicySchema,
+    skills: z.array(z.string()).optional(),
+    enabled: z.boolean().optional(),
+    allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
+    systemPrompt: z.string().optional(),
+  })
+  .strict();
+
+// ============================================================================
+// Main Configuration Schema
+// ============================================================================
+
+export const ConfigSchema = z
+  .object({
+    // Core settings
+    enabled: z.boolean().optional(),
+    appId: z.string().optional(),
+    appSecret: z.string().optional(),
+    domain: DomainSchema.optional().default("feishu"),
+    // Connection (websocket only, webhook removed)
+    connectionMode: ConnectionModeSchema.optional().default("websocket"),
+
+    // DM settings
+    dmPolicy: DmPolicySchema.optional().default("pairing"),
+    allowFrom: z.array(z.union([z.string(), z.number()])).optional(),
+    dmHistoryLimit: z.number().int().min(0).optional(),
+    dms: z.record(z.string(), DmConfigSchema).optional(),
+
+    // Group settings
+    groupPolicy: GroupPolicySchema.optional().default("allowlist"),
+    groupAllowFrom: z.array(z.union([z.string(), z.number()])).optional(),
+    requireMention: z.boolean().optional().default(true),
+    groups: z.record(z.string(), GroupConfigSchema.optional()).optional(),
+    historyLimit: z.number().int().min(0).optional(),
+
+    // Message formatting
+    markdown: MarkdownConfigSchema,
+    textChunkLimit: z.number().int().positive().optional(),
+    chunkMode: ChunkModeSchema.optional(),
+    blockStreamingCoalesce: StreamingCoalesceSchema,
+
+    // Media
+    mediaMaxMb: z.number().positive().optional(),
+
+    // UI
+    heartbeat: HeartbeatConfigSchema,
+    capabilities: z.array(z.string()).optional(),
+
+    // Threading
+    replyToMode: ReplyToModeSchema.optional().default("first"),
+    configWrites: z.boolean().optional(),
+  })
+  .strict()
+  .superRefine((value, ctx) => {
+    // Validate that "open" DM policy requires wildcard in allowFrom
+    if (value.dmPolicy === "open") {
+      const allowFrom = value.allowFrom ?? [];
+      const hasWildcard = allowFrom.some((entry) => String(entry).trim() === "*");
+      if (!hasWildcard) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["allowFrom"],
+          message: 'dmPolicy="open" requires allowFrom to include "*" wildcard',
+        });
+      }
+    }
+  });
+
+// ============================================================================
+// Type Exports (inferred from schemas)
+// ============================================================================
+
+export type Config = z.infer<typeof ConfigSchema>;
+export type GroupConfig = z.infer<typeof GroupConfigSchema>;
+export type ToolPolicy = z.infer<typeof ToolPolicySchema>;
+export type DmConfig = z.infer<typeof DmConfigSchema>;
+export type MarkdownConfig = z.infer<typeof MarkdownConfigSchema>;
+export type StreamingCoalesce = z.infer<typeof StreamingCoalesceSchema>;
+export type HeartbeatConfig = z.infer<typeof HeartbeatConfigSchema>;
+
+// ============================================================================
+// Credential Resolution
+// ============================================================================
+
+export interface Credentials {
+  appId: string;
+  appSecret: string;
+  domain: "feishu" | "lark";
+}
+
+/**
+ * Resolve credentials from config, with environment variable fallback.
+ * Returns null if required credentials are missing.
+ */
+export function resolveCredentials(config: Config | undefined): Credentials | null {
+  const appId = config?.appId?.trim() || process.env["FEISHU_APP_ID"]?.trim();
+  const appSecret = config?.appSecret?.trim() || process.env["FEISHU_APP_SECRET"]?.trim();
+
+  if (!appId || !appSecret) {
+    return null;
+  }
+
+  return {
+    appId,
+    appSecret,
+    domain: config?.domain ?? "feishu",
+  };
+}

package/src/core/dispatcher.ts

@@ -0,0 +1,227 @@
+/**
+ * Message dispatch and reply handling.
+ */
+
+import type { Config } from "../config/schema.js";
+import type { ParsedMessage, SendResult } from "../types/index.js";
+import { sendTextMessage, getMessage } from "../api/messages.js";
+import { addReaction, removeReaction, Emoji } from "../api/reactions.js";
+import { checkDmPolicy, checkGroupPolicy, shouldRequireMention } from "./policy.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface DispatchContext {
+  config: Config;
+  message: ParsedMessage;
+  botOpenId: string | undefined;
+  onLog?: (message: string) => void;
+  onError?: (message: string) => void;
+}
+
+export interface DispatchResult {
+  processed: boolean;
+  reason?: string;
+}
+
+export interface TypingIndicator {
+  messageId: string;
+  reactionId: string;
+}
+
+// ============================================================================
+// Typing Indicator
+// ============================================================================
+
+/**
+ * Add a typing indicator (reaction) to a message.
+ */
+export async function addTypingIndicator(
+  config: Config,
+  messageId: string
+): Promise<TypingIndicator | null> {
+  try {
+    const reactionId = await addReaction(config, {
+      messageId,
+      emojiType: Emoji.TYPING,
+    });
+    return { messageId, reactionId };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Remove a typing indicator.
+ */
+export async function removeTypingIndicator(
+  config: Config,
+  indicator: TypingIndicator
+): Promise<void> {
+  try {
+    await removeReaction(config, {
+      messageId: indicator.messageId,
+      reactionId: indicator.reactionId,
+    });
+  } catch {
+    // Ignore removal failures
+  }
+}
+
+// ============================================================================
+// Message Validation
+// ============================================================================
+
+/**
+ * Validate an incoming message against policies.
+ * Returns whether the message should be processed.
+ */
+export function validateMessage(ctx: DispatchContext): DispatchResult {
+  const { config, message } = ctx;
+  const log = ctx.onLog ?? console.log;
+
+  const isGroup = message.chatType === "group";
+
+  if (isGroup) {
+    // Check group policy
+    const policyResult = checkGroupPolicy(
+      config,
+      message.chatId,
+      message.senderOpenId,
+      message.senderName
+    );
+
+    if (!policyResult.allowed) {
+      log(`Dispatch: group policy denied - ${policyResult.reason}`);
+      return { processed: false, reason: policyResult.reason };
+    }
+
+    // Check mention requirement
+    const requiresMention = shouldRequireMention(config, message.chatType, message.chatId);
+
+    if (requiresMention && !message.mentionedBot) {
+      log(`Dispatch: mention required but bot not mentioned`);
+      return { processed: false, reason: "Mention required" };
+    }
+  } else {
+    // Check DM policy
+    const policyResult = checkDmPolicy(config, message.senderOpenId, message.senderName);
+
+    if (!policyResult.allowed) {
+      log(`Dispatch: DM policy denied - ${policyResult.reason}`);
+      return { processed: false, reason: policyResult.reason };
+    }
+  }
+
+  return { processed: true };
+}
+
+// ============================================================================
+// Quoted Message Context
+// ============================================================================
+
+/**
+ * Fetch quoted message content if replying to a message.
+ */
+export async function fetchQuotedContent(
+  config: Config,
+  parentId: string | undefined,
+  onLog?: (message: string) => void
+): Promise<string | undefined> {
+  if (!parentId) {
+    return undefined;
+  }
+
+  try {
+    const quotedMsg = await getMessage(config, parentId);
+    if (quotedMsg) {
+      onLog?.(`Dispatch: fetched quoted message: ${quotedMsg.content.slice(0, 100)}`);
+      return quotedMsg.content;
+    }
+  } catch (err) {
+    onLog?.(`Dispatch: failed to fetch quoted: ${String(err)}`);
+  }
+
+  return undefined;
+}
+
+// ============================================================================
+// Reply Sending
+// ============================================================================
+
+/**
+ * Send a reply to a message.
+ */
+export async function sendReply(
+  config: Config,
+  chatId: string,
+  text: string,
+  replyToMessageId?: string
+): Promise<SendResult> {
+  return sendTextMessage(config, {
+    to: chatId,
+    text,
+    replyToMessageId,
+  });
+}
+
+/**
+ * Send chunked replies for long messages.
+ */
+export async function sendChunkedReply(
+  config: Config,
+  chatId: string,
+  text: string,
+  replyToMessageId?: string,
+  chunkLimit = 4000
+): Promise<SendResult[]> {
+  const chunks = chunkText(text, chunkLimit);
+  const results: SendResult[] = [];
+
+  for (const chunk of chunks) {
+    const result = await sendTextMessage(config, {
+      to: chatId,
+      text: chunk,
+      replyToMessageId,
+    });
+    results.push(result);
+  }
+
+  return results;
+}
+
+/**
+ * Split text into chunks at reasonable boundaries.
+ */
+function chunkText(text: string, limit: number): string[] {
+  if (text.length <= limit) {
+    return [text];
+  }
+
+  const chunks: string[] = [];
+  let remaining = text;
+
+  while (remaining.length > limit) {
+    // Find a good break point
+    let breakPoint = remaining.lastIndexOf("\n\n", limit);
+    if (breakPoint === -1 || breakPoint < limit / 2) {
+      breakPoint = remaining.lastIndexOf("\n", limit);
+    }
+    if (breakPoint === -1 || breakPoint < limit / 2) {
+      breakPoint = remaining.lastIndexOf(" ", limit);
+    }
+    if (breakPoint === -1 || breakPoint < limit / 2) {
+      breakPoint = limit;
+    }
+
+    chunks.push(remaining.slice(0, breakPoint).trim());
+    remaining = remaining.slice(breakPoint).trim();
+  }
+
+  if (remaining) {
+    chunks.push(remaining);
+  }
+
+  return chunks;
+}