From 8b2ef40775c44e6898bd429d9c6a622b13124b38 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Wed, 22 Apr 2026 06:55:41 +0100
Subject: [PATCH] docs: remove bundled channel examples from core types

---
 src/agents/command/types.ts                 | 7 ++++---
 src/agents/pi-embedded-runner/run/params.ts | 2 +-
 src/agents/pi-embedded-runner/types.ts      | 4 ++--
 src/auto-reply/reply/route-reply.ts         | 2 +-
 src/auto-reply/templating.ts                | 4 ++--
 src/channels/plugins/types.adapters.ts      | 2 +-
 src/gateway/server-channels.ts              | 4 ++--
 7 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/src/agents/command/types.ts b/src/agents/command/types.ts
index b051800f807..bbe2f19c7da 100644
--- a/src/agents/command/types.ts
+++ b/src/agents/command/types.ts
@@ -56,10 +56,11 @@ export type AgentCommandOpts = {
   replyAccountId?: string;
   /** Override delivery thread/topic id (separate from session routing). */
   threadId?: string | number;
-  /** Message channel context (webchat|voicewake|whatsapp|...). */
+  /** Message channel context. */
   messageChannel?: string;
-  channel?: string; // delivery channel (whatsapp|telegram|...)
-  /** Account ID for multi-account channel routing (e.g., WhatsApp account). */
+  /** Delivery channel. */
+  channel?: string;
+  /** Account ID for multi-account channel routing. */
   accountId?: string;
   /** Context for embedded run routing (channel/account/thread). */
   runContext?: AgentRunContext;
diff --git a/src/agents/pi-embedded-runner/run/params.ts b/src/agents/pi-embedded-runner/run/params.ts
index bb2a257b201..1b0382fd4f1 100644
--- a/src/agents/pi-embedded-runner/run/params.ts
+++ b/src/agents/pi-embedded-runner/run/params.ts
@@ -30,7 +30,7 @@ export type RunEmbeddedPiAgentParams = {
   trigger?: EmbeddedRunTrigger;
   /** Relative workspace path that memory-triggered writes are allowed to append to. */
   memoryFlushWritePath?: string;
-  /** Delivery target (e.g. telegram:group:123:topic:456) for topic/thread routing. */
+  /** Delivery target for topic/thread routing. */
   messageTo?: string;
   /** Thread/topic identifier for routing replies to the originating thread. */
   messageThreadId?: string | number;
diff --git a/src/agents/pi-embedded-runner/types.ts b/src/agents/pi-embedded-runner/types.ts
index 7c1dae928f3..337214aff89 100644
--- a/src/agents/pi-embedded-runner/types.ts
+++ b/src/agents/pi-embedded-runner/types.ts
@@ -140,8 +140,8 @@ export type EmbeddedPiRunResult = {
     audioAsVoice?: boolean;
   }>;
   meta: EmbeddedPiRunMeta;
-  // True if a messaging tool (telegram, whatsapp, discord, slack, sessions_send)
-  // successfully sent a message. Used to suppress agent's confirmation text.
+  // True if a messaging tool successfully sent a message.
+  // Used to suppress agent's confirmation text.
   didSendViaMessagingTool?: boolean;
   // Texts successfully sent via messaging tools during the run.
   messagingToolSentTexts?: string[];
diff --git a/src/auto-reply/reply/route-reply.ts b/src/auto-reply/reply/route-reply.ts
index 7452fbe9a9b..0b8c67286be 100644
--- a/src/auto-reply/reply/route-reply.ts
+++ b/src/auto-reply/reply/route-reply.ts
@@ -40,7 +40,7 @@ function loadDeliverRuntime() {
 export type RouteReplyParams = {
   /** The reply payload to send. */
   payload: ReplyPayload;
-  /** The originating channel type (telegram, slack, etc). */
+  /** The originating channel type. */
   channel: OriginatingChannelType;
   /** The destination chat/channel/user ID. */
   to: string;
diff --git a/src/auto-reply/templating.ts b/src/auto-reply/templating.ts
index d8fc62273d8..4fc31eaedb8 100644
--- a/src/auto-reply/templating.ts
+++ b/src/auto-reply/templating.ts
@@ -142,9 +142,9 @@ export type MsgContext = {
   SenderTag?: string;
   SenderE164?: string;
   Timestamp?: number;
-  /** Provider label (e.g. whatsapp, telegram). */
+  /** Provider label. */
   Provider?: string;
-  /** Provider surface label (e.g. discord, slack). Prefer this over `Provider` when available. */
+  /** Provider surface label. Prefer this over `Provider` when available. */
   Surface?: string;
   /** Platform bot username when command mentions should be normalized. */
   BotUsername?: string;
diff --git a/src/channels/plugins/types.adapters.ts b/src/channels/plugins/types.adapters.ts
index e33be3cce7a..d9cf9a9e60a 100644
--- a/src/channels/plugins/types.adapters.ts
+++ b/src/channels/plugins/types.adapters.ts
@@ -298,7 +298,7 @@ export type ChannelGatewayContext<ResolvedAccount = unknown> = {
    * ## Backward Compatibility
    *
    * - This field is **optional** - channels that don't need it can ignore it
-   * - Built-in channels (slack, discord, etc.) typically don't use this field
+   * - Bundled channels typically don't use this field
    *   because they can directly import internal modules
    * - External plugins should check for undefined before using
    * - When provided, this must be a full `createPluginRuntime().channel` surface;
diff --git a/src/gateway/server-channels.ts b/src/gateway/server-channels.ts
index 620a45b1826..e4e487344c7 100644
--- a/src/gateway/server-channels.ts
+++ b/src/gateway/server-channels.ts
@@ -129,8 +129,8 @@ type ChannelManagerOptions = {
    * plugins to access advanced Plugin SDK features (AI dispatch, routing,
    * text processing, etc.).
    *
-   * Built-in channels (slack, discord, telegram) typically don't use this
-   * because they can directly import internal modules from the monorepo.
+   * Bundled channels typically don't use this because they can directly
+   * import internal modules from the monorepo.
    *
    * This field is optional - omitting it maintains backward compatibility
    * with existing channels. When provided, it must be a real