loudmouth-ai 0.1.0 → 0.2.0

package/extensions/tlon/src/onboarding.ts

@@ -1,213 +0,0 @@
-import {
-  formatDocsLink,
-  promptAccountId,
-  DEFAULT_ACCOUNT_ID,
-  normalizeAccountId,
-  type ChannelOnboardingAdapter,
-  type WizardPrompter,
-} from "clawdbot/plugin-sdk";
-
-import { listTlonAccountIds, resolveTlonAccount } from "./types.js";
-import type { TlonResolvedAccount } from "./types.js";
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
-
-const channel = "tlon" as const;
-
-function isConfigured(account: TlonResolvedAccount): boolean {
-  return Boolean(account.ship && account.url && account.code);
-}
-
-function applyAccountConfig(params: {
-  cfg: ClawdbotConfig;
-  accountId: string;
-  input: {
-    name?: string;
-    ship?: string;
-    url?: string;
-    code?: string;
-    groupChannels?: string[];
-    dmAllowlist?: string[];
-    autoDiscoverChannels?: boolean;
-  };
-}): ClawdbotConfig {
-  const { cfg, accountId, input } = params;
-  const useDefault = accountId === DEFAULT_ACCOUNT_ID;
-  const base = cfg.channels?.tlon ?? {};
-
-  if (useDefault) {
-    return {
-      ...cfg,
-      channels: {
-        ...cfg.channels,
-        tlon: {
-          ...base,
-          enabled: true,
-          ...(input.name ? { name: input.name } : {}),
-          ...(input.ship ? { ship: input.ship } : {}),
-          ...(input.url ? { url: input.url } : {}),
-          ...(input.code ? { code: input.code } : {}),
-          ...(input.groupChannels ? { groupChannels: input.groupChannels } : {}),
-          ...(input.dmAllowlist ? { dmAllowlist: input.dmAllowlist } : {}),
-          ...(typeof input.autoDiscoverChannels === "boolean"
-            ? { autoDiscoverChannels: input.autoDiscoverChannels }
-            : {}),
-        },
-      },
-    };
-  }
-
-  return {
-    ...cfg,
-    channels: {
-      ...cfg.channels,
-      tlon: {
-        ...base,
-        enabled: base.enabled ?? true,
-        accounts: {
-          ...(base as { accounts?: Record<string, unknown> }).accounts,
-          [accountId]: {
-            ...((base as { accounts?: Record<string, Record<string, unknown>> }).accounts?.[accountId] ?? {}),
-            enabled: true,
-            ...(input.name ? { name: input.name } : {}),
-            ...(input.ship ? { ship: input.ship } : {}),
-            ...(input.url ? { url: input.url } : {}),
-            ...(input.code ? { code: input.code } : {}),
-            ...(input.groupChannels ? { groupChannels: input.groupChannels } : {}),
-            ...(input.dmAllowlist ? { dmAllowlist: input.dmAllowlist } : {}),
-            ...(typeof input.autoDiscoverChannels === "boolean"
-              ? { autoDiscoverChannels: input.autoDiscoverChannels }
-              : {}),
-          },
-        },
-      },
-    },
-  };
-}
-
-async function noteTlonHelp(prompter: WizardPrompter): Promise<void> {
-  await prompter.note(
-    [
-      "You need your Urbit ship URL and login code.",
-      "Example URL: https://your-ship-host",
-      "Example ship: ~sampel-palnet",
-      `Docs: ${formatDocsLink("/channels/tlon", "channels/tlon")}`,
-    ].join("\n"),
-    "Tlon setup",
-  );
-}
-
-function parseList(value: string): string[] {
-  return value
-    .split(/[\n,;]+/g)
-    .map((entry) => entry.trim())
-    .filter(Boolean);
-}
-
-export const tlonOnboardingAdapter: ChannelOnboardingAdapter = {
-  channel,
-  getStatus: async ({ cfg }) => {
-    const accountIds = listTlonAccountIds(cfg);
-    const configured =
-      accountIds.length > 0
-        ? accountIds.some((accountId) => isConfigured(resolveTlonAccount(cfg, accountId)))
-        : isConfigured(resolveTlonAccount(cfg, DEFAULT_ACCOUNT_ID));
-
-    return {
-      channel,
-      configured,
-      statusLines: [`Tlon: ${configured ? "configured" : "needs setup"}`],
-      selectionHint: configured ? "configured" : "urbit messenger",
-      quickstartScore: configured ? 1 : 4,
-    };
-  },
-  configure: async ({ cfg, prompter, accountOverrides, shouldPromptAccountIds }) => {
-    const override = accountOverrides[channel]?.trim();
-    const defaultAccountId = DEFAULT_ACCOUNT_ID;
-    let accountId = override ? normalizeAccountId(override) : defaultAccountId;
-
-    if (shouldPromptAccountIds && !override) {
-      accountId = await promptAccountId({
-        cfg,
-        prompter,
-        label: "Tlon",
-        currentId: accountId,
-        listAccountIds: listTlonAccountIds,
-        defaultAccountId,
-      });
-    }
-
-    const resolved = resolveTlonAccount(cfg, accountId);
-    await noteTlonHelp(prompter);
-
-    const ship = await prompter.text({
-      message: "Ship name",
-      placeholder: "~sampel-palnet",
-      initialValue: resolved.ship ?? undefined,
-      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
-    });
-
-    const url = await prompter.text({
-      message: "Ship URL",
-      placeholder: "https://your-ship-host",
-      initialValue: resolved.url ?? undefined,
-      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
-    });
-
-    const code = await prompter.text({
-      message: "Login code",
-      placeholder: "lidlut-tabwed-pillex-ridrup",
-      initialValue: resolved.code ?? undefined,
-      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
-    });
-
-    const wantsGroupChannels = await prompter.confirm({
-      message: "Add group channels manually? (optional)",
-      initialValue: false,
-    });
-
-    let groupChannels: string[] | undefined;
-    if (wantsGroupChannels) {
-      const entry = await prompter.text({
-        message: "Group channels (comma-separated)",
-        placeholder: "chat/~host-ship/general, chat/~host-ship/support",
-      });
-      const parsed = parseList(String(entry ?? ""));
-      groupChannels = parsed.length > 0 ? parsed : undefined;
-    }
-
-    const wantsAllowlist = await prompter.confirm({
-      message: "Restrict DMs with an allowlist?",
-      initialValue: false,
-    });
-
-    let dmAllowlist: string[] | undefined;
-    if (wantsAllowlist) {
-      const entry = await prompter.text({
-        message: "DM allowlist (comma-separated ship names)",
-        placeholder: "~zod, ~nec",
-      });
-      const parsed = parseList(String(entry ?? ""));
-      dmAllowlist = parsed.length > 0 ? parsed : undefined;
-    }
-
-    const autoDiscoverChannels = await prompter.confirm({
-      message: "Enable auto-discovery of group channels?",
-      initialValue: resolved.autoDiscoverChannels ?? true,
-    });
-
-    const next = applyAccountConfig({
-      cfg,
-      accountId,
-      input: {
-        ship: String(ship).trim(),
-        url: String(url).trim(),
-        code: String(code).trim(),
-        groupChannels,
-        dmAllowlist,
-        autoDiscoverChannels,
-      },
-    });
-
-    return { cfg: next, accountId };
-  },
-};

