@openclaw/whatsapp 2026.5.2-beta.2 → 2026.5.3-beta.1

package/src/status-issues.ts

@@ -1,185 +0,0 @@
-import type {
-  ChannelAccountSnapshot,
-  ChannelStatusIssue,
-} from "openclaw/plugin-sdk/channel-contract";
-import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
-import {
-  asString,
-  collectIssuesForEnabledAccounts,
-  isRecord,
-} from "openclaw/plugin-sdk/status-helpers";
-
-type WhatsAppAccountStatus = {
-  accountId?: unknown;
-  statusState?: unknown;
-  enabled?: unknown;
-  linked?: unknown;
-  connected?: unknown;
-  running?: unknown;
-  reconnectAttempts?: unknown;
-  lastDisconnect?: unknown;
-  lastInboundAt?: unknown;
-  lastError?: unknown;
-  healthState?: unknown;
-};
-
-const RECENT_DISCONNECT_WARNING_WINDOW_MS = 15 * 60 * 1000;
-
-function readWhatsAppAccountStatus(value: ChannelAccountSnapshot): WhatsAppAccountStatus | null {
-  if (!isRecord(value)) {
-    return null;
-  }
-  return {
-    accountId: value.accountId,
-    statusState: value.statusState,
-    enabled: value.enabled,
-    linked: value.linked,
-    connected: value.connected,
-    running: value.running,
-    reconnectAttempts: value.reconnectAttempts,
-    lastDisconnect: value.lastDisconnect,
-    lastInboundAt: value.lastInboundAt,
-    lastError: value.lastError,
-    healthState: value.healthState,
-  };
-}
-
-function readLastDisconnect(value: unknown): { at: number | null; error?: string } | null {
-  if (typeof value === "string") {
-    const error = asString(value);
-    return error ? { at: null, error } : null;
-  }
-  if (!isRecord(value)) {
-    return null;
-  }
-  return {
-    at: typeof value.at === "number" ? value.at : null,
-    error: asString(value.error),
-  };
-}
-
-function isRecentDisconnect(disconnect: { at: number | null } | null, now = Date.now()): boolean {
-  if (disconnect?.at == null) {
-    return false;
-  }
-  return now - disconnect.at <= RECENT_DISCONNECT_WARNING_WINDOW_MS;
-}
-
-export function collectWhatsAppStatusIssues(
-  accounts: ChannelAccountSnapshot[],
-): ChannelStatusIssue[] {
-  return collectIssuesForEnabledAccounts({
-    accounts,
-    readAccount: readWhatsAppAccountStatus,
-    collectIssues: ({ account, accountId, issues }) => {
-      const linked = account.linked === true;
-      const statusState = asString(account.statusState);
-      const running = account.running === true;
-      const connected = account.connected === true;
-      const reconnectAttempts =
-        typeof account.reconnectAttempts === "number" ? account.reconnectAttempts : null;
-      const lastInboundAt =
-        typeof account.lastInboundAt === "number" ? account.lastInboundAt : null;
-      const lastDisconnect = readLastDisconnect(account.lastDisconnect);
-      const lastError = asString(account.lastError) ?? lastDisconnect?.error;
-      const healthState = asString(account.healthState);
-
-      if (statusState === "unstable") {
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "auth",
-          message: "Auth state is still stabilizing.",
-          fix: "Wait a moment for queued credential writes to finish, then retry the command or rerun health.",
-        });
-        return;
-      }
-
-      if (!linked) {
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "auth",
-          message: "Not linked (no WhatsApp Web session).",
-          fix: `Run: ${formatCliCommand("openclaw channels login")} (scan QR on the gateway host).`,
-        });
-        return;
-      }
-
-      if (healthState === "stale") {
-        const staleSuffix =
-          lastInboundAt != null
-            ? ` (last inbound ${Math.max(0, Math.floor((Date.now() - lastInboundAt) / 60000))}m ago)`
-            : "";
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "runtime",
-          message: `Linked but stale${staleSuffix}${lastError ? `: ${lastError}` : "."}`,
-          fix: `Run: ${formatCliCommand("openclaw doctor")} (or restart the gateway). If it persists, relink via channels login and check logs.`,
-        });
-        return;
-      }
-
-      if (
-        healthState === "reconnecting" ||
-        healthState === "conflict" ||
-        healthState === "stopped"
-      ) {
-        const stateLabel =
-          healthState === "conflict"
-            ? "session conflict"
-            : healthState === "reconnecting"
-              ? "reconnecting"
-              : "stopped";
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "runtime",
-          message: `Linked but ${stateLabel}${reconnectAttempts != null ? ` (reconnectAttempts=${reconnectAttempts})` : ""}${lastError ? `: ${lastError}` : "."}`,
-          fix: `Run: ${formatCliCommand("openclaw doctor")} (or restart the gateway). If it persists, relink via channels login and check logs.`,
-        });
-        return;
-      }
-
-      if (healthState === "logged-out") {
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "auth",
-          message: `Linked session logged out${lastError ? `: ${lastError}` : "."}`,
-          fix: `Run: ${formatCliCommand("openclaw channels login")} (scan QR on the gateway host).`,
-        });
-        return;
-      }
-
-      if (
-        linked &&
-        running &&
-        connected &&
-        reconnectAttempts != null &&
-        reconnectAttempts > 0 &&
-        isRecentDisconnect(lastDisconnect)
-      ) {
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "runtime",
-          message: `Linked but recently reconnected (reconnectAttempts=${reconnectAttempts})${lastError ? `: ${lastError}` : "."}`,
-          fix: `Watch: ${formatCliCommand("openclaw logs --follow")} and run ${formatCliCommand("openclaw channels status --probe")} if disconnects continue. If it keeps flapping, restart the gateway or relink via channels login.`,
-        });
-        return;
-      }
-
-      if (running && !connected) {
-        issues.push({
-          channel: "whatsapp",
-          accountId,
-          kind: "runtime",
-          message: `Linked but disconnected${reconnectAttempts != null ? ` (reconnectAttempts=${reconnectAttempts})` : ""}${lastError ? `: ${lastError}` : "."}`,
-          fix: `Run: ${formatCliCommand("openclaw doctor")} (or restart the gateway). If it persists, relink via channels login and check logs.`,
-        });
-      }
-    },
-  });
-}

