loudmouth-ai 0.1.0 → 0.2.0

package/extensions/matrix/src/matrix/monitor/room-info.ts

@@ -1,58 +0,0 @@
-import type { MatrixClient } from "matrix-bot-sdk";
-
-export type MatrixRoomInfo = {
-  name?: string;
-  canonicalAlias?: string;
-  altAliases: string[];
-};
-
-export function createMatrixRoomInfoResolver(client: MatrixClient) {
-  const roomInfoCache = new Map<string, MatrixRoomInfo>();
-
-  const getRoomInfo = async (roomId: string): Promise<MatrixRoomInfo> => {
-    const cached = roomInfoCache.get(roomId);
-    if (cached) return cached;
-    let name: string | undefined;
-    let canonicalAlias: string | undefined;
-    let altAliases: string[] = [];
-    try {
-      const nameState = await client
-        .getRoomStateEvent(roomId, "m.room.name", "")
-        .catch(() => null);
-      name = nameState?.name;
-    } catch {
-      // ignore
-    }
-    try {
-      const aliasState = await client
-        .getRoomStateEvent(roomId, "m.room.canonical_alias", "")
-        .catch(() => null);
-      canonicalAlias = aliasState?.alias;
-      altAliases = aliasState?.alt_aliases ?? [];
-    } catch {
-      // ignore
-    }
-    const info = { name, canonicalAlias, altAliases };
-    roomInfoCache.set(roomId, info);
-    return info;
-  };
-
-  const getMemberDisplayName = async (
-    roomId: string,
-    userId: string,
-  ): Promise<string> => {
-    try {
-      const memberState = await client
-        .getRoomStateEvent(roomId, "m.room.member", userId)
-        .catch(() => null);
-      return memberState?.displayname ?? userId;
-    } catch {
-      return userId;
-    }
-  };
-
-  return {
-    getRoomInfo,
-    getMemberDisplayName,
-  };
-}

package/extensions/matrix/src/matrix/monitor/rooms.ts

@@ -1,43 +0,0 @@
-import type { MatrixRoomConfig } from "../../types.js";
-import { buildChannelKeyCandidates, resolveChannelEntryMatch } from "clawdbot/plugin-sdk";
-
-export type MatrixRoomConfigResolved = {
-  allowed: boolean;
-  allowlistConfigured: boolean;
-  config?: MatrixRoomConfig;
-  matchKey?: string;
-  matchSource?: "direct" | "wildcard";
-};
-
-export function resolveMatrixRoomConfig(params: {
-  rooms?: Record<string, MatrixRoomConfig>;
-  roomId: string;
-  aliases: string[];
-  name?: string | null;
-}): MatrixRoomConfigResolved {
-  const rooms = params.rooms ?? {};
-  const keys = Object.keys(rooms);
-  const allowlistConfigured = keys.length > 0;
-  const candidates = buildChannelKeyCandidates(
-    params.roomId,
-    `room:${params.roomId}`,
-    ...params.aliases,
-    params.name ?? "",
-  );
-  const { entry: matched, key: matchedKey, wildcardEntry, wildcardKey } = resolveChannelEntryMatch({
-    entries: rooms,
-    keys: candidates,
-    wildcardKey: "*",
-  });
-  const resolved = matched ?? wildcardEntry;
-  const allowed = resolved ? resolved.enabled !== false && resolved.allow !== false : false;
-  const matchKey = matchedKey ?? wildcardKey;
-  const matchSource = matched ? "direct" : wildcardEntry ? "wildcard" : undefined;
-  return {
-    allowed,
-    allowlistConfigured,
-    config: resolved,
-    matchKey,
-    matchSource,
-  };
-}

package/extensions/matrix/src/matrix/monitor/threads.ts

