refactor(channels): move bootstrap channel logic behind extension seams

src/plugin-sdk/bluebubbles.ts

@@ -1,3 +1,5 @@
+import type { ChannelAccountSnapshot } from "../channels/plugins/types.core.js";
+import type { ChannelStatusIssue } from "../channels/plugins/types.js";
 import type { OpenClawConfig } from "../config/config.js";
 import {
   parseChatTargetPrefixesOrThrow,
@@ -5,6 +7,7 @@ import {
   type ParsedChatTarget,
 } from "./channel-targets.js";
 import { loadBundledPluginPublicSurfaceModuleSync } from "./facade-runtime.js";
+import { asString, collectIssuesForEnabledAccounts, isRecord } from "./status-helpers.js";
 
 // Narrow plugin-sdk surface for the bundled BlueBubbles plugin.
 // Keep this list additive and scoped to the conversation-binding seam only.
@@ -263,6 +266,101 @@ export function resolveBlueBubblesConversationIdFromTarget(target: string): stri
   return normalizeBlueBubblesAcpConversationId(target)?.conversationId;
 }
 
+type BlueBubblesAccountStatus = {
+  accountId?: unknown;
+  enabled?: unknown;
+  configured?: unknown;
+  running?: unknown;
+  baseUrl?: unknown;
+  lastError?: unknown;
+  probe?: unknown;
+};
+
+type BlueBubblesProbeResult = {
+  ok?: boolean;
+  status?: number | null;
+  error?: string | null;
+};
+
+function readBlueBubblesAccountStatus(
+  value: ChannelAccountSnapshot,
+): BlueBubblesAccountStatus | null {
+  if (!isRecord(value)) {
+    return null;
+  }
+  return {
+    accountId: value.accountId,
+    enabled: value.enabled,
+    configured: value.configured,
+    running: value.running,
+    baseUrl: value.baseUrl,
+    lastError: value.lastError,
+    probe: value.probe,
+  };
+}
+
+function readBlueBubblesProbeResult(value: unknown): BlueBubblesProbeResult | null {
+  if (!isRecord(value)) {
+    return null;
+  }
+  return {
+    ok: typeof value.ok === "boolean" ? value.ok : undefined,
+    status: typeof value.status === "number" ? value.status : null,
+    error: asString(value.error) ?? null,
+  };
+}
+
+export function collectBlueBubblesStatusIssues(
+  accounts: ChannelAccountSnapshot[],
+): ChannelStatusIssue[] {
+  return collectIssuesForEnabledAccounts({
+    accounts,
+    readAccount: readBlueBubblesAccountStatus,
+    collectIssues: ({ account, accountId, issues }) => {
+      const configured = account.configured === true;
+      const running = account.running === true;
+      const lastError = asString(account.lastError);
+      const probe = readBlueBubblesProbeResult(account.probe);
+
+      if (!configured) {
+        issues.push({
+          channel: "bluebubbles",
+          accountId,
+          kind: "config",
+          message: "Not configured (missing serverUrl or password).",
+          fix: "Run: openclaw channels add bluebubbles --http-url <server-url> --password <password>",
+        });
+        return;
+      }
+
+      if (probe && probe.ok === false) {
+        const errorDetail = probe.error
+          ? `: ${probe.error}`
+          : probe.status
+            ? ` (HTTP ${probe.status})`
+            : "";
+        issues.push({
+          channel: "bluebubbles",
+          accountId,
+          kind: "runtime",
+          message: `BlueBubbles server unreachable${errorDetail}`,
+          fix: "Check that the BlueBubbles server is running and accessible. Verify serverUrl and password in your config.",
+        });
+      }
+
+      if (running && lastError) {
+        issues.push({
+          channel: "bluebubbles",
+          accountId,
+          kind: "runtime",
+          message: `Channel error: ${lastError}`,
+          fix: "Check gateway logs for details. If the webhook is failing, verify the webhook URL is configured in BlueBubbles server settings.",
+        });
+      }
+    },
+  });
+}
+
 export { resolveAckReaction } from "../agents/identity.js";
 export {
   createActionGate,
@@ -305,7 +403,6 @@ export {
   patchScopedAccountConfig,
 } from "../channels/plugins/setup-helpers.js";
 export { createAccountListHelpers } from "../channels/plugins/account-helpers.js";
-export { collectBlueBubblesStatusIssues } from "../channels/plugins/status-issues/bluebubbles.js";
 export type {
   BaseProbeResult,
   ChannelAccountSnapshot,