package/src/system-prompt.test.ts

@@ -1,199 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  resolveWhatsAppDirectSystemPrompt,
-  resolveWhatsAppGroupSystemPrompt,
-} from "./system-prompt.js";
-
-describe("resolveWhatsAppGroupSystemPrompt", () => {
-  it("returns undefined when groupId is absent", () => {
-    expect(resolveWhatsAppGroupSystemPrompt({ groupId: null })).toBeUndefined();
-    expect(resolveWhatsAppGroupSystemPrompt({ groupId: undefined })).toBeUndefined();
-    expect(resolveWhatsAppGroupSystemPrompt({})).toBeUndefined();
-  });
-
-  it("returns undefined when accountConfig is absent", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({ groupId: "g1", accountConfig: null }),
-    ).toBeUndefined();
-    expect(
-      resolveWhatsAppGroupSystemPrompt({ groupId: "g1", accountConfig: undefined }),
-    ).toBeUndefined();
-  });
-
-  it("returns the group-specific systemPrompt when defined", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: { groups: { g1: { systemPrompt: "group prompt" } } },
-      }),
-    ).toBe("group prompt");
-  });
-
-  it("falls back to wildcard when specific group entry is absent", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: {
-          groups: { "*": { systemPrompt: "wildcard prompt" } },
-        },
-      }),
-    ).toBe("wildcard prompt");
-  });
-
-  it("suppresses wildcard when specific group entry sets systemPrompt to empty string", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: {
-          groups: {
-            g1: { systemPrompt: "" },
-            "*": { systemPrompt: "wildcard prompt" },
-          },
-        },
-      }),
-    ).toBeUndefined();
-  });
-
-  it("suppresses wildcard when specific group entry sets systemPrompt to whitespace-only string", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: {
-          groups: {
-            g1: { systemPrompt: "   " },
-            "*": { systemPrompt: "wildcard prompt" },
-          },
-        },
-      }),
-    ).toBeUndefined();
-  });
-
-  it("trims whitespace from specific group systemPrompt", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: { groups: { g1: { systemPrompt: "  trimmed  " } } },
-      }),
-    ).toBe("trimmed");
-  });
-
-  it("returns undefined when specific group entry has no systemPrompt key and no wildcard", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: { groups: { g1: {} } },
-      }),
-    ).toBeUndefined();
-  });
-
-  it("falls back to wildcard when specific group entry has no systemPrompt key", () => {
-    expect(
-      resolveWhatsAppGroupSystemPrompt({
-        groupId: "g1",
-        accountConfig: {
-          groups: {
-            g1: {},
-            "*": { systemPrompt: "wildcard prompt" },
-          },
-        },
-      }),
-    ).toBe("wildcard prompt");
-  });
-});
-
-describe("resolveWhatsAppDirectSystemPrompt", () => {
-  it("returns undefined when peerId is absent", () => {
-    expect(resolveWhatsAppDirectSystemPrompt({ peerId: null })).toBeUndefined();
-    expect(resolveWhatsAppDirectSystemPrompt({ peerId: undefined })).toBeUndefined();
-    expect(resolveWhatsAppDirectSystemPrompt({})).toBeUndefined();
-  });
-
-  it("returns undefined when accountConfig is absent", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({ peerId: "p1", accountConfig: null }),
-    ).toBeUndefined();
-    expect(
-      resolveWhatsAppDirectSystemPrompt({ peerId: "p1", accountConfig: undefined }),
-    ).toBeUndefined();
-  });
-
-  it("returns the peer-specific systemPrompt when defined", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: { direct: { p1: { systemPrompt: "direct prompt" } } },
-      }),
-    ).toBe("direct prompt");
-  });
-
-  it("falls back to wildcard when specific peer entry is absent", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: {
-          direct: { "*": { systemPrompt: "wildcard prompt" } },
-        },
-      }),
-    ).toBe("wildcard prompt");
-  });
-
-  it("suppresses wildcard when specific peer entry sets systemPrompt to empty string", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: {
-          direct: {
-            p1: { systemPrompt: "" },
-            "*": { systemPrompt: "wildcard prompt" },
-          },
-        },
-      }),
-    ).toBeUndefined();
-  });
-
-  it("suppresses wildcard when specific peer entry sets systemPrompt to whitespace-only string", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: {
-          direct: {
-            p1: { systemPrompt: "   " },
-            "*": { systemPrompt: "wildcard prompt" },
-          },
-        },
-      }),
-    ).toBeUndefined();
-  });
-
-  it("trims whitespace from specific peer systemPrompt", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: { direct: { p1: { systemPrompt: "  trimmed  " } } },
-      }),
-    ).toBe("trimmed");
-  });
-
-  it("returns undefined when specific peer entry has no systemPrompt key and no wildcard", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: { direct: { p1: {} } },
-      }),
-    ).toBeUndefined();
-  });
-
-  it("falls back to wildcard when specific peer entry has no systemPrompt key", () => {
-    expect(
-      resolveWhatsAppDirectSystemPrompt({
-        peerId: "p1",
-        accountConfig: {
-          direct: {
-            p1: {},
-            "*": { systemPrompt: "wildcard prompt" },
-          },
-        },
-      }),
-    ).toBe("wildcard prompt");
-  });
-});

