@mercuryo-ai/agentbrowse 0.2.50

package/dist/protected-fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-fill.d.ts","sourceRoot":"","sources":["../src/protected-fill.ts"],"names":[],"mappings":"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"}

package/dist/protected-fill.js

@@ -0,0 +1,20 @@
+import { fillProtectedFormBrowser, } from "./protected-fill-browser.js";
+import { buildProtectedExactValueProfile as buildProtectedExactValueProfileInternal } from "./secrets/protected-exact-value-redaction.js";
+/** Fills a previously observed protected form with caller-provided protected values. */
+export async function fillProtectedForm(params) {
+    return (await fillProtectedFormBrowser({
+        session: params.session,
+        fillableForm: params.fillableForm,
+        protectedValues: params.protectedValues,
+        fieldPolicies: params.fieldPolicies,
+    }));
+}
+export function buildProtectedExposureArtifacts(params) {
+    const filteredProtectedValues = Object.fromEntries(Object.entries(params.protectedValues).filter((entry) => {
+        const value = entry[1];
+        return typeof value === "string" && value.length > 0;
+    }));
+    return {
+        exactValueProfile: buildProtectedExactValueProfileInternal(filteredProtectedValues),
+    };
+}

package/dist/runtime-metrics.d.ts

@@ -0,0 +1,27 @@
+import type { BrowserSessionState } from './browser-session-state.js';
+import { type BrowsePayloadBudgetMetrics, type BrowseRuntimeMetrics } from './runtime-state.js';
+type NumericBrowseRuntimeMetricKey = Exclude<{
+    [K in keyof BrowseRuntimeMetrics]: BrowseRuntimeMetrics[K] extends number | undefined ? K : never;
+}[keyof BrowseRuntimeMetrics], undefined>;
+type LlmUsageLike = Partial<{
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    cached_input_tokens: number;
+    reasoning_tokens: number;
+}>;
+export declare function incrementMetric(session: BrowserSessionState, metric: NumericBrowseRuntimeMetricKey, by?: number): number;
+export declare function recordActionResult(session: BrowserSessionState, success: boolean, durationMs: number): BrowseRuntimeMetrics;
+export declare function recordLlmUsage(session: BrowserSessionState, params: {
+    purpose: string;
+    usage?: LlmUsageLike | null;
+    inputChars?: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cachedInputTokens?: number;
+    reasoningTokens?: number;
+}): BrowseRuntimeMetrics;
+export declare function recordPayloadBudget(session: BrowserSessionState, patch: Partial<BrowsePayloadBudgetMetrics>): BrowseRuntimeMetrics;
+export {};
+//# sourceMappingURL=runtime-metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-metrics.d.ts","sourceRoot":"","sources":["../src/runtime-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAKL,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,KAAK,6BAA6B,GAAG,OAAO,CAC1C;KACG,CAAC,IAAI,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,GACjF,CAAC,GACD,KAAK;CACV,CAAC,MAAM,oBAAoB,CAAC,EAC7B,SAAS,CACV,CAAC;AAEF,KAAK,YAAY,GAAG,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,CAAC;AAEH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,6BAA6B,EACrC,EAAE,SAAI,GACL,MAAM,CAIR;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAetB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,oBAAoB,CAmCtB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,OAAO,CAAC,0BAA0B,CAAC,GACzC,oBAAoB,CAgBtB"}

package/dist/runtime-metrics.js