@@ -1,64 +0,0 @@
-// Type for raw Matrix event from matrix-bot-sdk
-type MatrixRawEvent = {
-  event_id: string;
-  sender: string;
-  type: string;
-  origin_server_ts: number;
-  content: Record<string, unknown>;
-};
-
-type RoomMessageEventContent = {
-  msgtype: string;
-  body: string;
-  "m.relates_to"?: {
-    rel_type?: string;
-    event_id?: string;
-    "m.in_reply_to"?: { event_id?: string };
-  };
-};
-
-const RelationType = {
-  Thread: "m.thread",
-} as const;
-
-export function resolveMatrixThreadTarget(params: {
-  threadReplies: "off" | "inbound" | "always";
-  messageId: string;
-  threadRootId?: string;
-  isThreadRoot?: boolean;
-}): string | undefined {
-  const { threadReplies, messageId, threadRootId } = params;
-  if (threadReplies === "off") return undefined;
-  const isThreadRoot = params.isThreadRoot === true;
-  const hasInboundThread = Boolean(threadRootId && threadRootId !== messageId && !isThreadRoot);
-  if (threadReplies === "inbound") {
-    return hasInboundThread ? threadRootId : undefined;
-  }
-  if (threadReplies === "always") {
-    return threadRootId ?? messageId;
-  }
-  return undefined;
-}
-
-export function resolveMatrixThreadRootId(params: {
-  event: MatrixRawEvent;
-  content: RoomMessageEventContent;
-}): string | undefined {
-  const relates = params.content["m.relates_to"];
-  if (!relates || typeof relates !== "object") return undefined;
-  if ("rel_type" in relates && relates.rel_type === RelationType.Thread) {
-    if ("event_id" in relates && typeof relates.event_id === "string") {
-      return relates.event_id;
-    }
-    if (
-      "m.in_reply_to" in relates &&
-      typeof relates["m.in_reply_to"] === "object" &&
-      relates["m.in_reply_to"] &&
-      "event_id" in relates["m.in_reply_to"] &&
-      typeof relates["m.in_reply_to"].event_id === "string"
-    ) {
-      return relates["m.in_reply_to"].event_id;
-    }
-  }
-  return undefined;
-}

package/extensions/matrix/src/matrix/monitor/types.ts

@@ -1,39 +0,0 @@
-import type { EncryptedFile, MessageEventContent } from "matrix-bot-sdk";
-
-export const EventType = {
-  RoomMessage: "m.room.message",
-  RoomMessageEncrypted: "m.room.encrypted",
-  RoomMember: "m.room.member",
-  Location: "m.location",
-} as const;
-
-export const RelationType = {
-  Replace: "m.replace",
-  Thread: "m.thread",
-} as const;
-
-export type MatrixRawEvent = {
-  event_id: string;
-  sender: string;
-  type: string;
-  origin_server_ts: number;
-  content: Record<string, unknown>;
-  unsigned?: {
-    age?: number;
-    redacted_because?: unknown;
-  };
-};
-
-export type RoomMessageEventContent = MessageEventContent & {
-  url?: string;
-  file?: EncryptedFile;
-  info?: {
-    mimetype?: string;
-    size?: number;
-  };
-  "m.relates_to"?: {
-    rel_type?: string;
-    event_id?: string;
-    "m.in_reply_to"?: { event_id?: string };
-  };
-};

package/extensions/matrix/src/matrix/poll-types.test.ts

@@ -1,22 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { parsePollStartContent } from "./poll-types.js";
-
-describe("parsePollStartContent", () => {
-  it("parses legacy m.poll payloads", () => {
-    const summary = parsePollStartContent({
-      "m.poll": {
-        question: { "m.text": "Lunch?" },
-        kind: "m.poll.disclosed",
-        max_selections: 1,
-        answers: [
-          { id: "answer1", "m.text": "Yes" },
-          { id: "answer2", "m.text": "No" },
-        ],
-      },
-    });
-
-    expect(summary?.question).toBe("Lunch?");
-    expect(summary?.answers).toEqual(["Yes", "No"]);
-  });
-});

package/extensions/matrix/src/matrix/poll-types.ts

