@timmeck/brain-core 2.36.38 → 2.36.40

package/dist/messaging/message-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.js","sourceRoot":"","sources":["../../src/messaging/message-router.ts"],"names":[],"mappings":"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"}

package/dist/messaging/telegram-bot.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Telegram Bot — Bidirektionaler Message-Handler
+ *
+ * Empfängt Nachrichten via grammy Long Polling, routet sie durch
+ * den MessageRouter und sendet die Antwort zurück.
+ *
+ * Voraussetzungen:
+ *   npm install grammy (optional dependency)
+ *   TELEGRAM_BOT_TOKEN in .env
+ *   TELEGRAM_CHAT_ID in .env (optional: beschränkt auf einen Chat)
+ */
+import type { MessageRouter } from './message-router.js';
+export interface TelegramBotConfig {
+    botToken?: string;
+    /** If set, only respond in this chat. */
+    chatId?: string;
+    /** Allowed user IDs (if empty, all allowed). */
+    allowedUsers?: string[];
+}
+export interface TelegramBotStatus {
+    running: boolean;
+    messagesReceived: number;
+    messagesSent: number;
+    errors: number;
+    startedAt: number | null;
+}
+export declare class TelegramBot {
+    private readonly log;
+    private readonly botToken;
+    private readonly chatId;
+    private readonly allowedUsers;
+    private bot;
+    private router;
+    private running;
+    private stats;
+    constructor(config?: TelegramBotConfig);
+    /** Set the message router for dispatching incoming messages. */
+    setRouter(router: MessageRouter): void;
+    /** Check if Telegram bot can start. */
+    isConfigured(): boolean;
+    /** Start listening for messages. */
+    start(): Promise<void>;
+    /** Stop the bot. */
+    stop(): Promise<void>;
+    /** Get bot status. */
+    getStatus(): TelegramBotStatus;
+    private escapeHtml;
+}

package/dist/messaging/telegram-bot.js

@@ -0,0 +1,133 @@
+/**
+ * Telegram Bot — Bidirektionaler Message-Handler
+ *
+ * Empfängt Nachrichten via grammy Long Polling, routet sie durch
+ * den MessageRouter und sendet die Antwort zurück.
+ *
+ * Voraussetzungen:
+ *   npm install grammy (optional dependency)
+ *   TELEGRAM_BOT_TOKEN in .env
+ *   TELEGRAM_CHAT_ID in .env (optional: beschränkt auf einen Chat)
+ */
+import { getLogger } from '../utils/logger.js';
+export class TelegramBot {
+    log = getLogger();
+    botToken;
+    chatId;
+    allowedUsers;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    bot = null;
+    router = null;
+    running = false;
+    stats = {
+        messagesReceived: 0,
+        messagesSent: 0,
+        errors: 0,
+        startedAt: null,
+    };
+    constructor(config = {}) {
+        this.botToken = config.botToken ?? process.env.TELEGRAM_BOT_TOKEN ?? null;
+        this.chatId = config.chatId ?? process.env.TELEGRAM_CHAT_ID ?? null;
+        this.allowedUsers = new Set(config.allowedUsers ?? []);
+    }
+    /** Set the message router for dispatching incoming messages. */
+    setRouter(router) {
+        this.router = router;
+    }
+    /** Check if Telegram bot can start. */
+    isConfigured() {
+        return !!this.botToken;
+    }
+    /** Start listening for messages. */
+    async start() {
+        if (!this.botToken) {
+            this.log.debug('[TelegramBot] No TELEGRAM_BOT_TOKEN set, skipping');
+            return;
+        }
+        if (this.running)
+            return;
+        try {
+            const modulePath = 'grammy';
+            const { Bot } = await import(/* webpackIgnore: true */ modulePath);
+            this.bot = new Bot(this.botToken);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.bot.on('message:text', async (ctx) => {
+                try {
+                    const senderId = String(ctx.from?.id ?? '');
+                    const senderName = ctx.from?.first_name ?? ctx.from?.username ?? 'unknown';
+                    const chatId = String(ctx.chat?.id ?? '');
+                    // Chat filter
+                    if (this.chatId && chatId !== this.chatId)
+                        return;
+                    // User filter
+                    if (this.allowedUsers.size > 0 && !this.allowedUsers.has(senderId)) {
+                        await ctx.reply('Zugriff verweigert.');
+                        return;
+                    }
+                    this.stats.messagesReceived++;
+                    if (!this.router) {
+                        await ctx.reply('MessageRouter nicht konfiguriert.');
+                        return;
+                    }
+                    const response = await this.router.route({
+                        text: ctx.message.text,
+                        senderId,
+                        senderName,
+                        platform: 'telegram',
+                        channelId: chatId,
+                    });
+                    if (response.code) {
+                        await ctx.reply(`<pre>${this.escapeHtml(response.text)}</pre>`, { parse_mode: 'HTML' });
+                    }
+                    else {
+                        await ctx.reply(response.text);
+                    }
+                    this.stats.messagesSent++;
+                }
+                catch (err) {
+                    this.stats.errors++;
+                    this.log.warn(`[TelegramBot] Error handling message: ${err.message}`);
+                    try {
+                        await ctx.reply('Interner Fehler.');
+                    }
+                    catch { /* best effort */ }
+                }
+            });
+            // Start polling (non-blocking)
+            this.bot.start({
+                onStart: () => {
+                    this.log.info('[TelegramBot] Bot started, listening for messages');
+                },
+            });
+            this.running = true;
+            this.stats.startedAt = Date.now();
+        }
+        catch (err) {
+            this.log.warn(`[TelegramBot] Failed to start: ${err.message}`);
+        }
+    }
+    /** Stop the bot. */
+    async stop() {
+        if (this.bot && this.running) {
+            try {
+                await this.bot.stop();
+            }
+            catch { /* best effort */ }
+            this.running = false;
+        }
+    }
+    /** Get bot status. */
+    getStatus() {
+        return {
+            running: this.running,
+            messagesReceived: this.stats.messagesReceived,
+            messagesSent: this.stats.messagesSent,
+            errors: this.stats.errors,
+            startedAt: this.stats.startedAt,
+        };
+    }
+    escapeHtml(text) {
+        return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    }
+}
+//# sourceMappingURL=telegram-bot.js.map

