@nuanu-ai/agentbrowse 0.2.0 → 0.2.2

package/README.md

@@ -28,6 +28,7 @@ agentbrowse launch https://example.com
 - Node.js 18+
 - a Chrome-compatible browser runtime available on the machine
 - an Anthropic API key for browsing commands
+- an AgentPay API key for CLI startup
 
 ## Commands
 
@@ -88,17 +89,19 @@ Optional model override:
 export AGENTBROWSE_MODEL=anthropic/claude-haiku-4-5-20251001
 ```
 
-`solve-captcha` is separate and uses AgentPay gateway credentials only when
-that command is invoked.
+`agentbrowse` also requires an AgentPay API key at startup so the CLI stays on
+the same gateway-backed contract as the rest of the toolchain.
 
 ## Runtime model
 
 - `agentbrowse` persists the active browser session under `~/.agentpay`
 - browsing commands require `ANTHROPIC_API_KEY`
-- normal browsing commands do not require `AGENTPAY_API_KEY`
+- all commands require `AGENTPAY_API_KEY`
 - `solve-captcha` requires both:
   - a session with captcha-solving capability
   - AgentPay gateway configuration
 
 Human-readable progress is written to `stderr`. Command results are written to
 `stdout`.
+
+Releases are published automatically from `main` after checks pass.

package/dist/agentpay-gateway.d.ts

@@ -5,4 +5,5 @@ export interface AgentpayGatewayConfig {
 export declare function tryResolveAgentpayGatewayConfig(): AgentpayGatewayConfig | null;
 export declare function resolveAgentpayGatewayConfig(): AgentpayGatewayConfig;
 export declare function applyAgentpayGatewayEnv(gateway: AgentpayGatewayConfig): void;
+export declare function preflightAgentpayGateway(): Promise<AgentpayGatewayConfig>;
 //# sourceMappingURL=agentpay-gateway.d.ts.map

package/dist/agentpay-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentpay-gateway.d.ts","sourceRoot":"","sources":["../src/agentpay-gateway.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAiCD,wBAAgB,+BAA+B,IAAI,qBAAqB,GAAG,IAAI,CAoB9E;AAED,wBAAgB,4BAA4B,IAAI,qBAAqB,CAMpE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAG5E"}
+{"version":3,"file":"agentpay-gateway.d.ts","sourceRoot":"","sources":["../src/agentpay-gateway.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAiCD,wBAAgB,+BAA+B,IAAI,qBAAqB,GAAG,IAAI,CAoB9E;AAED,wBAAgB,4BAA4B,IAAI,qBAAqB,CAMpE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAG5E;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAI/E"}

package/dist/agentpay-gateway.js

@@ -48,7 +48,7 @@ export function tryResolveAgentpayGatewayConfig() {
 export function resolveAgentpayGatewayConfig() {
     const gateway = tryResolveAgentpayGatewayConfig();
     if (!gateway) {
-        throw new Error('Captcha solving requires API key configuration.');
+        throw new Error('AgentPay API key is required.');
     }
     return gateway;
 }
@@ -56,3 +56,8 @@ export function applyAgentpayGatewayEnv(gateway) {
     process.env.AGENTPAY_API_KEY = gateway.apiKey;
     process.env.AGENTPAY_API_URL = gateway.apiUrl;
 }
+export async function preflightAgentpayGateway() {
+    const gateway = resolveAgentpayGatewayConfig();
+    applyAgentpayGatewayEnv(gateway);
+    return gateway;
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
-export {};
+declare function main(argv?: string[]): Promise<void>;
+export { main };
+export declare function isDirectExecution(metaUrl: string, argv?: string[]): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAgLA,iBAAe,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGhE;AAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAWzF"}

package/dist/index.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 import { config as loadEnv } from 'dotenv';
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 loadEnv();
+import { preflightAgentpayGateway } from './agentpay-gateway.js';
 import { browseCommand, browseCommandName } from './command-name.js';
 import { loadSession } from './session.js';
 import { outputError, fatal, info } from './output.js';
@@ -32,8 +35,8 @@ Options:
 Environment:
   ANTHROPIC_API_KEY               Required for browsing commands
   AGENTBROWSE_MODEL               Optional model override for browsing commands
-  AGENTPAY_API_KEY                Required only for solve-captcha / gateway-backed solve
-  AGENTPAY_API_URL                Optional API base URL override for solve-captcha`;
+  AGENTPAY_API_KEY                Required for CLI start
+  AGENTPAY_API_URL                Optional API base URL override`;
 }
 const KNOWN_COMMANDS = new Set([
     'launch',
@@ -46,8 +49,8 @@ const KNOWN_COMMANDS = new Set([
     'status',
     'close',
 ]);
-function getCommand() {
-    const rawArgs = process.argv.slice(2);
+function getCommand(argv = process.argv) {
+    const rawArgs = argv.slice(2);
     if (rawArgs.length === 0 || rawArgs[0] === '--help') {
         info(usageText());
         process.exit(0);
@@ -137,14 +140,20 @@ function requireSession() {
     // Caller will handle connection errors.
     return 'ws://localhost:9222';
 }
-async function main() {
-    const parsed = getCommand();
+async function main(argv = process.argv) {
+    const parsed = getCommand(argv);
     if (!parsed)
         process.exit(1);
     const { command, args } = parsed;
     if (!KNOWN_COMMANDS.has(command)) {
         outputError(`Unknown command: ${command}\n\n${usageText()}`);
     }
+    try {
+        await preflightAgentpayGateway();
+    }
+    catch (err) {
+        outputError(err instanceof Error ? err.message : String(err));
+    }
     switch (command) {
         case 'launch': {
             const { launch } = await import('./commands/launch.js');
@@ -225,6 +234,21 @@ async function main() {
         }
     }
 }
-main().catch((err) => {
-    fatal(err instanceof Error ? err.message : String(err));
-});
+export { main };
+export function isDirectExecution(metaUrl, argv = process.argv) {
+    const entry = argv[1];
+    if (!entry) {
+        return false;
+    }
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(metaUrl));
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectExecution(import.meta.url)) {
+    main().catch((err) => {
+        fatal(err instanceof Error ? err.message : String(err));
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "description": "Standalone browser automation CLI for AI agents: launch, observe, act, extract, and solve captcha",
   "keywords": [