package/extensions/tlon/src/runtime.ts

@@ -1,14 +0,0 @@
-import type { PluginRuntime } from "clawdbot/plugin-sdk";
-
-let runtime: PluginRuntime | null = null;
-
-export function setTlonRuntime(next: PluginRuntime) {
-  runtime = next;
-}
-
-export function getTlonRuntime(): PluginRuntime {
-  if (!runtime) {
-    throw new Error("Tlon runtime not initialized");
-  }
-  return runtime;
-}

package/extensions/tlon/src/targets.ts

@@ -1,79 +0,0 @@
-export type TlonTarget =
-  | { kind: "dm"; ship: string }
-  | { kind: "group"; nest: string; hostShip: string; channelName: string };
-
-const SHIP_RE = /^~?[a-z-]+$/i;
-const NEST_RE = /^chat\/([^/]+)\/([^/]+)$/i;
-
-export function normalizeShip(raw: string): string {
-  const trimmed = raw.trim();
-  if (!trimmed) return trimmed;
-  return trimmed.startsWith("~") ? trimmed : `~${trimmed}`;
-}
-
-export function parseChannelNest(raw: string): { hostShip: string; channelName: string } | null {
-  const match = NEST_RE.exec(raw.trim());
-  if (!match) return null;
-  const hostShip = normalizeShip(match[1]);
-  const channelName = match[2];
-  return { hostShip, channelName };
-}
-
-export function parseTlonTarget(raw?: string | null): TlonTarget | null {
-  const trimmed = raw?.trim();
-  if (!trimmed) return null;
-  const withoutPrefix = trimmed.replace(/^tlon:/i, "");
-
-  const dmPrefix = withoutPrefix.match(/^dm[/:](.+)$/i);
-  if (dmPrefix) {
-    return { kind: "dm", ship: normalizeShip(dmPrefix[1]) };
-  }
-
-  const groupPrefix = withoutPrefix.match(/^(group|room)[/:](.+)$/i);
-  if (groupPrefix) {
-    const groupTarget = groupPrefix[2].trim();
-    if (groupTarget.startsWith("chat/")) {
-      const parsed = parseChannelNest(groupTarget);
-      if (!parsed) return null;
-      return {
-        kind: "group",
-        nest: `chat/${parsed.hostShip}/${parsed.channelName}`,
-        hostShip: parsed.hostShip,
-        channelName: parsed.channelName,
-      };
-    }
-    const parts = groupTarget.split("/");
-    if (parts.length === 2) {
-      const hostShip = normalizeShip(parts[0]);
-      const channelName = parts[1];
-      return {
-        kind: "group",
-        nest: `chat/${hostShip}/${channelName}`,
-        hostShip,
-        channelName,
-      };
-    }
-    return null;
-  }
-
-  if (withoutPrefix.startsWith("chat/")) {
-    const parsed = parseChannelNest(withoutPrefix);
-    if (!parsed) return null;
-    return {
-      kind: "group",
-      nest: `chat/${parsed.hostShip}/${parsed.channelName}`,
-      hostShip: parsed.hostShip,
-      channelName: parsed.channelName,
-    };
-  }
-
-  if (SHIP_RE.test(withoutPrefix)) {
-    return { kind: "dm", ship: normalizeShip(withoutPrefix) };
-  }
-
-  return null;
-}
-
-export function formatTargetHint(): string {
-  return "dm/~sampel-palnet | ~sampel-palnet | chat/~host-ship/channel | group:~host-ship/channel";
-}

