@xopcai/xopcbot 0.1.0

package/dist/plugins/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * xopcbot Plugin System - Core Types
+ *
+ * A lightweight plugin system inspired by OpenClaw.
+ */
+import type { Config } from '../types/index.js';
+export interface PluginDefinition {
+    /** Unique plugin identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Plugin description */
+    description?: string;
+    /** Plugin version */
+    version?: string;
+    /** Plugin kind */
+    kind?: PluginKind;
+    /** Configuration schema (JSON Schema) */
+    configSchema?: Record<string, unknown>;
+    /** Register hook - called when plugin is registered */
+    register?: (api: PluginApi) => void | Promise<void>;
+    /** Activate hook - called when plugin is enabled */
+    activate?: (api: PluginApi) => void | Promise<void>;
+    /** Deactivate hook - called when plugin is disabled */
+    deactivate?: (api: PluginApi) => void | Promise<void>;
+}
+export type PluginKind = 'channel' | 'provider' | 'memory' | 'tool' | 'utility';
+export type PluginModule = PluginDefinition | ((api: PluginApi) => void | Promise<void>);
+export interface PluginApi {
+    /** Plugin ID */
+    readonly id: string;
+    /** Plugin name */
+    readonly name: string;
+    /** Plugin version */
+    readonly version?: string;
+    /** Plugin source path */
+    readonly source: string;
+    /** Runtime configuration */
+    readonly config: Config;
+    /** Plugin-specific configuration */
+    readonly pluginConfig: Record<string, unknown>;
+    /** Logger instance */
+    readonly logger: PluginLogger;
+    registerTool(tool: PluginTool): void;
+    registerHook(event: PluginHookEvent, handler: PluginHookHandler, opts?: HookOptions): 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;
+}
+export interface PluginTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (params: Record<string, unknown>) => Promise<string>;
+}
+export interface PluginToolContext {
+    agentId?: string;
+    sessionKey?: string;
+    workspaceDir?: string;
+    sandboxed?: boolean;
+}
+export type PluginHookEvent = 'before_agent_start' | 'agent_end' | 'before_compaction' | 'after_compaction' | 'message_received' | 'message_sending' | 'message_sent' | 'before_tool_call' | 'after_tool_call' | 'session_start' | 'session_end' | 'gateway_start' | 'gateway_stop';
+export type PluginHookHandler = (event: unknown, context: unknown) => Promise<unknown> | unknown;
+export interface HookOptions {
+    priority?: number;
+    once?: boolean;
+}
+export interface ChannelPlugin {
+    name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(message: OutboundMessage): Promise<void>;
+    isRunning(): boolean;
+}
+export interface OutboundMessage {
+    channel: string;
+    chat_id: string;
+    content: string;
+}
+export interface HttpRequestHandler {
+    (req: HttpRequest, res: HttpResponse): Promise<void> | void;
+}
+export interface HttpRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+}
+export interface HttpResponse {
+    status(code: number): HttpResponse;
+    json(data: unknown): HttpResponse;
+    send(data: string): HttpResponse;
+}
+export interface PluginCommand {
+    name: string;
+    description: string;
+    acceptsArgs?: boolean;
+    requireAuth?: boolean;
+    handler: (args: string, context: CommandContext) => Promise<CommandResult> | CommandResult;
+}
+export interface CommandContext {
+    senderId?: string;
+    channel: string;
+    isAuthorized: boolean;
+    config: Config;
+}
+export interface CommandResult {
+    content: string;
+    success?: boolean;
+}
+export interface PluginService {
+    id: string;
+    start(context: ServiceContext): void | Promise<void>;
+    stop?(context: ServiceContext): void | Promise<void>;
+}
+export interface ServiceContext {
+    config: Config;
+    workspaceDir: string;
+    stateDir: string;
+    logger: PluginLogger;
+}
+export interface GatewayMethodHandler {
+    (params: Record<string, unknown>, context: GatewayContext): Promise<unknown> | unknown;
+}
+export interface GatewayContext {
+    senderId?: string;
+    channel?: string;
+    isAuthorized: boolean;
+}
+export interface PluginLogger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export interface PluginRegistry {
+    plugins: Map<string, PluginRecord>;
+    hooks: Map<PluginHookEvent, PluginHookHandler[]>;
+    channels: Map<string, ChannelPlugin>;
+    httpRoutes: Map<string, HttpRequestHandler>;
+    commands: Map<string, PluginCommand>;
+    services: Map<string, PluginService>;
+    gatewayMethods: Map<string, GatewayMethodHandler>;
+    tools: Map<string, PluginTool>;
+    getHooks(event: PluginHookEvent): PluginHookHandler[];
+    getTool(name: string): PluginTool | undefined;
+    getAllTools(): PluginTool[];
+    addTool(tool: PluginTool): void;
+    getCommand(name: string): PluginCommand | undefined;
+}
+export interface PluginRecord {
+    definition: PluginDefinition;
+    module: PluginModule;
+    source: string;
+    enabled: boolean;
+    loaded: boolean;
+}
+export interface PluginManifest {
+    id: string;
+    name: string;
+    description?: string;
+    version?: string;
+    kind?: PluginKind;
+    main?: string;
+    configSchema?: Record<string, unknown>;
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+}
+export type PluginOrigin = 'bundled' | 'global' | 'workspace' | 'config';
+export interface PluginsConfig {
+    enabled: string[];
+    disabled: string[];
+    autoLoad: boolean;
+}
+export interface ResolvedPluginsConfig {
+    plugins: ResolvedPluginConfig[];
+}
+export interface ResolvedPluginConfig {
+    id: string;
+    origin: PluginOrigin;
+    path: string;
+    enabled: boolean;
+    config: Record<string, unknown>;
+}

