@nuanu-ai/agentbrowse 0.2.47 → 0.2.49

package/dist/index.js

@@ -7,22 +7,24 @@ import { preflightAgentpayGateway } from './agentpay-gateway.js';
 import { browseCommand, browseCommandName } from './command-name.js';
 import { assertSemanticObserveRuntimeSupport } from './commands/semantic-observe-lexical.js';
 import { loadSession } from './session.js';
-import { outputError, outputJSON, fatal, info } from './output.js';
-import { applyDemoProxyBootstrap } from './solver/config.js';
+import { outputContractFailure, outputError, outputJSON, fatal, info } from './output.js';
 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
+  start-session [name] [--merchant-name <name>]
+                                  Start workflow session and telemetry on the current browser
+  end-session                     Complete the active workflow session without closing the browser
   solve-captcha [--timeout <s>]   Wait for captcha and solve it on current page
   navigate <url>                  Navigate current tab to URL
   get-secrets-catalog [url]       Refresh stored-secret metadata for a URL or current page
-  create-intent <fillRef> <storedSecretRef>
-                                  Create or reuse an intent for one stored secret fill
-  poll-intent <intentId>          Poll stored-secret intent status
-  fill-secret <fillRef> <intentId>
-                                  Fill protected fields from the one-time delivered secret payload
+  request-secret <fillRef> <storedSecretRef> --merchant-name <name>
+                                  Create or reuse a session-bound secret request for one fill target
+  poll-secret <requestId>         Poll one secret request state without blocking
+  fill-secret <fillRef> <requestId>
+                                  Claim an approved secret request and fill protected fields
   act <targetRef> <action> [value] Perform action on a previously observed target
   extract '<schema-json>' [scopeRef] Extract structured data from the page or a stored scope
   observe ["<goal>"]              Discover available targets/elements
@@ -34,12 +36,12 @@ Options:
   --compact                       Launch browser in compact window size (1280x900, default)
   --full                          Launch browser in full-size window
   --profile <name>                Solver profile name for launch (default: "default")
-  --proxy <url>                   Launch browser through proxy for this run only
-  --proxyless                     Ignore configured/profile proxy for this run only
+  --proxy [url]                   Launch through configured proxy, or use one-off override URL
   --headful                       Explicit alias for headful browser mode (default)
   --headless                      Launch browser in headless mode
   --path <file>                   Output path for screenshot
   --timeout <seconds>             Timeout for solve-captcha command (default: 90)
+  --merchant-name <name>          Merchant/vendor name for start-session or request-secret
   --help                          Show this help message
 
 Environment:
