aamp-openclaw-plugin 0.1.40 → 0.1.43

package/dist/index.js

@@ -1196,6 +1196,7 @@ var JmapPushClient = class extends TinyEmitter {
 
 // ../sdk/dist/pairing.js
 import { randomBytes } from "node:crypto";
+var DEFAULT_PAIRING_WEB_URL = "https://meshmail.ai/pair";
 function normalizeMailbox(value) {
   const mailbox = value.trim().toLowerCase();
   if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(mailbox)) {
@@ -1243,6 +1244,23 @@ function buildPairingUrl(payload) {
   }
   return url.toString();
 }
+function buildPairingWebUrl(payload, baseUrl2 = DEFAULT_PAIRING_WEB_URL) {
+  const mailbox = normalizeMailbox(payload.mailbox);
+  const pairCode = payload.pairCode.trim();
+  if (!pairCode)
+    throw new Error("pairCode cannot be empty");
+  const url = new URL(baseUrl2);
+  url.searchParams.set("mailbox", mailbox);
+  url.searchParams.set("pair_code", pairCode);
+  const rules = normalizeDispatchContextRules(payload.dispatchContextRules);
+  if (rules) {
+    url.searchParams.set("dispatch_context_rules", encodeBase64UrlJson2(rules));
+  }
+  return url.toString();
+}
+function pairingUrlToWebUrl(input, baseUrl2 = DEFAULT_PAIRING_WEB_URL) {
+  return buildPairingWebUrl(parsePairingUrl(input), baseUrl2);
+}
 function createPairingCode(options) {
   const pairCode = options.pairCode?.trim() || randomBytes(6).toString("base64url");
   const dispatchContextRules = normalizeDispatchContextRules(options.dispatchContextRules);
@@ -1265,8 +1283,10 @@ function parsePairingUrl(input) {
   } catch {
     throw new Error("Invalid pairing URL");
   }
-  if (url.protocol !== "aamp:" || url.hostname !== "connect") {
-    throw new Error("Pairing URL must start with aamp://connect");
+  const isDeepLink = url.protocol === "aamp:" && url.hostname === "connect";
+  const isWebLink = (url.protocol === "https:" || url.protocol === "http:") && url.hostname === "meshmail.ai" && url.pathname === "/pair";
+  if (!isDeepLink && !isWebLink) {
+    throw new Error("Pairing URL must start with aamp://connect or https://meshmail.ai/pair");
   }
   const mailbox = url.searchParams.get("mailbox") ?? "";
   const pairCode = url.searchParams.get("pair_code") ?? "";
@@ -1499,12 +1519,34 @@ var SmtpSender = class _SmtpSender {
       return false;
     return Boolean(this.config.httpBaseUrl && this.config.authToken);
   }
+  normalizeAttachments(attachments) {
+    if (!attachments?.length)
+      return void 0;
+    return attachments.map((a) => ({
+      filename: a.filename,
+      contentType: a.contentType,
+      content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content
+    }));
+  }
   getJmapAuthHeader() {
     if (!this.config.authToken) {
       throw new Error("JMAP auth token is not configured");
     }
     return `Basic ${this.config.authToken}`;
   }
+  rewriteUrlToConfiguredOrigin(rawUrl) {
+    const base = this.config.httpBaseUrl?.replace(/\/$/, "");
+    if (!base)
+      return rawUrl;
+    const parsed = new URL(rawUrl, `${base}/`);
+    const configured = new URL(base);
+    parsed.protocol = configured.protocol;
+    parsed.username = configured.username;
+    parsed.password = configured.password;
+    parsed.hostname = configured.hostname;
+    parsed.port = configured.port;
+    return parsed.toString();
+  }
   async resolveJmapSession() {
     const base = this.config.httpBaseUrl?.replace(/\/$/, "");
     if (!base) {
@@ -1525,7 +1567,8 @@ var SmtpSender = class _SmtpSender {
         }
         return {
           accountId,
-          apiUrl: `${base}/jmap/`
+          apiUrl: `${base}/jmap/`,
+          uploadUrl: this.rewriteUrlToConfiguredOrigin(session.uploadUrl ?? `${base}/jmap/upload/{accountId}/`)
         };
       })();
     }
@@ -1562,6 +1605,38 @@ var SmtpSender = class _SmtpSender {
     const data = await res.json();
     return data.methodResponses ?? [];
   }
+  async uploadSentAttachment(attachment) {
+    const session = await this.resolveJmapSession();
+    const content = typeof attachment.content === "string" ? Buffer.from(attachment.content, "base64") : attachment.content;
+    const uploadUrl = session.uploadUrl.replace(/\{accountId\}|%7BaccountId%7D/gi, encodeURIComponent(session.accountId));
+    const res = await this.fetch(uploadUrl, {
+      method: "POST",
+      headers: {
+        Authorization: this.getJmapAuthHeader(),
+        "Content-Type": attachment.contentType
+      },
+      body: content
+    });
+    const bodyText = await res.text();
+    if (!res.ok) {
+      throw new Error(`JMAP attachment upload failed: ${res.status} ${bodyText}`);
+    }
+    let data;
+    try {
+      data = JSON.parse(bodyText);
+    } catch {
+      throw new Error("JMAP attachment upload returned invalid JSON");
+    }
+    if (!data.blobId) {
+      throw new Error("JMAP attachment upload did not return blobId");
+    }
+    return {
+      blobId: data.blobId,
+      type: data.type ?? attachment.contentType,
+      size: data.size ?? content.byteLength,
+      name: attachment.filename
+    };
+  }
   async getSentMailboxId() {
     if (!this.sentMailboxIdPromise) {
       this.sentMailboxIdPromise = (async () => {
@@ -1586,20 +1661,43 @@ var SmtpSender = class _SmtpSender {
     const sentMailboxId = await this.getSentMailboxId();
     if (!sentMailboxId)
       return;
+    const uploadedAttachments = params.attachments?.length ? await Promise.all(params.attachments.map((attachment) => this.uploadSentAttachment(attachment))) : [];
     const emailCreate = {
       mailboxIds: { [sentMailboxId]: true },
       from: [{ email: params.from }],
       to: [{ email: params.to }],
       subject: params.subject,
-      bodyValues: {
+      keywords: { "$seen": true }
+    };
+    if (uploadedAttachments.length) {
+      emailCreate.bodyStructure = {
+        type: "multipart/mixed",
+        subParts: [
+          { partId: "body", type: "text/plain" },
+          ...uploadedAttachments.map((attachment) => ({
+            blobId: attachment.blobId,
+            type: attachment.type,
+            size: attachment.size,
+            name: attachment.name,
+            disposition: "attachment"
+          }))
+        ]
+      };
+      emailCreate.bodyValues = {
+        body: {
+          value: params.text,
+          isTruncated: false
+        }
+      };
+    } else {
+      emailCreate.bodyValues = {
         body: {
           value: params.text,
           charset: "utf-8"
         }
-      },
-      textBody: [{ partId: "body", type: "text/plain" }],
-      keywords: { "$seen": true }
-    };
+      };
+      emailCreate.textBody = [{ partId: "body", type: "text/plain" }];
+    }
     if (params.inReplyTo) {
       emailCreate["header:In-Reply-To:asText"] = ` ${sanitize(params.inReplyTo)}`;
     }
@@ -1622,6 +1720,12 @@ var SmtpSender = class _SmtpSender {
     try {
       await this.saveToSent(params);
     } catch {
+      if (params.attachments?.length) {
+        try {
+          await this.saveToSent({ ...params, attachments: void 0 });
+        } catch {
+        }
+      }
     }
   }
   /**
@@ -1631,6 +1735,7 @@ var SmtpSender = class _SmtpSender {
    */
   async sendTask(opts) {
     const taskId = opts.taskId ?? randomUUID();
+    const attachments = this.normalizeAttachments(opts.attachments);
     const aampHeaders = buildDispatchHeaders({
       taskId,
       priority: opts.priority,
@@ -1653,12 +1758,8 @@ var SmtpSender = class _SmtpSender {
       ].filter(Boolean).join("\n"),
       headers: aampHeaders
     };
-    if (opts.attachments?.length) {
-      sendMailOpts.attachments = opts.attachments.map((a) => ({
-        filename: a.filename,
-        content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content,
-        contentType: a.contentType
-      }));
+    if (attachments) {
+      sendMailOpts.attachments = attachments;
     }
     if (this.shouldUseHttpFallback(opts.to)) {
       const info2 = await this.sendViaHttp({
@@ -1666,11 +1767,7 @@ var SmtpSender = class _SmtpSender {
         subject: sendMailOpts.subject,
         text: sendMailOpts.text,
         aampHeaders,
-        attachments: opts.attachments?.map((a) => ({
-          filename: a.filename,
-          contentType: a.contentType,
-          content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content
-        }))
+        attachments
       });
       await this.saveToSentBestEffort({
         from: this.config.user,
@@ -1678,7 +1775,8 @@ var SmtpSender = class _SmtpSender {
         subject: sendMailOpts.subject,
         text: sendMailOpts.text,
         aampHeaders,
-        messageId: info2.messageId
+        messageId: info2.messageId,
+        attachments
       });
       return { taskId, messageId: info2.messageId ?? "" };
     }
@@ -1689,7 +1787,8 @@ var SmtpSender = class _SmtpSender {
       subject: sendMailOpts.subject,
       text: sendMailOpts.text,
       aampHeaders,
-      messageId: info.messageId
+      messageId: info.messageId,
+      attachments
     });
     return { taskId, messageId: info.messageId ?? "" };
   }
@@ -1697,6 +1796,7 @@ var SmtpSender = class _SmtpSender {
    * Send a task.result email back to the dispatcher
    */
   async sendResult(opts) {
+    const attachments = this.normalizeAttachments(opts.attachments);
     const aampHeaders = buildResultHeaders({
       taskId: opts.taskId,
       status: opts.status,
@@ -1725,12 +1825,8 @@ Error: ${opts.errorMsg}` : ""
       mailOpts.inReplyTo = opts.inReplyTo;
       mailOpts.references = opts.inReplyTo;
     }
-    if (opts.attachments?.length) {
-      mailOpts.attachments = opts.attachments.map((a) => ({
-        filename: a.filename,
-        content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content,
-        contentType: a.contentType
-      }));
+    if (attachments) {
+      mailOpts.attachments = attachments;
     }
     if (this.shouldUseHttpFallback(opts.to)) {
       const info2 = await this.sendViaHttp({
@@ -1738,11 +1834,7 @@ Error: ${opts.errorMsg}` : ""
         subject: mailOpts.subject,
         text: mailOpts.text,
         aampHeaders,
-        attachments: opts.attachments?.map((a) => ({
-          filename: a.filename,
-          contentType: a.contentType,
-          content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content
-        }))
+        attachments
       });
       await this.saveToSentBestEffort({
         from: this.config.user,
@@ -1752,7 +1844,8 @@ Error: ${opts.errorMsg}` : ""
         aampHeaders,
         messageId: info2.messageId,
         inReplyTo: opts.inReplyTo,
-        references: opts.inReplyTo
+        references: opts.inReplyTo,
+        attachments
       });
       return;
     }
@@ -1765,13 +1858,15 @@ Error: ${opts.errorMsg}` : ""
       aampHeaders,
       messageId: info.messageId,
       inReplyTo: opts.inReplyTo,
-      references: opts.inReplyTo
+      references: opts.inReplyTo,
+      attachments
     });
   }
   /**
    * Send a task.help_needed email when the agent is blocked
    */
   async sendHelp(opts) {
+    const attachments = this.normalizeAttachments(opts.attachments);
     const aampHeaders = buildHelpHeaders({
       taskId: opts.taskId,
       question: opts.question,
@@ -1800,12 +1895,8 @@ ${opts.suggestedOptions.map((o, i) => `  ${i + 1}. ${o}`).join("\n")}` : ""
       helpMailOpts.inReplyTo = opts.inReplyTo;
       helpMailOpts.references = opts.inReplyTo;
     }
-    if (opts.attachments?.length) {
-      helpMailOpts.attachments = opts.attachments.map((a) => ({
-        filename: a.filename,
-        content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content,
-        contentType: a.contentType
-      }));
+    if (attachments) {
+      helpMailOpts.attachments = attachments;
     }
     if (this.shouldUseHttpFallback(opts.to)) {
       const info2 = await this.sendViaHttp({
@@ -1813,11 +1904,7 @@ ${opts.suggestedOptions.map((o, i) => `  ${i + 1}. ${o}`).join("\n")}` : ""
         subject: helpMailOpts.subject,
         text: helpMailOpts.text,
         aampHeaders,
-        attachments: opts.attachments?.map((a) => ({
-          filename: a.filename,
-          contentType: a.contentType,
-          content: typeof a.content === "string" ? Buffer.from(a.content, "base64") : a.content
-        }))
+        attachments
       });
       await this.saveToSentBestEffort({
         from: this.config.user,
@@ -1827,7 +1914,8 @@ ${opts.suggestedOptions.map((o, i) => `  ${i + 1}. ${o}`).join("\n")}` : ""
         aampHeaders,
         messageId: info2.messageId,
         inReplyTo: opts.inReplyTo,
-        references: opts.inReplyTo
+        references: opts.inReplyTo,
+        attachments
       });
       return;
     }
@@ -1840,7 +1928,8 @@ ${opts.suggestedOptions.map((o, i) => `  ${i + 1}. ${o}`).join("\n")}` : ""
       aampHeaders,
       messageId: info.messageId,
       inReplyTo: opts.inReplyTo,
-      references: opts.inReplyTo
+      references: opts.inReplyTo,
+      attachments
     });
   }
   /**
@@ -2296,6 +2385,7 @@ var AampClient = class _AampClient extends TinyEmitter {
   taskDispatchConcurrency;
   pendingTaskDispatches = [];
   activeTaskDispatchCount = 0;
+  discoveryPromise;
   streamAppendQueues = /* @__PURE__ */ new Map();
   constructor(config) {
     super();
@@ -2407,6 +2497,8 @@ var AampClient = class _AampClient extends TinyEmitter {
   }
   static createPairingCode = createPairingCode;
   static buildPairingUrl = buildPairingUrl;
+  static buildPairingWebUrl = buildPairingWebUrl;
+  static pairingUrlToWebUrl = pairingUrlToWebUrl;
   static parsePairingUrl = parsePairingUrl;
   static isPairingUrl = isPairingUrl;
   static consumePairingCode = consumePairingCode;
@@ -2444,6 +2536,38 @@ var AampClient = class _AampClient extends TinyEmitter {
       ...opts.body ? { body: JSON.stringify(opts.body) } : {}
     });
   }
+  discoverCachedAampService() {
+    if (!this.discoveryPromise) {
+      const discoveryPromise = _AampClient.discoverAampService(this.config.baseUrl, this.config.fetch);
+      this.discoveryPromise = discoveryPromise;
+      void discoveryPromise.catch(() => {
+        if (this.discoveryPromise === discoveryPromise) {
+          this.discoveryPromise = void 0;
+        }
+      });
+    }
+    return this.discoveryPromise;
+  }
+  async callAampApi(opts) {
+    const fetchImpl = this.config.fetch ?? fetch;
+    const discovery = await this.discoverCachedAampService();
+    const base = this.config.baseUrl.replace(/\/$/, "");
+    const apiUrl = new URL(discovery.api.url, `${base}/`);
+    apiUrl.searchParams.set("action", opts.action);
+    for (const [key, value] of Object.entries(opts.query ?? {})) {
+      if (value == null)
+        continue;
+      apiUrl.searchParams.set(key, String(value));
+    }
+    return fetchImpl(apiUrl, {
+      method: opts.method ?? "GET",
+      headers: {
+        ...opts.authToken ? { Authorization: `Basic ${opts.authToken}` } : {},
+        ...opts.body ? { "Content-Type": "application/json" } : {}
+      },
+      body: opts.body ? JSON.stringify(opts.body) : void 0
+    });
+  }
   static async registerMailbox(opts) {
     const base = opts.aampHost.replace(/\/$/, "");
     const registerRes = await _AampClient.callDiscoveredApi(base, {
@@ -2669,7 +2793,7 @@ var AampClient = class _AampClient extends TinyEmitter {
     };
   }
   async resolveStreamCapability() {
-    const discovery = await _AampClient.discoverAampService(this.config.baseUrl, this.config.fetch);
+    const discovery = await this.discoverCachedAampService();
     const stream = discovery.capabilities?.stream;
     if (!stream?.transport) {
       throw new Error("AAMP stream capability is not available on this service");
@@ -2678,11 +2802,10 @@ var AampClient = class _AampClient extends TinyEmitter {
   }
   async createStream(opts) {
     const stream = await this.resolveStreamCapability();
-    const res = await _AampClient.callDiscoveredApi(this.config.baseUrl, {
+    const res = await this.callAampApi({
       action: stream.createAction ?? "aamp.stream.create",
       method: "POST",
       authToken: this.config.mailboxToken,
-      fetch: this.config.fetch,
       body: opts
     });
     if (!res.ok) {
@@ -2725,11 +2848,10 @@ var AampClient = class _AampClient extends TinyEmitter {
   }
   async dispatchStreamAppend(opts) {
     const stream = await this.resolveStreamCapability();
-    const res = await _AampClient.callDiscoveredApi(this.config.baseUrl, {
+    const res = await this.callAampApi({
       action: stream.appendAction ?? "aamp.stream.append",
       method: "POST",
       authToken: this.config.mailboxToken,
-      fetch: this.config.fetch,
       body: opts
     });
     if (!res.ok) {
@@ -2831,11 +2953,10 @@ var AampClient = class _AampClient extends TinyEmitter {
   async closeStream(opts) {
     await this.flushStreamAppendQueue(opts.streamId);
     const stream = await this.resolveStreamCapability();
-    const res = await _AampClient.callDiscoveredApi(this.config.baseUrl, {
+    const res = await this.callAampApi({
       action: stream.closeAction ?? "aamp.stream.close",
       method: "POST",
       authToken: this.config.mailboxToken,
-      fetch: this.config.fetch,
       body: opts
     });
     if (!res.ok) {
@@ -2846,10 +2967,9 @@ var AampClient = class _AampClient extends TinyEmitter {
   }
   async getTaskStream(opts) {
     const stream = await this.resolveStreamCapability();
-    const res = await _AampClient.callDiscoveredApi(this.config.baseUrl, {
+    const res = await this.callAampApi({
       action: stream.getAction ?? "aamp.stream.get",
       authToken: this.config.mailboxToken,
-      fetch: this.config.fetch,
       query: {
         ...opts.taskId ? { taskId: opts.taskId } : {},
         ...opts.streamId ? { streamId: opts.streamId } : {}
@@ -2989,6 +3109,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
 import { randomBytes as randomBytes2 } from "node:crypto";
+var DEFAULT_PAIRING_WEB_URL2 = "https://meshmail.ai/pair";
 function defaultCredentialsPath() {
   return join(homedir(), ".openclaw", "extensions", "aamp-openclaw-plugin", ".credentials.json");
 }
@@ -3062,6 +3183,14 @@ function createPairingCode2(params) {
   writeFileSync(resolved, JSON.stringify(state, null, 2), "utf-8");
   return state;
 }
+function pairingUrlToWebUrl2(connectUrl) {
+  const parsed = new URL(connectUrl);
+  const url = new URL(DEFAULT_PAIRING_WEB_URL2);
+  for (const [key, value] of parsed.searchParams) {
+    url.searchParams.set(key, value);
+  }
+  return url.toString();
+}
 function consumePairingCode2(params) {
   const resolved = params.file ?? defaultPairingPath();
   if (!existsSync(resolved))
@@ -3652,24 +3781,24 @@ var src_default = {
         return;
       if (request.to.trim().toLowerCase() !== agentEmail.trim().toLowerCase())
         return;
+      const senderPoliciesFile = cfg.senderPoliciesFile ?? defaultSenderPoliciesPath();
       const consumed = consumePairingCode2({
         file: cfg.pairingFile ?? defaultPairingPath(),
         mailbox: agentEmail,
         pairCode: request.pairCode
       });
-      if (!consumed) {
-        const reason = "invalid or expired pair code";
-        api.logger.warn(`[AAMP] Rejected pair.request from ${request.from}: ${reason}`);
-        await sendPairResponse(request, false, reason);
-        return;
+      const pairResponse = consumed ? { success: true } : { success: false, reason: "invalid or expired pair code" };
+      if (pairResponse.success) {
+        pairedSenderPolicies = addPairedSenderPolicy(senderPoliciesFile, {
+          sender: request.from.trim().toLowerCase(),
+          dispatchContextRules: request.dispatchContextRules ?? {},
+          pairedAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        api.logger.info(`[AAMP] Paired sender ${request.from}; sender policy saved to ${senderPoliciesFile}`);
+      } else {
+        api.logger.warn(`[AAMP] Rejected pair.request from ${request.from}: ${pairResponse.reason}`);
       }
-      pairedSenderPolicies = addPairedSenderPolicy(cfg.senderPoliciesFile ?? defaultSenderPoliciesPath(), {
-        sender: request.from.trim().toLowerCase(),
-        dispatchContextRules: request.dispatchContextRules ?? {},
-        pairedAt: (/* @__PURE__ */ new Date()).toISOString()
-      });
-      api.logger.info(`[AAMP] Paired sender ${request.from}; sender policy saved to ${cfg.senderPoliciesFile ?? defaultSenderPoliciesPath()}`);
-      await sendPairResponse(request, true);
+      await sendPairResponse(request, pairResponse.success, pairResponse.reason);
     }
     async function renderPairingCodeForCurrentAgent() {
       const identity = agentEmail ? { email: agentEmail } : loadCachedIdentity(cfg.credentialsFile ?? defaultCredentialsPath());
@@ -3681,8 +3810,10 @@ var src_default = {
         mailbox: email,
         file: cfg.pairingFile ?? defaultPairingPath()
       });
-      const qr = await renderTerminalQr(pairing.connectUrl);
+      const webUrl = pairingUrlToWebUrl2(pairing.connectUrl);
+      const qr = await renderTerminalQr(webUrl);
       api.logger.info(`[AAMP] Pair with AAMP App before ${pairing.expiresAt}: ${pairing.connectUrl}`);
+      api.logger.info(`[AAMP] Web pairing link: ${webUrl}`);
       if (qr)
         api.logger.info(`
 ${qr}`);
@@ -3693,7 +3824,8 @@ ${qr}`);
 Scan this QR code:
 ${qr}` : "\nCould not render a terminal QR code.",
         `
-Pairing URL: ${pairing.connectUrl}`
+Pairing link: ${webUrl}`,
+        `Pairing URL: ${pairing.connectUrl}`
       ].join("\n");
     }
     function wakeAgentForPendingTask(task) {
@@ -3785,7 +3917,7 @@ Pairing URL: ${pairing.connectUrl}`
         file: cfg.pairingFile ?? defaultPairingPath()
       });
       api.logger.info(`[AAMP] Pair with AAMP App before ${pairing.expiresAt}: ${pairing.connectUrl}`);
-      const qr = await renderTerminalQr(pairing.connectUrl);
+      const qr = await renderTerminalQr(pairingUrlToWebUrl2(pairing.connectUrl));
       if (qr)
         api.logger.info(`
 ${qr}`);
@@ -4682,7 +4814,7 @@ ${lines.join("\n")}`
     }, { name: "aamp_pending_tasks" });
     api.registerTool({
       name: "aamp_pairing_code",
-      description: "Generate a fresh five-minute AAMP pairing code for this OpenClaw agent and show a QR code. Use this when the user asks to pair AAMP App or another AAMP runtime with this agent.",
+      description: 'Generate a fresh five-minute AAMP pairing code for this OpenClaw agent and show a QR code. Use this immediately when the user asks for a pairing code, connect code, QR code, pairing link, invite link, or Chinese requests such as "\u53D1\u5BF9\u63A5\u7801", "\u751F\u6210\u914D\u5BF9\u7801", "\u5F39\u51FA\u4E8C\u7EF4\u7801", or "\u7ED9\u6211\u8FDE\u63A5\u4E8C\u7EF4\u7801".',
       parameters: { type: "object", properties: {} },
       execute: async () => ({
         content: [{ type: "text", text: await renderPairingCodeForCurrentAgent() }]
@@ -4951,7 +5083,7 @@ Question: ${h.question}`,
     });
     api.registerCommand({
       name: "aamp-pair",
-      description: "Show a fresh AAMP pairing QR code for this OpenClaw agent",
+      description: "Show a fresh AAMP pairing QR code, web pairing link, and aamp://connect URL for this OpenClaw agent",
       acceptsArgs: false,
       requireAuth: false,
       handler: async () => ({