package/dist/plugins/types.js

@@ -0,0 +1,7 @@
+/**
+ * xopcbot Plugin System - Core Types
+ *
+ * A lightweight plugin system inspired by OpenClaw.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

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

package/dist/providers/__tests__/registry.test.d.ts

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

package/dist/providers/__tests__/registry.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { ModelRegistry } from '../registry.js';
+// Mock pi-ai module
+vi.mock('@mariozechner/pi-ai', async () => {
+    const actual = await vi.importActual('@mariozechner/pi-ai');
+    return {
+        ...actual,
+        getProviders: vi.fn(() => ['google', 'minimax']),
+        getModels: vi.fn((provider) => {
+            if (provider === 'google') {
+                return [
+                    { id: 'gemini-2.5-flash', provider: 'google', api: 'google-generative-ai' },
+                    { id: 'gemini-2.5-pro', provider: 'google', api: 'google-generative-ai' },
+                ];
+            }
+            if (provider === 'minimax') {
+                // Note: pi-ai uses uppercase 'MiniMax-M2.1' format
+                return [
+                    { id: 'MiniMax-M2', provider: 'minimax', api: 'anthropic-messages' },
+                    { id: 'MiniMax-M2.1', provider: 'minimax', api: 'anthropic-messages' },
+                ];
+            }
+            return [];
+        }),
+    };
+});
+describe('ModelRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new ModelRegistry(null, { ollamaEnabled: false });
+    });
+    describe('loadBuiltInModels', () => {
+        it('should load models from pi-ai', () => {
+            const all = registry.getAll();
+            expect(all.length).toBeGreaterThan(0);
+        });
+        it('should have correct provider and id format from pi-ai', () => {
+            const models = registry.getAll();
+            const minimaxModels = models.filter(m => m.provider === 'minimax');
+            // pi-ai returns uppercase format
+            expect(minimaxModels).toContainEqual(expect.objectContaining({ id: 'MiniMax-M2.1', provider: 'minimax' }));
+        });
+    });
+    describe('find', () => {
+        it('should find google model by exact match', () => {
+            const model = registry.find('google', 'gemini-2.5-flash');
+            expect(model).toBeDefined();
+            expect(model?.id).toBe('gemini-2.5-flash');
+        });
+        it('should return undefined for non-existent model', () => {
+            const model = registry.find('google', 'non-existent');
+            expect(model).toBeUndefined();
+        });
+    });
+    describe('findByRef', () => {
+        it('should find by provider/model format (google)', () => {
+            const model = registry.findByRef('google/gemini-2.5-flash');
+            expect(model).toBeDefined();
+            expect(model?.id).toBe('gemini-2.5-flash');
+        });
+        it('should find by provider/model format (minimax - case insensitive)', () => {
+            // BUG FIX: user passes 'minimax/minimax-m2.1' and pi-ai has 'MiniMax-M2.1'
+            // Now works with case-insensitive matching
+            const model = registry.findByRef('minimax/minimax-m2.1');
+            expect(model).toBeDefined();
+            expect(model?.id).toBe('MiniMax-M2.1');
+            expect(model?.provider).toBe('minimax');
+        });
+        it('should find with various case combinations', () => {
+            // All these should find the same model
+            const variants = [
+                'minimax/MiniMax-M2.1',
+                'minimax/minimax-m2.1',
+                'MINIMAX/MINIMAX-M2.1',
+                'Minimax/Minimax-M2.1',
+            ];
+            for (const ref of variants) {
+                const model = registry.findByRef(ref);
+                expect(model, `Should find model for ref: ${ref}`).toBeDefined();
+                expect(model?.id).toBe('MiniMax-M2.1');
+            }
+        });
+        it('should find by exact case (current workaround)', () => {
+            // Current workaround: use exact case from pi-ai
+            const model = registry.findByRef('minimax/MiniMax-M2.1');
+            expect(model).toBeDefined();
+            expect(model?.id).toBe('MiniMax-M2.1');
+        });
+        it('should find by model id only (fallback)', () => {
+            // When no slash, should match any provider with that model id
+            const model = registry.findByRef('MiniMax-M2.1');
+            expect(model).toBeDefined();
+            expect(model?.id).toBe('MiniMax-M2.1');
+        });
+    });
+    describe('model loading verification', () => {
+        it('should verify pi-ai models are loaded correctly', () => {
+            const models = registry.getAll();
+            // Check google models
+            expect(models.some(m => m.provider === 'google' && m.id === 'gemini-2.5-flash')).toBe(true);
+            // Check minimax models (note the case)
+            expect(models.some(m => m.provider === 'minimax' && m.id === 'MiniMax-M2.1')).toBe(true);
+        });
+        it('should handle empty config gracefully', () => {
+            const emptyRegistry = new ModelRegistry(null, { ollamaEnabled: false });
+            expect(emptyRegistry.getAll().length).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/providers/__tests__/registry.test.js.map

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

package/dist/providers/api-strategies.d.ts

@@ -0,0 +1,15 @@
+/**
+ * API Strategy Patterns
+ *
+ * Encapsulates provider-specific API options building
+ * to eliminate scattered if-else chains in pi-ai.ts
+ */
+import type { ApiStrategy, ApiStrategyOptions } from './types.js';
+/**
+ * Get API strategy for the given API type
+ */
+export declare function getApiStrategy(apiType: string): ApiStrategy;
+/**
+ * Build provider-specific options
+ */
+export declare function buildProviderOptions(apiType: string, opts: ApiStrategyOptions): Record<string, unknown>;

