btcp-browser-agent 0.1.0 → 0.1.1

package/packages/cli/src/__tests__/cli.test.ts

@@ -1,434 +0,0 @@
-/**
- * CLI integration tests
- */
-
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { createCLI } from '../index.js';
-import type { CommandClient, CommandResult } from '../types.js';
-
-/**
- * Create a mock client for testing
- */
-function createMockClient(overrides: Partial<CommandClient> = {}): CommandClient {
-  return {
-    execute: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    navigate: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    back: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    forward: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    reload: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    getUrl: vi.fn().mockResolvedValue('https://example.com'),
-    getTitle: vi.fn().mockResolvedValue('Example Page'),
-    snapshot: vi.fn().mockResolvedValue('- button "Submit" [@ref:1]'),
-    click: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    type: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    fill: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    getText: vi.fn().mockResolvedValue('Hello'),
-    isVisible: vi.fn().mockResolvedValue(true),
-    screenshot: vi.fn().mockResolvedValue('data:image/png;base64,ABC123'),
-    tabNew: vi.fn().mockResolvedValue({ tabId: 123, url: 'about:blank' }),
-    tabClose: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    tabSwitch: vi.fn().mockResolvedValue({ id: '1', success: true }),
-    tabList: vi.fn().mockResolvedValue([
-      { id: 1, url: 'https://example.com', title: 'Example', active: true, index: 0 },
-    ]),
-    ...overrides,
-  };
-}
-
-describe('createCLI', () => {
-  let client: CommandClient;
-  let cli: ReturnType<typeof createCLI>;
-
-  beforeEach(() => {
-    client = createMockClient();
-    cli = createCLI(client);
-  });
-
-  describe('execute - single commands', () => {
-    it('executes goto command', async () => {
-      const result = await cli.execute('goto https://example.com');
-      expect(result.success).toBe(true);
-      expect(client.navigate).toHaveBeenCalledWith('https://example.com');
-    });
-
-    it('executes snapshot command', async () => {
-      const result = await cli.execute('snapshot');
-      expect(result.success).toBe(true);
-      expect(client.snapshot).toHaveBeenCalled();
-    });
-
-    it('executes click command', async () => {
-      const result = await cli.execute('click @ref:1');
-      expect(result.success).toBe(true);
-      expect(client.click).toHaveBeenCalledWith('@ref:1', { button: undefined });
-    });
-
-    it('executes type command', async () => {
-      const result = await cli.execute('type @ref:1 "hello world"');
-      expect(result.success).toBe(true);
-      expect(client.type).toHaveBeenCalledWith('@ref:1', 'hello world', expect.any(Object));
-    });
-
-    it('executes help command', async () => {
-      const result = await cli.execute('help');
-      expect(result.success).toBe(true);
-      expect(result.data).toContain('Commands');
-    });
-
-    it('returns empty result for empty input', async () => {
-      const result = await cli.execute('');
-      expect(result.success).toBe(true);
-      expect(result.message).toBe('');
-    });
-
-    it('returns empty result for whitespace input', async () => {
-      const result = await cli.execute('   ');
-      expect(result.success).toBe(true);
-    });
-
-    it('handles unknown commands', async () => {
-      const result = await cli.execute('unknowncommand');
-      expect(result.success).toBe(false);
-      expect(result.error).toContain('Unknown command');
-    });
-
-    it('includes suggestions for typos', async () => {
-      const result = await cli.execute('clck @ref:1');
-      expect(result.success).toBe(false);
-      expect(result.error).toContain('click');
-    });
-  });
-
-  describe('execute - multi-line commands', () => {
-    it('executes multiple commands', async () => {
-      const result = await cli.execute(`
-        goto https://example.com
-        snapshot
-      `);
-      expect(result.success).toBe(true);
-      expect(client.navigate).toHaveBeenCalled();
-      expect(client.snapshot).toHaveBeenCalled();
-    });
-
-    it('stops on first error', async () => {
-      client = createMockClient({
-        navigate: vi.fn().mockResolvedValue({ id: '1', success: false, error: 'Failed' }),
-      });
-      cli = createCLI(client);
-
-      const result = await cli.execute(`
-        goto https://example.com
-        snapshot
-      `);
-      expect(result.success).toBe(false);
-      expect(client.snapshot).not.toHaveBeenCalled();
-    });
-
-    it('skips comment lines', async () => {
-      const result = await cli.execute(`
-        # Navigate first
-        goto https://example.com
-        # Then take snapshot
-        snapshot
-      `);
-      expect(result.success).toBe(true);
-      expect(client.navigate).toHaveBeenCalled();
-      expect(client.snapshot).toHaveBeenCalled();
-    });
-
-    it('skips empty lines', async () => {
-      const result = await cli.execute(`
-        goto https://example.com
-
-        snapshot
-      `);
-      expect(result.success).toBe(true);
-    });
-
-    it('returns last result data on success', async () => {
-      const result = await cli.execute(`
-        goto https://example.com
-        snapshot
-      `);
-      expect(result.data).toContain('button');
-    });
-
-    it('includes failure index in error data', async () => {
-      // Use click which properly handles error results, not snapshot
-      client = createMockClient({
-        click: vi.fn().mockResolvedValue({ id: '1', success: false, error: 'Element not found' }),
-      });
-      cli = createCLI(client);
-
-      const result = await cli.execute(`
-        goto https://example.com
-        click @ref:1
-      `);
-      expect(result.success).toBe(false);
-      expect(result.data).toHaveProperty('failedAt', 1);
-    });
-  });
-
-  describe('executeAll', () => {
-    it('returns batch result', async () => {
-      const result = await cli.executeAll(`
-        goto https://example.com
-        snapshot
-      `);
-      expect(result.allSucceeded).toBe(true);
-      expect(result.results.length).toBe(2);
-      expect(result.executed).toBe(2);
-      expect(result.firstFailedIndex).toBe(-1);
-    });
-
-    it('stops on error by default', async () => {
-      client = createMockClient({
-        navigate: vi.fn().mockResolvedValue({ id: '1', success: false, error: 'Failed' }),
-      });
-      cli = createCLI(client);
-
-      const result = await cli.executeAll(`
-        goto https://example.com
-        snapshot
-        click @ref:1
-      `);
-      expect(result.allSucceeded).toBe(false);
-      expect(result.executed).toBe(1);
-      expect(result.firstFailedIndex).toBe(0);
-    });
-
-    it('continues on error with flag', async () => {
-      client = createMockClient({
-        navigate: vi.fn().mockResolvedValue({ id: '1', success: false, error: 'Failed' }),
-      });
-      cli = createCLI(client);
-
-      const result = await cli.executeAll(
-        `
-          goto https://example.com
-          snapshot
-          click @ref:1
-        `,
-        { continueOnError: true }
-      );
-      expect(result.allSucceeded).toBe(false);
-      expect(result.executed).toBe(3);
-      expect(result.firstFailedIndex).toBe(0);
-    });
-
-    it('returns empty result for empty input', async () => {
-      const result = await cli.executeAll('');
-      expect(result.allSucceeded).toBe(true);
-      expect(result.results).toHaveLength(0);
-      expect(result.executed).toBe(0);
-    });
-  });
-
-  describe('getCommands', () => {
-    it('returns all commands', () => {
-      const commands = cli.getCommands();
-      expect(commands.length).toBeGreaterThan(0);
-      expect(commands.find((c) => c.name === 'goto')).toBeDefined();
-      expect(commands.find((c) => c.name === 'click')).toBeDefined();
-      expect(commands.find((c) => c.name === 'snapshot')).toBeDefined();
-    });
-
-    it('each command has required fields', () => {
-      const commands = cli.getCommands();
-      for (const cmd of commands) {
-        expect(cmd.name).toBeDefined();
-        expect(cmd.description).toBeDefined();
-        expect(cmd.usage).toBeDefined();
-        expect(cmd.execute).toBeInstanceOf(Function);
-      }
-    });
-  });
-
-  describe('getHelp', () => {
-    it('returns general help', () => {
-      const help = cli.getHelp();
-      expect(help).toContain('Commands');
-      expect(help).toContain('goto');
-      expect(help).toContain('click');
-    });
-
-    it('returns command-specific help', () => {
-      const help = cli.getHelp('goto');
-      expect(help).toContain('goto');
-      expect(help).toContain('Navigate');
-    });
-
-    it('returns error for unknown command', () => {
-      const help = cli.getHelp('unknowncommand');
-      expect(help).toContain('Unknown');
-    });
-  });
-});
-
-describe('command execution', () => {
-  let client: CommandClient;
-  let cli: ReturnType<typeof createCLI>;
-
-  beforeEach(() => {
-    client = createMockClient();
-    cli = createCLI(client);
-  });
-
-  describe('navigation commands', () => {
-    it('goto adds https if missing', async () => {
-      await cli.execute('goto example.com');
-      expect(client.navigate).toHaveBeenCalledWith('https://example.com');
-    });
-
-    it('goto preserves existing protocol', async () => {
-      await cli.execute('goto http://example.com');
-      expect(client.navigate).toHaveBeenCalledWith('http://example.com');
-    });
-
-    it('back calls client.back', async () => {
-      await cli.execute('back');
-      expect(client.back).toHaveBeenCalled();
-    });
-
-    it('forward calls client.forward', async () => {
-      await cli.execute('forward');
-      expect(client.forward).toHaveBeenCalled();
-    });
-
-    it('reload calls client.reload', async () => {
-      await cli.execute('reload');
-      expect(client.reload).toHaveBeenCalled();
-    });
-
-    it('reload --hard passes bypassCache', async () => {
-      await cli.execute('reload --hard');
-      expect(client.reload).toHaveBeenCalledWith({ bypassCache: true });
-    });
-  });
-
-  describe('interaction commands', () => {
-    it('click with right button', async () => {
-      await cli.execute('click @ref:1 --button right');
-      expect(client.click).toHaveBeenCalledWith('@ref:1', { button: 'right' });
-    });
-
-    it('type with delay', async () => {
-      await cli.execute('type @ref:1 hello --delay 50');
-      expect(client.type).toHaveBeenCalledWith('@ref:1', 'hello', expect.objectContaining({ delay: 50 }));
-    });
-
-    it('type with clear flag', async () => {
-      await cli.execute('type @ref:1 hello --clear');
-      expect(client.type).toHaveBeenCalledWith('@ref:1', 'hello', expect.objectContaining({ clear: true }));
-    });
-
-    it('fill sets value', async () => {
-      await cli.execute('fill @ref:1 "test value"');
-      expect(client.fill).toHaveBeenCalledWith('@ref:1', 'test value');
-    });
-  });
-
-  describe('tab commands', () => {
-    it('tabs lists tabs', async () => {
-      const result = await cli.execute('tabs');
-      expect(result.success).toBe(true);
-      expect(client.tabList).toHaveBeenCalled();
-    });
-
-    it('newtab opens new tab', async () => {
-      await cli.execute('newtab');
-      expect(client.tabNew).toHaveBeenCalled();
-    });
-
-    it('newtab with URL', async () => {
-      await cli.execute('newtab https://example.com');
-      expect(client.tabNew).toHaveBeenCalledWith(expect.objectContaining({
-        url: 'https://example.com',
-      }));
-    });
-
-    it('newtab --background', async () => {
-      await cli.execute('newtab --background');
-      expect(client.tabNew).toHaveBeenCalledWith(expect.objectContaining({
-        active: false,
-      }));
-    });
-
-    it('tab switches to tab', async () => {
-      await cli.execute('tab 123');
-      expect(client.tabSwitch).toHaveBeenCalledWith(123);
-    });
-
-    it('closetab closes current tab', async () => {
-      await cli.execute('closetab');
-      expect(client.tabClose).toHaveBeenCalledWith(undefined);
-    });
-
-    it('closetab closes specific tab', async () => {
-      await cli.execute('closetab 123');
-      expect(client.tabClose).toHaveBeenCalledWith(123);
-    });
-  });
-
-  describe('inspection commands', () => {
-    it('snapshot returns tree', async () => {
-      const result = await cli.execute('snapshot');
-      expect(result.success).toBe(true);
-      expect(result.data).toContain('button');
-    });
-
-    it('screenshot returns data URL', async () => {
-      const result = await cli.execute('screenshot');
-      expect(result.success).toBe(true);
-      expect(result.data).toContain('data:image');
-    });
-
-    it('url returns current URL', async () => {
-      const result = await cli.execute('url');
-      expect(result.success).toBe(true);
-      expect(result.data).toBe('https://example.com');
-    });
-
-    it('title returns page title', async () => {
-      const result = await cli.execute('title');
-      expect(result.success).toBe(true);
-      expect(result.data).toBe('Example Page');
-    });
-
-    it('text returns element text', async () => {
-      const result = await cli.execute('text @ref:1');
-      expect(result.success).toBe(true);
-      expect(result.data).toBe('Hello');
-    });
-  });
-});
-
-describe('error handling', () => {
-  it('handles client errors gracefully', async () => {
-    const client = createMockClient({
-      navigate: vi.fn().mockRejectedValue(new Error('Network error')),
-    });
-    const cli = createCLI(client);
-
-    const result = await cli.execute('goto https://example.com');
-    expect(result.success).toBe(false);
-    expect(result.error).toContain('Network error');
-  });
-
-  it('handles missing arguments', async () => {
-    const client = createMockClient();
-    const cli = createCLI(client);
-
-    const result = await cli.execute('goto');
-    expect(result.success).toBe(false);
-    expect(result.error).toContain('URL required');
-  });
-
-  it('handles invalid tab ID', async () => {
-    const client = createMockClient();
-    const cli = createCLI(client);
-
-    const result = await cli.execute('tab notanumber');
-    expect(result.success).toBe(false);
-  });
-});

