@trydying/opencode-feishu-notifier 0.3.1 → 0.3.2

package/src/types.ts

@@ -0,0 +1,102 @@
+import type { NotificationType } from "./feishu/messages";
+
+/**
+ * 项目上下文信息
+ * 包含项目名称、分支、工作目录等基本信息
+ */
+export interface ProjectContext {
+  /** 项目名称，从 package.json 或目录名提取 */
+  projectName: string;
+  /** Git 当前分支名（如果项目是 git 仓库） */
+  branch?: string;
+  /** 工作目录绝对路径 */
+  workingDir: string;
+  /** 仓库 URL（如果是 git 项目） */
+  repoUrl?: string;
+  /** 是否 Git 仓库 */
+  isGitRepo: boolean;
+  /** 机器 hostname，用于区分不同的机器 */
+  hostname?: string;
+}
+
+/**
+ * 进度信息
+ * 包含当前任务状态和进度摘要
+ */
+export interface ProgressInfo {
+  /** 最近的操作描述 */
+  lastAction?: string;
+  /** 当前任务描述（如果可获取） */
+  currentTask?: string;
+  /** 时间戳 */
+  timestamp: string;
+  /** 工作目录中的文件变更信息 */
+  fileChanges?: {
+    /** 新增文件数 */
+    added?: number;
+    /** 修改文件数 */
+    modified?: number;
+    /** 删除文件数 */
+    deleted?: number;
+  };
+}
+
+/**
+ * 消息上下文
+ * 构建消息所需的所有上下文信息
+ */
+export interface MessageContext {
+  /** 项目上下文 */
+  project: ProjectContext;
+  /** 进度信息 */
+  progress: ProgressInfo;
+  /** 事件类型 */
+  eventType: NotificationType;
+  /** 原始事件负载 */
+  eventPayload?: unknown;
+  /** 事件原始类型 */
+  originalEventType?: string;
+  /** 会话 ID */
+  sessionID?: string;
+  /** 会话标题 */
+  sessionTitle?: string;
+  /** 触发事件的 Agent 名称 */
+  agentName?: string;
+}
+
+/**
+ * 消息模板接口
+ * 定义三段式消息的构建方法
+ */
+export interface MessageTemplate {
+  /** 构建标题区域：项目名 + 分支 + 事件类型 */
+  buildTitle(context: MessageContext): string;
+
+  /** 构建原因区域：为什么发送通知 + 具体说明 */
+  buildReason(context: MessageContext): string;
+
+  /** 构建进度区域：工作目录 + 最近操作 + 当前任务 */
+  buildProgress(context: MessageContext): string;
+
+  /** 构建完整消息 */
+  buildFullMessage(context: MessageContext): string;
+}
+
+/**
+ * 事件原因说明配置
+ */
+export interface ReasonConfig {
+  /** 原因分类：闲暇等待/需要权限/需要选择等 */
+  category: string;
+  /** 原因说明文案 */
+  description: string;
+  /** 是否需要具体操作说明 */
+  requiresAction: boolean;
+  /** 事件类型对应的 emoji */
+  emoji?: string;
+}
+
+/**
+ * 事件类型到原因配置的映射
+ */
+export type ReasonConfigMap = Record<NotificationType, ReasonConfig>;

package/dist/chunk-DGUM43GV.js

@@ -1,11 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export {
-  __require
-};
-//# sourceMappingURL=chunk-DGUM43GV.js.map

package/dist/chunk-DGUM43GV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,5 +0,0 @@
-import { Plugin } from '@opencode-ai/plugin';
-
-declare const FeishuNotifierPlugin: Plugin;
-
-export { FeishuNotifierPlugin as default };

package/dist/index.js

