@botcord/daemon 0.2.35 → 0.2.37

package/src/config.ts

@@ -95,10 +95,35 @@ export interface OpenclawDiscoveryConfig {
   searchPaths?: string[];
   /** Overrides the local loopback ports to probe. */
   defaultPorts?: number[];
-  /** Defaults to true. When false, discovery only persists gateways. */
+  /** Defaults to false. When false, discovery only persists gateways. */
   autoProvision?: boolean;
 }
 
+/** Third-party messaging provider supported by the daemon's channel factory. */
+export type ThirdPartyGatewayType = "telegram" | "wechat";
+
+/**
+ * One third-party gateway profile bound to a BotCord agent. `id` is the
+ * channel id (typically `gw_...` minted by the Hub); `accountId` is the
+ * BotCord agent the inbound traffic should be attributed to. Secrets and
+ * provider cursors live outside this struct — see `secretFile` and
+ * `stateFile`. When omitted, the daemon derives them as
+ * `~/.botcord/daemon/gateways/{id}.json` and `{id}.state.json`.
+ */
+export interface ThirdPartyGatewayProfile {
+  id: string;
+  type: ThirdPartyGatewayType;
+  accountId: string;
+  label?: string;
+  enabled?: boolean;
+  secretFile?: string;
+  stateFile?: string;
+  allowedSenderIds?: string[];
+  allowedChatIds?: string[];
+  splitAt?: number;
+  baseUrl?: string;
+}
+
 export interface DaemonConfig {
   /**
    * @deprecated Kept for backward compatibility with pre-multi-agent configs.
@@ -148,6 +173,13 @@ export interface DaemonConfig {
    * search paths/ports and automatic adoption of discovered agents.
    */
   openclawDiscovery?: OpenclawDiscoveryConfig;
+
+  /**
+   * Third-party messaging gateways (Telegram, WeChat, …) bound to BotCord
+   * agents on this daemon. Each entry becomes one channel in the gateway
+   * runtime; `enabled === false` entries are filtered out at boot.
+   */
+  thirdPartyGateways?: ThirdPartyGatewayProfile[];
 }
 
 /**
@@ -393,6 +425,45 @@ export function loadConfig(): DaemonConfig {
     }
     out.openclawDiscovery = copy;
   }
+  const tpg = (parsed as Partial<DaemonConfig>).thirdPartyGateways;
+  if (tpg !== undefined) {
+    if (!Array.isArray(tpg)) {
+      throw new Error(
+        `daemon config "thirdPartyGateways" must be an array (${CONFIG_PATH})`,
+      );
+    }
+    const seen = new Set<string>();
+    for (const [i, g] of tpg.entries()) {
+      if (!g || typeof g !== "object") {
+        throw new Error(
+          `daemon config thirdPartyGateways[${i}] is not an object (${CONFIG_PATH})`,
+        );
+      }
+      const gg = g as Partial<ThirdPartyGatewayProfile>;
+      if (typeof gg.id !== "string" || gg.id.length === 0) {
+        throw new Error(
+          `daemon config thirdPartyGateways[${i}].id must be a non-empty string (${CONFIG_PATH})`,
+        );
+      }
+      if (gg.type !== "telegram" && gg.type !== "wechat") {
+        throw new Error(
+          `daemon config thirdPartyGateways[${i}].type must be "telegram" or "wechat" (${CONFIG_PATH})`,
+        );
+      }
+      if (typeof gg.accountId !== "string" || gg.accountId.length === 0) {
+        throw new Error(
+          `daemon config thirdPartyGateways[${i}].accountId must be a non-empty string (${CONFIG_PATH})`,
+        );
+      }
+      if (seen.has(gg.id)) {
+        throw new Error(
+          `daemon config thirdPartyGateways[${i}].id "${gg.id}" duplicated (${CONFIG_PATH})`,
+        );
+      }
+      seen.add(gg.id);
+    }
+    out.thirdPartyGateways = (tpg as ThirdPartyGatewayProfile[]).map((g) => ({ ...g }));
+  }
   return out;
 }
 

package/src/daemon-config-map.ts

@@ -135,6 +135,10 @@ export const DEFAULT_BOTCORD_CHANNEL_ID = "botcord-main";
 /** Channel `type` tag used by `createBotCordChannel`. */
 export const BOTCORD_CHANNEL_TYPE = "botcord";
 