@@ -1,157 +0,0 @@
-/**
- * Matrix Poll Types (MSC3381)
- *
- * Defines types for Matrix poll events:
- * - m.poll.start - Creates a new poll
- * - m.poll.response - Records a vote
- * - m.poll.end - Closes a poll
- */
-
-import type { PollInput } from "clawdbot/plugin-sdk";
-
-export const M_POLL_START = "m.poll.start" as const;
-export const M_POLL_RESPONSE = "m.poll.response" as const;
-export const M_POLL_END = "m.poll.end" as const;
-
-export const ORG_POLL_START = "org.matrix.msc3381.poll.start" as const;
-export const ORG_POLL_RESPONSE = "org.matrix.msc3381.poll.response" as const;
-export const ORG_POLL_END = "org.matrix.msc3381.poll.end" as const;
-
-export const POLL_EVENT_TYPES = [
-  M_POLL_START,
-  M_POLL_RESPONSE,
-  M_POLL_END,
-  ORG_POLL_START,
-  ORG_POLL_RESPONSE,
-  ORG_POLL_END,
-];
-
-export const POLL_START_TYPES = [M_POLL_START, ORG_POLL_START];
-export const POLL_RESPONSE_TYPES = [M_POLL_RESPONSE, ORG_POLL_RESPONSE];
-export const POLL_END_TYPES = [M_POLL_END, ORG_POLL_END];
-
-export type PollKind = "m.poll.disclosed" | "m.poll.undisclosed";
-
-export type TextContent = {
-  "m.text"?: string;
-  "org.matrix.msc1767.text"?: string;
-  body?: string;
-};
-
-export type PollAnswer = {
-  id: string;
-} & TextContent;
-
-export type PollStartSubtype = {
-  question: TextContent;
-  kind?: PollKind;
-  max_selections?: number;
-  answers: PollAnswer[];
-};
-
-export type LegacyPollStartContent = {
-  "m.poll"?: PollStartSubtype;
-};
-
-export type PollStartContent = {
-  [M_POLL_START]?: PollStartSubtype;
-  [ORG_POLL_START]?: PollStartSubtype;
-  "m.poll"?: PollStartSubtype;
-  "m.text"?: string;
-  "org.matrix.msc1767.text"?: string;
-};
-
-export type PollSummary = {
-  eventId: string;
-  roomId: string;
-  sender: string;
-  senderName: string;
-  question: string;
-  answers: string[];
-  kind: PollKind;
-  maxSelections: number;
-};
-
-export function isPollStartType(eventType: string): boolean {
-  return POLL_START_TYPES.includes(eventType);
-}
-
-export function getTextContent(text?: TextContent): string {
-  if (!text) return "";
-  return text["m.text"] ?? text["org.matrix.msc1767.text"] ?? text.body ?? "";
-}
-
-export function parsePollStartContent(content: PollStartContent): PollSummary | null {
-  const poll = (content as Record<string, PollStartSubtype | undefined>)[M_POLL_START]
-    ?? (content as Record<string, PollStartSubtype | undefined>)[ORG_POLL_START]
-    ?? (content as Record<string, PollStartSubtype | undefined>)["m.poll"];
-  if (!poll) return null;
-
-  const question = getTextContent(poll.question);
-  if (!question) return null;
-
-  const answers = poll.answers
-    .map((answer) => getTextContent(answer))
-    .filter((a) => a.trim().length > 0);
-
-  return {
-    eventId: "",
-    roomId: "",
-    sender: "",
-    senderName: "",
-    question,
-    answers,
-    kind: poll.kind ?? "m.poll.disclosed",
-    maxSelections: poll.max_selections ?? 1,
-  };
-}
-
-export function formatPollAsText(summary: PollSummary): string {
-  const lines = [
-    "[Poll]",
-    summary.question,
-    "",
-    ...summary.answers.map((answer, idx) => `${idx + 1}. ${answer}`),
-  ];
-  return lines.join("\n");
-}
-
-function buildTextContent(body: string): TextContent {
-  return {
-    "m.text": body,
-    "org.matrix.msc1767.text": body,
-  };
-}
-
-function buildPollFallbackText(question: string, answers: string[]): string {
-  if (answers.length === 0) return question;
-  return `${question}\n${answers.map((answer, idx) => `${idx + 1}. ${answer}`).join("\n")}`;
-}
-
-export function buildPollStartContent(poll: PollInput): PollStartContent {
-  const question = poll.question.trim();
-  const answers = poll.options
-    .map((option) => option.trim())
-    .filter((option) => option.length > 0)
-    .map((option, idx) => ({
-      id: `answer${idx + 1}`,
-      ...buildTextContent(option),
-    }));
-
-  const maxSelections = poll.multiple ? Math.max(1, answers.length) : 1;
-  const fallbackText = buildPollFallbackText(
-    question,
-    answers.map((answer) => getTextContent(answer)),
-  );
-
-  return {
-    [M_POLL_START]: {
-      question: buildTextContent(question),
-      kind: poll.multiple ? "m.poll.undisclosed" : "m.poll.disclosed",
-      max_selections: maxSelections,
-      answers,
-    },
-    "m.text": fallbackText,
-    "org.matrix.msc1767.text": fallbackText,
-  };
-}