@@ -48,11 +50,13 @@ Environment:
 }
 const KNOWN_COMMANDS = new Set([
     'launch',
+    'start-session',
+    'end-session',
     'init',
     'navigate',
     'get-secrets-catalog',
-    'create-intent',
-    'poll-intent',
+    'request-secret',
+    'poll-secret',
     'fill-secret',
     'solve-captcha',
     'act',
@@ -117,8 +121,8 @@ function parseLaunchArgs(args) {
     let compact = true;
     let profile;
     let headless = false;
+    let useProxy = false;
     let proxy;
-    let noProxy = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (arg === '--headless') {
@@ -140,36 +144,40 @@ function parseLaunchArgs(args) {
         if (arg === '--profile') {
             const value = args[i + 1];
             if (!value || value.startsWith('--')) {
-                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy <url>|--proxyless]', '[--headful|--headless]')}`);
+                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
             }
             profile = value;
             i += 1;
             continue;
         }
-        if (arg === '--proxy') {
-            const value = args[i + 1];
-            if (!value || value.startsWith('--')) {
-                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy <url>|--proxyless]', '[--headful|--headless]')}`);
+        if (arg.startsWith('--proxy=')) {
+            const value = arg.slice('--proxy='.length).trim();
+            if (!value) {
+                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
             }
+            useProxy = true;
             proxy = value;
-            noProxy = false;
-            i += 1;
             continue;
         }
-        if (arg === '--proxyless') {
-            proxy = undefined;
-            noProxy = true;
+        if (arg === '--proxy') {
+            useProxy = true;
+            const value = args[i + 1];
+            const trailingPositionals = args.slice(i + 1).filter((entry) => !entry.startsWith('--'));
+            if (value && !value.startsWith('--') && (url || trailingPositionals.length > 1)) {
+                proxy = value;
+                i += 1;
+            }
             continue;
         }
         if (arg.startsWith('--')) {
             outputError(`Unknown launch option: ${arg}`);
         }
         if (url) {
-            outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy <url>|--proxyless]', '[--headful|--headless]')}`);
+            outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
         }
         url = arg;
     }
-    return { url, compact, profile, headless, proxy, noProxy };
+    return { url, compact, profile, headless, useProxy, proxy };
 }
 function parseCaptchaTimeout(args) {
     const timeoutRaw = getFlag(args, '--timeout');
@@ -201,22 +209,98 @@ function parseInitArgs(args) {
         apiUrl,
     };
 }
+function parseStartSessionArgs(args) {
+    const nameParts = [];
+    let merchantName;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--merchant-name') {
+            const value = args[i + 1];
+            if (!value || value.startsWith('--')) {
+                outputError(`Usage: ${browseCommand('start-session', '[name]', '[--merchant-name <name>]')}`);
+            }
+            merchantName = value;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            outputError(`Usage: ${browseCommand('start-session', '[name]', '[--merchant-name <name>]')}`);
+        }
+        nameParts.push(arg);
+    }
+    return {
+        name: nameParts.join(' ').trim() || undefined,
+        merchantName,
+    };
+}
+function parseRequestSecretArgs(args) {
+    const positionals = [];
+    let merchantName;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--merchant-name') {
+            const value = args[i + 1];
+            if (!value || value.startsWith('--')) {
+                outputError(`Usage: ${browseCommand('request-secret', '<fillRef>', '<storedSecretRef>', '--merchant-name <name>')}`);
+            }
+            merchantName = value.trim();
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            outputError(`Usage: ${browseCommand('request-secret', '<fillRef>', '<storedSecretRef>', '--merchant-name <name>')}`);
+        }
+        positionals.push(arg);
+    }
+    if (merchantName !== undefined && merchantName.length === 0) {
+        outputError('Invalid --merchant-name value. Expected a non-empty string.');
+    }
+    if (positionals.length !== 2) {
+        outputError(`Usage: ${browseCommand('request-secret', '<fillRef>', '<storedSecretRef>', '--merchant-name <name>')}`);
+    }
+    if (!merchantName) {
+        outputError(`The \`request-secret\` command requires \`--merchant-name <name>\` so the operator sees which vendor requested the secret.`);
+    }
+    return {
+        fillRef: positionals[0],
+        storedSecretRef: positionals[1],
+        merchantName,
+    };
+}
 /** Require an active browser session. */
-function requireSessionRecord() {
+function requireBrowserSessionRecord(command) {
     const session = loadSession();
-    if (session)
+    if (session) {
         return session;
-    // Fallback: try CDP on port 9222 directly
-    // (Chrome may have been launched by agentpay-cli or externally)
-    // Caller will handle connection errors. Runtime state starts empty.
-    return {
-        cdpUrl: 'ws://localhost:9222',
-        pid: process.pid,
-        launchedAt: new Date().toISOString(),
-    };
+    }
+    return outputContractFailure({
+        error: 'workflow_session_required',
+        outcomeType: 'blocked',
+        message: `The \`${command}\` command requires an active product workflow session.`,
+        reason: `No persisted browser session was found. Run \`${browseCommandName()} launch [url]\` first, then \`${browseCommandName()} start-session\`.`,
+    });
+}
+function requireProductSessionRecord(command) {
+    const session = requireBrowserSessionRecord(command);
+    if (session.intentSessionId && session.activeRunId) {
+        return session;
+    }
+    if (!session.intentSessionId) {
+        return outputContractFailure({
+            error: 'workflow_session_required',
+            outcomeType: 'blocked',
+            message: `The \`${command}\` command requires an active product workflow session.`,
+            reason: `A browser session is loaded, but no product workflow session is active for it. Run \`${browseCommandName()} start-session\` first.`,
+        });
+    }
+    return outputContractFailure({
+        error: 'workflow_session_required',
+        outcomeType: 'blocked',
+        message: `The \`${command}\` command requires an active product workflow session.`,
+        reason: `The current product workflow session is missing its local run binding. Run \`${browseCommandName()} start-session\` again to re-bind the current browser session.`,
+    });
 }
 async function main(argv = process.argv) {
-    applyDemoProxyBootstrap();
     const parsed = getCommand(argv);
     if (!parsed)
         process.exit(1);
@@ -254,63 +338,77 @@ async function main(argv = process.argv) {
                 compact: launchArgs.compact,
                 profile: launchArgs.profile,
                 headless: launchArgs.headless,
+                useProxy: launchArgs.useProxy,
                 proxy: launchArgs.proxy,
-                noProxy: launchArgs.noProxy,
             });
-            const updateNotice = await updateNoticePromise;
+            const updateNotice = await Promise.race([
+                updateNoticePromise,
+                new Promise((resolve) => {
+                    queueMicrotask(() => resolve(null));
+                }),
+            ]);
             if (updateNotice) {
                 info(updateNotice.message);
             }
             outputJSON(launchResult);
             break;
         }
