@openclaw/whatsapp 2026.5.1-beta.1

package/action-runtime-api.ts

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

package/action-runtime.runtime.ts

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

package/api.ts

@@ -0,0 +1,213 @@
+export { whatsappPlugin } from "./src/channel.js";
+export { whatsappSetupPlugin } from "./src/channel.setup.js";
+export {
+  DEFAULT_WHATSAPP_MEDIA_MAX_MB,
+  hasAnyWhatsAppAuth,
+  listEnabledWhatsAppAccounts,
+  listWhatsAppAccountIds,
+  listWhatsAppAuthDirs,
+  resolveDefaultWhatsAppAccountId,
+  type ResolvedWhatsAppAccount,
+  resolveWhatsAppAccount,
+  resolveWhatsAppAuthDir,
+  resolveWhatsAppMediaMaxBytes,
+} from "./src/accounts.js";
+export { DEFAULT_WEB_MEDIA_BYTES } from "./src/auto-reply/constants.js";
+export { whatsappCommandPolicy } from "./src/command-policy.js";
+export {
+  resolveWhatsAppGroupRequireMention,
+  resolveWhatsAppGroupToolPolicy,
+} from "./src/group-policy.js";
+export { WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./src/outbound-send-deps.js";
+export {
+  __test__,
+  asNullableObjectRecord,
+  asNullableRecord,
+  asOptionalObjectRecord,
+  asOptionalRecord,
+  asRecord,
+  assertWebChannel,
+  type AssistantVisibleTextSanitizerProfile,
+  bindAbortRelay,
+  buildTimeoutAbortSignal,
+  chunkItems,
+  chunkMarkdownIR,
+  clamp,
+  clampInt,
+  clampNumber,
+  type CodeRegion,
+  CONFIG_DIR,
+  convertMarkdownTables,
+  createScopedExpiringIdCache,
+  DEFAULT_LOG_DIR,
+  DEFAULT_LOG_FILE,
+  diagnosticLogger,
+  type DisplayMessageWithContent,
+  displayPath,
+  displayString,
+  ensureDir,
+  escapeRegExp,
+  fetchWithTimeout,
+  FILE_REF_EXTENSIONS_WITH_TLD,
+  findCodeRegions,
+  getChildLogger,
+  getDefaultRedactPatterns,
+  getDiagnosticSessionStateCountForTest,
+  getLogger,
+  getResolvedLoggerSettings,
+  hasNonEmptyString,
+  hasOrphanReasoningCloseBoundary,
+  hasSystemMark,
+  type InlineDirectiveParseResult,
+  isAutoLinkedFileRef,
+  isFileLogLevelEnabled,
+  isInsideCode,
+  isRecord,
+  isSelfChatMode,
+  jidToE164,
+  type JidToE164Options,
+  localeLowercasePreservingWhitespace,
+  logActiveRuns,
+  logDebug,
+  logError,
+  type LoggerResolvedSettings,
+  type LoggerSettings,
+  logInfo,
+  logLaneDequeue,
+  logLaneEnqueue,
+  logMessageProcessed,
+  logMessageQueued,
+  logRunAttempt,
+  logSessionStateChange,
+  logSuccess,
+  logToolLoopAction,
+  logWarn,
+  logWebhookError,
+  logWebhookProcessed,
+  logWebhookReceived,
+  lowercasePreservingWhitespace,
+  type MarkdownIR,
+  type MarkdownLinkSpan,
+  type MarkdownParseOptions,
+  type MarkdownStyle,
+  type MarkdownStyleSpan,
+  type MarkdownTableData,
+  type MarkdownTableMeta,
+  markdownToIR,
+  markdownToIRWithMeta,
+  markdownToWhatsApp,
+  normalizeArrayBackedTrimmedStringList,
+  normalizeAtHashSlug,
+  normalizeCsvOrLooseStringList,
+  normalizeE164,
+  normalizeFastMode,
+  normalizeHyphenSlug,
+  normalizeLowercaseStringOrEmpty,
+  normalizeNullableString,
+  normalizeOptionalLowercaseString,
+  normalizeOptionalString,
+  normalizeOptionalStringifiedId,
+  normalizeOptionalThreadValue,
+  normalizeOptionalTrimmedStringList,
+  normalizeSingleOrTrimmedStringList,
+  normalizeStringEntries,
+  normalizeStringEntriesLower,
+  normalizeStringifiedOptionalString,
+  normalizeTrimmedStringList,
+  parseInlineDirectives,
+  pathExists,
+  type PinoLikeLogger,
+  prefixSystemMessage,
+  type ReactionLevel,
+  readStringField,
+  readStringValue,
+  type ReasoningTagMode,
+  type ReasoningTagTrim,
+  redactIdentifier,
+  redactSensitiveLines,
+  type RedactSensitiveMode,
+  redactSensitiveText,
+  redactToolDetail,
+  type RenderedMarkdownChunk,
+  type RenderLink,
+  renderMarkdownIRChunksWithinLimit,
+  type RenderMarkdownIRChunksWithinLimitOptions,
+  renderMarkdownWithMarkers,
+  type RenderOptions,
+  type RenderStyleMap,
+  type RenderStyleMarker,
+  resetDiagnosticStateForTest,
+  resetLogger,
+  resolveConfigDir,
+  type ResolvedReactionLevel,
+  type ResolvedRedactOptions,
+  resolveGlobalMap,
+  resolveGlobalSingleton,
+  resolveHomeDir,
+  resolveJidToE164,
+  resolvePrimaryStringValue,
+  resolveReactionLevel,
+  resolveRedactOptions,
+  resolveStuckSessionWarnMs,
+  resolveUserPath,
+  safeParseJson,
+  sanitizeAssistantVisibleText,
+  sanitizeAssistantVisibleTextWithOptions,
+  sanitizeAssistantVisibleTextWithProfile,
+  sanitizeReplyDirectiveId,
+  sanitizeTerminalText,
+  type ScopedExpiringIdCache,
+  setLoggerOverride,
+  sha256HexPrefix,
+  shortenHomeInString,
+  shortenHomePath,
+  sleep,
+  sliceMarkdownIR,
+  sliceUtf16Safe,
+  startDiagnosticHeartbeat,
+  stopDiagnosticHeartbeat,
+  stripAssistantInternalScaffolding,
+  stripDowngradedToolCallText,
+  stripInlineDirectiveTagsForDelivery,
+  stripInlineDirectiveTagsForDisplay,
+  stripInlineDirectiveTagsFromMessageForDisplay,
+  stripMarkdown,
+  stripMinimaxToolCallXml,
+  stripReasoningTagsFromText,
+  stripToolCallXmlTags,
+  summarizeStringEntries,
+  SYSTEM_MARK,
+  toPinoLikeLogger,
+  toWhatsappJid,
+  truncateUtf16Safe,
+  type WebChannel,
+  withTimeout,
+} from "./src/text-runtime.js";
+export {
+  type WebChannelHealthState,
+  type WebChannelStatus,
+  type WebInboundMsg,
+  type WebMonitorTuning,
+} from "./src/auto-reply/types.js";
+export {
+  type ActiveWebListener,
+  type ActiveWebSendOptions,
+  type WebInboundMessage,
+  type WebListenerCloseReason,
+  type WhatsAppStructuredContactContext,
+} from "./src/inbound/types.js";
+export {
+  listWhatsAppDirectoryGroupsFromConfig,
+  listWhatsAppDirectoryPeersFromConfig,
+} from "./src/directory-config.js";
+export { resolveWhatsAppOutboundTarget } from "./src/resolve-outbound-target.js";
+export {
+  isWhatsAppGroupJid,
+  normalizeWhatsAppAllowFromEntries,
+  isWhatsAppUserTarget,
+  looksLikeWhatsAppTargetId,
+  normalizeWhatsAppMessagingTarget,
+  normalizeWhatsAppTarget,
+} from "./src/normalize-target.js";
+export { resolveWhatsAppGroupIntroHint } from "./src/runtime-api.js";
+export { __testing as whatsappAccessControlTesting } from "./src/inbound/access-control.js";

package/auth-presence.ts

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
+import { resolveUserPath } from "openclaw/plugin-sdk/account-resolution";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
+import { resolveOAuthDir } from "openclaw/plugin-sdk/state-paths";
+import { hasWebCredsSync } from "./src/creds-files.js";
+
+type WhatsAppAuthPresenceParams =
+  | {
+      cfg: OpenClawConfig;
+      env?: NodeJS.ProcessEnv;
+    }
+  | OpenClawConfig;
+
+function addAccountAuthDirs(
+  authDirs: Set<string>,
+  accountId: string,
+  authDir: string | undefined,
+  accountsRoot: string,
+  env: NodeJS.ProcessEnv,
+): void {
+  authDirs.add(path.join(accountsRoot, normalizeAccountId(accountId)));
+  const configuredAuthDir = authDir?.trim();
+  if (configuredAuthDir) {
+    authDirs.add(resolveUserPath(configuredAuthDir, env));
+  }
+}
+
+function listWhatsAppAuthDirs(
+  cfg: OpenClawConfig,
+  env: NodeJS.ProcessEnv = process.env,
+): readonly string[] {
+  const oauthDir = resolveOAuthDir(env);
+  const accountsRoot = path.join(oauthDir, "whatsapp");
+  const channel = cfg.channels?.whatsapp;
+  const authDirs = new Set<string>([oauthDir, path.join(accountsRoot, DEFAULT_ACCOUNT_ID)]);
+
+  addAccountAuthDirs(authDirs, DEFAULT_ACCOUNT_ID, undefined, accountsRoot, env);
+
+  if (channel?.defaultAccount?.trim()) {
+    addAccountAuthDirs(
+      authDirs,
+      channel.defaultAccount,
+      channel.accounts?.[channel.defaultAccount]?.authDir,
+      accountsRoot,
+      env,
+    );
+  }
+
+  const accounts = channel?.accounts;
+  if (accounts) {
+    for (const [accountId, account] of Object.entries(accounts)) {
+      addAccountAuthDirs(authDirs, accountId, account?.authDir, accountsRoot, env);
+    }
+  }
+
+  try {
+    const entries = fs.readdirSync(accountsRoot, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        authDirs.add(path.join(accountsRoot, entry.name));
+      }
+    }
+  } catch {
+    // Missing directories mean no auth state.
+  }
+
+  return [...authDirs];
+}
+
+export function hasAnyWhatsAppAuth(
+  params: WhatsAppAuthPresenceParams,
+  env: NodeJS.ProcessEnv = process.env,
+): boolean {
+  const cfg = params && typeof params === "object" && "cfg" in params ? params.cfg : params;
+  const resolvedEnv =
+    params && typeof params === "object" && "cfg" in params ? (params.env ?? env) : env;
+  return listWhatsAppAuthDirs(cfg, resolvedEnv).some((authDir) => hasWebCredsSync(authDir));
+}

