@accomplish_ai/agent-core 0.2.0 → 0.2.2

package/mcp-tools/dev-browser-mcp/src/snapshot/manager.test.ts

@@ -1,247 +0,0 @@
-// packages/core/mcp-tools/dev-browser-mcp/src/snapshot/manager.test.ts
-
-import { describe, it, expect, beforeEach } from 'vitest';
-import { SnapshotManager } from './manager.js';
-
-describe('SnapshotManager', () => {
-  let manager: SnapshotManager;
-
-  beforeEach(() => {
-    manager = new SnapshotManager();
-  });
-
-  const simpleSnapshot = `- button "Submit" [ref=e1]`;
-
-  it('returns full snapshot on first call', () => {
-    const result = manager.processSnapshot(
-      simpleSnapshot,
-      'https://example.com',
-      'Test Page'
-    );
-
-    expect(result.type).toBe('full');
-    expect(result.content).toBe(simpleSnapshot);
-  });
-
-  it('returns diff on second call with same page', () => {
-    // First call
-    manager.processSnapshot(simpleSnapshot, 'https://example.com', 'Test');
-
-    // Second call - same URL
-    const result = manager.processSnapshot(
-      simpleSnapshot,
-      'https://example.com',
-      'Test'
-    );
-
-    expect(result.type).toBe('diff');
-  });
-
-  it('returns full snapshot when URL changes', () => {
-    // First call
-    manager.processSnapshot(simpleSnapshot, 'https://example.com/page1', 'Page 1');
-
-    // Second call - different URL
-    const result = manager.processSnapshot(
-      simpleSnapshot,
-      'https://example.com/page2',
-      'Page 2'
-    );
-
-    expect(result.type).toBe('full');
-  });
-
-  it('returns full snapshot when full_snapshot option is true', () => {
-    // First call
-    manager.processSnapshot(simpleSnapshot, 'https://example.com', 'Test');
-
-    // Second call with full_snapshot: true
-    const result = manager.processSnapshot(
-      simpleSnapshot,
-      'https://example.com',
-      'Test',
-      { fullSnapshot: true }
-    );
-
-    expect(result.type).toBe('full');
-  });
-
-  it('normalizes URLs for same-page detection', () => {
-    // First call
-    manager.processSnapshot(simpleSnapshot, 'https://example.com/page#section1', 'Test');
-
-    // Second call - same URL, different hash
-    const result = manager.processSnapshot(
-      simpleSnapshot,
-      'https://example.com/page#section2',
-      'Test'
-    );
-
-    expect(result.type).toBe('diff');
-  });
-
-  it('resets state correctly', () => {
-    // First call
-    manager.processSnapshot(simpleSnapshot, 'https://example.com', 'Test');
-
-    // Reset
-    manager.reset();
-
-    // Should act like first call again
-    const result = manager.processSnapshot(
-      simpleSnapshot,
-      'https://example.com',
-      'Test'
-    );
-
-    expect(result.type).toBe('full');
-  });
-
-  describe('session history', () => {
-    it('should track navigation history', () => {
-      // Process snapshots for different pages
-      manager.processSnapshot(simpleSnapshot, 'https://example.com/page1', 'Page 1');
-      manager.processSnapshot(simpleSnapshot, 'https://example.com/page2', 'Page 2');
-      manager.processSnapshot(simpleSnapshot, 'https://example.com/page3', 'Page 3');
-
-      const summary = manager.getSessionSummary();
-      expect(summary.history).toContain('Page 1');
-      expect(summary.history).toContain('Page 2');
-      expect(summary.history).toContain('Page 3');
-      expect(summary.pagesVisited).toBe(3);
-    });
-
-    it('should limit history to 10 entries', () => {
-      for (let i = 0; i < 15; i++) {
-        manager.processSnapshot(
-          simpleSnapshot,
-          `https://example.com/page${i}`,
-          `Page ${i}`
-        );
-      }
-
-      const summary = manager.getSessionSummary();
-      expect(summary.pagesVisited).toBe(10);
-      expect(summary.history).not.toContain('Page 0');
-      expect(summary.history).toContain('Page 14');
-    });
-
-    it('should reset history on manager reset', () => {
-      manager.processSnapshot(simpleSnapshot, 'https://example.com', 'Home');
-      manager.reset();
-
-      const summary = manager.getSessionSummary();
-      expect(summary.pagesVisited).toBe(0);
-    });
-  });
-
-  describe('full optimization pipeline', () => {
-    it('should produce optimized output with all tiers', () => {
-      // Create test YAML with various element types
-      const yaml1 = `- button "Home" [ref=e1]
-- link "About" [ref=e2]
-- navigation "Main Nav" [ref=e3]`;
-
-      const yaml2 = `- button "Search" [ref=e4]
-- textbox "Query" [ref=e5]
-- link "Results" [ref=e6]`;
-
-      // Simulate navigation to first page
-      const result1 = manager.processSnapshot(
-        yaml1,
-        'https://example.com/home',
-        'Home',
-        {}
-      );
-
-      // First snapshot should be full
-      expect(result1.type).toBe('full');
-      expect(result1.content).toBe(yaml1);
-
-      // Simulate navigation to second page
-      const result2 = manager.processSnapshot(
-        yaml2,
-        'https://example.com/search',
-        'Search',
-        {}
-      );
-
-      // New page should also be full snapshot
-      expect(result2.type).toBe('full');
-      expect(result2.content).toBe(yaml2);
-
-      // Verify session tracking
-      const summary = manager.getSessionSummary();
-      expect(summary.pagesVisited).toBe(2);
-      expect(summary.history).toContain('Home');
-      expect(summary.history).toContain('Search');
-    });
-
-    it('should use diff for same-page updates', () => {
-      const initialYaml = `- button "Submit" [ref=e1]
-- textbox "Name" [ref=e2]`;
-
-      const updatedYaml = `- button "Submit" [ref=e1]
-- textbox "Name" [ref=e2]
-- text "Success!" [ref=e3]`;
-
-      // First snapshot
-      const result1 = manager.processSnapshot(
-        initialYaml,
-        'https://example.com/form',
-        'Form Page',
-        {}
-      );
-      expect(result1.type).toBe('full');
-
-      // Same page update should use diff
-      const result2 = manager.processSnapshot(
-        updatedYaml,
-        'https://example.com/form',
-        'Form Page',
-        {}
-      );
-      expect(result2.type).toBe('diff');
-
-      // Session should show only one unique page visit path
-      const summary = manager.getSessionSummary();
-      expect(summary.pagesVisited).toBe(2); // Both snapshots recorded
-      expect(summary.history).toContain('Form Page');
-    });
-
-    it('should combine navigation tracking with diff optimization', () => {
-      // Simulate a real user flow: home -> search -> results -> back to search
-      const homeYaml = `- link "Search" [ref=e1]
-- navigation "Main" [ref=e2]`;
-
-      const searchYaml = `- textbox "Query" [ref=e3]
-- button "Search" [ref=e4]`;
-
-      const searchWithResultsYaml = `- textbox "Query" [ref=e3]
-- button "Search" [ref=e4]
-- link "Result 1" [ref=e5]
-- link "Result 2" [ref=e6]`;
-
-      // Visit home
-      manager.processSnapshot(homeYaml, 'https://example.com/', 'Home', {});
-
-      // Navigate to search
-      manager.processSnapshot(searchYaml, 'https://example.com/search', 'Search', {});
-
-      // Update search page with results (same page, should diff)
-      const resultUpdate = manager.processSnapshot(
-        searchWithResultsYaml,
-        'https://example.com/search',
-        'Search',
-        {}
-      );
-      expect(resultUpdate.type).toBe('diff');
-
-      // Verify full navigation history is tracked
-      const summary = manager.getSessionSummary();
-      expect(summary.pagesVisited).toBe(3);
-      expect(summary.history).toContain('Home');
-      expect(summary.history).toContain('Search');
-    });
-  });
-});

