@browsers-cli/se-cli 0.1.0

package/dist/session.js

@@ -0,0 +1,264 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const net = __importStar(require("net"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const registry_1 = require("./registry");
+const config_1 = require("./config");
+class Session {
+    workspaceDir;
+    sessionName;
+    socketPath;
+    wsHash;
+    registry;
+    constructor(workspaceDir, sessionName = 'default') {
+        this.workspaceDir = workspaceDir;
+        this.sessionName = sessionName;
+        this.wsHash = (0, config_1.workspaceHash)(workspaceDir);
+        this.socketPath = (0, config_1.makeSocketPath)(this.wsHash, sessionName);
+        this.registry = new registry_1.Registry((0, config_1.baseDaemonDir)());
+    }
+    async canConnect() {
+        return new Promise((resolve) => {
+            const sock = net.connect(this.socketPath);
+            const timer = setTimeout(() => { sock.destroy(); resolve(false); }, 1000);
+            sock.once('connect', () => {
+                clearTimeout(timer);
+                sock.destroy();
+                resolve(true);
+            });
+            sock.once('error', () => { clearTimeout(timer); sock.destroy(); resolve(false); });
+        });
+    }
+    async startDaemon(opts = {}) {
+        // If a daemon is already running on this socket, verify it's responsive.
+        if (await this.canConnect()) {
+            try {
+                await this.sendAndClose({ method: 'ping', params: { args: [], cwd: '' } });
+                return; // Daemon is alive and responsive
+            }
+            catch {
+                // Daemon is listening but not responsive — force kill it.
+                const config = this.registry.loadSession(this.wsHash, this.sessionName);
+                if (config && config.pid) {
+                    try {
+                        process.kill(config.pid, 'SIGKILL');
+                    }
+                    catch { }
+                }
+                this.registry.deleteSession(this.wsHash, this.sessionName);
+                await new Promise(r => setTimeout(r, 500));
+            }
+        }
+        const browserName = opts.browserName || 'chrome';
+        const daemonScript = path.join(__dirname, 'daemon', 'server.js');
+        const args = [daemonScript, this.sessionName, this.socketPath, this.workspaceDir, browserName];
+        if (opts.headed)
+            args.push('--headed');
+        if (opts.cdpEndpoint)
+            args.push(`--cdp=${opts.cdpEndpoint}`);
+        const child = (0, child_process_1.spawn)(process.execPath, args, {
+            detached: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                child.kill();
+                reject(new Error('daemon start timeout'));
+            }, 120000);
+            const onStdout = (data) => {
+                const line = data.toString().trim();
+                if (line.startsWith('Daemon listening on')) {
+                    clearTimeout(timeout);
+                    // Detach from the child so it survives the parent's exit.
+                    child.unref();
+                    // Remove listeners so we don't interfere with the child's lifecycle.
+                    child.stdout?.removeListener('data', onStdout);
+                    child.stderr?.removeListener('data', onStderr);
+                    child.removeListener('error', onError);
+                    child.removeListener('exit', onExit);
+                    // Unref the stdio pipes so they don't keep the parent's event
+                    // loop alive (which would cause execSync-based callers to hang
+                    // until their timeout).  Do NOT destroy the pipes — destroying
+                    // them breaks the child's stdout/stderr fd and causes the daemon
+                    // to crash with EPIPE the next time it tries to log an error.
+                    const stdoutSock = child.stdout;
+                    const stderrSock = child.stderr;
+                    stdoutSock.unref?.();
+                    stderrSock.unref?.();
+                    resolve();
+                }
+            };
+            const onStderr = (data) => {
+                process.stderr.write(`daemon stderr: ${data}`);
+            };
+            const onError = (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            };
+            const onExit = (code, signal) => {
+                clearTimeout(timeout);
+                reject(new Error(`daemon exited early code=${code} signal=${signal}`));
+            };
+            child.stdout?.on('data', onStdout);
+            child.stderr?.on('data', onStderr);
+            child.on('error', onError);
+            child.on('exit', onExit);
+        });
+        // Health check: verify the daemon is actually responsive by sending a ping.
+        // The daemon might crash shortly after listening (e.g., during module
+        // loading), so we confirm it can handle at least one request.
+        try {
+            await this.sendAndClose({ method: 'ping', params: { args: [], cwd: '' } });
+        }
+        catch {
+            // Ping failed — the daemon may have crashed. Try one more time with
+            // a short delay to give it a chance to fully initialize.
+            await new Promise(r => setTimeout(r, 500));
+            await this.sendAndClose({ method: 'ping', params: { args: [], cwd: '' } });
+        }
+    }
+    async run(args, cwd, opts = {}) {
+        const msg = {
+            method: 'run',
+            params: { args, cwd, raw: opts.raw, json: opts.json },
+        };
+        // Retry on connection failures — the daemon may have crashed and
+        // needs to be restarted from the saved session config.
+        let lastErr = null;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                return await this.sendAndClose(msg);
+            }
+            catch (e) {
+                lastErr = e;
+                const errMsg = e.message || '';
+                if (errMsg.includes('daemon closed connection') || errMsg.includes('ECONNREFUSED') || errMsg.includes('connect ENOENT') || errMsg.includes('ECONNRESET') || errMsg.includes('EPIPE')) {
+                    // Try to restart the daemon on the first connection failure.
+                    if (attempt === 0) {
+                        try {
+                            const config = this.registry.loadSession(this.wsHash, this.sessionName);
+                            if (config && config.browserName) {
+                                await this.startDaemon({ browserName: config.browserName });
+                            }
+                        }
+                        catch {
+                            // startDaemon may fail — that's OK, we'll retry the connection
+                        }
+                    }
+                    await new Promise(r => setTimeout(r, 1000 * (attempt + 1)));
+                    continue;
+                }
+                throw e;
+            }
+        }
+        throw lastErr;
+    }
+    async stop() {
+        try {
+            await this.sendAndClose({ method: 'stop', params: { args: [], cwd: process.cwd() } });
+        }
+        catch {
+            // daemon may already be dead
+        }
+        this.registry.deleteSession(this.wsHash, this.sessionName);
+        // Wait for the daemon to actually exit — the 'stop' response is sent
+        // before shutdown() completes, so the socket might still be alive briefly.
+        for (let i = 0; i < 10; i++) {
+            if (!(await this.canConnect()))
+                break;
+            await new Promise(r => setTimeout(r, 200));
+        }
+    }
+    sendAndClose(msg) {
+        return new Promise((resolve, reject) => {
+            const sock = net.connect(this.socketPath);
+            const timeout = setTimeout(() => {
+                sock.destroy();
+                reject(new Error('daemon connection timeout'));
+            }, 60000);
+            let settled = false;
+            const cleanup = () => {
+                clearTimeout(timeout);
+                sock.removeAllListeners();
+                sock.destroy();
+            };
+            sock.once('connect', () => {
+                sock.write(JSON.stringify(msg) + '\n');
+            });
+            let buffer = '';
+            sock.on('data', (data) => {
+                buffer += data.toString();
+                if (buffer.includes('\n')) {
+                    if (settled)
+                        return;
+                    settled = true;
+                    try {
+                        const resp = JSON.parse(buffer.split('\n')[0]);
+                        cleanup();
+                        resolve(resp);
+                    }
+                    catch (e) {
+                        cleanup();
+                        reject(e);
+                    }
+                }
+            });
+            sock.once('error', (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(err);
+            });
+            sock.once('close', () => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                if (buffer === '' || !buffer.includes('\n')) {
+                    reject(new Error('daemon closed connection without response'));
+                }
+            });
+        });
+    }
+    loadConfig() {
+        return this.registry.loadSession(this.wsHash, this.sessionName);
+    }
+}
+exports.Session = Session;
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/snapshot/aria-snapshot.d.ts

