npm - btcp-browser-agent - Versions diffs - 0.1.0 → 0.1.2 - Mend

btcp-browser-agent 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (136) hide show

package/package.json +8 -9
package/packages/core/dist/actions.d.ts +97 -0
package/packages/core/dist/actions.js +940 -0
package/packages/core/dist/errors.d.ts +138 -0
package/packages/core/dist/errors.js +157 -0
package/packages/core/dist/index.d.ts +120 -0
package/packages/core/dist/index.js +134 -0
package/packages/core/dist/ref-map.d.ts +16 -0
package/packages/core/dist/ref-map.js +91 -0
package/packages/core/dist/snapshot.d.ts +37 -0
package/packages/core/dist/snapshot.js +751 -0
package/packages/core/dist/types.d.ts +396 -0
package/packages/core/dist/types.js +7 -0
package/packages/extension/dist/background.d.ts +227 -0
package/packages/extension/dist/background.js +737 -0
package/packages/extension/dist/content.d.ts +18 -0
package/packages/extension/dist/content.js +149 -0
package/packages/extension/dist/index.d.ts +228 -0
package/packages/extension/dist/index.js +350 -0
package/packages/extension/dist/session-manager.d.ts +87 -0
package/packages/extension/dist/session-manager.js +322 -0
package/packages/extension/{src/session-types.ts → dist/session-types.d.ts} +113 -144
package/packages/extension/dist/session-types.js +5 -0
package/packages/extension/dist/types.d.ts +88 -0
package/packages/extension/dist/types.js +7 -0
package/CLAUDE.md +0 -230
package/SKILL.md +0 -143
package/SNAPSHOT_IMPROVEMENTS.md +0 -302
package/USAGE.md +0 -146
package/dist/index.d.ts.map +0 -1
package/dist/index.js.map +0 -1
package/docs/browser-cli-design.md +0 -500
package/examples/chrome-extension/CHANGELOG.md +0 -210
package/examples/chrome-extension/DEBUG.md +0 -231
package/examples/chrome-extension/ERROR_FIXED.md +0 -147
package/examples/chrome-extension/QUICK_TEST.md +0 -189
package/examples/chrome-extension/README.md +0 -149
package/examples/chrome-extension/SESSION_ONLY_MODE.md +0 -305
package/examples/chrome-extension/TEST_WITH_YOUR_TABS.md +0 -97
package/examples/chrome-extension/build.js +0 -43
package/examples/chrome-extension/manifest.json +0 -37
package/examples/chrome-extension/package-lock.json +0 -1063
package/examples/chrome-extension/package.json +0 -21
package/examples/chrome-extension/popup.html +0 -195
package/examples/chrome-extension/src/background.ts +0 -12
package/examples/chrome-extension/src/content.ts +0 -7
package/examples/chrome-extension/src/popup.ts +0 -303
package/examples/chrome-extension/src/scenario-google-github.ts +0 -389
package/examples/chrome-extension/test-page.html +0 -127
package/examples/chrome-extension/tests/README.md +0 -206
package/examples/chrome-extension/tests/scenario-google-to-github-star.ts +0 -380
package/examples/chrome-extension/tsconfig.json +0 -14
package/examples/snapshots/README.md +0 -207
package/examples/snapshots/amazon-com-detail.html +0 -9528
package/examples/snapshots/amazon-com-detail.snapshot.txt +0 -997
package/examples/snapshots/convert-snapshots.ts +0 -97
package/examples/snapshots/edition-cnn-com.html +0 -13292
package/examples/snapshots/edition-cnn-com.snapshot.txt +0 -562
package/examples/snapshots/github-com-microsoft-vscode.html +0 -2916
package/examples/snapshots/github-com-microsoft-vscode.snapshot.txt +0 -455
package/examples/snapshots/google-search.html +0 -20012
package/examples/snapshots/google-search.snapshot.txt +0 -195
package/examples/snapshots/metadata.json +0 -86
package/examples/snapshots/npr-org-templates.html +0 -2031
package/examples/snapshots/npr-org-templates.snapshot.txt +0 -224
package/examples/snapshots/stackoverflow-com.html +0 -5216
package/examples/snapshots/stackoverflow-com.snapshot.txt +0 -2404
package/examples/snapshots/test-all-mode.html +0 -46
package/examples/snapshots/test-all-mode.snapshot.txt +0 -5
package/examples/snapshots/validate.test.ts +0 -296
package/packages/cli/package.json +0 -42
package/packages/cli/src/__tests__/cli.test.ts +0 -434
package/packages/cli/src/__tests__/errors.test.ts +0 -226
package/packages/cli/src/__tests__/executor.test.ts +0 -275
package/packages/cli/src/__tests__/formatter.test.ts +0 -260
package/packages/cli/src/__tests__/parser.test.ts +0 -288
package/packages/cli/src/__tests__/suggestions.test.ts +0 -255
package/packages/cli/src/commands/back.ts +0 -22
package/packages/cli/src/commands/check.ts +0 -33
package/packages/cli/src/commands/clear.ts +0 -33
package/packages/cli/src/commands/click.ts +0 -32
package/packages/cli/src/commands/closetab.ts +0 -31
package/packages/cli/src/commands/eval.ts +0 -41
package/packages/cli/src/commands/fill.ts +0 -30
package/packages/cli/src/commands/focus.ts +0 -33
package/packages/cli/src/commands/forward.ts +0 -22
package/packages/cli/src/commands/goto.ts +0 -34
package/packages/cli/src/commands/help.ts +0 -162
package/packages/cli/src/commands/hover.ts +0 -34
package/packages/cli/src/commands/index.ts +0 -129
package/packages/cli/src/commands/newtab.ts +0 -35
package/packages/cli/src/commands/press.ts +0 -40
package/packages/cli/src/commands/reload.ts +0 -25
package/packages/cli/src/commands/screenshot.ts +0 -27
package/packages/cli/src/commands/scroll.ts +0 -64
package/packages/cli/src/commands/select.ts +0 -35
package/packages/cli/src/commands/snapshot.ts +0 -21
package/packages/cli/src/commands/tab.ts +0 -32
package/packages/cli/src/commands/tabs.ts +0 -26
package/packages/cli/src/commands/text.ts +0 -27
package/packages/cli/src/commands/title.ts +0 -17
package/packages/cli/src/commands/type.ts +0 -38
package/packages/cli/src/commands/uncheck.ts +0 -33
package/packages/cli/src/commands/url.ts +0 -17
package/packages/cli/src/commands/wait.ts +0 -54
package/packages/cli/src/errors.ts +0 -164
package/packages/cli/src/executor.ts +0 -68
package/packages/cli/src/formatter.ts +0 -215
package/packages/cli/src/index.ts +0 -257
package/packages/cli/src/parser.ts +0 -195
package/packages/cli/src/suggestions.ts +0 -207
package/packages/cli/src/terminal/Terminal.ts +0 -365
package/packages/cli/src/terminal/index.ts +0 -5
package/packages/cli/src/types.ts +0 -155
package/packages/cli/tsconfig.json +0 -20
package/packages/core/package.json +0 -35
package/packages/core/src/actions.ts +0 -1210
package/packages/core/src/errors.ts +0 -296
package/packages/core/src/index.test.ts +0 -638
package/packages/core/src/index.ts +0 -220
package/packages/core/src/ref-map.ts +0 -107
package/packages/core/src/snapshot.ts +0 -873
package/packages/core/src/types.ts +0 -536
package/packages/core/tsconfig.json +0 -23
package/packages/extension/README.md +0 -129
package/packages/extension/package.json +0 -43
package/packages/extension/src/background.ts +0 -888
package/packages/extension/src/content.ts +0 -172
package/packages/extension/src/index.ts +0 -579
package/packages/extension/src/session-manager.ts +0 -385
package/packages/extension/src/types.ts +0 -162
package/packages/extension/tsconfig.json +0 -28
package/src/index.ts +0 -64
package/tsconfig.build.json +0 -12
package/tsconfig.json +0 -26
package/vitest.config.ts +0 -13