package/extensions/tlon/src/types.ts

@@ -1,85 +0,0 @@
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
-
-export type TlonResolvedAccount = {
-  accountId: string;
-  name: string | null;
-  enabled: boolean;
-  configured: boolean;
-  ship: string | null;
-  url: string | null;
-  code: string | null;
-  groupChannels: string[];
-  dmAllowlist: string[];
-  autoDiscoverChannels: boolean | null;
-  showModelSignature: boolean | null;
-};
-
-export function resolveTlonAccount(cfg: ClawdbotConfig, accountId?: string | null): TlonResolvedAccount {
-  const base = cfg.channels?.tlon as
-    | {
-        name?: string;
-        enabled?: boolean;
-        ship?: string;
-        url?: string;
-        code?: string;
-        groupChannels?: string[];
-        dmAllowlist?: string[];
-        autoDiscoverChannels?: boolean;
-        showModelSignature?: boolean;
-        accounts?: Record<string, Record<string, unknown>>;
-      }
-    | undefined;
-
-  if (!base) {
-    return {
-      accountId: accountId || "default",
-      name: null,
-      enabled: false,
-      configured: false,
-      ship: null,
-      url: null,
-      code: null,
-      groupChannels: [],
-      dmAllowlist: [],
-      autoDiscoverChannels: null,
-      showModelSignature: null,
-    };
-  }
-
-  const useDefault = !accountId || accountId === "default";
-  const account = useDefault ? base : (base.accounts?.[accountId] as Record<string, unknown> | undefined);
-
-  const ship = (account?.ship ?? base.ship ?? null) as string | null;
-  const url = (account?.url ?? base.url ?? null) as string | null;
-  const code = (account?.code ?? base.code ?? null) as string | null;
-  const groupChannels = (account?.groupChannels ?? base.groupChannels ?? []) as string[];
-  const dmAllowlist = (account?.dmAllowlist ?? base.dmAllowlist ?? []) as string[];
-  const autoDiscoverChannels =
-    (account?.autoDiscoverChannels ?? base.autoDiscoverChannels ?? null) as boolean | null;
-  const showModelSignature =
-    (account?.showModelSignature ?? base.showModelSignature ?? null) as boolean | null;
-  const configured = Boolean(ship && url && code);
-
-  return {
-    accountId: accountId || "default",
-    name: (account?.name ?? base.name ?? null) as string | null,
-    enabled: (account?.enabled ?? base.enabled ?? true) !== false,
-    configured,
-    ship,
-    url,
-    code,
-    groupChannels,
-    dmAllowlist,
-    autoDiscoverChannels,
-    showModelSignature,
-  };
-}
-
-export function listTlonAccountIds(cfg: ClawdbotConfig): string[] {
-  const base = cfg.channels?.tlon as
-    | { ship?: string; accounts?: Record<string, Record<string, unknown>> }
-    | undefined;
-  if (!base) return [];
-  const accounts = base.accounts ?? {};
-  return [...(base.ship ? ["default"] : []), ...Object.keys(accounts)];
-}

