agent-messenger 2.22.0 → 2.23.1

package/dist/src/platforms/webexbot/listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../../src/platforms/webexbot/listener.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,aAAa,EAIb,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAA;AAG9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAGvD,KAAK,QAAQ,GAAG,MAAM,wBAAwB,CAAA;AAC9C,KAAK,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAA;AAE1D,UAAU,uBAAuB;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,IAAI,aAAa,CAAA;IACvB,IAAI,SAAS,IAAI,OAAO,CAAA;IACxB,EAAE,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACrG,GAAG,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACtG,IAAI,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;CACxG;AAED,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,uBAAuB,CAAA;CACjF;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,uBAA4B;IAKvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B,EAAE,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKhG,GAAG,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKjG,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAKlG,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,SAAS;YAMH,aAAa;IAoB3B,OAAO,CAAC,WAAW;CA+EpB"}
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../../src/platforms/webexbot/listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAIjD,YAAY,EACV,mBAAmB,IAAI,sBAAsB,EAC7C,oBAAoB,IAAI,uBAAuB,GAChD,MAAM,mBAAmB,CAAA;AAE1B,qBAAa,gBAAiB,SAAQ,aAAa;IAG3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/src/platforms/webexbot/listener.js

@@ -1,214 +1,19 @@
-import { EventEmitter } from 'events';
-import { WebexMessageHandler } from 'webex-message-handler';
-import WebSocket from 'ws';
-import { createWdmRewriteFetch, discoverWdmDevicesUrl } from './wdm-discovery.js';
-export class WebexBotListener {
-    client;
-    options;
-    running = false;
-    emitter = new EventEmitter();
-    handler = null;
-    generation = 0;
-    detachHandler = null;
-    startPromise = null;
-    constructor(client, options = {}) {
-        this.client = client;
-        this.options = options;
-    }
+import { WebexListener } from '../webex/listener.js';
+import { WebexError } from '../webex/types.js';
+import { WebexBotError } from './types.js';
+export class WebexBotListener extends WebexListener {
+    // Preserve the bot error contract: WDM discovery (shared with the user platform)
+    // throws WebexError, but existing bot callers catch WebexBotError.
     async start() {
-        if (this.startPromise)
-            return this.startPromise;
-        if (this.running)
-            return;
-        this.running = true;
-        const generation = ++this.generation;
-        let startPromise;
-        startPromise = (async () => {
-            let handler = null;
-            try {
-                handler = await this.createHandler();
-                if (!this.running || this.generation !== generation) {
-                    await handler.disconnect().catch(() => undefined);
-                    return;
-                }
-                this.handler = handler;
-                this.detachHandler = this.wireHandler(handler, generation);
-                await handler.connect();
-                if (!this.running || this.handler !== handler || this.generation !== generation) {
-                    await handler.disconnect().catch(() => undefined);
-                    return;
-                }
-            }
-            catch (error) {
-                if (this.handler === handler && this.generation === generation) {
-                    this.detachHandler?.();
-                    this.detachHandler = null;
-                    this.handler = null;
-                }
-                if (this.generation === generation) {
-                    this.running = false;
-                }
-                await handler?.disconnect().catch(() => undefined);
-                throw error;
-            }
-            finally {
-                if (this.startPromise === startPromise) {
-                    this.startPromise = null;
-                }
-            }
-        })();
-        this.startPromise = startPromise;
-        return startPromise;
-    }
-    async stop() {
-        const pendingStart = this.startPromise;
-        this.startPromise = null;
-        this.running = false;
-        this.generation++;
-        const detach = this.detachHandler;
-        this.detachHandler = null;
-        detach?.();
-        const handler = this.handler;
-        this.handler = null;
-        if (handler) {
-            await handler.disconnect().catch(() => undefined);
-        }
-        if (pendingStart) {
-            await pendingStart.catch(() => undefined);
+        try {
+            await super.start();
         }
-    }
-    on(event, listener) {
-        this.emitter.on(event, listener);
-        return this;
-    }
-    off(event, listener) {
-        this.emitter.off(event, listener);
-        return this;
-    }
-    once(event, listener) {
-        this.emitter.once(event, listener);
-        return this;
-    }
-    isCurrent(handler, generation) {
-        return this.running && this.handler === handler && this.generation === generation;
-    }
-    // Node's EventEmitter throws synchronously if an 'error' event is emitted with
-    // no registered listener. Guard it so SDK consumers that only subscribe to
-    // message events are never crashed by a transient connection error.
-    emitError(error) {
-        if (this.emitter.listenerCount('error') > 0) {
-            this.emitter.emit('error', error);
-        }
-    }
-    async createHandler() {
-        const token = this.client.getToken();
-        const config = { token };
-        if (this.options.ignoreSelfMessages !== undefined)
-            config.ignoreSelfMessages = this.options.ignoreSelfMessages;
-        if (this.options.pingInterval !== undefined)
-            config.pingInterval = this.options.pingInterval;
-        if (this.options.pongTimeout !== undefined)
-            config.pongTimeout = this.options.pongTimeout;
-        if (this.options.reconnectBackoffMax !== undefined)
-            config.reconnectBackoffMax = this.options.reconnectBackoffMax;
-        if (this.options.maxReconnectAttempts !== undefined)
-            config.maxReconnectAttempts = this.options.maxReconnectAttempts;
-        if (this.options._handlerFactory) {
-            return this.options._handlerFactory(config);
+        catch (error) {
+            if (error instanceof WebexError) {
+                throw new WebexBotError(error.message, error.code);
+            }
+            throw error;
         }
-        const wdmDevicesUrl = await discoverWdmDevicesUrl(token);
-        config.mode = 'injected';
-        config.fetch = createWdmRewriteFetch(wdmDevicesUrl);
-        config.webSocketFactory = (url) => new WebSocket(url);
-        return new WebexMessageHandler(config);
-    }
-    wireHandler(handler, generation) {
-        const onMessageCreated = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('message_created', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onMessageUpdated = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('message_updated', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onMessageDeleted = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('message_deleted', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onMembershipCreated = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('membership_created', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onAttachmentAction = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('attachment_action', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onRoomCreated = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('room_created', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onRoomUpdated = (event) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('room_updated', event);
-            this.emitter.emit('webex_event', event);
-        };
-        const onConnected = () => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('connected', { connected: handler.connected, status: handler.status() });
-        };
-        const onReconnecting = (attempt) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('reconnecting', attempt);
-        };
-        const onDisconnected = (reason) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitter.emit('disconnected', reason);
-        };
-        const onError = (error) => {
-            if (!this.isCurrent(handler, generation))
-                return;
-            this.emitError(error);
-        };
-        handler.on('message:created', onMessageCreated);
-        handler.on('message:updated', onMessageUpdated);
-        handler.on('message:deleted', onMessageDeleted);
-        handler.on('membership:created', onMembershipCreated);
-        handler.on('attachmentAction:created', onAttachmentAction);
-        handler.on('room:created', onRoomCreated);
-        handler.on('room:updated', onRoomUpdated);
-        handler.on('connected', onConnected);
-        handler.on('reconnecting', onReconnecting);
-        handler.on('disconnected', onDisconnected);
-        handler.on('error', onError);
-        return () => {
-            handler.off('message:created', onMessageCreated);
-            handler.off('message:updated', onMessageUpdated);
-            handler.off('message:deleted', onMessageDeleted);
-            handler.off('membership:created', onMembershipCreated);
-            handler.off('attachmentAction:created', onAttachmentAction);
-            handler.off('room:created', onRoomCreated);
-            handler.off('room:updated', onRoomUpdated);
-            handler.off('connected', onConnected);
-            handler.off('reconnecting', onReconnecting);
-            handler.off('disconnected', onDisconnected);
-            handler.off('error', onError);
-        };
     }
 }
 //# sourceMappingURL=listener.js.map

package/dist/src/platforms/webexbot/listener.js.map

@@ -1 +1 @@
-{"version":3,"file":"listener.js","sourceRoot":"","sources":["../../../../src/platforms/webexbot/listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAY3D,OAAO,SAAS,MAAM,IAAI,CAAA;AAI1B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAwB9E,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAoB;IAC1B,OAAO,CAAyB;IAChC,OAAO,GAAG,KAAK,CAAA;IACf,OAAO,GAAG,IAAI,YAAY,EAAE,CAAA;IAC5B,OAAO,GAAmC,IAAI,CAAA;IAC9C,UAAU,GAAG,CAAC,CAAA;IACd,aAAa,GAAwB,IAAI,CAAA;IACzC,YAAY,GAAyB,IAAI,CAAA;IAEjD,YAAY,MAA0B,EAAE,UAAmC,EAAE;QAC3E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAA;QAC/C,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QAExB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,UAAU,CAAA;QAEpC,IAAI,YAA4B,CAAA;QAChC,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YACzB,IAAI,OAAO,GAAmC,IAAI,CAAA;YAClD,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAA;gBAEpC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBACpD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;oBACjD,OAAM;gBACR,CAAC;gBACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;gBACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;gBAE1D,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;gBAEvB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAChF,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;oBACjD,OAAM;gBACR,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC/D,IAAI,CAAC,aAAa,EAAE,EAAE,CAAA;oBACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;oBACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;gBACrB,CAAC;gBACD,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBACnC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;gBACtB,CAAC;gBACD,MAAM,OAAO,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;gBAClD,MAAM,KAAK,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,IAAI,IAAI,CAAC,YAAY,KAAK,YAAY,EAAE,CAAC;oBACvC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;QAEJ,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;QACtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QAExB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,IAAI,CAAC,UAAU,EAAE,CAAA;QAEjB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAA;QACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QACzB,MAAM,EAAE,EAAE,CAAA;QAEV,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACnD,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,EAAE,CAAqB,KAAQ,EAAE,QAAwD;QACvF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAA;QAC5D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAqB,KAAQ,EAAE,QAAwD;QACxF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAA;QAC7D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAqB,KAAQ,EAAE,QAAwD;QACzF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,SAAS,CAAC,OAAgC,EAAE,UAAkB;QACpE,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,CAAA;IACnF,CAAC;IAED,+EAA+E;IAC/E,2EAA2E;IAC3E,oEAAoE;IAC5D,SAAS,CAAC,KAAY;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA;QACpC,MAAM,MAAM,GAA8B,EAAE,KAAK,EAAE,CAAA;QACnD,IAAI,IAAI,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS;YAAE,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAA;QAC9G,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAA;QAC5F,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAA;QACzF,IAAI,IAAI,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;YAAE,MAAM,CAAC,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAA;QACjH,IAAI,IAAI,CAAC,OAAO,CAAC,oBAAoB,KAAK,SAAS;YAAE,MAAM,CAAC,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAA;QAEpH,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;QAC7C,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAA;QACxD,MAAM,CAAC,IAAI,GAAG,UAAU,CAAA;QACxB,MAAM,CAAC,KAAK,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAA;QACnD,MAAM,CAAC,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,GAAG,CAAiC,CAAA;QAC7F,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;IAEO,WAAW,CAAC,OAAgC,EAAE,UAAkB;QACtE,MAAM,gBAAgB,GAAG,CAAC,KAAuB,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;YAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,gBAAgB,GAAG,CAAC,KAAuB,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;YAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,gBAAgB,GAAG,CAAC,KAAqB,EAAE,EAAE;YACjD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;YAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAAE,EAAE;YACxD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAA;YAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,kBAAkB,GAAG,CAAC,KAAuB,EAAE,EAAE;YACrD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAA;YAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAE,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAE,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC5F,CAAC,CAAA;QACD,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,EAAE;YACzC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;QAC5C,CAAC,CAAA;QACD,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,EAAE;YACxC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QAC3C,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAAE,OAAM;YAChD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC,CAAA;QAED,OAAO,CAAC,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;QAC/C,OAAO,CAAC,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;QAC/C,OAAO,CAAC,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;QAC/C,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAA;QACrD,OAAO,CAAC,EAAE,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAAA;QAC1D,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;QACzC,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;QACzC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;QACpC,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;QAC1C,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;QAC1C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE5B,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;YAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;YAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;YAChD,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAA;YACtD,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;YAC1C,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;YAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;YACrC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;YAC3C,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;YAC3C,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/B,CAAC,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"listener.js","sourceRoot":"","sources":["../../../../src/platforms/webexbot/listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAOvC,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACjD,iFAAiF;IACjF,mEAAmE;IACnE,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;gBAChC,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YACpD,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/src/platforms/webexbot/types.d.ts

@@ -1,5 +1,5 @@
-import type { AttachmentAction, DecryptedMessage, DeletedMessage, HandlerStatus, MembershipActivity, RoomActivity } from 'webex-message-handler';
 import { z } from 'zod';
+export type { WebexListenerEventMap as WebexBotListenerEventMap } from '../webex/listener.js';
 export interface WebexBotEntry {
     bot_id: string;
     bot_name: string;
@@ -40,21 +40,4 @@ export declare const WebexBotCredentialsSchema: z.ZodObject<{
     bot_id: z.ZodString;
     bot_name: z.ZodString;
 }, z.core.$strip>;
-export interface WebexBotListenerEventMap {
-    message_created: [event: DecryptedMessage];
-    message_updated: [event: DecryptedMessage];
-    message_deleted: [event: DeletedMessage];
-    membership_created: [event: MembershipActivity];
-    attachment_action: [event: AttachmentAction];
-    room_created: [event: RoomActivity];
-    room_updated: [event: RoomActivity];
-    webex_event: [event: DecryptedMessage | DeletedMessage | MembershipActivity | AttachmentAction | RoomActivity];
-    connected: [info: {
-        connected: boolean;
-        status: HandlerStatus;
-    }];
-    reconnecting: [attempt: number];
-    disconnected: [reason: string];
-    error: [error: Error];
-}
 //# sourceMappingURL=types.d.ts.map

package/dist/src/platforms/webexbot/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platforms/webexbot/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAA;gBAEA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAED,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;iBAO/B,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAA;AAEF,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;IAC1C,eAAe,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;IAC1C,eAAe,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACxC,kBAAkB,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAA;IAC/C,iBAAiB,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAA;IAC5C,YAAY,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACnC,YAAY,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACnC,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,CAAC,CAAA;IAC9G,SAAS,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;IAChE,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platforms/webexbot/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,YAAY,EAAE,qBAAqB,IAAI,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAE1F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAA;gBAEA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAED,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;iBAO/B,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAA"}

package/dist/src/platforms/webexbot/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/platforms/webexbot/types.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAmBvB,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,IAAI,CAAQ;IAEZ,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;SACD,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC;CAChD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/platforms/webexbot/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAqBvB,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,IAAI,CAAQ;IAEZ,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;SACD,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC;CAChD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAA"}

package/docs/content/docs/cli/webex.mdx

@@ -42,12 +42,32 @@ This command:
 - Auto-extraction runs when no valid token is stored, so manual extraction is rarely needed
 - Messages are encrypted client-side (JWE/AES-256-GCM). Encryption keys are cached at extract time; for end-to-end encrypted conversations whose key is not cached, the key is fetched on demand (Mercury + KMS) and persisted for reuse. Non-encrypted conversations send as plaintext.
 
+### Email/Password Login
+
+Logs in with a Webex email and password — no browser. Useful for servers and CI/CD that need a real user token (e.g. for the real-time listener, which receives all space messages without an @mention). Run `agent-webex auth login` with no flags in a terminal to be prompted for your email and then your password (read without echoing); for headless use, pipe the password via stdin to keep it out of shell history.
+
+```bash
+# Interactive — prompts for email, then password (hidden)
+agent-webex auth login
+
+# Headless — provide the email and pipe the password from stdin
+printf '%s' "$WEBEX_PASSWORD" | agent-webex auth login --email you@example.com --password-stdin
+
+# Provide the email only — password is prompted securely
+agent-webex auth login --email you@example.com
+```
+
+- Discovers the user's Webex region, performs OAuth2 Authorization Code + PKCE against Cisco IdBroker, and stores access/refresh tokens in `~/.config/agent-messenger/`
+- Produces a KMS-scoped user token (client-side JWE/AES-256-GCM encryption works)
+- `--idbroker-host <host>` overrides region auto-discovery if needed
+- Accounts protected by SSO/IdP or MFA are not supported and fail with a clear error
+
 ### OAuth Device Grant (Fallback)
 
 Uses OAuth Device Grant flow with built-in Integration credentials. No tokens to copy, no developer portal setup needed. Messages show "via agent-messenger".
 
 ```bash
-agent-webex auth login
+agent-webex auth oauth
 ```
 
 This command:
@@ -61,10 +81,11 @@ This command:
 
 ### How Login Works
 
-1. Run `agent-webex auth extract` (recommended) or `agent-webex auth login` (fallback)
+1. Run `agent-webex auth extract` (recommended), `agent-webex auth login` (email/password), or `agent-webex auth oauth` (Device Grant)
 2. For extraction: CLI reads your browser's Webex session — no prompts needed
-3. For Device Grant: Browser opens, enter the displayed code, CLI stores tokens
-4. Access tokens are refreshed automatically
+3. For email/password: CLI prompts for any missing credentials, then exchanges them for a token
+4. For Device Grant: Browser opens, enter the displayed code, CLI stores tokens
+5. Access tokens are refreshed automatically
 
 ### Token Types
 
@@ -72,6 +93,7 @@ This command:
 | -------------------------------- | -------------------------------------------- | ------------------------------------ |
 | Browser Extraction (recommended) | Session-based (re-extract when expired)      | Interactive use, sending as yourself |
 | OAuth Device Grant               | 14-day access, 90-day refresh (auto-refresh) | Fallback when no browser session     |
+| Email/Password (headless)        | Access + refresh (auto-refresh)              | Server-side/CI without a browser     |
 | Bot Token                        | Never expires                                | CI/CD, long-running automation       |
 | Personal Access Token (PAT)      | 12 hours                                     | Quick testing                        |
 
@@ -81,11 +103,15 @@ This command:
 # Extract token from browser (recommended)
 agent-webex auth extract
 
-# Log in (Device Grant flow, opens browser)
+# Log in with email/password (prompts when flags are omitted)
 agent-webex auth login
+printf '%s' "$WEBEX_PASSWORD" | agent-webex auth login --email you@example.com --password-stdin
 
-# Log in with custom Integration credentials
-agent-webex auth login --client-id <id> --client-secret <secret>
+# Log in via OAuth Device Grant (opens browser)
+agent-webex auth oauth
+
+# Log in via OAuth with custom Integration credentials
+agent-webex auth oauth --client-id <id> --client-secret <secret>
 
 # Log in with a bot token (never expires)
 agent-webex auth login --token <bot-token>
@@ -109,7 +135,7 @@ Override the built-in Integration credentials with your own:
 | `AGENT_WEBEX_CLIENT_ID`     | Webex Integration client ID     |
 | `AGENT_WEBEX_CLIENT_SECRET` | Webex Integration client secret |
 
-Both must be set together. When set, `auth login` (without `--token`) uses these instead of the built-in credentials.
+Both must be set together. When set, `auth oauth` uses these instead of the built-in credentials.
 
 ## Commands
 
@@ -233,10 +259,10 @@ agent-webex auth login
 
 ### Token Expired (401 Unauthorized)
 
-**If using Device Grant (default)**: Tokens auto-refresh. If you still get 401s, the refresh token may have expired (after 90 days). Re-run:
+**If using Device Grant**: Tokens auto-refresh. If you still get 401s, the refresh token may have expired (after 90 days). Re-run:
 
 ```bash
-agent-webex auth login
+agent-webex auth oauth
 ```
 
 **If using a PAT**: Generate a new one at https://developer.webex.com/docs/getting-started
@@ -245,10 +271,10 @@ agent-webex auth login
 
 ### "Device authorization timed out"
 
-You didn't approve the request in the browser before the code expired. Run `auth login` again:
+You didn't approve the request in the browser before the code expired. Run `auth oauth` again:
 
 ```bash
-agent-webex auth login
+agent-webex auth oauth
 ```
 
 ### "Device authorization failed"

package/docs/content/docs/sdk/webexbot.mdx

@@ -177,6 +177,22 @@ const listener = new WebexBotListener(client, {
 | `disconnected`       | `string` (reason)        | Connection dropped; listener will auto-reconnect       |
 | `error`              | `Error`                  | Fatal error (max reconnects exceeded). Listener stops. |
 
+### ID format
+
+Every REST-resource ID on emitted events — person IDs (`personId`, `actorId`, `mentionedPeople`), room IDs (`roomId`), message IDs (`id`, `parentId`, `messageId`), and `AttachmentAction.id` — is in **Webex REST ID format** (`ciscospark://...` base64), directly comparable with IDs returned by `WebexBotClient` (e.g. `getMessage`, `listSpaces`, `listPeople`). The two Mercury-only activity IDs that have no REST resource — `MembershipActivity.id` and `RoomActivity.id` — stay as raw Mercury UUIDs. The original Mercury payload (with raw UUIDs) is preserved under `.raw` on every event except `message_deleted`, whose upstream Mercury event does not include the full activity.
+
+```typescript
+import { WebexBotClient, WebexBotListener, fromRestId } from 'agent-messenger/webexbot'
+
+listener.on('message_created', async (event) => {
+  // event.roomId is a REST ID — compare it directly with REST results
+  const space = await client.getSpace(event.roomId)
+
+  // Recover the raw Mercury UUID when needed
+  const personUuid = fromRestId(event.personId)
+})
+```
+
 ### Reconnection
 
 On transient failures (network drops, 5xx), the listener emits `disconnected` and retries with exponential backoff up to `reconnectBackoffMax`. After `maxReconnectAttempts` consecutive failures, it emits `error` and stops.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-messenger",
-  "version": "2.22.0",
+  "version": "2.23.1",
   "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams, Webex, Telegram, Telegram Bot, WhatsApp, LINE, Instagram, KakaoTalk, Channel Talk)",
   "repository": {
     "type": "git",

package/skills/agent-channeltalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalk
 description: Interact with Channel Talk using extracted desktop app or browser credentials - read chats, send messages, search messages, manage groups
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-channeltalk:*)
 metadata:
   openclaw:

package/skills/agent-channeltalkbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-channeltalkbot
 description: Interact with Channel Talk workspaces using API credentials - send messages, read chats, manage groups and bots
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-channeltalkbot:*)
 metadata:
   openclaw:

package/skills/agent-discord/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discord
 description: Interact with Discord servers - send messages, read channels, manage reactions
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-discord:*)
 metadata:
   openclaw:

package/skills/agent-discordbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-discordbot
 description: Interact with Discord servers using bot tokens - send messages, read channels, manage reactions
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-discordbot:*)
 metadata:
   openclaw:

package/skills/agent-instagram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-instagram
 description: Interact with Instagram DMs - send messages, read conversations, manage accounts
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-instagram:*)
 metadata:
   openclaw:

package/skills/agent-kakaotalk/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-kakaotalk
 description: Interact with KakaoTalk - send messages, read chats, manage conversations
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-kakaotalk:*)
 metadata:
   openclaw:

package/skills/agent-line/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-line
 description: Interact with LINE - send messages, read chats, manage conversations
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-line:*)
 metadata:
   openclaw:

package/skills/agent-slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slack
 description: Interact with Slack workspaces - send messages, read channels, manage reactions
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-slack:*)
 metadata:
   openclaw:

package/skills/agent-slackbot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-slackbot
 description: Interact with Slack workspaces using bot tokens - send messages, read channels, manage reactions
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-slackbot:*)
 metadata:
   openclaw:

package/skills/agent-teams/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-teams
 description: Interact with Microsoft Teams - send messages, read channels, manage reactions
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-teams:*)
 metadata:
   openclaw:

package/skills/agent-telegram/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegram
 description: Interact with Telegram through TDLib - authenticate, inspect chats, and send messages
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-telegram:*)
 ---
 

package/skills/agent-telegrambot/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agent-telegrambot
 description: Interact with Telegram using bot tokens - send messages, read chats, manage reactions
-version: 2.22.0
+version: 2.23.1
 allowed-tools: Bash(agent-telegrambot:*)
 metadata:
   openclaw: