@xagent-ai/cli 1.2.2 → 1.3.1

package/test/cli-launch.test.ts

@@ -0,0 +1,279 @@
+/**
+ * xAgent CLI Launch Tests
+ * 
+ * 这些测试用于验证 CLI 的基本启动和命令行为。
+ * 测试不依赖外部服务，可以离线运行。
+ */
+
+import { describe, it, expect } from 'vitest';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const cliPath = join(__dirname, '../dist/cli.js');
+
+// commander.js 的 --help 行为会导致退出码为 1，这是正常行为
+const HELP_EXIT_CODE = 1;
+
+/**
+ * 运行 CLI 命令并返回结果（使用 execSync）
+ */
+function runCli(args: string[], options: { env?: Record<string, string> } = {}): {
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+} {
+  try {
+    const env = { ...process.env, ...options.env, NODE_ENV: 'test' };
+    const stdout = execSync(`"${process.execPath}" "${cliPath}" ${args.join(' ')}`, {
+      encoding: 'utf-8',
+      env,
+      timeout: 30000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return {
+      exitCode: 0,
+      stdout,
+      stderr: ''
+    };
+  } catch (error: any) {
+    // execSync 在命令失败时会抛出错误
+    const stdout = error.stdout || '';
+    const stderr = error.stderr || '';
+    const exitCode = error.status || -1;
+    // 合并 stdout 和 stderr，因为 Windows PowerShell 可能将输出重定向
+    const combinedOutput = stdout + stderr;
+    return {
+      exitCode,
+      stdout: combinedOutput,
+      stderr
+    };
+  }
+}
+
+describe('xAgent CLI Launch Tests', () => {
+  /**
+   * 测试版本号输出
+   */
+  describe('version', () => {
+    it('should output version with --version flag', () => {
+      const result = runCli(['--version']);
+      
+      expect(result.exitCode).toBe(0);
+      expect(result.stdout).toMatch(/\d+\.\d+\.\d+/); // 匹配语义化版本号
+    });
+    
+    it('should exit with code 0 on --version', () => {
+      const result = runCli(['--version']);
+      expect(result.exitCode).toBe(0);
+    });
+  });
+  
+  /**
+   * 测试帮助信息
+   */
+  describe('help', () => {
+    it('should output help with --help flag', () => {
+      const result = runCli(['--help']);
+      
+      // commander.js --help 退出码为 1 是正常行为
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      // stdout 可能为空，输出在 stderr 中
+      const output = result.stdout || result.stderr;
+      expect(output).toContain('xagent');
+      expect(output).toContain('AI-powered');
+    });
+    
+    it('should list available commands in help', () => {
+      const result = runCli(['--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect(output).toContain('start');
+      expect(output).toContain('auth');
+      expect(output).toContain('agent');
+      expect(output).toContain('mcp');
+      expect(output).toContain('init');
+    });
+    
+    it('should show help for auth command', () => {
+      const result = runCli(['auth', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      expect(output).toContain('auth');
+      // 检查认证相关文本
+      expect(output).toMatch(/authentication|authenticate|Auth/i);
+    });
+    
+    it('should show help for mcp command', () => {
+      const result = runCli(['mcp', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      expect(output).toContain('mcp');
+      expect(output).toContain('--list');
+      expect(output).toContain('--add');
+      expect(output).toContain('--remove');
+    });
+  });
+  
+  /**
+   * 测试 start 命令启动
+   */
+  describe('start command', () => {
+    it('should start and output when running xagent start', () => {
+      // start 命令会启动交互式会话
+      // 我们使用 timeout 强制终止并检查是否有输出
+      const result = runCli(['start']);
+      
+      // 由于是交互式命令，退出码可能是 0 或超时 -1
+      // 关键是验证命令能够启动并产生输出
+      const output = result.stdout || result.stderr;
+      
+      // 验证命令能够启动（没有立即崩溃）
+      expect([0, -1]).toContain(result.exitCode);
+      
+      // 验证有输出内容（启动提示信息）
+      expect(output).toBeTruthy();
+      
+      // 验证输出包含 CLI 相关内容
+      expect(output.toLowerCase()).toMatch(/xagent|agent|start|welcome/i);
+    });
+  });
+  
+  /**
+   * 测试错误处理
+   */
+  describe('error handling', () => {
+    it('should show error for unknown command', () => {
+      const result = runCli(['unknown-command-xyz']);
+      
+      expect(result.exitCode).toBeGreaterThan(0);
+      const output = result.stdout || result.stderr;
+      expect(output).toBeTruthy();
+    });
+    
+    it('should show error for unknown option', () => {
+      const result = runCli(['--unknown-option-xyz']);
+      
+      expect(result.exitCode).toBeGreaterThan(0);
+      const output = result.stdout || result.stderr;
+      expect(output).toBeTruthy();
+    });
+  });
+  
+  /**
+   * 测试 agent 命令
+   */
+  describe('agent command', () => {
+    it('should show agent help', () => {
+      const result = runCli(['agent', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      // 检查帮助输出中包含关键选项
+      expect(output).toContain('--list');
+      expect(output).toContain('--add');
+      expect(output).toContain('--remove');
+      // 检查输出与 agent 相关
+      expect(output.toLowerCase()).toMatch(/agent|specify an action/i);
+    });
+    
+    it('should list agents with --list flag', () => {
+      const result = runCli(['agent', '--list']);
+      
+      // agent --list 可能会因为没有配置而返回非零退出码
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      const output = result.stdout || result.stderr;
+      expect(output).toBeTruthy();
+    });
+  });
+  
+  /**
+   * 测试 mcp 命令
+   */
+  describe('mcp command', () => {
+    it('should show mcp help', () => {
+      const result = runCli(['mcp', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      expect(output).toContain('--list');
+      // 检查输出中包含 mcp 相关的选项
+      expect(output.toLowerCase()).toMatch(/mcp|transport|server|--add/i);
+    });
+    
+    it('should list MCP servers with --list flag', () => {
+      const result = runCli(['mcp', '--list']);
+      
+      // mcp --list 可能会因为没有配置而返回非零退出码
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+    });
+  });
+  
+  /**
+   * 测试 init 命令
+   */
+  describe('init command', () => {
+    it('should show init help', () => {
+      const result = runCli(['init', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      expect(output.toLowerCase()).toContain('init');
+      // init 命令会实际执行初始化，检查是否有关键内容
+      expect(output.toLowerCase()).toMatch(/project|xagent\.md|initial/i);
+    });
+  });
+  
+  /**
+   * 测试 workflow 命令
+   */
+  describe('workflow command', () => {
+    it('should show workflow help', () => {
+      const result = runCli(['workflow', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      // workflow 命令可能输出"Please specify an action"或帮助信息
+      expect(output.toLowerCase()).toMatch(/workflow|specify an action|--list/i);
+      expect(output).toContain('--list');
+    });
+    
+    it('should list workflows with --list flag', () => {
+      const result = runCli(['workflow', '--list']);
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+    });
+  });
+  
+  /**
+   * 测试 skill 命令
+   */
+  describe('skill command', () => {
+    it('should show skill help', () => {
+      const result = runCli(['skill', '--help']);
+      const output = result.stdout || result.stderr;
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+      expect(output.toLowerCase()).toContain('skill');
+      // skill 命令使用 -l 而不是 --list
+      expect(output.toLowerCase()).toMatch(/skill|-l|--add|--remove/i);
+    });
+  });
+  
+  /**
+   * 测试环境变量处理
+   */
+  describe('environment handling', () => {
+    it('should handle empty XAGENT_BASE_URL gracefully', () => {
+      const result = runCli(['--help'], {
+        env: { XAGENT_BASE_URL: '' }
+      });
+      
+      expect([0, HELP_EXIT_CODE]).toContain(result.exitCode);
+    });
+  });
+});

package/tsconfig.json

@@ -1,22 +1,22 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "lib": ["ES2022"],
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "allowSyntheticDefaultImports": true,
-    "types": ["node"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}

package/vitest.config.ts

@@ -1,19 +1,21 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['src/**/*.{test,spec}.{ts,tsx}', 'test/**/*.{test,spec}.{ts,tsx}'],
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html'],
-      exclude: [
-        'node_modules/',
-        'src/tests/',
-        '**/*.test.ts',
-        '**/*.spec.ts'
-      ]
-    }
-  }
-});
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.{test,spec}.{ts,tsx}', 'test/**/*.{test,spec}.{ts,tsx}'],
+    testTimeout: 60000,
+    hookTimeout: 30000,
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: [
+        'node_modules/',
+        'src/tests/',
+        '**/*.test.ts',
+        '**/*.spec.ts'
+      ]
+    }
+  }
+});

package/dist/ai-client.d.ts

@@ -1,86 +0,0 @@
-import { AuthConfig } from './types.js';
-export interface AnthropicContentBlock {
-    type: 'text' | 'tool_use' | 'tool_result' | 'thinking';
-    text?: string;
-    id?: string;
-    name?: string;
-    input?: any;
-    tool_use_id?: string;
-    content?: string;
-    thinking?: string;
-}
-export declare function renderMarkdown(text: string): string;
-export declare function displayMessages(messages: any[], systemPrompt?: string): void;
-export interface Message {
-    role: 'system' | 'user' | 'assistant' | 'tool';
-    content: string | Array<AnthropicContentBlock | {
-        type: string;
-        text?: string;
-        image_url?: {
-            url: string;
-        };
-    }>;
-    reasoning_content?: string;
-    tool_calls?: any[];
-    tool_call_id?: string;
-}
-export interface ToolDefinition {
-    type: 'function';
-    function: {
-        name: string;
-        description: string;
-        parameters?: any;
-    };
-}
-export interface ChatCompletionOptions {
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-    tools?: ToolDefinition[];
-    toolChoice?: 'auto' | 'none' | {
-        type: string;
-        function: {
-            name: string;
-        };
-    };
-    stream?: boolean;
-    thinkingTokens?: number;
-}
-export interface ChatCompletionResponse {
-    id: string;
-    object: string;
-    created: number;
-    model: string;
-    choices: Array<{
-        index: number;
-        message: Message;
-        finish_reason: string;
-    }>;
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-}
-export declare class AIClient {
-    private client;
-    private authConfig;
-    constructor(authConfig: AuthConfig);
-    private convertToAnthropicFormat;
-    chatCompletion(messages: Message[], options?: ChatCompletionOptions): Promise<ChatCompletionResponse>;
-    private isRetryableError;
-    private anthropicNativeChatCompletion;
-    private minimaxChatCompletion;
-    private convertFromAnthropicNativeResponse;
-    private convertFromMiniMaxResponse;
-    streamChatCompletion(messages: Message[], options?: ChatCompletionOptions): AsyncGenerator<string, void, unknown>;
-    private anthropicNativeStreamChatCompletion;
-    private minimaxStreamChatCompletion;
-    listModels(): Promise<any[]>;
-    updateAuthConfig(authConfig: AuthConfig): void;
-    getAuthConfig(): AuthConfig;
-    hasToolCalls(messages: Message[]): boolean;
-}
-export declare function detectThinkingKeywords(text: string): 'none' | 'normal' | 'hard' | 'mega' | 'ultra';
-export declare function getThinkingTokens(mode: 'none' | 'normal' | 'hard' | 'mega' | 'ultra'): number;
-//# sourceMappingURL=ai-client.d.ts.map

package/dist/ai-client.d.ts.map

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