@@ -0,0 +1,66 @@
+import { createLlmUsageBucket, createPayloadBudgetMetrics, ensureMetricsExtensions, ensureRuntimeState, } from './runtime-state.js';
+export function incrementMetric(session, metric, by = 1) {
+    const runtime = ensureRuntimeState(session);
+    runtime.metrics[metric] = (runtime.metrics[metric] ?? 0) + by;
+    return runtime.metrics[metric] ?? 0;
+}
+export function recordActionResult(session, success, durationMs) {
+    const runtime = ensureRuntimeState(session);
+    ensureMetricsExtensions(runtime.metrics);
+    if (success) {
+        runtime.metrics.successfulActions += 1;
+    }
+    else {
+        runtime.metrics.failedActions += 1;
+    }
+    runtime.metrics.totalActionDurationMs += Math.max(0, durationMs);
+    const attempts = runtime.metrics.successfulActions + runtime.metrics.failedActions;
+    runtime.metrics.successRate = attempts === 0 ? 0 : runtime.metrics.successfulActions / attempts;
+    runtime.metrics.averageActionDurationMs =
+        attempts === 0 ? 0 : runtime.metrics.totalActionDurationMs / attempts;
+    return runtime.metrics;
+}
+export function recordLlmUsage(session, params) {
+    const runtime = ensureRuntimeState(session);
+    ensureMetricsExtensions(runtime.metrics);
+    const promptTokens = params.promptTokens ?? params.usage?.prompt_tokens ?? 0;
+    const completionTokens = params.completionTokens ?? params.usage?.completion_tokens ?? 0;
+    const totalTokens = params.totalTokens ??
+        params.usage?.total_tokens ??
+        (promptTokens > 0 || completionTokens > 0 ? promptTokens + completionTokens : 0);
+    const cachedInputTokens = params.cachedInputTokens ?? params.usage?.cached_input_tokens ?? 0;
+    const reasoningTokens = params.reasoningTokens ?? params.usage?.reasoning_tokens ?? 0;
+    const inputChars = params.inputChars ?? 0;
+    runtime.metrics.llmCalls = (runtime.metrics.llmCalls ?? 0) + 1;
+    runtime.metrics.llmPromptTokens = (runtime.metrics.llmPromptTokens ?? 0) + promptTokens;
+    runtime.metrics.llmCompletionTokens =
+        (runtime.metrics.llmCompletionTokens ?? 0) + completionTokens;
+    runtime.metrics.llmTotalTokens = (runtime.metrics.llmTotalTokens ?? 0) + totalTokens;
+    runtime.metrics.llmCachedInputTokens =
+        (runtime.metrics.llmCachedInputTokens ?? 0) + cachedInputTokens;
+    runtime.metrics.llmReasoningTokens = (runtime.metrics.llmReasoningTokens ?? 0) + reasoningTokens;
+    const purposeKey = params.purpose.trim().length > 0 ? params.purpose.trim() : 'unknown';
+    const bucket = runtime.metrics.llmUsageByPurpose?.[purposeKey] ?? createLlmUsageBucket();
+    bucket.calls += 1;
+    bucket.inputChars += inputChars;
+    bucket.promptTokens += promptTokens;
+    bucket.completionTokens += completionTokens;
+    bucket.totalTokens += totalTokens;
+    bucket.cachedInputTokens += cachedInputTokens;
+    bucket.reasoningTokens += reasoningTokens;
+    runtime.metrics.llmUsageByPurpose[purposeKey] = bucket;
+    return runtime.metrics;
+}
+export function recordPayloadBudget(session, patch) {
+    const runtime = ensureRuntimeState(session);
+    ensureMetricsExtensions(runtime.metrics);
+    const payloadBudget = runtime.metrics.payloadBudget ?? createPayloadBudgetMetrics();
+    for (const [key, value] of Object.entries(patch)) {
+        if (!Number.isFinite(value)) {
+            continue;
+        }
+        payloadBudget[key] += value ?? 0;
+    }
+    runtime.metrics.payloadBudget = payloadBudget;
+    return runtime.metrics;
+}

package/dist/runtime-page-state.d.ts

@@ -0,0 +1,11 @@
+import type { BrowserSessionState } from './browser-session-state.js';
+import { type BrowsePageState } from './runtime-state.js';
+export declare function registerPage(session: BrowserSessionState, page?: Partial<Omit<BrowsePageState, 'pageRef' | 'createdAt' | 'updatedAt'>> & {
+    pageRef?: string;
+    makeCurrent?: boolean;
+}): BrowsePageState;
+export declare function updatePage(session: BrowserSessionState, pageRef: string, patch: Partial<Omit<BrowsePageState, 'pageRef' | 'createdAt' | 'updatedAt'>>): BrowsePageState;
+export declare function getPageScopeEpoch(session: BrowserSessionState, pageRef: string): number;
+export declare function bumpPageScopeEpoch(session: BrowserSessionState, pageRef: string): number;
+export declare function setCurrentPage(session: BrowserSessionState, pageRef: string): void;
+//# sourceMappingURL=runtime-page-state.d.ts.map