package/mcp-tools/dev-browser-mcp/src/snapshot/manager.ts

@@ -1,131 +0,0 @@
-import type { ParsedSnapshot, SnapshotResult, SessionHistoryEntry, SessionSummary } from './types.js';
-import { parseSnapshot } from './parser.js';
-import { diffSnapshots, formatDiff } from './differ.js';
-
-const SNAPSHOT_TIMEOUT_MS = 30000;
-
-export interface SnapshotManagerOptions {
-  fullSnapshot?: boolean;
-  interactiveOnly?: boolean;
-}
-
-export class SnapshotManager {
-  private lastSnapshot: ParsedSnapshot | null = null;
-  private lastTimestamp: number = 0;
-  private sessionHistory: SessionHistoryEntry[] = [];
-  private readonly MAX_HISTORY_SIZE = 10;
-
-  processSnapshot(
-    rawYaml: string,
-    url: string,
-    title: string,
-    options: SnapshotManagerOptions = {}
-  ): SnapshotResult {
-    const currentSnapshot = parseSnapshot(rawYaml, url, title);
-    const now = Date.now();
-
-    this.recordNavigation(url, title);
-
-    if (
-      options.fullSnapshot ||
-      !this.lastSnapshot ||
-      now - this.lastTimestamp > SNAPSHOT_TIMEOUT_MS
-    ) {
-      this.updateState(currentSnapshot, now);
-      return { type: 'full', content: rawYaml };
-    }
-
-    if (this.isSamePage(currentSnapshot.url)) {
-      const diff = diffSnapshots(this.lastSnapshot, currentSnapshot);
-
-      if (!diff) {
-        this.updateState(currentSnapshot, now);
-        return { type: 'full', content: rawYaml };
-      }
-
-      this.updateState(currentSnapshot, now);
-      const formattedDiff = formatDiff(diff, url, title);
-      return {
-        type: 'diff',
-        content: formattedDiff,
-        unchangedRefs: diff.unchangedRefs,
-      };
-    }
-
-    this.updateState(currentSnapshot, now);
-    return { type: 'full', content: rawYaml };
-  }
-
-  reset(): void {
-    this.lastSnapshot = null;
-    this.lastTimestamp = 0;
-    this.sessionHistory = [];
-  }
-
-  private isSamePage(currentUrl: string): boolean {
-    if (!this.lastSnapshot) return false;
-
-    const normalizedCurrent = this.normalizeUrl(currentUrl);
-    const normalizedLast = this.normalizeUrl(this.lastSnapshot.url);
-
-    return normalizedCurrent === normalizedLast;
-  }
-
-  private normalizeUrl(url: string): string {
-    try {
-      const parsed = new URL(url);
-      parsed.hash = '';
-      return parsed.toString();
-    } catch {
-      return url;
-    }
-  }
-
-  private updateState(snapshot: ParsedSnapshot, timestamp: number): void {
-    this.lastSnapshot = snapshot;
-    this.lastTimestamp = timestamp;
-  }
-
-  private recordNavigation(url: string, title: string): void {
-    this.sessionHistory.push({
-      url,
-      title,
-      timestamp: Date.now(),
-      actionsTaken: [],
-    });
-
-    if (this.sessionHistory.length > this.MAX_HISTORY_SIZE) {
-      this.sessionHistory = this.sessionHistory.slice(-this.MAX_HISTORY_SIZE);
-    }
-  }
-
-  public getSessionSummary(): SessionSummary {
-    if (this.sessionHistory.length === 0) {
-      return { history: '', pagesVisited: 0 };
-    }
-
-    const history = this.sessionHistory
-      .map(h => h.title || new URL(h.url).pathname)
-      .join(' → ');
-
-    return {
-      history,
-      pagesVisited: this.sessionHistory.length,
-    };
-  }
-}
-
-let snapshotManagerInstance: SnapshotManager | null = null;
-
-export function getSnapshotManager(): SnapshotManager {
-  if (!snapshotManagerInstance) {
-    snapshotManagerInstance = new SnapshotManager();
-  }
-  return snapshotManagerInstance;
-}
-
-export function resetSnapshotManager(): void {
-  if (snapshotManagerInstance) {
-    snapshotManagerInstance.reset();
-  }
-}

