@umimoney/clawdbot-relay-plugin 0.1.7 → 0.1.9

package/dist/clawdbot.plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://clawdbot.dev/schemas/plugin.json",
   "id": "umi-relay",
   "name": "UMI Relay",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Connect to UMI relay server for real-time chat visibility in UMI web UI",
   "type": "channel",
   "main": "index.js",

package/dist/index.d.mts

@@ -96,25 +96,79 @@ declare class UmiRelayClient {
     private scheduleReconnect;
     private generateId;
 }
-interface ClawdbotContext {
-    injectMessage: (params: {
-        channel: string;
-        text: string;
-        metadata?: any;
+interface ClawdbotPluginApi {
+    registerChannel: (opts: {
+        plugin: ChannelPlugin;
     }) => void;
-    registerSend: (channel: string, handler: (response: any) => void) => void;
+    runtime: any;
 }
-/** Plugin ID - must match manifest */
-declare const id = "umi-relay";
-/**
- * Activate the UMI Relay plugin (Clawdbot standard export)
- * Note: Clawdbot ignores async, so we fire-and-forget the connection
- */
-declare function activate(ctx: ClawdbotContext, config?: RelayConfig): void;
-/**
- * Deactivate the UMI Relay plugin
- */
-declare function deactivate(): void;
-declare const register: typeof activate;
+interface AccountInfo {
+    accountId: string;
+    enabled: boolean;
+    configured: boolean;
+}
+interface ChannelPlugin {
+    id: string;
+    meta: {
+        id: string;
+        label: string;
+        description?: string;
+    };
+    capabilities: {
+        chatTypes: string[];
+        media: boolean;
+    };
+    configSchema: {
+        type: string;
+        properties: Record<string, any>;
+        additionalProperties: boolean;
+    };
+    config: {
+        listAccountIds: (cfg: any) => string[];
+        resolveAccount: (cfg: any, accountId: string) => AccountInfo;
+        defaultAccountId: (cfg: any) => string;
+        isConfigured: (account: AccountInfo) => boolean;
+        describeAccount: (account: AccountInfo) => AccountInfo;
+    };
+    outbound: {
+        deliveryMode: 'direct' | 'queued';
+        resolveTarget: (opts: {
+            to: string;
+        }) => {
+            ok: boolean;
+            to: string;
+        };
+        sendText: (opts: {
+            cfg: any;
+            to: string;
+            text: string;
+        }) => Promise<{
+            channel: string;
+            ok: boolean;
+        }>;
+    };
+    gateway: {
+        startAccount: (ctx: GatewayContext) => Promise<{
+            stop: () => void;
+        }>;
+    };
+}
+interface GatewayContext {
+    cfg: any;
+    runtime: {
+        inbound: (msg: InboundMessage) => void;
+    };
+}
+interface InboundMessage {
+    channel: string;
+    from: string;
+    text: string;
+    ts?: number;
+    metadata?: Record<string, any>;
+}
+declare const _default: {
+    id: string;
+    register(api: ClawdbotPluginApi): void;
+};
 
-export { type ClawdbotContext, type MessageHandler, type RelayConfig, type RelayMessage, type StateUpdate, UmiRelayClient, activate, deactivate, id, register };
+export { type MessageHandler, type RelayConfig, type RelayMessage, type StateUpdate, UmiRelayClient, _default as default };

package/dist/index.d.ts

@@ -96,25 +96,79 @@ declare class UmiRelayClient {
     private scheduleReconnect;
     private generateId;
 }
-interface ClawdbotContext {
-    injectMessage: (params: {
-        channel: string;
-        text: string;
-        metadata?: any;
+interface ClawdbotPluginApi {
+    registerChannel: (opts: {
+        plugin: ChannelPlugin;
     }) => void;
-    registerSend: (channel: string, handler: (response: any) => void) => void;
+    runtime: any;
 }
-/** Plugin ID - must match manifest */
-declare const id = "umi-relay";
-/**
- * Activate the UMI Relay plugin (Clawdbot standard export)
- * Note: Clawdbot ignores async, so we fire-and-forget the connection
- */
-declare function activate(ctx: ClawdbotContext, config?: RelayConfig): void;
-/**
- * Deactivate the UMI Relay plugin
- */
-declare function deactivate(): void;
-declare const register: typeof activate;
+interface AccountInfo {
+    accountId: string;
+    enabled: boolean;
+    configured: boolean;
+}
+interface ChannelPlugin {
+    id: string;
+    meta: {
+        id: string;
+        label: string;
+        description?: string;
+    };
+    capabilities: {
+        chatTypes: string[];
+        media: boolean;
+    };
+    configSchema: {
+        type: string;
+        properties: Record<string, any>;
+        additionalProperties: boolean;
+    };
+    config: {
+        listAccountIds: (cfg: any) => string[];
+        resolveAccount: (cfg: any, accountId: string) => AccountInfo;
+        defaultAccountId: (cfg: any) => string;
+        isConfigured: (account: AccountInfo) => boolean;
+        describeAccount: (account: AccountInfo) => AccountInfo;
+    };
+    outbound: {
+        deliveryMode: 'direct' | 'queued';
+        resolveTarget: (opts: {
+            to: string;
+        }) => {
+            ok: boolean;
+            to: string;
+        };
+        sendText: (opts: {
+            cfg: any;
+            to: string;
+            text: string;
+        }) => Promise<{
+            channel: string;
+            ok: boolean;
+        }>;
+    };
+    gateway: {
+        startAccount: (ctx: GatewayContext) => Promise<{
+            stop: () => void;
+        }>;
+    };
+}
+interface GatewayContext {
+    cfg: any;
+    runtime: {
+        inbound: (msg: InboundMessage) => void;
+    };
+}
+interface InboundMessage {
+    channel: string;
+    from: string;
+    text: string;
+    ts?: number;
+    metadata?: Record<string, any>;
+}
+declare const _default: {
+    id: string;
+    register(api: ClawdbotPluginApi): void;
+};
 
-export { type ClawdbotContext, type MessageHandler, type RelayConfig, type RelayMessage, type StateUpdate, UmiRelayClient, activate, deactivate, id, register };
+export { type MessageHandler, type RelayConfig, type RelayMessage, type StateUpdate, UmiRelayClient, _default as default };

package/dist/index.js

@@ -31,10 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   UmiRelayClient: () => UmiRelayClient,
-  activate: () => activate,
-  deactivate: () => deactivate,
-  id: () => id,
-  register: () => register
+  default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
 var import_ws = __toESM(require("ws"));
@@ -274,56 +271,102 @@ var UmiRelayClient = class {
   }
 };
 var relayClient = null;
-var id = "umi-relay";
-function activate(ctx, config) {
-  const resolvedConfig = {
-    apiKey: config?.apiKey || process.env.UMI_API_KEY || "",
-    relayUrl: config?.relayUrl || "wss://ws.umi.app/ws/relay",
-    agentVersion: config?.agentVersion || "1.0.0",
-    capabilities: config?.capabilities || ["chat"],
-    autoReconnect: config?.autoReconnect ?? true
-  };
-  if (!resolvedConfig.apiKey) {
-    console.error("[UmiRelay] No API key provided. Set UMI_API_KEY or pass apiKey in config.");
-    return;
-  }
-  relayClient = new UmiRelayClient(resolvedConfig);
-  relayClient.onMessage((message) => {
-    if (message.type === "platform:message") {
-      ctx.injectMessage({
-        channel: "umi",
-        text: message.content,
-        metadata: {
-          userId: message.userId,
-          agentId: message.agentId
+var umiRelayChannel = {
+  id: "umi-relay",
+  meta: {
+    id: "umi-relay",
+    label: "UMI Relay",
+    description: "Connect to UMI relay server for real-time chat"
+  },
+  capabilities: {
+    chatTypes: ["direct"],
+    media: false
+  },
+  configSchema: {
+    type: "object",
+    properties: {},
+    additionalProperties: false
+  },
+  config: {
+    listAccountIds: () => ["default"],
+    resolveAccount: (cfg, accountId) => ({
+      accountId: accountId || "default",
+      enabled: true,
+      configured: true
+    }),
+    defaultAccountId: () => "default",
+    isConfigured: () => true,
+    describeAccount: (account) => ({
+      accountId: account.accountId,
+      enabled: account.enabled,
+      configured: account.configured
+    })
+  },
+  outbound: {
+    deliveryMode: "direct",
+    resolveTarget: ({ to }) => ({ ok: true, to }),
+    sendText: async ({ cfg, to, text }) => {
+      if (relayClient?.isConnected) {
+        relayClient.sendMessage(text, { to });
+        return { channel: "umi-relay", ok: true };
+      }
+      return { channel: "umi-relay", ok: false };
+    }
+  },
+  gateway: {
+    startAccount: async (ctx) => {
+      const config = {
+        apiKey: ctx.cfg?.apiKey || process.env.UMI_API_KEY || "",
+        relayUrl: ctx.cfg?.relayUrl || "wss://ws.umi.app/ws/relay",
+        agentVersion: ctx.cfg?.agentVersion || "1.0.0",
+        capabilities: ctx.cfg?.capabilities || ["chat"],
+        autoReconnect: ctx.cfg?.autoReconnect ?? true
+      };
+      if (!config.apiKey) {
+        console.error("[UmiRelay] No API key provided. Set UMI_API_KEY or pass apiKey in config.");
+        return { stop: () => {
+        } };
+      }
+      relayClient = new UmiRelayClient(config);
+      relayClient.onMessage((message) => {
+        if (message.type === "platform:message") {
+          ctx.runtime.inbound({
+            channel: "umi-relay",
+            from: message.userId || "unknown",
+            text: message.content,
+            ts: message.timestamp,
+            metadata: {
+              userId: message.userId,
+              agentId: message.agentId
+            }
+          });
         }
       });
+      try {
+        await relayClient.connect();
+        console.log("[UmiRelay] Connected to relay");
+      } catch (error) {
+        console.error("[UmiRelay] Failed to connect:", error);
+      }
+      return {
+        stop: () => {
+          if (relayClient) {
+            relayClient.disconnect();
+            relayClient = null;
+          }
+          console.log("[UmiRelay] Disconnected");
+        }
+      };
     }
-  });
-  ctx.registerSend("umi", (response) => {
-    if (relayClient?.isConnected) {
-      relayClient.sendMessage(response.text || response.content, response.metadata);
-    }
-  });
-  relayClient.connect().then(() => {
-    console.log("[UmiRelay] Plugin activated and connected");
-  }).catch((error) => {
-    console.error("[UmiRelay] Failed to connect:", error);
-  });
-}
-function deactivate() {
-  if (relayClient) {
-    relayClient.disconnect();
-    relayClient = null;
   }
-  console.log("[UmiRelay] Plugin deactivated");
-}
-var register = activate;
+};
+var index_default = {
+  id: "umi-relay",
+  register(api) {
+    api.registerChannel({ plugin: umiRelayChannel });
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  UmiRelayClient,
-  activate,
-  deactivate,
-  id,
-  register
+  UmiRelayClient
 });

package/dist/index.mjs

@@ -236,55 +236,102 @@ var UmiRelayClient = class {
   }
 };
 var relayClient = null;
-var id = "umi-relay";
-function activate(ctx, config) {
-  const resolvedConfig = {
-    apiKey: config?.apiKey || process.env.UMI_API_KEY || "",
-    relayUrl: config?.relayUrl || "wss://ws.umi.app/ws/relay",
-    agentVersion: config?.agentVersion || "1.0.0",
-    capabilities: config?.capabilities || ["chat"],
-    autoReconnect: config?.autoReconnect ?? true
-  };
-  if (!resolvedConfig.apiKey) {
-    console.error("[UmiRelay] No API key provided. Set UMI_API_KEY or pass apiKey in config.");
-    return;
-  }
-  relayClient = new UmiRelayClient(resolvedConfig);
-  relayClient.onMessage((message) => {
-    if (message.type === "platform:message") {
-      ctx.injectMessage({
-        channel: "umi",
-        text: message.content,
-        metadata: {
-          userId: message.userId,
-          agentId: message.agentId
+var umiRelayChannel = {
+  id: "umi-relay",
+  meta: {
+    id: "umi-relay",
+    label: "UMI Relay",
+    description: "Connect to UMI relay server for real-time chat"
+  },
+  capabilities: {
+    chatTypes: ["direct"],
+    media: false
+  },
+  configSchema: {
+    type: "object",
+    properties: {},
+    additionalProperties: false
+  },
+  config: {
+    listAccountIds: () => ["default"],
+    resolveAccount: (cfg, accountId) => ({
+      accountId: accountId || "default",
+      enabled: true,
+      configured: true
+    }),
+    defaultAccountId: () => "default",
+    isConfigured: () => true,
+    describeAccount: (account) => ({
+      accountId: account.accountId,
+      enabled: account.enabled,
+      configured: account.configured
+    })
+  },
+  outbound: {
+    deliveryMode: "direct",
+    resolveTarget: ({ to }) => ({ ok: true, to }),
+    sendText: async ({ cfg, to, text }) => {
+      if (relayClient?.isConnected) {
+        relayClient.sendMessage(text, { to });
+        return { channel: "umi-relay", ok: true };
+      }
+      return { channel: "umi-relay", ok: false };
+    }
+  },
+  gateway: {
+    startAccount: async (ctx) => {
+      const config = {
+        apiKey: ctx.cfg?.apiKey || process.env.UMI_API_KEY || "",
+        relayUrl: ctx.cfg?.relayUrl || "wss://ws.umi.app/ws/relay",
+        agentVersion: ctx.cfg?.agentVersion || "1.0.0",
+        capabilities: ctx.cfg?.capabilities || ["chat"],
+        autoReconnect: ctx.cfg?.autoReconnect ?? true
+      };
+      if (!config.apiKey) {
+        console.error("[UmiRelay] No API key provided. Set UMI_API_KEY or pass apiKey in config.");
+        return { stop: () => {
+        } };
+      }
+      relayClient = new UmiRelayClient(config);
+      relayClient.onMessage((message) => {
+        if (message.type === "platform:message") {
+          ctx.runtime.inbound({
+            channel: "umi-relay",
+            from: message.userId || "unknown",
+            text: message.content,
+            ts: message.timestamp,
+            metadata: {
+              userId: message.userId,
+              agentId: message.agentId
+            }
+          });
         }
       });
+      try {
+        await relayClient.connect();
+        console.log("[UmiRelay] Connected to relay");
+      } catch (error) {
+        console.error("[UmiRelay] Failed to connect:", error);
+      }
+      return {
+        stop: () => {
+          if (relayClient) {
+            relayClient.disconnect();
+            relayClient = null;
+          }
+          console.log("[UmiRelay] Disconnected");
+        }
+      };
     }
-  });
-  ctx.registerSend("umi", (response) => {
-    if (relayClient?.isConnected) {
-      relayClient.sendMessage(response.text || response.content, response.metadata);
-    }
-  });
-  relayClient.connect().then(() => {
-    console.log("[UmiRelay] Plugin activated and connected");
-  }).catch((error) => {
-    console.error("[UmiRelay] Failed to connect:", error);
-  });
-}
-function deactivate() {
-  if (relayClient) {
-    relayClient.disconnect();
-    relayClient = null;
   }
-  console.log("[UmiRelay] Plugin deactivated");
-}
-var register = activate;
+};
+var index_default = {
+  id: "umi-relay",
+  register(api) {
+    api.registerChannel({ plugin: umiRelayChannel });
+  }
+};
 export {
   UmiRelayClient,
-  activate,
-  deactivate,
-  id,
-  register
+  index_default as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umimoney/clawdbot-relay-plugin",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Clawdbot plugin for connecting to UMI relay server",
   "main": "dist/index.js",
   "module": "dist/index.mjs",