@@ -0,0 +1 @@
+export declare function generateAriaSnapshotScript(): string;

package/dist/snapshot/aria-snapshot.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAriaSnapshotScript = generateAriaSnapshotScript;
+function generateAriaSnapshotScript() {
+    return `
+(function() {
+  const INTERACTIVE_TAGS = new Set([
+    'a', 'button', 'input', 'select', 'textarea',
+    'summary', 'details', 'option', 'optgroup'
+  ]);
+  const INTERACTIVE_ROLES = new Set([
+    'button', 'link', 'textbox', 'checkbox', 'radio', 'menuitem',
+    'menuitemcheckbox', 'menuitemradio', 'tab', 'combobox',
+    'option', 'searchbox', 'spinbutton', 'slider', 'switch'
+  ]);
+
+  const TAG_TO_ROLE = {
+    'a': 'link',
+    'button': 'button',
+    'input': 'textbox',
+    'select': 'combobox',
+    'textarea': 'textbox',
+    'nav': 'navigation',
+    'main': 'main',
+    'header': 'banner',
+    'footer': 'contentinfo',
+    'aside': 'complementary',
+    'form': 'form',
+    'search': 'search',
+    'h1': 'heading', 'h2': 'heading', 'h3': 'heading',
+    'h4': 'heading', 'h5': 'heading', 'h6': 'heading',
+    'img': 'image',
+    'ul': 'list', 'ol': 'list',
+    'li': 'listitem',
+    'table': 'table',
+    'tr': 'row',
+    'details': 'group',
+    'summary': 'button',
+    'dialog': 'dialog',
+    'alert': 'alert',
+    'menu': 'menu',
+    'menubar': 'menubar',
+    'toolbar': 'toolbar',
+    'tablist': 'tablist',
+    'tab': 'tab',
+    'tabpanel': 'tabpanel',
+    'option': 'option',
+  };
+
+  let refCounter = 0;
+  const lines = [];
+
+  function getRole(el) {
+    const explicit = el.getAttribute('role');
+    if (explicit) return explicit;
+    const tag = el.tagName.toLowerCase();
+    if (tag in TAG_TO_ROLE) return TAG_TO_ROLE[tag];
+    return null;
+  }
+
+  function getLabel(el, role) {
+    const ariaLabel = el.getAttribute('aria-label');
+    if (ariaLabel) return ariaLabel;
+
+    const labelledby = el.getAttribute('aria-labelledby');
+    if (labelledby) {
+      const labelEl = document.getElementById(labelledby);
+      if (labelEl) return labelEl.textContent.trim();
+    }
+
+    const tag = el.tagName.toLowerCase();
+    if (tag === 'input' || tag === 'textarea') {
+      const type = (el.type || '').toLowerCase();
+      if (type === 'checkbox' || type === 'radio') {
+        if (el.id) {
+          const label = document.querySelector('label[for="' + CSS.escape(el.id) + '"]');
+          if (label) return label.textContent.trim();
+        }
+        const parentLabel = el.closest('label');
+        if (parentLabel) return parentLabel.textContent.trim();
+      }
+      return el.placeholder || el.name || '';
+    }
+
+    if (tag === 'img') return el.alt || el.title || '';
+
+    const text = (el.textContent || '').trim();
+    return text ? text.slice(0, 80) : '';
+  }
+
+  function isInteractive(el, role) {
+    const tag = el.tagName.toLowerCase();
+    if (INTERACTIVE_TAGS.has(tag)) return true;
+    if (role && INTERACTIVE_ROLES.has(role)) return true;
+    return false;
+  }
+
+  function isHidden(el) {
+    if (el.hidden) return true;
+    if (el.getAttribute('aria-hidden') === 'true') return true;
+    if (el.style && (el.style.display === 'none' || el.style.visibility === 'hidden')) return true;
+    // getComputedStyle for elements that may be hidden via CSS classes
+    try {
+      const style = window.getComputedStyle(el);
+      if (style.display === 'none' || style.visibility === 'hidden') return true;
+    } catch (e) {}
+    return false;
+  }
+
+  function getAttrs(el, role) {
+    const attrs = [];
+    const tag = el.tagName.toLowerCase();
+    if (tag.match(/^h[1-6]$/)) {
+      attrs.push('level=' + tag[1]);
+    }
+    if (role === 'heading' && el.getAttribute('aria-level')) {
+      attrs.push('level=' + el.getAttribute('aria-level'));
+    }
+    if (el.tagName === 'INPUT') {
+      const type = (el.type || '').toLowerCase();
+      if (type === 'checkbox' && el.checked) attrs.push('checked');
+      if (type === 'radio' && el.checked) attrs.push('checked');
+      if (el.disabled) attrs.push('disabled');
+    }
+    return attrs.length ? ' [' + attrs.join(' ') + ']' : '';
+  }
+
+  function walk(el, level, depth) {
+    if (level > depth) return;
+    if (isHidden(el)) return;
+
+    const role = getRole(el);
+    if (role === 'none' || role === 'presentation') {
+      for (const child of el.children) walk(child, level, depth);
+      return;
+    }
+
+    const label = getLabel(el, role);
+    const interactive = isInteractive(el, role);
+
+    let refAttr = '';
+    if (interactive) {
+      const ref = 'e' + (++refCounter);
+      el.setAttribute('data-se-ref', ref);
+      refAttr = ' [ref=' + ref + ']';
+    }
+
+    const attrs = getAttrs(el, role);
+    const indent = '  '.repeat(level);
+
+    if (role) {
+      const labelPart = label ? ' "' + label + '"' : '';
+      lines.push(indent + '- ' + role + labelPart + attrs + refAttr);
+    }
+
+    // Detect iframes and output placeholder
+    for (const child of el.children) {
+      if (child.tagName === 'IFRAME') {
+        const src = child.src || child.getAttribute('src') || '';
+        const indent2 = '  '.repeat(level + 1);
+        lines.push(indent2 + '- iframe: ' + src);
+        continue;
+      }
+      walk(child, level + 1, depth);
+    }
+    // Detect open shadow roots
+    if (el.shadowRoot) {
+      const indent2 = '  '.repeat(level + 1);
+      lines.push(indent2 + '- shadowroot:');
+      for (const child of el.shadowRoot.children) {
+        walk(child, level + 2, depth);
+      }
+    }
+  }
+
+  return function generateAriaSnapshot(options) {
+    options = options || {};
+    const depth = options.depth || 50;
+    refCounter = 0;
+    lines.length = 0;
+
+    const root = options.target
+      ? document.querySelector('[data-se-ref="' + options.target + '"]') || document.querySelector(options.target)
+      : document.body;
+
+    if (!root) return '';
+
+    if (root === document.body) {
+      lines.push('- document:');
+      for (const child of root.children) walk(child, 1, depth);
+    } else {
+      walk(root, 0, depth);
+    }
+
+    return lines.join('\\n');
+  };
+})()
+`;
+}
+//# sourceMappingURL=aria-snapshot.js.map

package/dist/snapshot/aria-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-snapshot.js","sourceRoot":"","sources":["../../src/snapshot/aria-snapshot.ts"],"names":[],"mappings":";;AAAA,gEAmMC;AAnMD,SAAgB,0BAA0B;IACxC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiMR,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@browsers-cli/se-cli",
+  "version": "0.1.0",
+  "description": "Selenium CLI with token-efficient browser automation for AI agents",
+  "license": "Apache-2.0",
+  "homepage": "https://se-cli.github.io/se-cli/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/se-cli/se-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/se-cli/se-cli/issues"
+  },
+  "keywords": [
+    "selenium",
+    "cli",
+    "webdriver",
+    "browser-automation",
+    "ai-agent",
+    "accessibility",
+    "aria"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "se-cli": "dist/cli.js",
+    "se": "dist/cli.js",
+    "selenium-cli": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "selenium-webdriver": "^4.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}