package/extensions/matrix/src/matrix/probe.ts

@@ -1,70 +0,0 @@
-import { createMatrixClient, isBunRuntime } from "./client.js";
-
-export type MatrixProbe = {
-  ok: boolean;
-  status?: number | null;
-  error?: string | null;
-  elapsedMs: number;
-  userId?: string | null;
-};
-
-export async function probeMatrix(params: {
-  homeserver: string;
-  accessToken: string;
-  userId?: string;
-  timeoutMs: number;
-}): Promise<MatrixProbe> {
-  const started = Date.now();
-  const result: MatrixProbe = {
-    ok: false,
-    status: null,
-    error: null,
-    elapsedMs: 0,
-  };
-  if (isBunRuntime()) {
-    return {
-      ...result,
-      error: "Matrix probe requires Node (bun runtime not supported)",
-      elapsedMs: Date.now() - started,
-    };
-  }
-  if (!params.homeserver?.trim()) {
-    return {
-      ...result,
-      error: "missing homeserver",
-      elapsedMs: Date.now() - started,
-    };
-  }
-  if (!params.accessToken?.trim()) {
-    return {
-      ...result,
-      error: "missing access token",
-      elapsedMs: Date.now() - started,
-    };
-  }
-  try {
-    const client = await createMatrixClient({
-      homeserver: params.homeserver,
-      userId: params.userId ?? "",
-      accessToken: params.accessToken,
-      localTimeoutMs: params.timeoutMs,
-    });
-    // matrix-bot-sdk uses getUserId() which calls whoami internally
-    const userId = await client.getUserId();
-    result.ok = true;
-    result.userId = userId ?? null;
-
-    result.elapsedMs = Date.now() - started;
-    return result;
-  } catch (err) {
-    return {
-      ...result,
-      status:
-        typeof err === "object" && err && "statusCode" in err
-          ? Number((err as { statusCode?: number }).statusCode)
-          : result.status,
-      error: err instanceof Error ? err.message : String(err),
-      elapsedMs: Date.now() - started,
-    };
-  }
-}

package/extensions/matrix/src/matrix/send/client.ts