package/dist/messaging/telegram-bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-bot.js","sourceRoot":"","sources":["../../src/messaging/telegram-bot.ts"],"names":[],"mappings":"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"}

package/dist/observability/index.d.ts

@@ -0,0 +1,2 @@
+export { TraceCollector, runTraceMigration } from './trace-collector.js';
+export type { Trace, Span, TraceTree, TraceStats, TraceListOptions, TraceCollectorStatus, } from './trace-collector.js';

package/dist/observability/index.js

@@ -0,0 +1,2 @@
+export { TraceCollector, runTraceMigration } from './trace-collector.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/observability/trace-collector.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Trace Collector — Observability für das Brain Ecosystem
+ *
+ * Inspiriert von OpenTelemetry / LangSmith Tracing.
+ * Erfasst Spans (Arbeitseinheiten) in hierarchischen Traces,
+ * speichert sie in SQLite und berechnet Latenz-Statistiken.
+ *
+ * Usage:
+ * ```typescript
+ * const traceId = collector.startTrace('research-cycle');
+ * const spanId = collector.startSpan(traceId, 'llm-call', { template: 'explain' });
+ * // ... do work ...
+ * collector.endSpan(spanId, { tokens: 150, cost: 0.001 });
+ * collector.endTrace(traceId);
+ * ```
+ */
+import type Database from 'better-sqlite3';
+export interface Trace {
+    id: string;
+    name: string;
+    status: 'running' | 'completed' | 'error';
+    startedAt: number;
+    endedAt: number | null;
+    durationMs: number | null;
+    spanCount: number;
+    totalTokens: number;
+    totalCost: number;
+    metadata: Record<string, unknown>;
+    error?: string;
+}
+export interface Span {
+    id: string;
+    traceId: string;
+    parentSpanId: string | null;
+    name: string;
+    status: 'running' | 'completed' | 'error';
+    startedAt: number;
+    endedAt: number | null;
+    durationMs: number | null;
+    tokens: number;
+    cost: number;
+    metadata: Record<string, unknown>;
+    error?: string;
+}
+export interface TraceTree {
+    trace: Trace;
+    spans: Span[];
+}
+export interface TraceStats {
+    totalTraces: number;
+    totalSpans: number;
+    totalTokens: number;
+    totalCost: number;
+    avgDurationMs: number;
+    p50DurationMs: number;
+    p99DurationMs: number;
+    tracesByName: Record<string, number>;
+    activeTraces: number;
+}
+export interface TraceListOptions {
+    limit?: number;
+    offset?: number;
+    name?: string;
+    status?: 'running' | 'completed' | 'error';
+    since?: number;
+}
+export interface TraceCollectorStatus {
+    totalTraces: number;
+    activeTraces: number;
+    totalSpans: number;
+    totalTokens: number;
+    totalCost: number;
+}
+export declare function runTraceMigration(db: Database.Database): void;
+export declare class TraceCollector {
+    private db;
+    private readonly log;
+    private stmtInsertTrace;
+    private stmtInsertSpan;
+    private stmtEndTrace;
+    private stmtEndSpan;
+    private stmtUpdateTraceStats;
+    constructor(db: Database.Database);
+    /** Start a new trace. Returns trace ID. */
+    startTrace(name: string, metadata?: Record<string, unknown>): string;
+    /** End a trace (complete or error). */
+    endTrace(traceId: string, error?: string): void;
+    /** Start a span within a trace. Returns span ID. */
+    startSpan(traceId: string, name: string, options?: {
+        parentSpanId?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    /** End a span with optional results. */
+    endSpan(spanId: string, result?: {
+        tokens?: number;
+        cost?: number;
+        error?: string;
+    }): void;
+    /** Get a single trace with all its spans. */
+    getTrace(traceId: string): TraceTree | null;
+    /** List traces with optional filters. */
+    listTraces(options?: TraceListOptions): Trace[];
+    /** Get aggregate statistics. */
+    getStats(): TraceStats;
+    /** Get collector status (lightweight). */
+    getStatus(): TraceCollectorStatus;
+    /** Delete traces older than maxAgeDays. Returns number pruned. */
+    prune(maxAgeDays?: number): number;
+    private mapTrace;
+    private mapSpan;
+}

package/dist/observability/trace-collector.js

@@ -0,0 +1,303 @@
+/**
+ * Trace Collector — Observability für das Brain Ecosystem
+ *
+ * Inspiriert von OpenTelemetry / LangSmith Tracing.
+ * Erfasst Spans (Arbeitseinheiten) in hierarchischen Traces,
+ * speichert sie in SQLite und berechnet Latenz-Statistiken.
+ *
+ * Usage:
+ * ```typescript
+ * const traceId = collector.startTrace('research-cycle');
+ * const spanId = collector.startSpan(traceId, 'llm-call', { template: 'explain' });
+ * // ... do work ...
+ * collector.endSpan(spanId, { tokens: 150, cost: 0.001 });
+ * collector.endTrace(traceId);
+ * ```
+ */
+import { randomUUID } from 'node:crypto';
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runTraceMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS workflow_traces (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'running',
+      started_at INTEGER NOT NULL,
+      ended_at INTEGER,
+      duration_ms INTEGER,
+      span_count INTEGER NOT NULL DEFAULT 0,
+      total_tokens INTEGER NOT NULL DEFAULT 0,
+      total_cost REAL NOT NULL DEFAULT 0,
+      metadata TEXT DEFAULT '{}',
+      error TEXT,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_traces_name ON workflow_traces(name);
+    CREATE INDEX IF NOT EXISTS idx_traces_status ON workflow_traces(status);
+    CREATE INDEX IF NOT EXISTS idx_traces_started ON workflow_traces(started_at);
+
+    CREATE TABLE IF NOT EXISTS trace_spans (
+      id TEXT PRIMARY KEY,
+      trace_id TEXT NOT NULL,
+      parent_span_id TEXT,
+      name TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'running',
+      started_at INTEGER NOT NULL,
+      ended_at INTEGER,
+      duration_ms INTEGER,
+      tokens INTEGER NOT NULL DEFAULT 0,
+      cost REAL NOT NULL DEFAULT 0,
+      metadata TEXT DEFAULT '{}',
+      error TEXT,
+      FOREIGN KEY (trace_id) REFERENCES workflow_traces(id) ON DELETE CASCADE
+    );
+    CREATE INDEX IF NOT EXISTS idx_spans_trace ON trace_spans(trace_id);
+    CREATE INDEX IF NOT EXISTS idx_spans_parent ON trace_spans(parent_span_id);
+  `);
+}
+// ── Collector ───────────────────────────────────────────
+export class TraceCollector {
+    db;
+    log = getLogger();
+    stmtInsertTrace;
+    stmtInsertSpan;
+    stmtEndTrace;
+    stmtEndSpan;
+    stmtUpdateTraceStats;
+    constructor(db) {
+        this.db = db;
+        runTraceMigration(db);
+        this.stmtInsertTrace = db.prepare(`INSERT INTO workflow_traces (id, name, status, started_at, metadata)
+       VALUES (?, ?, 'running', ?, ?)`);
+        this.stmtInsertSpan = db.prepare(`INSERT INTO trace_spans (id, trace_id, parent_span_id, name, status, started_at, metadata)
+       VALUES (?, ?, ?, ?, 'running', ?, ?)`);
+        this.stmtEndTrace = db.prepare(`UPDATE workflow_traces SET status = ?, ended_at = ?, duration_ms = ?, error = ?
+       WHERE id = ?`);
+        this.stmtEndSpan = db.prepare(`UPDATE trace_spans SET status = ?, ended_at = ?, duration_ms = ?, tokens = ?, cost = ?, error = ?
+       WHERE id = ?`);
+        this.stmtUpdateTraceStats = db.prepare(`UPDATE workflow_traces SET
+         span_count = (SELECT COUNT(*) FROM trace_spans WHERE trace_id = ?),
+         total_tokens = (SELECT COALESCE(SUM(tokens), 0) FROM trace_spans WHERE trace_id = ?),
+         total_cost = (SELECT COALESCE(SUM(cost), 0) FROM trace_spans WHERE trace_id = ?)
+       WHERE id = ?`);
+        this.log.debug('[TraceCollector] Initialized');
+    }
+    // ── Trace Lifecycle ─────────────────────────────────
+    /** Start a new trace. Returns trace ID. */
+    startTrace(name, metadata = {}) {
+        const id = randomUUID();
+        const now = Date.now();
+        try {
+            this.stmtInsertTrace.run(id, name, now, JSON.stringify(metadata));
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to start trace: ${e.message}`);
+        }
+        return id;
+    }
+    /** End a trace (complete or error). */
+    endTrace(traceId, error) {
+        const now = Date.now();
+        try {
+            const trace = this.db.prepare('SELECT started_at FROM workflow_traces WHERE id = ?').get(traceId);
+            const duration = trace ? now - trace.started_at : 0;
+            const status = error ? 'error' : 'completed';
+            // Update aggregate stats from spans
+            this.stmtUpdateTraceStats.run(traceId, traceId, traceId, traceId);
+            this.stmtEndTrace.run(status, now, duration, error ?? null, traceId);
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to end trace: ${e.message}`);
+        }
+    }
+    // ── Span Lifecycle ──────────────────────────────────
+    /** Start a span within a trace. Returns span ID. */
+    startSpan(traceId, name, options) {
+        const id = randomUUID();
+        const now = Date.now();
+        try {
+            this.stmtInsertSpan.run(id, traceId, options?.parentSpanId ?? null, name, now, JSON.stringify(options?.metadata ?? {}));
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to start span: ${e.message}`);
+        }
+        return id;
+    }
+    /** End a span with optional results. */
+    endSpan(spanId, result) {
+        const now = Date.now();
+        try {
+            const span = this.db.prepare('SELECT started_at FROM trace_spans WHERE id = ?').get(spanId);
+            const duration = span ? now - span.started_at : 0;
+            const status = result?.error ? 'error' : 'completed';
+            this.stmtEndSpan.run(status, now, duration, result?.tokens ?? 0, result?.cost ?? 0, result?.error ?? null, spanId);
+        }
+        catch (e) {
+            this.log.warn(`[TraceCollector] Failed to end span: ${e.message}`);
+        }
+    }
+    // ── Queries ─────────────────────────────────────────
+    /** Get a single trace with all its spans. */
+    getTrace(traceId) {
+        try {
+            const row = this.db.prepare('SELECT * FROM workflow_traces WHERE id = ?').get(traceId);
+            if (!row)
+                return null;
+            const spans = this.db.prepare('SELECT * FROM trace_spans WHERE trace_id = ? ORDER BY started_at').all(traceId);
+            return {
+                trace: this.mapTrace(row),
+                spans: spans.map(s => this.mapSpan(s)),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List traces with optional filters. */
+    listTraces(options = {}) {
+        const { limit = 50, offset = 0, name, status, since } = options;
+        try {
+            const conditions = [];
+            const params = [];
+            if (name) {
+                conditions.push('name = ?');
+                params.push(name);
+            }
+            if (status) {
+                conditions.push('status = ?');
+                params.push(status);
+            }
+            if (since) {
+                conditions.push('started_at >= ?');
+                params.push(since);
+            }
+            const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+            const sql = `SELECT * FROM workflow_traces ${where} ORDER BY started_at DESC LIMIT ? OFFSET ?`;
+            params.push(limit, offset);
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map(r => this.mapTrace(r));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get aggregate statistics. */
+    getStats() {
+        try {
+            const totals = this.db.prepare(`
+        SELECT
+          COUNT(*) as total_traces,
+          COALESCE(SUM(span_count), 0) as total_spans,
+          COALESCE(SUM(total_tokens), 0) as total_tokens,
+          COALESCE(SUM(total_cost), 0) as total_cost,
+          COALESCE(AVG(duration_ms), 0) as avg_duration
+        FROM workflow_traces
+        WHERE status != 'running'
+      `).get();
+            const active = this.db.prepare("SELECT COUNT(*) as count FROM workflow_traces WHERE status = 'running'").get();
+            // P50 / P99 from completed traces
+            const durations = this.db.prepare("SELECT duration_ms FROM workflow_traces WHERE status = 'completed' AND duration_ms IS NOT NULL ORDER BY duration_ms").all();
+            const p50 = durations.length > 0
+                ? durations[Math.floor(durations.length * 0.5)]?.duration_ms ?? 0
+                : 0;
+            const p99 = durations.length > 0
+                ? durations[Math.floor(durations.length * 0.99)]?.duration_ms ?? 0
+                : 0;
+            // Traces by name
+            const byName = this.db.prepare('SELECT name, COUNT(*) as count FROM workflow_traces GROUP BY name').all();
+            const tracesByName = {};
+            for (const row of byName) {
+                tracesByName[row.name] = row.count;
+            }
+            return {
+                totalTraces: totals.total_traces ?? 0,
+                totalSpans: totals.total_spans ?? 0,
+                totalTokens: totals.total_tokens ?? 0,
+                totalCost: totals.total_cost ?? 0,
+                avgDurationMs: Math.round(totals.avg_duration ?? 0),
+                p50DurationMs: p50,
+                p99DurationMs: p99,
+                tracesByName,
+                activeTraces: active.count,
+            };
+        }
+        catch {
+            return {
+                totalTraces: 0, totalSpans: 0, totalTokens: 0, totalCost: 0,
+                avgDurationMs: 0, p50DurationMs: 0, p99DurationMs: 0,
+                tracesByName: {}, activeTraces: 0,
+            };
+        }
+    }
+    /** Get collector status (lightweight). */
+    getStatus() {
+        try {
+            const row = this.db.prepare(`
+        SELECT
+          COUNT(*) as total,
+          SUM(CASE WHEN status = 'running' THEN 1 ELSE 0 END) as active,
+          COALESCE(SUM(span_count), 0) as spans,
+          COALESCE(SUM(total_tokens), 0) as tokens,
+          COALESCE(SUM(total_cost), 0) as cost
+        FROM workflow_traces
+      `).get();
+            return {
+                totalTraces: row.total ?? 0,
+                activeTraces: row.active ?? 0,
+                totalSpans: row.spans ?? 0,
+                totalTokens: row.tokens ?? 0,
+                totalCost: row.cost ?? 0,
+            };
+        }
+        catch {
+            return { totalTraces: 0, activeTraces: 0, totalSpans: 0, totalTokens: 0, totalCost: 0 };
+        }
+    }
+    /** Delete traces older than maxAgeDays. Returns number pruned. */
+    prune(maxAgeDays = 30) {
+        try {
+            const cutoff = Date.now() - maxAgeDays * 86_400_000;
+            // Delete spans first (FK constraint)
+            this.db.prepare('DELETE FROM trace_spans WHERE trace_id IN (SELECT id FROM workflow_traces WHERE started_at < ? AND status != ?)').run(cutoff, 'running');
+            const result = this.db.prepare('DELETE FROM workflow_traces WHERE started_at < ? AND status != ?').run(cutoff, 'running');
+            return result.changes;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ── Private ─────────────────────────────────────────
+    mapTrace(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            status: row.status,
+            startedAt: row.started_at,
+            endedAt: row.ended_at,
+            durationMs: row.duration_ms,
+            spanCount: row.span_count,
+            totalTokens: row.total_tokens,
+            totalCost: row.total_cost,
+            metadata: JSON.parse(row.metadata || '{}'),
+            error: row.error,
+        };
+    }
+    mapSpan(row) {
+        return {
+            id: row.id,
+            traceId: row.trace_id,
+            parentSpanId: row.parent_span_id,
+            name: row.name,
+            status: row.status,
+            startedAt: row.started_at,
+            endedAt: row.ended_at,
+            durationMs: row.duration_ms,
+            tokens: row.tokens,
+            cost: row.cost,
+            metadata: JSON.parse(row.metadata || '{}'),
+            error: row.error,
+        };
+    }
+}
+//# sourceMappingURL=trace-collector.js.map

package/dist/observability/trace-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-collector.js","sourceRoot":"","sources":["../../src/observability/trace-collector.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/brain-core",
-  "version": "2.36.38",
+  "version": "2.36.40",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",