@nuanu-ai/agentbrowse 0.2.47 → 0.2.49

package/dist/commands/close.js

@@ -2,9 +2,13 @@
  * browse close — Close the browser and clean up session.
  */
 import { deleteSession, isOwnedSession, loadSession } from '../session.js';
+import { finishRunRecord, finishRunStep, pruneLocalRuns, startRunStep } from '../run-store.js';
+import { appendCommandLifecycleEventBestEffort, captureStepSnapshotBestEffort, } from '../run-observability.js';
+import { exportRunRootToOtlpHttpJsonBestEffort, exportRunStepToOtlpHttpJsonBestEffort, } from '../otel-exporter.js';
 import { info } from '../output.js';
 import { closeOwnedBrowser } from '../owned-browser.js';
 import { isManagedBrowserPid } from '../owned-process.js';
+import { completeWorkflowSessionRemote } from '../workflow-session-completion.js';
 function isCloseableManagedSession(session) {
     if (!session) {
         return false;
@@ -14,11 +18,100 @@ function isCloseableManagedSession(session) {
     }
     return !session.identity && isManagedBrowserPid(session.pid);
 }
+function formatUnknownError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object') {
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return Object.prototype.toString.call(error);
+        }
+    }
+    return String(error);
+}
+async function finalizeRunBestEffort(runId, options) {
+    if (!runId) {
+        return;
+    }
+    try {
+        finishRunRecord(runId, {
+            status: options.status,
+            finalOutcome: {
+                success: options.success,
+                outcomeType: options.outcomeType,
+                message: options.message,
+                ...(options.reason ? { reason: options.reason } : {}),
+            },
+        });
+    }
+    catch (error) {
+        info(`[close] failed to finalize local run ${runId}: ${formatUnknownError(error)}`);
+    }
+}
+function pruneLocalRunsBestEffort() {
+    try {
+        const result = pruneLocalRuns();
+        if (result.deletedRunIds.length > 0) {
+            info(`[close] pruned stale local run${result.deletedRunIds.length === 1 ? '' : 's'} ${result.deletedRunIds.join(', ')}`);
+        }
+        if (result.failedRunIds.length > 0) {
+            info(`[close] failed to prune local run${result.failedRunIds.length === 1 ? '' : 's'} ${result.failedRunIds.map((entry) => `${entry.runId}: ${entry.reason}`).join('; ')}`);
+        }
+    }
+    catch (error) {
+        info(`[close] local run prune failed: ${formatUnknownError(error)}`);
+    }
+}
 export async function close() {
     const session = loadSession();
+    const closeStep = session?.activeRunId
+        ? startRunStep({
+            runId: session.activeRunId,
+            command: 'close',
+            input: {
+                hadSession: session !== null,
+                closeableManagedSession: isCloseableManagedSession(session),
+            },
+        })
+        : null;
+    if (session) {
+        captureStepSnapshotBestEffort({
+            session,
+            step: closeStep,
+            phase: 'before',
+        });
+    }
+    appendCommandLifecycleEventBestEffort({
+        step: closeStep,
+        phase: 'started',
+        attributes: {
+            hadSession: session !== null,
+            closeableManagedSession: isCloseableManagedSession(session),
+        },
+    });
     if (isCloseableManagedSession(session)) {
         const closeResult = await closeOwnedBrowser(session);
         if (!closeResult.success) {
+            appendCommandLifecycleEventBestEffort({
+                step: closeStep,
+                phase: 'failed',
+                attributes: {
+                    outcomeType: 'browser_close_failed',
+                    reason: closeResult.reason,
+                },
+            });
+            await finalizeStepBestEffort(session?.activeRunId, closeStep?.stepId, {
+                success: false,
+                outcomeType: 'browser_close_failed',
+                message: 'Browser close failed.',
+                reason: closeResult.reason,
+            });
             info(`Owned browser close failed; keeping session record: ${closeResult.reason}`);
             return {
                 success: false,
@@ -30,8 +123,93 @@ export async function close() {
         }
         info(`Closed owned browser via ${closeResult.method}`);
     }
+    if (session?.intentSessionId) {
+        const remoteCompletion = await completeWorkflowSessionRemote({
+            session,
+            stepId: closeStep?.stepId,
+            command: 'close',
+            terminalStatus: 'canceled',
+            runStatus: 'aborted',
+            summary: 'Browser session closed before the workflow completed.',
+            outcomeType: 'workflow_session_canceled',
+            message: 'Workflow session canceled because the browser was closed.',
+            reason: 'The active browser session was closed by the close command.',
+        });
+        if (!remoteCompletion.success) {
+            const reason = remoteCompletion.reason;
+            const failureError = remoteCompletion.error === 'backend_session_complete_failed'
+                ? 'workflow_session_complete_failed'
+                : remoteCompletion.error;
+            const failureMessage = 'Browser closed but workflow session completion failed.';
+            appendCommandLifecycleEventBestEffort({
+                step: closeStep,
+                phase: 'failed',
+                attributes: {
+                    outcomeType: remoteCompletion.error === 'backend_session_complete_failed'
+                        ? 'workflow_session_complete_failed'
+                        : remoteCompletion.error,
+                    reason,
+                },
+            });
+            await finalizeStepBestEffort(session?.activeRunId, closeStep?.stepId, {
+                success: false,
+                outcomeType: remoteCompletion.error === 'backend_session_complete_failed'
+                    ? 'workflow_session_complete_failed'
+                    : remoteCompletion.error,
+                message: failureMessage,
+                reason,
+                skipExport: true,
+            });
+            return {
+                success: false,
+                error: failureError,
+                outcomeType: remoteCompletion.error === 'backend_session_complete_failed' ? 'failed' : 'blocked',
+                message: failureMessage,
+                reason,
+            };
+        }
+    }
+    appendCommandLifecycleEventBestEffort({
+        step: closeStep,
+        phase: 'completed',
+        attributes: {
+            outcomeType: 'browser_closed',
+        },
+    });
     if (session) {
         deleteSession();
     }
+    await finalizeStepBestEffort(session?.activeRunId, closeStep?.stepId, {
+        success: true,
+        outcomeType: 'browser_closed',
+        message: 'Browser session closed.',
+    });
+    await finalizeRunBestEffort(session?.activeRunId, {
+        status: 'aborted',
+        success: false,
+        outcomeType: 'browser_closed',
+        message: 'Browser session closed.',
+        reason: 'The active browser session was closed by the close command.',
+    });
+    await exportRunRootToOtlpHttpJsonBestEffort(session?.activeRunId);
+    pruneLocalRunsBestEffort();
     return { success: true };
 }
+async function finalizeStepBestEffort(runId, stepId, options) {
+    if (!runId || !stepId) {
+        return;
+    }
+    try {
+        finishRunStep({
+            runId,
+            stepId,
+            ...options,
+        });
+    }
+    catch (error) {
+        info(`[close] failed to finalize local run step ${stepId}: ${formatUnknownError(error)}`);
+    }
+    if (!options.skipExport) {
+        await exportRunStepToOtlpHttpJsonBestEffort(runId, stepId);
+    }
+}

package/dist/commands/descriptor-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"descriptor-validation.d.ts","sourceRoot":"","sources":["../../src/commands/descriptor-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,eAAO,MAAM,4BAA4B,QAaxC,CAAC;AAEF,iBAAS,gCAAgC,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAwBF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWtF;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAWxC;AAOD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GACtC,OAAO,CAoCT;AAED,eAAO,MAAM,0BAA0B;;;;;CAKtC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6EnF"}
+{"version":3,"file":"descriptor-validation.d.ts","sourceRoot":"","sources":["../../src/commands/descriptor-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,eAAO,MAAM,4BAA4B,QAaxC,CAAC;AAEF,iBAAS,gCAAgC,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAiGF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWtF;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAWxC;AAOD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GACtC,OAAO,CAoCT;AAED,eAAO,MAAM,0BAA0B;;;;;CAKtC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnF"}

package/dist/commands/descriptor-validation.js

@@ -46,6 +46,78 @@ const LOCATOR_BINDING_SNAPSHOT_SCRIPT = String.raw `
     autocomplete: element.getAttribute('autocomplete')?.trim() || undefined,
   };
 `;
+const LOCATOR_OUTER_HTML_SCRIPT = String.raw `
+  if (!(element instanceof HTMLElement)) {
+    return null;
+  }
+
+  const ownerWindow = element.ownerDocument?.defaultView || window;
+  const TextCtor = ownerWindow.Text;
+  const ElementCtor = ownerWindow.Element;
+  const ShadowRootCtor = ownerWindow.ShadowRoot;
+  const voidTags = new Set([
+    'area',
+    'base',
+    'br',
+    'col',
+    'embed',
+    'hr',
+    'img',
+    'input',
+    'link',
+    'meta',
+    'param',
+    'source',
+    'track',
+    'wbr',
+  ]);
+
+  const escapeText = (value) =>
+    value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+
+  const escapeAttribute = (value) =>
+    value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
+
+  const serializeChildren = (parent) =>
+    Array.from(parent.childNodes)
+      .map((node) => serializeNode(node))
+      .join('');
+
+  const serializeNode = (node) => {
+    if (node instanceof TextCtor) {
+      return escapeText(node.textContent ?? '');
+    }
+
+    if (!(node instanceof ElementCtor)) {
+      return '';
+    }
+
+    const tag = node.tagName.toLowerCase();
+    if (['script', 'style', 'noscript', 'template'].includes(tag)) {
+      return '';
+    }
+
+    const attrs = node
+      .getAttributeNames()
+      .sort()
+      .map((name) => ' ' + name + '="' + escapeAttribute(node.getAttribute(name) ?? '') + '"')
+      .join('');
+    const shadowRoot =
+      node.shadowRoot && node.shadowRoot instanceof ShadowRootCtor ? node.shadowRoot : null;
+    const shadowHtml = shadowRoot
+      ? '<div data-agentbrowse-shadow-root="open">' + serializeChildren(shadowRoot) + '</div>'
+      : '';
+    const childHtml = serializeChildren(node);
+
+    if (voidTags.has(tag)) {
+      return '<' + tag + attrs + '>' + shadowHtml;
+    }
+
+    return '<' + tag + attrs + '>' + shadowHtml + childHtml + '</' + tag + '>';
+  };
+
+  return serializeNode(element);
+`;
 export async function readLocatorDomSignature(locator) {
     try {
         return await locator
@@ -110,63 +182,9 @@ export const __testDescriptorValidation = {
 };
 export async function readLocatorOuterHtml(locator) {
     try {
-        return await locator.first().evaluate((element) => {
-            if (!(element instanceof HTMLElement)) {
-                return null;
-            }
-            const ownerWindow = element.ownerDocument?.defaultView || window;
-            const TextCtor = ownerWindow.Text;
-            const ElementCtor = ownerWindow.Element;
-            const ShadowRootCtor = ownerWindow.ShadowRoot;
-            const voidTags = new Set([
-                'area',
-                'base',
-                'br',
-                'col',
-                'embed',
-                'hr',
-                'img',
-                'input',
-                'link',
-                'meta',
-                'param',
-                'source',
-                'track',
-                'wbr',
-            ]);
-            const escapeText = (value) => value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-            const escapeAttribute = (value) => value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
-            const serializeChildren = (parent) => Array.from(parent.childNodes)
-                .map((node) => serializeNode(node))
-                .join('');
-            const serializeNode = (node) => {
-                if (node instanceof TextCtor) {
-                    return escapeText(node.textContent ?? '');
-                }
-                if (!(node instanceof ElementCtor)) {
-                    return '';
-                }
-                const tag = node.tagName.toLowerCase();
-                if (['script', 'style', 'noscript', 'template'].includes(tag)) {
-                    return '';
-                }
-                const attrs = node
-                    .getAttributeNames()
-                    .sort()
-                    .map((name) => ` ${name}="${escapeAttribute(node.getAttribute(name) ?? '')}"`)
-                    .join('');
-                const shadowRoot = node.shadowRoot && node.shadowRoot instanceof ShadowRootCtor ? node.shadowRoot : null;
-                const shadowHtml = shadowRoot
-                    ? `<div data-agentbrowse-shadow-root="open">${serializeChildren(shadowRoot)}</div>`
-                    : '';
-                const childHtml = serializeChildren(node);
-                if (voidTags.has(tag)) {
-                    return `<${tag}${attrs}>${shadowHtml}`;
-                }
-                return `<${tag}${attrs}>${shadowHtml}${childHtml}</${tag}>`;
-            };
-            return serializeNode(element);
-        });
+        return await locator
+            .first()
+            .evaluate((element, source) => Function('element', source)(element), LOCATOR_OUTER_HTML_SCRIPT);
     }
     catch {
         return null;

package/dist/commands/end-session.d.ts

@@ -0,0 +1,25 @@
+/**
+ * browse end-session — Mark the current workflow session as completed without closing the browser.
+ */
+import { type BrowseSession } from '../session.js';
+export type EndSessionSuccessResult = {
+    success: true;
+    runId: string;
+    intentSessionId: string;
+    status: string;
+    lastEventSeq: number;
+    browserSessionId: string | null;
+    completedAt: string;
+    outcomeType: 'workflow_session_completed';
+    message: 'Workflow session completed.';
+};
+export type EndSessionFailureResult = {
+    success: false;
+    error: 'workflow_session_unavailable' | 'workflow_run_unavailable' | 'workflow_step_unavailable' | 'backend_session_complete_failed';
+    outcomeType: 'blocked' | 'failed';
+    message: 'Workflow session end failed.';
+    reason: string;
+};
+export type EndSessionResult = EndSessionSuccessResult | EndSessionFailureResult;
+export declare function endSession(session: BrowseSession): Promise<EndSessionResult>;
+//# sourceMappingURL=end-session.d.ts.map

package/dist/commands/end-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-session.d.ts","sourceRoot":"","sources":["../../src/commands/end-session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAOhE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,4BAA4B,CAAC;IAC1C,OAAO,EAAE,6BAA6B,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EACD,8BAA8B,GAC9B,0BAA0B,GAC1B,2BAA2B,GAC3B,iCAAiC,CAAC;IACtC,WAAW,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,8BAA8B,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,uBAAuB,CAAC;AA0DjF,wBAAsB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0IlF"}

package/dist/commands/end-session.js

@@ -0,0 +1,161 @@
+/**
+ * browse end-session — Mark the current workflow session as completed without closing the browser.
+ */
+import { withApiTraceContext } from '../command-api-tracing.js';
+import { exportRunRootToOtlpHttpJsonBestEffort, exportRunStepToOtlpHttpJsonBestEffort, } from '../otel-exporter.js';
+import { info } from '../output.js';
+import { appendCommandLifecycleEventBestEffort, captureStepSnapshotBestEffort, } from '../run-observability.js';
+import { finishRunRecord, finishRunStep, startRunStep } from '../run-store.js';
+import { saveSession } from '../session.js';
+import { clearWorkflowState, completeWorkflowSessionRemote, formatUnknownWorkflowCompletionError, } from '../workflow-session-completion.js';
+function finalizeEndSessionStepBestEffort(runId, stepId, options) {
+    if (!runId || !stepId) {
+        return;
+    }
+    try {
+        finishRunStep({
+            runId,
+            stepId,
+            ...options,
+        });
+    }
+    catch (error) {
+        info(`[end-session] failed to finalize local run step ${stepId}: ${formatUnknownWorkflowCompletionError(error)}`);
+    }
+}
+function finalizeRunRecordBestEffort(runId, options) {
+    if (!runId) {
+        return;
+    }
+    try {
+        finishRunRecord(runId, {
+            status: options.status,
+            finalOutcome: {
+                success: options.success,
+                ...(options.outcomeType ? { outcomeType: options.outcomeType } : {}),
+                ...(options.message ? { message: options.message } : {}),
+                ...(options.reason ? { reason: options.reason } : {}),
+            },
+        });
+    }
+    catch (error) {
+        info(`[end-session] failed to finalize local run ${runId}: ${formatUnknownWorkflowCompletionError(error)}`);
+    }
+}
+export async function endSession(session) {
+    const endSessionStep = session.activeRunId
+        ? startRunStep({
+            runId: session.activeRunId,
+            command: 'end-session',
+            input: {
+                hasWorkflowSession: Boolean(session.intentSessionId),
+                currentRequestId: session.currentRequestId ?? null,
+            },
+        })
+        : null;
+    const endSessionStepHandle = session.activeRunId && endSessionStep?.stepId
+        ? {
+            runId: session.activeRunId,
+            stepId: endSessionStep.stepId,
+            command: 'end-session',
+        }
+        : null;
+    captureStepSnapshotBestEffort({
+        session,
+        step: endSessionStepHandle,
+        phase: 'before',
+        pageRef: session.runtime?.currentPageRef,
+    });
+    appendCommandLifecycleEventBestEffort({
+        step: endSessionStepHandle,
+        phase: 'started',
+        attributes: {
+            hasWorkflowSession: Boolean(session.intentSessionId),
+            currentRequestId: session.currentRequestId ?? null,
+            pageRef: session.runtime?.currentPageRef,
+        },
+    });
+    return withApiTraceContext({
+        runId: session.activeRunId,
+        stepId: endSessionStep?.stepId,
+        command: 'end-session',
+    }, async () => {
+        const remoteCompletion = await completeWorkflowSessionRemote({
+            session,
+            stepId: endSessionStep?.stepId,
+            command: 'end-session',
+            terminalStatus: 'completed',
+            runStatus: 'completed',
+            summary: 'Workflow session completed.',
+            outcomeType: 'workflow_session_completed',
+            message: 'Workflow session completed.',
+        });
+        if (!remoteCompletion.success) {
+            const outcomeType = remoteCompletion.error === 'backend_session_complete_failed' ? 'backend_session_complete_failed' : 'blocked';
+            appendCommandLifecycleEventBestEffort({
+                step: endSessionStepHandle,
+                phase: 'failed',
+                attributes: {
+                    outcomeType,
+                    reason: remoteCompletion.reason,
+                },
+            });
+            finalizeEndSessionStepBestEffort(session.activeRunId, endSessionStep?.stepId, {
+                success: false,
+                outcomeType,
+                message: 'Workflow session end failed.',
+                reason: remoteCompletion.reason,
+            });
+            await exportRunStepToOtlpHttpJsonBestEffort(session.activeRunId, endSessionStep?.stepId);
+            return {
+                success: false,
+                error: remoteCompletion.error,
+                outcomeType: remoteCompletion.error === 'backend_session_complete_failed' ? 'failed' : 'blocked',
+                message: 'Workflow session end failed.',
+                reason: remoteCompletion.reason,
+            };
+        }
+        captureStepSnapshotBestEffort({
+            session,
+            step: endSessionStepHandle,
+            phase: 'after',
+            pageRef: session.runtime?.currentPageRef,
+        });
+        appendCommandLifecycleEventBestEffort({
+            step: endSessionStepHandle,
+            phase: 'completed',
+            attributes: {
+                outcomeType: 'workflow_session_completed',
+                intentSessionId: remoteCompletion.response.session.id,
+                remoteLastEventSeq: remoteCompletion.response.session.last_event_seq,
+                pageRef: session.runtime?.currentPageRef,
+            },
+        });
+        finalizeEndSessionStepBestEffort(remoteCompletion.runId, remoteCompletion.stepId ?? undefined, {
+            success: true,
+            outcomeType: 'workflow_session_completed',
+            message: 'Workflow session completed.',
+        });
+        finalizeRunRecordBestEffort(remoteCompletion.runId, {
+            status: 'completed',
+            success: true,
+            outcomeType: 'workflow_session_completed',
+            message: 'Workflow session completed.',
+        });
+        const nextSession = clearWorkflowState(session);
+        saveSession(nextSession);
+        await exportRunStepToOtlpHttpJsonBestEffort(remoteCompletion.runId, remoteCompletion.stepId ?? undefined);
+        await exportRunRootToOtlpHttpJsonBestEffort(remoteCompletion.runId);
+        return {
+            success: true,
+            runId: remoteCompletion.runId,
+            intentSessionId: remoteCompletion.response.session.id,
+            status: remoteCompletion.response.session.status,
+            lastEventSeq: remoteCompletion.response.session.last_event_seq,
+            browserSessionId: remoteCompletion.response.browser_session_id,
+            completedAt: remoteCompletion.completedAt,
+            outcomeType: 'workflow_session_completed',
+            message: 'Workflow session completed.',
+        };
+    });
+}

package/dist/commands/extract-stagehand-executor.js

@@ -1,7 +1,7 @@
 import { extract as runExtract } from '@browserbasehq/stagehand/lib/inference.js';
 import { v3Logger } from '@browserbasehq/stagehand/lib/v3/logger.js';
 import { captureHybridSnapshot } from '@browserbasehq/stagehand/lib/v3/understudy/a11y/snapshot/index.js';
-import { incrementMetric, recordLlmUsage, recordPayloadBudget } from '../runtime-state.js';
+import { incrementMetric, recordLlmUsage, recordPayloadBudget } from '../runtime-metrics.js';
 import { stagehandRuntimeResolution } from '../runtime-resolution.js';
 import { withStagehand } from '../stagehand-runtime.js';
 import { readLocatorOuterHtml } from './descriptor-validation.js';

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

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/commands/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAmOnD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA6Of"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/commands/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAyUnD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA8Sf"}