@richwats/webex 0.2.3

package/README.md

@@ -0,0 +1,62 @@
+# OpenClaw Webex Channel Plugin
+
+Webex channel plugin for OpenClaw using webex-node-bot-framework.
+
+## Required Configuration
+
+Set both values in your OpenClaw config under channels.webex:
+
+- token: Webex bot token
+- webhookUrl: Public callback URL that Webex calls for events
+- listenPort (optional): Local port for the plugin webhook server if default/fallback port is already in use
+
+Example:
+
+```json
+{
+  "channels": {
+    "webex": {
+      "enabled": true,
+      "token": "YOUR_WEBEX_BOT_TOKEN",
+      "webhookUrl": "https://your-public-host.example.com/webex/webhook",
+      "defaultTo": "Y2lzY29zcGFyazovL3VzL1JPT00v...",
+      "listenPort": 3988
+    }
+  }
+}
+```
+
+## Enable in OpenClaw
+
+1. Place this plugin in your OpenClaw extensions path (for example `.openclaw/extensions/webex`).
+2. Ensure OpenClaw loads the plugin entry from `index.ts` (or built output if your runtime requires compiled JS).
+3. Enable the channel in your OpenClaw config by setting `channels.webex.enabled: true` and providing `token` + `webhookUrl`.
+4. Restart the OpenClaw gateway so the channel plugin is registered and started.
+
+Minimal enablement example:
+
+```json
+{
+  "channels": {
+    "webex": {
+      "enabled": true,
+      "token": "YOUR_WEBEX_BOT_TOKEN",
+      "webhookUrl": "https://your-public-host.example.com/webex/webhook"
+    }
+  }
+}
+```
+
+## Behavior
+
+- Receives inbound messages from Webex via webhook middleware from webex-node-bot-framework.
+- Sends outbound text messages to a target roomId, or person:<personId>.
+- Ignores bot-authored inbound messages to prevent loops.
+
+## Local OpenShell Notes
+
+- Ensure webhookUrl is publicly reachable from Webex cloud.
+- The plugin listens on `PORT` when set, otherwise uses webhookUrl explicit port, otherwise falls back to `3978`.
+- To avoid `EADDRINUSE` port conflicts (common when another channel uses 3978), set `channels.webex.listenPort`.
+- If running behind a reverse proxy in OpenShell, route webhookUrl path to this plugin service.
+- The plugin includes a Node compatibility shim for legacy Webex dependencies that mutate `globalThis.navigator`.

package/dist/channel-config-api.d.ts

@@ -0,0 +1,2 @@
+export { WebexChannelConfigSchema } from "./src/config-schema.js";
+//# sourceMappingURL=channel-config-api.d.ts.map

package/dist/channel-config-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config-api.d.ts","sourceRoot":"","sources":["../channel-config-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/channel-config-api.js

@@ -0,0 +1,2 @@
+export { WebexChannelConfigSchema } from "./src/config-schema.js";
+//# sourceMappingURL=channel-config-api.js.map

package/dist/channel-config-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config-api.js","sourceRoot":"","sources":["../channel-config-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { webexPlugin } from "./src/channel.js";
+export { setWebexRuntime } from "./src/runtime.js";
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;;AAEnD,wBAMG"}

package/dist/index.js

