@gakr-gakr/feishu 0.1.0

package/src/card-ux-approval.ts

@@ -0,0 +1,65 @@
+import { createFeishuCardInteractionEnvelope } from "./card-interaction.js";
+import { buildFeishuCardButton, buildFeishuCardInteractionContext } from "./card-ux-shared.js";
+
+export const FEISHU_APPROVAL_REQUEST_ACTION = "feishu.quick_actions.request_approval";
+export const FEISHU_APPROVAL_CONFIRM_ACTION = "feishu.approval.confirm";
+export const FEISHU_APPROVAL_CANCEL_ACTION = "feishu.approval.cancel";
+
+export function createApprovalCard(params: {
+  operatorOpenId: string;
+  chatId?: string;
+  command: string;
+  prompt: string;
+  expiresAt: number;
+  chatType?: "p2p" | "group";
+  sessionKey?: string;
+  confirmLabel?: string;
+  cancelLabel?: string;
+}): Record<string, unknown> {
+  const context = buildFeishuCardInteractionContext(params);
+
+  return {
+    schema: "2.0",
+    config: {
+      width_mode: "fill",
+    },
+    header: {
+      title: {
+        tag: "plain_text",
+        content: "Confirm action",
+      },
+      template: "orange",
+    },
+    body: {
+      elements: [
+        {
+          tag: "markdown",
+          content: params.prompt,
+        },
+        {
+          tag: "action",
+          actions: [
+            buildFeishuCardButton({
+              label: params.confirmLabel ?? "Confirm",
+              type: "primary",
+              value: createFeishuCardInteractionEnvelope({
+                k: "quick",
+                a: FEISHU_APPROVAL_CONFIRM_ACTION,
+                q: params.command,
+                c: context,
+              }),
+            }),
+            buildFeishuCardButton({
+              label: params.cancelLabel ?? "Cancel",
+              value: createFeishuCardInteractionEnvelope({
+                k: "button",
+                a: FEISHU_APPROVAL_CANCEL_ACTION,
+                c: context,
+              }),
+            }),
+          ],
+        },
+      ],
+    },
+  };
+}

package/src/card-ux-launcher.ts

@@ -0,0 +1,121 @@
+import { normalizeOptionalLowercaseString } from "autobot/plugin-sdk/string-coerce-runtime";
+import type { ClawdbotConfig, RuntimeEnv } from "../runtime-api.js";
+import { createFeishuCardInteractionEnvelope } from "./card-interaction.js";
+import { FEISHU_APPROVAL_REQUEST_ACTION } from "./card-ux-approval.js";
+import { buildFeishuCardButton, buildFeishuCardInteractionContext } from "./card-ux-shared.js";
+import { sendCardFeishu } from "./send.js";
+
+const FEISHU_QUICK_ACTION_CARD_TTL_MS = 10 * 60_000;
+
+const QUICK_ACTION_MENU_KEYS = new Set(["quick-actions", "quick_actions", "launcher"]);
+
+export function isFeishuQuickActionMenuEventKey(eventKey: string): boolean {
+  return QUICK_ACTION_MENU_KEYS.has(normalizeOptionalLowercaseString(eventKey) ?? "");
+}
+
+export function createQuickActionLauncherCard(params: {
+  operatorOpenId: string;
+  chatId?: string;
+  expiresAt: number;
+  chatType?: "p2p" | "group";
+  sessionKey?: string;
+}): Record<string, unknown> {
+  const context = buildFeishuCardInteractionContext(params);
+  return {
+    schema: "2.0",
+    config: {
+      width_mode: "fill",
+    },
+    header: {
+      title: {
+        tag: "plain_text",
+        content: "Quick actions",
+      },
+      template: "indigo",
+    },
+    body: {
+      elements: [
+        {
+          tag: "markdown",
+          content: "Run common actions without typing raw commands.",
+        },
+        {
+          tag: "action",
+          actions: [
+            buildFeishuCardButton({
+              label: "Help",
+              value: createFeishuCardInteractionEnvelope({
+                k: "quick",
+                a: "feishu.quick_actions.help",
+                q: "/help",
+                c: context,
+              }),
+            }),
+            buildFeishuCardButton({
+              label: "New session",
+              type: "primary",
+              value: createFeishuCardInteractionEnvelope({
+                k: "meta",
+                a: FEISHU_APPROVAL_REQUEST_ACTION,
+                m: {
+                  command: "/new",
+                  prompt: "Start a fresh session? This will reset the current chat context.",
+                },
+                c: context,
+              }),
+            }),
+            buildFeishuCardButton({
+              label: "Reset",
+              type: "danger",
+              value: createFeishuCardInteractionEnvelope({
+                k: "meta",
+                a: FEISHU_APPROVAL_REQUEST_ACTION,
+                m: {
+                  command: "/reset",
+                  prompt: "Reset this session now? Any active conversation state will be cleared.",
+                },
+                c: context,
+              }),
+            }),
+          ],
+        },
+      ],
+    },
+  };
+}
+
+export async function maybeHandleFeishuQuickActionMenu(params: {
+  cfg: ClawdbotConfig;
+  eventKey: string;
+  operatorOpenId: string;
+  runtime?: RuntimeEnv;
+  accountId?: string;
+  now?: number;
+}): Promise<boolean> {
+  if (!isFeishuQuickActionMenuEventKey(params.eventKey)) {
+    return false;
+  }
+
+  const expiresAt = (params.now ?? Date.now()) + FEISHU_QUICK_ACTION_CARD_TTL_MS;
+  try {
+    await sendCardFeishu({
+      cfg: params.cfg,
+      to: `user:${params.operatorOpenId}`,
+      card: createQuickActionLauncherCard({
+        operatorOpenId: params.operatorOpenId,
+        expiresAt,
+        chatType: "p2p",
+      }),
+      accountId: params.accountId,
+    });
+  } catch (err) {
+    params.runtime?.log?.(
+      `feishu[${params.accountId ?? "default"}]: failed to open quick-action launcher for ${params.operatorOpenId}: ${String(err)}`,
+    );
+    return false;
+  }
+  params.runtime?.log?.(
+    `feishu[${params.accountId ?? "default"}]: opened quick-action launcher for ${params.operatorOpenId}`,
+  );
+  return true;
+}