@@ -1,63 +0,0 @@
-import type { MatrixClient } from "matrix-bot-sdk";
-
-import { getMatrixRuntime } from "../../runtime.js";
-import { getActiveMatrixClient } from "../active-client.js";
-import {
-  createMatrixClient,
-  isBunRuntime,
-  resolveMatrixAuth,
-  resolveSharedMatrixClient,
-} from "../client.js";
-import type { CoreConfig } from "../types.js";
-
-const getCore = () => getMatrixRuntime();
-
-export function ensureNodeRuntime() {
-  if (isBunRuntime()) {
-    throw new Error("Matrix support requires Node (bun runtime not supported)");
-  }
-}
-
-export function resolveMediaMaxBytes(): number | undefined {
-  const cfg = getCore().config.loadConfig() as CoreConfig;
-  if (typeof cfg.channels?.matrix?.mediaMaxMb === "number") {
-    return cfg.channels.matrix.mediaMaxMb * 1024 * 1024;
-  }
-  return undefined;
-}
-
-export async function resolveMatrixClient(opts: {
-  client?: MatrixClient;
-  timeoutMs?: number;
-}): Promise<{ client: MatrixClient; stopOnDone: boolean }> {
-  ensureNodeRuntime();
-  if (opts.client) return { client: opts.client, stopOnDone: false };
-  const active = getActiveMatrixClient();
-  if (active) return { client: active, stopOnDone: false };
-  const shouldShareClient = Boolean(process.env.CLAWDBOT_GATEWAY_PORT);
-  if (shouldShareClient) {
-    const client = await resolveSharedMatrixClient({
-      timeoutMs: opts.timeoutMs,
-    });
-    return { client, stopOnDone: false };
-  }
-  const auth = await resolveMatrixAuth();
-  const client = await createMatrixClient({
-    homeserver: auth.homeserver,
-    userId: auth.userId,
-    accessToken: auth.accessToken,
-    encryption: auth.encryption,
-    localTimeoutMs: opts.timeoutMs,
-  });
-  if (auth.encryption && client.crypto) {
-    try {
-      const joinedRooms = await client.getJoinedRooms();
-      await client.crypto.prepare(joinedRooms);
-    } catch {
-      // Ignore crypto prep failures for one-off sends; normal sync will retry.
-    }
-  }
-  // matrix-bot-sdk uses start() instead of startClient()
-  await client.start();
-  return { client, stopOnDone: true };
-}

package/extensions/matrix/src/matrix/send/formatting.ts

@@ -1,92 +0,0 @@
-import { markdownToMatrixHtml } from "../format.js";
-import { getMatrixRuntime } from "../../runtime.js";
-import {
-  MsgType,
-  RelationType,
-  type MatrixFormattedContent,
-  type MatrixMediaMsgType,
-  type MatrixRelation,
-  type MatrixReplyRelation,
-  type MatrixTextContent,
-  type MatrixThreadRelation,
-} from "./types.js";
-
-const getCore = () => getMatrixRuntime();
-
-export function buildTextContent(
-  body: string,
-  relation?: MatrixRelation,
-): MatrixTextContent {
-  const content: MatrixTextContent = relation
-    ? {
-        msgtype: MsgType.Text,
-        body,
-        "m.relates_to": relation,
-      }
-    : {
-        msgtype: MsgType.Text,
-        body,
-      };
-  applyMatrixFormatting(content, body);
-  return content;
-}
-
-export function applyMatrixFormatting(content: MatrixFormattedContent, body: string): void {
-  const formatted = markdownToMatrixHtml(body ?? "");
-  if (!formatted) return;
-  content.format = "org.matrix.custom.html";
-  content.formatted_body = formatted;
-}
-
-export function buildReplyRelation(replyToId?: string): MatrixReplyRelation | undefined {
-  const trimmed = replyToId?.trim();
-  if (!trimmed) return undefined;
-  return { "m.in_reply_to": { event_id: trimmed } };
-}
-
-export function buildThreadRelation(
-  threadId: string,
-  replyToId?: string,
-): MatrixThreadRelation {
-  const trimmed = threadId.trim();
-  return {
-    rel_type: RelationType.Thread,
-    event_id: trimmed,
-    is_falling_back: true,
-    "m.in_reply_to": { event_id: (replyToId?.trim() || trimmed) },
-  };
-}
-
-export function resolveMatrixMsgType(
-  contentType?: string,
-  _fileName?: string,
-): MatrixMediaMsgType {
-  const kind = getCore().media.mediaKindFromMime(contentType ?? "");
-  switch (kind) {
-    case "image":
-      return MsgType.Image;
-    case "audio":
-      return MsgType.Audio;
-    case "video":
-      return MsgType.Video;
-    default:
-      return MsgType.File;
-  }
-}
-
-export function resolveMatrixVoiceDecision(opts: {
-  wantsVoice: boolean;
-  contentType?: string;
-  fileName?: string;
-}): { useVoice: boolean } {
-  if (!opts.wantsVoice) return { useVoice: false };
-  if (
-    getCore().media.isVoiceCompatibleAudio({
-      contentType: opts.contentType,
-      fileName: opts.fileName,
-    })
-  ) {
-    return { useVoice: true };
-  }
-  return { useVoice: false };
-}