@xopcai/xopcbot 0.1.0

package/README.md

@@ -0,0 +1,132 @@
+# 🐈 xopcbot: Ultra-Lightweight Personal AI Assistant
+
+[中文](./README.zh-CN.md) | English
+
+<div align="center">
+  <p>
+    <strong>An ultra-lightweight, plugin-driven personal AI assistant built with Node.js and TypeScript.</strong>
+  </p>
+  <p>
+    <a href="https://github.com/xopcai/xopcbot">
+      <img src="https://img.shields.io/badge/GitHub-xopcai/xopcbot-blue" alt="GitHub">
+    </a>
+    <a href="https://xopcai.github.io/xopcbot/">
+      <img src="https://img.shields.io/badge/Docs-xopcai.github.io/xopcbot-brightgreen" alt="Docs">
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/Node-%3E%3D22.0.0-brightgreen" alt="Node">
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/TypeScript-5.x-blue" alt="TypeScript">
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/License-MIT-green" alt="License">
+    </a>
+  </p>
+</div>
+
+**xopcbot** provides the core functionality of a personal AI agent in a minimal footprint (~6,000 lines of TypeScript). It's designed to be simple, extensible, and easy to understand.
+
+## ✨ Features
+
+- **🤖 Unified LLM API** - Supports 20+ providers (OpenAI, Anthropic, Google, Groq, DeepSeek, MiniMax, Qwen, Kimi, etc.)
+- **🔌 Extensible Plugins** - Add custom tools, hooks, and commands with hot-reloading
+- **📱 Multi-Channel Support** - Telegram, WhatsApp, Feishu/Lark, or Web UI
+- **🧠 Persistent Memory** - Conversation history with automatic context compaction
+- **📂 Session Management** - Browse, search, archive, and manage conversations via CLI or Web UI
+- **🔧 Rich Built-in Tools** - Filesystem, shell, web search, grep, find, edit, and more
+- **⏰ Scheduled Tasks** - Cron-based automation
+- **🖥️ Powerful CLI** - Manage agent, config, and plugins from command line
+- **🌐 Modern Web UI** - Chat, sessions, cron, subagents, logs, and settings
+
+---
+
+## 🚀 Quick Start
+
+### Option 1: Install from npm
+
+```bash
+# Install globally
+npm install -g @xopcai/xopcbot
+
+# Configure (interactive setup)
+xopcbot configure
+
+# Start chatting!
+xopcbot agent -i
+```
+
+### Option 2: Build from source
+
+```bash
+# Clone and install
+git clone https://github.com/xopcai/xopcbot.git
+cd xopcbot
+pnpm install
+
+# Configure (interactive setup)
+pnpm run dev -- configure
+
+# Start chatting!
+pnpm run dev -- agent -i
+```
+
+> **Tip:** Run `xopcbot configure` (or `pnpm run dev -- configure`) to set up your LLM provider API key interactively.
+
+---
+
+## 📖 Documentation
+
+Full documentation is available at **[xopcai.github.io/xopcbot](https://xopcai.github.io/xopcbot/)**
+
+| Guide | Description |
+|-------|-------------|
+| [Getting Started](https://xopcai.github.io/xopcbot/getting-started) | Setup and basic usage |
+| [Configuration](https://xopcai.github.io/xopcbot/configuration) | Full config reference |
+| [CLI Reference](https://xopcai.github.io/xopcbot/cli) | All available commands |
+| [Channels](https://xopcai.github.io/xopcbot/channels) | Telegram, WhatsApp, Feishu setup |
+| [Plugins](https://xopcai.github.io/xopcbot/plugins) | Build your own plugins |
+| [Tools](https://xopcai.github.io/xopcbot/tools) | Built-in tools reference |
+| [Architecture](https://xopcai.github.io/xopcbot/architecture) | Under the hood |
+
+---
+
+## 💬 Supported Channels
+
+| Channel | Status | Description |
+|---------|--------|-------------|
+| Telegram | ✅ | Bot API with polling/webhook |
+| WhatsApp | ✅ | Baileys WebSocket |
+| Feishu/Lark | ✅ | WebSocket events |
+| Web UI | ✅ | Modern browser interface |
+
+---
+
+## 🛠️ Development
+
+```bash
+# Development
+pnpm run dev
+
+# Build
+pnpm run build
+
+# Test
+pnpm test
+
+# Lint
+pnpm run lint
+```
+
+---
+
+## 🙏 Credits
+
+- Inspired by [OpenClaw](https://github.com/openclaw/openclaw)
+- LLM providers via [@mariozechner/pi-ai](https://github.com/badlogic/pi-mono)
+
+---
+
+<div align="center">
+  <sub>Made with ❤️ by <a href="https://github.com/xopcai">xopcai</a></sub>
+</div>

package/README.zh-CN.md

@@ -0,0 +1,130 @@
+# 🐈 xopcbot: 超轻量级个人 AI 助手
+
+<div align="center">
+  <p>
+    <strong>使用 Node.js 和 TypeScript 构建的超轻量级、插件驱动的个人 AI 助手。</strong>
+  </p>
+  <p>
+    <a href="https://github.com/xopcai/xopcbot">
+      <img src="https://img.shields.io/badge/GitHub-xopcai/xopcbot-blue" alt="GitHub">
+    </a>
+    <a href="https://xopcai.github.io/xopcbot/">
+      <img src="https://img.shields.io/badge/Docs-xopcai.github.io/xopcbot-brightgreen" alt="Docs">
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/Node-%3E%3D22.0.0-brightgreen" alt="Node">
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/TypeScript-5.x-blue" alt="TypeScript">
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/License-MIT-green" alt="License">
+    </a>
+  </p>
+</div>
+
+**xopcbot** 以极简的代码量（约 6,000 行 TypeScript）提供个人 AI 代理的核心功能。设计简洁、可扩展、易于理解。
+
+## ✨ 特性
+
+- **🤖 统一 LLM API** - 支持 20+ 提供商（OpenAI、Anthropic、Google、Groq、DeepSeek、Minimax、Qwen、Kimi 等）
+- **🔌 可扩展插件** - 支持热加载的自定义工具、钩子和命令
+- **📱 多渠道支持** - Telegram、WhatsApp、飞书/Lark 或 Web UI
+- **🧠 持久记忆** - 对话历史，自动上下文压缩
+- **📂 会话管理** - 通过 CLI 或 Web UI 浏览、搜索、归档和管理对话
+- **🔧 丰富的内置工具** - 文件系统、Shell、Web 搜索、grep、查找、编辑等
+- **⏰ 定时任务** - 基于 Cron 的自动化
+- **🖥️ 强大的 CLI** - 从命令行管理代理、配置和插件
+- **🌐 现代 Web UI** - 聊天、会话、Cron、子代理、日志和设置
+
+---
+
+## 🚀 快速开始
+
+### 方式一：从 npm 安装
+
+```bash
+# 全局安装
+npm install -g @xopcai/xopcbot
+
+# 配置（交互式设置）
+xopcbot configure
+
+# 开始聊天！
+xopcbot agent -i
+```
+
+### 方式二：从源码构建
+
+```bash
+# 克隆并安装
+git clone https://github.com/xopcai/xopcbot.git
+cd xopcbot
+pnpm install
+
+# 配置（交互式设置）
+pnpm run dev -- configure
+
+# 开始聊天！
+pnpm run dev -- agent -i
+```
+
+> **提示：** 运行 `xopcbot configure`（或 `pnpm run dev -- configure`）交互式设置 LLM 提供商 API 密钥。
+
+---
+
+## 📖 文档
+
+完整文档请访问 **[xopcai.github.io/xopcbot](https://xopcai.github.io/xopcbot/)**
+
+| 指南 | 描述 |
+|------|------|
+| [快速开始](https://xopcai.github.io/xopcbot/getting-started) | 安装和基本用法 |
+| [配置](https://xopcai.github.io/xopcbot/configuration) | 完整配置参考 |
+| [CLI 参考](https://xopcai.github.io/xopcbot/cli) | 所有可用命令 |
+| [渠道](https://xopcai.github.io/xopcbot/channels) | Telegram、WhatsApp、飞书设置 |
+| [插件](https://xopcai.github.io/xopcbot/plugins) | 构建你自己的插件 |
+| [工具](https://xopcai.github.io/xopcbot/tools) | 内置工具参考 |
+| [架构](https://xopcai.github.io/xopcbot/architecture) | 底层实现 |
+
+---
+
+## 💬 支持的渠道
+
+| 渠道 | 状态 | 描述 |
+|------|------|------|
+| Telegram | ✅ | Bot API，支持轮询/webhook |
+| WhatsApp | ✅ | Baileys WebSocket |
+| 飞书/Lark | ✅ | WebSocket 事件 |
+| Web UI | ✅ | 现代浏览器界面 |
+
+---
+
+## 🛠️ 开发
+
+```bash
+# 开发模式
+pnpm run dev
+
+# 构建
+pnpm run build
+
+# 测试
+pnpm test
+
+# 代码检查
+pnpm run lint
+```
+
+---
+
+## 🙏 致谢
+
+- 灵感来自 [OpenClaw](https://github.com/openclaw/openclaw)
+- LLM 提供商基于 [@mariozechner/pi-ai](https://github.com/badlogic/pi-mono)
+
+---
+
+<div align="center">
+  <sub>由 <a href="https://github.com/xopcai">xopcai</a> 用 ❤️ 构建</sub>
+</div>

package/dist/__tests__/core.test.d.ts

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

package/dist/__tests__/core.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest';
+/**
+ * 集成测试 - 验证核心模块能正确加载
+ * 详细的单元测试请查看各模块的 __tests__/ 目录
+ */
+describe('xopcbot integration tests', () => {
+    it('should load all core modules without errors', async () => {
+        // Agent modules
+        const { AgentService } = await import('../agent/index.js');
+        expect(AgentService).toBeDefined();
+        // Config modules
+        const { loadConfig, saveConfig, ConfigSchema } = await import('../config/index.js');
+        expect(loadConfig).toBeDefined();
+        expect(saveConfig).toBeDefined();
+        expect(ConfigSchema).toBeDefined();
+        // CLI modules
+        const { CommandRegistry } = await import('../cli/registry.js');
+        expect(CommandRegistry).toBeDefined();
+        // Memory modules
+        const { SessionStore } = await import('../session/index.js');
+        expect(SessionStore).toBeDefined();
+        // Cron modules
+        const { CronService } = await import('../cron/index.js');
+        expect(CronService).toBeDefined();
+        // Provider modules
+        const { createProvider } = await import('../providers/index.js');
+        expect(createProvider).toBeDefined();
+        // Bus modules
+        const { MessageBus } = await import('../bus/index.js');
+        expect(MessageBus).toBeDefined();
+    }, 30000);
+    it('should instantiate core classes', async () => {
+        const { CommandRegistry } = await import('../cli/registry.js');
+        const { SessionStore } = await import('../session/index.js');
+        // Should be able to instantiate
+        expect(() => new CommandRegistry()).not.toThrow();
+        expect(() => new SessionStore('/tmp/test')).not.toThrow();
+    });
+    it('should have all tool functions available', async () => {
+        const tools = await import('../agent/tools/index.js');
+        expect(tools.readFileTool).toBeDefined();
+        expect(tools.writeFileTool).toBeDefined();
+        expect(tools.editFileTool).toBeDefined();
+        expect(tools.listDirTool).toBeDefined();
+        expect(tools.createShellTool).toBeDefined();
+        expect(tools.createWebSearchTool).toBeDefined();
+        expect(tools.webFetchTool).toBeDefined();
+        expect(tools.createMessageTool).toBeDefined();
+    });
+    it('should have all CLI commands registered', async () => {
+        const { registry } = await import('../cli/registry.js');
+        // Import commands to trigger registration
+        await import('../cli/commands/onboard.js');
+        await import('../cli/commands/agent.js');
+        await import('../cli/commands/gateway.js');
+        await import('../cli/commands/cron.js');
+        await import('../cli/commands/config.js');
+        await import('../cli/commands/models.js');
+        await import('../cli/commands/configure.js');
+        await import('../cli/commands/session.js');
+        // Verify commands are registered
+        expect(registry.findByName('onboard')).toBeDefined();
+        expect(registry.findByName('agent')).toBeDefined();
+        expect(registry.findByName('gateway')).toBeDefined();
+        expect(registry.findByName('cron')).toBeDefined();
+        expect(registry.findByName('config')).toBeDefined();
+        expect(registry.findByName('models')).toBeDefined();
+        expect(registry.findByName('configure')).toBeDefined();
+        expect(registry.findByName('session')).toBeDefined();
+    });
+});
+//# sourceMappingURL=core.test.js.map

package/dist/__tests__/core.test.js.map

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

package/dist/agent/fallback/__tests__/index.test.d.ts

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

package/dist/agent/fallback/__tests__/index.test.js

@@ -0,0 +1,111 @@
+import { describe, expect, it } from 'vitest';
+import { classifyFailoverReason, isRateLimitErrorMessage, isTimeoutErrorMessage, isBillingErrorMessage, isAuthErrorMessage, isFormatErrorMessage, } from '../reason.js';
+import { FailoverError, isFailoverError, describeFailoverError } from '../error.js';
+import { resolveFallbackCandidates } from '../candidates.js';
+describe('Failover Reason Classification', () => {
+    it('classifies rate limit errors', () => {
+        expect(classifyFailoverReason({ status: 429 })).toBe('rate_limit');
+        expect(classifyFailoverReason('rate limit exceeded')).toBe('rate_limit');
+        expect(isRateLimitErrorMessage('Rate limit exceeded')).toBe(true);
+    });
+    it('classifies billing errors', () => {
+        expect(classifyFailoverReason({ status: 402 })).toBe('billing');
+        expect(classifyFailoverReason('insufficient credits')).toBe('billing');
+        expect(isBillingErrorMessage('Insufficient credits')).toBe(true);
+    });
+    it('classifies auth errors', () => {
+        expect(classifyFailoverReason({ status: 401 })).toBe('auth');
+        expect(classifyFailoverReason({ status: 403 })).toBe('auth');
+        expect(classifyFailoverReason('invalid api key')).toBe('auth');
+        expect(isAuthErrorMessage('Invalid API key')).toBe(true);
+    });
+    it('classifies timeout errors', () => {
+        expect(classifyFailoverReason({ status: 408 })).toBe('timeout');
+        expect(classifyFailoverReason({ code: 'ETIMEDOUT' })).toBe('timeout');
+        expect(isTimeoutErrorMessage('Request timed out')).toBe(true);
+    });
+    it('classifies format errors', () => {
+        expect(classifyFailoverReason({ status: 400 })).toBe('format');
+        expect(isFormatErrorMessage('Invalid request format')).toBe(true);
+    });
+    it('returns unknown for unrecognized errors', () => {
+        expect(classifyFailoverReason('random error')).toBe('unknown');
+    });
+});
+describe('FailoverError', () => {
+    it('creates error with properties', () => {
+        const error = new FailoverError('Test', 'rate_limit', 'openai', 'gpt-4', 429);
+        expect(error.message).toBe('Test');
+        expect(error.reason).toBe('rate_limit');
+        expect(error.provider).toBe('openai');
+        expect(error.model).toBe('gpt-4');
+        expect(error.status).toBe(429);
+    });
+    it('detects via isFailoverError', () => {
+        expect(isFailoverError(new FailoverError('Test', 'auth'))).toBe(true);
+        expect(isFailoverError(new Error('Test'))).toBe(false);
+    });
+    it('describes error correctly', () => {
+        const error = new FailoverError('Rate limited', 'rate_limit', 'anthropic', 'claude-3', 429);
+        const desc = describeFailoverError(error);
+        expect(desc.message).toBe('Rate limited');
+        expect(desc.reason).toBe('rate_limit');
+    });
+});
+describe('resolveFallbackCandidates', () => {
+    it('returns single candidate with no config', () => {
+        const candidates = resolveFallbackCandidates({ cfg: undefined, provider: 'anthropic', model: 'claude-sonnet-4-5' });
+        expect(candidates).toEqual([]);
+    });
+    it('includes fallbacks from config', () => {
+        const candidates = resolveFallbackCandidates({
+            cfg: {
+                agents: { defaults: { model: { primary: 'anthropic/claude-sonnet-4-5', fallbacks: ['openai/gpt-4o'] } } },
+                providers: { anthropic: { apiKey: 'test-key' }, openai: { apiKey: 'test-key' } },
+            },
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-5',
+        });
+        expect(candidates.length).toBeGreaterThanOrEqual(2);
+        expect(candidates[0]).toEqual({ provider: 'anthropic', model: 'claude-sonnet-4-5' });
+    });
+    it('respects fallbacksOverride', () => {
+        const candidates = resolveFallbackCandidates({
+            cfg: {
+                agents: { defaults: { model: { primary: 'anthropic/claude-sonnet-4-5', fallbacks: ['openai/gpt-4o'] } } },
+                providers: { anthropic: { apiKey: 'test-key' }, minimax: { apiKey: 'test-key' } },
+            },
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-5',
+            fallbacksOverride: ['minimax/minimax-m2.1'],
+        });
+        expect(candidates).toHaveLength(2);
+        expect(candidates[1]).toEqual({ provider: 'minimax', model: 'minimax-m2.1' });
+    });
+    it('deduplicates candidates', () => {
+        const candidates = resolveFallbackCandidates({
+            cfg: {
+                agents: { defaults: { model: { primary: 'anthropic/claude-sonnet-4-5', fallbacks: ['anthropic/claude-sonnet-4-5'] } } },
+                providers: { anthropic: { apiKey: 'test-key' } },
+            },
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-5',
+        });
+        const keys = candidates.map(c => `${c.provider}/${c.model}`);
+        expect(keys.length).toBe(new Set(keys).size);
+    });
+    it('filters out unconfigured providers', () => {
+        const candidates = resolveFallbackCandidates({
+            cfg: {
+                agents: { defaults: { model: { primary: 'anthropic/claude-sonnet-4-5', fallbacks: ['openai/gpt-4o', 'unconfigured/model'] } } },
+                providers: { anthropic: { apiKey: 'test-key' } }, // openai not configured
+            },
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-5',
+        });
+        // Only anthropic should be included, openai is filtered out
+        expect(candidates).toHaveLength(1);
+        expect(candidates[0]).toEqual({ provider: 'anthropic', model: 'claude-sonnet-4-5' });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/agent/fallback/__tests__/index.test.js.map

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

package/dist/agent/fallback/candidates.d.ts

@@ -0,0 +1,23 @@
+import type { Config } from '../../config/schema.js';
+export interface ModelCandidate {
+    provider: string;
+    model: string;
+}
+export interface FallbackAttempt {
+    provider: string;
+    model: string;
+    error: string;
+    reason?: string;
+    status?: number;
+    code?: string;
+}
+/**
+ * Check if a provider is configured (has API key or is enabled for local providers)
+ */
+export declare function isProviderConfigured(cfg: Config | undefined, provider: string): boolean;
+export declare function resolveFallbackCandidates(params: {
+    cfg: Config | undefined;
+    provider: string;
+    model: string;
+    fallbacksOverride?: string[];
+}): ModelCandidate[];

package/dist/agent/fallback/candidates.js

@@ -0,0 +1,62 @@
+/**
+ * Check if a provider is configured (has API key or is enabled for local providers)
+ */
+export function isProviderConfigured(cfg, provider) {
+    if (!cfg?.providers)
+        return false;
+    const providerConfig = cfg.providers[provider];
+    if (!providerConfig)
+        return false;
+    // Ollama is special - it uses 'enabled' flag instead of apiKey
+    if (provider === 'ollama') {
+        return providerConfig.enabled ?? true;
+    }
+    // Other providers require apiKey
+    return 'apiKey' in providerConfig && Boolean(providerConfig.apiKey);
+}
+function parseModelRef(raw, defaultProvider) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    const slashIndex = trimmed.indexOf('/');
+    if (slashIndex === -1) {
+        return defaultProvider ? { provider: defaultProvider, model: trimmed } : null;
+    }
+    const provider = trimmed.slice(0, slashIndex).trim();
+    const model = trimmed.slice(slashIndex + 1).trim();
+    return provider && model ? { provider, model } : null;
+}
+export function resolveFallbackCandidates(params) {
+    const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;
+    const modelConfig = cfg?.agents?.defaults?.model;
+    const primaryRef = typeof modelConfig === 'string' ? modelConfig : modelConfig?.primary;
+    const fallbacks = fallbacksOverride ?? (typeof modelConfig === 'object' ? modelConfig.fallbacks : undefined);
+    const primaryResolved = parseModelRef(primaryRef ?? 'anthropic/claude-sonnet-4-5');
+    const provider = inputProvider.trim() || primaryResolved?.provider || 'anthropic';
+    const model = inputModel.trim() || primaryResolved?.model || 'claude-sonnet-4-5';
+    const candidates = [];
+    const seen = new Set();
+    const addCandidate = (c) => {
+        const key = `${c.provider}/${c.model}`.toLowerCase();
+        if (seen.has(key))
+            return;
+        // Skip providers that are not configured (no API key)
+        if (!isProviderConfigured(cfg, c.provider))
+            return;
+        seen.add(key);
+        candidates.push(c);
+    };
+    addCandidate({ provider, model });
+    if (fallbacks) {
+        for (const fb of fallbacks) {
+            const resolved = parseModelRef(fb, provider);
+            if (resolved)
+                addCandidate(resolved);
+        }
+    }
+    if (!fallbacksOverride && primaryResolved) {
+        addCandidate(primaryResolved);
+    }
+    return candidates;
+}
+//# sourceMappingURL=candidates.js.map

package/dist/agent/fallback/candidates.js.map

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

package/dist/agent/fallback/error.d.ts

@@ -0,0 +1,22 @@
+import { type FailoverReason } from './reason.js';
+export type { FailoverReason };
+export declare class FailoverError extends Error {
+    readonly reason: FailoverReason;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly status?: number;
+    readonly code?: string;
+    constructor(message: string, reason: FailoverReason, provider?: string, model?: string, status?: number, code?: string, cause?: unknown);
+}
+export declare function isFailoverError(err: unknown): err is FailoverError;
+export declare function describeFailoverError(err: unknown): {
+    message: string;
+    reason: FailoverReason;
+    status: number;
+    code: string;
+} | {
+    message: string;
+    reason: FailoverReason;
+    status?: undefined;
+    code?: undefined;
+};

package/dist/agent/fallback/error.js

@@ -0,0 +1,27 @@
+import { classifyFailoverReason } from './reason.js';
+export class FailoverError extends Error {
+    reason;
+    provider;
+    model;
+    status;
+    code;
+    constructor(message, reason, provider, model, status, code, cause) {
+        super(message, { cause });
+        this.reason = reason;
+        this.provider = provider;
+        this.model = model;
+        this.status = status;
+        this.code = code;
+        this.name = 'FailoverError';
+    }
+}
+export function isFailoverError(err) {
+    return err instanceof FailoverError;
+}
+export function describeFailoverError(err) {
+    if (isFailoverError(err)) {
+        return { message: err.message, reason: err.reason, status: err.status, code: err.code };
+    }
+    return { message: String(err), reason: classifyFailoverReason(err) };
+}
+//# sourceMappingURL=error.js.map

package/dist/agent/fallback/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/agent/fallback/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAuB,MAAM,aAAa,CAAC;AAI1E,MAAM,OAAO,aAAc,SAAQ,KAAK;IAG3B;IACA;IACA;IACA;IACA;IANX,YACE,OAAe,EACN,MAAsB,EACtB,QAAiB,EACjB,KAAc,EACd,MAAe,EACf,IAAa,EACtB,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAPjB,WAAM,GAAN,MAAM,CAAgB;QACtB,aAAQ,GAAR,QAAQ,CAAS;QACjB,UAAK,GAAL,KAAK,CAAS;QACd,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QAItB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/agent/fallback/index.d.ts

@@ -0,0 +1,6 @@
+export type { FailoverReason } from './reason.js';
+export { classifyFailoverReason, isRateLimitErrorMessage, isTimeoutErrorMessage, isBillingErrorMessage, isAuthErrorMessage, isFormatErrorMessage, } from './reason.js';
+export { FailoverError, isFailoverError, describeFailoverError } from './error.js';
+export { runWithModelFallback, type FallbackResult } from './runner.js';
+export type { ModelCandidate, FallbackAttempt } from './candidates.js';
+export { resolveFallbackCandidates, isProviderConfigured } from './candidates.js';

package/dist/agent/fallback/index.js

@@ -0,0 +1,5 @@
+export { classifyFailoverReason, isRateLimitErrorMessage, isTimeoutErrorMessage, isBillingErrorMessage, isAuthErrorMessage, isFormatErrorMessage, } from './reason.js';
+export { FailoverError, isFailoverError, describeFailoverError } from './error.js';
+export { runWithModelFallback } from './runner.js';
+export { resolveFallbackCandidates, isProviderConfigured } from './candidates.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/fallback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/fallback/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAuB,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/agent/fallback/reason.d.ts

@@ -0,0 +1,7 @@
+export type FailoverReason = 'auth' | 'format' | 'rate_limit' | 'billing' | 'timeout' | 'unknown';
+export declare function isRateLimitErrorMessage(raw: string): boolean;
+export declare function isTimeoutErrorMessage(raw: string): boolean;
+export declare function isBillingErrorMessage(raw: string): boolean;
+export declare function isAuthErrorMessage(raw: string): boolean;
+export declare function isFormatErrorMessage(raw: string): boolean;
+export declare function classifyFailoverReason(err: unknown): FailoverReason;