@xopcai/xopcbot 0.1.0

package/dist/plugins/__tests__/hooks.test.js

@@ -0,0 +1,159 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { HookRunner, isHookEvent } from '../hooks.js';
+// Mock PluginRegistry
+function createMockRegistry() {
+    const hooks = new Map();
+    return {
+        plugins: new Map(),
+        hooks,
+        channels: new Map(),
+        httpRoutes: new Map(),
+        commands: new Map(),
+        services: new Map(),
+        gatewayMethods: new Map(),
+        tools: new Map(),
+        getHooks(event) {
+            return hooks.get(event) || [];
+        },
+        getTool(name) {
+            return this.tools.get(name);
+        },
+        getAllTools() {
+            return Array.from(this.tools.values());
+        },
+        addTool(tool) {
+            this.tools.set(tool.name, tool);
+        },
+        getCommand(name) {
+            return this.commands.get(name);
+        },
+    };
+}
+describe('HookRunner', () => {
+    let registry;
+    let hookRunner;
+    beforeEach(() => {
+        registry = createMockRegistry();
+        hookRunner = new HookRunner(registry, {
+            catchErrors: false,
+            logger: {
+                info: vi.fn(),
+                warn: vi.fn(),
+                error: vi.fn(),
+            },
+        });
+    });
+    describe('getRegistry()', () => {
+        it('should return the plugin registry', () => {
+            const result = hookRunner.getRegistry();
+            expect(result).toBe(registry);
+        });
+        it('should allow getting hooks from registry', () => {
+            // Register a test hook
+            const testHandler = vi.fn();
+            registry.hooks.set('before_tool_call', [testHandler]);
+            const result = hookRunner.getRegistry().getHooks('before_tool_call');
+            expect(result).toHaveLength(1);
+            expect(result[0]).toBe(testHandler);
+        });
+    });
+    describe('runHooks()', () => {
+        it('should execute all registered hooks for an event', async () => {
+            const handler1 = vi.fn().mockResolvedValue(undefined);
+            const handler2 = vi.fn().mockResolvedValue(undefined);
+            registry.hooks.set('before_tool_call', [handler1, handler2]);
+            await hookRunner.runHooks('before_tool_call', { toolName: 'test' }, {});
+            expect(handler1).toHaveBeenCalledTimes(1);
+            expect(handler2).toHaveBeenCalledTimes(1);
+        });
+        it('should catch errors when catchErrors is true', async () => {
+            const errorHandler = vi.fn().mockRejectedValue(new Error('Test error'));
+            registry.hooks.set('before_tool_call', [errorHandler]);
+            // When catchErrors is true, errors are caught and logged
+            const runner = new HookRunner(registry, {
+                catchErrors: true,
+                logger: {
+                    info: vi.fn(),
+                    warn: vi.fn(),
+                    error: vi.fn(),
+                }
+            });
+            const result = await runner.runHooks('before_tool_call', { toolName: 'test' }, {});
+            expect(result.success).toBe(true);
+            expect(result.results).toHaveLength(1);
+            expect(result.results[0]).toEqual({
+                success: false,
+                error: 'Test error',
+            });
+        });
+        it('should throw when catchErrors is false', async () => {
+            const errorHandler = vi.fn().mockRejectedValue(new Error('Test error'));
+            registry.hooks.set('before_tool_call', [errorHandler]);
+            const runner = new HookRunner(registry, { catchErrors: false });
+            await expect(runner.runHooks('before_tool_call', { toolName: 'test' }, {})).rejects.toThrow('Test error');
+        });
+    });
+    describe('runBeforeToolCall()', () => {
+        it('should allow tool execution by default', async () => {
+            const result = await hookRunner.runBeforeToolCall('test_tool', { param: 'value' }, {});
+            expect(result.allowed).toBe(true);
+        });
+        it('should block tool when hook returns block: true', async () => {
+            const blockingHandler = vi.fn().mockResolvedValue({
+                block: true,
+                blockReason: 'Not allowed',
+            });
+            registry.hooks.set('before_tool_call', [blockingHandler]);
+            const result = await hookRunner.runBeforeToolCall('test_tool', { param: 'value' }, {});
+            expect(result.allowed).toBe(false);
+            expect(result.reason).toBe('Not allowed');
+        });
+        it('should modify params when hook returns params', async () => {
+            const modifyingHandler = vi.fn().mockResolvedValue({
+                params: { modified: 'value' },
+            });
+            registry.hooks.set('before_tool_call', [modifyingHandler]);
+            const result = await hookRunner.runBeforeToolCall('test_tool', { original: 'value' }, {});
+            expect(result.params).toEqual({ modified: 'value' });
+        });
+    });
+    describe('runMessageSending()', () => {
+        it('should send message by default', async () => {
+            const result = await hookRunner.runMessageSending('chat123', 'Hello', {});
+            expect(result.send).toBe(true);
+            expect(result.content).toBe('Hello');
+        });
+        it('should cancel message when hook returns cancel: true', async () => {
+            const cancelHandler = vi.fn().mockResolvedValue({
+                cancel: true,
+                cancelReason: 'Content filtered',
+            });
+            registry.hooks.set('message_sending', [cancelHandler]);
+            const result = await hookRunner.runMessageSending('chat123', 'Hello', {});
+            expect(result.send).toBe(false);
+            expect(result.reason).toBe('Content filtered');
+        });
+        it('should modify content when hook returns content', async () => {
+            const modifyHandler = vi.fn().mockResolvedValue({
+                content: 'Modified content',
+            });
+            registry.hooks.set('message_sending', [modifyHandler]);
+            const result = await hookRunner.runMessageSending('chat123', 'Original', {});
+            expect(result.content).toBe('Modified content');
+        });
+    });
+});
+describe('isHookEvent', () => {
+    it('should return true for valid hook events', () => {
+        expect(isHookEvent('before_agent_start')).toBe(true);
+        expect(isHookEvent('message_received')).toBe(true);
+        expect(isHookEvent('before_tool_call')).toBe(true);
+        expect(isHookEvent('session_end')).toBe(true);
+    });
+    it('should return false for invalid hook events', () => {
+        expect(isHookEvent('invalid_event')).toBe(false);
+        expect(isHookEvent('')).toBe(false);
+        expect(isHookEvent('before_invalid')).toBe(false);
+    });
+});
+//# sourceMappingURL=hooks.test.js.map

