@fased/fased 0.1.36 → 0.1.37

package/extensions/feishu/src/wiki.ts

@@ -1,237 +0,0 @@
-import type * as Lark from "@larksuiteoapi/node-sdk";
-import type { FasedAgentPluginApi } from "fased/plugin-sdk";
-import { listEnabledFeishuAccounts } from "./accounts.js";
-import { createFeishuToolClient, resolveAnyEnabledFeishuToolsConfig } from "./tool-account.js";
-import { FeishuWikiSchema, type FeishuWikiParams } from "./wiki-schema.js";
-
-// ============ Helpers ============
-
-function json(data: unknown) {
-  return {
-    content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }],
-    details: data,
-  };
-}
-
-type ObjType = "doc" | "sheet" | "mindnote" | "bitable" | "file" | "docx" | "slides";
-
-// ============ Actions ============
-
-const WIKI_ACCESS_HINT =
-  "To grant wiki access: Open wiki space → Settings → Members → Add the bot. " +
-  "See: https://open.feishu.cn/document/server-docs/docs/wiki-v2/wiki-qa#a40ad4ca";
-
-async function listSpaces(client: Lark.Client) {
-  const res = await client.wiki.space.list({});
-  if (res.code !== 0) {
-    throw new Error(res.msg);
-  }
-
-  const spaces =
-    res.data?.items?.map((s) => ({
-      space_id: s.space_id,
-      name: s.name,
-      description: s.description,
-      visibility: s.visibility,
-    })) ?? [];
-
-  return {
-    spaces,
-    ...(spaces.length === 0 && { hint: WIKI_ACCESS_HINT }),
-  };
-}
-
-async function listNodes(client: Lark.Client, spaceId: string, parentNodeToken?: string) {
-  const res = await client.wiki.spaceNode.list({
-    path: { space_id: spaceId },
-    params: { parent_node_token: parentNodeToken },
-  });
-  if (res.code !== 0) {
-    throw new Error(res.msg);
-  }
-
-  return {
-    nodes:
-      res.data?.items?.map((n) => ({
-        node_token: n.node_token,
-        obj_token: n.obj_token,
-        obj_type: n.obj_type,
-        title: n.title,
-        has_child: n.has_child,
-      })) ?? [],
-  };
-}
-
-async function getNode(client: Lark.Client, token: string) {
-  const res = await client.wiki.space.getNode({
-    params: { token },
-  });
-  if (res.code !== 0) {
-    throw new Error(res.msg);
-  }
-
-  const node = res.data?.node;
-  return {
-    node_token: node?.node_token,
-    space_id: node?.space_id,
-    obj_token: node?.obj_token,
-    obj_type: node?.obj_type,
-    title: node?.title,
-    parent_node_token: node?.parent_node_token,
-    has_child: node?.has_child,
-    creator: node?.creator,
-    create_time: node?.node_create_time,
-  };
-}
-
-async function createNode(
-  client: Lark.Client,
-  spaceId: string,
-  title: string,
-  objType?: string,
-  parentNodeToken?: string,
-) {
-  const res = await client.wiki.spaceNode.create({
-    path: { space_id: spaceId },
-    data: {
-      obj_type: (objType as ObjType) || "docx",
-      node_type: "origin" as const,
-      title,
-      parent_node_token: parentNodeToken,
-    },
-  });
-  if (res.code !== 0) {
-    throw new Error(res.msg);
-  }
-
-  const node = res.data?.node;
-  return {
-    node_token: node?.node_token,
-    obj_token: node?.obj_token,
-    obj_type: node?.obj_type,
-    title: node?.title,
-  };
-}
-
-async function moveNode(
-  client: Lark.Client,
-  spaceId: string,
-  nodeToken: string,
-  targetSpaceId?: string,
-  targetParentToken?: string,
-) {
-  const res = await client.wiki.spaceNode.move({
-    path: { space_id: spaceId, node_token: nodeToken },
-    data: {
-      target_space_id: targetSpaceId || spaceId,
-      target_parent_token: targetParentToken,
-    },
-  });
-  if (res.code !== 0) {
-    throw new Error(res.msg);
-  }
-
-  return {
-    success: true,
-    node_token: res.data?.node?.node_token,
-  };
-}
-
-async function renameNode(client: Lark.Client, spaceId: string, nodeToken: string, title: string) {
-  const res = await client.wiki.spaceNode.updateTitle({
-    path: { space_id: spaceId, node_token: nodeToken },
-    data: { title },
-  });
-  if (res.code !== 0) {
-    throw new Error(res.msg);
-  }
-
-  return {
-    success: true,
-    node_token: nodeToken,
-    title,
-  };
-}
-
-// ============ Tool Registration ============
-
-export function registerFeishuWikiTools(api: FasedAgentPluginApi) {
-  if (!api.config) {
-    api.logger.debug?.("feishu_wiki: No config available, skipping wiki tools");
-    return;
-  }
-
-  const accounts = listEnabledFeishuAccounts(api.config);
-  if (accounts.length === 0) {
-    api.logger.debug?.("feishu_wiki: No Feishu accounts configured, skipping wiki tools");
-    return;
-  }
-
-  const toolsCfg = resolveAnyEnabledFeishuToolsConfig(accounts);
-  if (!toolsCfg.wiki) {
-    api.logger.debug?.("feishu_wiki: wiki tool disabled in config");
-    return;
-  }
-
-  type FeishuWikiExecuteParams = FeishuWikiParams & { accountId?: string };
-
-  api.registerTool(
-    (ctx) => {
-      const defaultAccountId = ctx.agentAccountId;
-      return {
-        name: "feishu_wiki",
-        label: "Feishu Wiki",
-        description:
-          "Feishu knowledge base operations. Actions: spaces, nodes, get, create, move, rename",
-        parameters: FeishuWikiSchema,
-        async execute(_toolCallId, params) {
-          const p = params as FeishuWikiExecuteParams;
-          try {
-            const client = createFeishuToolClient({
-              api,
-              executeParams: p,
-              defaultAccountId,
-            });
-            switch (p.action) {
-              case "spaces":
-                return json(await listSpaces(client));
-              case "nodes":
-                return json(await listNodes(client, p.space_id, p.parent_node_token));
-              case "get":
-                return json(await getNode(client, p.token));
-              case "search":
-                return json({
-                  error:
-                    "Search is not available. Use feishu_wiki with action: 'nodes' to browse or action: 'get' to lookup by token.",
-                });
-              case "create":
-                return json(
-                  await createNode(client, p.space_id, p.title, p.obj_type, p.parent_node_token),
-                );
-              case "move":
-                return json(
-                  await moveNode(
-                    client,
-                    p.space_id,
-                    p.node_token,
-                    p.target_space_id,
-                    p.target_parent_token,
-                  ),
-                );
-              case "rename":
-                return json(await renameNode(client, p.space_id, p.node_token, p.title));
-              default:
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- exhaustive check fallback
-                return json({ error: `Unknown action: ${(p as any).action}` });
-            }
-          } catch (err) {
-            return json({ error: err instanceof Error ? err.message : String(err) });
-          }
-        },
-      };
-    },
-    { name: "feishu_wiki" },
-  );
-
-  api.logger.debug?.(`feishu_wiki: Registered feishu_wiki tool`);
-}