package/src/system-prompt.ts

@@ -1,31 +0,0 @@
-export function resolveWhatsAppGroupSystemPrompt(params: {
-  accountConfig?: { groups?: Record<string, { systemPrompt?: string | null }> } | null;
-  groupId?: string | null;
-}): string | undefined {
-  if (!params.groupId) {
-    return undefined;
-  }
-  const groups = params.accountConfig?.groups;
-  const specific = groups?.[params.groupId];
-  if (specific != null && specific.systemPrompt != null) {
-    return specific.systemPrompt.trim() || undefined;
-  }
-  const wildcard = groups?.["*"]?.systemPrompt;
-  return wildcard != null ? wildcard.trim() || undefined : undefined;
-}
-
-export function resolveWhatsAppDirectSystemPrompt(params: {
-  accountConfig?: { direct?: Record<string, { systemPrompt?: string | null }> } | null;
-  peerId?: string | null;
-}): string | undefined {
-  if (!params.peerId) {
-    return undefined;
-  }
-  const direct = params.accountConfig?.direct;
-  const specific = direct?.[params.peerId];
-  if (specific != null && specific.systemPrompt != null) {
-    return specific.systemPrompt.trim() || undefined;
-  }
-  const wildcard = direct?.["*"]?.systemPrompt;
-  return wildcard != null ? wildcard.trim() || undefined : undefined;
-}