+        case 'start-session': {
+            const startSessionArgs = parseStartSessionArgs(args);
+            const { startSession } = await import('./commands/start-session.js');
+            outputJSON(await startSession(startSessionArgs.name, {
+                merchantName: startSessionArgs.merchantName,
+            }));
+            break;
+        }
+        case 'end-session': {
+            const { endSession } = await import('./commands/end-session.js');
+            outputJSON(await endSession(requireProductSessionRecord(command)));
+            break;
+        }
         case 'navigate': {
             const url = getPositional(args);
             if (!url)
                 outputError(`Usage: ${browseCommand('navigate', '<url>')}`);
             const { navigate } = await import('./commands/navigate.js');
-            await navigate(requireSessionRecord(), url);
+            await navigate(requireProductSessionRecord(command), url);
             break;
         }
         case 'get-secrets-catalog': {
             const url = getPositional(args);
             const { getSecretsCatalog } = await import('./commands/get-secrets-catalog.js');
-            await getSecretsCatalog(requireSessionRecord(), url);
+            await getSecretsCatalog(requireProductSessionRecord(command), url);
             break;
         }
-        case 'create-intent': {
-            const positionals = getPositionals(args);
-            const [fillRef, storedSecretRef] = positionals;
-            if (!fillRef || !storedSecretRef) {
-                outputError(`Usage: ${browseCommand('create-intent', '<fillRef>', '<storedSecretRef>')}`);
-            }
-            const { createIntent } = await import('./commands/create-intent.js');
-            await createIntent(requireSessionRecord(), fillRef, storedSecretRef);
+        case 'request-secret': {
+            const requestSecretArgs = parseRequestSecretArgs(args);
+            const { requestSecret } = await import('./commands/request-secret.js');
+            await requestSecret(requireProductSessionRecord(command), requestSecretArgs.fillRef, requestSecretArgs.storedSecretRef, requestSecretArgs.merchantName);
             break;
         }
-        case 'poll-intent': {
-            const intentId = getPositional(args);
-            if (!intentId) {
-                outputError(`Usage: ${browseCommand('poll-intent', '<intentId>')}`);
+        case 'poll-secret': {
+            const requestId = getPositional(args);
+            if (!requestId) {
+                outputError(`Usage: ${browseCommand('poll-secret', '<requestId>')}`);
             }
-            const { pollIntent } = await import('./commands/poll-intent.js');
-            await pollIntent(requireSessionRecord(), intentId);
+            const { pollSecret } = await import('./commands/poll-secret.js');
+            await pollSecret(requireProductSessionRecord(command), requestId);
             break;
         }
         case 'fill-secret': {
             const positionals = getPositionals(args);
-            const [fillRef, intentId] = positionals;
-            if (!fillRef || !intentId) {
-                outputError(`Usage: ${browseCommand('fill-secret', '<fillRef>', '<intentId>')}`);
+            const [fillRef, requestId] = positionals;
+            if (!fillRef || !requestId) {
+                outputError(`Usage: ${browseCommand('fill-secret', '<fillRef>', '<requestId>')}`);
             }
             const { fillSecret } = await import('./commands/fill-secret.js');
-            await fillSecret(requireSessionRecord(), fillRef, intentId);
+            await fillSecret(requireProductSessionRecord(command), fillRef, requestId);
             break;
         }
         case 'solve-captcha': {
             const timeout = parseCaptchaTimeout(args);
             const { captchaSolve } = await import('./commands/captcha-solve.js');
-            await captchaSolve(loadSession(), timeout);
+            await captchaSolve(requireProductSessionRecord(command), timeout);
             break;
         }
         case 'act': {
@@ -323,7 +421,8 @@ async function main(argv = process.argv) {
             if (!isBrowseAction(action)) {
                 outputError(`Unsupported act action: ${action}. Expected one of: click, fill, type, select, press.`);
             }
-            await act(requireSessionRecord(), targetRef, action, valueParts.length > 0 ? valueParts.join(' ') : undefined);
+            const session = requireProductSessionRecord(command);
+            await act(session, targetRef, action, valueParts.length > 0 ? valueParts.join(' ') : undefined);
             break;
         }
         case 'extract': {
@@ -333,13 +432,13 @@ async function main(argv = process.argv) {
                 outputError(`Usage: ${browseCommand('extract', "'<schema-json>'", '[scopeRef]')}`);
             }
             const { extract } = await import('./commands/extract.js');
-            await extract(requireSessionRecord(), schemaJson, scopeRef);
+            await extract(requireProductSessionRecord(command), schemaJson, scopeRef);
             break;
         }
         case 'observe': {
             const instruction = getPositional(args);
             const { observe } = await import('./commands/observe.js');
-            await observe(requireSessionRecord(), instruction);
+            await observe(requireProductSessionRecord(command), instruction);
             break;
         }
         case 'screenshot': {
@@ -349,12 +448,13 @@ async function main(argv = process.argv) {
             }
             const filePath = getFlag(args, '--path');
             const { screenshot } = await import('./commands/screenshot.js');
-            await screenshot(requireSessionRecord(), filePath);
+            await screenshot(requireProductSessionRecord(command), filePath);
             break;
         }
         case 'status': {
+            requireProductSessionRecord(command);
             const { status } = await import('./commands/status.js');
-            await status();
+            outputJSON(await status());
             break;
         }
         case 'close': {

package/dist/otel-exporter.d.ts

@@ -0,0 +1,58 @@
+import { type OtlpTraceRequest } from './otel-projector.js';
+export type OtlpHttpJsonExporterConfig = {
+    tracesEndpoint: string;
+    headers: Record<string, string>;
+    timeoutMs: number;
+    protocol: 'http/json';
+};
+export type ExportStepTraceResult = {
+    attempted: false;
+    reason: 'config_missing' | 'run_missing' | 'step_missing' | 'unsupported_protocol';
+} | {
+    attempted: true;
+    success: true;
+    status: number;
+    payload: OtlpTraceRequest;
+} | {
+    attempted: true;
+    success: false;
+    status?: number;
+    reason: string;
+    payload: OtlpTraceRequest;
+};
+export type ExportRunRootTraceResult = {
+    attempted: false;
+    reason: 'config_missing' | 'run_missing';
+} | {
+    attempted: true;
+    success: true;
+    status: number;
+    payload: OtlpTraceRequest;
+} | {
+    attempted: true;
+    success: false;
+    status?: number;
+    reason: string;
+    payload: OtlpTraceRequest;
+};
+export declare function loadOtlpHttpJsonExporterConfig(env?: NodeJS.ProcessEnv): OtlpHttpJsonExporterConfig | null;
+export declare function exportRunStepToOtlpHttpJson(params?: {
+    runId: string;
+    stepId: string;
+    config?: OtlpHttpJsonExporterConfig | null;
+    fetchImpl?: typeof fetch;
+}): Promise<ExportStepTraceResult>;
+export declare function buildRunStepOtlpTraceRequest(runId: string, stepId: string): OtlpTraceRequest | null;
+export declare function exportRunRootToOtlpHttpJson(params?: {
+    runId: string;
+    config?: OtlpHttpJsonExporterConfig | null;
+    fetchImpl?: typeof fetch;
+}): Promise<ExportRunRootTraceResult>;
+export declare function buildRunRootOtlpTraceRequest(runId: string): OtlpTraceRequest | null;
+export declare function exportRunStepToOtlpHttpJsonBestEffort(runId: string | undefined, stepId: string | undefined, options?: {
+    fetchImpl?: typeof fetch;
+}): Promise<ExportStepTraceResult>;
+export declare function exportRunRootToOtlpHttpJsonBestEffort(runId: string | undefined, options?: {
+    fetchImpl?: typeof fetch;
+}): Promise<ExportRunRootTraceResult>;
+//# sourceMappingURL=otel-exporter.d.ts.map

package/dist/otel-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-exporter.d.ts","sourceRoot":"","sources":["../src/otel-exporter.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAS7B,MAAM,MAAM,0BAA0B,GAAG;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,cAAc,GAAG,sBAAsB,CAAC;CACpF,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;CAC3B,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAChC;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAAC;CAC1C,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;CAC3B,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AA4DN,wBAAgB,8BAA8B,CAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,0BAA0B,GAAG,IAAI,CAsCnC;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,GAAE;IACN,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAI1B,GACA,OAAO,CAAC,qBAAqB,CAAC,CAgFhC;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,gBAAgB,GAAG,IAAI,CAyBzB;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,GAAE;IACN,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAG1B,GACA,OAAO,CAAC,wBAAwB,CAAC,CAkDnC;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAOnF;AAED,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB,GACL,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB,GACL,OAAO,CAAC,wBAAwB,CAAC,CASnC"}