@nuanu-ai/agentbrowse 0.2.47 → 0.2.49

package/dist/otel-projector.js

@@ -0,0 +1,409 @@
+const INTERNAL_SPAN_KIND = 1;
+const CLIENT_SPAN_KIND = 3;
+const STATUS_CODE_UNSET = 0;
+const STATUS_CODE_OK = 1;
+const STATUS_CODE_ERROR = 2;
+const MAX_ATTRIBUTE_STRING_LENGTH = 256;
+const MAX_REASON_LENGTH = 512;
+const SENSITIVE_KEY_PATTERN = /(secret|token|password|authorization|cookie|api[-_]?key|raw[-_]?value|raw[-_]?values|resolved[-_]?values|protected[-_]?values)/i;
+function isoToUnixNano(value, fallback) {
+    const source = value ?? fallback;
+    const millis = new Date(source).getTime();
+    const safeMillis = Number.isFinite(millis) ? millis : new Date(fallback).getTime();
+    return `${Math.max(0, safeMillis) * 1_000_000}`;
+}
+function truncateString(value, maxLength = MAX_ATTRIBUTE_STRING_LENGTH) {
+    return value.length <= maxLength ? value : `${value.slice(0, maxLength)}...`;
+}
+export function sanitizeUrlForTelemetry(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.username = '';
+        parsed.password = '';
+        parsed.search = '';
+        parsed.hash = '';
+        return parsed.toString();
+    }
+    catch {
+        return truncateString(url);
+    }
+}
+function isSensitiveKey(key) {
+    return SENSITIVE_KEY_PATTERN.test(key);
+}
+function normalizePrimitiveForTelemetry(key, value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (isSensitiveKey(key)) {
+        return '[redacted]';
+    }
+    if (typeof value === 'string') {
+        if (key.toLowerCase().includes('url')) {
+            return sanitizeUrlForTelemetry(value);
+        }
+        if (key.toLowerCase().includes('reason')) {
+            return truncateString(value, MAX_REASON_LENGTH);
+        }
+        if (key.toLowerCase().includes('message')) {
+            return truncateString(value, MAX_ATTRIBUTE_STRING_LENGTH);
+        }
+        return truncateString(value);
+    }
+    if (typeof value === 'boolean' || typeof value === 'number') {
+        return value;
+    }
+    return undefined;
+}
+function flattenTelemetryAttributes(prefix, value, target) {
+    if (value === null || value === undefined) {
+        return;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return;
+        }
+        const normalized = value
+            .map((entry, index) => normalizePrimitiveForTelemetry(`${prefix}[${index}]`, entry))
+            .filter((entry) => entry !== undefined);
+        if (normalized.length > 0) {
+            target[prefix] = normalized;
+        }
+        return;
+    }
+    if (typeof value === 'object') {
+        for (const [key, nested] of Object.entries(value)) {
+            const nextPrefix = prefix.length > 0 ? `${prefix}.${key}` : key;
+            flattenTelemetryAttributes(nextPrefix, nested, target);
+        }
+        return;
+    }
+    const normalized = normalizePrimitiveForTelemetry(prefix, value);
+    if (normalized !== undefined) {
+        target[prefix] = normalized;
+    }
+}
+function toAnyValue(value) {
+    if (typeof value === 'string') {
+        return { stringValue: value };
+    }
+    if (typeof value === 'boolean') {
+        return { boolValue: value };
+    }
+    if (typeof value === 'number') {
+        if (Number.isInteger(value)) {
+            return { intValue: String(value) };
+        }
+        return { doubleValue: value };
+    }
+    if (Array.isArray(value)) {
+        const values = value.map(toAnyValue).filter((entry) => entry !== null);
+        return { arrayValue: { values } };
+    }
+    if (value && typeof value === 'object') {
+        const values = Object.entries(value)
+            .map(([key, nested]) => {
+            const nestedValue = toAnyValue(nested);
+            return nestedValue ? { key, value: nestedValue } : null;
+        })
+            .filter((entry) => entry !== null);
+        return { kvlistValue: { values } };
+    }
+    return null;
+}
+function toKeyValues(values) {
+    return Object.entries(values)
+        .map(([key, value]) => {
+        const anyValue = toAnyValue(value);
+        return anyValue ? { key, value: anyValue } : null;
+    })
+        .filter((entry) => entry !== null);
+}
+function getPrimaryRunSiteHost(run) {
+    return run.hostHints?.find((entry) => typeof entry === 'string' && entry.length > 0);
+}
+function buildResourceAttributes(run) {
+    const siteHost = getPrimaryRunSiteHost(run);
+    const values = {
+        'service.name': run.resource.serviceName,
+        'service.version': run.resource.serviceVersion,
+        'service.instance.id': run.resource.serviceInstanceId,
+        'telemetry.sdk.language': run.resource.telemetrySdkLanguage,
+        'agentbrowse.session.id': run.sessionId,
+        'agentbrowse.run.id': run.runId,
+        'agentbrowse.run.source': run.source,
+        'agentbrowse.run.entry_command': run.entryCommand,
+        'agentbrowse.run.display_name': run.displayName,
+        'agentbrowse.run.profile': run.profile,
+        'agentbrowse.run.site_host': siteHost,
+        'agentbrowse.run.started_at': run.startedAt,
+        'agentbrowse.run.ended_at': run.endedAt,
+        'agentbrowse.run.status': run.status,
+        'agentbrowse.run.protected': run.protectedRun,
+        'agentbrowse.run.final_outcome_type': run.finalOutcome?.outcomeType,
+        'agentbrowse.run.final_message': run.finalOutcome?.message,
+        'agentbrowse.run.final_reason': run.finalOutcome?.reason,
+    };
+    if (run.hostHints && run.hostHints.length > 0) {
+        values['agentbrowse.run.host_hints'] = run.hostHints.map((host) => truncateString(host));
+    }
+    return toKeyValues(values);
+}
+function buildSnapshotAttributes(snapshot) {
+    return {
+        'agentbrowse.snapshot.phase': snapshot.phase,
+        'agentbrowse.snapshot.page_ref': snapshot.pageRef,
+        'agentbrowse.snapshot.url': sanitizeUrlForTelemetry(snapshot.url),
+        'agentbrowse.snapshot.tab_count': snapshot.tabs.length,
+        'agentbrowse.snapshot.runtime.page_count': snapshot.runtimeSummary.pageCount,
+        'agentbrowse.snapshot.runtime.surface_count': snapshot.runtimeSummary.surfaceCount,
+        'agentbrowse.snapshot.runtime.target_count': snapshot.runtimeSummary.targetCount,
+        'agentbrowse.snapshot.runtime.fillable_form_count': snapshot.runtimeSummary.fillableFormCount,
+        'agentbrowse.snapshot.runtime.secret_request_count': snapshot.runtimeSummary.secretRequestCount,
+        'agentbrowse.snapshot.runtime.protected_page_count': snapshot.runtimeSummary.protectedPageCount,
+        'agentbrowse.snapshot.protected.active': snapshot.protectionState?.protectedExposureActive ?? false,
+        'agentbrowse.snapshot.protected.fill_ref': snapshot.protectionState?.fillRef,
+        'agentbrowse.snapshot.protected.request_id': snapshot.protectionState?.requestId,
+        'agentbrowse.snapshot.protected.reason': snapshot.protectionState?.reason,
+    };
+}
+function buildArtifactAttributes(manifest) {
+    return {
+        'agentbrowse.artifacts.manifest_id': manifest.artifactManifestId,
+        'agentbrowse.artifacts.screenshot_count': manifest.screenshots.length,
+        'agentbrowse.artifacts.html_count': manifest.htmlSnapshots.length,
+        'agentbrowse.artifacts.trace_count': manifest.traces.length,
+        'agentbrowse.artifacts.log_count': manifest.logs.length,
+        'agentbrowse.artifacts.suppressed_count': manifest.suppressed.length,
+        'agentbrowse.artifacts.suppressed_reasons': manifest.suppressed.map((entry) => `${entry.kind}:${entry.reason}`),
+    };
+}
+function buildStepAttributes(run, step, artifactManifest) {
+    const values = {
+        'agentbrowse.run.id': run.runId,
+        'agentbrowse.session.id': run.sessionId,
+        'agentbrowse.step.id': step.stepId,
+        'agentbrowse.step.ordinal': step.ordinal,
+        'agentbrowse.step.command': step.command,
+        'agentbrowse.step.protected': step.protectedStep,
+        'agentbrowse.step.page_ref': step.refs?.pageRef,
+        'agentbrowse.step.target_ref': step.refs?.targetRef,
+        'agentbrowse.step.surface_ref': step.refs?.surfaceRef,
+        'agentbrowse.step.fill_ref': step.refs?.fillRef,
+        'agentbrowse.step.request_id': step.refs?.requestId,
+        'agentbrowse.step.success': step.outputSummary?.success,
+        'agentbrowse.step.outcome_type': step.outputSummary?.outcomeType,
+        'agentbrowse.step.message': step.outputSummary?.message,
+        'agentbrowse.step.reason': step.outputSummary?.reason,
+        'agentbrowse.step.before_snapshot_id': step.beforeSnapshotId,
+        'agentbrowse.step.after_snapshot_id': step.afterSnapshotId,
+        'agentbrowse.step.event_count': step.eventIds.length,
+        'agentbrowse.step.child_span_count': step.childSpans?.length ?? step.childSpanIds?.length ?? 0,
+        'agentbrowse.trace.propagation_mode': run.traceContext.propagationMode,
+    };
+    const flattenedInput = {};
+    flattenTelemetryAttributes('agentbrowse.step.input', step.input, flattenedInput);
+    Object.assign(values, flattenedInput);
+    if (artifactManifest) {
+        Object.assign(values, buildArtifactAttributes(artifactManifest));
+    }
+    return toKeyValues(values);
+}
+function buildRunRootSpanName(run) {
+    const siteHost = getPrimaryRunSiteHost(run);
+    const displayName = typeof run.displayName === 'string' && run.displayName.trim().length > 0
+        ? run.displayName.trim()
+        : undefined;
+    if (siteHost && displayName) {
+        return truncateString(`${siteHost} - ${displayName}`);
+    }
+    if (displayName) {
+        return truncateString(displayName);
+    }
+    if (siteHost) {
+        return truncateString(siteHost);
+    }
+    if (run.entryCommand) {
+        return `agentbrowse.${truncateString(run.entryCommand)}`;
+    }
+    return 'agentbrowse.run';
+}
+function buildRunRootSpanAttributes(run) {
+    const siteHost = getPrimaryRunSiteHost(run);
+    const values = {
+        'agentbrowse.run.id': run.runId,
+        'agentbrowse.session.id': run.sessionId,
+        'agentbrowse.run.entry_command': run.entryCommand,
+        'agentbrowse.run.display_name': run.displayName,
+        'agentbrowse.run.site_host': siteHost,
+        'agentbrowse.run.status': run.status,
+        'agentbrowse.run.protected': run.protectedRun,
+        'agentbrowse.run.step_count': run.stepIds.length,
+        'agentbrowse.run.final_outcome_type': run.finalOutcome?.outcomeType,
+        'agentbrowse.run.final_message': run.finalOutcome?.message,
+        'agentbrowse.run.final_reason': run.finalOutcome?.reason,
+    };
+    if (run.hostHints && run.hostHints.length > 0) {
+        values['agentbrowse.run.host_hints'] = run.hostHints.map((host) => truncateString(host));
+    }
+    return toKeyValues(values);
+}
+function buildEventAttributes(attributes) {
+    const flattened = {};
+    flattenTelemetryAttributes('', attributes, flattened);
+    const keyValues = toKeyValues(flattened);
+    return keyValues.length > 0 ? keyValues : undefined;
+}
+function buildSpanEvents(params) {
+    const spanEvents = params.events.map((event) => ({
+        name: event.name,
+        timeUnixNano: isoToUnixNano(event.emittedAt, event.emittedAt),
+        ...(buildEventAttributes(event.attributes)
+            ? { attributes: buildEventAttributes(event.attributes) }
+            : {}),
+    }));
+    for (const snapshot of [params.beforeSnapshot, params.afterSnapshot]) {
+        if (!snapshot) {
+            continue;
+        }
+        spanEvents.push({
+            name: `browser.snapshot.${snapshot.phase}`,
+            timeUnixNano: isoToUnixNano(snapshot.capturedAt, snapshot.capturedAt),
+            attributes: toKeyValues(buildSnapshotAttributes(snapshot)),
+        });
+    }
+    if (params.artifactManifest) {
+        spanEvents.push({
+            name: 'artifacts.recorded',
+            timeUnixNano: params.afterSnapshot
+                ? isoToUnixNano(params.afterSnapshot.capturedAt, params.afterSnapshot.capturedAt)
+                : String(Date.now() * 1_000_000),
+            attributes: toKeyValues(buildArtifactAttributes(params.artifactManifest)),
+        });
+    }
+    spanEvents.sort((left, right) => left.timeUnixNano.localeCompare(right.timeUnixNano));
+    return spanEvents;
+}
+function buildSpanLinks(step) {
+    if (!step.otel.linkedSpanIds || step.otel.linkedSpanIds.length === 0) {
+        return undefined;
+    }
+    return step.otel.linkedSpanIds.map((spanId) => ({
+        traceId: step.otel.traceId,
+        spanId,
+    }));
+}
+function buildSpanStatus(step) {
+    const code = step.otel.statusCode === 'ok'
+        ? STATUS_CODE_OK
+        : step.otel.statusCode === 'error'
+            ? STATUS_CODE_ERROR
+            : STATUS_CODE_UNSET;
+    return {
+        code,
+        ...(step.otel.statusMessage ? { message: truncateString(step.otel.statusMessage) } : {}),
+    };
+}
+function buildChildSpanStatus(childSpan) {
+    const code = childSpan.statusCode === 'ok'
+        ? STATUS_CODE_OK
+        : childSpan.statusCode === 'error'
+            ? STATUS_CODE_ERROR
+            : STATUS_CODE_UNSET;
+    return {
+        code,
+        ...(childSpan.statusMessage ? { message: truncateString(childSpan.statusMessage) } : {}),
+    };
+}
+function buildChildSpanAttributes(childSpan) {
+    return toKeyValues(childSpan.attributes);
+}
+export function projectStepToOtlpTraceRequest(params) {
+    const span = {
+        traceId: params.step.otel.traceId,
+        spanId: params.step.otel.spanId,
+        ...(params.step.otel.parentSpanId ? { parentSpanId: params.step.otel.parentSpanId } : {}),
+        name: params.step.otel.spanName,
+        kind: INTERNAL_SPAN_KIND,
+        startTimeUnixNano: isoToUnixNano(params.step.startedAt, params.run.startedAt),
+        endTimeUnixNano: isoToUnixNano(params.step.endedAt, params.step.startedAt),
+        attributes: buildStepAttributes(params.run, params.step, params.artifactManifest ?? null),
+        events: buildSpanEvents({
+            events: params.events ?? [],
+            beforeSnapshot: params.beforeSnapshot,
+            afterSnapshot: params.afterSnapshot,
+            artifactManifest: params.artifactManifest,
+        }),
+        ...(buildSpanLinks(params.step) ? { links: buildSpanLinks(params.step) } : {}),
+        status: buildSpanStatus(params.step),
+    };
+    const childSpans = (params.step.childSpans ?? []).map((childSpan) => ({
+        traceId: params.step.otel.traceId,
+        spanId: childSpan.spanId,
+        parentSpanId: childSpan.parentSpanId,
+        name: childSpan.name,
+        kind: CLIENT_SPAN_KIND,
+        startTimeUnixNano: isoToUnixNano(childSpan.startedAt, params.step.startedAt),
+        endTimeUnixNano: isoToUnixNano(childSpan.endedAt, childSpan.startedAt),
+        attributes: buildChildSpanAttributes(childSpan),
+        status: buildChildSpanStatus(childSpan),
+    }));
+    return {
+        resourceSpans: [
+            {
+                resource: {
+                    attributes: buildResourceAttributes(params.run),
+                },
+                scopeSpans: [
+                    {
+                        scope: {
+                            name: params.step.otel.instrumentationScope,
+                        },
+                        spans: [span, ...childSpans],
+                    },
+                ],
+            },
+        ],
+    };
+}
+export function projectRunRootToOtlpTraceRequest(params) {
+    const statusCode = params.run.finalOutcome?.success === true || params.run.status === 'completed'
+        ? STATUS_CODE_OK
+        : params.run.finalOutcome?.success === false ||
+            params.run.status === 'failed' ||
+            params.run.status === 'aborted'
+            ? STATUS_CODE_ERROR
+            : STATUS_CODE_UNSET;
+    const span = {
+        traceId: params.run.traceContext.traceId,
+        spanId: params.run.traceContext.rootSpanId,
+        name: buildRunRootSpanName(params.run),
+        kind: INTERNAL_SPAN_KIND,
+        startTimeUnixNano: isoToUnixNano(params.run.startedAt, params.run.startedAt),
+        endTimeUnixNano: isoToUnixNano(params.run.endedAt, params.run.startedAt),
+        attributes: buildRunRootSpanAttributes(params.run),
+        status: {
+            code: statusCode,
+            ...(params.run.finalOutcome?.reason
+                ? { message: truncateString(params.run.finalOutcome.reason) }
+                : {}),
+        },
+    };
+    return {
+        resourceSpans: [
+            {
+                resource: {
+                    attributes: buildResourceAttributes(params.run),
+                },
+                scopeSpans: [
+                    {
+                        scope: {
+                            name: 'agentbrowse.local-run-store',
+                        },
+                        spans: [span],
+                    },
+                ],
+            },
+        ],
+    };
+}