+/** Channel `type` tags for built-in third-party providers. */
+export const TELEGRAM_CHANNEL_TYPE = "telegram";
+export const WECHAT_CHANNEL_TYPE = "wechat";
+
 /**
  * Map daemon's historical narrower TrustLevel ("owner" | "untrusted") onto
  * gateway's ("owner" | "trusted" | "public"). Matches the adapter-level
@@ -241,6 +245,26 @@ export function toGatewayConfig(
     agentId,
   }));
 
+  // Append one channel per enabled third-party gateway. Disabled entries are
+  // dropped here so the gateway runtime never sees them; re-enabling requires
+  // an `upsert_gateway` (Phase B) or a config reload.
+  for (const g of cfg.thirdPartyGateways ?? []) {
+    if (g.enabled === false) continue;
+    const ch: GatewayChannelConfig = {
+      id: g.id,
+      type: g.type,
+      accountId: g.accountId,
+    };
+    if (g.label !== undefined) ch.label = g.label;
+    if (g.secretFile !== undefined) ch.secretFile = g.secretFile;
+    if (g.stateFile !== undefined) ch.stateFile = g.stateFile;
+    if (g.allowedSenderIds !== undefined) ch.allowedSenderIds = g.allowedSenderIds;
+    if (g.allowedChatIds !== undefined) ch.allowedChatIds = g.allowedChatIds;
+    if (g.splitAt !== undefined) ch.splitAt = g.splitAt;
+    if (g.baseUrl !== undefined) ch.baseUrl = g.baseUrl;
+    channels.push(ch);
+  }
+
   // DaemonConfig's typed surface doesn't carry `trustLevel`, but we read it
   // defensively so future config extensions can propagate without a shape bump.
   const profiles = prepareGatewayProfiles(cfg.openclawGateways);

package/src/daemon.ts

@@ -6,6 +6,8 @@ import {
 import {
   Gateway,
   createBotCordChannel,
+  createTelegramChannel,
+  createWechatChannel,
   resolveTranscriptEnabled,
   sanitizeUntrustedContent,
   type ChannelAdapter,
@@ -116,6 +118,69 @@ export function createActivityRecorder(opts: {
   };
 }
 
+/** Per-call dependencies for {@link createDaemonChannel}. */
+export interface CreateDaemonChannelDeps {
+  credentialPathByAgentId: Map<string, string>;
+  defaultCredentialsPath?: string;
+  hubBaseUrl?: string;
+}
+
+/**
+ * Dispatch a `GatewayChannelConfig` to the right adapter constructor based on
+ * `chCfg.type`. Phase A wires up the BotCord adapter and stub constructors
+ * for telegram/wechat (which throw "not implemented"); Phase B will fill the
+ * latter in. Unknown types throw so misconfigured channels fail loudly at
+ * boot rather than silently dropping inbound traffic.
+ */
+export function createDaemonChannel(
+  chCfg: GatewayChannelConfig,
+  deps: CreateDaemonChannelDeps,
+): ChannelAdapter {
+  switch (chCfg.type) {
+    case "botcord": {
+      const agentId =
+        typeof chCfg.agentId === "string" ? chCfg.agentId : chCfg.accountId;
+      return createBotCordChannel({
+        id: chCfg.id,
+        accountId: chCfg.accountId,
+        agentId,
+        credentialsPath:
+          deps.credentialPathByAgentId.get(agentId) ?? deps.defaultCredentialsPath,
+        hubBaseUrl: deps.hubBaseUrl,
+      });
+    }
+    case "telegram":
+      return createTelegramChannel({
+        id: chCfg.id,
+        accountId: chCfg.accountId,
+        ...(typeof chCfg.baseUrl === "string" ? { baseUrl: chCfg.baseUrl } : {}),
+        ...(Array.isArray(chCfg.allowedSenderIds)
+          ? { allowedSenderIds: chCfg.allowedSenderIds as string[] }
+          : {}),
+        ...(Array.isArray(chCfg.allowedChatIds)
+          ? { allowedChatIds: chCfg.allowedChatIds as string[] }
+          : {}),
+        ...(typeof chCfg.splitAt === "number" ? { splitAt: chCfg.splitAt } : {}),
+        ...(typeof chCfg.secretFile === "string" ? { secretFile: chCfg.secretFile } : {}),
+        ...(typeof chCfg.stateFile === "string" ? { stateFile: chCfg.stateFile } : {}),
+      });
+    case "wechat":
+      return createWechatChannel({
+        id: chCfg.id,
+        accountId: chCfg.accountId,
+        ...(typeof chCfg.baseUrl === "string" ? { baseUrl: chCfg.baseUrl } : {}),
+        ...(Array.isArray(chCfg.allowedSenderIds)
+          ? { allowedSenderIds: chCfg.allowedSenderIds as string[] }
+          : {}),
+        ...(typeof chCfg.splitAt === "number" ? { splitAt: chCfg.splitAt } : {}),
+        ...(typeof chCfg.secretFile === "string" ? { secretFile: chCfg.secretFile } : {}),
+        ...(typeof chCfg.stateFile === "string" ? { stateFile: chCfg.stateFile } : {}),
+      });
+    default:
+      throw new Error(`unknown channel type "${chCfg.type}"`);
+  }
+}
+
 /**
  * Minimal send-capable surface used by {@link pushRuntimeSnapshot}.
  * Exists so the helper is trivially mockable from unit tests without needing
@@ -414,18 +479,12 @@ export async function startDaemon(opts: DaemonRuntimeOptions): Promise<DaemonHan
   const gateway = new Gateway({
     config: gwConfig,
     sessionStorePath: opts.sessionStorePath ?? SESSIONS_PATH,
-    createChannel: (chCfg: GatewayChannelConfig): ChannelAdapter => {
-      const agentId =
-        typeof chCfg.agentId === "string" ? chCfg.agentId : chCfg.accountId;
-      return createBotCordChannel({
-        id: chCfg.id,
-        accountId: chCfg.accountId,
-        agentId,
-        credentialsPath:
-          credentialPathByAgentId.get(agentId) ?? opts.credentialsPath,
+    createChannel: (chCfg: GatewayChannelConfig): ChannelAdapter =>
+      createDaemonChannel(chCfg, {
+        credentialPathByAgentId,
+        defaultCredentialsPath: opts.credentialsPath,
         hubBaseUrl: opts.hubBaseUrl,
-      });
-    },
+      }),
     log: logger,
     turnTimeoutMs: DEFAULT_TURN_TIMEOUT_MS,
     buildSystemContext,

package/src/gateway/__tests__/botcord-channel.test.ts

@@ -648,7 +648,7 @@ describe("createBotCordChannel — streamBlock()", () => {
       expect(body.block).toEqual({
         kind: "thinking",
         seq: 7,
-        payload: { phase: "updated", label: "Searching web", source: "runtime" },
+        payload: { phase: "updated", label: "Searching web", source: "runtime", details: "Searching web" },
       });
     } finally {
       globalThis.fetch = realFetch;