package/extensions/tlon/src/urbit/auth.ts

@@ -1,18 +0,0 @@
-export async function authenticate(url: string, code: string): Promise<string> {
-  const resp = await fetch(`${url}/~/login`, {
-    method: "POST",
-    headers: { "Content-Type": "application/x-www-form-urlencoded" },
-    body: `password=${code}`,
-  });
-
-  if (!resp.ok) {
-    throw new Error(`Login failed with status ${resp.status}`);
-  }
-
-  await resp.text();
-  const cookie = resp.headers.get("set-cookie");
-  if (!cookie) {
-    throw new Error("No authentication cookie received");
-  }
-  return cookie;
-}

package/extensions/tlon/src/urbit/http-api.ts

@@ -1,36 +0,0 @@
-import { Urbit } from "@urbit/http-api";
-
-let patched = false;
-
-export function ensureUrbitConnectPatched() {
-  if (patched) return;
-  patched = true;
-  Urbit.prototype.connect = async function patchedConnect() {
-    const resp = await fetch(`${this.url}/~/login`, {
-      method: "POST",
-      body: `password=${this.code}`,
-      credentials: "include",
-    });
-
-    if (resp.status >= 400) {
-      throw new Error(`Login failed with status ${resp.status}`);
-    }
-
-    const cookie = resp.headers.get("set-cookie");
-    if (cookie) {
-      const match = /urbauth-~([\w-]+)/.exec(cookie);
-      if (match) {
-        if (!(this as unknown as { ship?: string | null }).ship) {
-          (this as unknown as { ship?: string | null }).ship = match[1];
-        }
-        (this as unknown as { nodeId?: string }).nodeId = match[1];
-      }
-      (this as unknown as { cookie?: string }).cookie = cookie;
-    }
-
-    await (this as typeof Urbit.prototype).getShipName();
-    await (this as typeof Urbit.prototype).getOurName();
-  };
-}
-
-export { Urbit };

package/extensions/tlon/src/urbit/send.test.ts

@@ -1,38 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-vi.mock("@urbit/aura", () => ({
-  scot: vi.fn(() => "mocked-ud"),
-  da: {
-    fromUnix: vi.fn(() => 123n),
-  },
-}));
-
-describe("sendDm", () => {
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it("uses aura v3 helpers for the DM id", async () => {
-    const { sendDm } = await import("./send.js");
-    const aura = await import("@urbit/aura");
-    const scot = vi.mocked(aura.scot);
-    const fromUnix = vi.mocked(aura.da.fromUnix);
-
-    const sentAt = 1_700_000_000_000;
-    vi.spyOn(Date, "now").mockReturnValue(sentAt);
-
-    const poke = vi.fn(async () => ({}));
-
-    const result = await sendDm({
-      api: { poke },
-      fromShip: "~zod",
-      toShip: "~nec",
-      text: "hi",
-    });
-
-    expect(fromUnix).toHaveBeenCalledWith(sentAt);
-    expect(scot).toHaveBeenCalledWith("ud", 123n);
-    expect(poke).toHaveBeenCalledTimes(1);
-    expect(result.messageId).toBe("~zod/mocked-ud");
-  });
-});

package/extensions/tlon/src/urbit/send.ts

