textweb 0.2.3 → 0.2.4

package/mcp/index.js

@@ -11,6 +11,7 @@
  */
 
 const { AgentBrowser } = require('../src/browser');
+const { ensureBrowser } = require('../src/ensure-browser');
 
 const SERVER_INFO = {
   name: 'textweb',
@@ -462,4 +463,7 @@ function main() {
   });
 }
 
-main();
+ensureBrowser().then(main).catch((err) => {
+  process.stderr.write(`Fatal: ${err.message}\n`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textweb",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "A text-grid web renderer for AI agents — see the web without screenshots",
   "main": "src/browser.js",
   "bin": {

package/src/cli.js

@@ -6,6 +6,7 @@
 
 const { AgentBrowser } = require('./browser');
 const { createServer } = require('./server');
+const { ensureBrowser } = require('./ensure-browser');
 const readline = require('readline');
 
 // Parse command line arguments
@@ -392,7 +393,9 @@ async function main() {
     showHelp();
     return;
   }
-  
+
+  await ensureBrowser();
+
   if (options.serve) {
     await serve(options);
   } else if (options.interactive) {

package/src/ensure-browser.js

@@ -0,0 +1,92 @@
+'use strict';
+
+/**
+ * ensure-browser.js
+ *
+ * Checks whether Playwright's Chromium is installed and, when running
+ * in an interactive terminal, offers to install it automatically.
+ *
+ * All output goes to stderr so it never pollutes stdout-based protocols
+ * (e.g. the MCP JSON-RPC transport).
+ */
+
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+const readline = require('readline');
+
+function ask(prompt) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+function log(msg) {
+  process.stderr.write(msg + '\n');
+}
+
+function isInstalled() {
+  try {
+    const { chromium } = require('playwright');
+    const execPath = chromium.executablePath();
+    return fs.existsSync(execPath);
+  } catch {
+    return false;
+  }
+}
+
+function install() {
+  // Prefer the local playwright CLI (bundled with the dep) over npx
+  let cliPath = null;
+  try {
+    cliPath = require.resolve('playwright/cli.js');
+  } catch { /* fall through to npx */ }
+
+  const result = cliPath
+    ? spawnSync(process.execPath, [cliPath, 'install', 'chromium'], { stdio: 'inherit' })
+    : spawnSync('npx', ['playwright', 'install', 'chromium'], { stdio: 'inherit', shell: true });
+
+  return result.status === 0;
+}
+
+async function ensureBrowser() {
+  if (isInstalled()) return;
+
+  log('');
+  log('⚠  Playwright Chromium is not installed — textweb needs it to browse the web.');
+
+  if (process.stdin.isTTY) {
+    const answer = await ask('   Install it now? (Y/n) ');
+    if (answer.toLowerCase() === 'n') {
+      log('');
+      log('   Run manually:  npx playwright install chromium');
+      log('');
+      process.exit(1);
+    }
+  } else {
+    log('');
+    log('   Run:  npx playwright install chromium');
+    log('');
+    process.exit(1);
+  }
+
+  log('');
+  log('   Installing Chromium — this takes ~30 seconds the first time…');
+  log('');
+
+  if (!install()) {
+    log('');
+    log('   Installation failed. Run manually:  npx playwright install chromium');
+    log('');
+    process.exit(1);
+  }
+
+  log('');
+  log('✓  Chromium installed successfully!');
+  log('');
+}
+
+module.exports = { ensureBrowser };