@nuanu-ai/agentbrowse 0.2.47 → 0.2.49

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,
+    });
+}

package/dist/otel-projector.d.ts

@@ -0,0 +1,75 @@
+import type { ArtifactManifest, BrowserStateSnapshot, RunEventRecord, RunRecord, StepRecord } from './run-store.js';
+type OtlpAnyValue = {
+    stringValue: string;
+} | {
+    boolValue: boolean;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+} | {
+    arrayValue: {
+        values: OtlpAnyValue[];
+    };
+} | {
+    kvlistValue: {
+        values: OtlpKeyValue[];
+    };
+};
+type OtlpKeyValue = {
+    key: string;
+    value: OtlpAnyValue;
+};
+type OtlpSpanEvent = {
+    name: string;
+    timeUnixNano: string;
+    attributes?: OtlpKeyValue[];
+};
+type OtlpSpanLink = {
+    traceId: string;
+    spanId: string;
+    attributes?: OtlpKeyValue[];
+};
+type OtlpSpan = {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes?: OtlpKeyValue[];
+    events?: OtlpSpanEvent[];
+    links?: OtlpSpanLink[];
+    status?: {
+        code: number;
+        message?: string;
+    };
+};
+export type OtlpTraceRequest = {
+    resourceSpans: Array<{
+        resource: {
+            attributes: OtlpKeyValue[];
+        };
+        scopeSpans: Array<{
+            scope: {
+                name: string;
+            };
+            spans: OtlpSpan[];
+        }>;
+    }>;
+};
+export declare function sanitizeUrlForTelemetry(url: string): string;
+export declare function projectStepToOtlpTraceRequest(params: {
+    run: RunRecord;
+    step: StepRecord;
+    events?: RunEventRecord[];
+    beforeSnapshot?: BrowserStateSnapshot | null;
+    afterSnapshot?: BrowserStateSnapshot | null;
+    artifactManifest?: ArtifactManifest | null;
+}): OtlpTraceRequest;
+export declare function projectRunRootToOtlpTraceRequest(params: {
+    run: RunRecord;
+}): OtlpTraceRequest;
+export {};
+//# sourceMappingURL=otel-projector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel-projector.d.ts","sourceRoot":"","sources":["../src/otel-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,SAAS,EAET,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB,KAAK,YAAY,GACb;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,UAAU,EAAE;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAA;CAAE,GAC1C;IAAE,WAAW,EAAE;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhD,KAAK,YAAY,GAAG;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B,CAAC;AAEF,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,KAAK,CAAC;QACnB,QAAQ,EAAE;YACR,UAAU,EAAE,YAAY,EAAE,CAAC;SAC5B,CAAC;QACF,UAAU,EAAE,KAAK,CAAC;YAChB,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC;aACd,CAAC;YACF,KAAK,EAAE,QAAQ,EAAE,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ,CAAC;AAwBF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW3D;AAoWD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7C,aAAa,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C,GAAG,gBAAgB,CAiDnB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,SAAS,CAAA;CAAE,GAAG,gBAAgB,CA2C7F"}