package/mcp-tools/dev-browser-mcp/src/snapshot/parser.test.ts

@@ -1,94 +0,0 @@
-// packages/core/mcp-tools/dev-browser-mcp/src/snapshot/parser.test.ts
-
-import { describe, it, expect } from 'vitest';
-import { parseSnapshot, extractTitleFromSnapshot } from './parser.js';
-
-describe('parseSnapshot', () => {
-  it('parses a simple element with ref', () => {
-    const yaml = `- button "Submit" [ref=e1]`;
-    const result = parseSnapshot(yaml, 'https://example.com', 'Test Page');
-
-    expect(result.elements.size).toBe(1);
-    expect(result.elements.get('e1')).toEqual({
-      ref: 'e1',
-      role: 'button',
-      name: 'Submit',
-    });
-  });
-
-  it('parses element with value', () => {
-    const yaml = `- textbox "Email" [ref=e1]: "user@example.com"`;
-    const result = parseSnapshot(yaml, 'https://example.com', 'Test');
-
-    expect(result.elements.get('e1')?.value).toBe('user@example.com');
-  });
-
-  it('parses disabled attribute', () => {
-    const yaml = `- button "Submit" [ref=e1] [disabled]`;
-    const result = parseSnapshot(yaml, 'https://example.com', 'Test');
-
-    expect(result.elements.get('e1')?.disabled).toBe(true);
-  });
-
-  it('parses checked attribute', () => {
-    const yaml = `- checkbox "Agree" [ref=e1] [checked]`;
-    const result = parseSnapshot(yaml, 'https://example.com', 'Test');
-
-    expect(result.elements.get('e1')?.checked).toBe(true);
-  });
-
-  it('parses checked=mixed attribute', () => {
-    const yaml = `- checkbox "Partial" [ref=e1] [checked=mixed]`;
-    const result = parseSnapshot(yaml, 'https://example.com', 'Test');
-
-    expect(result.elements.get('e1')?.checked).toBe('mixed');
-  });
-
-  it('parses multiple elements', () => {
-    const yaml = `
-- textbox "Email" [ref=e1]
-- textbox "Password" [ref=e2]
-- button "Login" [ref=e3]
-    `.trim();
-    const result = parseSnapshot(yaml, 'https://example.com', 'Login');
-
-    expect(result.elements.size).toBe(3);
-    expect(result.elements.has('e1')).toBe(true);
-    expect(result.elements.has('e2')).toBe(true);
-    expect(result.elements.has('e3')).toBe(true);
-  });
-
-  it('skips elements without refs', () => {
-    const yaml = `
-- heading "Welcome"
-- button "Submit" [ref=e1]
-    `.trim();
-    const result = parseSnapshot(yaml, 'https://example.com', 'Test');
-
-    expect(result.elements.size).toBe(1);
-    expect(result.elements.has('e1')).toBe(true);
-  });
-
-  it('stores url and title', () => {
-    const yaml = `- button "Test" [ref=e1]`;
-    const result = parseSnapshot(yaml, 'https://example.com/page', 'My Page');
-
-    expect(result.url).toBe('https://example.com/page');
-    expect(result.title).toBe('My Page');
-  });
-});
-
-describe('extractTitleFromSnapshot', () => {
-  it('extracts title from Page Title header', () => {
-    const snapshot = `# Page Info
-Page Title: My Login Page
-URL: https://example.com`;
-
-    expect(extractTitleFromSnapshot(snapshot)).toBe('My Login Page');
-  });
-
-  it('returns empty string if no title found', () => {
-    const snapshot = `# Some other content`;
-    expect(extractTitleFromSnapshot(snapshot)).toBe('');
-  });
-});