package/examples/snapshots/test-all-mode.html DELETED Viewed

@@ -1,46 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Test All Mode - Images, Headings, and Text</title>
-</head>
-<body>
-    <header>
-        <h1>Welcome to Our Website</h1>
-        <img src="/images/logo.png" alt="Company Logo" />
-    </header>
-    <main>
-        <section>
-            <h2>About Us</h2>
-            <p>We are a leading provider of innovative solutions for modern businesses. Our team has over 20 years of experience in delivering exceptional results.</p>
-            <img src="/images/team.jpg" alt="Our dedicated team working together" title="Team collaboration" />
-        </section>
-        <section>
-            <h2>Our Services</h2>
-            <h3>Consulting</h3>
-            <p>Expert consulting services to help your business grow and thrive in today's competitive market.</p>
-            <h3>Development</h3>
-            <p>Custom software development tailored to your specific needs and requirements.</p>
-            <img src="/images/code.png" alt="Code editor showing programming" />
-        </section>
-        <section>
-            <h2>Contact Us</h2>
-            <form>
-                <label for="email">Email:</label>
-                <input type="email" id="email" name="email" />
-                <button type="submit">Submit</button>
-            </form>
-        </section>
-    </main>
-    <footer>
-        <p>Copyright 2025 - All rights reserved</p>
-        <img src="footer-logo.png" alt="Footer brand logo" />
-    </footer>
-</body>
-</html>

