@ravi-hq/ravi 0.4.1 → 0.5.1

package/dist/channels/email.d.ts

@@ -1,5 +1,5 @@
 import type { RaviClient } from "../client.js";
-import type { EmailEvent } from "../types.js";
+import type { EmailEvent, BaseGatewayContext } from "../types.js";
 /** Configuration for a single email account within the ravi-email channel. */
 export interface EmailAccountConfig {
     /** The identity UUID this account is bound to. */
@@ -41,6 +41,8 @@ export interface EmailInboundEnvelope {
         lastMessageId: number;
     };
 }
+/** Context passed by the ChannelManager to `gateway.startAccount()`. */
+export type EmailGatewayContext = BaseGatewayContext<EmailAccountConfig>;
 /**
  * Creates the ravi-email channel definition for OpenClaw.
  *
@@ -69,17 +71,22 @@ export declare function createEmailChannel(): {
         /**
          * List all configured account IDs (identity UUIDs) for the ravi-email channel.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * Reads from the plugin config path first (set by `openclaw ravi login`),
+         * then falls back to the standard `channels.ravi-email.accounts` path.
+         * Deduplicates when both sources contain the same UUID.
+         *
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @returns Array of identity UUID strings.
          */
         listAccountIds: (cfg: Record<string, unknown>) => string[];
         /**
          * Resolve an account configuration by its ID (identity UUID).
          *
-         * Returns a default empty config if the account is not found rather than
-         * throwing, so callers can handle missing accounts gracefully.
+         * Returns a minimal config with just the UUID if the account is not
+         * found in the standard channels path. The gateway adapter will fetch
+         * identity details at startup.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @param accountId - The identity UUID to look up.
          * @returns The resolved {@link EmailAccountConfig}.
          */