package/extensions/googlechat/fased.plugin.json

@@ -1,9 +0,0 @@
-{
-  "id": "googlechat",
-  "channels": ["googlechat"],
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {}
-  }
-}

package/extensions/googlechat/index.ts

@@ -1,19 +0,0 @@
-import type { FasedAgentPluginApi } from "fased/plugin-sdk";
-import { emptyPluginConfigSchema } from "fased/plugin-sdk";
-import { googlechatDock, googlechatPlugin } from "./src/channel.js";
-import { handleGoogleChatWebhookRequest } from "./src/monitor.js";
-import { setGoogleChatRuntime } from "./src/runtime.js";
-
-const plugin = {
-  id: "googlechat",
-  name: "Google Chat",
-  description: "FasedAgent Google Chat channel plugin",
-  configSchema: emptyPluginConfigSchema(),
-  register(api: FasedAgentPluginApi) {
-    setGoogleChatRuntime(api.runtime);
-    api.registerChannel({ plugin: googlechatPlugin, dock: googlechatDock });
-    api.registerHttpHandler(handleGoogleChatWebhookRequest);
-  },
-};
-
-export default plugin;

package/extensions/googlechat/package.json

@@ -1,37 +0,0 @@
-{
-  "name": "@fased/googlechat",
-  "version": "0.1.36",
-  "private": true,
-  "description": "FasedAgent Google Chat channel plugin",
-  "type": "module",
-  "dependencies": {
-    "google-auth-library": "^10.6.1"
-  },
-  "peerDependencies": {
-    "@fased/fased": "^0.1.36"
-  },
-  "fased": {
-    "extensions": [
-      "./index.ts"
-    ],
-    "channel": {
-      "id": "googlechat",
-      "label": "Google Chat",
-      "selectionLabel": "Google Chat (Chat API)",
-      "detailLabel": "Google Chat",
-      "docsPath": "/channels/googlechat",
-      "docsLabel": "googlechat",
-      "blurb": "Google Workspace Chat app via HTTP webhooks.",
-      "aliases": [
-        "gchat",
-        "google-chat"
-      ],
-      "order": 55
-    },
-    "install": {
-      "npmSpec": "@fased/googlechat",
-      "localPath": "extensions/googlechat",
-      "defaultChoice": "local"
-    }
-  }
-}

package/extensions/googlechat/src/accounts.ts

@@ -1,147 +0,0 @@
-import type { FasedAgentConfig } from "fased/plugin-sdk";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "fased/plugin-sdk/account-id";
-import type { GoogleChatAccountConfig } from "./types.config.js";
-
-export type GoogleChatCredentialSource = "file" | "inline" | "env" | "none";
-
-export type ResolvedGoogleChatAccount = {
-  accountId: string;
-  name?: string;
-  enabled: boolean;
-  config: GoogleChatAccountConfig;
-  credentialSource: GoogleChatCredentialSource;
-  credentials?: Record<string, unknown>;
-  credentialsFile?: string;
-};
-
-const ENV_SERVICE_ACCOUNT = "GOOGLE_CHAT_SERVICE_ACCOUNT";
-const ENV_SERVICE_ACCOUNT_FILE = "GOOGLE_CHAT_SERVICE_ACCOUNT_FILE";
-
-function listConfiguredAccountIds(cfg: FasedAgentConfig): string[] {
-  const accounts = cfg.channels?.["googlechat"]?.accounts;
-  if (!accounts || typeof accounts !== "object") {
-    return [];
-  }
-  return Object.keys(accounts).filter(Boolean);
-}
-
-export function listGoogleChatAccountIds(cfg: FasedAgentConfig): string[] {
-  const ids = listConfiguredAccountIds(cfg);
-  if (ids.length === 0) {
-    return [DEFAULT_ACCOUNT_ID];
-  }
-  return ids.toSorted((a, b) => a.localeCompare(b));
-}
-
-export function resolveDefaultGoogleChatAccountId(cfg: FasedAgentConfig): string {
-  const channel = cfg.channels?.["googlechat"];
-  if (channel?.defaultAccount?.trim()) {
-    return channel.defaultAccount.trim();
-  }
-  const ids = listGoogleChatAccountIds(cfg);
-  if (ids.includes(DEFAULT_ACCOUNT_ID)) {
-    return DEFAULT_ACCOUNT_ID;
-  }
-  return ids[0] ?? DEFAULT_ACCOUNT_ID;
-}
-
-function resolveAccountConfig(
-  cfg: FasedAgentConfig,
-  accountId: string,
-): GoogleChatAccountConfig | undefined {
-  const accounts = cfg.channels?.["googlechat"]?.accounts;
-  if (!accounts || typeof accounts !== "object") {
-    return undefined;
-  }
-  return accounts[accountId];
-}
-
-function mergeGoogleChatAccountConfig(
-  cfg: FasedAgentConfig,
-  accountId: string,
-): GoogleChatAccountConfig {
-  const raw = cfg.channels?.["googlechat"] ?? {};
-  const { accounts: _ignored, defaultAccount: _ignored2, ...base } = raw;
-  const account = resolveAccountConfig(cfg, accountId) ?? {};
-  return { ...base, ...account } as GoogleChatAccountConfig;
-}
-
-function parseServiceAccount(value: unknown): Record<string, unknown> | null {
-  if (value && typeof value === "object") {
-    return value as Record<string, unknown>;
-  }
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  try {
-    return JSON.parse(trimmed) as Record<string, unknown>;
-  } catch {
-    return null;
-  }
-}
-
-function resolveCredentialsFromConfig(params: {
-  accountId: string;
-  account: GoogleChatAccountConfig;
-}): {
-  credentials?: Record<string, unknown>;
-  credentialsFile?: string;
-  source: GoogleChatCredentialSource;
-} {
-  const { account, accountId } = params;
-  const inline = parseServiceAccount(account.serviceAccount);
-  if (inline) {
-    return { credentials: inline, source: "inline" };
-  }
-
-  const file = account.serviceAccountFile?.trim();
-  if (file) {
-    return { credentialsFile: file, source: "file" };
-  }
-
-  if (accountId === DEFAULT_ACCOUNT_ID) {
-    const envJson = process.env[ENV_SERVICE_ACCOUNT];
-    const envInline = parseServiceAccount(envJson);
-    if (envInline) {
-      return { credentials: envInline, source: "env" };
-    }
-    const envFile = process.env[ENV_SERVICE_ACCOUNT_FILE]?.trim();
-    if (envFile) {
-      return { credentialsFile: envFile, source: "env" };
-    }
-  }
-
-  return { source: "none" };
-}
-
-export function resolveGoogleChatAccount(params: {
-  cfg: FasedAgentConfig;
-  accountId?: string | null;
-}): ResolvedGoogleChatAccount {
-  const accountId = normalizeAccountId(params.accountId);
-  const baseEnabled = params.cfg.channels?.["googlechat"]?.enabled !== false;
-  const merged = mergeGoogleChatAccountConfig(params.cfg, accountId);
-  const accountEnabled = merged.enabled !== false;
-  const enabled = baseEnabled && accountEnabled;
-  const credentials = resolveCredentialsFromConfig({ accountId, account: merged });
-
-  return {
-    accountId,
-    name: merged.name?.trim() || undefined,
-    enabled,
-    config: merged,
-    credentialSource: credentials.source,
-    credentials: credentials.credentials,
-    credentialsFile: credentials.credentialsFile,
-  };
-}
-
-export function listEnabledGoogleChatAccounts(cfg: FasedAgentConfig): ResolvedGoogleChatAccount[] {
-  return listGoogleChatAccountIds(cfg)
-    .map((accountId) => resolveGoogleChatAccount({ cfg, accountId }))
-    .filter((account) => account.enabled);
-}