package/dist/providers/api-strategies.js

@@ -0,0 +1,96 @@
+/**
+ * API Strategy Patterns
+ *
+ * Encapsulates provider-specific API options building
+ * to eliminate scattered if-else chains in pi-ai.ts
+ */
+/**
+ * Anthropic Messages API Strategy
+ * Supports thinking/reasoning mode
+ */
+const anthropicStrategy = {
+    buildOptions(opts) {
+        const options = {};
+        if (opts.reasoning) {
+            options.thinkingEnabled = true;
+            options.thinkingBudgetTokens = opts.maxTokens
+                ? Math.min(opts.maxTokens, opts.modelMaxTokens)
+                : opts.modelMaxTokens;
+        }
+        return options;
+    },
+};
+/**
+ * Google Generative AI Strategy
+ */
+const googleStrategy = {
+    buildOptions(opts) {
+        const options = {};
+        if (opts.reasoning) {
+            options.thinking = {
+                enabled: true,
+                budgetTokens: opts.maxTokens
+                    ? Math.min(opts.maxTokens, opts.modelMaxTokens)
+                    : opts.modelMaxTokens,
+            };
+        }
+        return options;
+    },
+};
+/**
+ * OpenAI Completions API Strategy
+ * Handles different thinking formats (qwen, openai)
+ */
+const openaiStrategy = {
+    buildOptions(opts) {
+        const options = {};
+        if (opts.reasoning) {
+            // Qwen uses enableThinking flag
+            if (opts.thinkingFormat === 'qwen') {
+                options.enableThinking = true;
+            }
+            else {
+                // Standard OpenAI reasoning
+                options.reasoningEffort = 'medium';
+            }
+        }
+        return options;
+    },
+};
+/**
+ * GitHub Copilot Strategy
+ */
+const githubCopilotStrategy = {
+    buildOptions(_opts) {
+        // GitHub Copilot doesn't expose thinking controls
+        return {};
+    },
+};
+// ============================================
+// Strategy Registry
+// ============================================
+const STRATEGIES = {
+    'anthropic-messages': anthropicStrategy,
+    'google-generative-ai': googleStrategy,
+    'openai-completions': openaiStrategy,
+    'github-copilot': githubCopilotStrategy,
+};
+/**
+ * Get API strategy for the given API type
+ */
+export function getApiStrategy(apiType) {
+    const strategy = STRATEGIES[apiType];
+    if (!strategy) {
+        // Return noop strategy for unknown API types
+        return { buildOptions: () => ({}) };
+    }
+    return strategy;
+}
+/**
+ * Build provider-specific options
+ */
+export function buildProviderOptions(apiType, opts) {
+    const strategy = getApiStrategy(apiType);
+    return strategy.buildOptions(opts);
+}
+//# sourceMappingURL=api-strategies.js.map