@@ -1,550 +0,0 @@
-import "./chunk-DGUM43GV.js";
-
-// src/config.ts
-import fs from "fs";
-import os from "os";
-import path from "path";
-var receiverTypes = ["user_id", "open_id", "chat_id"];
-function getConfigPaths(options) {
-  if (options.configPath) {
-    return [options.configPath];
-  }
-  const paths = [];
-  const directory = options.directory ?? process.cwd();
-  const xdgConfig = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), ".config");
-  paths.push(path.join(xdgConfig, "opencode", "feishu-notifier.json"));
-  paths.push(path.join(directory, ".opencode", "feishu-notifier.json"));
-  return paths;
-}
-function readConfigFile(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return null;
-  }
-  const raw = fs.readFileSync(filePath, "utf8").trim();
-  if (!raw) {
-    return null;
-  }
-  try {
-    return JSON.parse(raw);
-  } catch (error) {
-    throw new Error(`Invalid JSON in ${filePath}: ${String(error)}`);
-  }
-}
-function readEnvConfig() {
-  return {
-    appId: process.env.FEISHU_APP_ID,
-    appSecret: process.env.FEISHU_APP_SECRET,
-    receiverType: process.env.FEISHU_RECEIVER_TYPE,
-    receiverId: process.env.FEISHU_RECEIVER_ID
-  };
-}
-function resolveConfig(options) {
-  const configPaths = getConfigPaths(options);
-  let mergedConfig = {};
-  const sources = [];
-  for (const configPath of configPaths) {
-    const config = readConfigFile(configPath);
-    if (config) {
-      mergedConfig = {
-        ...mergedConfig,
-        ...config
-      };
-      sources.push({ type: "file", detail: configPath });
-    }
-  }
-  const envConfig = readEnvConfig();
-  if (envConfig.appId || envConfig.appSecret || envConfig.receiverType || envConfig.receiverId) {
-    mergedConfig = {
-      ...mergedConfig,
-      ...envConfig
-    };
-    sources.push({ type: "env", detail: "FEISHU_*" });
-  }
-  return { mergedConfig, sources };
-}
-function finalizeConfig(mergedConfig, sources) {
-  if (sources.length === 0) {
-    throw new Error(
-      "Missing Feishu configuration. Use FEISHU_* environment variables or create feishu-notifier.json."
-    );
-  }
-  const missing = [];
-  if (!mergedConfig.appId) missing.push("appId");
-  if (!mergedConfig.appSecret) missing.push("appSecret");
-  if (!mergedConfig.receiverType) missing.push("receiverType");
-  if (!mergedConfig.receiverId) missing.push("receiverId");
-  if (missing.length > 0) {
-    throw new Error(`Missing config fields: ${missing.join(", ")}`);
-  }
-  const receiverType = mergedConfig.receiverType;
-  if (!receiverTypes.includes(receiverType)) {
-    throw new Error(
-      `Invalid receiverType: ${mergedConfig.receiverType}. Expected one of ${receiverTypes.join(", ")}`
-    );
-  }
-  return {
-    appId: mergedConfig.appId,
-    appSecret: mergedConfig.appSecret,
-    receiverType,
-    receiverId: mergedConfig.receiverId
-  };
-}
-function loadConfigWithSource(options = {}) {
-  const { mergedConfig, sources } = resolveConfig(options);
-  return {
-    config: finalizeConfig(mergedConfig, sources),
-    sources
-  };
-}
-
-// src/feishu/client.ts
-var tokenCache = /* @__PURE__ */ new Map();
-function clearTokenCache(config) {
-  const cacheKey = `${config.appId}:${config.appSecret}`;
-  tokenCache.delete(cacheKey);
-}
-function isTokenExpiredError(code) {
-  return code === 99991663 || code === 99991664 || code === 99991668;
-}
-function ensureFetch() {
-  if (typeof fetch === "undefined") {
-    throw new Error("Global fetch is not available. Use Node.js 18+.");
-  }
-  return fetch;
-}
-async function readJson(response) {
-  const text = await response.text();
-  if (!text) {
-    throw new Error(`Empty response from Feishu API (${response.status}).`);
-  }
-  return JSON.parse(text);
-}
-async function getTenantAccessToken(config) {
-  const cacheKey = `${config.appId}:${config.appSecret}`;
-  const now = Date.now();
-  const cached = tokenCache.get(cacheKey);
-  if (cached && cached.expiresAt > now + 6e4) {
-    return cached.token;
-  }
-  const fetchImpl = ensureFetch();
-  const response = await fetchImpl(
-    "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
-    {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        app_id: config.appId,
-        app_secret: config.appSecret
-      })
-    }
-  );
-  if (!response.ok) {
-    const errorText = await response.text().catch(() => `Failed to read error response`);
-    throw new Error(`Feishu auth request failed: ${response.status} - ${errorText}`);
-  }
-  const payload = await readJson(response);
-  if (payload.code !== 0 || !payload.tenant_access_token) {
-    throw new Error(`Feishu auth failed: ${payload.msg} (${payload.code})`);
-  }
-  const expiresIn = payload.expire ? payload.expire * 1e3 : 2 * 60 * 60 * 1e3;
-  const expiresAt = now + expiresIn - 6e4;
-  tokenCache.set(cacheKey, {
-    token: payload.tenant_access_token,
-    expiresAt
-  });
-  return payload.tenant_access_token;
-}
-async function sendMessage(config, msgType, content) {
-  const fetchImpl = ensureFetch();
-  const sendWithToken = async (retryOnTokenExpired = true) => {
-    const token = await getTenantAccessToken(config);
-    const response = await fetchImpl(
-      `https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=${config.receiverType}`,
-      {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({
-          receive_id: config.receiverId,
-          msg_type: msgType,
-          content: JSON.stringify(content)
-        })
-      }
-    );
-    if (!response.ok) {
-      const errorText = await response.text().catch(() => `Failed to read error response`);
-      throw new Error(`Feishu message request failed: ${response.status} - ${errorText}`);
-    }
-    const payload = await readJson(response);
-    if (payload.code !== 0) {
-      if (retryOnTokenExpired && isTokenExpiredError(payload.code)) {
-        clearTokenCache(config);
-        return sendWithToken(false);
-      }
-      throw new Error(`Feishu message failed: ${payload.msg} (${payload.code}) - Response: ${JSON.stringify(payload)}`);
-    }
-    return payload;
-  };
-  return sendWithToken();
-}
-async function sendTextMessage(config, text) {
-  return sendMessage(config, "text", { text });
-}
-function textToPostContent(text, title = "OpenCode \u901A\u77E5") {
-  const cleanedText = text.split("\n").filter((line) => line.trim().length > 0).join("\n");
-  const content = [
-    [
-      {
-        tag: "text",
-        text: cleanedText,
-        un_escape: true
-      }
-    ]
-  ];
-  return {
-    post: {
-      zh_cn: {
-        title,
-        content
-      }
-    }
-  };
-}
-async function sendRichTextMessage(config, text, title, richContent) {
-  const postContent = richContent || textToPostContent(text, title);
-  return sendMessage(config, "post", postContent);
-}
-
-// src/feishu/messages.ts
-import os2 from "os";
-var sessionTitleCache = /* @__PURE__ */ new Map();
-var sessionAgentCache = /* @__PURE__ */ new Map();
-function asRecord(value) {
-  if (value && typeof value === "object") {
-    return value;
-  }
-  return void 0;
-}
-function readString(value) {
-  return typeof value === "string" ? value : void 0;
-}
-function extractEventPayload(event) {
-  if (!event) {
-    return void 0;
-  }
-  if (event.payload !== void 0) {
-    return event.payload;
-  }
-  if (event.properties !== void 0) {
-    return event.properties;
-  }
-  return void 0;
-}
-function extractEventProperties(event) {
-  if (!event) {
-    return void 0;
-  }
-  if (event.properties) {
-    return asRecord(event.properties);
-  }
-  if (event.payload) {
-    return asRecord(event.payload);
-  }
-  return void 0;
-}
-function extractSessionContext(event) {
-  const properties = extractEventProperties(event);
-  const info = asRecord(properties?.info);
-  const part = asRecord(properties?.part);
-  const sessionID = readString(properties?.sessionID) ?? readString(info?.sessionID) ?? readString(info?.id) ?? readString(part?.sessionID);
-  const sessionTitle = readString(info?.title);
-  const agentName = readString(properties?.agent) ?? readString(info?.agent) ?? readString(part?.agent) ?? readString(part?.name);
-  return {
-    sessionID,
-    sessionTitle,
-    agentName
-  };
-}
-async function resolveSessionContext(event, client) {
-  const baseContext = extractSessionContext(event);
-  if (!baseContext.sessionID) {
-    return baseContext;
-  }
-  const cachedTitle = sessionTitleCache.get(baseContext.sessionID);
-  const cachedAgent = sessionAgentCache.get(baseContext.sessionID);
-  const mergedContext = {
-    ...baseContext,
-    sessionTitle: baseContext.sessionTitle ?? cachedTitle,
-    agentName: baseContext.agentName ?? cachedAgent
-  };
-  if (mergedContext.sessionTitle) {
-    return mergedContext;
-  }
-  if (client?.session?.get) {
-    try {
-      const response = await client.session.get({
-        path: { id: baseContext.sessionID }
-      });
-      const title = response?.data?.title;
-      if (title) {
-        sessionTitleCache.set(baseContext.sessionID, title);
-        return {
-          ...mergedContext,
-          sessionTitle: title
-        };
-      }
-    } catch {
-    }
-  }
-  return mergedContext;
-}
-function recordEventContext(event) {
-  const context = extractSessionContext(event);
-  if (!context.sessionID) {
-    return;
-  }
-  if (context.sessionTitle) {
-    sessionTitleCache.set(context.sessionID, context.sessionTitle);
-  }
-  if (context.agentName) {
-    sessionAgentCache.set(context.sessionID, context.agentName);
-  }
-}
-var titles = {
-  interaction_required: "\u9700\u8981\u4EA4\u4E92",
-  permission_required: "\u9700\u8981\u6743\u9650\u786E\u8BA4",
-  command_args_required: "\u9700\u8981\u8865\u5145\u53C2\u6570",
-  confirmation_required: "\u9700\u8981\u786E\u8BA4",
-  session_idle: "OpenCode \u95F2\u6687",
-  question_asked: "\u9700\u8981\u9009\u62E9\u65B9\u6848",
-  setup_test: "Feishu \u901A\u77E5\u6D4B\u8BD5"
-};
-async function buildStructuredNotification(type, event, directory, client) {
-  const { buildStructuredMessage } = await import("./templates-PQN4V7CV.js");
-  const eventPayload = extractEventPayload(event);
-  const sessionContext = await resolveSessionContext(event, client);
-  try {
-    const text = await buildStructuredMessage(
-      type,
-      eventPayload,
-      event?.type,
-      directory,
-      sessionContext
-    );
-    return {
-      title: titles[type],
-      text,
-      richContent: textToPostContent2(text, titles[type])
-    };
-  } catch (error) {
-    return buildLegacyNotification(type, event);
-  }
-}
-function buildLegacyNotification(type, event) {
-  const title = titles[type];
-  if (type === "setup_test") {
-    const text2 = `${title}
-Feishu \u901A\u77E5\u5DF2\u542F\u7528\u3002`;
-    return {
-      title,
-      text: text2,
-      richContent: textToPostContent2(text2, title)
-    };
-  }
-  const payloadText = formatPayload(extractEventPayload(event));
-  const sessionContext = extractSessionContext(event);
-  const lines = [
-    `[OpenCode] ${title}`,
-    event?.type ? `\u4E8B\u4EF6\u7C7B\u578B: ${event.type}` : "",
-    sessionContext.sessionTitle || sessionContext.sessionID ? `\u4F1A\u8BDD: ${sessionContext.sessionTitle ?? sessionContext.sessionID}` : "",
-    sessionContext.agentName ? `Agent: ${sessionContext.agentName}` : "",
-    `\u4E3B\u673A: ${os2.hostname()}`,
-    payloadText ? `\u8BE6\u60C5: ${payloadText}` : ""
-  ].filter(Boolean);
-  const text = lines.join("\n");
-  return {
-    title,
-    text,
-    richContent: textToPostContent2(text, title)
-  };
-}
-function formatPayload(payload) {
-  if (!payload) {
-    return "";
-  }
-  const text = JSON.stringify(payload, null, 2);
-  if (text.length > 1200) {
-    return `${text.slice(0, 1200)}\u2026`;
-  }
-  return text;
-}
-function textToPostContent2(text, title = "OpenCode \u901A\u77E5") {
-  const cleanedText = text.split("\n").filter((line) => line.trim().length > 0).join("\n");
-  const content = [
-    [
-      {
-        tag: "text",
-        text: cleanedText,
-        un_escape: true
-      }
-    ]
-  ];
-  return {
-    post: {
-      zh_cn: {
-        title,
-        content
-      }
-    }
-  };
-}
-async function buildNotification(type, event, directory, client) {
-  return buildStructuredNotification(type, event, directory, client);
-}
-
-// src/hooks.ts
-function mapEventToNotification(eventType) {
-  switch (eventType) {
-    case "permission.asked":
-      return "permission_required";
-    case "question.asked":
-      return "question_asked";
-    default:
-      return null;
-  }
-}
-function mapCompletionEventToNotification(event) {
-  const status = event.properties?.status;
-  if (event.type === "session.status" && status?.type === "idle") {
-    return "session_idle";
-  }
-  if (event.type === "message.completed" || event.type === "message.failed" || event.type === "message.errored") {
-    return "session_idle";
-  }
-  return null;
-}
-
-// src/index.ts
-var serviceName = "opencode-feishu-notifier";
-var FeishuNotifierPlugin = async ({ client, directory }) => {
-  let configCache = null;
-  let configError = null;
-  const log = (level, message, extra) => {
-    const payload = {
-      body: {
-        service: serviceName,
-        level,
-        message,
-        extra
-      }
-    };
-    void client.app.log(payload).catch(() => void 0);
-  };
-  const logDebug = (message, extra) => {
-    log("debug", message, extra);
-  };
-  const logInfo = (message, extra) => {
-    log("info", message, extra);
-  };
-  const logError = (message, extra) => {
-    log("error", message, extra);
-  };
-  logInfo("Feishu notifier plugin loading", { directory });
-  const ensureConfig = () => {
-    if (configCache || configError) {
-      return;
-    }
-    try {
-      configCache = loadConfigWithSource({ directory });
-      logInfo("Feishu notifier plugin initialized", { sources: configCache.sources.map((s) => s.type) });
-      logDebug("Loaded Feishu config", { sources: configCache.sources });
-    } catch (error) {
-      configError = error instanceof Error ? error : new Error(String(error));
-      logError("Feishu config error", { error: configError.message });
-    }
-  };
-  ensureConfig();
-  return {
-    event: async ({ event }) => {
-      recordEventContext(event);
-      logDebug("Event received", { eventType: event.type });
-      let notificationType = mapEventToNotification(event.type);
-      notificationType = notificationType ?? mapCompletionEventToNotification(event);
-      if (!notificationType) {
-        logDebug("Event ignored", { eventType: event.type });
-        return;
-      }
-      logDebug("Event mapped to notification", {
-        eventType: event.type,
-        notificationType
-      });
-      ensureConfig();
-      if (configError) {
-        logError("Feishu config error (cached)", { error: configError.message });
-        return;
-      }
-      if (!configCache) {
-        logError("Feishu config not loaded");
-        return;
-      }
-      const { text, title, richContent } = await buildNotification(
-        notificationType,
-        event,
-        directory,
-        { session: client.session }
-      );
-      logDebug("Sending Feishu notification", {
-        eventType: event.type,
-        notificationType,
-        directory,
-        hasRichContent: !!richContent
-      });
-      try {
-        let response;
-        if (richContent) {
-          try {
-            logDebug("Attempting to send rich text message", {
-              richContentType: typeof richContent,
-              hasPost: !!richContent.post,
-              hasZhCn: !!richContent.post?.zh_cn,
-              titleLength: richContent.post?.zh_cn?.title?.length ?? 0,
-              contentLength: richContent.post?.zh_cn?.content?.length ?? 0
-            });
-            response = await sendRichTextMessage(configCache.config, text, title, richContent);
-            logDebug("Feishu rich notification sent", {
-              messageId: response.data?.message_id ?? null
-            });
-          } catch (richError) {
-            logDebug("Rich text message failed, falling back to text", {
-              error: richError instanceof Error ? richError.message : String(richError),
-              stack: richError instanceof Error ? richError.stack : void 0,
-              name: richError instanceof Error ? richError.name : void 0
-            });
-            response = await sendTextMessage(configCache.config, text);
-            logDebug("Feishu text notification sent (fallback)", {
-              messageId: response.data?.message_id ?? null
-            });
-          }
-        } else {
-          response = await sendTextMessage(configCache.config, text);
-          logDebug("Feishu text notification sent", {
-            messageId: response.data?.message_id ?? null
-          });
-        }
-      } catch (error) {
-        logError("Failed to send Feishu notification", {
-          error: String(error)
-        });
-      }
-    }
-  };
-};
-var index_default = FeishuNotifierPlugin;
-export {
-  index_default as default
-};
-//# sourceMappingURL=index.js.map