@worca/ui 0.9.0 → 0.11.0

package/server/integrations/index.js

@@ -0,0 +1,390 @@
+/**
+ * createIntegrations factory — boots enabled adapters, wires event fan-out
+ * and inbound command dispatch.
+ * @module integrations/index
+ */
+
+import { join } from 'node:path';
+import { createDiscordAdapter } from './adapters/discord.js';
+import { createSlackAdapter } from './adapters/slack.js';
+import { createTelegramAdapter } from './adapters/telegram.js';
+import { createWebhookOutAdapter } from './adapters/webhook_out.js';
+import { createAllowlistGuard } from './allowlist.js';
+import { createChatContext } from './chat_context.js';
+import { createControlHandlers } from './commands/control.js';
+import { createGlobalHandlers } from './commands/global.js';
+import { parseCommand } from './commands/parser.js';
+import { createProjectHandlers } from './commands/project.js';
+import { loadIntegrationsConfig } from './config-loader.js';
+import { createRateLimiter } from './rate_limiter.js';
+import { renderEvent } from './renderers.js';
+import { createRestClient } from './rest_client.js';
+import { verify } from './verify.js';
+
+/** Symbol used to pass raw request body through the stored event for HMAC verification. */
+export const RAW_BODY = Symbol('raw_body');
+
+const NO_OP_STUB = {
+  onEvent() {},
+  status() {
+    return { enabled: false };
+  },
+  strictInboxVerification: false,
+  secrets: [],
+};
+
+/**
+ * @param {{
+ *   port: number,
+ *   host?: string,
+ *   prefsDir: string,
+ *   configPath: string,
+ * }} opts
+ * @returns {{ onEvent, status, strictInboxVerification: boolean, secrets: string[] }}
+ */
+export function createIntegrations({
+  port,
+  host = '127.0.0.1',
+  prefsDir,
+  configPath,
+}) {
+  let cfg = loadIntegrationsConfig(configPath);
+  if (!cfg || !cfg.enabled) return NO_OP_STUB;
+
+  let secrets = _loadSecrets(cfg);
+  const integrationsDir = join(prefsDir, 'integrations');
+  const chatContext = createChatContext(
+    join(integrationsDir, 'chat_context.json'),
+  );
+  const restClient = createRestClient({ host, port });
+
+  const globalHandlers = createGlobalHandlers({
+    chatContext,
+    prefsDir,
+    restClient,
+  });
+  const projectHandlers = createProjectHandlers({ chatContext, restClient });
+  const controlHandlers = createControlHandlers({ chatContext, restClient });
+  const allHandlers = {
+    ...globalHandlers,
+    ...projectHandlers,
+    ...controlHandlers,
+  };
+
+  // Mutable adapter registry — keyed by adapter name
+  const adapterMap = new Map(); // name → { adapter, adapterCfg }
+  const rateLimiters = new Map();
+  let allowlist = createAllowlistGuard(_collectAllowedIds(cfg));
+
+  let invalidSigEvents = 0;
+  let lastEventAt = null;
+
+  // Boot initial adapters from config
+  for (const entry of _bootAdapters(cfg, integrationsDir)) {
+    _startEntry(entry);
+  }
+
+  function _startEntry({ adapter, adapterCfg }) {
+    adapterMap.set(adapter.name, { adapter, adapterCfg });
+    rateLimiters.set(
+      adapter.name,
+      createRateLimiter({ ratePerMin: adapterCfg.rate_limit_per_min ?? 20 }),
+    );
+    if (adapter.supportsInbound) {
+      adapter.onInbound((msg) => _handleInbound(msg));
+    }
+    adapter
+      .start()
+      .catch((err) =>
+        console.error(
+          `[integrations] ${adapter.name} start error:`,
+          err.message,
+        ),
+      );
+  }
+
+  async function _stopAdapter(name) {
+    const entry = adapterMap.get(name);
+    if (!entry) return;
+    try {
+      await entry.adapter.stop();
+    } catch (err) {
+      console.error(`[integrations] ${name} stop error:`, err.message);
+    }
+    adapterMap.delete(name);
+    rateLimiters.delete(name);
+  }
+
+  /**
+   * Hot-reload a single adapter: re-reads config, stops the old instance,
+   * boots a new one. No-op if the adapter's config section is missing/disabled.
+   */
+  async function reloadAdapter(name) {
+    cfg = loadIntegrationsConfig(configPath) || cfg;
+    if (!cfg.enabled) return;
+    secrets = _loadSecrets(cfg);
+    allowlist = createAllowlistGuard(_collectAllowedIds(cfg));
+
+    // Stop existing adapter — must complete before booting new one
+    await _stopAdapter(name);
+
+    // Boot new adapter from fresh config
+    const entries = _bootAdapters({ [name]: cfg[name] }, integrationsDir);
+    for (const entry of entries) {
+      _startEntry(entry);
+    }
+  }
+
+  /**
+   * Remove a single adapter: stops and unregisters it, refreshes config.
+   */
+  async function removeAdapter(name) {
+    await _stopAdapter(name);
+    cfg = loadIntegrationsConfig(configPath) || cfg;
+    secrets = _loadSecrets(cfg);
+    allowlist = createAllowlistGuard(_collectAllowedIds(cfg));
+  }
+
+  async function _handleInbound(msg) {
+    if (!allowlist.isAllowed({ platform: msg.platform, chatId: msg.chatId }))
+      return;
+
+    const parsed = parseCommand(msg.text);
+    if (!parsed) return;
+
+    const chatKey = `${msg.platform}:${msg.chatId}`;
+    const handler = allHandlers[parsed.command];
+    let reply;
+
+    if (!handler) {
+      reply = `Unknown command /${parsed.command}. Try /help.`;
+    } else {
+      try {
+        reply = await handler(chatKey, parsed.args);
+      } catch (err) {
+        console.error('[integrations] command error:', err.message);
+        reply = 'Internal error — try again.';
+      }
+    }
+
+    if (reply) await _sendReply(msg.platform, msg.chatId, reply);
+  }
+
+  async function _sendReply(platform, chatId, text) {
+    const entry = adapterMap.get(platform);
+    if (!entry) return;
+    const msg = {
+      title: null,
+      body: [{ kind: 'markdown', value: text }],
+      severity: 'info',
+    };
+    const rl = rateLimiters.get(platform);
+    if (rl) {
+      await rl.send(msg, (m) => entry.adapter.send(chatId, m));
+    } else {
+      await entry.adapter.send(chatId, msg);
+    }
+  }
+
+  function onEvent(stored) {
+    const rawBody = stored[RAW_BODY];
+    const sigHeader = stored.headers?.['x-worca-signature'];
+
+    if (secrets.length > 0) {
+      if (!rawBody || !verify(rawBody, sigHeader, secrets)) {
+        invalidSigEvents++;
+        return;
+      }
+    }
+
+    lastEventAt = new Date().toISOString();
+    const envelope = stored.envelope;
+
+    for (const [, { adapter, adapterCfg }] of adapterMap) {
+      const events = adapterCfg.events ?? [];
+      if (!events.includes(envelope?.event_type)) continue;
+
+      const chatId = String(adapterCfg.chat_id ?? adapterCfg.channel_id ?? '');
+      const chatKey = `${adapter.name}:${chatId}`;
+
+      if (chatContext.isMuted(chatKey)) {
+        chatContext.incrementMuted(chatKey);
+        continue;
+      }
+
+      const msg = renderEvent(envelope);
+      if (!msg) continue;
+
+      const rl = rateLimiters.get(adapter.name);
+      const sendFn = (m) => adapter.send(chatId, m);
+
+      if (rl) {
+        rl.send(msg, sendFn).catch((err) =>
+          console.error(
+            `[integrations] ${adapter.name} send error:`,
+            err.message,
+          ),
+        );
+      } else {
+        sendFn(msg).catch((err) =>
+          console.error(
+            `[integrations] ${adapter.name} send error:`,
+            err.message,
+          ),
+        );
+      }
+    }
+  }
+
+  function status() {
+    return {
+      enabled: true,
+      strict_inbox_verification: cfg.strict_inbox_verification ?? false,
+      secrets_configured: secrets.length,
+      adapters: [...adapterMap.values()].map(({ adapter }) => {
+        const conn = adapter.connectionState?.() ?? {
+          state: 'n/a',
+          error: null,
+        };
+        return {
+          name: adapter.name,
+          enabled: true,
+          persistent: adapter.persistent ?? false,
+          connection: conn.state,
+          connection_error: conn.error,
+          dropped_messages:
+            rateLimiters.get(adapter.name)?.getStats().dropped_messages ?? 0,
+          invalid_signature_events: invalidSigEvents,
+          last_event_at: lastEventAt,
+        };
+      }),
+      chats: _collectChatStatus(cfg, chatContext),
+    };
+  }
+
+  return {
+    onEvent,
+    status,
+    reloadAdapter,
+    removeAdapter,
+    /** @internal — used by detect endpoint to pause/resume adapter */
+    _getAdapter: (name) => adapterMap.get(name) ?? null,
+    strictInboxVerification: cfg.strict_inbox_verification ?? false,
+    secrets,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function _loadSecrets(cfg) {
+  const secrets = [];
+  if (cfg.webhook_secret_env) {
+    const val = process.env[cfg.webhook_secret_env];
+    if (val) secrets.push(val);
+  }
+  if (cfg.webhook_secrets_env) {
+    const val = process.env[cfg.webhook_secrets_env];
+    if (val) {
+      for (const s of val.split(',')) {
+        const trimmed = s.trim();
+        if (trimmed) secrets.push(trimmed);
+      }
+    }
+  }
+  return secrets;
+}
+
+function _bootAdapters(cfg, integrationsDir) {
+  const adapters = [];
+
+  if (cfg.telegram?.enabled) {
+    const token =
+      cfg.telegram.bot_token ||
+      process.env[cfg.telegram.bot_token_env || 'TELEGRAM_BOT_TOKEN'];
+    if (!token) {
+      console.warn('[integrations] telegram token not configured — skipping');
+    } else {
+      adapters.push({
+        adapter: createTelegramAdapter({
+          token,
+          cursorPath: join(integrationsDir, 'telegram.cursor'),
+        }),
+        adapterCfg: cfg.telegram,
+      });
+    }
+  }
+
+  if (cfg.discord?.enabled) {
+    const botToken =
+      cfg.discord.bot_token ||
+      process.env[cfg.discord.bot_token_env || 'DISCORD_BOT_TOKEN'];
+    if (!botToken) {
+      console.warn('[integrations] discord token not configured — skipping');
+    } else {
+      adapters.push({
+        adapter: createDiscordAdapter({
+          botToken,
+          channelId: cfg.discord.channel_id,
+        }),
+        adapterCfg: cfg.discord,
+      });
+    }
+  }
+
+  if (cfg.slack?.enabled) {
+    const webhookUrl =
+      cfg.slack.webhook_url ||
+      process.env[cfg.slack.webhook_url_env || 'SLACK_WEBHOOK_URL'];
+    if (!webhookUrl) {
+      console.warn(
+        '[integrations] slack webhook URL not configured — skipping',
+      );
+    } else {
+      adapters.push({
+        adapter: createSlackAdapter({ webhookUrl }),
+        adapterCfg: cfg.slack,
+      });
+    }
+  }
+
+  if (cfg.webhook_out?.enabled) {
+    const endpoints = cfg.webhook_out.endpoints ?? [];
+    if (endpoints.length > 0) {
+      const events = [...new Set(endpoints.flatMap((ep) => ep.events ?? []))];
+      adapters.push({
+        adapter: createWebhookOutAdapter({ endpoints }),
+        adapterCfg: { ...cfg.webhook_out, events },
+      });
+    }
+  }
+
+  return adapters;
+}
+
+function _collectAllowedIds(cfg) {
+  const ids = [];
+  if (cfg.telegram?.chat_id) ids.push(String(cfg.telegram.chat_id));
+  if (cfg.discord?.channel_id) ids.push(String(cfg.discord.channel_id));
+  if (cfg.slack?.chat_id) ids.push(String(cfg.slack.chat_id));
+  return ids;
+}
+
+function _collectChatStatus(cfg, chatContext) {
+  const chats = [];
+  if (cfg.telegram?.chat_id) {
+    const chatKey = `telegram:${cfg.telegram.chat_id}`;
+    const id = cfg.telegram.chat_id;
+    const state = chatContext.get(chatKey);
+    const masked = id.length > 6 ? `${id.slice(0, 3)}***${id.slice(-3)}` : id;
+    chats.push({
+      platform: 'telegram',
+      chat_id: masked,
+      active_project: state.active_project,
+      muted_until: state.mute_until,
+      muted_messages: state.muted_messages,
+    });
+  }
+  return chats;
+}

package/server/integrations/markdown.js

@@ -0,0 +1,220 @@
+/**
+ * Markdown-to-native format converters for chat adapter responses.
+ *
+ * Command handlers write responses in standard markdown. Each adapter
+ * converts to its native format before sending.
+ *
+ * @module integrations/markdown
+ */
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Escape HTML special characters in text (for Telegram HTML).
+ */
+function escHtml(text) {
+  return text
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+}
+
+/**
+ * Process a markdown string by extracting protected regions (code blocks and
+ * inline code) first, applying transformations to unprotected text, then
+ * restoring the protected regions.
+ *
+ * @param {string} md - Markdown input
+ * @param {(text: string) => string} transformText - Transform non-code text
+ * @param {(code: string) => string} transformCodeBlock - Transform ```block```
+ * @param {(code: string) => string} transformInlineCode - Transform `code`
+ * @returns {string}
+ */
+function processWithCodeProtection(
+  md,
+  transformText,
+  transformCodeBlock,
+  transformInlineCode,
+) {
+  const placeholders = [];
+  let idx = 0;
+
+  function placeholder(value) {
+    const key = `\x00PH${idx++}\x00`;
+    placeholders.push({ key, value });
+    return key;
+  }
+
+  // 1. Protect fenced code blocks (``` ... ```)
+  let result = md.replace(/```([\s\S]*?)```/g, (_match, code) => {
+    return placeholder(transformCodeBlock(code));
+  });
+
+  // 2. Protect inline code (` ... `)
+  result = result.replace(/`([^`]+)`/g, (_match, code) => {
+    return placeholder(transformInlineCode(code));
+  });
+
+  // 3. Transform the remaining (unprotected) text
+  result = transformText(result);
+
+  // 4. Restore placeholders
+  for (const { key, value } of placeholders) {
+    result = result.replace(key, value);
+  }
+
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Telegram HTML
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert standard markdown to Telegram HTML.
+ *
+ * Supports: bold, italic, code, code blocks, links, strikethrough.
+ * Escapes <, >, & in regular text before adding HTML tags.
+ *
+ * @param {string} md
+ * @returns {string}
+ */
+export function toTelegramHtml(md) {
+  if (!md) return '';
+
+  return processWithCodeProtection(
+    md,
+    // Transform regular text
+    (text) => {
+      // Escape HTML entities in regular text first
+      text = text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+      // Links: [text](url) → <a href="url">text</a>
+      text = text.replace(
+        /\[([^\]]+)\]\(([^)]+)\)/g,
+        (_m, label, url) => `<a href="${url}">${label}</a>`,
+      );
+      // Bold: **text** → <b>text</b>
+      text = text.replace(/\*\*(.+?)\*\*/g, '<b>$1</b>');
+      // Italic: *text* → <i>text</i>
+      text = text.replace(/\*(.+?)\*/g, '<i>$1</i>');
+      // Strikethrough: ~~text~~ → <s>text</s>
+      text = text.replace(/~~(.+?)~~/g, '<s>$1</s>');
+      return text;
+    },
+    // Code block: ```block``` → <pre>block</pre>
+    (code) => `<pre>${escHtml(code)}</pre>`,
+    // Inline code: `code` → <code>code</code>
+    (code) => `<code>${escHtml(code)}</code>`,
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Discord markdown (pass-through)
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert standard markdown to Discord markdown.
+ * Discord supports standard markdown natively, so this is a pass-through.
+ *
+ * @param {string} md
+ * @returns {string}
+ */
+export function toDiscordMarkdown(md) {
+  return md ?? '';
+}
+
+// ---------------------------------------------------------------------------
+// Slack mrkdwn
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert standard markdown to Slack mrkdwn format.
+ *
+ * Supports: bold, italic, code, code blocks, links, strikethrough.
+ *
+ * @param {string} md
+ * @returns {string}
+ */
+export function toSlackMrkdwn(md) {
+  if (!md) return '';
+
+  return processWithCodeProtection(
+    md,
+    // Transform regular text
+    (text) => {
+      // Links: [text](url) → <url|text>
+      // Match links carefully — url part uses a greedy match up to the closing )
+      text = text.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_m, label, url) => {
+        // Escape pipe characters in url and label
+        const safeUrl = url.replace(/\|/g, '%7C');
+        const safeLabel = label.replace(/\|/g, '\u2758');
+        return `<${safeUrl}|${safeLabel}>`;
+      });
+      // Italic (single *) BEFORE bold — we need to match single * that are NOT
+      // part of ** pairs. Convert italic first using a temp marker, then bold.
+      // Step 1: Convert bold **text** → placeholder
+      const boldParts = [];
+      let bIdx = 0;
+      text = text.replace(/\*\*(.+?)\*\*/g, (_m, content) => {
+        const key = `\x01B${bIdx++}\x01`;
+        boldParts.push({ key, content });
+        return key;
+      });
+      // Step 2: Convert remaining italic *text* → _text_
+      text = text.replace(/\*(.+?)\*/g, '_$1_');
+      // Step 3: Restore bold as Slack bold *text*
+      for (const { key, content } of boldParts) {
+        text = text.replace(key, `*${content}*`);
+      }
+      // Strikethrough: ~~text~~ → ~text~
+      text = text.replace(/~~(.+?)~~/g, '~$1~');
+      return text;
+    },
+    // Code blocks pass through as-is (``` is native in Slack)
+    (code) => `\`\`\`${code}\`\`\``,
+    // Inline code passes through as-is
+    (code) => `\`${code}\``,
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Plain text
+// ---------------------------------------------------------------------------
+
+/**
+ * Strip all markdown formatting and return plain text.
+ *
+ * @param {string} md
+ * @returns {string}
+ */
+export function toPlainText(md) {
+  if (!md) return '';
+
+  return processWithCodeProtection(
+    md,
+    // Transform regular text
+    (text) => {
+      // Links: [text](url) → text (url)
+      text = text.replace(
+        /\[([^\]]+)\]\(([^)]+)\)/g,
+        (_m, label, url) => `${label} (${url})`,
+      );
+      // Bold: **text** → text
+      text = text.replace(/\*\*(.+?)\*\*/g, '$1');
+      // Italic: *text* → text
+      text = text.replace(/\*(.+?)\*/g, '$1');
+      // Strikethrough: ~~text~~ → text
+      text = text.replace(/~~(.+?)~~/g, '$1');
+      return text;
+    },
+    // Code blocks: just the content
+    (code) => code,
+    // Inline code: just the content
+    (code) => code,
+  );
+}