// Runtime web-channel plugin helpers expose web-channel tools through activated plugin runtimes.

import type { AgentToolResult } from "../../agents/runtime/index.js";

import type { ChannelAgentTool } from "../../channels/plugins/types.core.js";

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import {

getDefaultLocalRoots as getDefaultLocalRootsImpl,

loadWebMedia as loadWebMediaImpl,

loadWebMediaRaw as loadWebMediaRawImpl,

optimizeImageToJpeg as optimizeImageToJpegImpl,

} from "../../media/web-media.js";

import type { PollInput } from "../../polls.js";

import {

createPluginModuleLoaderCache,

type PluginModuleLoaderCache,

lid: string | null;

};

webAuthExists: (authDir?: string) => Promise<boolean>;

createWhatsAppLoginTool: () => ChannelAgentTool;

formatError: (error: unknown) => string;

getStatusCode: (error: unknown) => number | undefined;

pickWebChannel: (pref: string, authDir?: string) => Promise<string>;

accountId?: string;

},

) => Promise<{ messageId: string; toJid: string }>;

sendPollWhatsApp: (

to: string,

poll: PollInput,

options: { verbose: boolean; accountId?: string; cfg?: OpenClawConfig },

) => Promise<{ messageId: string; toJid: string }>;

sendReactionWhatsApp: (

chatJid: string,

messageId: string,

emoji: string,

options: {

verbose: boolean;

fromMe?: boolean;

participant?: string;

accountId?: string;

},

) => Promise<void>;

createWaSocket: (

printQr: boolean,

verbose: boolean,

opts?: { authDir?: string; onQr?: (qr: string) => void },

) => Promise<unknown>;

handleWhatsAppAction: (

params: Record<string, unknown>,

cfg: OpenClawConfig,

) => Promise<AgentToolResult<unknown>>;

monitorWebChannel: (...args: unknown[]) => Promise<unknown>;

monitorWebInbox: (...args: unknown[]) => Promise<unknown>;

startWebLoginWithQr: (...args: unknown[]) => Promise<unknown>;

return loadWebChannelHeavyModule().then((loaded) => loaded.sendMessageWhatsApp(...args));

}

/** Sends a web-channel poll through the heavy runtime API. */

export function sendWebChannelPoll(

...args: Parameters<WebChannelHeavyRuntimeModule["sendPollWhatsApp"]>

): ReturnType<WebChannelHeavyRuntimeModule["sendPollWhatsApp"]> {

return loadWebChannelHeavyModule().then((loaded) => loaded.sendPollWhatsApp(...args));

}

/** Sends a web-channel reaction through the heavy runtime API. */

export function sendWebChannelReaction(

...args: Parameters<WebChannelHeavyRuntimeModule["sendReactionWhatsApp"]>

): ReturnType<WebChannelHeavyRuntimeModule["sendReactionWhatsApp"]> {

return loadWebChannelHeavyModule().then((loaded) => loaded.sendReactionWhatsApp(...args));

}

/** Creates the web-channel login tool from the light runtime API. */

export function createRuntimeWebChannelLoginTool(

...args: Parameters<WebChannelLightRuntimeModule["createWhatsAppLoginTool"]>

): ReturnType<WebChannelLightRuntimeModule["createWhatsAppLoginTool"]> {

return getLightExport("createWhatsAppLoginTool")(...args);

}

/** Creates a web-channel socket through the heavy runtime API. */

export function createWebChannelSocket(

...args: Parameters<WebChannelHeavyRuntimeModule["createWaSocket"]>

): ReturnType<WebChannelHeavyRuntimeModule["createWaSocket"]> {

return loadWebChannelHeavyModule().then((loaded) => loaded.createWaSocket(...args));

}

/** Formats a web-channel runtime error through the light runtime API. */

export function formatError(

...args: Parameters<WebChannelLightRuntimeModule["formatError"]>

throw new Error("web channel plugin runtime is missing export 'resolveDefaultWebAuthDir'");

}

/** Handles a web-channel action through the heavy runtime API. */

export async function handleWebChannelAction(

...args: Parameters<WebChannelHeavyRuntimeModule["handleWhatsAppAction"]>

): ReturnType<WebChannelHeavyRuntimeModule["handleWhatsAppAction"]> {

return (await getHeavyExport("handleWhatsAppAction"))(...args);

}

/** Loads web media through the core media helper. */

export async function loadWebMedia(

...args: Parameters<typeof loadWebMediaImpl>