@@ -1,127 +0,0 @@
-import { scot, da } from "@urbit/aura";
-
-export type TlonPokeApi = {
-  poke: (params: { app: string; mark: string; json: unknown }) => Promise<unknown>;
-};
-
-type SendTextParams = {
-  api: TlonPokeApi;
-  fromShip: string;
-  toShip: string;
-  text: string;
-};
-
-export async function sendDm({ api, fromShip, toShip, text }: SendTextParams) {
-  const story = [{ inline: [text] }];
-  const sentAt = Date.now();
-  const idUd = scot('ud', da.fromUnix(sentAt));
-  const id = `${fromShip}/${idUd}`;
-
-  const delta = {
-    add: {
-      memo: {
-        content: story,
-        author: fromShip,
-        sent: sentAt,
-      },
-      kind: null,
-      time: null,
-    },
-  };
-
-  const action = {
-    ship: toShip,
-    diff: { id, delta },
-  };
-
-  await api.poke({
-    app: "chat",
-    mark: "chat-dm-action",
-    json: action,
-  });
-
-  return { channel: "tlon", messageId: id };
-}
-
-type SendGroupParams = {
-  api: TlonPokeApi;
-  fromShip: string;
-  hostShip: string;
-  channelName: string;
-  text: string;
-  replyToId?: string | null;
-};
-
-export async function sendGroupMessage({
-  api,
-  fromShip,
-  hostShip,
-  channelName,
-  text,
-  replyToId,
-}: SendGroupParams) {
-  const story = [{ inline: [text] }];
-  const sentAt = Date.now();
-
-  // Format reply ID as @ud (with dots) - required for Tlon to recognize thread replies
-  let formattedReplyId = replyToId;
-  if (replyToId && /^\d+$/.test(replyToId)) {
-    try {
-      formattedReplyId = formatUd(BigInt(replyToId));
-    } catch {
-      // Fall back to raw ID if formatting fails
-    }
-  }
-
-  const action = {
-    channel: {
-      nest: `chat/${hostShip}/${channelName}`,
-      action: formattedReplyId
-        ? {
-            // Thread reply - needs post wrapper around reply action
-            // ReplyActionAdd takes Memo: {content, author, sent} - no kind/blob/meta
-            post: {
-              reply: {
-                id: formattedReplyId,
-                action: {
-                  add: {
-                    content: story,
-                    author: fromShip,
-                    sent: sentAt,
-                  },
-                },
-              },
-            },
-          }
-        : {
-            // Regular post
-            post: {
-              add: {
-                content: story,
-                author: fromShip,
-                sent: sentAt,
-                kind: "/chat",
-                blob: null,
-                meta: null,
-              },
-            },
-          },
-    },
-  };
-
-  await api.poke({
-    app: "channels",
-    mark: "channel-action-1",
-    json: action,
-  });
-
-  return { channel: "tlon", messageId: `${fromShip}/${sentAt}` };
-}
-
-export function buildMediaText(text: string | undefined, mediaUrl: string | undefined): string {
-  const cleanText = text?.trim() ?? "";
-  const cleanUrl = mediaUrl?.trim() ?? "";
-  if (cleanText && cleanUrl) return `${cleanText}\n${cleanUrl}`;
-  if (cleanUrl) return cleanUrl;
-  return cleanText;
-}

package/extensions/tlon/src/urbit/sse-client.test.ts

@@ -1,41 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-
-import { UrbitSSEClient } from "./sse-client.js";
-
-const mockFetch = vi.fn();
-
-describe("UrbitSSEClient", () => {
-  beforeEach(() => {
-    vi.stubGlobal("fetch", mockFetch);
-    mockFetch.mockReset();
-  });
-
-  afterEach(() => {
-    vi.unstubAllGlobals();
-  });
-
-  it("sends subscriptions added after connect", async () => {
-    mockFetch.mockResolvedValue({ ok: true, status: 200, text: async () => "" });
-
-    const client = new UrbitSSEClient("https://example.com", "urbauth-~zod=123");
-    (client as { isConnected: boolean }).isConnected = true;
-
-    await client.subscribe({
-      app: "chat",
-      path: "/dm/~zod",
-      event: () => {},
-    });
-
-    expect(mockFetch).toHaveBeenCalledTimes(1);
-    const [url, init] = mockFetch.mock.calls[0];
-    expect(url).toBe(client.channelUrl);
-    expect(init.method).toBe("PUT");
-    const body = JSON.parse(init.body as string);
-    expect(body).toHaveLength(1);
-    expect(body[0]).toMatchObject({
-      action: "subscribe",
-      app: "chat",
-      path: "/dm/~zod",
-    });
-  });
-});