refactor(channels): deprecate the never-consumed group intro hint adapter (#107252)

steipete · web-flow · commit 5bcee076a5ed · 2026-07-14T01:06:13.000-07:00
* refactor(channels): deprecate the never-consumed group intro hint adapter

* chore(channels): compress the intro-hint deprecation note to satisfy the size ratchet
diff --git a/extensions/whatsapp/src/channel.setup.ts b/extensions/whatsapp/src/channel.setup.ts
@@ -1,7 +1,6 @@
 // Whatsapp plugin module implements channel.setup behavior.
 import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
 import type { ResolvedWhatsAppAccount } from "./accounts.js";
-import { resolveWhatsAppGroupIntroHint } from "./group-intro.js";
 import {
   resolveWhatsAppGroupRequireMention,
   resolveWhatsAppGroupToolPolicy,
@@ -20,7 +19,6 @@ export const whatsappSetupPlugin: ChannelPlugin<ResolvedWhatsAppAccount> = {
     groups: {
       resolveRequireMention: resolveWhatsAppGroupRequireMention,
       resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
-      resolveGroupIntroHint: resolveWhatsAppGroupIntroHint,
     },
     setupWizard: whatsappSetupWizardProxy,
     setup: whatsappSetupAdapter,
diff --git a/extensions/whatsapp/src/channel.ts b/extensions/whatsapp/src/channel.ts
@@ -18,10 +18,7 @@ import {
 import { whatsappChannelOutbound, whatsappMessageAdapter } from "./channel-outbound.js";
 import { whatsappCommandPolicy } from "./command-policy.js";
 import { formatWhatsAppConfigAllowFromEntries } from "./config-accessors.js";
-import {
-  resolveWhatsAppGroupIntroHint,
-  resolveWhatsAppMentionStripRegexes,
-} from "./group-intro.js";
+import { resolveWhatsAppMentionStripRegexes } from "./group-intro.js";
 import {
   resolveWhatsAppGroupRequireMention,
   resolveWhatsAppGroupToolPolicy,
@@ -85,7 +82,6 @@ export const whatsappPlugin: ChannelPlugin<ResolvedWhatsAppAccount> =
         groups: {
           resolveRequireMention: resolveWhatsAppGroupRequireMention,
           resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
-          resolveGroupIntroHint: resolveWhatsAppGroupIntroHint,
         },
         setupWizard: whatsappSetupWizardProxy,
         setup: whatsappSetupAdapter,
diff --git a/extensions/whatsapp/src/group-intro.ts b/extensions/whatsapp/src/group-intro.ts
@@ -2,6 +2,11 @@
 const WHATSAPP_GROUP_INTRO_HINT =
   "WhatsApp IDs: SenderId is the participant JID (group participant id).";
 
+/**
+ * @deprecated Core never consumed the group intro hint adapter; this export
+ * remains only for the plugin API surface and is removed after the next
+ * release train together with ChannelGroupAdapter.resolveGroupIntroHint.
+ */
 export function resolveWhatsAppGroupIntroHint(): string {
   return WHATSAPP_GROUP_INTRO_HINT;
 }
diff --git a/src/channels/plugins/types.adapters.ts b/src/channels/plugins/types.adapters.ts
@@ -175,10 +175,10 @@ export type ChannelSecretsAdapter = {
 
 export type ChannelGroupAdapter = {
   resolveRequireMention?: (params: ChannelGroupContext) => boolean | undefined;
+  /** @deprecated Core never consumed this; removed after the next release train. */
   resolveGroupIntroHint?: (params: ChannelGroupContext) => string | undefined;
   resolveToolPolicy?: (params: ChannelGroupContext) => GroupToolPolicyConfig | undefined;
 };
-
 export type ChannelStatusAdapter<ResolvedAccount, Probe = unknown, Audit = unknown> = {
   defaultRuntime?: ChannelAccountSnapshot;
   buildChannelSummary?: ChannelAdapterCallback<
