@timmeck/brain-core 2.36.11 → 2.36.14

package/dist/notifications/telegram-provider.js

@@ -0,0 +1,78 @@
+/**
+ * Telegram Notification Provider — Bot Messages via grammy
+ *
+ * Einrichten:
+ *   1. Bot erstellen: https://t.me/BotFather → /newbot → Token kopieren
+ *   2. Chat ID finden: Nachricht an Bot senden, dann
+ *      https://api.telegram.org/bot<TOKEN>/getUpdates → chat.id
+ *   3. In .env:
+ *      TELEGRAM_BOT_TOKEN=...
+ *      TELEGRAM_CHAT_ID=...
+ */
+import { getLogger } from '../utils/logger.js';
+const PRIORITY_EMOJI = {
+    critical: '🔴',
+    high: '🟠',
+    medium: '🟡',
+    low: '🟢',
+};
+export class TelegramProvider {
+    name = 'telegram';
+    botToken;
+    chatId;
+    log = getLogger();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    bot = null;
+    sentCount = 0;
+    constructor(config = {}) {
+        this.botToken = config.botToken ?? process.env.TELEGRAM_BOT_TOKEN ?? null;
+        this.chatId = config.chatId ?? process.env.TELEGRAM_CHAT_ID ?? null;
+    }
+    async isAvailable() {
+        if (!this.botToken || !this.chatId)
+            return false;
+        try {
+            await this.getBot();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(notification) {
+        try {
+            const bot = await this.getBot();
+            const emoji = PRIORITY_EMOJI[notification.priority] ?? '⚪';
+            const text = [
+                `${emoji} *${this.escapeMarkdown(notification.title)}*`,
+                '',
+                this.escapeMarkdown(notification.message),
+                '',
+                `_${notification.event}_`,
+            ].join('\n');
+            await bot.api.sendMessage(this.chatId, text, { parse_mode: 'MarkdownV2' });
+            this.sentCount++;
+            return { provider: this.name, success: true };
+        }
+        catch (err) {
+            return { provider: this.name, success: false, error: err.message };
+        }
+    }
+    async shutdown() {
+        this.bot = null;
+    }
+    escapeMarkdown(text) {
+        return text.replace(/[_*[\]()~`>#+\-=|{}.!\\]/g, '\\$&');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async getBot() {
+        if (this.bot)
+            return this.bot;
+        // Dynamic import — grammy is optional (variable path avoids TS module resolution)
+        const modulePath = 'grammy';
+        const { Bot } = await import(/* webpackIgnore: true */ modulePath);
+        this.bot = new Bot(this.botToken);
+        return this.bot;
+    }
+}
+//# sourceMappingURL=telegram-provider.js.map

package/dist/notifications/telegram-provider.js.map

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

package/dist/plugin/__tests__/plugin-registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/plugin/__tests__/plugin-registry.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { PluginRegistry } from '../plugin-registry.js';
+function createMockContext(name) {
+    return {
+        dataDir: path.join(os.tmpdir(), 'brain-test-plugins', name),
+        log: {
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+            debug: vi.fn(),
+        },
+        callBrain: vi.fn().mockResolvedValue({}),
+        notify: vi.fn().mockResolvedValue(undefined),
+    };
+}
+describe('PluginRegistry', () => {
+    let tmpDir;
+    let registry;
+    beforeEach(() => {
+        tmpDir = path.join(os.tmpdir(), `brain-plugin-test-${Date.now()}`);
+        fs.mkdirSync(tmpDir, { recursive: true });
+        registry = new PluginRegistry(tmpDir);
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('creates plugin directory if it does not exist', () => {
+        const newDir = path.join(tmpDir, 'subdir');
+        const reg = new PluginRegistry(newDir);
+        expect(fs.existsSync(newDir)).toBe(true);
+    });
+    it('starts with no plugins', () => {
+        expect(registry.size).toBe(0);
+        expect(registry.list()).toEqual([]);
+        expect(registry.getRoutes()).toEqual([]);
+        expect(registry.getTools()).toEqual([]);
+    });
+    it('has() returns false for unknown plugin', () => {
+        expect(registry.has('nonexistent')).toBe(false);
+    });
+    it('get() returns null for unknown plugin', () => {
+        expect(registry.get('nonexistent')).toBeNull();
+    });
+    it('loadAll with empty directory loads nothing', async () => {
+        await registry.loadAll((name) => createMockContext(name));
+        expect(registry.size).toBe(0);
+    });
+    it('loadAll skips directories without package.json', async () => {
+        fs.mkdirSync(path.join(tmpDir, 'empty-dir'));
+        await registry.loadAll((name) => createMockContext(name));
+        expect(registry.size).toBe(0);
+    });
+    it('loadAll skips packages without brainPlugin flag', async () => {
+        const pluginDir = path.join(tmpDir, 'normal-pkg');
+        fs.mkdirSync(pluginDir);
+        fs.writeFileSync(path.join(pluginDir, 'package.json'), JSON.stringify({
+            name: 'normal-pkg',
+            version: '1.0.0',
+        }));
+        fs.writeFileSync(path.join(pluginDir, 'index.js'), 'module.exports = {}');
+        await registry.loadAll((name) => createMockContext(name));
+        expect(registry.size).toBe(0);
+    });
+    it('unloadPlugin returns false for unknown plugin', async () => {
+        expect(await registry.unloadPlugin('nonexistent')).toBe(false);
+    });
+    it('runCycle does nothing with no plugins', async () => {
+        await expect(registry.runCycle(1)).resolves.toBeUndefined();
+    });
+    it('list returns empty array when no plugins loaded', () => {
+        expect(registry.list()).toEqual([]);
+    });
+    it('getRoutes returns plugin-prefixed routes', () => {
+        // Manually inject a plugin for testing
+        const plugin = {
+            name: 'test-plugin',
+            version: '1.0.0',
+            routes: [
+                { method: 'test.hello', handler: () => ({ hello: 'world' }) },
+            ],
+        };
+        // Access internal map (testing only)
+        registry.plugins.set('test-plugin', {
+            plugin,
+            path: '/fake',
+            loadedAt: new Date().toISOString(),
+            error: null,
+        });
+        const routes = registry.getRoutes();
+        expect(routes).toHaveLength(1);
+        expect(routes[0].plugin).toBe('test-plugin');
+        expect(routes[0].method).toBe('test.hello');
+    });
+    it('getTools returns plugin-prefixed tools', () => {
+        const plugin = {
+            name: 'test-plugin',
+            version: '1.0.0',
+            tools: [
+                { name: 'test_tool', description: 'A test', schema: {}, handler: () => 'ok' },
+            ],
+        };
+        registry.plugins.set('test-plugin', {
+            plugin,
+            path: '/fake',
+            loadedAt: new Date().toISOString(),
+            error: null,
+        });
+        const tools = registry.getTools();
+        expect(tools).toHaveLength(1);
+        expect(tools[0].plugin).toBe('test-plugin');
+        expect(tools[0].name).toBe('test_tool');
+    });
+    it('runCycle calls onCycle for loaded plugins', async () => {
+        const onCycle = vi.fn();
+        const plugin = {
+            name: 'cycle-plugin',
+            version: '1.0.0',
+            onCycle,
+        };
+        registry.plugins.set('cycle-plugin', {
+            plugin,
+            path: '/fake',
+            loadedAt: new Date().toISOString(),
+            error: null,
+        });
+        await registry.runCycle(42);
+        expect(onCycle).toHaveBeenCalledWith(42);
+    });
+    it('runCycle catches errors from plugins', async () => {
+        const plugin = {
+            name: 'bad-plugin',
+            version: '1.0.0',
+            onCycle: () => { throw new Error('boom'); },
+        };
+        registry.plugins.set('bad-plugin', {
+            plugin,
+            path: '/fake',
+            loadedAt: new Date().toISOString(),
+            error: null,
+        });
+        // Should not throw
+        await expect(registry.runCycle(1)).resolves.toBeUndefined();
+    });
+    it('unloadPlugin calls onUnload and removes', async () => {
+        const onUnload = vi.fn();
+        const plugin = {
+            name: 'unload-test',
+            version: '1.0.0',
+            onUnload,
+        };
+        registry.plugins.set('unload-test', {
+            plugin,
+            path: '/fake',
+            loadedAt: new Date().toISOString(),
+            error: null,
+        });
+        expect(registry.has('unload-test')).toBe(true);
+        await registry.unloadPlugin('unload-test');
+        expect(registry.has('unload-test')).toBe(false);
+        expect(onUnload).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=plugin-registry.test.js.map

package/dist/plugin/__tests__/plugin-registry.test.js.map

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

package/dist/plugin/plugin-registry.d.ts

@@ -0,0 +1,38 @@
+import type { BrainPlugin, PluginContext, PluginRecord, PluginRouteDefinition, PluginToolDefinition } from './types.js';
+/**
+ * PluginRegistry — discovers, loads, and manages Brain plugins.
+ * Plugins are npm packages with `brainPlugin: true` in package.json,
+ * or local directories under ~/.brain/plugins/.
+ */
+export declare class PluginRegistry {
+    private plugins;
+    private logger;
+    private pluginDir;
+    constructor(pluginDir: string);
+    /** Load all plugins from the plugin directory. */
+    loadAll(contextFactory: (name: string) => PluginContext): Promise<void>;
+    /** Load a single plugin by directory path. */
+    loadPlugin(pluginPath: string, context: PluginContext): Promise<boolean>;
+    /** Unload a plugin by name. */
+    unloadPlugin(name: string): Promise<boolean>;
+    /** Run onCycle for all loaded plugins. */
+    runCycle(cycleCount: number): Promise<void>;
+    /** Get all registered IPC routes from plugins. */
+    getRoutes(): Array<{
+        plugin: string;
+    } & PluginRouteDefinition>;
+    /** Get all registered MCP tools from plugins. */
+    getTools(): Array<{
+        plugin: string;
+    } & PluginToolDefinition>;
+    /** List all plugins (loaded + discovered). */
+    list(): PluginRecord[];
+    /** Get a loaded plugin by name. */
+    get(name: string): BrainPlugin | null;
+    /** Check if a plugin is loaded. */
+    has(name: string): boolean;
+    /** Get plugin count. */
+    get size(): number;
+    /** Discover plugins in the plugin directory. */
+    private discoverPlugins;
+}

package/dist/plugin/plugin-registry.js

@@ -0,0 +1,185 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+/**
+ * PluginRegistry — discovers, loads, and manages Brain plugins.
+ * Plugins are npm packages with `brainPlugin: true` in package.json,
+ * or local directories under ~/.brain/plugins/.
+ */
+export class PluginRegistry {
+    plugins = new Map();
+    logger = getLogger();
+    pluginDir;
+    constructor(pluginDir) {
+        this.pluginDir = pluginDir;
+        fs.mkdirSync(pluginDir, { recursive: true });
+    }
+    /** Load all plugins from the plugin directory. */
+    async loadAll(contextFactory) {
+        const entries = this.discoverPlugins();
+        for (const entry of entries) {
+            try {
+                await this.loadPlugin(entry.path, contextFactory(entry.name));
+            }
+            catch (err) {
+                this.logger.error(`Failed to load plugin ${entry.name}: ${err.message}`);
+            }
+        }
+        this.logger.info(`Loaded ${this.plugins.size}/${entries.length} plugins`);
+    }
+    /** Load a single plugin by directory path. */
+    async loadPlugin(pluginPath, context) {
+        try {
+            const manifestPath = path.join(pluginPath, 'package.json');
+            if (!fs.existsSync(manifestPath)) {
+                this.logger.warn(`No package.json in ${pluginPath}`);
+                return false;
+            }
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+            if (!manifest.brainPlugin) {
+                this.logger.debug(`${manifest.name} is not a brain plugin (missing brainPlugin flag)`);
+                return false;
+            }
+            const mainFile = path.join(pluginPath, manifest.main || 'index.js');
+            if (!fs.existsSync(mainFile)) {
+                this.logger.error(`Plugin entry point not found: ${mainFile}`);
+                return false;
+            }
+            // Dynamic import
+            const mod = await import(`file://${mainFile.replace(/\\/g, '/')}`);
+            const plugin = mod.default ?? mod;
+            if (!plugin.name || !plugin.version) {
+                this.logger.error(`Plugin at ${pluginPath} missing name or version`);
+                return false;
+            }
+            // Prevent duplicate
+            if (this.plugins.has(plugin.name)) {
+                this.logger.warn(`Plugin ${plugin.name} already loaded, skipping duplicate`);
+                return false;
+            }
+            // Lifecycle: onLoad
+            if (plugin.onLoad) {
+                await plugin.onLoad(context);
+            }
+            this.plugins.set(plugin.name, {
+                plugin,
+                path: pluginPath,
+                loadedAt: new Date().toISOString(),
+                error: null,
+            });
+            this.logger.info(`Plugin loaded: ${plugin.name} v${plugin.version}`);
+            return true;
+        }
+        catch (err) {
+            this.logger.error(`Plugin load failed at ${pluginPath}: ${err.message}`);
+            return false;
+        }
+    }
+    /** Unload a plugin by name. */
+    async unloadPlugin(name) {
+        const loaded = this.plugins.get(name);
+        if (!loaded)
+            return false;
+        try {
+            if (loaded.plugin.onUnload) {
+                await loaded.plugin.onUnload();
+            }
+        }
+        catch (err) {
+            this.logger.error(`Error during ${name} unload: ${err.message}`);
+        }
+        this.plugins.delete(name);
+        this.logger.info(`Plugin unloaded: ${name}`);
+        return true;
+    }
+    /** Run onCycle for all loaded plugins. */
+    async runCycle(cycleCount) {
+        for (const [name, loaded] of this.plugins) {
+            if (loaded.plugin.onCycle) {
+                try {
+                    await loaded.plugin.onCycle(cycleCount);
+                }
+                catch (err) {
+                    this.logger.error(`Plugin ${name} cycle error: ${err.message}`);
+                }
+            }
+        }
+    }
+    /** Get all registered IPC routes from plugins. */
+    getRoutes() {
+        const routes = [];
+        for (const [name, loaded] of this.plugins) {
+            if (loaded.plugin.routes) {
+                for (const route of loaded.plugin.routes) {
+                    routes.push({ plugin: name, ...route });
+                }
+            }
+        }
+        return routes;
+    }
+    /** Get all registered MCP tools from plugins. */
+    getTools() {
+        const tools = [];
+        for (const [name, loaded] of this.plugins) {
+            if (loaded.plugin.tools) {
+                for (const tool of loaded.plugin.tools) {
+                    tools.push({ plugin: name, ...tool });
+                }
+            }
+        }
+        return tools;
+    }
+    /** List all plugins (loaded + discovered). */
+    list() {
+        const records = [];
+        for (const [, loaded] of this.plugins) {
+            records.push({
+                name: loaded.plugin.name,
+                version: loaded.plugin.version,
+                description: loaded.plugin.description ?? '',
+                enabled: true,
+                loadedAt: loaded.loadedAt,
+                error: loaded.error,
+            });
+        }
+        return records;
+    }
+    /** Get a loaded plugin by name. */
+    get(name) {
+        return this.plugins.get(name)?.plugin ?? null;
+    }
+    /** Check if a plugin is loaded. */
+    has(name) {
+        return this.plugins.has(name);
+    }
+    /** Get plugin count. */
+    get size() {
+        return this.plugins.size;
+    }
+    /** Discover plugins in the plugin directory. */
+    discoverPlugins() {
+        const results = [];
+        if (!fs.existsSync(this.pluginDir))
+            return results;
+        const entries = fs.readdirSync(this.pluginDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const pluginPath = path.join(this.pluginDir, entry.name);
+            const manifestPath = path.join(pluginPath, 'package.json');
+            if (fs.existsSync(manifestPath)) {
+                try {
+                    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+                    if (manifest.brainPlugin) {
+                        results.push({ name: manifest.name || entry.name, path: pluginPath });
+                    }
+                }
+                catch {
+                    // Invalid manifest, skip
+                }
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/plugin/plugin-registry.js.map

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

package/dist/plugin/types.d.ts

@@ -0,0 +1,59 @@
+export interface BrainPlugin {
+    /** Unique plugin name (e.g. 'weather-brain'). */
+    name: string;
+    /** SemVer version string. */
+    version: string;
+    /** Human-readable description. */
+    description?: string;
+    /** Called when plugin is loaded. Return services/state. */
+    onLoad?(context: PluginContext): Promise<void> | void;
+    /** Called when plugin is unloaded. Clean up resources. */
+    onUnload?(): Promise<void> | void;
+    /** Called on each learning cycle. */
+    onCycle?(cycleCount: number): Promise<void> | void;
+    /** MCP tools to register. */
+    tools?: PluginToolDefinition[];
+    /** IPC routes to register. */
+    routes?: PluginRouteDefinition[];
+}
+export interface PluginContext {
+    /** Data directory for this plugin (e.g. ~/.brain/plugins/weather-brain/). */
+    dataDir: string;
+    /** Logger scoped to this plugin. */
+    log: PluginLogger;
+    /** IPC client to communicate with Brain. */
+    callBrain(method: string, params?: unknown): Promise<unknown>;
+    /** Notify other brains via cross-brain. */
+    notify(event: string, data: unknown): Promise<void>;
+}
+export interface PluginLogger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+}
+export interface PluginToolDefinition {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+    handler: (params: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+export interface PluginRouteDefinition {
+    method: string;
+    handler: (params: unknown) => Promise<unknown> | unknown;
+}
+export interface PluginManifest {
+    name: string;
+    version: string;
+    description?: string;
+    main: string;
+    brainPlugin: true;
+}
+export interface PluginRecord {
+    name: string;
+    version: string;
+    description: string;
+    enabled: boolean;
+    loadedAt: string | null;
+    error: string | null;
+}

package/dist/plugin/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugin/types.ts"],"names":[],"mappings":""}

package/dist/research/adapters/__tests__/web-adapters.test.d.ts

@@ -0,0 +1 @@
+export {};