package/dist/owned-browser.d.ts

@@ -1,7 +1,7 @@
 import { type BrowseSession } from './session.js';
 export type CloseOwnedBrowserResult = {
     success: true;
-    method: 'already_closed' | 'cdp' | 'signal';
+    method: 'already_closed' | 'cdp' | 'signal' | 'cleanup';
 } | {
     success: false;
     reason: string;

package/dist/owned-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"owned-browser.d.ts","sourceRoot":"","sources":["../src/owned-browser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlE,MAAM,MAAM,uBAAuB,GAC/B;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,QAAQ,CAAC;CAC7C,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA2BhG"}
+{"version":3,"file":"owned-browser.d.ts","sourceRoot":"","sources":["../src/owned-browser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlE,MAAM,MAAM,uBAAuB,GAC/B;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzD,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuChG"}

package/dist/owned-browser.js

@@ -1,6 +1,7 @@
 import { connectPlaywright } from './playwright-runtime.js';
-import { terminateOwnedPid } from './owned-process.js';
+import { cleanupManagedBrowserPids, terminateOwnedPid } from './owned-process.js';
 import { getSessionPort } from './session.js';
+import { getUserDataDir } from './solver/config.js';
 const ENDPOINT_WAIT_ATTEMPTS = 10;
 const ENDPOINT_WAIT_MS = 100;
 export async function closeOwnedBrowser(session) {
@@ -19,6 +20,17 @@ export async function closeOwnedBrowser(session) {
             method: endpointAliveBeforeClose ? 'signal' : 'already_closed',
         };
     }
+    if (session.profile) {
+        const cleanup = await cleanupManagedBrowserPids({
+            userDataDir: getUserDataDir(session.profile),
+        });
+        if (await waitForBrowserEndpointToClose(port)) {
+            return {
+                success: true,
+                method: cleanup.terminated.length > 0 ? 'cleanup' : 'already_closed',
+            };
+        }
+    }
     if (!endpointAliveBeforeClose && termination === 'not_found') {
         return { success: true, method: 'already_closed' };
     }

package/dist/owned-process.d.ts

@@ -7,9 +7,11 @@ export declare function isPidAlive(pid: number): boolean;
 export declare function terminateOwnedPid(pid: number): Promise<OwnedPidTerminationResult>;
 export declare function cleanupManagedBrowserPids(options?: {
     excludePids?: Iterable<number>;
+    userDataDir?: string;
 }): Promise<ManagedBrowserCleanupResult>;
 export declare function listManagedBrowserPids(options?: {
     processTable?: string;
+    userDataDir?: string;
 }): number[];
 export declare function isManagedBrowserPid(pid: number, options?: {
     processTable?: string;

package/dist/owned-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"owned-process.d.ts","sourceRoot":"","sources":["../src/owned-process.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AACjG,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW/C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAOvF;AAiCD,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAAO,GAC/C,OAAO,CAAC,2BAA2B,CAAC,CAqBtC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,MAAM,EAAE,CAuBV;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,OAAO,CAET"}
+{"version":3,"file":"owned-process.d.ts","sourceRoot":"","sources":["../src/owned-process.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AACjG,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW/C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAOvF;AAiCD,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC,2BAA2B,CAAC,CAqBtC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,MAAM,EAAE,CAwBV;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,OAAO,CAET"}

package/dist/owned-process.js

@@ -58,7 +58,7 @@ export async function cleanupManagedBrowserPids(options = {}) {
     const excludePids = new Set(options.excludePids ?? []);
     const terminated = [];
     const blocked = [];
-    for (const pid of listManagedBrowserPids()) {
+    for (const pid of listManagedBrowserPids({ userDataDir: options.userDataDir })) {
         if (excludePids.has(pid)) {
             continue;
         }
@@ -76,6 +76,7 @@ export async function cleanupManagedBrowserPids(options = {}) {
 export function listManagedBrowserPids(options = {}) {
     const processTable = options.processTable ?? readProcessTable();
     const pids = new Set();
+    const scopedUserDataDir = options.userDataDir ? path.resolve(options.userDataDir) : null;
     for (const line of processTable.split(/\r?\n/)) {
         const match = line.trimStart().match(/^(\d+)\s+(.*)$/);
         if (!match) {
@@ -86,7 +87,7 @@ export function listManagedBrowserPids(options = {}) {
         if (!Number.isFinite(pid) || pid <= 0 || pid === process.pid) {
             continue;
         }
-        if (!isManagedBrowserCommand(command)) {
+        if (!isManagedBrowserCommand(command, scopedUserDataDir)) {
             continue;
         }
         pids.add(pid);
@@ -123,7 +124,7 @@ function readProcessTable() {
         return '';
     }
 }
-function isManagedBrowserCommand(command) {
+function isManagedBrowserCommand(command, scopedUserDataDir) {
     if (!command.includes('--remote-debugging-address=127.0.0.1')) {
         return false;
     }
@@ -132,6 +133,9 @@ function isManagedBrowserCommand(command) {
         return false;
     }
     const normalizedUserDataDir = path.resolve(userDataDir);
+    if (scopedUserDataDir && normalizedUserDataDir !== scopedUserDataDir) {
+        return false;
+    }
     return MANAGED_PROFILE_ROOTS.some((root) => isWithinRoot(normalizedUserDataDir, root));
 }
 function readCommandFlag(command, flag) {

package/dist/playwright-runtime.d.ts

@@ -1,7 +1,7 @@
 import { type Browser, type Page } from 'playwright-core';
 import type { BrowseSession } from './session.js';
 export declare function connectPlaywright(cdpUrl: string): Promise<Browser>;
-export declare function disconnectPlaywright(browser: Browser): void;
+export declare function disconnectPlaywright(browser: Browser): Promise<void>;
 export declare function listPages(browser: Browser): Page[];
 type LaunchPageMetadata = {
     page: Page | null;

package/dist/playwright-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-runtime.d.ts","sourceRoot":"","sources":["../src/playwright-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO3D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAElD;AA8CD,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAQF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAC;CAC5C,CAAC;AA4IF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,kBAAkB,CAAC,CA+C7B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC5D;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA8Cf;AA+CD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,0BAA0B,CAAC,CAqCrC;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5D"}
+{"version":3,"file":"playwright-runtime.d.ts","sourceRoot":"","sources":["../src/playwright-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAElD;AA8CD,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAQF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAAC;CAC5C,CAAC;AA4IF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,kBAAkB,CAAC,CA+C7B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC5D;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA8Cf;AA+CD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,0BAA0B,CAAC,CAqCrC;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5D"}

package/dist/playwright-runtime.js

@@ -1,15 +1,15 @@
 import { chromium } from 'playwright-core';
-import { ensureRuntimeState, registerPage, updatePage } from './runtime-state.js';
+import { ensureRuntimeState } from './runtime-state.js';
+import { registerPage, updatePage } from './runtime-page-state.js';
 export async function connectPlaywright(cdpUrl) {
     return chromium.connectOverCDP(cdpUrl);
 }
-export function disconnectPlaywright(browser) {
-    void browser;
-    // Playwright exposes no safe public disconnect for CDP browsers here.
-    // Private connection close paths can terminate the remote browser target,
-    // which breaks follow-up observe/act calls in the same process.
-    // The CLI process is short-lived, so we intentionally leave the CDP socket
-    // cleanup to process teardown instead of risking remote browser shutdown.
+export async function disconnectPlaywright(browser) {
+    const maybeClose = browser.close;
+    if (typeof maybeClose !== 'function') {
+        return;
+    }
+    await Promise.resolve(maybeClose.call(browser)).catch(() => undefined);
 }
 export function listPages(browser) {
     return browser.contexts().flatMap((context) => context.pages());

package/dist/run-observability.d.ts

@@ -0,0 +1,25 @@
+import type { BrowseSession } from './session.js';
+import { type BrowserStateSnapshot, type RunEventRecord, type StepRecord } from './run-store.js';
+type StepHandle = Pick<StepRecord, 'runId' | 'stepId' | 'command'> | null | undefined;
+export declare function captureStepSnapshotBestEffort(params: {
+    session: BrowseSession;
+    step: StepHandle;
+    phase: BrowserStateSnapshot['phase'];
+    pageRef?: string;
+    url?: string;
+    title?: string;
+    artifactRefs?: BrowserStateSnapshot['artifactRefs'];
+}): string | undefined;
+export declare function appendStepEventBestEffort(params: {
+    step: StepHandle;
+    source: RunEventRecord['source'];
+    name: string;
+    attributes?: Record<string, unknown>;
+}): string | undefined;
+export declare function appendCommandLifecycleEventBestEffort(params: {
+    step: StepHandle;
+    phase: 'started' | 'completed' | 'failed';
+    attributes?: Record<string, unknown>;
+}): string | undefined;
+export {};
+//# sourceMappingURL=run-observability.d.ts.map

package/dist/run-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-observability.d.ts","sourceRoot":"","sources":["../src/run-observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAExB,KAAK,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AA+EtF,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;CACrD,GAAG,MAAM,GAAG,SAAS,CAqBrB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GAAG,MAAM,GAAG,SAAS,CAiBrB;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE;IAC5D,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,sBAWA"}