package/extensions/googlechat/src/actions.ts

@@ -1,176 +0,0 @@
-import type {
-  ChannelMessageActionAdapter,
-  ChannelMessageActionName,
-  FasedAgentConfig,
-} from "fased/plugin-sdk";
-import {
-  createActionGate,
-  extractToolSend,
-  jsonResult,
-  readNumberParam,
-  readReactionParams,
-  readStringParam,
-} from "fased/plugin-sdk";
-import { listEnabledGoogleChatAccounts, resolveGoogleChatAccount } from "./accounts.js";
-import {
-  createGoogleChatReaction,
-  deleteGoogleChatReaction,
-  listGoogleChatReactions,
-  sendGoogleChatMessage,
-  uploadGoogleChatAttachment,
-} from "./api.js";
-import { getGoogleChatRuntime } from "./runtime.js";
-import { resolveGoogleChatOutboundSpace } from "./targets.js";
-
-const providerId = "googlechat";
-
-function listEnabledAccounts(cfg: FasedAgentConfig) {
-  return listEnabledGoogleChatAccounts(cfg).filter(
-    (account) => account.enabled && account.credentialSource !== "none",
-  );
-}
-
-function isReactionsEnabled(
-  accounts: ReturnType<typeof listEnabledAccounts>,
-  cfg: FasedAgentConfig,
-) {
-  for (const account of accounts) {
-    const gate = createActionGate(
-      (account.config.actions ??
-        (cfg.channels?.["googlechat"] as { actions?: unknown })?.actions) as Record<
-        string,
-        boolean | undefined
-      >,
-    );
-    if (gate("reactions")) {
-      return true;
-    }
-  }
-  return false;
-}
-
-function resolveAppUserNames(account: { config: { botUser?: string | null } }) {
-  return new Set(["users/app", account.config.botUser?.trim()].filter(Boolean) as string[]);
-}
-
-export const googlechatMessageActions: ChannelMessageActionAdapter = {
-  listActions: ({ cfg }) => {
-    const accounts = listEnabledAccounts(cfg);
-    if (accounts.length === 0) {
-      return [];
-    }
-    const actions = new Set<ChannelMessageActionName>([]);
-    actions.add("send");
-    if (isReactionsEnabled(accounts, cfg)) {
-      actions.add("react");
-      actions.add("reactions");
-    }
-    return Array.from(actions);
-  },
-  extractToolSend: ({ args }) => {
-    return extractToolSend(args, "sendMessage");
-  },
-  handleAction: async ({ action, params, cfg, accountId }) => {
-    const account = resolveGoogleChatAccount({
-      cfg: cfg,
-      accountId,
-    });
-    if (account.credentialSource === "none") {
-      throw new Error("Google Chat credentials are missing.");
-    }
-
-    if (action === "send") {
-      const to = readStringParam(params, "to", { required: true });
-      const content = readStringParam(params, "message", {
-        required: true,
-        allowEmpty: true,
-      });
-      const mediaUrl = readStringParam(params, "media", { trim: false });
-      const threadId = readStringParam(params, "threadId") ?? readStringParam(params, "replyTo");
-      const space = await resolveGoogleChatOutboundSpace({ account, target: to });
-
-      if (mediaUrl) {
-        const core = getGoogleChatRuntime();
-        const maxBytes = (account.config.mediaMaxMb ?? 20) * 1024 * 1024;
-        const loaded = await core.channel.media.fetchRemoteMedia({ url: mediaUrl, maxBytes });
-        const upload = await uploadGoogleChatAttachment({
-          account,
-          space,
-          filename: loaded.fileName ?? "attachment",
-          buffer: loaded.buffer,
-          contentType: loaded.contentType,
-        });
-        await sendGoogleChatMessage({
-          account,
-          space,
-          text: content,
-          thread: threadId ?? undefined,
-          attachments: upload.attachmentUploadToken
-            ? [
-                {
-                  attachmentUploadToken: upload.attachmentUploadToken,
-                  contentName: loaded.fileName,
-                },
-              ]
-            : undefined,
-        });
-        return jsonResult({ ok: true, to: space });
-      }
-
-      await sendGoogleChatMessage({
-        account,
-        space,
-        text: content,
-        thread: threadId ?? undefined,
-      });
-      return jsonResult({ ok: true, to: space });
-    }
-
-    if (action === "react") {
-      const messageName = readStringParam(params, "messageId", { required: true });
-      const { emoji, remove, isEmpty } = readReactionParams(params, {
-        removeErrorMessage: "Emoji is required to remove a Google Chat reaction.",
-      });
-      if (remove || isEmpty) {
-        const reactions = await listGoogleChatReactions({ account, messageName });
-        const appUsers = resolveAppUserNames(account);
-        const toRemove = reactions.filter((reaction) => {
-          const userName = reaction.user?.name?.trim();
-          if (appUsers.size > 0 && !appUsers.has(userName ?? "")) {
-            return false;
-          }
-          if (emoji) {
-            return reaction.emoji?.unicode === emoji;
-          }
-          return true;
-        });
-        for (const reaction of toRemove) {
-          if (!reaction.name) {
-            continue;
-          }
-          await deleteGoogleChatReaction({ account, reactionName: reaction.name });
-        }
-        return jsonResult({ ok: true, removed: toRemove.length });
-      }
-      const reaction = await createGoogleChatReaction({
-        account,
-        messageName,
-        emoji,
-      });
-      return jsonResult({ ok: true, reaction });
-    }
-
-    if (action === "reactions") {
-      const messageName = readStringParam(params, "messageId", { required: true });
-      const limit = readNumberParam(params, "limit", { integer: true });
-      const reactions = await listGoogleChatReactions({
-        account,
-        messageName,
-        limit: limit ?? undefined,
-      });
-      return jsonResult({ ok: true, reactions });
-    }
-
-    throw new Error(`Action ${action} is not supported for provider ${providerId}.`);
-  },
-};