package/mcp-tools/dev-browser-mcp/src/snapshot/parser.ts

@@ -1,81 +0,0 @@
-import type { SnapshotElement, ParsedSnapshot } from './types.js';
-
-export function parseSnapshot(
-  yamlSnapshot: string,
-  url: string,
-  title: string
-): ParsedSnapshot {
-  const elements = new Map<string, SnapshotElement>();
-  const lines = yamlSnapshot.split('\n');
-
-  const elementRegex = /^(\s*)-\s+(\w+)(?:\s+"([^"]*)"|\s+'([^']*)')?(.*)$/;
-  const refRegex = /\[ref=(e\d+)\]/;
-  const valueRegex = /:\s*"([^"]*)"\s*$/;
-  const checkedRegex = /\[checked(?:=(\w+))?\]/;
-  const disabledRegex = /\[disabled\]/;
-  const expandedRegex = /\[expanded\]/;
-  const selectedRegex = /\[selected\]/;
-  const levelRegex = /\[level=(\d+)\]/;
-  const pressedRegex = /\[pressed(?:=(\w+))?\]/;
-
-  for (const line of lines) {
-    const match = line.match(elementRegex);
-    if (!match) continue;
-
-    const [, , role, nameDouble, nameSingle, rest] = match;
-    const name = nameDouble ?? nameSingle ?? '';
-
-    const refMatch = rest.match(refRegex);
-    if (!refMatch) continue;
-
-    const ref = refMatch[1];
-    const element: SnapshotElement = { ref, role, name };
-
-    const valueMatch = line.match(valueRegex);
-    if (valueMatch) {
-      element.value = valueMatch[1];
-    }
-
-    const checkedMatch = rest.match(checkedRegex);
-    if (checkedMatch) {
-      element.checked = checkedMatch[1] === 'mixed' ? 'mixed' : true;
-    }
-
-    if (disabledRegex.test(rest)) {
-      element.disabled = true;
-    }
-
-    if (expandedRegex.test(rest)) {
-      element.expanded = true;
-    }
-
-    if (selectedRegex.test(rest)) {
-      element.selected = true;
-    }
-
-    const levelMatch = rest.match(levelRegex);
-    if (levelMatch) {
-      element.level = parseInt(levelMatch[1], 10);
-    }
-
-    const pressedMatch = rest.match(pressedRegex);
-    if (pressedMatch) {
-      element.pressed = pressedMatch[1] === 'mixed' ? 'mixed' : true;
-    }
-
-    elements.set(ref, element);
-  }
-
-  return {
-    url,
-    title,
-    timestamp: Date.now(),
-    elements,
-    rawYaml: yamlSnapshot,
-  };
-}
-
-export function extractTitleFromSnapshot(snapshot: string): string {
-  const titleMatch = snapshot.match(/(?:Page Title|Title):\s*(.+)/i);
-  return titleMatch ? titleMatch[1].trim() : '';
-}