package/dist/runtime-page-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-page-state.d.ts","sourceRoot":"","sources":["../src/runtime-page-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE9E,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,GAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,GAAG;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CAClB,GACL,eAAe,CAsBjB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,GAC3E,eAAe,CAejB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAcxF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMlF"}

package/dist/runtime-page-state.js

@@ -0,0 +1,62 @@
+import { ensureRuntimeState } from './runtime-state.js';
+export function registerPage(session, page = {}) {
+    const runtime = ensureRuntimeState(session);
+    const pageRef = page.pageRef ?? `p${runtime.counters.nextPage++}`;
+    const now = new Date().toISOString();
+    const existing = runtime.pages[pageRef];
+    const nextPage = {
+        pageRef,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+        url: page.url ?? existing?.url,
+        title: page.title ?? existing?.title,
+        targetId: page.targetId ?? existing?.targetId,
+        openerPageRef: page.openerPageRef ?? existing?.openerPageRef,
+        scopeEpoch: existing?.scopeEpoch ?? 0,
+    };
+    runtime.pages[pageRef] = nextPage;
+    if (page.makeCurrent !== false) {
+        runtime.currentPageRef = pageRef;
+    }
+    return nextPage;
+}
+export function updatePage(session, pageRef, patch) {
+    const runtime = ensureRuntimeState(session);
+    const current = runtime.pages[pageRef];
+    if (!current) {
+        throw new Error(`unknown_page_ref: ${pageRef}`);
+    }
+    const nextPage = {
+        ...current,
+        ...patch,
+        scopeEpoch: patch.scopeEpoch ?? current.scopeEpoch ?? 0,
+        updatedAt: new Date().toISOString(),
+    };
+    runtime.pages[pageRef] = nextPage;
+    return nextPage;
+}
+export function getPageScopeEpoch(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    return runtime.pages[pageRef]?.scopeEpoch ?? 0;
+}
+export function bumpPageScopeEpoch(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    const current = runtime.pages[pageRef];
+    if (!current) {
+        throw new Error(`unknown_page_ref: ${pageRef}`);
+    }
+    const nextEpoch = (current.scopeEpoch ?? 0) + 1;
+    runtime.pages[pageRef] = {
+        ...current,
+        scopeEpoch: nextEpoch,
+        updatedAt: new Date().toISOString(),
+    };
+    return nextEpoch;
+}
+export function setCurrentPage(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    if (!runtime.pages[pageRef]) {
+        throw new Error(`unknown_page_ref: ${pageRef}`);
+    }
+    runtime.currentPageRef = pageRef;
+}

package/dist/runtime-protected-state.d.ts

@@ -0,0 +1,14 @@
+import type { BrowserSessionState } from './browser-session-state.js';
+import type { PersistedFillableForm } from './secrets/types.js';
+import { type ProtectedExposureState } from './runtime-state.js';
+export declare function saveFillableForms(session: BrowserSessionState, forms: ReadonlyArray<PersistedFillableForm>): PersistedFillableForm[];
+export declare function replaceFillableFormsForPage(session: BrowserSessionState, pageRef: string, forms: ReadonlyArray<Omit<PersistedFillableForm, 'fillRef'>>, options?: {
+    preserveExistingOnEmpty?: boolean;
+}): PersistedFillableForm[];
+export declare function markFillableFormsUnknownForPage(session: BrowserSessionState, pageRef: string): PersistedFillableForm[];
+export declare function markFillableFormsAbsentForPage(session: BrowserSessionState, pageRef: string): PersistedFillableForm[];
+export declare function getFillableForm(session: BrowserSessionState, fillRef: string): PersistedFillableForm | null;
+export declare function saveProtectedExposure(session: BrowserSessionState, exposure: ProtectedExposureState): ProtectedExposureState;
+export declare function getProtectedExposure(session: BrowserSessionState, pageRef: string): ProtectedExposureState | null;
+export declare function clearProtectedExposure(session: BrowserSessionState, pageRef?: string): void;
+//# sourceMappingURL=runtime-protected-state.d.ts.map