@@ -94,7 +101,7 @@ export declare function createEmailChannel(): {
      *
      * @param event - The raw {@link EmailEvent} from the SSE stream.
      * @param account - The {@link EmailAccountConfig} for the receiving identity.
-     * @returns A normalized {@link EmailInboundEnvelope} (never null).
+     * @returns A normalized {@link EmailInboundEnvelope}. Current implementation always returns non-null.
      */
     normalizeInbound(event: EmailEvent, account: EmailAccountConfig): EmailInboundEnvelope | null;
     outbound: {
@@ -134,6 +141,27 @@ export declare function createEmailChannel(): {
      * @returns The deterministic session key string.
      */
     getSessionKey(agentId: string, accountId: string, threadId: string): string;
+    gateway: {
+        /**
+         * Start monitoring inbound emails for a single identity account.
+         *
+         * Called by the ChannelManager once per account. Opens an SSE stream
+         * to the Ravi backend, dispatches inbound emails through the OpenClaw
+         * reply pipeline, and blocks until the abort signal fires.
+         *
+         * This gateway adapter is the ChannelManager-driven path, used when
+         * OpenClaw manages channel lifecycles directly. The `normalizeInbound` +
+         * `RaviListenerService` path in service.ts is the legacy self-managed
+         * approach for environments where the gateway doesn't call startAccount.
+         *
+         * Owner/self senders get full dispatch with reply delivery.
+         * External senders trigger an agent turn but reply delivery is suppressed.
+         *
+         * @param ctx - Gateway context provided by the ChannelManager.
+         * @returns Promise that resolves when the account is stopped.
+         */
+        startAccount: (ctx: EmailGatewayContext) => Promise<void>;
+    };
 };
 /** The singleton ravi-email channel instance. */
 export declare const raviEmailChannel: {
@@ -152,17 +180,22 @@ export declare const raviEmailChannel: {
         /**
          * List all configured account IDs (identity UUIDs) for the ravi-email channel.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * Reads from the plugin config path first (set by `openclaw ravi login`),
+         * then falls back to the standard `channels.ravi-email.accounts` path.
+         * Deduplicates when both sources contain the same UUID.
+         *
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @returns Array of identity UUID strings.
          */
         listAccountIds: (cfg: Record<string, unknown>) => string[];
         /**
          * Resolve an account configuration by its ID (identity UUID).
          *
-         * Returns a default empty config if the account is not found rather than
-         * throwing, so callers can handle missing accounts gracefully.
+         * Returns a minimal config with just the UUID if the account is not
+         * found in the standard channels path. The gateway adapter will fetch
+         * identity details at startup.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @param accountId - The identity UUID to look up.
          * @returns The resolved {@link EmailAccountConfig}.
          */
@@ -177,7 +210,7 @@ export declare const raviEmailChannel: {
      *
      * @param event - The raw {@link EmailEvent} from the SSE stream.
      * @param account - The {@link EmailAccountConfig} for the receiving identity.
-     * @returns A normalized {@link EmailInboundEnvelope} (never null).
+     * @returns A normalized {@link EmailInboundEnvelope}. Current implementation always returns non-null.
      */
     normalizeInbound(event: EmailEvent, account: EmailAccountConfig): EmailInboundEnvelope | null;
     outbound: {
@@ -217,5 +250,26 @@ export declare const raviEmailChannel: {
      * @returns The deterministic session key string.
      */
     getSessionKey(agentId: string, accountId: string, threadId: string): string;
+    gateway: {
+        /**
+         * Start monitoring inbound emails for a single identity account.
+         *
+         * Called by the ChannelManager once per account. Opens an SSE stream
+         * to the Ravi backend, dispatches inbound emails through the OpenClaw
+         * reply pipeline, and blocks until the abort signal fires.
+         *
+         * This gateway adapter is the ChannelManager-driven path, used when
+         * OpenClaw manages channel lifecycles directly. The `normalizeInbound` +
+         * `RaviListenerService` path in service.ts is the legacy self-managed
+         * approach for environments where the gateway doesn't call startAccount.
+         *
+         * Owner/self senders get full dispatch with reply delivery.
+         * External senders trigger an agent turn but reply delivery is suppressed.
+         *
+         * @param ctx - Gateway context provided by the ChannelManager.
+         * @returns Promise that resolves when the account is stopped.
+         */
+        startAccount: (ctx: EmailGatewayContext) => Promise<void>;
+    };
 };
 //# sourceMappingURL=email.d.ts.map

package/dist/channels/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/channels/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CAEf;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB;;;;;;;;;;;;;QAkB5B;;;;;WAKG;8BACmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,EAAE;QAOxD;;;;;;;;;WASG;8BAEI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aACjB,MAAM,KAChB,kBAAkB;;IAgBvB;;;;;;;;;;OAUG;4BAEM,UAAU,WACR,kBAAkB,GAC1B,oBAAoB,GAAG,IAAI;;;QAuB5B;;;;;;;;;;WAUG;2BACsB;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,UAAU,CAAC;YACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC;SACpC,KAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;;IAoB9C;;;;;;;;;;;;;OAaG;2BACoB,MAAM,aAAa,MAAM,YAAY,MAAM,GAAG,MAAM;EAI9E;AAED,iDAAiD;AACjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;QAvIvB;;;;;WAKG;8BACmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,EAAE;QAOxD;;;;;;;;;WASG;8BAEI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aACjB,MAAM,KAChB,kBAAkB;;IAgBvB;;;;;;;;;;OAUG;4BAEM,UAAU,WACR,kBAAkB,GAC1B,oBAAoB,GAAG,IAAI;;;QAuB5B;;;;;;;;;;WAUG;2BACsB;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,UAAU,CAAC;YACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC;SACpC,KAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;;IAoB9C;;;;;;;;;;;;;OAaG;2BACoB,MAAM,aAAa,MAAM,YAAY,MAAM,GAAG,MAAM;CAO3B,CAAC"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/channels/email.ts"],"names":[],"mappings":"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"}

package/dist/channels/email.js

@@ -29,30 +29,44 @@ export function createEmailChannel() {
             /**
              * List all configured account IDs (identity UUIDs) for the ravi-email channel.
              *
-             * @param cfg - The full OpenClaw plugin configuration object.
+             * Reads from the plugin config path first (set by `openclaw ravi login`),
+             * then falls back to the standard `channels.ravi-email.accounts` path.
+             * Deduplicates when both sources contain the same UUID.
+             *
+             * @param cfg - The full OpenClaw gateway configuration object.
              * @returns Array of identity UUID strings.
              */
             listAccountIds: (cfg) => {
+                // Primary: read from plugin config (set by `openclaw ravi login`)
+                const plugins = cfg.plugins;
+                const uuid = plugins?.entries?.ravi?.config?.identityUuid;
+                // Fallback: standard channel accounts path
                 const channels = cfg.channels;
-                return Object.keys(channels?.["ravi-email"]?.accounts ?? {});
+                const channelIds = Object.keys(channels?.["ravi-email"]?.accounts ?? {});
+                // Deduplicate — plugin config uuid takes priority
+                if (uuid) {
+                    return [uuid, ...channelIds.filter((id) => id !== uuid)];
+                }
+                return channelIds;
             },
             /**
              * Resolve an account configuration by its ID (identity UUID).
              *
-             * Returns a default empty config if the account is not found rather than
-             * throwing, so callers can handle missing accounts gracefully.
+             * Returns a minimal config with just the UUID if the account is not
+             * found in the standard channels path. The gateway adapter will fetch
+             * identity details at startup.
              *
-             * @param cfg - The full OpenClaw plugin configuration object.
+             * @param cfg - The full OpenClaw gateway configuration object.
              * @param accountId - The identity UUID to look up.
              * @returns The resolved {@link EmailAccountConfig}.
              */
             resolveAccount: (cfg, accountId) => {
                 const channels = cfg.channels;
                 const found = channels?.["ravi-email"]?.accounts?.[accountId];
-                if (!found) {
-                    console.warn(`[ravi] Email account ${accountId} not found in config — using empty defaults`);
-                }
-                return found ?? {
+                if (found)
+                    return found;
+                // Fallback: return minimal config — gateway adapter fetches details at startup
+                return {
                     identityUuid: accountId,
                     identityName: "",
                     email: "",
@@ -68,7 +82,7 @@ export function createEmailChannel() {
          *
          * @param event - The raw {@link EmailEvent} from the SSE stream.
          * @param account - The {@link EmailAccountConfig} for the receiving identity.
-         * @returns A normalized {@link EmailInboundEnvelope} (never null).
+         * @returns A normalized {@link EmailInboundEnvelope}. Current implementation always returns non-null.
          */
         normalizeInbound(event, account) {
             const isReadOnly = event.sender_type !== "owner" && event.sender_type !== "self";
@@ -136,6 +150,250 @@ export function createEmailChannel() {
         getSessionKey(agentId, accountId, threadId) {
             return `agent:${agentId}:ravi-email:${accountId}:thread:${threadId}`;
         },
+        // ─── Gateway Adapter ──────────────────────────────────────────────────
+        gateway: {
+            /**
+             * Start monitoring inbound emails for a single identity account.
+             *
+             * Called by the ChannelManager once per account. Opens an SSE stream
+             * to the Ravi backend, dispatches inbound emails through the OpenClaw
+             * reply pipeline, and blocks until the abort signal fires.
+             *
+             * This gateway adapter is the ChannelManager-driven path, used when
+             * OpenClaw manages channel lifecycles directly. The `normalizeInbound` +
+             * `RaviListenerService` path in service.ts is the legacy self-managed
+             * approach for environments where the gateway doesn't call startAccount.
+             *
+             * Owner/self senders get full dispatch with reply delivery.
+             * External senders trigger an agent turn but reply delivery is suppressed.
+             *
+             * @param ctx - Gateway context provided by the ChannelManager.
+             * @returns Promise that resolves when the account is stopped.
+             */
+            startAccount: async (ctx) => {
+                const log = ctx.log ?? {
+                    info: (...args) => console.log("[ravi-email]", ...args),
+                    warn: (...args) => console.warn("[ravi-email]", ...args),
+                    error: (...args) => console.error("[ravi-email]", ...args),
+                };
+                // Lazy imports — only loaded when the gateway actually starts an account.
+                // This avoids pulling in runtime/auth/config/client/sse in test environments
+                // where gateway.startAccount() is never called.
+                let getRaviRuntime, loadAuth, updateAuth, RAVI_API_URL, RaviClient, RaviSSEClient;
+                try {
+                    ({ getRaviRuntime } = await import("../runtime.js"));
+                    ({ loadAuth, updateAuth } = await import("../auth.js"));
+                    ({ RAVI_API_URL } = await import("../config.js"));
+                    ({ RaviClient } = await import("../client.js"));
+                    ({ RaviSSEClient } = await import("../sse.js"));
+                }
+                catch (err) {
+                    const detail = err instanceof Error ? err.message : String(err);
+                    log.error(`[ravi-email] Failed to load dependencies: ${detail}. Is the plugin built correctly?`);
+                    return;
+                }
+                const runtime = getRaviRuntime();
+                const auth = loadAuth();
+                if (!auth?.access_token) {
+                    log.error("[ravi-email] No auth credentials — cannot start email channel. Run 'openclaw ravi login'.");
+                    return;
+                }
+                // Track the current token — onTokenRefresh updates this when the
+                // REST client auto-refreshes on 401, so the SSE client (created after
+                // the first REST call) gets the fresh token instead of the stale one.
+                let currentToken = auth.access_token;
+                let sse = null;
+                // Build HTTP client for identity lookup + outbound replies
+                const client = new RaviClient({
+                    apiUrl: RAVI_API_URL,
+                    token: auth.access_token,
+                    refreshToken: auth.refresh_token,
+                    identityUuid: ctx.accountId,
+                    onTokenRefresh: (newToken) => {
+                        currentToken = newToken;
+                        try {
+                            updateAuth({ access_token: newToken });
+                        }
+                        catch (err) {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-email] Failed to persist refreshed token: ${detail}`);
+                        }
+                        sse?.updateToken(newToken);
+                    },
+                });
+                // Fetch identity details (email address, name) if not in config
+                let email = ctx.account.email;
+                let identityName = ctx.account.identityName;
+                if (!email) {
+                    try {
+                        const identities = await client.listIdentities();
+                        const identity = identities.find((i) => i.uuid === ctx.accountId);
+                        email = identity?.inbox ?? "";
+                        identityName = identity?.display_name ?? identity?.name ?? ctx.accountId;
+                    }
+                    catch (err) {
+                        if (err?.name === "RaviApiError") {
+                            const status = err.status;
+                            log.error(`[ravi-email] Failed to fetch identity details (HTTP ${status}): ${err.message}` +
+                                (status === 401 ? ". Token may be expired — run 'openclaw ravi login'." : ""));
+                        }
+                        else {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-email] Failed to fetch identity details: ${detail}`);
+                        }
+                        return;
+                    }
+                }
+                if (!email) {
+                    log.error(`[ravi-email] Identity ${ctx.accountId} has no email address — cannot start email channel`);
+                    return;
+                }
+                log.info(`[ravi-email] Starting email channel for ${identityName} (${email})`);
+                // Build SSE client using currentToken — which may have been refreshed
+                // by the listIdentities() call above if the original token was expired.
+                // onAuthFailure triggers a REST call to force auto-refresh, then returns
+                // the updated currentToken (already set by onTokenRefresh callback).
+                sse = new RaviSSEClient({
+                    apiUrl: RAVI_API_URL,
+                    token: currentToken,
+                    identityUuid: ctx.accountId,
+                    onAuthFailure: async () => {
+                        const tokenBefore = currentToken;
+                        try {
+                            await client.listIdentities();
+                        }
+                        catch (err) {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-email] Auth refresh failed during SSE reconnect: ${detail}. Run 'openclaw ravi login' to re-authenticate.`);
+                            return null;
+                        }
+                        if (currentToken === tokenBefore) {
+                            log.warn(`[ravi-email] Auth refresh did not produce a new token — SSE auth failure is not recoverable via REST refresh`);
+                            return null;
+                        }
+                        return currentToken;
+                    },
+                });
+                sse.onEmail((event) => {
+                    try {
+                        // Classify sender: owner/self get full reply; external/unknown wakes agent but suppresses delivery
+                        const isAuthorizedSender = event.sender_type === "owner" || event.sender_type === "self";
+                        const lastMessageId = Number(event.id) || 0;
+                        if (!lastMessageId) {
+                            log.warn(`[ravi-email] Event has non-numeric id "${event.id}" — reply threading may fail`);
+                        }
+                        const subject = event.subject;
+                        // Resolve agent route — maps (channel, accountId) → agentId + session key
+                        const route = runtime.channel.routing.resolveAgentRoute({
+                            cfg: ctx.cfg,
+                            channel: "ravi-email",
+                            accountId: ctx.accountId,
+                            peer: { kind: "direct", id: event.thread_id },
+                        });
+                        const sessionKey = route.sessionKey;
+                        // Build MsgContext for dispatch
+                        const msgCtx = {
+                            Body: event.text_content || event.subject,
+                            BodyForAgent: event.text_content || event.subject,
+                            From: `ravi-email:${event.from_email}`,
+                            To: `ravi-email:${email}`,
+                            SessionKey: sessionKey,
+                            AccountId: ctx.accountId,
+                            ChatType: "direct",
+                            Provider: "ravi-email",
+                            Surface: "ravi-email",
+                            OriginatingChannel: "ravi-email",
+                            OriginatingTo: ctx.accountId,
+                            SenderName: event.from_display_name || event.from_email,
+                            SenderId: event.from_email,
+                            Timestamp: Date.now(),
+                            CommandAuthorized: isAuthorizedSender,
+                            MessageSid: `ravi-email:${event.id}`,
+                        };
+                        // Record inbound session so follow-ups route back through this email thread
+                        try {
+                            runtime.channel.session.recordInboundSession({
+                                storePath: runtime.channel.session.resolveStorePath(ctx.cfg.session?.store, { agentId: route.agentId }),
+                                sessionKey,
+                                ctx: msgCtx,
+                                updateLastRoute: {
+                                    sessionKey,
+                                    channel: "ravi-email",
+                                    to: ctx.accountId,
+                                    accountId: ctx.accountId,
+                                    threadId: event.thread_id,
+                                },
+                                onRecordError: (err) => {
+                                    const detail = err instanceof Error ? err.message : String(err);
+                                    log.error(`[ravi-email] Session record error for thread ${event.thread_id}: ${detail}`);
+                                },
+                            });
+                        }
+                        catch (err) {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-email] recordInboundSession threw for thread ${event.thread_id}: ${detail}`);
+                        }
+                        // Dispatch — triggers AI agent turn.
+                        // For external senders: AI wakes up, can use tools, but deliver is suppressed.
+                        runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+                            ctx: msgCtx,
+                            cfg: ctx.cfg,
+                            dispatcherOptions: {
+                                deliver: async (payload) => {
+                                    if (!payload.text) {
+                                        log.info(`[ravi-email] Deliver called with empty text for thread ${event.thread_id} — skipping`);
+                                        return;
+                                    }
+                                    // Suppress reply delivery for external senders
+                                    if (!isAuthorizedSender) {
+                                        log.info(`[ravi-email] Suppressing reply to external sender ${event.from_email}`);
+                                        return;
+                                    }
+                                    try {
+                                        await client.replyToEmail(lastMessageId, wrapInHtml(payload.text), subject);
+                                    }
+                                    catch (err) {
+                                        const detail = err instanceof Error ? err.message : String(err);
+                                        const status = err?.status;
+                                        log.error(`[ravi-email] Failed to deliver reply to thread ${event.thread_id}` +
+                                            `${status ? ` (HTTP ${status})` : ""}: ${detail}`);
+                                    }
+                                },
+                                onError: (err) => {
+                                    log.error(`[ravi-email] Dispatch error: ${err}`);
+                                },
+                            },
+                        }).catch((err) => {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-email] dispatchReply failed for thread ${event.thread_id}: ${detail}`);
+                        });
+                    }
+                    catch (err) {
+                        const detail = err instanceof Error ? err.message : String(err);
+                        log.error(`[ravi-email] Unhandled error processing event ${event.id}: ${detail}`);
+                    }
+                });
+                sse.onReconnect(() => {
+                    log.info(`[ravi-email] SSE reconnecting for ${identityName}`);
+                });
+                sse.connect();
+                log.info(`[ravi-email] SSE connected for ${identityName} (${ctx.accountId})`);
+                // Block until gateway signals shutdown
+                await new Promise((resolve) => {
+                    if (ctx.abortSignal.aborted) {
+                        log.info(`[ravi-email] Stopping email channel for ${identityName} (already aborted)`);
+                        sse.disconnect();
+                        resolve();
+                        return;
+                    }
+                    ctx.abortSignal.addEventListener("abort", () => {
+                        log.info(`[ravi-email] Stopping email channel for ${identityName}`);
+                        sse.disconnect();
+                        resolve();
+                    });
+                });
+            },
+        },
     };
 }
 /** The singleton ravi-email channel instance. */

package/dist/channels/email.js.map

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

package/dist/channels/sms.d.ts

@@ -1,5 +1,5 @@
 import type { RaviClient } from "../client.js";
-import type { SmsEvent } from "../types.js";
+import type { SmsEvent, BaseGatewayContext } from "../types.js";
 /** Configuration for a single SMS account within the ravi-sms channel. */
 export interface SmsAccountConfig {
     /** The identity UUID this account is bound to. */
@@ -35,6 +35,8 @@ export interface SmsInboundEnvelope {
         conversationId: string;
     };
 }
+/** Context passed by the ChannelManager to `gateway.startAccount()`. */
+export type SmsGatewayContext = BaseGatewayContext<SmsAccountConfig>;
 /**
  * Creates the ravi-sms channel definition for OpenClaw.
  *
@@ -63,17 +65,22 @@ export declare function createSmsChannel(): {
         /**
          * List all configured account IDs (identity UUIDs) for the ravi-sms channel.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * Reads from the plugin config path first (set by `openclaw ravi login`),
+         * then falls back to the standard `channels.ravi-sms.accounts` path.
+         * Deduplicates when both sources contain the same UUID.
+         *
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @returns Array of identity UUID strings.
          */
         listAccountIds: (cfg: Record<string, unknown>) => string[];
         /**
          * Resolve an account configuration by its ID (identity UUID).
          *
-         * Returns a default empty config if the account is not found rather than
-         * throwing, so callers can handle missing accounts gracefully.
+         * Returns a minimal config with just the UUID if the account is not
+         * found in the standard channels path. The gateway adapter will fetch
+         * identity details at startup.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @param accountId - The identity UUID to look up.
          * @returns The resolved {@link SmsAccountConfig}.
          */
@@ -88,7 +95,7 @@ export declare function createSmsChannel(): {
      *
      * @param event - The raw {@link SmsEvent} from the SSE stream.
      * @param account - The {@link SmsAccountConfig} for the receiving identity.
-     * @returns A normalized {@link SmsInboundEnvelope} (never null).
+     * @returns A normalized {@link SmsInboundEnvelope}. Current implementation always returns non-null.
      */
     normalizeInbound(event: SmsEvent, account: SmsAccountConfig): SmsInboundEnvelope | null;
     outbound: {
@@ -132,6 +139,30 @@ export declare function createSmsChannel(): {
      * @returns The deterministic session key string.
      */
     getSessionKey(agentId: string, accountId: string, phoneNumber: string): string;
+    gateway: {
+        /**
+         * Start monitoring inbound SMS for a single identity account.
+         *
+         * Called by the ChannelManager once per account. Opens an SSE stream
+         * to the Ravi backend, dispatches inbound SMS through the OpenClaw
+         * reply pipeline, and blocks until the abort signal fires.
+         *
+         * Bails out early if the identity has no phone number — SMS requires
+         * a provisioned phone number.
+         *
+         * Owner/self senders get full dispatch with reply delivery.
+         * External senders trigger an agent turn but reply delivery is suppressed.
+         *
+         * This gateway adapter is the ChannelManager-driven path, used when
+         * OpenClaw manages channel lifecycles directly. The `normalizeInbound` +
+         * `RaviListenerService` path in service.ts is the legacy self-managed
+         * approach for environments where the gateway doesn't call startAccount.
+         *
+         * @param ctx - Gateway context provided by the ChannelManager.
+         * @returns Promise that resolves when the account is stopped.
+         */
+        startAccount: (ctx: SmsGatewayContext) => Promise<void>;
+    };
 };
 /** The singleton ravi-sms channel instance. */
 export declare const raviSmsChannel: {
@@ -150,17 +181,22 @@ export declare const raviSmsChannel: {
         /**
          * List all configured account IDs (identity UUIDs) for the ravi-sms channel.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * Reads from the plugin config path first (set by `openclaw ravi login`),
+         * then falls back to the standard `channels.ravi-sms.accounts` path.
+         * Deduplicates when both sources contain the same UUID.
+         *
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @returns Array of identity UUID strings.
          */
         listAccountIds: (cfg: Record<string, unknown>) => string[];
         /**
          * Resolve an account configuration by its ID (identity UUID).
          *
-         * Returns a default empty config if the account is not found rather than
-         * throwing, so callers can handle missing accounts gracefully.
+         * Returns a minimal config with just the UUID if the account is not
+         * found in the standard channels path. The gateway adapter will fetch
+         * identity details at startup.
          *
-         * @param cfg - The full OpenClaw plugin configuration object.
+         * @param cfg - The full OpenClaw gateway configuration object.
          * @param accountId - The identity UUID to look up.
          * @returns The resolved {@link SmsAccountConfig}.
          */
@@ -175,7 +211,7 @@ export declare const raviSmsChannel: {
      *
      * @param event - The raw {@link SmsEvent} from the SSE stream.
      * @param account - The {@link SmsAccountConfig} for the receiving identity.
-     * @returns A normalized {@link SmsInboundEnvelope} (never null).
+     * @returns A normalized {@link SmsInboundEnvelope}. Current implementation always returns non-null.
      */
     normalizeInbound(event: SmsEvent, account: SmsAccountConfig): SmsInboundEnvelope | null;
     outbound: {
@@ -219,5 +255,29 @@ export declare const raviSmsChannel: {
      * @returns The deterministic session key string.
      */
     getSessionKey(agentId: string, accountId: string, phoneNumber: string): string;
+    gateway: {
+        /**
+         * Start monitoring inbound SMS for a single identity account.
+         *
+         * Called by the ChannelManager once per account. Opens an SSE stream
+         * to the Ravi backend, dispatches inbound SMS through the OpenClaw
+         * reply pipeline, and blocks until the abort signal fires.
+         *
+         * Bails out early if the identity has no phone number — SMS requires
+         * a provisioned phone number.
+         *
+         * Owner/self senders get full dispatch with reply delivery.
+         * External senders trigger an agent turn but reply delivery is suppressed.
+         *
+         * This gateway adapter is the ChannelManager-driven path, used when
+         * OpenClaw manages channel lifecycles directly. The `normalizeInbound` +
+         * `RaviListenerService` path in service.ts is the legacy self-managed
+         * approach for environments where the gateway doesn't call startAccount.
+         *
+         * @param ctx - Gateway context provided by the ChannelManager.
+         * @returns Promise that resolves when the account is stopped.
+         */
+        startAccount: (ctx: SmsGatewayContext) => Promise<void>;
+    };
 };
 //# sourceMappingURL=sms.d.ts.map