package/mcp-tools/dev-browser-mcp/src/snapshot/priority.test.ts

@@ -1,104 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { getElementPriority, ROLE_PRIORITIES, truncateElements, type TruncatableElement } from './priority';
-
-describe('priority scoring', () => {
-  describe('getElementPriority', () => {
-    it('should score buttons highest', () => {
-      const score = getElementPriority('button', true);
-      expect(score).toBe(150); // 100 base + 50 viewport bonus
-    });
-
-    it('should score textbox high', () => {
-      const score = getElementPriority('textbox', true);
-      expect(score).toBe(145); // 95 base + 50 viewport bonus
-    });
-
-    it('should give viewport bonus', () => {
-      const inViewport = getElementPriority('link', true);
-      const outViewport = getElementPriority('link', false);
-      expect(inViewport - outViewport).toBe(50);
-    });
-
-    it('should default unknown roles to 50', () => {
-      const score = getElementPriority('unknown-role', false);
-      expect(score).toBe(50);
-    });
-
-    it('should score navigation lower than primary inputs', () => {
-      const navigation = getElementPriority('navigation', false);
-      const button = getElementPriority('button', false);
-      expect(button).toBeGreaterThan(navigation);
-    });
-  });
-
-  describe('ROLE_PRIORITIES', () => {
-    it('should define priorities for all interactive roles', () => {
-      const interactiveRoles = [
-        'button', 'link', 'textbox', 'checkbox', 'radio',
-        'combobox', 'listbox', 'option', 'tab', 'menuitem',
-      ];
-      for (const role of interactiveRoles) {
-        expect(ROLE_PRIORITIES[role]).toBeDefined();
-        expect(ROLE_PRIORITIES[role]).toBeGreaterThan(0);
-      }
-    });
-  });
-});
-
-describe('truncateElements', () => {
-  const createElements = (count: number, role = 'button', inViewport = true): TruncatableElement[] => {
-    return Array.from({ length: count }, (_, i) => ({
-      ref: `e${i + 1}`,
-      role,
-      name: `Element ${i + 1}`,
-      inViewport,
-    }));
-  };
-
-  it('should return all elements when under limit', () => {
-    const elements = createElements(5);
-    const result = truncateElements(elements, { maxElements: 10 });
-    expect(result.elements).toHaveLength(5);
-    expect(result.truncated).toBe(false);
-  });
-
-  it('should truncate to maxElements', () => {
-    const elements = createElements(100);
-    const result = truncateElements(elements, { maxElements: 50 });
-    expect(result.elements).toHaveLength(50);
-    expect(result.truncated).toBe(true);
-    expect(result.totalElements).toBe(100);
-  });
-
-  it('should prioritize viewport elements', () => {
-    const inViewport = createElements(5, 'button', true);
-    const outViewport = createElements(5, 'button', false);
-    const mixed = [...outViewport, ...inViewport]; // Out of viewport first
-
-    const result = truncateElements(mixed, { maxElements: 5 });
-
-    // Should keep all viewport elements
-    expect(result.elements.every(e => e.inViewport)).toBe(true);
-  });
-
-  it('should prioritize by role', () => {
-    const buttons = createElements(3, 'button', false);
-    const links = createElements(3, 'link', false);
-    const navs = createElements(3, 'navigation', false);
-    const mixed = [...navs, ...links, ...buttons]; // Lowest priority first
-
-    const result = truncateElements(mixed, { maxElements: 3 });
-
-    // Should keep buttons (highest priority)
-    expect(result.elements.every(e => e.role === 'button')).toBe(true);
-  });
-
-  it('should return metadata about truncation', () => {
-    const elements = createElements(100);
-    const result = truncateElements(elements, { maxElements: 30 });
-
-    expect(result.totalElements).toBe(100);
-    expect(result.includedElements).toBe(30);
-    expect(result.truncated).toBe(true);
-  });
-});