@ravi-hq/ravi 0.4.0 → 0.5.0

package/dist/channels/sms.js

@@ -28,30 +28,44 @@ export 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) => {
+                // 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-sms"]?.accounts ?? {});
+                const channelIds = Object.keys(channels?.["ravi-sms"]?.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 SmsAccountConfig}.
              */
             resolveAccount: (cfg, accountId) => {
                 const channels = cfg.channels;
                 const found = channels?.["ravi-sms"]?.accounts?.[accountId];
-                if (!found) {
-                    console.warn(`[ravi] SMS 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: "",
                     phone: "",
@@ -67,7 +81,7 @@ export 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, account) {
             const isReadOnly = event.sender_type !== "owner" && event.sender_type !== "self";
@@ -134,6 +148,214 @@ export function createSmsChannel() {
         getSessionKey(agentId, accountId, phoneNumber) {
             return `agent:${agentId}:ravi-sms:${accountId}:dm:${phoneNumber}`;
         },
+        // ─── Gateway Adapter ──────────────────────────────────────────────────
+        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: async (ctx) => {
+                const log = ctx.log ?? {
+                    info: (...args) => console.log("[ravi-sms]", ...args),
+                    warn: (...args) => console.warn("[ravi-sms]", ...args),
+                    error: (...args) => console.error("[ravi-sms]", ...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, RAVI_API_URL, RaviClient, RaviSSEClient;
+                try {
+                    ({ getRaviRuntime } = await import("../runtime.js"));
+                    ({ loadAuth } = 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-sms] Failed to load dependencies: ${detail}. Is the plugin built correctly?`);
+                    return;
+                }
+                const runtime = getRaviRuntime();
+                const auth = loadAuth();
+                if (!auth?.access_token) {
+                    log.error("[ravi-sms] No auth credentials — cannot start SMS channel. Run 'openclaw ravi login'.");
+                    return;
+                }
+                // 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,
+                });
+                // Fetch identity details (phone number, name) if not in config
+                let phone = ctx.account.phone;
+                let identityName = ctx.account.identityName;
+                if (!phone) {
+                    try {
+                        const identities = await client.listIdentities();
+                        const identity = identities.find((i) => i.uuid === ctx.accountId);
+                        phone = identity?.phone ?? "";
+                        identityName = identity?.display_name ?? identity?.name ?? ctx.accountId;
+                    }
+                    catch (err) {
+                        if (err?.name === "RaviApiError") {
+                            const status = err.status;
+                            log.error(`[ravi-sms] 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-sms] Failed to fetch identity details: ${detail}`);
+                        }
+                        return;
+                    }
+                }
+                // SMS requires a phone number — bail out if the identity doesn't have one
+                if (!phone) {
+                    log.info(`[ravi-sms] Identity ${identityName} has no phone number — skipping SMS channel`);
+                    return;
+                }
+                log.info(`[ravi-sms] Starting SMS channel for ${identityName} (${phone})`);
+                // Build SSE client for real-time events
+                const sse = new RaviSSEClient({
+                    apiUrl: RAVI_API_URL,
+                    token: auth.access_token,
+                    identityUuid: ctx.accountId,
+                });
+                sse.onSms((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";
+                        // Resolve agent route — maps (channel, accountId) → agentId + session key
+                        const route = runtime.channel.routing.resolveAgentRoute({
+                            cfg: ctx.cfg,
+                            channel: "ravi-sms",
+                            accountId: ctx.accountId,
+                            peer: { kind: "direct", id: event.from_number },
+                        });
+                        const sessionKey = route.sessionKey;
+                        // Build MsgContext for dispatch
+                        const msgCtx = {
+                            Body: event.body,
+                            BodyForAgent: event.body,
+                            From: `ravi-sms:${event.from_number}`,
+                            To: `ravi-sms:${phone}`,
+                            SessionKey: sessionKey,
+                            AccountId: ctx.accountId,
+                            ChatType: "direct",
+                            Provider: "ravi-sms",
+                            Surface: "ravi-sms",
+                            OriginatingChannel: "ravi-sms",
+                            OriginatingTo: ctx.accountId,
+                            SenderName: event.from_number,
+                            SenderId: event.from_number,
+                            Timestamp: Date.now(),
+                            CommandAuthorized: isAuthorizedSender,
+                            MessageSid: `ravi-sms:${event.id}`,
+                        };
+                        // Record inbound session so follow-ups route back through SMS
+                        try {
+                            runtime.channel.session.recordInboundSession({
+                                storePath: runtime.channel.session.resolveStorePath(ctx.cfg.session?.store, { agentId: route.agentId }),
+                                sessionKey,
+                                ctx: msgCtx,
+                                updateLastRoute: {
+                                    sessionKey,
+                                    channel: "ravi-sms",
+                                    to: ctx.accountId,
+                                    accountId: ctx.accountId,
+                                    phoneNumber: event.from_number,
+                                },
+                                onRecordError: (err) => {
+                                    const detail = err instanceof Error ? err.message : String(err);
+                                    log.error(`[ravi-sms] Session record error for ${event.from_number}: ${detail}`);
+                                },
+                            });
+                        }
+                        catch (err) {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-sms] recordInboundSession threw for ${event.from_number}: ${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-sms] Deliver called with empty text for ${event.from_number} — skipping`);
+                                        return;
+                                    }
+                                    // Suppress reply delivery for external senders
+                                    if (!isAuthorizedSender) {
+                                        log.info(`[ravi-sms] Suppressing reply to external sender ${event.from_number}`);
+                                        return;
+                                    }
+                                    try {
+                                        await client.sendSms(event.from_number, payload.text);
+                                    }
+                                    catch (err) {
+                                        const detail = err instanceof Error ? err.message : String(err);
+                                        const status = err?.status;
+                                        log.error(`[ravi-sms] Failed to deliver reply to ${event.from_number}` +
+                                            `${status ? ` (HTTP ${status})` : ""}: ${detail}`);
+                                    }
+                                },
+                                onError: (err) => {
+                                    log.error(`[ravi-sms] Dispatch error: ${err}`);
+                                },
+                            },
+                        }).catch((err) => {
+                            const detail = err instanceof Error ? err.message : String(err);
+                            log.error(`[ravi-sms] dispatchReply failed for ${event.from_number}: ${detail}`);
+                        });
+                    }
+                    catch (err) {
+                        const detail = err instanceof Error ? err.message : String(err);
+                        log.error(`[ravi-sms] Unhandled error processing event ${event.id}: ${detail}`);
+                    }
+                });
+                sse.onReconnect(() => {
+                    log.info(`[ravi-sms] SSE reconnecting for ${identityName}`);
+                });
+                sse.connect();
+                log.info(`[ravi-sms] SSE connected for ${identityName} (${ctx.accountId})`);
+                // Block until gateway signals shutdown
+                await new Promise((resolve) => {
+                    if (ctx.abortSignal.aborted) {
+                        log.info(`[ravi-sms] Stopping SMS channel for ${identityName} (already aborted)`);
+                        sse.disconnect();
+                        resolve();
+                        return;
+                    }
+                    ctx.abortSignal.addEventListener("abort", () => {
+                        log.info(`[ravi-sms] Stopping SMS channel for ${identityName}`);
+                        sse.disconnect();
+                        resolve();
+                    });
+                });
+            },
+        },
     };
 }
 /** The singleton ravi-sms channel instance. */

package/dist/channels/sms.js.map

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

package/dist/cli.js

@@ -311,7 +311,7 @@ export const cliCommands = [
                             process.stderr.write(`Select an identity:\n`);
                             for (let i = 0; i < identities.length; i++) {
                                 const id = identities[i];
-                                const details = [id.email, id.phone].filter(Boolean).join(", ");
+                                const details = [id.inbox, id.phone].filter(Boolean).join(", ");
                                 process.stderr.write(`  ${i + 1}. ${id.name}${details ? ` (${details})` : ""}\n`);
                             }
                             try {
@@ -384,8 +384,8 @@ export const cliCommands = [
                 output += `\nIdentities (${identities.length}):\n`;
                 for (const identity of identities) {
                     output += `  - ${identity.name} (${identity.uuid})\n`;
-                    if (identity.email)
-                        output += `    Email: ${identity.email}\n`;
+                    if (identity.inbox)
+                        output += `    Email: ${identity.inbox}\n`;
                     if (identity.phone)
                         output += `    Phone: ${identity.phone}\n`;
                 }

package/dist/index.d.ts

@@ -7,7 +7,9 @@
  *
  * @module index
  */
-export type { RaviPluginConfig, Identity, EmailThread, EmailMessage, EmailThreadDetail, SmsConversation, SmsMessage, PasswordEntry, SecretEntry, EncryptionMeta, EmailEvent, SmsEvent, SenderType, } from "./types.js";
+export type { RaviPluginConfig, Identity, EmailThread, EmailMessage, EmailThreadDetail, SmsConversation, SmsMessage, PasswordEntry, SecretEntry, EncryptionMeta, EmailEvent, SmsEvent, SenderType, GatewayLogger, PluginRuntimeSubset, BaseGatewayContext, } from "./types.js";
+export type { EmailGatewayContext } from "./channels/email.js";
+export type { SmsGatewayContext } from "./channels/sms.js";
 export { RaviClient, RaviApiError } from "./client.js";
 export type { RaviClientConfig } from "./client.js";
 export type { CryptoManager, KeyPair } from "./crypto.js";
@@ -17,6 +19,8 @@ export type { ToolDefinition, ToolContext } from "./tools/identity.js";
 export type { EmailAccountConfig, EmailThreadContext, EmailInboundEnvelope } from "./channels/email.js";
 export type { SmsAccountConfig, SmsThreadContext, SmsInboundEnvelope } from "./channels/sms.js";
 export type { CliCommand } from "./cli.js";
+export { setRaviRuntime, getRaviRuntime } from "./runtime.js";
+import type { PluginRuntimeSubset } from "./types.js";
 /**
  * All agent tools combined into a single flat array.
  *
@@ -37,6 +41,8 @@ interface PluginAPI {
     config: Record<string, unknown>;
     /** Validated plugin-specific config from plugins.entries.ravi.config. */
     pluginConfig?: Record<string, unknown>;
+    /** PluginRuntime — provided by OpenClaw gateway hosts. May be absent in CLI-only or test environments. */
+    runtime?: PluginRuntimeSubset;
     /** Structured logger (info, warn, error, debug). */
     logger: {
         info: (...args: unknown[]) => void;
@@ -74,6 +80,10 @@ interface PluginAPI {
         start: () => void;
         stop: () => void;
     }): void;
+    /** Register a plugin lifecycle hook. */
+    on(hookName: string, handler: (...args: unknown[]) => unknown, opts?: {
+        priority?: number;
+    }): void;
 }
 /** Minimal Commander.js program interface for CLI registration. */
 interface CLIProgram {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACxG,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAChG,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoB9D,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIxE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,uCAQpB,CAAC;AAIF;;;;;;GAMG;AACH,UAAU,SAAS;IACjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,0GAA0G;IAC1G,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,oDAAoD;IACpD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACpC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;KACrC,CAAC;IACF,+EAA+E;IAC/E,YAAY,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;YAChE,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAChD,CAAC,CAAC;KACJ,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3C,uDAAuD;IACvD,eAAe,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,4DAA4D;IAC5D,WAAW,CACT,SAAS,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,EACjD,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7B,IAAI,CAAC;IACR,+DAA+D;IAC/D,eAAe,CAAC,GAAG,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,IAAI,CAAC;QAClB,IAAI,EAAE,MAAM,IAAI,CAAC;KAClB,GAAG,IAAI,CAAC;IACT,wCAAwC;IACxC,EAAE,CACA,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACxC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,IAAI,CAAC;CACT;AAED,mEAAmE;AACnE,UAAU,UAAU;IAClB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC;AAED,8CAA8C;AAC9C,UAAU,UAAU;IAClB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAClC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAClD,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;CACtE;AAmCD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA+I3D"}

package/dist/index.js

@@ -8,6 +8,7 @@
  * @module index
  */
 export { RaviClient, RaviApiError } from "./client.js";
+export { setRaviRuntime, getRaviRuntime } from "./runtime.js";
 // ─── Value Imports ───────────────────────────────────────────────────────────
 import { RAVI_API_URL } from "./config.js";
 import { RaviClient } from "./client.js";
@@ -24,6 +25,7 @@ import { passwordTools } from "./tools/passwords.js";
 import { vaultTools } from "./tools/vault.js";
 import { feedbackTools } from "./tools/feedback.js";
 import { cliCommands } from "./cli.js";
+import { setRaviRuntime } from "./runtime.js";
 // ─── Combined Tools ──────────────────────────────────────────────────────────
 /**
  * All agent tools combined into a single flat array.
@@ -41,6 +43,35 @@ export const allTools = [
     ...vaultTools,
     ...feedbackTools,
 ];
+// ─── Agent Context ───────────────────────────────────────────────────────────
+/**
+ * Concise tool reference and email writing guide injected into every agent
+ * session via the `before_prompt_build` hook. Avoids duplicating guidance
+ * across individual tool descriptions.
+ */
+const RAVI_AGENT_CONTEXT = `## Ravi Identity Provider — Quick Reference
+
+### Tool Index
+**Identity:** ravi_identity_list, ravi_identity_create, ravi_get_info
+**Email Inbox:** ravi_inbox_email, ravi_read_email
+**Email Send:** ravi_email_compose, ravi_email_reply, ravi_email_forward
+**SMS:** ravi_inbox_sms, ravi_read_sms, ravi_sms_send
+**Passwords:** ravi_passwords_list, ravi_passwords_get, ravi_passwords_create, ravi_passwords_update, ravi_generate_password, ravi_passwords_delete
+**Vault:** ravi_vault_list, ravi_vault_get, ravi_vault_set, ravi_vault_delete
+**Feedback:** ravi_feedback
+
+### Email Writing Best Practices
+When composing, replying, or forwarding emails:
+- Wrap body text in <p> tags for professional formatting — no plain text or <br> chains
+- Subjects: 40-60 chars, specific, no ALL CAPS, no spam trigger words (free, urgent, act now)
+- Max 2-3 links per email — use descriptive anchor text, never "Click here"
+- End with a clear action item
+- Sign with the identity name (from ravi_get_info), not the account owner's name
+
+### Key Distinctions
+- **Passwords** (ravi_passwords_*) = website credentials (domain + username + password)
+- **Vault** (ravi_vault_*) = API keys, tokens, env vars (key-value secrets)
+- **Feedback** (ravi_feedback) — use after any Ravi workflow, successful or not. The team reads every message.`;
 // ─── Plugin Registration ─────────────────────────────────────────────────────
 /**
  * The OpenClaw plugin registration function.
@@ -56,6 +87,11 @@ export default function registerPlugin(api) {
     const config = (api.pluginConfig ?? {});
     // Load auth from ~/.ravi/auth.json (written by `openclaw ravi login`)
     const auth = loadAuth();
+    // Store the PluginRuntime so channel gateway adapters can access it later.
+    // Available on the gateway but not in test environments.
+    if (api.runtime) {
+        setRaviRuntime(api.runtime);
+    }
     // ── Always register CLI commands (login works even without auth) ───────
     api.registerCli(({ program }) => {
         const ravi = program
@@ -122,6 +158,10 @@ export default function registerPlugin(api) {
             },
         });
     }
+    // ── Inject Ravi tool guide into every agent session ─────────────────────
+    api.on("before_prompt_build", () => ({
+        prependContext: RAVI_AGENT_CONTEXT,
+    }));
     // ── Register channels ───────────────────────────────────────────────────
     api.registerChannel({ plugin: raviEmailChannel });
     api.registerChannel({ plugin: raviSmsChannel });
@@ -145,7 +185,7 @@ export default function registerPlugin(api) {
                     emailAccount: {
                         identityUuid,
                         identityName: name,
-                        email: identity?.email ?? "",
+                        email: identity?.inbox ?? "",
                     },
                     // Only register SMS handler if the identity has a phone number
                     ...(identity?.phone ? {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AASvD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,8BAA8B,EAAsB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAA2B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAyB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,cAAc;IACjB,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,aAAa;CACjB,CAAC;AAoEF,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;+GAsBoF,CAAC;AAEhH,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,GAAc;IACnD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAqB,CAAC;IAE5D,sEAAsE;IACtE,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IAExB,2EAA2E;IAC3E,yDAAyD;IACzD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAE1E,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,OAAO;aACjB,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,yDAAyD,CAAC,CAAC;QAC1E,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI;iBACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;iBACjB,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC;iBAC5B,MAAM,CAAC,KAAK,IAAI,EAAE;gBACjB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE3B,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;QACxB,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,0GAA0G,CAC3G,CAAC;QACF,OAAO;IACT,CAAC;IAED,+EAA+E;IAC/E,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,CAAC,OAAO,EAAE,EAAE;QAClD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;QAC5B,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,IAAI,CAAC,YAAY;QACxB,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC3B,UAAU,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;KACF,CAAC,CAAC;IAEH,oEAAoE;IACpE,uEAAuE;IACvE,IAAI,MAAiC,CAAC;IACtC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,8BAA8B,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,wCAAwC,MAAM,IAAI;gBAClD,wEAAwE,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,uFAAuF;YACvF,qDAAqD,CACtD,CAAC;IACJ,CAAC;IAED,2EAA2E;IAE3E,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,GAAG,CAAC,YAAY,CAAC;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,KAAK,EAAE,GAAW,EAAE,MAA+B,EAAE,EAAE;gBAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9D,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ;oBACrC,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACpC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/C,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;QACnC,cAAc,EAAE,kBAAkB;KACnC,CAAC,CAAC,CAAC;IAEJ,2EAA2E;IAE3E,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAClD,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhD,2EAA2E;IAE3E,GAAG,CAAC,eAAe,CAAC;QAClB,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YACzC,IAAI,CAAC,YAAY;gBAAE,OAAO;YAE1B,mEAAmE;YACnE,+CAA+C;YAC/C,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;gBACjE,MAAM,IAAI,GAAG,QAAQ,EAAE,YAAY,IAAI,QAAQ,EAAE,IAAI,IAAI,YAAY,CAAC;gBAEtE,OAAO,CAAC,WAAW,CAAC;oBAClB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,IAAI,CAAC,YAAY;oBACxB,YAAY;oBACZ,OAAO,EAAE,SAAS;oBAClB,YAAY,EAAE;wBACZ,YAAY;wBACZ,YAAY,EAAE,IAAI;wBAClB,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE;qBAC7B;oBACD,+DAA+D;oBAC/D,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;wBACpB,UAAU,EAAE;4BACV,YAAY;4BACZ,YAAY,EAAE,IAAI;4BAClB,KAAK,EAAE,QAAQ,CAAC,KAAK;yBACtB;qBACF,CAAC,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;YACL,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACf,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,34 @@
+/**
+ * PluginRuntime singleton for the Ravi OpenClaw plugin.
+ *
+ * The OpenClaw gateway injects a `PluginRuntime` object during
+ * `registerPlugin()`. Channel gateway adapters need access to this
+ * runtime later (in `startAccount()`) to dispatch inbound messages
+ * and resolve agent routes. This module bridges that gap with a
+ * simple module-level store.
+ *
+ * Reading the runtime before it is set throws — this surfaces
+ * misconfiguration early rather than allowing undefined-property
+ * errors downstream in the dispatch pipeline.
+ *
+ * @module runtime
+ */
+import type { PluginRuntimeSubset } from "./types.js";
+/**
+ * Store the PluginRuntime reference.
+ *
+ * Called once during `registerPlugin()` when `api.runtime` is available.
+ * Must be called before any channel gateway adapter starts.
+ *
+ * @param next - The PluginRuntime object from the OpenClaw gateway.
+ */
+export declare function setRaviRuntime(next: PluginRuntimeSubset): void;
+/**
+ * Retrieve the stored PluginRuntime reference.
+ *
+ * @throws If called before `setRaviRuntime()` — indicates the plugin
+ *         was not properly initialized via `registerPlugin()`.
+ * @returns The PluginRuntime object.
+ */
+export declare function getRaviRuntime(): PluginRuntimeSubset;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,mBAAmB,CAKpD"}

package/dist/runtime.js

@@ -0,0 +1,41 @@
+/**
+ * PluginRuntime singleton for the Ravi OpenClaw plugin.
+ *
+ * The OpenClaw gateway injects a `PluginRuntime` object during
+ * `registerPlugin()`. Channel gateway adapters need access to this
+ * runtime later (in `startAccount()`) to dispatch inbound messages
+ * and resolve agent routes. This module bridges that gap with a
+ * simple module-level store.
+ *
+ * Reading the runtime before it is set throws — this surfaces
+ * misconfiguration early rather than allowing undefined-property
+ * errors downstream in the dispatch pipeline.
+ *
+ * @module runtime
+ */
+let runtime = null;
+/**
+ * Store the PluginRuntime reference.
+ *
+ * Called once during `registerPlugin()` when `api.runtime` is available.
+ * Must be called before any channel gateway adapter starts.
+ *
+ * @param next - The PluginRuntime object from the OpenClaw gateway.
+ */
+export function setRaviRuntime(next) {
+    runtime = next;
+}
+/**
+ * Retrieve the stored PluginRuntime reference.
+ *
+ * @throws If called before `setRaviRuntime()` — indicates the plugin
+ *         was not properly initialized via `registerPlugin()`.
+ * @returns The PluginRuntime object.
+ */
+export function getRaviRuntime() {
+    if (!runtime) {
+        throw new Error("Ravi runtime not initialized — was registerPlugin() called?");
+    }
+    return runtime;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,IAAI,OAAO,GAA+B,IAAI,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAyB;IACtD,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/email-send.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-send.d.ts","sourceRoot":"","sources":["../../src/tools/email-send.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAwCjE,oDAAoD;AACpD,eAAO,MAAM,cAAc,EAAE,cAAc,EA+M1C,CAAC"}
+{"version":3,"file":"email-send.d.ts","sourceRoot":"","sources":["../../src/tools/email-send.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAwCjE,oDAAoD;AACpD,eAAO,MAAM,cAAc,EAAE,cAAc,EAqM1C,CAAC"}

package/dist/tools/email-send.js

@@ -41,15 +41,10 @@ function buildSendOpts(params, attachmentUuids) {
 export const emailSendTools = [
     {
         name: "ravi_email_compose",
-        description: "Compose and send a new email from the identity's Ravi email address. " +
-            "The body is plain text — newlines become <br> tags and special characters are escaped. " +
-            "If you need HTML formatting, you can include tags like <p>, <h2>, <ul>, <a href=\"...\"> " +
-            "and they will be sent as-is (no wrapper needed). " +
-            "Rate limits: 60 emails/hour, 500/day. " +
-            "Supports CC and BCC recipients — pass arrays of email addresses. " +
-            "Supports file attachments — provide an array of absolute file paths and they will be " +
-            "uploaded and attached to the email (max 10 MB each, dangerous extensions like .exe blocked). " +
-            "The sent email will appear in the inbox as an outbound message.",
+        description: "Compose and send a new email. Body is plain text (auto-converted to HTML) — or include your own " +
+            "HTML tags (<p>, <h2>, <a href>). See Email Writing Best Practices in the Ravi Quick Reference for formatting tips. " +
+            "Use ravi_get_info to get your identity name for signatures. " +
+            "Rate limits: 60/hour, 500/day. Supports CC, BCC, and file attachments (max 10 MB each).",
         parameters: {
             type: "object",
             properties: {
@@ -93,15 +88,10 @@ export const emailSendTools = [
     },
     {
         name: "ravi_email_reply",
-        description: "Reply to an existing email message. The reply is threaded in the original conversation " +
-            "(correct In-Reply-To and References headers are set automatically). " +
-            "The subject MUST be provided because the original email's subject is E2E encrypted on the server " +
-            "and cannot be read by the backend — copy it from the message you're replying to (via ravi_read_email). " +
-            "Body is plain text, automatically wrapped in HTML. " +
-            "Supports file attachments — provide an array of absolute file paths. " +
-            "Set reply_all to true to reply to all recipients (To + CC). " +
-            "Supports CC and BCC — pass arrays of email addresses. Use ravi_read_email to check existing CC " +
-            "recipients before replying, so you can include them appropriately.",
+        description: "Reply to an existing email message (threaded with correct headers). " +
+            "Read the thread with ravi_read_email first to understand context and see CC recipients. " +
+            "Subject is required — copy it from the thread (it's E2E encrypted on the server). " +
+            "Body is plain text, auto-wrapped in HTML. Supports reply_all, CC, BCC, and file attachments.",
         parameters: {
             type: "object",
             properties: {
@@ -155,9 +145,9 @@ export const emailSendTools = [
     },
     {
         name: "ravi_email_forward",
-        description: "Forward an email message to a new recipient. Preserves the original message content " +
-            "(the backend includes the full original email in the forwarded message). " +
-            "The subject and an optional forwarding note are required. " +
+        description: "Forward an email to a new recipient. The original message content is included automatically. " +
+            "Read the thread with ravi_read_email first to review content. " +
+            "Subject is required — copy it from the thread (it's E2E encrypted on the server). " +
             "Supports CC, BCC, and file attachments.",
         parameters: {
             type: "object",