loudmouth-ai 0.1.0 → 0.2.0

package/extensions/bluebubbles/src/onboarding.ts

@@ -1,340 +0,0 @@
-import type {
-  ChannelOnboardingAdapter,
-  ChannelOnboardingDmPolicy,
-  ClawdbotConfig,
-  DmPolicy,
-  WizardPrompter,
-} from "clawdbot/plugin-sdk";
-import {
-  DEFAULT_ACCOUNT_ID,
-  addWildcardAllowFrom,
-  formatDocsLink,
-  normalizeAccountId,
-  promptAccountId,
-} from "clawdbot/plugin-sdk";
-import {
-  listBlueBubblesAccountIds,
-  resolveBlueBubblesAccount,
-  resolveDefaultBlueBubblesAccountId,
-} from "./accounts.js";
-import { normalizeBlueBubblesServerUrl } from "./types.js";
-import { parseBlueBubblesAllowTarget, normalizeBlueBubblesHandle } from "./targets.js";
-
-const channel = "bluebubbles" as const;
-
-function setBlueBubblesDmPolicy(cfg: ClawdbotConfig, dmPolicy: DmPolicy): ClawdbotConfig {
-  const allowFrom =
-    dmPolicy === "open" ? addWildcardAllowFrom(cfg.channels?.bluebubbles?.allowFrom) : undefined;
-  return {
-    ...cfg,
-    channels: {
-      ...cfg.channels,
-      bluebubbles: {
-        ...cfg.channels?.bluebubbles,
-        dmPolicy,
-        ...(allowFrom ? { allowFrom } : {}),
-      },
-    },
-  };
-}
-
-function setBlueBubblesAllowFrom(
-  cfg: ClawdbotConfig,
-  accountId: string,
-  allowFrom: string[],
-): ClawdbotConfig {
-  if (accountId === DEFAULT_ACCOUNT_ID) {
-    return {
-      ...cfg,
-      channels: {
-        ...cfg.channels,
-        bluebubbles: {
-          ...cfg.channels?.bluebubbles,
-          allowFrom,
-        },
-      },
-    };
-  }
-  return {
-    ...cfg,
-    channels: {
-      ...cfg.channels,
-      bluebubbles: {
-        ...cfg.channels?.bluebubbles,
-        accounts: {
-          ...cfg.channels?.bluebubbles?.accounts,
-          [accountId]: {
-            ...cfg.channels?.bluebubbles?.accounts?.[accountId],
-            allowFrom,
-          },
-        },
-      },
-    },
-  };
-}
-
-function parseBlueBubblesAllowFromInput(raw: string): string[] {
-  return raw
-    .split(/[\n,]+/g)
-    .map((entry) => entry.trim())
-    .filter(Boolean);
-}
-
-async function promptBlueBubblesAllowFrom(params: {
-  cfg: ClawdbotConfig;
-  prompter: WizardPrompter;
-  accountId?: string;
-}): Promise<ClawdbotConfig> {
-  const accountId =
-    params.accountId && normalizeAccountId(params.accountId)
-      ? (normalizeAccountId(params.accountId) ?? DEFAULT_ACCOUNT_ID)
-      : resolveDefaultBlueBubblesAccountId(params.cfg);
-  const resolved = resolveBlueBubblesAccount({ cfg: params.cfg, accountId });
-  const existing = resolved.config.allowFrom ?? [];
-  await params.prompter.note(
-    [
-      "Allowlist BlueBubbles DMs by handle or chat target.",
-      "Examples:",
-      "- +15555550123",
-      "- user@example.com",
-      "- chat_id:123",
-      "- chat_guid:iMessage;-;+15555550123",
-      "Multiple entries: comma- or newline-separated.",
-      `Docs: ${formatDocsLink("/channels/bluebubbles", "bluebubbles")}`,
-    ].join("\n"),
-    "BlueBubbles allowlist",
-  );
-  const entry = await params.prompter.text({
-    message: "BlueBubbles allowFrom (handle or chat_id)",
-    placeholder: "+15555550123, user@example.com, chat_id:123",
-    initialValue: existing[0] ? String(existing[0]) : undefined,
-    validate: (value) => {
-      const raw = String(value ?? "").trim();
-      if (!raw) return "Required";
-      const parts = parseBlueBubblesAllowFromInput(raw);
-      for (const part of parts) {
-        if (part === "*") continue;
-        const parsed = parseBlueBubblesAllowTarget(part);
-        if (parsed.kind === "handle" && !parsed.handle) {
-          return `Invalid entry: ${part}`;
-        }
-      }
-      return undefined;
-    },
-  });
-  const parts = parseBlueBubblesAllowFromInput(String(entry));
-  const unique = [...new Set(parts)];
-  return setBlueBubblesAllowFrom(params.cfg, accountId, unique);
-}
-
-const dmPolicy: ChannelOnboardingDmPolicy = {
-  label: "BlueBubbles",
-  channel,
-  policyKey: "channels.bluebubbles.dmPolicy",
-  allowFromKey: "channels.bluebubbles.allowFrom",
-  getCurrent: (cfg) => cfg.channels?.bluebubbles?.dmPolicy ?? "pairing",
-  setPolicy: (cfg, policy) => setBlueBubblesDmPolicy(cfg, policy),
-  promptAllowFrom: promptBlueBubblesAllowFrom,
-};
-
-export const blueBubblesOnboardingAdapter: ChannelOnboardingAdapter = {
-  channel,
-  getStatus: async ({ cfg }) => {
-    const configured = listBlueBubblesAccountIds(cfg).some((accountId) => {
-      const account = resolveBlueBubblesAccount({ cfg, accountId });
-      return account.configured;
-    });
-    return {
-      channel,
-      configured,
-      statusLines: [`BlueBubbles: ${configured ? "configured" : "needs setup"}`],
-      selectionHint: configured ? "configured" : "iMessage via BlueBubbles app",
-      quickstartScore: configured ? 1 : 0,
-    };
-  },
-  configure: async ({ cfg, prompter, accountOverrides, shouldPromptAccountIds }) => {
-    const blueBubblesOverride = accountOverrides.bluebubbles?.trim();
-    const defaultAccountId = resolveDefaultBlueBubblesAccountId(cfg);
-    let accountId = blueBubblesOverride
-      ? normalizeAccountId(blueBubblesOverride)
-      : defaultAccountId;
-    if (shouldPromptAccountIds && !blueBubblesOverride) {
-      accountId = await promptAccountId({
-        cfg,
-        prompter,
-        label: "BlueBubbles",
-        currentId: accountId,
-        listAccountIds: listBlueBubblesAccountIds,
-        defaultAccountId,
-      });
-    }
-
-    let next = cfg;
-    const resolvedAccount = resolveBlueBubblesAccount({ cfg: next, accountId });
-
-    // Prompt for server URL
-    let serverUrl = resolvedAccount.config.serverUrl?.trim();
-    if (!serverUrl) {
-      await prompter.note(
-        [
-          "Enter the BlueBubbles server URL (e.g., http://192.168.1.100:1234).",
-          "Find this in the BlueBubbles Server app under Connection.",
-          `Docs: ${formatDocsLink("/channels/bluebubbles", "bluebubbles")}`,
-        ].join("\n"),
-        "BlueBubbles server URL",
-      );
-      const entered = await prompter.text({
-        message: "BlueBubbles server URL",
-        placeholder: "http://192.168.1.100:1234",
-        validate: (value) => {
-          const trimmed = String(value ?? "").trim();
-          if (!trimmed) return "Required";
-          try {
-            const normalized = normalizeBlueBubblesServerUrl(trimmed);
-            new URL(normalized);
-            return undefined;
-          } catch {
-            return "Invalid URL format";
-          }
-        },
-      });
-      serverUrl = String(entered).trim();
-    } else {
-      const keepUrl = await prompter.confirm({
-        message: `BlueBubbles server URL already set (${serverUrl}). Keep it?`,
-        initialValue: true,
-      });
-      if (!keepUrl) {
-        const entered = await prompter.text({
-          message: "BlueBubbles server URL",
-          placeholder: "http://192.168.1.100:1234",
-          initialValue: serverUrl,
-          validate: (value) => {
-            const trimmed = String(value ?? "").trim();
-            if (!trimmed) return "Required";
-            try {
-              const normalized = normalizeBlueBubblesServerUrl(trimmed);
-              new URL(normalized);
-              return undefined;
-            } catch {
-              return "Invalid URL format";
-            }
-          },
-        });
-        serverUrl = String(entered).trim();
-      }
-    }
-
-    // Prompt for password
-    let password = resolvedAccount.config.password?.trim();
-    if (!password) {
-      await prompter.note(
-        [
-          "Enter the BlueBubbles server password.",
-          "Find this in the BlueBubbles Server app under Settings.",
-        ].join("\n"),
-        "BlueBubbles password",
-      );
-      const entered = await prompter.text({
-        message: "BlueBubbles password",
-        validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
-      });
-      password = String(entered).trim();
-    } else {
-      const keepPassword = await prompter.confirm({
-        message: "BlueBubbles password already set. Keep it?",
-        initialValue: true,
-      });
-      if (!keepPassword) {
-        const entered = await prompter.text({
-          message: "BlueBubbles password",
-          validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
-        });
-        password = String(entered).trim();
-      }
-    }
-
-    // Prompt for webhook path (optional)
-    const existingWebhookPath = resolvedAccount.config.webhookPath?.trim();
-    const wantsWebhook = await prompter.confirm({
-      message: "Configure a custom webhook path? (default: /bluebubbles-webhook)",
-      initialValue: Boolean(existingWebhookPath && existingWebhookPath !== "/bluebubbles-webhook"),
-    });
-    let webhookPath = "/bluebubbles-webhook";
-    if (wantsWebhook) {
-      const entered = await prompter.text({
-        message: "Webhook path",
-        placeholder: "/bluebubbles-webhook",
-        initialValue: existingWebhookPath || "/bluebubbles-webhook",
-        validate: (value) => {
-          const trimmed = String(value ?? "").trim();
-          if (!trimmed) return "Required";
-          if (!trimmed.startsWith("/")) return "Path must start with /";
-          return undefined;
-        },
-      });
-      webhookPath = String(entered).trim();
-    }
-
-    // Apply config
-    if (accountId === DEFAULT_ACCOUNT_ID) {
-      next = {
-        ...next,
-        channels: {
-          ...next.channels,
-          bluebubbles: {
-            ...next.channels?.bluebubbles,
-            enabled: true,
-            serverUrl,
-            password,
-            webhookPath,
-          },
-        },
-      };
-    } else {
-      next = {
-        ...next,
-        channels: {
-          ...next.channels,
-          bluebubbles: {
-            ...next.channels?.bluebubbles,
-            enabled: true,
-            accounts: {
-              ...next.channels?.bluebubbles?.accounts,
-              [accountId]: {
-                ...next.channels?.bluebubbles?.accounts?.[accountId],
-                enabled: next.channels?.bluebubbles?.accounts?.[accountId]?.enabled ?? true,
-                serverUrl,
-                password,
-                webhookPath,
-              },
-            },
-          },
-        },
-      };
-    }
-
-    await prompter.note(
-      [
-        "Configure the webhook URL in BlueBubbles Server:",
-        "1. Open BlueBubbles Server → Settings → Webhooks",
-        "2. Add your Clawdbot gateway URL + webhook path",
-        "   Example: https://your-gateway-host:3000/bluebubbles-webhook",
-        "3. Enable the webhook and save",
-        "",
-        `Docs: ${formatDocsLink("/channels/bluebubbles", "bluebubbles")}`,
-      ].join("\n"),
-      "BlueBubbles next steps",
-    );
-
-    return { cfg: next, accountId };
-  },
-  dmPolicy,
-  disable: (cfg) => ({
-    ...cfg,
-    channels: {
-      ...cfg.channels,
-      bluebubbles: { ...cfg.channels?.bluebubbles, enabled: false },
-    },
-  }),
-};