@@ -0,0 +1,34 @@
+import * as OpenClawCore from "openclaw/plugin-sdk/core";
+import { webexPlugin } from "./src/channel.js";
+import { setWebexRuntime } from "./src/runtime.js";
+const defineChannelPluginEntryCompat = OpenClawCore.defineChannelPluginEntry ??
+    ((params) => ({
+        id: params.id,
+        name: params.name,
+        description: params.description,
+        configSchema: typeof params.configSchema === "function"
+            ? params.configSchema()
+            : (params.configSchema ?? {
+                type: "object",
+                additionalProperties: false,
+                properties: {},
+            }),
+        register(api) {
+            params.setRuntime?.(api?.runtime ?? api);
+            api.registerChannel?.({ plugin: params.plugin });
+            params.registerCliMetadata?.(api);
+            params.registerFull?.(api);
+        },
+        channelPlugin: params.plugin,
+        ...(params.setRuntime ? { setChannelRuntime: params.setRuntime } : {}),
+    }));
+export { webexPlugin } from "./src/channel.js";
+export { setWebexRuntime } from "./src/runtime.js";
+export default defineChannelPluginEntryCompat({
+    id: "webex",
+    name: "Cisco Webex",
+    description: "Cisco Webex channel plugin (webex-node-bot-framework)",
+    plugin: webexPlugin,
+    setRuntime: setWebexRuntime,
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,8BAA8B,GACjC,YAAoE,CAAC,wBAAwB;IAC9F,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EACV,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU;YACvC,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE;YACvB,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI;gBACtB,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE,EAAE;aACf,CAAC;QACR,QAAQ,CAAC,GAAQ;YACf,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;YACzC,GAAG,CAAC,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,aAAa,EAAE,MAAM,CAAC,MAAM;QAC5B,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC,CAAC;AAEN,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAe,8BAA8B,CAAC;IAC5C,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,uDAAuD;IACpE,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,eAAe;CAC5B,CAAC,CAAC"}

package/dist/src/channel.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-contract";
+export declare const webexPlugin: ChannelPlugin<any, any>;
+//# sourceMappingURL=channel.d.ts.map

package/dist/src/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/channel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AA4B1E,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CA+G9C,CAAC"}

package/dist/src/channel.js

@@ -0,0 +1,129 @@
+import * as OpenClawCore from "openclaw/plugin-sdk/core";
+import { WebexChannelConfigSchema, hasConfiguredWebexChannel, resolveWebexChannelConfig } from "./config-schema.js";
+import { monitorWebexProvider } from "./monitor.js";
+import { sendTextWebex } from "./outbound.js";
+import { setWebexRuntime, webexLogDebug, webexLogError, webexLogInfo } from "./runtime.js";
+const createChatChannelPluginCompat = OpenClawCore.createChatChannelPlugin ??
+    ((config) => config?.base ?? config);
+const state = {};
+async function waitUntilAbort(signal) {
+    if (!signal) {
+        return await new Promise(() => { });
+    }
+    if (signal.aborted) {
+        return;
+    }
+    await new Promise((resolve) => {
+        signal.addEventListener("abort", () => resolve(), { once: true });
+    });
+}
+export const webexPlugin = createChatChannelPluginCompat({
+    base: {
+        id: "webex",
+        meta: {
+            id: "webex",
+            label: "Cisco Webex",
+            selectionLabel: "Cisco Webex Bot",
+            docsPath: "/channels/webex",
+            docsLabel: "webex",
+            blurb: "Webex bot channel powered by webex-node-bot-framework.",
+            aliases: ["cisco-webex"],
+            order: 80,
+        },
+        capabilities: {
+            chatTypes: ["direct", "channel"],
+            threads: false,
+            media: false,
+            polls: false,
+        },
+        reload: { configPrefixes: ["channels.webex"] },
+        configSchema: WebexChannelConfigSchema,
+        config: {
+            // Keep both modern and legacy config adapter fields for broad runtime compatibility.
+            sectionKey: "webex",
+            listAccountIds: () => ["default"],
+            resolveAccount: (cfg) => ({
+                accountId: "default",
+                enabled: cfg?.channels?.webex?.enabled !== false,
+                configured: hasConfiguredWebexChannel(cfg),
+            }),
+            resolveAccessorAccount: ({ cfg }) => resolveWebexChannelConfig(cfg),
+            resolveAllowFrom: () => undefined,
+            resolveDefaultTo: (account) => account?.defaultTo,
+            isConfigured: (_account, cfg) => hasConfiguredWebexChannel(cfg),
+        },
+        gateway: {
+            startAccount: async (ctx) => {
+                setWebexRuntime(ctx?.runtime ?? ctx);
+                webexLogInfo("webex gateway startAccount begin", {
+                    accountId: String(ctx.accountId ?? "default"),
+                });
+                if (state.provider) {
+                    webexLogDebug("webex gateway shutting down previous provider before restart");
+                    await state.provider.shutdown();
+                    state.provider = undefined;
+                }
+                let provider;
+                try {
+                    provider = await monitorWebexProvider({
+                        cfg: ctx.cfg,
+                        abortSignal: ctx.abortSignal,
+                    });
+                }
+                catch (err) {
+                    webexLogError("webex gateway startAccount failed", { error: String(err) });
+                    throw err;
+                }
+                state.provider = provider ?? undefined;
+                const configured = hasConfiguredWebexChannel(ctx.cfg);
+                ctx.setStatus({ accountId: ctx.accountId, configured, running: Boolean(provider) });
+                webexLogInfo("webex gateway status updated", {
+                    accountId: String(ctx.accountId ?? "default"),
+                    configured,
+                    running: Boolean(provider),
+                });
+                if (!provider) {
+                    return null;
+                }
+                try {
+                    await waitUntilAbort(ctx.abortSignal);
+                    return null;
+                }
+                finally {
+                    if (state.provider) {
+                        webexLogInfo("webex gateway abort detected; shutting down provider", {
+                            accountId: String(ctx.accountId ?? "default"),
+                        });
+                        await state.provider.shutdown();
+                        state.provider = undefined;
+                    }
+                    webexLogInfo("webex gateway startAccount complete", {
+                        accountId: String(ctx.accountId ?? "default"),
+                    });
+                }
+            },
+        },
+        outbound: {
+            deliveryMode: "direct",
+            sendText: async (params) => {
+                const provider = state.provider;
+                if (!provider) {
+                    throw new Error("Webex provider not running.");
+                }
+                const cfg = resolveWebexChannelConfig(params.cfg);
+                const to = (params.to || cfg.defaultTo || "").trim();
+                if (!to) {
+                    throw new Error("Missing Webex target. Provide `to` or configure channels.webex.defaultTo.");
+                }
+                await sendTextWebex({
+                    frameworkRuntime: provider.runtime,
+                    to,
+                    text: params.text,
+                });
+                webexLogDebug("webex outbound sent", { to });
+                return { messageId: "framework", conversationId: to };
+            },
+        },
+    },
+});
+//# sourceMappingURL=channel.js.map

package/dist/src/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/channel.ts"],"names":[],"mappings":"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"}

package/dist/src/config-schema.d.ts

@@ -0,0 +1,23 @@
+export type WebexChannelConfig = {
+    enabled?: boolean;
+    token?: string;
+    webhookUrl?: string;
+    defaultTo?: string;
+    listenPort?: number;
+};
+type JsonSchemaObject = {
+    type: "object";
+    additionalProperties?: boolean;
+    properties?: Record<string, unknown>;
+    required?: string[];
+};
+export declare const WebexChannelConfigSchema: JsonSchemaObject;
+export declare function resolveWebexChannelConfig(cfg: unknown): WebexChannelConfig;
+export declare function hasConfiguredWebexChannel(cfg: unknown): boolean;
+export declare function parseWebhookUrl(raw: string): {
+    url: URL;
+    path: string;
+    port?: number;
+};
+export {};
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/src/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/config-schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAiCF,eAAO,MAAM,wBAAwB,kBAAS,CAAC;AAE/C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAG1E;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAKtF"}

package/dist/src/config-schema.js

@@ -0,0 +1,45 @@
+const schema = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        enabled: { type: "boolean", default: true },
+        token: {
+            type: "string",
+            minLength: 1,
+            description: "Webex bot access token.",
+        },
+        webhookUrl: {
+            type: "string",
+            minLength: 1,
+            description: "Public Webex webhook callback URL for this plugin.",
+        },
+        defaultTo: {
+            type: "string",
+            minLength: 1,
+            description: "Default Webex roomId target for outbound messages.",
+        },
+        listenPort: {
+            type: "number",
+            minimum: 1,
+            maximum: 65535,
+            description: "Local HTTP listen port override for the Webex webhook server (useful when 3978 is already in use).",
+        },
+    },
+    required: ["token", "webhookUrl"],
+};
+export const WebexChannelConfigSchema = schema;
+export function resolveWebexChannelConfig(cfg) {
+    const channelCfg = cfg?.channels?.webex;
+    return channelCfg ?? {};
+}
+export function hasConfiguredWebexChannel(cfg) {
+    const channelCfg = resolveWebexChannelConfig(cfg);
+    return Boolean(channelCfg.token?.trim() && channelCfg.webhookUrl?.trim());
+}
+export function parseWebhookUrl(raw) {
+    const url = new URL(raw);
+    const path = url.pathname?.trim() ? url.pathname : "/webex/webhook";
+    const port = url.port ? Number(url.port) : undefined;
+    return { url, path, port };
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/src/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/config-schema.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,GAAqB;IAC/B,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3C,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,yBAAyB;SACvC;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,oDAAoD;SAClE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,oDAAoD;SAClE;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,KAAK;YACd,WAAW,EACT,oGAAoG;SACvG;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,MAAM,UAAU,yBAAyB,CAAC,GAAY;IACpD,MAAM,UAAU,GAAI,GAAiE,EAAE,QAAQ,EAAE,KAAK,CAAC;IACvG,OAAO,UAAU,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAY;IACpD,MAAM,UAAU,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACpE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/dist/src/framework-runtime.d.ts

@@ -0,0 +1,34 @@
+import type { Express } from "express";
+type FrameworkLike = {
+    email?: string;
+    start: () => Promise<boolean> | boolean;
+    stop: () => Promise<boolean> | boolean;
+    on: (eventName: string, cb: (...args: any[]) => void) => void;
+    hears?: (matcher: string | RegExp, cb: (...args: any[]) => void) => void;
+    getBotByRoomId: (roomId: string) => {
+        say: (message: string | Record<string, unknown>) => Promise<unknown>;
+    } | null;
+    getWebexSDK: () => {
+        messages: {
+            create: (payload: Record<string, unknown>) => Promise<unknown>;
+        };
+    };
+};
+export type WebexFrameworkConfig = {
+    token: string;
+    webhookUrl: string;
+};
+type AttachHandlersOpts = {
+    cfg: unknown;
+    send: (roomId: string, text: string) => Promise<void>;
+};
+export type WebexFrameworkRuntime = {
+    framework: FrameworkLike;
+    webhookMiddleware: (req: unknown, res: unknown, next?: (err?: unknown) => void) => void;
+    attachInboundHandlers: (opts: AttachHandlersOpts) => void;
+};
+export declare function createWebexFrameworkRuntime(config: WebexFrameworkConfig): WebexFrameworkRuntime;
+export declare function sendFrameworkMessage(framework: FrameworkLike, to: string, text: string): Promise<void>;
+export declare function bindFrameworkWebhook(app: Express, path: string, middleware: WebexFrameworkRuntime["webhookMiddleware"]): void;
+export {};
+//# sourceMappingURL=framework-runtime.d.ts.map

package/dist/src/framework-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-runtime.d.ts","sourceRoot":"","sources":["../../src/framework-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA4BvC,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACvC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACzE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACpH,WAAW,EAAE,MAAM;QACjB,QAAQ,EAAE;YACR,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAChE,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,aAAa,CAAC;IACzB,iBAAiB,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;IACxF,qBAAqB,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC3D,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,qBAAqB,CA4F/F;AAED,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,aAAa,EACxB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAG7H"}

package/dist/src/framework-runtime.js

@@ -0,0 +1,271 @@
+import { createRequire } from "node:module";
+import { dispatchInboundToAgent, webexLogDebug, webexLogError, webexLogInfo } from "./runtime.js";
+const require = createRequire(import.meta.url);
+function ensureNavigatorWritableForLegacyDeps() {
+    const descriptor = Object.getOwnPropertyDescriptor(globalThis, "navigator");
+    if (!descriptor) {
+        return;
+    }
+    // Some legacy Webex transitive dependencies assign to globalThis.navigator.
+    // Newer Node versions expose navigator via a getter-only property.
+    const isGetterOnly = typeof descriptor.get === "function" && descriptor.set === undefined;
+    if (!isGetterOnly || descriptor.configurable !== true) {
+        return;
+    }
+    const current = descriptor.get?.call(globalThis);
+    Object.defineProperty(globalThis, "navigator", {
+        value: current,
+        writable: true,
+        configurable: true,
+        enumerable: descriptor.enumerable ?? true,
+    });
+}
+export function createWebexFrameworkRuntime(config) {
+    webexLogInfo("webex framework init starting", {
+        webhookHost: safeWebhookHost(config.webhookUrl),
+        hasToken: Boolean(config.token?.trim()),
+    });
+    ensureNavigatorWritableForLegacyDeps();
+    const FrameworkCtor = require("webex-node-bot-framework");
+    const webhookFactory = require("webex-node-bot-framework/webhook");
+    const framework = new FrameworkCtor({
+        token: config.token,
+        webhookUrl: config.webhookUrl,
+        // Prevent startup discovery from spawning bot objects in existing/default rooms.
+        maxStartupSpaces: 0,
+    });
+    framework.on("log", (msg) => {
+        webexLogDebug("webex framework log", { msg: String(msg ?? "") });
+    });
+    framework.on("start", () => {
+        webexLogInfo("webex framework start event");
+    });
+    framework.on("initialized", () => {
+        webexLogInfo("webex framework initialized event");
+    });
+    framework.on("stop", () => {
+        webexLogInfo("webex framework stop event");
+    });
+    framework.on("spawn", (_bot, id, addedBy) => {
+        webexLogDebug("webex framework spawn event", {
+            id: String(id ?? ""),
+            hasAddedBy: Boolean(addedBy),
+        });
+    });
+    const webhookMiddleware = webhookFactory(framework);
+    const attachInboundHandlers = (opts) => {
+        if (typeof framework.hears === "function") {
+            framework.hears(/[\s\S]*/, () => {
+                // Keep this empty catch-all so the framework does not emit "No Hears Called" noise.
+            });
+            webexLogDebug("webex framework hears catch-all registered");
+        }
+        framework.on("message", (_bot, trigger) => {
+            const botEmail = framework.email?.toLowerCase().trim();
+            const senderEmail = String(trigger?.person?.emails?.[0] ?? trigger?.personEmail ?? "").toLowerCase().trim();
+            if (botEmail && senderEmail && botEmail === senderEmail) {
+                webexLogDebug("webex inbound ignored bot-authored message", { senderEmail });
+                return;
+            }
+            const text = String(trigger?.message?.text ?? "").trim();
+            const roomId = String(trigger?.message?.roomId ?? "").trim();
+            if (!text || !roomId) {
+                webexLogDebug("webex inbound ignored: missing text or roomId", {
+                    hasText: Boolean(text),
+                    hasRoomId: Boolean(roomId),
+                });
+                return;
+            }
+            webexLogDebug("webex inbound received", {
+                roomId,
+                messageId: typeof trigger?.message?.id === "string" ? trigger.message.id : undefined,
+                senderEmail,
+                textLength: text.length,
+                textPreview: truncate(text, 280),
+            });
+            const event = {
+                text,
+                roomId,
+                personId: typeof trigger?.personId === "string" ? trigger.personId : undefined,
+                personEmail: senderEmail || undefined,
+                messageId: typeof trigger?.message?.id === "string" ? trigger.message.id : undefined,
+                raw: trigger,
+            };
+            void dispatchInboundToAgent(event, opts.cfg, (text) => opts.send(event.roomId, text)).catch((err) => {
+                webexLogError("webex inbound dispatch failed", { error: String(err) });
+            });
+        });
+    };
+    return {
+        framework,
+        webhookMiddleware,
+        attachInboundHandlers,
+    };
+}
+export async function sendFrameworkMessage(framework, to, text) {
+    webexLogDebug("webex outbound dispatch begin", {
+        target: to,
+        textLength: text.length,
+    });
+    const bot = framework.getBotByRoomId(to);
+    if (bot) {
+        const callMeta = {
+            api: "bot.say",
+            target: to,
+            textLength: text.length,
+            textPreview: truncate(text, 280),
+        };
+        await retryWebexApiCall(callMeta, () => bot.say(text));
+        webexLogInfo("webex outbound sent via bot room context", { target: to });
+        return;
+    }
+    const sdk = framework.getWebexSDK();
+    if (to.startsWith("person:")) {
+        const payload = { toPersonId: to.slice("person:".length), markdown: text };
+        const callMeta = {
+            api: "messages.create",
+            mode: "direct",
+            target: payload.toPersonId,
+            textLength: text.length,
+            textPreview: truncate(text, 280),
+        };
+        await retryWebexApiCall(callMeta, () => sdk.messages.create(payload));
+        webexLogInfo("webex outbound sent via direct person target", { target: to });
+        return;
+    }
+    const payload = { roomId: to, markdown: text };
+    const callMeta = {
+        api: "messages.create",
+        mode: "room",
+        target: payload.roomId,
+        textLength: text.length,
+        textPreview: truncate(text, 280),
+    };
+    await retryWebexApiCall(callMeta, () => sdk.messages.create(payload));
+    webexLogInfo("webex outbound sent via room target", { target: to });
+}
+export function bindFrameworkWebhook(app, path, middleware) {
+    webexLogDebug("webex webhook route bound", { path });
+    app.post(path, (req, res, next) => middleware(req, res, next));
+}
+function safeWebhookHost(rawUrl) {
+    try {
+        return new URL(rawUrl).host;
+    }
+    catch {
+        return "invalid";
+    }
+}
+function truncate(text, maxLength) {
+    return text.length <= maxLength ? text : `${text.slice(0, Math.max(0, maxLength - 1))}...`;
+}
+async function retryWebexApiCall(meta, operation) {
+    const maxAttempts = 4;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        webexLogInfo("webex api call begin", {
+            ...meta,
+            attempt,
+            maxAttempts,
+        });
+        try {
+            const result = await operation();
+            webexLogInfo("webex api call success", {
+                api: meta.api,
+                mode: meta.mode,
+                target: meta.target,
+                attempt,
+            });
+            return result;
+        }
+        catch (err) {
+            lastError = err;
+            const retriable = isRetriableWebexError(err);
+            const isLastAttempt = attempt >= maxAttempts;
+            webexLogError("webex api call failed", {
+                api: meta.api,
+                mode: meta.mode,
+                target: meta.target,
+                attempt,
+                maxAttempts,
+                retriable,
+                error: formatErrorForLog(err),
+            });
+            if (!retriable || isLastAttempt) {
+                throw err;
+            }
+            const delayMs = getRetryDelayMs(attempt);
+            webexLogInfo("webex api call retry scheduled", {
+                api: meta.api,
+                mode: meta.mode,
+                target: meta.target,
+                nextAttempt: attempt + 1,
+                delayMs,
+            });
+            await sleep(delayMs);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "Unknown Webex API error"));
+}
+function isRetriableWebexError(err) {
+    const details = extractErrorDetails(err);
+    if (details.statusCode !== undefined) {
+        if (details.statusCode === 429 || details.statusCode >= 500) {
+            return true;
+        }
+        return false;
+    }
+    const haystack = [details.message, details.code, details.causeMessage]
+        .filter((value) => Boolean(value))
+        .join(" ")
+        .toLowerCase();
+    return [
+        "networkorcorserror",
+        "socket hang up",
+        "tunneling socket could not be established",
+        "econnreset",
+        "etimedout",
+        "econnrefused",
+        "timeout",
+        "temporarily unavailable",
+        "fetch failed",
+        "network error",
+    ].some((needle) => haystack.includes(needle));
+}
+function extractErrorDetails(err) {
+    if (!err || typeof err !== "object") {
+        return { message: String(err ?? "") };
+    }
+    const record = err;
+    const cause = record.cause && typeof record.cause === "object" ? record.cause : undefined;
+    const response = record.response && typeof record.response === "object" ? record.response : undefined;
+    return {
+        message: typeof record.message === "string" ? record.message : String(err),
+        code: typeof record.code === "string" ? record.code : undefined,
+        causeMessage: typeof cause?.message === "string" ? cause.message : undefined,
+        statusCode: typeof record.statusCode === "number"
+            ? record.statusCode
+            : typeof record.status === "number"
+                ? record.status
+                : typeof response?.statusCode === "number"
+                    ? response.statusCode
+                    : typeof response?.status === "number"
+                        ? response.status
+                        : undefined,
+    };
+}
+function formatErrorForLog(err) {
+    const details = extractErrorDetails(err);
+    return [details.message, details.code, details.causeMessage].filter(Boolean).join(" | ");
+}
+function getRetryDelayMs(attempt) {
+    const baseMs = 750;
+    const jitterMs = Math.floor(Math.random() * 250);
+    return baseMs * 2 ** (attempt - 1) + jitterMs;
+}
+async function sleep(delayMs) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, delayMs);
+    });
+}
+//# sourceMappingURL=framework-runtime.js.map