package/examples/snapshots/test-all-mode.snapshot.txt DELETED Viewed

@@ -1,5 +0,0 @@
-PAGE: http://localhost/ | Test All Mode - Images, Headings, and Text | viewport=1024x768
-SNAPSHOT: elements=25 refs=2
-TEXTBOX "Email:" @ref:0 [type=email] /main/section[3]/form/input#email
-BUTTON "Submit" @ref:1 /main/section[3]/form/button

package/examples/snapshots/validate.test.ts DELETED Viewed

@@ -1,296 +0,0 @@
-/**
- * Validation tests for real-world HTML snapshots
- *
- * Tests snapshot structure and smart label selection against real-world websites
- */
-import { describe, it, expect, beforeEach } from 'vitest';
-import { readFileSync, readdirSync } from 'fs';
-import { join } from 'path';
-import { JSDOM, VirtualConsole } from 'jsdom';
-import { createSnapshot } from '../../packages/core/src/snapshot.js';
-import { createSimpleRefMap } from '../../packages/core/src/ref-map.js';
-const SNAPSHOTS_DIR = join(__dirname);
-// Helper to load HTML and generate snapshot
-function generateSnapshotFromHTML(htmlPath: string) {
-  const html = readFileSync(htmlPath, 'utf-8');
-  const virtualConsole = new VirtualConsole();
-  virtualConsole.on('error', () => {});
-  virtualConsole.on('warn', () => {});
-  const dom = new JSDOM(html, {
-    url: 'http://localhost',
-    contentType: 'text/html',
-    pretendToBeVisual: true,
-    virtualConsole,
-  });
-  const { document } = dom.window;
-  const refMap = createSimpleRefMap();
-  return createSnapshot(document, refMap, {
-    interactive: true,
-    compact: true,
-    maxDepth: 10,
-    includeHidden: false,
-  });
-}
-// Find all HTML test files
-const htmlFiles = readdirSync(SNAPSHOTS_DIR)
-  .filter(f => f.endsWith('.html'))
-  .map(f => ({
-    name: f.replace('.html', ''),
-    path: join(SNAPSHOTS_DIR, f),
-  }));
-describe('Real-World Snapshot Validation', () => {
-  describe('Snapshot Structure', () => {
-    htmlFiles.forEach(({ name, path }) => {
-      describe(name, () => {
-        let snapshot: ReturnType<typeof createSnapshot>;
-        beforeEach(() => {
-          try {
-            snapshot = generateSnapshotFromHTML(path);
-          } catch (error) {
-            // Skip files that fail to load (like amazon-com.html with invalid selectors)
-            snapshot = { tree: '', refs: {} };
-          }
-        });
-        it('should generate snapshot without errors', () => {
-          expect(snapshot).toBeDefined();
-          expect(typeof snapshot).toBe('string');
-          expect(snapshot.length).toBeGreaterThan(0);
-        });
-        it('should include PAGE header with URL, title, and viewport', () => {
-          const lines = snapshot.split('\n');
-          const pageHeader = lines[0];
-          if (pageHeader && pageHeader.startsWith('PAGE:')) {
-            expect(pageHeader).toMatch(/^PAGE: .+ \| .+ \| viewport=\d+x\d+$/);
-          }
-        });
-        it('should include SNAPSHOT header with statistics', () => {
-          const lines = snapshot.split('\n');
-          const snapshotHeader = lines.find(l => l.startsWith('SNAPSHOT:'));
-          if (snapshotHeader) {
-            expect(snapshotHeader).toMatch(/SNAPSHOT: elements=\d+/);
-            expect(snapshotHeader).toMatch(/depth=\d+\/\d+/);
-            expect(snapshotHeader).toMatch(/mode=/);
-          }
-        });
-        it('should format heading levels correctly', () => {
-          const lines = snapshot.split('\n');
-          const headings = lines.filter(l => l.includes('HEADING LEVEL='));
-          headings.forEach(heading => {
-            expect(heading).toMatch(/HEADING LEVEL=[1-6]/);
-          });
-        });
-        it('should show form boundaries where present', () => {
-          const lines = snapshot.split('\n');
-          const forms = lines.filter(l => l.trim().startsWith('FORM'));
-          forms.forEach(form => {
-            // Forms should have id or action attributes
-            const hasAttributes = form.includes('id=') || form.includes('action=');
-            if (hasAttributes) {
-              expect(form).toMatch(/FORM/);
-            }
-          });
-        });
-        it('should show input types and validation attributes', () => {
-          const lines = snapshot.split('\n');
-          const inputs = lines.filter(l => l.includes('TEXTBOX') || l.includes('CHECKBOX'));
-          inputs.forEach(input => {
-            // Check if input has attribute notation
-            if (input.includes('[')) {
-              expect(input).toMatch(/\[.*\]/);
-              // Common attributes: type, required, invalid
-            }
-          });
-        });
-        it('should show children indicators for large elements', () => {
-          const lines = snapshot.split('\n');
-          const withChildren = lines.filter(l => l.includes('children'));
-          withChildren.forEach(line => {
-            // Should show one of: "N children:", "N shown", "hidden by"
-            const hasIndicator =
-              line.includes('children:') ||
-              line.includes('shown') ||
-              line.includes('hidden by') ||
-              line.includes('filtered');
-            expect(hasIndicator).toBe(true);
-          });
-        });
-      });
-    });
-  });
-  describe('Smart Label Selection', () => {
-    htmlFiles.forEach(({ name, path }) => {
-      describe(name, () => {
-        let snapshot: ReturnType<typeof createSnapshot>;
-        beforeEach(() => {
-          try {
-            snapshot = generateSnapshotFromHTML(path);
-          } catch (error) {
-            snapshot = { tree: '', refs: {} };
-          }
-        });
-        it('should have meaningful labels for buttons', () => {
-          const lines = snapshot.split('\n');
-          const buttons = lines.filter(l => l.includes('BUTTON'));
-          buttons.forEach(button => {
-            // Extract label (text between BUTTON and @ref or end)
-            const match = button.match(/BUTTON "([^"]+)"/);
-            if (match) {
-              const label = match[1];
-              expect(label.length).toBeGreaterThan(0);
-              // Should not be just whitespace
-              expect(label.trim()).toBe(label);
-            }
-          });
-        });
-        it('should show link destinations', () => {
-          const lines = snapshot.split('\n');
-          const links = lines.filter(l => l.includes('LINK'));
-          const linksWithHref = links.filter(l => l.includes('href='));
-          // At least some links should have href
-          if (links.length > 0) {
-            expect(linksWithHref.length).toBeGreaterThan(0);
-          }
-        });
-        it('should have meaningful labels for links', () => {
-          const lines = snapshot.split('\n');
-          const links = lines.filter(l => l.includes('LINK'));
-          links.forEach(link => {
-            // Extract label
-            const match = link.match(/LINK "([^"]+)"/);
-            if (match) {
-              const label = match[1];
-              expect(label.length).toBeGreaterThan(0);
-              expect(label.trim()).toBe(label);
-            }
-          });
-        });
-        it('should not use placeholders as input labels', () => {
-          const lines = snapshot.split('\n');
-          const inputs = lines.filter(l =>
-            l.includes('TEXTBOX') ||
-            l.includes('TEXTAREA') ||
-            l.includes('COMBOBOX')
-          );
-          // This is a negative test - we can't easily check what WASN'T used
-          // But we can verify inputs have labels (from label elements, aria-label, or title)
-          inputs.forEach(input => {
-            // Should have a label in quotes
-            const hasLabel = input.match(/"([^"]+)"/);
-            if (hasLabel) {
-              const label = hasLabel[1];
-              // Label should not be common placeholder text
-              const isPlaceholder =
-                label.toLowerCase().includes('enter ') ||
-                label.toLowerCase().includes('type ') ||
-                label.toLowerCase().startsWith('e.g.');
-              // Most inputs should not have placeholder-style labels
-              // (This is a soft check since some sites do use these as actual labels)
-            }
-          });
-        });
-        it('should generate refs for interactive elements', () => {
-          // Refs are now internal, just count @ref: in output
-          const lines = snapshot.split('\n');
-          const interactiveLines = lines.filter(l =>
-            l.includes('@ref:') ||
-            l.includes('BUTTON') ||
-            l.includes('LINK') ||
-            l.includes('TEXTBOX')
-          );
-          // Should have refs for interactive elements
-          if (interactiveLines.length > 0) {
-            expect(refCount).toBeGreaterThan(0);
-          }
-        });
-        it.skip('should have bounding boxes in refs', () => {
-          // Refs are now internal - this test is skipped
-          // The highlight feature still works using internal refs
-          expect(true).toBe(true);
-            // Should have bounding box info
-            if (ref.bbox) {
-              expect(ref.bbox.x).toBeDefined();
-              expect(ref.bbox.y).toBeDefined();
-              expect(ref.bbox.width).toBeDefined();
-              expect(ref.bbox.height).toBeDefined();
-            }
-            // Should have viewport detection
-            expect(typeof ref.inViewport).toBe('boolean');
-          });
-        });
-      });
-    });
-  });
-  describe('Performance', () => {
-    htmlFiles.forEach(({ name, path }) => {
-      it(`${name}: should generate snapshot in reasonable time`, () => {
-        const start = performance.now();
-        try {
-          generateSnapshotFromHTML(path);
-        } catch (error) {
-          // Skip invalid files
-        }
-        const duration = performance.now() - start;
-        // Should complete in under 5 seconds (generous limit for large pages)
-        expect(duration).toBeLessThan(5000);
-      });
-      it(`${name}: should generate manageable output size`, () => {
-        let snapshot;
-        try {
-          snapshot = generateSnapshotFromHTML(path);
-        } catch (error) {
-          snapshot = { tree: '', refs: {} };
-        }
-        const sizeKB = snapshot.length / 1024;
-        // Should be under 50KB (adaptive depth should prevent excessive output)
-        expect(sizeKB).toBeLessThan(50);
-      });
-    });
-  });
-});

package/packages/cli/package.json DELETED Viewed

@@ -1,42 +0,0 @@
-{
-  "name": "@btcp/cli",
-  "version": "0.1.0",
-  "description": "Browser-based CLI for browser automation - runs in Chrome extension",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./terminal": {
-      "types": "./dist/terminal/index.d.ts",
-      "import": "./dist/terminal/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "keywords": [
-    "browser",
-    "automation",
-    "cli",
-    "chrome-extension"
-  ],
-  "license": "Apache-2.0",
-  "dependencies": {
-    "@btcp/extension": "file:../extension"
-  },
-  "devDependencies": {
-    "@types/chrome": "^0.0.268",
-    "typescript": "^5.3.0"
-  }
-}