@cachly-dev/mcp-server 0.10.48 → 0.10.49

package/src/handlers/tco.ts

@@ -0,0 +1,347 @@
+/**
+ * Travel Chaos Organizer — MCP bridge.
+ *
+ * Exposes the TCO REST API as MCP tools so any Claude instance with cachly-mcp
+ * configured can manage travel plans through natural language.
+ *
+ * Auth: TCO and Cachly share the same Keycloak realm, so the Cachly JWT
+ * (CACHLY_JWT env var) is forwarded as-is to the TCO backend — no extra
+ * credentials needed.
+ *
+ * Config:
+ *   TCO_API_URL   — base URL of the TCO FastAPI backend (e.g. http://localhost:8000)
+ *                   If not set, all tools return a configuration error.
+ */
+
+const TCO_URL = process.env.TCO_API_URL ?? '';
+
+export const TCO_TOOL_NAMES = new Set([
+  'tco_list_trips',
+  'tco_create_trip',
+  'tco_get_timeline',
+  'tco_delete_trip',
+  'tco_inbox_list',
+  'tco_inbox_assign',
+  'tco_inbox_reject',
+  'tco_parse_url',
+  'tco_import_email',
+  'tco_parse_text',
+  'tco_cache_stats',
+  'tco_provision_cache',
+  'tco_telegram_status',
+  'tco_telegram_send',
+]);
+
+type TcoFetch = (path: string, jwt: string, init?: RequestInit) => Promise<unknown>;
+
+async function tcoFetch(path: string, jwt: string, init: RequestInit = {}): Promise<unknown> {
+  if (!TCO_URL) {
+    throw new Error(
+      'TCO_API_URL is not configured. Add `TCO_API_URL=http://<your-tco-host>:8000` to your environment.'
+    );
+  }
+  const res = await fetch(`${TCO_URL}${path}`, {
+    ...init,
+    headers: {
+      Authorization: `Bearer ${jwt}`,
+      'Content-Type': 'application/json',
+      ...(init.headers ?? {}),
+    },
+    signal: AbortSignal.timeout(20_000),
+  });
+
+  if (!res.ok) {
+    const text = await res.text().catch(() => '');
+    throw new Error(`TCO API ${res.status}: ${text}`);
+  }
+
+  const ct = res.headers.get('content-type') ?? '';
+  if (res.status === 204 || !ct.includes('application/json')) return null;
+  return res.json();
+}
+
+function noConfig(): string {
+  return (
+    '⚙️  **TCO not configured.**\n\n' +
+    'Set `TCO_API_URL=http://<host>:8000` in your environment and restart cachly-mcp.\n' +
+    'See `apps/travel-chaos-organizer/README.md` for setup instructions.'
+  );
+}
+
+function fmt(data: unknown): string {
+  return JSON.stringify(data, null, 2);
+}
+
+export async function handleTcoTool(
+  name: string,
+  args: Record<string, unknown>,
+  jwt: string,
+): Promise<string | null> {
+  if (!TCO_TOOL_NAMES.has(name)) return null;
+  if (!TCO_URL) return noConfig();
+
+  try {
+    switch (name) {
+
+      // ── List all trips ───────────────────────────────────────────────────
+      case 'tco_list_trips': {
+        const trips = await tcoFetch('/api/v1/trips', jwt);
+        const list = trips as Array<Record<string, unknown>>;
+        if (!list.length) return '📭 No trips yet. Use `tco_create_trip` to get started.';
+        const rows = list.map((t) => {
+          const dates = t.start_date
+            ? `${t.start_date}${t.end_date ? ` → ${t.end_date}` : ''}`
+            : 'no dates';
+          return `• **${t.name}** \`${t.id}\` — ${dates}`;
+        });
+        return `🗺️  **Your trips (${list.length}):**\n\n${rows.join('\n')}`;
+      }
+
+      // ── Create a trip ────────────────────────────────────────────────────
+      case 'tco_create_trip': {
+        const { name: tripName, description = null, start_date = null, end_date = null } = args as {
+          name: string; description?: string | null; start_date?: string | null; end_date?: string | null;
+        };
+        const trip = await tcoFetch('/api/v1/trips', jwt, {
+          method: 'POST',
+          body: JSON.stringify({ name: tripName, description, start_date, end_date }),
+        });
+        const t = trip as Record<string, unknown>;
+        return `✅ Trip **${t.name}** created (id: \`${t.id}\`)`;
+      }
+
+      // ── Get timeline for a trip ──────────────────────────────────────────
+      case 'tco_get_timeline': {
+        const { trip_id } = args as { trip_id: string };
+        const items = await tcoFetch(`/api/v1/trips/${trip_id}/items`, jwt);
+        const list = items as Array<Record<string, unknown>>;
+        if (!list.length) return `📂 Trip \`${trip_id}\` has no timeline items yet. Upload a document to get started.`;
+
+        const TYPE_ICONS: Record<string, string> = {
+          flight: '✈️', train: '🚂', bus: '🚌', hotel: '🏨',
+          rental_car: '🚗', activity: '🎡', transfer: '🚕', document: '📄', other: '📋',
+        };
+        const rows = list.map((i) => {
+          const icon = TYPE_ICONS[i.type as string] ?? '📋';
+          const time = i.event_at ? ` · ${(i.event_at as string).slice(0, 16).replace('T', ' ')}` : '';
+          const ref = i.booking_ref ? ` · #${i.booking_ref}` : '';
+          const provider = i.provider ? ` · ${i.provider}` : '';
+          return `${icon} **${i.title}**${time}${provider}${ref}`;
+        });
+        return `📅 **Timeline (${list.length} items):**\n\n${rows.join('\n')}`;
+      }
+
+      // ── Delete a trip ────────────────────────────────────────────────────
+      case 'tco_delete_trip': {
+        const { trip_id } = args as { trip_id: string };
+        await tcoFetch(`/api/v1/trips/${trip_id}`, jwt, { method: 'DELETE' });
+        return `🗑️ Trip \`${trip_id}\` deleted.`;
+      }
+
+      // ── Inbox: list pending items ────────────────────────────────────────
+      case 'tco_inbox_list': {
+        const status = (args.status as string | undefined) ?? 'pending';
+        const items = await tcoFetch(`/api/v1/inbox?status_filter=${status}`, jwt);
+        const list = items as Array<Record<string, unknown>>;
+        if (!list.length) return `🎉 Chaos inbox is empty (status: ${status}).`;
+        const rows = list.map((i) => {
+          const pd = i.parsed_data as Record<string, unknown> | null;
+          const title = (pd?.title as string | undefined) ?? '(no title)';
+          const src = (i.source as string | undefined) ?? 'unknown source';
+          return `• **${title}** \`${i.id}\` — from ${src}`;
+        });
+        return `📥 **Inbox (${list.length} ${status}):**\n\n${rows.join('\n')}\n\nUse \`tco_inbox_assign\` to move to a trip.`;
+      }
+
+      // ── Inbox: assign item to trip ───────────────────────────────────────
+      case 'tco_inbox_assign': {
+        const { inbox_id, trip_id, type = 'other' } = args as {
+          inbox_id: string; trip_id: string; type?: string;
+        };
+        const result = await tcoFetch(`/api/v1/inbox/${inbox_id}/assign`, jwt, {
+          method: 'POST',
+          body: JSON.stringify({ trip_id, type }),
+        });
+        const r = result as Record<string, unknown>;
+        return `✅ Inbox item assigned to trip. New timeline item id: \`${r.trip_item_id}\``;
+      }
+
+      // ── Inbox: reject / delete item ──────────────────────────────────────
+      case 'tco_inbox_reject': {
+        const { inbox_id } = args as { inbox_id: string };
+        await tcoFetch(`/api/v1/inbox/${inbox_id}`, jwt, { method: 'DELETE' });
+        return `🗑️ Inbox item \`${inbox_id}\` rejected and removed.`;
+      }
+
+      // ── Parse a public URL into a trip ───────────────────────────────────
+      case 'tco_parse_url': {
+        const { url, trip_id } = args as { url: string; trip_id?: string };
+        const body: Record<string, string> = { url };
+        if (trip_id) body.trip_id = trip_id;
+        const result = await tcoFetch('/api/v1/parse/url', jwt, {
+          method: 'POST',
+          body: JSON.stringify(body),
+        });
+        const r = result as Record<string, unknown>;
+        const confidence = typeof r.confidence === 'number' ? ` (confidence: ${Math.round(r.confidence * 100)}%)` : '';
+        const dest = trip_id ? `trip \`${trip_id}\`` : 'chaos inbox';
+        return `✅ URL parsed and saved to ${dest}${confidence}.\n\nParsed: ${fmt(r.parsed_data ?? r)}`;
+      }
+
+      // ── Import email text into inbox or trip ─────────────────────────────
+      case 'tco_import_email': {
+        const { raw_email, trip_id } = args as { raw_email: string; trip_id?: string };
+        const body: Record<string, string> = { raw_email };
+        if (trip_id) body.trip_id = trip_id;
+        const result = await tcoFetch('/api/v1/mail/import', jwt, {
+          method: 'POST',
+          body: JSON.stringify(body),
+        });
+        const r = result as Record<string, unknown>;
+        const dest = trip_id ? `trip \`${trip_id}\`` : 'chaos inbox';
+        return `✅ Email imported to ${dest}. Inbox id: \`${r.inbox_id ?? '?'}\``;
+      }
+
+      // ── Parse raw text via Ollama (Cachly-cached) ────────────────────────
+      case 'tco_parse_text': {
+        const { text, trip_id } = args as { text: string; trip_id?: string };
+        const params = new URLSearchParams();
+        params.set('raw_text', text);
+        if (trip_id) params.set('trip_id', trip_id);
+        const result = await tcoFetch('/api/v1/parse/text', jwt, {
+          method: 'POST',
+          body: params.toString(),
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        });
+        const r = result as Record<string, unknown>;
+        const parsed = r.parsed as Record<string, unknown> | undefined;
+        const cached = (r as Record<string, unknown>).cached;
+        const dest = trip_id ? `trip \`${trip_id}\`` : 'Chaos Inbox';
+        const cacheNote = cached ? ' ⚡ **(Cache Hit — kein AI-Call)**' : '';
+        const confidence = typeof parsed?.confidence === 'number'
+          ? ` (confidence: ${Math.round((parsed.confidence as number) * 100)}%)`
+          : '';
+        return `✅ Text geparst und in ${dest} gespeichert${confidence}${cacheNote}.\n\nParsed: ${fmt(parsed ?? r)}`;
+      }
+
+      // ── Cachly Redis cache stats ─────────────────────────────────────────
+      case 'tco_cache_stats': {
+        const stats = await tcoFetch('/api/v1/cache/stats', jwt) as Record<string, unknown>;
+        if (!stats.configured) {
+          return (
+            '📭 **Cachly Redis ist nicht verbunden.**\n\n' +
+            'Setze `CACHLY_REDIS_URL=redis://<host>:6379/0` in der TCO `.env` und deploye neu.\n' +
+            'Nutze `tco_provision_cache` um eine kostenlose Cachly-Instanz zu erstellen.'
+          );
+        }
+        const hits = stats.hits as number;
+        const misses = stats.misses as number;
+        const total = hits + misses;
+        const hitPct = total > 0 ? Math.round((hits / total) * 100) : 0;
+        const saved = hits > 0
+          ? `\n\n💡 **~${hits} AI-Calls eingespart** (jeder Cache Hit = kein Ollama-Aufruf).`
+          : '';
+        return (
+          `✅ **Cachly Redis — aktiv**\n\n` +
+          `| Metric | Wert |\n|--------|------|\n` +
+          `| Cache Hits | **${hits}** |\n` +
+          `| Cache Misses | ${misses} |\n` +
+          `| Hit Rate | **${hitPct}%** |\n` +
+          `| Gecachte Dokumente | ${stats.key_count} |\n` +
+          `| TTL | ${stats.ttl_days} Tage |` +
+          saved
+        );
+      }
+
+      // ── Provision a Cachly free instance for TCO ─────────────────────────
+      case 'tco_provision_cache': {
+        const CACHLY_API = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
+        const res = await fetch(`${CACHLY_API}/api/v1/instances`, {
+          method: 'POST',
+          headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify({ name: 'tco-cache', tier: 'free' }),
+          signal: AbortSignal.timeout(30_000),
+        });
+
+        if (!res.ok) {
+          const txt = await res.text().catch(() => '');
+          // Instance may already exist — try to fetch it
+          if (res.status === 409 || txt.includes('already')) {
+            const listRes = await fetch(`${CACHLY_API}/api/v1/instances`, {
+              headers: { Authorization: `Bearer ${jwt}` },
+            });
+            if (listRes.ok) {
+              const list = await listRes.json() as Array<Record<string, unknown>>;
+              const existing = list.find((i) => i.name === 'tco-cache');
+              if (existing) {
+                return (
+                  `ℹ️ **Instanz "tco-cache" existiert bereits.**\n\n` +
+                  `Redis URL: \`${existing.redis_url ?? existing.connection_string ?? '(siehe Cachly Dashboard)'}\`\n\n` +
+                  `Setze in der TCO \`.env\`:\n\`\`\`\nCACHLY_REDIS_URL=${existing.redis_url ?? existing.connection_string}\n\`\`\`\n` +
+                  `Dann: \`bash scripts/deploy.sh\``
+                );
+              }
+            }
+          }
+          throw new Error(`Cachly API ${res.status}: ${txt}`);
+        }
+
+        const instance = await res.json() as Record<string, unknown>;
+        const redisUrl = instance.redis_url ?? instance.connection_string ?? '';
+        return (
+          `🎉 **Cachly Redis Instanz erstellt!**\n\n` +
+          `Name: \`tco-cache\` (Free Tier, 25 MB)\n` +
+          `Redis URL: \`${redisUrl}\`\n\n` +
+          `**Setup (2 Schritte):**\n` +
+          `1. Füge zur TCO \`.env\` hinzu:\n\`\`\`\nCACHLY_REDIS_URL=${redisUrl}\n\`\`\`\n` +
+          `2. Neu deployen:\n\`\`\`bash\nbash scripts/deploy.sh\n\`\`\`\n\n` +
+          `Ab sofort werden alle Ollama Parse-Ergebnisse gecacht — kein zweiter AI-Call für dasselbe Dokument.`
+        );
+      }
+
+      // ── Telegram: check linked status ────────────────────────────────────
+      case 'tco_telegram_status': {
+        const me = await tcoFetch('/api/v1/users/me', jwt) as Record<string, unknown>;
+        const linked = me.telegram_linked === true;
+        if (linked) {
+          return (
+            `✅ **Telegram ist verknüpft.**\n\n` +
+            `Plan: ${me.plan === 'pro' ? '✦ Pro' : 'Free'}\n\n` +
+            `Du kannst mit \`tco_telegram_send\` direkt Nachrichten an den User senden.`
+          );
+        }
+        return (
+          `🔴 **Telegram nicht verknüpft.**\n\n` +
+          `Der User muss in der TCO-App unter *Einstellungen → Mit Telegram verknüpfen* einen PIN generieren ` +
+          `und diesen an @TCOBot senden (\`/link <PIN>\`).`
+        );
+      }
+
+      // ── Telegram: send message to user ───────────────────────────────────
+      case 'tco_telegram_send': {
+        const { message } = args as { message: string };
+        const me = await tcoFetch('/api/v1/users/me', jwt) as Record<string, unknown>;
+        if (!me.telegram_linked) {
+          return (
+            `🔴 **Telegram nicht verknüpft** — Nachricht wurde nicht gesendet.\n\n` +
+            `Nutze \`tco_telegram_status\` für Details zur Verknüpfung.`
+          );
+        }
+        await tcoFetch('/api/v1/users/telegram-notify', jwt, {
+          method: 'POST',
+          body: JSON.stringify({ message }),
+        });
+        return `✅ Telegram-Nachricht gesendet:\n\n> ${message.slice(0, 200)}${message.length > 200 ? '…' : ''}`;
+      }
+
+      default:
+        return null;
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return `❌ TCO error: ${msg}`;
+  }
+}