@nuanu-ai/agentbrowse 0.2.46 → 0.2.48

package/dist/index.js

@@ -7,7 +7,7 @@ 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 { outputContractFailure, outputError, outputJSON, fatal, info } from './output.js';
 import { applyDemoProxyBootstrap } from './solver/config.js';
 function usageText() {
     return `Usage: ${browseCommandName()} <command> [args] [options]
@@ -15,14 +15,17 @@ function usageText() {
 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
@@ -40,6 +43,7 @@ Options:
   --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 +52,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',
@@ -201,19 +207,96 @@ 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();
@@ -257,60 +340,74 @@ async function main(argv = process.argv) {
                 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 +420,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 +431,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 +447,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"}

package/dist/otel-exporter.js

@@ -0,0 +1,263 @@
+import { listRunEventRecordsForStep, loadArtifactManifest, loadBrowserStateSnapshot, loadRunRecord, loadStepRecord, setRunIngestState, } from './run-store.js';
+import { projectRunRootToOtlpTraceRequest, projectStepToOtlpTraceRequest, } from './otel-projector.js';
+import { exportRunStepViaSessionEvent } from './session-event-exporter.js';
+import { buildAgentpayTelemetryTracesUrl, tryResolveAgentpayGatewayConfig, } from './agentpay-gateway.js';
+const DEFAULT_HTTP_TIMEOUT_MS = 5_000;
+function trimEnv(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function parseHeaderList(value) {
+    if (!value) {
+        return {};
+    }
+    const headers = {};
+    for (const chunk of value.split(',')) {
+        const separatorIndex = chunk.indexOf('=');
+        if (separatorIndex === -1) {
+            continue;
+        }
+        const key = chunk.slice(0, separatorIndex).trim();
+        const headerValue = chunk.slice(separatorIndex + 1).trim();
+        if (!key || !headerValue) {
+            continue;
+        }
+        headers[key] = headerValue;
+    }
+    return headers;
+}
+function parseTimeoutMs(value) {
+    const parsed = value ? Number(value) : NaN;
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_HTTP_TIMEOUT_MS;
+}
+function buildTracesEndpoint(base) {
+    return `${base.replace(/\/+$/, '')}/v1/traces`;
+}
+async function postOtlpTraceRequest(params) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), params.config.timeoutMs);
+    try {
+        return await params.fetchImpl(params.config.tracesEndpoint, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                ...params.config.headers,
+            },
+            body: JSON.stringify(params.payload),
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function loadOtlpHttpJsonExporterConfig(env = process.env) {
+    const protocol = trimEnv(env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL) ??
+        trimEnv(env.OTEL_EXPORTER_OTLP_PROTOCOL) ??
+        'http/json';
+    if (protocol !== 'http/json') {
+        return null;
+    }
+    const tracesEndpoint = trimEnv(env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT);
+    const baseEndpoint = trimEnv(env.OTEL_EXPORTER_OTLP_ENDPOINT);
+    const gateway = tryResolveAgentpayGatewayConfig();
+    const resolvedEndpoint = tracesEndpoint ??
+        (baseEndpoint ? buildTracesEndpoint(baseEndpoint) : null) ??
+        (gateway ? buildAgentpayTelemetryTracesUrl(gateway.apiUrl) : null);
+    if (!resolvedEndpoint) {
+        return null;
+    }
+    const timeoutMs = parseTimeoutMs(trimEnv(env.OTEL_EXPORTER_OTLP_TRACES_TIMEOUT) ??
+        trimEnv(env.OTEL_EXPORTER_OTLP_TIMEOUT));
+    const headers = {
+        ...parseHeaderList(trimEnv(env.OTEL_EXPORTER_OTLP_HEADERS)),
+        ...parseHeaderList(trimEnv(env.OTEL_EXPORTER_OTLP_TRACES_HEADERS)),
+    };
+    if (!headers.authorization && gateway) {
+        headers.authorization = `Bearer ${gateway.apiKey}`;
+    }
+    return {
+        tracesEndpoint: resolvedEndpoint,
+        headers,
+        timeoutMs,
+        protocol: 'http/json',
+    };
+}
+export async function exportRunStepToOtlpHttpJson(params = {
+    runId: '',
+    stepId: '',
+}) {
+    const run = loadRunRecord(params.runId);
+    if (!run) {
+        return { attempted: false, reason: 'run_missing' };
+    }
+    const step = loadStepRecord(params.runId, params.stepId);
+    if (!step) {
+        return { attempted: false, reason: 'step_missing' };
+    }
+    const payload = buildRunStepOtlpTraceRequest(params.runId, params.stepId);
+    if (!payload) {
+        return { attempted: false, reason: 'step_missing' };
+    }
+    const fetchImpl = params.fetchImpl ?? fetch;
+    const sessionEventResult = await exportRunStepViaSessionEvent({
+        runId: params.runId,
+        stepId: params.stepId,
+        telemetryPayload: payload,
+        fetchImpl,
+    });
+    if (sessionEventResult.attempted) {
+        if (sessionEventResult.success) {
+            return {
+                attempted: true,
+                success: true,
+                status: sessionEventResult.status,
+                payload,
+            };
+        }
+        return {
+            attempted: true,
+            success: false,
+            ...(sessionEventResult.status !== undefined ? { status: sessionEventResult.status } : {}),
+            reason: sessionEventResult.reason,
+            payload,
+        };
+    }
+    const config = params.config ?? loadOtlpHttpJsonExporterConfig();
+    if (!config) {
+        return { attempted: false, reason: 'config_missing' };
+    }
+    try {
+        const response = await postOtlpTraceRequest({
+            payload,
+            config,
+            fetchImpl,
+        });
+        if (!response.ok) {
+            setRunIngestState(params.runId, 'export_failed');
+            return {
+                attempted: true,
+                success: false,
+                status: response.status,
+                reason: `otlp_http_status_${response.status}`,
+                payload,
+            };
+        }
+        setRunIngestState(params.runId, 'exported');
+        return {
+            attempted: true,
+            success: true,
+            status: response.status,
+            payload,
+        };
+    }
+    catch (error) {
+        setRunIngestState(params.runId, 'export_failed');
+        return {
+            attempted: true,
+            success: false,
+            reason: error instanceof Error ? error.message : String(error),
+            payload,
+        };
+    }
+}
+export function buildRunStepOtlpTraceRequest(runId, stepId) {
+    const run = loadRunRecord(runId);
+    if (!run) {
+        return null;
+    }
+    const step = loadStepRecord(runId, stepId);
+    if (!step) {
+        return null;
+    }
+    return projectStepToOtlpTraceRequest({
+        run,
+        step,
+        events: listRunEventRecordsForStep(runId, stepId),
+        beforeSnapshot: step.beforeSnapshotId
+            ? loadBrowserStateSnapshot(runId, step.beforeSnapshotId)
+            : null,
+        afterSnapshot: step.afterSnapshotId
+            ? loadBrowserStateSnapshot(runId, step.afterSnapshotId)
+            : null,
+        artifactManifest: step.artifactManifestId
+            ? loadArtifactManifest(runId, step.artifactManifestId)
+            : null,
+    });
+}
+export async function exportRunRootToOtlpHttpJson(params = {
+    runId: '',
+}) {
+    const config = params.config ?? loadOtlpHttpJsonExporterConfig();
+    if (!config) {
+        return { attempted: false, reason: 'config_missing' };
+    }
+    const run = loadRunRecord(params.runId);
+    if (!run) {
+        return { attempted: false, reason: 'run_missing' };
+    }
+    const payload = buildRunRootOtlpTraceRequest(params.runId);
+    if (!payload) {
+        return { attempted: false, reason: 'run_missing' };
+    }
+    const fetchImpl = params.fetchImpl ?? fetch;
+    try {
+        const response = await postOtlpTraceRequest({
+            payload,
+            config,
+            fetchImpl,
+        });
+        if (!response.ok) {
+            setRunIngestState(params.runId, 'export_failed');
+            return {
+                attempted: true,
+                success: false,
+                status: response.status,
+                reason: `otlp_http_status_${response.status}`,
+                payload,
+            };
+        }
+        setRunIngestState(params.runId, 'exported');
+        return {
+            attempted: true,
+            success: true,
+            status: response.status,
+            payload,
+        };
+    }
+    catch (error) {
+        setRunIngestState(params.runId, 'export_failed');
+        return {
+            attempted: true,
+            success: false,
+            reason: error instanceof Error ? error.message : String(error),
+            payload,
+        };
+    }
+}
+export function buildRunRootOtlpTraceRequest(runId) {
+    const run = loadRunRecord(runId);
+    if (!run) {
+        return null;
+    }
+    return projectRunRootToOtlpTraceRequest({ run });
+}
+export async function exportRunStepToOtlpHttpJsonBestEffort(runId, stepId, options = {}) {
+    if (!runId || !stepId) {
+        return { attempted: false, reason: 'step_missing' };
+    }
+    return exportRunStepToOtlpHttpJson({
+        runId,
+        stepId,
+        fetchImpl: options.fetchImpl,
+    });
+}
+export async function exportRunRootToOtlpHttpJsonBestEffort(runId, options = {}) {
+    if (!runId) {
+        return { attempted: false, reason: 'run_missing' };
+    }
+    return exportRunRootToOtlpHttpJson({
+        runId,
+        fetchImpl: options.fetchImpl,
+    });
+}