package/dist/runtime-protected-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-protected-state.d.ts","sourceRoot":"","sources":["../src/runtime-protected-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAyC5B,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAC1C,qBAAqB,EAAE,CAYzB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC,EAC5D,OAAO,GAAE;IACP,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC9B,GACL,qBAAqB,EAAE,CAgDzB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAuBzB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAmBzB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,qBAAqB,GAAG,IAAI,CAI9B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,sBAAsB,GAC/B,sBAAsB,CAKxB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,sBAAsB,GAAG,IAAI,CAG/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAS3F"}

package/dist/runtime-protected-state.js

@@ -0,0 +1,148 @@
+import { logicalProtectedBindingKey } from './secrets/protected-bindings.js';
+import { createFillRef, ensureRuntimeState, } from './runtime-state.js';
+function syncFillCounter(runtime, ref) {
+    const match = /^f(\d+)$/.exec(ref);
+    if (!match)
+        return;
+    const nextFill = Number(match[1]) + 1;
+    if (Number.isFinite(nextFill)) {
+        runtime.counters.nextFill = Math.max(runtime.counters.nextFill, nextFill);
+    }
+}
+function fillableFormIdentity(form) {
+    const fieldsKey = [...form.fields]
+        .map((field) => logicalProtectedBindingKey(field))
+        .sort()
+        .join('|');
+    return [form.pageRef, form.scopeRef ?? '', form.purpose, fieldsKey].join('||');
+}
+function normalizeFillableForm(runtime, form) {
+    const pageScopeEpoch = runtime.pages[form.pageRef]?.scopeEpoch ?? 0;
+    const scopeEpoch = form.scopeEpoch ?? pageScopeEpoch;
+    const presence = form.presence === 'absent'
+        ? 'absent'
+        : form.presence === 'unknown' || scopeEpoch < pageScopeEpoch
+            ? 'unknown'
+            : 'present';
+    return {
+        ...form,
+        scopeEpoch,
+        presence,
+    };
+}
+export function saveFillableForms(session, forms) {
+    const runtime = ensureRuntimeState(session);
+    for (const form of forms) {
+        const pageScopeEpoch = runtime.pages[form.pageRef]?.scopeEpoch ?? 0;
+        runtime.fillableForms[form.fillRef] = {
+            ...form,
+            presence: form.presence ?? 'present',
+            scopeEpoch: form.scopeEpoch ?? pageScopeEpoch,
+        };
+        syncFillCounter(runtime, form.fillRef);
+    }
+    return forms.map((form) => getFillableForm(session, form.fillRef));
+}
+export function replaceFillableFormsForPage(session, pageRef, forms, options = {}) {
+    const runtime = ensureRuntimeState(session);
+    const pageScopeEpoch = runtime.pages[pageRef]?.scopeEpoch ?? 0;
+    const existingEntries = Object.entries(runtime.fillableForms).filter(([, form]) => form.pageRef === pageRef);
+    const preserveExistingOnEmpty = options.preserveExistingOnEmpty !== false;
+    if (forms.length === 0 && preserveExistingOnEmpty) {
+        return existingEntries.map(([, form]) => form);
+    }
+    const reusableRefs = new Map();
+    for (const [fillRef, form] of existingEntries) {
+        if (form.presence === 'absent') {
+            continue;
+        }
+        const identity = fillableFormIdentity(form);
+        const refs = reusableRefs.get(identity) ?? [];
+        refs.push(fillRef);
+        reusableRefs.set(identity, refs);
+    }
+    const reusedRefs = new Set();
+    const nextForms = [];
+    for (const form of forms) {
+        const identity = fillableFormIdentity(form);
+        const matchedRef = (reusableRefs.get(identity) ?? []).find((ref) => !reusedRefs.has(ref));
+        const fillRef = matchedRef ?? createFillRef(session);
+        runtime.fillableForms[fillRef] = {
+            ...form,
+            fillRef,
+            presence: 'present',
+            scopeEpoch: pageScopeEpoch,
+        };
+        syncFillCounter(runtime, fillRef);
+        reusedRefs.add(fillRef);
+        nextForms.push(runtime.fillableForms[fillRef]);
+    }
+    for (const [fillRef, form] of existingEntries) {
+        if (!reusedRefs.has(fillRef) && form.presence !== 'absent') {
+            delete runtime.fillableForms[fillRef];
+        }
+    }
+    return nextForms;
+}
+export function markFillableFormsUnknownForPage(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    const pageScopeEpoch = runtime.pages[pageRef]?.scopeEpoch ?? 0;
+    const nextForms = [];
+    for (const [fillRef, form] of Object.entries(runtime.fillableForms)) {
+        if (form.pageRef !== pageRef) {
+            continue;
+        }
+        if (form.presence === 'absent') {
+            nextForms.push(runtime.fillableForms[fillRef]);
+            continue;
+        }
+        runtime.fillableForms[fillRef] = {
+            ...form,
+            presence: 'unknown',
+            scopeEpoch: pageScopeEpoch,
+        };
+        nextForms.push(runtime.fillableForms[fillRef]);
+    }
+    return nextForms;
+}
+export function markFillableFormsAbsentForPage(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    const pageScopeEpoch = runtime.pages[pageRef]?.scopeEpoch ?? 0;
+    const nextForms = [];
+    for (const [fillRef, form] of Object.entries(runtime.fillableForms)) {
+        if (form.pageRef !== pageRef) {
+            continue;
+        }
+        runtime.fillableForms[fillRef] = {
+            ...form,
+            presence: 'absent',
+            scopeEpoch: pageScopeEpoch,
+        };
+        nextForms.push(runtime.fillableForms[fillRef]);
+    }
+    return nextForms;
+}
+export function getFillableForm(session, fillRef) {
+    const runtime = ensureRuntimeState(session);
+    const form = runtime.fillableForms[fillRef];
+    return form ? normalizeFillableForm(runtime, form) : null;
+}
+export function saveProtectedExposure(session, exposure) {
+    const runtime = ensureRuntimeState(session);
+    const exposures = runtime.protectedExposureByPage ?? (runtime.protectedExposureByPage = {});
+    exposures[exposure.pageRef] = exposure;
+    return exposures[exposure.pageRef];
+}
+export function getProtectedExposure(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    return runtime.protectedExposureByPage?.[pageRef] ?? null;
+}
+export function clearProtectedExposure(session, pageRef) {
+    const runtime = ensureRuntimeState(session);
+    if (!pageRef) {
+        runtime.protectedExposureByPage = {};
+        return;
+    }
+    const exposures = runtime.protectedExposureByPage ?? (runtime.protectedExposureByPage = {});
+    delete exposures[pageRef];
+}