package/dist/plugins/__tests__/hooks.test.js.map

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

package/dist/plugins/__tests__/loader.test.d.ts

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

package/dist/plugins/__tests__/loader.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { PluginLoader, normalizePluginConfig } from '../loader.js';
+describe('PluginLoader', () => {
+    describe('normalizePluginConfig()', () => {
+        it('should normalize enabled plugins', () => {
+            const config = {
+                enabled: ['plugin-a', 'plugin-b'],
+                'plugin-a': { setting: 'value' },
+            };
+            const result = normalizePluginConfig(config);
+            expect(result).toHaveLength(2);
+            expect(result[0]).toEqual({
+                id: 'plugin-a',
+                origin: 'config',
+                path: 'plugin-a',
+                enabled: true,
+                config: { setting: 'value' },
+            });
+            expect(result[1]).toEqual({
+                id: 'plugin-b',
+                origin: 'config',
+                path: 'plugin-b',
+                enabled: true,
+                config: {},
+            });
+        });
+        it('should handle disabled plugins', () => {
+            const config = {
+                enabled: ['plugin-a'],
+                disabled: ['plugin-b'],
+            };
+            const result = normalizePluginConfig(config);
+            expect(result).toHaveLength(2);
+            expect(result[0].enabled).toBe(true);
+            expect(result[1].enabled).toBe(false);
+        });
+        it('should handle boolean plugin config', () => {
+            const config = {
+                enabled: ['plugin-a', 'plugin-b'],
+                'plugin-a': true,
+                'plugin-b': { setting: 'value' },
+            };
+            const result = normalizePluginConfig(config);
+            expect(result[0].config).toBe(true);
+            expect(result[1].config).toEqual({ setting: 'value' });
+        });
+        it('should handle empty config', () => {
+            const result = normalizePluginConfig({});
+            expect(result).toHaveLength(0);
+        });
+    });
+    describe('getRegistry()', () => {
+        let loader;
+        beforeEach(() => {
+            loader = new PluginLoader({
+                workspaceDir: '/tmp/workspace',
+                pluginsDir: '/tmp/workspace/.plugins',
+            });
+        });
+        it('should return a PluginRegistry', () => {
+            const registry = loader.getRegistry();
+            expect(registry).toBeDefined();
+            expect(typeof registry.addTool).toBe('function');
+            expect(typeof registry.getTool).toBe('function');
+            expect(typeof registry.getAllTools).toBe('function');
+        });
+        it('should allow adding and retrieving tools', () => {
+            const registry = loader.getRegistry();
+            const tool = {
+                name: 'test_tool',
+                description: 'A test tool',
+                parameters: { type: 'object' },
+                execute: async () => 'result',
+            };
+            registry.addTool(tool);
+            expect(registry.getTool('test_tool')).toEqual(tool);
+            expect(registry.getAllTools()).toHaveLength(1);
+        });
+    });
+});
+describe('PluginRegistry (via PluginLoader)', () => {
+    let loader;
+    beforeEach(() => {
+        loader = new PluginLoader();
+    });
+    describe('getCommand()', () => {
+        it('should return undefined for non-existent command', () => {
+            const registry = loader.getRegistry();
+            const command = registry.getCommand('non_existent');
+            expect(command).toBeUndefined();
+        });
+        it('should store and retrieve commands', () => {
+            const registry = loader.getRegistry();
+            const command = {
+                name: 'test',
+                description: 'Test command',
+                handler: async () => ({ content: 'result' }),
+            };
+            registry.commands.set('test', command);
+            expect(registry.getCommand('test')).toEqual(command);
+        });
+    });
+    describe('httpRoutes', () => {
+        it('should store and retrieve HTTP routes', () => {
+            const registry = loader.getRegistry();
+            const handler = async () => { };
+            registry.httpRoutes.set('/test', handler);
+            expect(registry.httpRoutes.get('/test')).toBe(handler);
+        });
+    });
+    describe('gatewayMethods', () => {
+        it('should store and retrieve gateway methods', () => {
+            const registry = loader.getRegistry();
+            const handler = async () => 'result';
+            registry.gatewayMethods.set('test.method', handler);
+            expect(registry.gatewayMethods.get('test.method')).toBe(handler);
+        });
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/plugins/__tests__/loader.test.js.map

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

package/dist/plugins/api.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Plugin API Implementation
+ */
+import type { ChannelPlugin, GatewayMethodHandler, HttpRequestHandler, PluginApi, PluginCommand, PluginLogger, PluginService, PluginTool, PluginRegistry } from './types.js';
+import type { Config } from '../types/index.js';
+import { EventEmitter } from 'events';
+export declare class PluginApiImpl implements PluginApi {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string | undefined;
+    readonly source: string;
+    readonly config: Config;
+    readonly pluginConfig: Record<string, unknown>;
+    private readonly _logger;
+    private readonly _resolvePath;
+    private readonly _registry?;
+    private _tools;
+    private _hooks;
+    private _eventBus;
+    constructor(id: string, name: string, version: string | undefined, source: string, config: Config, pluginConfig: Record<string, unknown>, _logger: PluginLogger, _resolvePath: (input: string) => string, _registry?: PluginRegistry);
+    get logger(): PluginLogger;
+    registerTool(tool: PluginTool): void;
+    registerHook(event: string, handler: Function, opts?: {
+        priority?: number;
+        once?: boolean;
+    }): void;
+    registerChannel(channel: ChannelPlugin): void;
+    registerHttpRoute(path: string, handler: HttpRequestHandler): void;
+    registerCommand(command: PluginCommand): void;
+    registerService(service: PluginService): void;
+    registerGatewayMethod(method: string, handler: GatewayMethodHandler): void;
+    resolvePath(input: string): string;
+    emit(event: string, data: unknown): void;
+    on(event: string, handler: (data: unknown) => void): void;
+    off(event: string, handler: (data: unknown) => void): void;
+    _getTools(): Map<string, PluginTool>;
+    _getHooks(): Map<string, Set<Function>>;
+    _getEventBus(): EventEmitter;
+}
+export declare function createPluginLogger(prefix: string): PluginLogger;
+export declare function createPathResolver(pluginDir: string, workspaceDir: string): (input: string) => string;

package/dist/plugins/api.js

@@ -0,0 +1,131 @@
+/**
+ * Plugin API Implementation
+ */
+import { resolve, isAbsolute } from 'path';
+import { EventEmitter } from 'events';
+import { createLogger } from '../utils/logger.js';
+export class PluginApiImpl {
+    id;
+    name;
+    version;
+    source;
+    config;
+    pluginConfig;
+    _logger;
+    _resolvePath;
+    _registry;
+    _tools = new Map();
+    _hooks = new Map();
+    _eventBus = new EventEmitter();
+    constructor(id, name, version, source, config, pluginConfig, _logger, _resolvePath, _registry) {
+        this.id = id;
+        this.name = name;
+        this.version = version;
+        this.source = source;
+        this.config = config;
+        this.pluginConfig = pluginConfig;
+        this._logger = _logger;
+        this._resolvePath = _resolvePath;
+        this._registry = _registry;
+    }
+    get logger() {
+        return this._logger;
+    }
+    registerTool(tool) {
+        if (this._tools.has(tool.name)) {
+            this._logger.warn(`Tool ${tool.name} already registered, overwriting`);
+        }
+        this._tools.set(tool.name, tool);
+        // Sync to registry if available
+        if (this._registry) {
+            this._registry.addTool(tool);
+        }
+        this._logger.info(`Registered tool: ${tool.name}`);
+    }
+    registerHook(event, handler, opts) {
+        if (!this._hooks.has(event)) {
+            this._hooks.set(event, new Set());
+        }
+        this._hooks.get(event).add(handler);
+        if (opts?.once) {
+            const wrapper = async (...args) => {
+                await handler(...args);
+                this._hooks.get(event)?.delete(wrapper);
+            };
+            this._hooks.get(event).add(wrapper);
+        }
+        this._logger.info(`Registered hook: ${event}`);
+    }
+    registerChannel(channel) {
+        this._eventBus.emit('channel:register', channel);
+        this._logger.info(`Registered channel: ${channel.name}`);
+    }
+    registerHttpRoute(path, handler) {
+        this._eventBus.emit('http:route', { path, handler });
+        this._logger.info(`Registered HTTP route: ${path}`);
+    }
+    registerCommand(command) {
+        this._eventBus.emit('command:register', command);
+        this._logger.info(`Registered command: /${command.name}`);
+    }
+    registerService(service) {
+        this._eventBus.emit('service:register', service);
+        this._logger.info(`Registered service: ${service.id}`);
+    }
+    registerGatewayMethod(method, handler) {
+        this._eventBus.emit('gateway:method', { method, handler });
+        this._logger.info(`Registered gateway method: ${method}`);
+    }
+    resolvePath(input) {
+        return this._resolvePath(input);
+    }
+    emit(event, data) {
+        this._eventBus.emit(event, data);
+    }
+    on(event, handler) {
+        this._eventBus.on(event, handler);
+    }
+    off(event, handler) {
+        this._eventBus.off(event, handler);
+    }
+    // Internal methods for plugin manager
+    _getTools() {
+        return this._tools;
+    }
+    _getHooks() {
+        return this._hooks;
+    }
+    _getEventBus() {
+        return this._eventBus;
+    }
+}
+// ============================================================================
+// Default Logger
+// ============================================================================
+export function createPluginLogger(prefix) {
+    const childLogger = createLogger(`Plugin:${prefix}`);
+    return {
+        debug: (msg) => childLogger.debug(msg),
+        info: (msg) => childLogger.info(msg),
+        warn: (msg) => childLogger.warn(msg),
+        error: (msg) => childLogger.error(msg),
+    };
+}
+// ============================================================================
+// Path Resolver
+// ============================================================================
+export function createPathResolver(pluginDir, workspaceDir) {
+    return (input) => {
+        if (input.startsWith('~')) {
+            return input.replace('~', process.env.HOME || '');
+        }
+        if (input.startsWith('.')) {
+            return resolve(pluginDir, input);
+        }
+        if (!isAbsolute(input)) {
+            return resolve(workspaceDir, input);
+        }
+        return input;
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/plugins/api.js.map

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

package/dist/plugins/hooks.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Plugin Hook System
+ */
+import type { PluginHookEvent, PluginRegistry } from './types.js';
+export interface HookContext {
+    timestamp?: Date;
+    pluginId?: string;
+    sessionKey?: string;
+    agentId?: string;
+}
+export interface BeforeAgentStartContext extends HookContext {
+    prompt: string;
+    messages?: unknown[];
+}
+export interface BeforeAgentStartResult {
+    systemPrompt?: string;
+    prependContext?: string;
+}
+export interface AgentEndContext extends HookContext {
+    messages: unknown[];
+    success: boolean;
+    error?: string;
+    durationMs?: number;
+}
+export interface BeforeCompactionContext extends HookContext {
+    messageCount: number;
+    tokenCount?: number;
+}
+export interface AfterCompactionContext extends HookContext {
+    messageCount: number;
+    tokenCount?: number;
+    compactedCount: number;
+}
+export interface MessageReceivedContext extends HookContext {
+    channelId: string;
+    from: string;
+    content: string;
+    timestamp?: Date;
+    metadata?: Record<string, unknown>;
+}
+export interface MessageSendingContext extends HookContext {
+    to: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MessageSendingResult {
+    content?: string;
+    cancel?: boolean;
+    cancelReason?: string;
+}
+export interface MessageSentContext extends HookContext {
+    to: string;
+    content: string;
+    success: boolean;
+    error?: string;
+}
+export interface BeforeToolCallContext extends HookContext {
+    toolName: string;
+    params: Record<string, unknown>;
+}
+export interface BeforeToolCallResult {
+    params?: Record<string, unknown>;
+    block?: boolean;
+    blockReason?: string;
+}
+export interface AfterToolCallContext extends HookContext {
+    toolName: string;
+    params: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    durationMs?: number;
+}
+export interface SessionStartContext extends HookContext {
+    sessionId: string;
+    resumedFrom?: string;
+}
+export interface SessionEndContext extends HookContext {
+    sessionId: string;
+    messageCount: number;
+    durationMs?: number;
+}
+export interface GatewayStartContext extends HookContext {
+    port: number;
+    host: string;
+}
+export interface GatewayStopContext extends HookContext {
+    reason?: string;
+}
+export type HookHandlerMap = {
+    before_agent_start: (event: BeforeAgentStartContext, ctx: HookContext) => Promise<BeforeAgentStartResult | void> | BeforeAgentStartResult | void;
+    agent_end: (event: AgentEndContext, ctx: HookContext) => Promise<void> | void;
+    before_compaction: (event: BeforeCompactionContext, ctx: HookContext) => Promise<void> | void;
+    after_compaction: (event: AfterCompactionContext, ctx: HookContext) => Promise<void> | void;
+    message_received: (event: MessageReceivedContext, ctx: HookContext) => Promise<void> | void;
+    message_sending: (event: MessageSendingContext, ctx: HookContext) => Promise<MessageSendingResult | void> | MessageSendingResult | void;
+    message_sent: (event: MessageSentContext, ctx: HookContext) => Promise<void> | void;
+    before_tool_call: (event: BeforeToolCallContext, ctx: HookContext) => Promise<BeforeToolCallResult | void> | BeforeToolCallResult | void;
+    after_tool_call: (event: AfterToolCallContext, ctx: HookContext) => Promise<void> | void;
+    session_start: (event: SessionStartContext, ctx: HookContext) => Promise<void> | void;
+    session_end: (event: SessionEndContext, ctx: HookContext) => Promise<void> | void;
+    gateway_start: (event: GatewayStartContext, ctx: HookContext) => Promise<void> | void;
+    gateway_stop: (event: GatewayStopContext, ctx: HookContext) => Promise<void> | void;
+};
+export interface HookRunnerOptions {
+    /** If true, errors in hooks will be caught and logged instead of thrown */
+    catchErrors?: boolean;
+    /** Default logger */
+    logger?: HookLogger;
+}
+export interface HookLogger {
+    debug?: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+export declare class HookRunner {
+    private registry;
+    private options;
+    constructor(registry: PluginRegistry, options?: HookRunnerOptions);
+    /**
+     * Get the plugin registry
+     */
+    getRegistry(): PluginRegistry;
+    /**
+     * Execute hooks for a specific event
+     */
+    runHooks<K extends PluginHookEvent>(event: K, eventData: unknown, context: HookContext): Promise<{
+        success: boolean;
+        results: unknown[];
+    }>;
+    /**
+     * Execute hooks and return modified event data
+     */
+    runHooksWithResult<K extends PluginHookEvent>(event: K, eventData: BeforeAgentStartContext, context: HookContext): Promise<BeforeAgentStartContext>;
+    /**
+     * Execute before_tool_call hooks and potentially block the call
+     */
+    runBeforeToolCall(toolName: string, params: Record<string, unknown>, context: HookContext): Promise<{
+        allowed: boolean;
+        params?: Record<string, unknown>;
+        reason?: string;
+    }>;
+    /**
+     * Execute message_sending hooks and potentially cancel or modify
+     */
+    runMessageSending(to: string, content: string, context: HookContext): Promise<{
+        send: boolean;
+        content?: string;
+        reason?: string;
+    }>;
+}
+export declare function createHookContext(overrides?: Partial<HookContext>): HookContext;
+export declare function isHookEvent(value: string): value is PluginHookEvent;