package/src/card-ux-shared.ts

@@ -0,0 +1,33 @@
+import type { FeishuCardInteractionEnvelope } from "./card-interaction.js";
+
+export function buildFeishuCardButton(params: {
+  label: string;
+  value: FeishuCardInteractionEnvelope;
+  type?: "default" | "primary" | "danger";
+}) {
+  return {
+    tag: "button",
+    text: {
+      tag: "plain_text",
+      content: params.label,
+    },
+    type: params.type ?? "default",
+    value: params.value,
+  };
+}
+
+export function buildFeishuCardInteractionContext(params: {
+  operatorOpenId: string;
+  chatId?: string;
+  expiresAt: number;
+  chatType?: "p2p" | "group";
+  sessionKey?: string;
+}) {
+  return {
+    u: params.operatorOpenId,
+    ...(params.chatId ? { h: params.chatId } : {}),
+    ...(params.sessionKey ? { s: params.sessionKey } : {}),
+    e: params.expiresAt,
+    ...(params.chatType ? { t: params.chatType } : {}),
+  };
+}

package/src/channel-runtime-api.ts

@@ -0,0 +1,16 @@
+export type {
+  ChannelMessageActionName,
+  ChannelMeta,
+  ChannelPlugin,
+  ClawdbotConfig,
+} from "../runtime-api.js";
+
+export { DEFAULT_ACCOUNT_ID } from "autobot/plugin-sdk/account-resolution";
+export { createActionGate } from "autobot/plugin-sdk/channel-actions";
+export { buildChannelConfigSchema } from "autobot/plugin-sdk/channel-config-primitives";
+export {
+  buildProbeChannelStatusSummary,
+  createDefaultChannelRuntimeState,
+} from "autobot/plugin-sdk/status-helpers";
+export { PAIRING_APPROVED_MESSAGE } from "autobot/plugin-sdk/channel-status";
+export { chunkTextForOutbound } from "autobot/plugin-sdk/text-chunking";

package/src/channel.runtime.ts

@@ -0,0 +1,47 @@
+import {
+  getChatInfo as getChatInfoImpl,
+  getChatMembers as getChatMembersImpl,
+  getFeishuMemberInfo as getFeishuMemberInfoImpl,
+} from "./chat.js";
+import {
+  listFeishuDirectoryGroupsLive as listFeishuDirectoryGroupsLiveImpl,
+  listFeishuDirectoryPeersLive as listFeishuDirectoryPeersLiveImpl,
+} from "./directory.js";
+import { feishuOutbound as feishuOutboundImpl } from "./outbound.js";
+import {
+  createPinFeishu as createPinFeishuImpl,
+  listPinsFeishu as listPinsFeishuImpl,
+  removePinFeishu as removePinFeishuImpl,
+} from "./pins.js";
+import { probeFeishu as probeFeishuImpl } from "./probe.js";
+import {
+  addReactionFeishu as addReactionFeishuImpl,
+  listReactionsFeishu as listReactionsFeishuImpl,
+  removeReactionFeishu as removeReactionFeishuImpl,
+} from "./reactions.js";
+import {
+  editMessageFeishu as editMessageFeishuImpl,
+  getMessageFeishu as getMessageFeishuImpl,
+  sendCardFeishu as sendCardFeishuImpl,
+  sendMessageFeishu as sendMessageFeishuImpl,
+} from "./send.js";
+
+export const feishuChannelRuntime = {
+  listFeishuDirectoryGroupsLive: listFeishuDirectoryGroupsLiveImpl,
+  listFeishuDirectoryPeersLive: listFeishuDirectoryPeersLiveImpl,
+  feishuOutbound: { ...feishuOutboundImpl },
+  createPinFeishu: createPinFeishuImpl,
+  listPinsFeishu: listPinsFeishuImpl,
+  removePinFeishu: removePinFeishuImpl,
+  probeFeishu: probeFeishuImpl,
+  addReactionFeishu: addReactionFeishuImpl,
+  listReactionsFeishu: listReactionsFeishuImpl,
+  removeReactionFeishu: removeReactionFeishuImpl,
+  getChatInfo: getChatInfoImpl,
+  getChatMembers: getChatMembersImpl,
+  getFeishuMemberInfo: getFeishuMemberInfoImpl,
+  editMessageFeishu: editMessageFeishuImpl,
+  getMessageFeishu: getMessageFeishuImpl,
+  sendCardFeishu: sendCardFeishuImpl,
+  sendMessageFeishu: sendMessageFeishuImpl,
+};