package/dist/runtime-resolution.d.ts

@@ -0,0 +1,9 @@
+export type RuntimeSource = 'dom' | 'stagehand';
+export type RuntimeResolution = {
+    source: RuntimeSource;
+    degraded: boolean;
+    degradationReason?: string;
+};
+export declare function domRuntimeResolution(): RuntimeResolution;
+export declare function stagehandRuntimeResolution(degradationReason?: string): RuntimeResolution;
+//# sourceMappingURL=runtime-resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-resolution.d.ts","sourceRoot":"","sources":["../src/runtime-resolution.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,WAAW,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD;AAED,wBAAgB,0BAA0B,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAaxF"}

package/dist/runtime-resolution.js

@@ -0,0 +1,19 @@
+export function domRuntimeResolution() {
+    return {
+        source: 'dom',
+        degraded: false,
+    };
+}
+export function stagehandRuntimeResolution(degradationReason) {
+    if (!degradationReason) {
+        return {
+            source: 'stagehand',
+            degraded: false,
+        };
+    }
+    return {
+        source: 'stagehand',
+        degraded: true,
+        degradationReason,
+    };
+}

package/dist/runtime-state.d.ts

@@ -0,0 +1,251 @@
+import type { BrowserSessionState } from "./browser-session-state.js";
+import type { PersistedFillableForm, SecretCatalogSnapshot } from "./secrets/types.js";
+export type LocatorStrategy = "role" | "label" | "placeholder" | "text" | "title" | "testId" | "css" | "xpath";
+export interface LocatorCandidate {
+    strategy: LocatorStrategy;
+    value: string;
+    name?: string;
+    attribute?: "data-testid" | "data-test-id";
+    scope?: "root" | "surface";
+}
+export declare function locatorCandidateKey(candidate: Pick<LocatorCandidate, "strategy" | "value" | "name" | "attribute" | "scope">): string;
+export interface TargetSemantics {
+    role?: string;
+    name?: string;
+    states?: Record<string, string | boolean | number>;
+    source?: "dom" | "stagehand" | "aria-snapshot" | "cdp-ax";
+}
+export type TargetCapability = "actionable" | "scope" | "informational";
+export type TargetLifecycle = "live" | "stale" | "invalidated";
+export type TargetAvailability = "available" | "gated" | "surface-inactive" | "hidden";
+export type TargetAllowedAction = "click" | "fill" | "type" | "select" | "press";
+export type TargetControlFamily = "text-input" | "select" | "datepicker" | "structured-grid" | "trigger";
+export type TargetAcceptancePolicy = "value-change" | "selection" | "toggle" | "disclosure" | "date-selection" | "submit" | "navigation" | "generic-click";
+export interface TargetAvailabilityState {
+    state: TargetAvailability;
+    reason?: string;
+}
+export interface TargetContextNode {
+    kind?: string;
+    label?: string;
+    text?: string;
+    selector?: string;
+}
+export interface TargetVisualContext {
+    emphasis?: "muted" | "normal" | "strong";
+    fill?: "none" | "light" | "mid" | "dark";
+    outlined?: boolean;
+}
+export interface TargetStructure {
+    family?: "structured-grid";
+    variant?: "date-cell" | "seat-cell" | "grid-cell";
+    row?: string;
+    column?: string;
+    zone?: string;
+    cellLabel?: string;
+}
+export interface TargetContext {
+    item?: TargetContextNode;
+    group?: TargetContextNode;
+    container?: TargetContextNode;
+    landmark?: TargetContextNode;
+    layout?: {
+        lane?: "left" | "center" | "right";
+        band?: "top" | "middle" | "bottom";
+    };
+    hintText?: string;
+    visual?: TargetVisualContext;
+}
+export interface TargetValidationEvidence {
+    invalid?: boolean;
+    required?: boolean;
+    message?: string;
+    errorStyling?: boolean;
+}
+export interface TargetDescriptor {
+    ref: string;
+    pageRef: string;
+    framePath?: string[];
+    frameUrl?: string;
+    kind?: string;
+    label?: string;
+    displayLabel?: string;
+    placeholder?: string;
+    inputName?: string;
+    inputType?: string;
+    autocomplete?: string;
+    ariaAutocomplete?: string;
+    surfaceKind?: string;
+    controlsSurfaceSelector?: string;
+    validation?: TargetValidationEvidence;
+    capability: TargetCapability;
+    lifecycle: TargetLifecycle;
+    availability: TargetAvailabilityState;
+    allowedActions: TargetAllowedAction[];
+    controlFamily?: TargetControlFamily;
+    acceptancePolicy?: TargetAcceptancePolicy;
+    surfaceRef?: string;
+    ownerRef?: string;
+    locatorCandidates: LocatorCandidate[];
+    semantics?: TargetSemantics;
+    structure?: TargetStructure;
+    context?: TargetContext;
+    stagehandAction?: unknown;
+    createdAt: number;
+    pageSignature?: string;
+    domSignature?: string;
+    lifecycleReason?: string;
+}
+type TargetDescriptorInput = Omit<TargetDescriptor, "ref" | "capability" | "lifecycle" | "availability" | "allowedActions"> & {
+    ref?: string;
+    capability?: TargetCapability;
+    lifecycle?: TargetLifecycle;
+    availability?: TargetAvailabilityState;
+    allowedActions?: TargetAllowedAction[];
+};
+export interface BrowsePageState {
+    pageRef: string;
+    createdAt: string;
+    updatedAt: string;
+    url?: string;
+    title?: string;
+    targetId?: string;
+    openerPageRef?: string;
+    scopeEpoch: number;
+}
+export type ExtractScopeLifetime = "durable" | "snapshot";
+export interface SurfaceDescriptor {
+    ref: string;
+    surfaceId: string;
+    pageRef: string;
+    framePath?: string[];
+    frameUrl?: string;
+    kind?: string;
+    label?: string;
+    parentSurfaceRef?: string;
+    childSurfaceRefs?: string[];
+    targetRefs?: string[];
+    lifecycle: TargetLifecycle;
+    availability: TargetAvailabilityState;
+    locatorCandidates: LocatorCandidate[];
+    createdAt: number;
+    pageSignature?: string;
+    lifecycleReason?: string;
+    extractScopeLifetime?: ExtractScopeLifetime;
+    scopeEpoch?: number;
+}
+type SurfaceDescriptorInput = Omit<SurfaceDescriptor, "ref" | "lifecycle" | "availability"> & {
+    ref?: string;
+    lifecycle?: TargetLifecycle;
+    availability?: TargetAvailabilityState;
+};
+export interface BrowseRuntimeMetrics {
+    stagehandCalls: number;
+    deterministicActions: number;
+    fallbackActions: number;
+    observeAxAttempts: number;
+    observeAxHits: number;
+    observeFallbackUses: number;
+    successfulActions: number;
+    failedActions: number;
+    totalActionDurationMs: number;
+    successRate: number;
+    averageActionDurationMs: number;
+    llmCalls?: number;
+    llmPromptTokens?: number;
+    llmCompletionTokens?: number;
+    llmTotalTokens?: number;
+    llmCachedInputTokens?: number;
+    llmReasoningTokens?: number;
+    llmUsageByPurpose?: Record<string, BrowseLlmUsageBucket>;
+    payloadBudget?: BrowsePayloadBudgetMetrics;
+}
+export interface BrowseLlmUsageBucket {
+    calls: number;
+    inputChars: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    cachedInputTokens: number;
+    reasoningTokens: number;
+}
+export interface BrowsePayloadBudgetMetrics {
+    observeRerankCandidatesSeen: number;
+    observeRerankCandidatesSent: number;
+    extractSnapshotLinesSeen: number;
+    extractSnapshotLinesSent: number;
+    protectedBindingsSeen: number;
+    protectedBindingsSent: number;
+}
+export type ProtectedExactValueMatcher = "text" | "digits" | "email" | "expiry";
+export interface ProtectedExactValueRule {
+    matcher: ProtectedExactValueMatcher;
+    digest: string;
+    normalizedLength: number;
+}
+export interface ProtectedExactValueProfile {
+    version: 1;
+    rules: ProtectedExactValueRule[];
+}
+export interface ProtectedExposureState {
+    pageRef: string;
+    scopeRef?: string;
+    fillRef: string;
+    requestId: string;
+    activatedAt: string;
+    exactValueProfile?: ProtectedExactValueProfile;
+    reason: "protected_fill_success" | "protected_fill_binding_stale" | "protected_fill_validation_failed" | "protected_fill_unexpected_error";
+}
+export interface BrowseRuntimeState {
+    version: 1;
+    currentPageRef: string;
+    pages: Record<string, BrowsePageState>;
+    surfaces: Record<string, SurfaceDescriptor>;
+    targets: Record<string, TargetDescriptor>;
+    secretCatalogByHost: Record<string, SecretCatalogSnapshot>;
+    fillableForms: Record<string, PersistedFillableForm>;
+    protectedExposureByPage?: Record<string, ProtectedExposureState>;
+    counters: {
+        nextPage: number;
+        nextSurface: number;
+        nextTarget: number;
+        nextFill: number;
+    };
+    metrics: BrowseRuntimeMetrics;
+}
+export declare function createPayloadBudgetMetrics(): BrowsePayloadBudgetMetrics;
+export declare function createLlmUsageBucket(): BrowseLlmUsageBucket;
+export declare function ensureMetricsExtensions(metrics: BrowseRuntimeMetrics): void;
+export declare function createRuntimeState(initialPage?: Partial<Omit<BrowsePageState, "pageRef" | "createdAt" | "updatedAt">> & {
+    pageRef?: string;
+}): BrowseRuntimeState;
+export declare function ensureRuntimeState(session: BrowserSessionState): BrowseRuntimeState;
+export declare function createTargetRef(session: BrowserSessionState): string;
+export declare function createFillRef(session: BrowserSessionState): string;
+export declare function createSurfaceRef(session: BrowserSessionState): string;
+export declare function saveSurfaces(session: BrowserSessionState, descriptors: ReadonlyArray<SurfaceDescriptorInput>): SurfaceDescriptor[];
+export declare function replaceSurfacesForPage(session: BrowserSessionState, pageRef: string, descriptors: ReadonlyArray<SurfaceDescriptorInput>, options?: {
+    preserveExistingOnEmpty?: boolean;
+    preserveExisting?: boolean;
+}): SurfaceDescriptor[];
+export declare function saveTargets(session: BrowserSessionState, descriptors: ReadonlyArray<TargetDescriptorInput>): TargetDescriptor[];
+export declare function replaceTargetsForPage(session: BrowserSessionState, pageRef: string, descriptors: ReadonlyArray<TargetDescriptorInput>, options?: {
+    preserveExistingOnEmpty?: boolean;
+    preserveExisting?: boolean;
+}): TargetDescriptor[];
+export declare function getTarget(session: BrowserSessionState, targetRef: string): TargetDescriptor | null;
+export declare function getSurface(session: BrowserSessionState, surfaceRef: string): SurfaceDescriptor | null;
+export declare function saveSecretCatalog(session: BrowserSessionState, snapshot: SecretCatalogSnapshot): SecretCatalogSnapshot;
+export declare function getSecretCatalog(session: BrowserSessionState, host: string): SecretCatalogSnapshot | null;
+export declare function updateSurface(session: BrowserSessionState, surfaceRef: string, patch: Partial<Omit<SurfaceDescriptor, "ref" | "createdAt">>): SurfaceDescriptor | null;
+export declare function markSurfaceLifecycle(session: BrowserSessionState, surfaceRef: string, lifecycle: TargetLifecycle, reason?: string): SurfaceDescriptor | null;
+export declare function setSurfaceAvailability(session: BrowserSessionState, surfaceRef: string, state: TargetAvailability, reason?: string): SurfaceDescriptor | null;
+export declare function deleteTarget(session: BrowserSessionState, targetRef: string): void;
+export declare function updateTarget(session: BrowserSessionState, targetRef: string, patch: Partial<Omit<TargetDescriptor, "ref" | "createdAt">>): TargetDescriptor | null;
+export declare function markTargetLifecycle(session: BrowserSessionState, targetRef: string, lifecycle: TargetLifecycle, reason?: string): TargetDescriptor | null;
+export declare function setTargetAvailability(session: BrowserSessionState, targetRef: string, state: TargetAvailability, reason?: string): TargetDescriptor | null;
+export declare function listTargets(session: BrowserSessionState): TargetDescriptor[];
+export declare function listSurfaces(session: BrowserSessionState): SurfaceDescriptor[];
+export declare function clearTargets(session: BrowserSessionState, pageRef?: string): void;
+export {};
+//# sourceMappingURL=runtime-state.d.ts.map