@nuanu-ai/agentbrowse 0.2.16 → 0.2.18

package/README.md

@@ -81,22 +81,33 @@ agentbrowse status
 agentbrowse close
 ```
 
+Persist AgentPay gateway config for future runs:
+
+```bash
+agentbrowse init ap_...
+agentbrowse init ap_... --api-url https://your-project.supabase.co/functions/v1/api
+```
+
 ## Configure
 
 `agentbrowse` uses the AgentPay backend for browser reasoning and gateway-backed
 operations:
 
 ```bash
-export AGENTPAY_API_KEY=...
+agentbrowse init ap_...
 ```
 
+Use `AGENTPAY_API_KEY` and `AGENTPAY_API_URL` only as explicit runtime
+overrides.
+
 ## Runtime model
 
 - `agentbrowse` persists the active browser session under `~/.agentpay`
 - mock stored secrets for live/manual runs come from one canonical file:
   `~/.agentpay/mock-stored-secrets.json`
 - repo JSON fixtures under `src/secrets/` are fallback seeds and test inputs, not an additional runtime config source
-- all commands require `AGENTPAY_API_KEY`
+- all commands require AgentPay gateway configuration; prefer `agentbrowse init`
+  and use env vars only as runtime overrides
 - the external AI agent remains the orchestration owner
 - `agentbrowse` is a single-step browser toolset, not an internal reactive form loop
 - runtime may enrich `observe` output with semantic hints and validation evidence, but it should not silently auto-submit, auto-retry, or maintain hidden durable field-state machines on behalf of the agent

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function init(apiKey: string, apiUrl?: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAOA,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBzE"}

package/dist/commands/init.js

@@ -0,0 +1,27 @@
+import { outputJSON } from '../output.js';
+import { getConfigPath, readConfig, writeConfig } from '../solver/config.js';
+function normalizeApiUrl(value) {
+    return value.replace(/\/$/, '');
+}
+export async function init(apiKey, apiUrl) {
+    const config = readConfig();
+    const normalizedApiKey = apiKey.trim();
+    const normalizedApiUrl = apiUrl?.trim() ? normalizeApiUrl(apiUrl.trim()) : undefined;
+    const nextConfig = {
+        ...config,
+        agentpay: {
+            ...(config.agentpay ?? {}),
+            apiKey: normalizedApiKey,
+            ...(normalizedApiUrl ? { apiUrl: normalizedApiUrl } : {}),
+        },
+    };
+    writeConfig(nextConfig);
+    outputJSON({
+        success: true,
+        configPath: getConfigPath(),
+        agentpay: {
+            apiKeyConfigured: true,
+            apiUrl: normalizedApiUrl ?? null,
+        },
+    });
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAqNA,iBAAe,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJhE;AAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAWzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiPA,iBAAe,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4JhE;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

@@ -11,6 +11,7 @@ function usageText() {
     return `Usage: ${browseCommandName()} <command> [args] [options]
 
 Commands:
+  init <apiKey> [--api-url <url>] Configure AgentPay gateway access for AgentBrowse
   launch [url] [options]          Launch browser, optionally navigate to URL
   solve-captcha [--timeout <s>]   Wait for captcha and solve it on current page
   navigate <url>                  Navigate current tab to URL
@@ -38,11 +39,12 @@ Options:
   --help                          Show this help message
 
 Environment:
-  AGENTPAY_API_KEY                Required for CLI start and browsing commands
+  AGENTPAY_API_KEY                Optional runtime override; use init for persisted config
   AGENTPAY_API_URL                Optional API base URL override`;
 }
 const KNOWN_COMMANDS = new Set([
     'launch',
+    'init',
     'navigate',
     'get-secrets-catalog',
     'create-intent',
@@ -156,6 +158,28 @@ function parseCaptchaTimeout(args) {
     }
     return timeout;
 }
+function parseInitArgs(args) {
+    const apiKey = getPositional(args, ['--api-url']);
+    if (!apiKey) {
+        outputError(`Usage: ${browseCommand('init', '<apiKey>', '[--api-url <url>]')}`);
+    }
+    const apiUrl = getFlag(args, '--api-url');
+    const allowedFlags = new Set(['--api-url']);
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg.startsWith('--')) {
+            continue;
+        }
+        if (!allowedFlags.has(arg)) {
+            outputError(`Unknown init option: ${arg}`);
+        }
+        i += 1;
+    }
+    return {
+        apiKey: apiKey,
+        apiUrl,
+    };
+}
 /** Require an active browser session. */
 function requireSessionRecord() {
     const session = loadSession();
@@ -178,13 +202,21 @@ async function main(argv = process.argv) {
     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));
+    if (command !== 'init') {
+        try {
+            await preflightAgentpayGateway();
+        }
+        catch (err) {
+            outputError(err instanceof Error ? err.message : String(err));
+        }
     }
     switch (command) {
+        case 'init': {
+            const { init } = await import('./commands/init.js');
+            const initArgs = parseInitArgs(args);
+            await init(initArgs.apiKey, initArgs.apiUrl);
+            break;
+        }
         case 'launch': {
             const { launch } = await import('./commands/launch.js');
             const launchArgs = parseLaunchArgs(args);

package/dist/secrets/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/secrets/backend.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAqCpB,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;CACjE;AAWD,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,SAA4D;CAIhF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAC9B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrE,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC7F,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CAC3E;AAyKD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAYhD"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/secrets/backend.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AA6DpB,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;CACjE;AAWD,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,SAA4D;CAIhF;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAC9B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrE,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC7F,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CAC3E;AA6KD,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAYhD"}

package/dist/secrets/backend.js

@@ -3,6 +3,27 @@ import { resolveHostFromInput, resolveMockStoredSecretValues, syncMockSecretCata
 import { createOrReuseMockSecretIntent, getMockSecretIntent, markMockSecretIntentCompleted, } from './mock-agentpay-cabinet.js';
 const ENABLE_MOCK_SECRETS_ENV = 'AGENTBROWSE_ENABLE_MOCK_SECRETS';
 const APPROVAL_CHANNEL = 'agentpay-cabinet';
+function tryParseJsonRecord(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function formatAgentpayBackendError(status, text) {
+    const parsed = text ? tryParseJsonRecord(text) : null;
+    if (!parsed) {
+        return `agentpay_secret_backend_http_${status}${text ? `:${text}` : ''}`;
+    }
+    if (typeof parsed.error === 'string' && parsed.error.length > 0) {
+        return `agentpay_secret_backend_http_${status}:${parsed.error}`;
+    }
+    return `agentpay_secret_backend_http_${status}${text ? `:${text}` : ''}`;
+}
 function envFlagEnabled(value) {
     if (!value) {
         return false;
@@ -79,7 +100,7 @@ async function requestAgentpay(method, path, body) {
     });
     if (!response.ok) {
         const text = await response.text().catch(() => '');
-        throw new Error(`agentpay_secret_backend_http_${response.status}${text ? `:${text}` : ''}`);
+        throw new Error(formatAgentpayBackendError(response.status, text));
     }
     return (await response.json());
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "type": "module",
   "description": "Browser automation CLI for AI agents: control a CDP browser, observe UI surfaces, act on refs, extract data, and solve captchas",
   "keywords": [