package/channel-config-api.ts

@@ -0,0 +1 @@
+export { WhatsAppChannelConfigSchema } from "./src/config-schema.js";

package/channel-plugin-api.ts

@@ -0,0 +1,3 @@
+// Keep bundled channel bootstrap loads narrow so lightweight channel entry
+// loads do not import setup-only surfaces.
+export { whatsappPlugin } from "./src/channel.js";

package/config-api.ts

@@ -0,0 +1,4 @@
+export {
+  buildChannelConfigSchema,
+  WhatsAppConfigSchema,
+} from "openclaw/plugin-sdk/bundled-channel-config-schema";

package/constants.ts

@@ -0,0 +1 @@
+export { DEFAULT_WEB_MEDIA_BYTES } from "./src/auto-reply/constants.js";

package/contract-api.ts

@@ -0,0 +1,29 @@
+import { whatsappCommandPolicy as whatsappCommandPolicyImpl } from "./src/command-policy.js";
+import { resolveLegacyGroupSessionKey as resolveLegacyGroupSessionKeyImpl } from "./src/group-session-contract.js";
+import { __testing as whatsappAccessControlTestingImpl } from "./src/inbound/access-control.js";
+import {
+  isWhatsAppGroupJid as isWhatsAppGroupJidImpl,
+  normalizeWhatsAppTarget as normalizeWhatsAppTargetImpl,
+} from "./src/normalize-target.js";
+export {
+  listWhatsAppDirectoryGroupsFromConfig,
+  listWhatsAppDirectoryPeersFromConfig,
+} from "./src/directory-config.js";
+import { resolveWhatsAppRuntimeGroupPolicy as resolveWhatsAppRuntimeGroupPolicyImpl } from "./src/runtime-group-policy.js";
+import {
+  canonicalizeLegacySessionKey as canonicalizeLegacySessionKeyImpl,
+  isLegacyGroupSessionKey as isLegacyGroupSessionKeyImpl,
+} from "./src/session-contract.js";
+export {
+  collectUnsupportedSecretRefConfigCandidates,
+  unsupportedSecretRefSurfacePatterns,
+} from "./src/security-contract.js";
+
+export const canonicalizeLegacySessionKey = canonicalizeLegacySessionKeyImpl;
+export const isLegacyGroupSessionKey = isLegacyGroupSessionKeyImpl;
+export const isWhatsAppGroupJid = isWhatsAppGroupJidImpl;
+export const normalizeWhatsAppTarget = normalizeWhatsAppTargetImpl;
+export const resolveLegacyGroupSessionKey = resolveLegacyGroupSessionKeyImpl;
+export const resolveWhatsAppRuntimeGroupPolicy = resolveWhatsAppRuntimeGroupPolicyImpl;
+export const whatsappAccessControlTesting = whatsappAccessControlTestingImpl;
+export const whatsappCommandPolicy = whatsappCommandPolicyImpl;

package/directory-contract-api.ts

@@ -0,0 +1,4 @@
+export {
+  listWhatsAppDirectoryGroupsFromConfig,
+  listWhatsAppDirectoryPeersFromConfig,
+} from "./src/directory-config.js";

package/dist/.boundary-tsc.stamp

@@ -0,0 +1 @@
+2026-04-29T11:29:30.144Z