Plugin SDK: add public WhatsApp runtime subpaths

src/plugin-sdk/subpaths.test.ts

@@ -29,6 +29,8 @@ import * as telegramSdk from "openclaw/plugin-sdk/telegram";
 import * as testingSdk from "openclaw/plugin-sdk/testing";
 import * as voiceCallSdk from "openclaw/plugin-sdk/voice-call";
 import * as whatsappSdk from "openclaw/plugin-sdk/whatsapp";
+import * as whatsappActionRuntimeSdk from "openclaw/plugin-sdk/whatsapp-action-runtime";
+import * as whatsappLoginQrSdk from "openclaw/plugin-sdk/whatsapp-login-qr";
 import { describe, expect, expectTypeOf, it } from "vitest";
 import type { ChannelMessageActionContext } from "../channels/plugins/types.js";
 import type { PluginRuntime } from "../plugins/runtime/types.js";
@@ -297,6 +299,15 @@ describe("plugin-sdk subpath exports", () => {
     expect("resolveWhatsAppMentionStripPatterns" in whatsappSdk).toBe(false);
   });
 
+  it("exports WhatsApp QR login helpers from the dedicated subpath", () => {
+    expect(typeof whatsappLoginQrSdk.startWebLoginWithQr).toBe("function");
+    expect(typeof whatsappLoginQrSdk.waitForWebLogin).toBe("function");
+  });
+
+  it("exports WhatsApp action runtime helpers from the dedicated subpath", () => {
+    expect(typeof whatsappActionRuntimeSdk.handleWhatsAppAction).toBe("function");
+  });
+
   it("exports Feishu helpers", async () => {
     expect(typeof feishuSdk.feishuSetupWizard).toBe("object");
     expect(typeof feishuSdk.feishuSetupAdapter).toBe("object");

src/plugin-sdk/whatsapp-action-runtime.ts

@@ -0,0 +1 @@
+export { handleWhatsAppAction } from "../../extensions/whatsapp/action-runtime-api.js";

src/plugin-sdk/whatsapp-login-qr.ts

@@ -0,0 +1 @@
+export { startWebLoginWithQr, waitForWebLogin } from "../../extensions/whatsapp/login-qr-api.js";

src/plugin-sdk/whatsapp.ts

@@ -71,10 +71,13 @@ export {
   resolveWhatsAppAccount,
 } from "../../extensions/whatsapp/api.js";
 export {
+  getActiveWebListener,
+  getWebAuthAgeMs,
   WA_WEB_AUTH_DIR,
   logWebSelfId,
   logoutWeb,
   pickWebChannel,
+  readWebSelfId,
   webAuthExists,
 } from "../../extensions/whatsapp/runtime-api.js";
 export {

src/plugins/runtime/runtime-whatsapp-login-tool.ts

@@ -1 +1 @@
-export { createWhatsAppLoginTool as createRuntimeWhatsAppLoginTool } from "../../../extensions/whatsapp/runtime-api.js";
+export { createWhatsAppLoginTool as createRuntimeWhatsAppLoginTool } from "openclaw/plugin-sdk/whatsapp";

src/plugins/runtime/runtime-whatsapp-login.runtime.ts

@@ -1,4 +1,4 @@
-import { loginWeb as loginWebImpl } from "../../../extensions/whatsapp/runtime-api.js";
+import { loginWeb as loginWebImpl } from "openclaw/plugin-sdk/whatsapp";
 import type { PluginRuntime } from "./types.js";
 
 type RuntimeWhatsAppLogin = Pick<PluginRuntime["channel"]["whatsapp"], "loginWeb">;

src/plugins/runtime/runtime-whatsapp-outbound.runtime.ts

@@ -1,7 +1,7 @@
 import {
   sendMessageWhatsApp as sendMessageWhatsAppImpl,
   sendPollWhatsApp as sendPollWhatsAppImpl,
-} from "../../../extensions/whatsapp/runtime-api.js";
+} from "openclaw/plugin-sdk/whatsapp";
 import type { PluginRuntime } from "./types.js";
 
 type RuntimeWhatsAppOutbound = Pick<

src/plugins/runtime/runtime-whatsapp.ts

@@ -1,11 +1,11 @@
-import { getActiveWebListener } from "../../../extensions/whatsapp/runtime-api.js";
+import { getActiveWebListener } from "openclaw/plugin-sdk/whatsapp";
 import {
   getWebAuthAgeMs,
-  logoutWeb,
   logWebSelfId,
+  logoutWeb,
   readWebSelfId,
   webAuthExists,
-} from "../../../extensions/whatsapp/runtime-api.js";
+} from "openclaw/plugin-sdk/whatsapp";
 import {
   createLazyRuntimeMethodBinder,
   createLazyRuntimeSurface,
@@ -63,16 +63,15 @@ const handleWhatsAppActionLazy: PluginRuntime["channel"]["whatsapp"]["handleWhat
     return handleWhatsAppAction(...args);
   };
 
-let webLoginQrPromise: Promise<
-  typeof import("../../../extensions/whatsapp/login-qr-api.js")
-> | null = null;
+let webLoginQrPromise: Promise<typeof import("openclaw/plugin-sdk/whatsapp-login-qr")> | null =
+  null;
 let webChannelPromise: Promise<typeof import("../../channels/web/index.js")> | null = null;
 let whatsappActionsPromise: Promise<
-  typeof import("../../../extensions/whatsapp/action-runtime-api.js")
+  typeof import("openclaw/plugin-sdk/whatsapp-action-runtime")
 > | null = null;
 
 function loadWebLoginQr() {
-  webLoginQrPromise ??= import("../../../extensions/whatsapp/login-qr-api.js");
+  webLoginQrPromise ??= import("openclaw/plugin-sdk/whatsapp-login-qr");
   return webLoginQrPromise;
 }
 
@@ -82,7 +81,7 @@ function loadWebChannel() {
 }
 
 function loadWhatsAppActions() {
-  whatsappActionsPromise ??= import("../../../extensions/whatsapp/action-runtime-api.js");
+  whatsappActionsPromise ??= import("openclaw/plugin-sdk/whatsapp-action-runtime");
   return whatsappActionsPromise;
 }
 

src/plugins/runtime/types-channel.ts

@@ -205,19 +205,19 @@ export type PluginRuntimeChannel = {
     sendMessageIMessage: typeof import("../../../extensions/imessage/runtime-api.js").sendMessageIMessage;
   };
   whatsapp: {
-    getActiveWebListener: typeof import("../../../extensions/whatsapp/runtime-api.js").getActiveWebListener;
-    getWebAuthAgeMs: typeof import("../../../extensions/whatsapp/runtime-api.js").getWebAuthAgeMs;
-    logoutWeb: typeof import("../../../extensions/whatsapp/runtime-api.js").logoutWeb;
-    logWebSelfId: typeof import("../../../extensions/whatsapp/runtime-api.js").logWebSelfId;
-    readWebSelfId: typeof import("../../../extensions/whatsapp/runtime-api.js").readWebSelfId;
-    webAuthExists: typeof import("../../../extensions/whatsapp/runtime-api.js").webAuthExists;
-    sendMessageWhatsApp: typeof import("../../../extensions/whatsapp/runtime-api.js").sendMessageWhatsApp;
-    sendPollWhatsApp: typeof import("../../../extensions/whatsapp/runtime-api.js").sendPollWhatsApp;
-    loginWeb: typeof import("../../../extensions/whatsapp/runtime-api.js").loginWeb;
-    startWebLoginWithQr: typeof import("../../../extensions/whatsapp/login-qr-api.js").startWebLoginWithQr;
-    waitForWebLogin: typeof import("../../../extensions/whatsapp/login-qr-api.js").waitForWebLogin;
+    getActiveWebListener: typeof import("openclaw/plugin-sdk/whatsapp").getActiveWebListener;
+    getWebAuthAgeMs: typeof import("openclaw/plugin-sdk/whatsapp").getWebAuthAgeMs;
+    logoutWeb: typeof import("openclaw/plugin-sdk/whatsapp").logoutWeb;
+    logWebSelfId: typeof import("openclaw/plugin-sdk/whatsapp").logWebSelfId;
+    readWebSelfId: typeof import("openclaw/plugin-sdk/whatsapp").readWebSelfId;
+    webAuthExists: typeof import("openclaw/plugin-sdk/whatsapp").webAuthExists;
+    sendMessageWhatsApp: typeof import("openclaw/plugin-sdk/whatsapp").sendMessageWhatsApp;
+    sendPollWhatsApp: typeof import("openclaw/plugin-sdk/whatsapp").sendPollWhatsApp;
+    loginWeb: typeof import("openclaw/plugin-sdk/whatsapp").loginWeb;
+    startWebLoginWithQr: typeof import("openclaw/plugin-sdk/whatsapp-login-qr").startWebLoginWithQr;
+    waitForWebLogin: typeof import("openclaw/plugin-sdk/whatsapp-login-qr").waitForWebLogin;
     monitorWebChannel: typeof import("../../channels/web/index.js").monitorWebChannel;
-    handleWhatsAppAction: typeof import("../../../extensions/whatsapp/action-runtime-api.js").handleWhatsAppAction;
+    handleWhatsAppAction: typeof import("openclaw/plugin-sdk/whatsapp-action-runtime").handleWhatsAppAction;
     createLoginTool: typeof import("./runtime-whatsapp-login-tool.js").createRuntimeWhatsAppLoginTool;
   };
   line: {