package/dist/providers/api-strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-strategies.js","sourceRoot":"","sources":["../../src/providers/api-strategies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,iBAAiB,GAAgB;IACrC,YAAY,CAAC,IAAwB;QACnC,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;YAC/B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,SAAS;gBAC3C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC;gBAC/C,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;QAC1B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAgB;IAClC,YAAY,CAAC,IAAwB;QACnC,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,QAAQ,GAAG;gBACjB,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,IAAI,CAAC,SAAS;oBAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC;oBAC/C,CAAC,CAAC,IAAI,CAAC,cAAc;aACxB,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,cAAc,GAAgB;IAClC,YAAY,CAAC,IAAwB;QACnC,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,gCAAgC;YAChC,IAAI,IAAI,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;gBACnC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,4BAA4B;gBAC5B,OAAO,CAAC,eAAe,GAAG,QAAQ,CAAC;YACrC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,qBAAqB,GAAgB;IACzC,YAAY,CAAC,KAAyB;QACpC,kDAAkD;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAEF,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C,MAAM,UAAU,GAAiC;IAC/C,oBAAoB,EAAE,iBAAiB;IACvC,sBAAsB,EAAE,cAAc;IACtC,oBAAoB,EAAE,cAAc;IACpC,gBAAgB,EAAE,qBAAqB;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAkB,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,6CAA6C;QAC7C,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,IAAwB;IAExB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/providers/auto-discovery.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Auto Discovery
+ *
+ * 自动检测和配置 Provider
+ * - 从环境变量自动检测已配置的 provider
+ * - 生成简化配置
+ * - 无需手动编辑 config.json
+ */
+export interface DiscoveredProvider {
+    id: string;
+    name: string;
+    configured: boolean;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export interface AutoConfig {
+    /** 默认模型 */
+    defaultModel: string;
+    /** 启用的 providers */
+    enabledProviders: string[];
+    /** 完整的 provider 配置 */
+    providerConfigs: Record<string, {
+        apiKey?: string;
+        baseUrl?: string;
+    }>;
+}
+/**
+ * 扫描所有 provider，返回已配置和未配置的列表
+ */
+export declare function scanProviders(): {
+    configured: DiscoveredProvider[];
+    unconfigured: DiscoveredProvider[];
+};
+/**
+ * 推荐默认模型
+ * 根据已配置的 provider 选择最佳默认模型
+ */
+export declare function recommendDefaultModel(configuredProviders: string[]): string;
+/**
+ * 生成自动配置
+ * 基于环境变量生成最小化配置
+ */
+export declare function generateAutoConfig(): AutoConfig;
+/**
+ * 生成 config.json 内容（用于显示或导出）
+ */
+export declare function generateConfigTemplate(): string;
+/**
+ * 快速配置向导结果
+ */
+export interface QuickSetupResult {
+    success: boolean;
+    message: string;
+    defaultModel?: string;
+    providers?: string[];
+    errors?: string[];
+}
+/**
+ * 快速配置向导
+ * 检测环境并返回配置建议
+ */
+export declare function quickSetup(): QuickSetupResult;
+/**
+ * 检查特定模型是否可用
+ */
+export declare function isModelAvailable(modelRef: string): boolean;
+/**
+ * 获取最佳可用模型
+ * 按优先级返回第一个可用的模型
+ */
+export declare function getBestAvailableModel(): string | undefined;
+/**
+ * 打印配置诊断信息
+ */
+export declare function printDiagnostic(): void;
+/**
+ * 获取配置状态摘要
+ */
+export declare function getConfigSummary(): {
+    status: 'ready' | 'no_providers';
+    providers: number;
+    defaultModel?: string;
+    message: string;
+};