package/src/targets-runtime.ts

@@ -1,180 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
-import { logVerbose, shouldLogVerbose } from "openclaw/plugin-sdk/runtime-env";
-import { escapeRegExp } from "openclaw/plugin-sdk/text-runtime";
-import { CONFIG_DIR, resolveUserPath } from "openclaw/plugin-sdk/text-runtime";
-
-const WHATSAPP_FENCE_PLACEHOLDER = "\x00FENCE";
-const WHATSAPP_INLINE_CODE_PLACEHOLDER = "\x00CODE";
-
-export type WebChannel = "web";
-
-export function assertWebChannel(input: string): asserts input is WebChannel {
-  if (input !== "web") {
-    throw new Error("Web channel must be 'web'");
-  }
-}
-
-export function isSelfChatMode(
-  selfE164: string | null | undefined,
-  allowFrom?: Array<string | number> | null,
-): boolean {
-  if (!selfE164) {
-    return false;
-  }
-  if (!Array.isArray(allowFrom) || allowFrom.length === 0) {
-    return false;
-  }
-  const normalizedSelf = normalizeE164(selfE164);
-  return allowFrom.some((n) => {
-    if (n === "*") {
-      return false;
-    }
-    try {
-      return normalizeE164(String(n)) === normalizedSelf;
-    } catch {
-      return false;
-    }
-  });
-}
-
-export function toWhatsappJid(number: string): string {
-  const withoutPrefix = number.replace(/^whatsapp:/i, "").trim();
-  if (withoutPrefix.includes("@")) {
-    return withoutPrefix;
-  }
-  const e164 = normalizeE164(withoutPrefix);
-  const digits = e164.replace(/\D/g, "");
-  return `${digits}@s.whatsapp.net`;
-}
-
-export type JidToE164Options = {
-  authDir?: string;
-  lidMappingDirs?: string[];
-  logMissing?: boolean;
-};
-
-type LidLookup = {
-  getPNForLID?: (jid: string) => Promise<string | null>;
-};
-
-function resolveLidMappingDirs(params: { opts?: JidToE164Options }): string[] {
-  const dirs = new Set<string>();
-  const addDir = (dir?: string | null) => {
-    if (!dir) {
-      return;
-    }
-    dirs.add(resolveUserPath(dir));
-  };
-  addDir(params.opts?.authDir);
-  for (const dir of params.opts?.lidMappingDirs ?? []) {
-    addDir(dir);
-  }
-  addDir(CONFIG_DIR);
-  addDir(path.join(CONFIG_DIR, "credentials"));
-  return [...dirs];
-}
-
-function readLidReverseMapping(params: { lid: string; opts?: JidToE164Options }): string | null {
-  const mappingFilename = `lid-mapping-${params.lid}_reverse.json`;
-  const mappingDirs = resolveLidMappingDirs({ opts: params.opts });
-  for (const dir of mappingDirs) {
-    const mappingPath = path.join(dir, mappingFilename);
-    try {
-      const data = fs.readFileSync(mappingPath, "utf8");
-      const phone = JSON.parse(data) as string | number | null;
-      if (phone === null || phone === undefined) {
-        continue;
-      }
-      return normalizeE164(String(phone));
-    } catch {
-      // next location
-    }
-  }
-  return null;
-}
-
-export function jidToE164(jid: string, opts?: JidToE164Options): string | null {
-  const match = jid.match(/^(\d+)(?::\d+)?@(s\.whatsapp\.net|hosted)$/);
-  if (match) {
-    return `+${match[1]}`;
-  }
-
-  const lidMatch = jid.match(/^(\d+)(?::\d+)?@(lid|hosted\.lid)$/);
-  if (!lidMatch) {
-    return null;
-  }
-  const phone = readLidReverseMapping({
-    lid: lidMatch[1],
-    opts,
-  });
-  if (phone) {
-    return phone;
-  }
-  const shouldLog = opts?.logMissing ?? shouldLogVerbose();
-  if (shouldLog) {
-    logVerbose(`LID mapping not found for ${lidMatch[1]}; skipping inbound message`);
-  }
-  return null;
-}
-
-export async function resolveJidToE164(
-  jid: string | null | undefined,
-  opts?: JidToE164Options & { lidLookup?: LidLookup },
-): Promise<string | null> {
-  if (!jid) {
-    return null;
-  }
-  const direct = jidToE164(jid, opts);
-  if (direct) {
-    return direct;
-  }
-  if (!/(@lid|@hosted\.lid)$/.test(jid) || !opts?.lidLookup?.getPNForLID) {
-    return null;
-  }
-  try {
-    const pnJid = await opts.lidLookup.getPNForLID(jid);
-    if (!pnJid) {
-      return null;
-    }
-    return jidToE164(pnJid, opts);
-  } catch (err) {
-    if (shouldLogVerbose()) {
-      logVerbose(`LID mapping lookup failed for ${jid}: ${String(err)}`);
-    }
-    return null;
-  }
-}
-
-export function markdownToWhatsApp(text: string): string {
-  if (!text) {
-    return text;
-  }
-
-  const fences: string[] = [];
-  let result = text.replace(/```[\s\S]*?```/g, (match) => {
-    fences.push(match);
-    return `${WHATSAPP_FENCE_PLACEHOLDER}${fences.length - 1}`;
-  });
-
-  const inlineCodes: string[] = [];
-  result = result.replace(/`[^`\n]+`/g, (match) => {
-    inlineCodes.push(match);
-    return `${WHATSAPP_INLINE_CODE_PLACEHOLDER}${inlineCodes.length - 1}`;
-  });
-
-  result = result.replace(/\*\*(.+?)\*\*/g, "*$1*");
-  result = result.replace(/__(.+?)__/g, "*$1*");
-  result = result.replace(/~~(.+?)~~/g, "~$1~");
-
-  result = result.replace(
-    new RegExp(`${escapeRegExp(WHATSAPP_INLINE_CODE_PLACEHOLDER)}(\\d+)`, "g"),
-    (_, idx) => inlineCodes[Number(idx)] ?? "",
-  );
-  result = result.replace(
-    new RegExp(`${escapeRegExp(WHATSAPP_FENCE_PLACEHOLDER)}(\\d+)`, "g"),
-    (_, idx) => fences[Number(idx)] ?? "",
-  );
-  return result;
-}