package/extensions/bluebubbles/src/probe.ts

@@ -1,127 +0,0 @@
-import { buildBlueBubblesApiUrl, blueBubblesFetchWithTimeout } from "./types.js";
-
-export type BlueBubblesProbe = {
-  ok: boolean;
-  status?: number | null;
-  error?: string | null;
-};
-
-export type BlueBubblesServerInfo = {
-  os_version?: string;
-  server_version?: string;
-  private_api?: boolean;
-  helper_connected?: boolean;
-  proxy_service?: string;
-  detected_icloud?: string;
-  computer_id?: string;
-};
-
-/** Cache server info by account ID to avoid repeated API calls */
-const serverInfoCache = new Map<string, { info: BlueBubblesServerInfo; expires: number }>();
-const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
-
-function buildCacheKey(accountId?: string): string {
-  return accountId?.trim() || "default";
-}
-
-/**
- * Fetch server info from BlueBubbles API and cache it.
- * Returns cached result if available and not expired.
- */
-export async function fetchBlueBubblesServerInfo(params: {
-  baseUrl?: string | null;
-  password?: string | null;
-  accountId?: string;
-  timeoutMs?: number;
-}): Promise<BlueBubblesServerInfo | null> {
-  const baseUrl = params.baseUrl?.trim();
-  const password = params.password?.trim();
-  if (!baseUrl || !password) return null;
-
-  const cacheKey = buildCacheKey(params.accountId);
-  const cached = serverInfoCache.get(cacheKey);
-  if (cached && cached.expires > Date.now()) {
-    return cached.info;
-  }
-
-  const url = buildBlueBubblesApiUrl({ baseUrl, path: "/api/v1/server/info", password });
-  try {
-    const res = await blueBubblesFetchWithTimeout(url, { method: "GET" }, params.timeoutMs ?? 5000);
-    if (!res.ok) return null;
-    const payload = (await res.json().catch(() => null)) as Record<string, unknown> | null;
-    const data = payload?.data as BlueBubblesServerInfo | undefined;
-    if (data) {
-      serverInfoCache.set(cacheKey, { info: data, expires: Date.now() + CACHE_TTL_MS });
-    }
-    return data ?? null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get cached server info synchronously (for use in listActions).
- * Returns null if not cached or expired.
- */
-export function getCachedBlueBubblesServerInfo(accountId?: string): BlueBubblesServerInfo | null {
-  const cacheKey = buildCacheKey(accountId);
-  const cached = serverInfoCache.get(cacheKey);
-  if (cached && cached.expires > Date.now()) {
-    return cached.info;
-  }
-  return null;
-}
-
-/**
- * Parse macOS version string (e.g., "15.0.1" or "26.0") into major version number.
- */
-export function parseMacOSMajorVersion(version?: string | null): number | null {
-  if (!version) return null;
-  const match = /^(\d+)/.exec(version.trim());
-  return match ? Number.parseInt(match[1], 10) : null;
-}
-
-/**
- * Check if the cached server info indicates macOS 26 or higher.
- * Returns false if no cached info is available (fail open for action listing).
- */
-export function isMacOS26OrHigher(accountId?: string): boolean {
-  const info = getCachedBlueBubblesServerInfo(accountId);
-  if (!info?.os_version) return false;
-  const major = parseMacOSMajorVersion(info.os_version);
-  return major !== null && major >= 26;
-}
-
-/** Clear the server info cache (for testing) */
-export function clearServerInfoCache(): void {
-  serverInfoCache.clear();
-}
-
-export async function probeBlueBubbles(params: {
-  baseUrl?: string | null;
-  password?: string | null;
-  timeoutMs?: number;
-}): Promise<BlueBubblesProbe> {
-  const baseUrl = params.baseUrl?.trim();
-  const password = params.password?.trim();
-  if (!baseUrl) return { ok: false, error: "serverUrl not configured" };
-  if (!password) return { ok: false, error: "password not configured" };
-  const url = buildBlueBubblesApiUrl({ baseUrl, path: "/api/v1/ping", password });
-  try {
-    const res = await blueBubblesFetchWithTimeout(
-      url,
-      { method: "GET" },
-      params.timeoutMs,
-    );
-    if (!res.ok) {
-      return { ok: false, status: res.status, error: `HTTP ${res.status}` };
-    }
-    return { ok: true, status: res.status };
-  } catch (err) {
-    return {
-      ok: false,
-      status: null,
-      error: err instanceof Error ? err.message : String(err),
-    };
-  }
-}