package/packages/cli/src/__tests__/errors.test.ts

@@ -1,226 +0,0 @@
-/**
- * Error classes tests
- */
-
-import { describe, it, expect } from 'vitest';
-import {
-  CLIError,
-  CommandNotFoundError,
-  InvalidArgumentsError,
-  ParseError,
-  ExecutionError,
-  ElementNotFoundError,
-  NavigationError,
-  TimeoutError,
-} from '../errors.js';
-
-describe('CLIError', () => {
-  it('creates basic error', () => {
-    const error = new CLIError('Something went wrong');
-    expect(error.message).toBe('Something went wrong');
-    expect(error.name).toBe('CLIError');
-    expect(error).toBeInstanceOf(Error);
-  });
-
-  it('creates error with suggestions', () => {
-    const error = new CLIError('Error', {
-      suggestions: ['Try this', 'Or that'],
-    });
-    expect(error.suggestions).toEqual(['Try this', 'Or that']);
-  });
-
-  it('creates error with usage', () => {
-    const error = new CLIError('Error', { usage: 'command <arg>' });
-    expect(error.usage).toBe('command <arg>');
-  });
-
-  it('creates error with command', () => {
-    const error = new CLIError('Error', { command: 'click' });
-    expect(error.command).toBe('click');
-  });
-
-  describe('toFormattedString', () => {
-    it('formats basic error', () => {
-      const error = new CLIError('Something failed');
-      expect(error.toFormattedString()).toBe('Something failed');
-    });
-
-    it('includes usage in formatted output', () => {
-      const error = new CLIError('Missing argument', {
-        usage: 'click <selector>',
-      });
-      const formatted = error.toFormattedString();
-      expect(formatted).toContain('Missing argument');
-      expect(formatted).toContain('Usage: click <selector>');
-    });
-
-    it('includes suggestions in formatted output', () => {
-      const error = new CLIError('Error', {
-        suggestions: ['Try running snapshot first', 'Check the selector'],
-      });
-      const formatted = error.toFormattedString();
-      expect(formatted).toContain('Suggestions:');
-      expect(formatted).toContain('Try running snapshot first');
-      expect(formatted).toContain('Check the selector');
-    });
-
-    it('includes both usage and suggestions', () => {
-      const error = new CLIError('Error', {
-        usage: 'click <selector>',
-        suggestions: ['Use @ref:N format'],
-      });
-      const formatted = error.toFormattedString();
-      expect(formatted).toContain('Usage:');
-      expect(formatted).toContain('Suggestions:');
-    });
-  });
-});
-
-describe('CommandNotFoundError', () => {
-  it('creates error with command name', () => {
-    const error = new CommandNotFoundError('clck');
-    expect(error.message).toBe('Unknown command: clck');
-    expect(error.commandName).toBe('clck');
-    expect(error.name).toBe('CommandNotFoundError');
-  });
-
-  it('includes similar commands in suggestions', () => {
-    const error = new CommandNotFoundError('clck', ['click']);
-    expect(error.suggestions).toContain("Did you mean 'click'?");
-  });
-
-  it('includes multiple similar commands', () => {
-    const error = new CommandNotFoundError('chck', ['check', 'click']);
-    expect(error.suggestions?.length).toBe(2);
-  });
-
-  it('provides default suggestion when no similar commands', () => {
-    const error = new CommandNotFoundError('xyz');
-    expect(error.suggestions).toContain('Type "help" to see available commands');
-  });
-
-  it('provides default suggestion for empty similar commands', () => {
-    const error = new CommandNotFoundError('xyz', []);
-    expect(error.suggestions).toContain('Type "help" to see available commands');
-  });
-});
-
-describe('InvalidArgumentsError', () => {
-  it('creates error with message', () => {
-    const error = new InvalidArgumentsError('Missing selector');
-    expect(error.message).toBe('Missing selector');
-    expect(error.name).toBe('InvalidArgumentsError');
-  });
-
-  it('includes usage', () => {
-    const error = new InvalidArgumentsError('Missing selector', 'click <selector>');
-    expect(error.usage).toBe('click <selector>');
-  });
-
-  it('includes examples as suggestions', () => {
-    const error = new InvalidArgumentsError(
-      'Missing selector',
-      'click <selector>',
-      ['click @ref:5', 'click #submit']
-    );
-    expect(error.suggestions).toContain('Example: click @ref:5');
-    expect(error.suggestions).toContain('Example: click #submit');
-  });
-});
-
-describe('ParseError', () => {
-  it('creates error with message', () => {
-    const error = new ParseError('Unterminated quote');
-    expect(error.message).toBe('Unterminated quote');
-    expect(error.name).toBe('ParseError');
-  });
-
-  it('includes default suggestions', () => {
-    const error = new ParseError('Syntax error');
-    expect(error.suggestions?.length).toBeGreaterThan(0);
-    expect(error.suggestions?.some((s) => s.includes('quotes'))).toBe(true);
-  });
-
-  it('uses custom hint when provided', () => {
-    const error = new ParseError('Error', 'Custom hint');
-    expect(error.suggestions).toEqual(['Custom hint']);
-  });
-});
-
-describe('ExecutionError', () => {
-  it('creates error with message', () => {
-    const error = new ExecutionError('Execution failed');
-    expect(error.message).toBe('Execution failed');
-    expect(error.name).toBe('ExecutionError');
-  });
-
-  it('includes suggestions', () => {
-    const error = new ExecutionError('Failed', {
-      suggestions: ['Try again'],
-    });
-    expect(error.suggestions).toEqual(['Try again']);
-  });
-
-  it('includes command', () => {
-    const error = new ExecutionError('Failed', {
-      command: 'click',
-    });
-    expect(error.command).toBe('click');
-  });
-});
-
-describe('ElementNotFoundError', () => {
-  it('creates error with selector', () => {
-    const error = new ElementNotFoundError('@ref:5');
-    expect(error.message).toBe('Element not found: @ref:5');
-    expect(error.name).toBe('ElementNotFoundError');
-  });
-
-  it('includes helpful suggestions', () => {
-    const error = new ElementNotFoundError('@ref:5');
-    expect(error.suggestions?.some((s) => s.includes('snapshot'))).toBe(true);
-    expect(error.suggestions?.some((s) => s.includes('wait'))).toBe(true);
-  });
-
-  it('includes selector in wait suggestion', () => {
-    const error = new ElementNotFoundError('#my-button');
-    expect(error.suggestions?.some((s) => s.includes('#my-button'))).toBe(true);
-  });
-});
-
-describe('NavigationError', () => {
-  it('creates error with URL', () => {
-    const error = new NavigationError('https://example.com');
-    expect(error.message).toContain('example.com');
-    expect(error.name).toBe('NavigationError');
-  });
-
-  it('creates error with reason', () => {
-    const error = new NavigationError('https://example.com', 'Network error');
-    expect(error.message).toContain('Network error');
-  });
-
-  it('includes protocol suggestion', () => {
-    const error = new NavigationError('example.com');
-    expect(error.suggestions?.some((s) => s.includes('https://'))).toBe(true);
-  });
-});
-
-describe('TimeoutError', () => {
-  it('creates error with operation', () => {
-    const error = new TimeoutError('waiting for element');
-    expect(error.message).toBe('Timeout: waiting for element');
-    expect(error.name).toBe('TimeoutError');
-  });
-
-  it('includes general suggestions', () => {
-    const error = new TimeoutError('operation');
-    expect(error.suggestions?.some((s) => s.includes('wait'))).toBe(true);
-    expect(error.suggestions?.some((s) => s.includes('snapshot'))).toBe(true);
-  });
-
-  it('includes selector-specific suggestion when provided', () => {
-    const error = new TimeoutError('waiting', '@ref:5');
-    expect(error.suggestions?.some((s) => s.includes('@ref:5'))).toBe(true);
-  });
-});