@0xmaxma/claude-gateway 2.0.9 → 2.0.11

package/dist/automation/browser-steps.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBrowserStepsWith = runBrowserStepsWith;
+const zod_1 = require("zod");
+const node_crypto_1 = require("node:crypto");
+const command_steps_1 = require("./command-steps");
+/**
+ * Remote Browser step mode: an explicit user step list runs step after step on
+ * one tab lease without returning to the parent agent between steps. Each part
+ * is one direct command of the single-command runner, so its fast paths,
+ * confidence gate, write-ahead receipt and never-replay rules are unchanged.
+ * This file adds sequencing, per-step effect verification and the same caps
+ * as Computer Use step mode. The user's own list is their authorization.
+ */
+const STEP_RETRY_MAX = 2;
+const LOADING_DELAY_MS = 800;
+const SETTLE_OBSERVATIONS = 4;
+const SETTLE_DELAY_MS = 400;
+const SCROLL_NO_EFFECT_MAX = 3;
+// Settling a newly loaded document: at most ~2.4 s of reads before moving on.
+const STABLE_OBSERVATIONS = 8;
+const STABLE_DELAY_MS = 300;
+// The previous step's page may still be loading (results absent right after Enter).
+const PART_ACTIONS = 3, PART_EVALUATIONS = 6;
+const LOADING_REASONS = new Set(['NO_SUPPORTED_ACTION', 'LOW_TARGET_CONFIDENCE', 'LOW_OPERATION_CONFIDENCE', 'PAGE_CONTENT_UNAVAILABLE']);
+// Steps whose effect may legitimately be invisible in a structured observation.
+const TOLERANT_KINDS = new Set(['scroll', 'key']);
+const StepsInput = zod_1.z.object({
+    contractVersion: zod_1.z.literal(1).default(1),
+    steps: zod_1.z.array(zod_1.z.string().min(1).max(command_steps_1.STEP_TEXT_MAX)).min(2).max(command_steps_1.COMMAND_STEPS_MAX),
+    scope: zod_1.z.object({ device_id: zod_1.z.string().min(1).max(120), grant_id: zod_1.z.string().min(1).max(120), tab_id: zod_1.z.string().min(1).max(120) }).strict(),
+    interactionContext: zod_1.z.string().max(8000).optional(),
+    /** Opened before the first step, as in a single-command run. */
+    startUrl: zod_1.z.string().max(8192).optional(),
+    fields: zod_1.z.array(zod_1.z.object({ label: zod_1.z.string().min(1).max(250), text: zod_1.z.string().max(2000) }).strict()).max(60).default([]),
+    timeoutMs: zod_1.z.number().int().min(1000).max(600000).default(command_steps_1.COMMAND_STEPS_TIMEOUT_MS),
+    /** Whole-run budgets from the binding; each step part still gets at most 3 actions / 6 decisions. */
+    maxSteps: zod_1.z.number().int().min(1).max(100).optional(), maxEvaluations: zod_1.z.number().int().min(1).max(150).optional(), maxTextCalls: zod_1.z.number().int().min(0).max(60).optional(),
+    maxStaleRetries: zod_1.z.number().int().min(0).max(10).optional(), operationConfidence: zod_1.z.number().min(0).max(1).optional(), targetConfidence: zod_1.z.number().min(0).max(1).optional(),
+}).strict();
+const fingerprint = (p) => p && JSON.stringify([p.url, p.title, p.text, p.elements.map(({ ref: _, ...e }) => e), p.scroll, p.navigation]);
+const delay = (ms, signal) => new Promise((resolve, reject) => {
+    const stop = () => { clearTimeout(timer); reject(Error('TASK_CANCELLED')); };
+    const timer = setTimeout(() => { signal.removeEventListener('abort', stop); resolve(); }, ms);
+    signal.addEventListener('abort', stop, { once: true });
+    if (signal.aborted)
+        stop();
+});
+async function runBrowserStepsWith(runOne, parse, raw, deps, signal) {
+    const input = StepsInput.parse(raw);
+    const timeoutMs = Math.min(input.timeoutMs, command_steps_1.COMMAND_STEPS_TIMEOUT_MS);
+    const deadline = Date.now() + timeoutMs;
+    const runSignal = AbortSignal.any([signal, AbortSignal.timeout(timeoutMs)]);
+    const events = [];
+    let sequence = 0, actions = 0, evaluations = 0, completed = 0, scrollNoEffect = 0;
+    let lease, prefetched, before, last;
+    // The run's last dispatched and confirmed actions, across parts: a later part
+    // that dispatched nothing must not hide them from the host's receipt check.
+    let lastAction, lastConfirmedAction;
+    const unverified = [], notes = [];
+    let doneParts = [];
+    // One lease for the whole run: the per-part runner sees an idempotent
+    // acquire and a deferred release. Mutations still pass the host fence.
+    const inner = {
+        ...deps,
+        call: async (name, args, callSignal) => {
+            if (name === 'browser_task_acquire' && lease)
+                return { state: 'completed', result: { protocol_version: 1, lease_token: lease } };
+            if (name === 'browser_task_release')
+                return { state: 'completed', result: {} };
+            if (name === 'page_observe' && prefetched) {
+                const page = prefetched;
+                prefetched = undefined;
+                before ?? (before = page);
+                return structuredClone(page);
+            }
+            const value = await deps.call(name, args, callSignal);
+            if (name === 'browser_task_acquire') {
+                const parsed = zod_1.z.object({ state: zod_1.z.literal('completed'), result: zod_1.z.object({ lease_token: zod_1.z.string() }).passthrough() }).safeParse(value);
+                if (parsed.success)
+                    lease = parsed.data.result.lease_token;
+            }
+            if (name === 'page_observe') {
+                const parsed = safeParse(parse, value);
+                if (parsed)
+                    before ?? (before = parsed);
+            }
+            return value;
+        },
+        trace: event => {
+            const entry = { ...event, sequence: ++sequence };
+            if (events.length < 1024)
+                events.push(entry);
+            try {
+                deps.trace?.(structuredClone(entry));
+            }
+            catch { /* Diagnostic sinks cannot change an outcome. */ }
+        },
+        progress: event => deps.progress?.({ ...event, steps: actions + event.steps, evaluations: evaluations + event.evaluations }),
+    };
+    const observe = async () => {
+        try {
+            const value = await deps.call('page_observe', { ...input.scope, lease_token: lease, detail: 'full' }, runSignal);
+            if (value?.error)
+                return undefined;
+            return safeParse(parse, value);
+        }
+        catch {
+            runSignal.throwIfAborted();
+            return undefined;
+        }
+    };
+    const stop = (index, stopReason, detail, remainingFrom = index) => ({
+        total: input.steps.length, completed, stopReason, stoppedAt: index + 1, stoppedStep: input.steps[index], ...(detail ? { detail } : {}),
+        remaining: input.steps.slice(remainingFrom), ...(unverified.length ? { unverifiedSteps: [...unverified] } : {}),
+        ...(doneParts.length ? { doneParts: [...doneParts] } : {}), ...(notes.length ? { notes: [...notes] } : {}),
+    });
+    const finish = (status, reason, stepRun) => ({
+        contractVersion: 1, status, reason, steps: actions, evaluations, staleRetries: 0, textCalls: 0, stepRun,
+        trace: { version: 1, events: [...events], truncated: sequence > events.length, sinkFailed: false },
+        ...(lastAction ? { lastAction } : {}), ...(lastConfirmedAction ? { lastConfirmedAction } : {}),
+        ...(last?.lastEvaluation ? { lastEvaluation: last.lastEvaluation } : {}), ...(last?.fieldRequest ? { fieldRequest: last.fieldRequest } : {}),
+        ...(last?.observation ? { observation: last.observation } : {}),
+    });
+    const waiting = (stepRun) => finish('needs_verification', 'COMMAND_WAITING_INPUT', stepRun);
+    const timedOut = () => runSignal.aborted && !signal.aborted && !deps.interruptSignal?.aborted;
+    let index = 0;
+    try {
+        for (; index < input.steps.length; index++) {
+            const step = input.steps[index];
+            const parts = (0, command_steps_1.stepParts)(step);
+            let stepChanged = true, lastKind;
+            doneParts = [];
+            for (const part of parts) {
+                let result;
+                for (let attempt = 0; attempt <= STEP_RETRY_MAX; attempt++) {
+                    runSignal.throwIfAborted();
+                    const actionsLeft = Math.min(PART_ACTIONS, (input.maxSteps ?? Infinity) - actions), evaluationsLeft = Math.min(PART_EVALUATIONS, (input.maxEvaluations ?? Infinity) - evaluations);
+                    if (actionsLeft < 1 || evaluationsLeft < 1)
+                        return waiting(stop(index, 'STEP_NOT_EXECUTED', actionsLeft < 1 ? 'ACTION_BUDGET' : 'EVALUATION_BUDGET'));
+                    before = undefined;
+                    const context = [input.interactionContext, index ? 'Completed steps in this run: ' + input.steps.slice(0, index).map((s, i) => `${i + 1}) ${s}`).join('; ') : ''].filter(Boolean).join('\n').slice(-8000);
+                    result = await runOne({ contractVersion: 1, goal: part, scope: input.scope, command: true, yieldAfterAction: true, stepPart: true,
+                        fields: input.fields, maxSteps: actionsLeft, maxEvaluations: evaluationsLeft, timeoutMs: Math.max(1000, deadline - Date.now()),
+                        ...(input.maxTextCalls !== undefined ? { maxTextCalls: input.maxTextCalls } : {}), ...(input.maxStaleRetries !== undefined ? { maxStaleRetries: input.maxStaleRetries } : {}),
+                        ...(input.operationConfidence !== undefined ? { operationConfidence: input.operationConfidence } : {}), ...(input.targetConfidence !== undefined ? { targetConfidence: input.targetConfidence } : {}),
+                        ...(input.startUrl && index === 0 && part === parts[0] && attempt === 0 ? { startUrl: input.startUrl } : {}),
+                        ...(context ? { interactionContext: context } : {}) }, inner, runSignal);
+                    last = result;
+                    actions += result.steps;
+                    evaluations += result.evaluations;
+                    lastAction = result.lastAction ?? lastAction;
+                    lastConfirmedAction = result.lastConfirmedAction ?? lastConfirmedAction;
+                    const reason = result.commandOutcome?.done === false ? result.commandOutcome.reason : undefined;
+                    // Only a part that dispatched nothing is retried, on a fresh observation.
+                    const retryable = !result.steps && reason !== undefined && LOADING_REASONS.has(reason) && (index > 0 || part !== parts[0]);
+                    if (!retryable || attempt === STEP_RETRY_MAX)
+                        break;
+                    prefetched = undefined;
+                    await delay(LOADING_DELAY_MS, runSignal);
+                }
+                if (!result)
+                    break;
+                if (result.lastAction?.outcome === 'unknown' || result.reason === 'OUTCOME_UNKNOWN')
+                    return finish('blocked', 'OUTCOME_UNKNOWN', stop(index, 'OUTCOME_UNKNOWN'));
+                if (result.status === 'cancelled' || timedOut())
+                    return timedOut() ? finish('blocked', 'TASK_DEADLINE', stop(index, 'TIMEOUT')) : finish('cancelled', result.reason, stop(index, 'CANCELLED'));
+                const outcome = result.commandOutcome;
+                if (!outcome) {
+                    // Field requests keep their own lifecycle; anything else returns control.
+                    if (result.status === 'blocked' && result.reason === 'FIELD_TEXT_REQUIRED')
+                        return finish('blocked', 'FIELD_TEXT_REQUIRED', stop(index, 'STEP_NOT_EXECUTED', result.reason));
+                    if (result.status === 'failed' || result.status === 'blocked')
+                        return finish(result.status, result.reason, stop(index, 'FAILED', result.reason));
+                    return waiting(stop(index, 'STEP_NOT_EXECUTED', result.reason));
+                }
+                if (outcome.action?.kind === 'new_tab') {
+                    // Scope stays on the approved tab; the following steps run there.
+                    notes.push(`Step ${index + 1}: stayed in the approved tab (no new tab is opened).`);
+                    lastKind = 'new_tab';
+                    doneParts.push(part);
+                    continue;
+                }
+                if (!outcome.done && outcome.reason === 'SCROLL_LIMIT') {
+                    stepChanged = false;
+                    lastKind = 'scroll';
+                    doneParts.push(part);
+                    continue;
+                }
+                if (!outcome.done)
+                    return waiting(stop(index, 'STEP_NOT_EXECUTED', outcome.reason));
+                // Verify the observable effect before the next part decides; a
+                // navigation may still be committing, so poll a few fresh reads.
+                let after = result.observation;
+                let changed = fingerprint(before) !== fingerprint(after);
+                for (let poll = 0; poll < SETTLE_OBSERVATIONS && !changed; poll++) {
+                    await delay(SETTLE_DELAY_MS, runSignal);
+                    const fresh = await observe();
+                    if (fresh) {
+                        after = fresh;
+                        changed = fingerprint(before) !== fingerprint(fresh);
+                    }
+                }
+                // Opening the address the tab already shows leaves the page unchanged,
+                // yet the requested state holds (E2E: start_url was already google.com).
+                if (!changed && outcome.action?.kind === 'navigate' && sameAddress(after?.url, outcome.action.url))
+                    changed = true;
+                // A new document (search results, a followed link) keeps rendering after
+                // it commits; deciding on it too early meets FORM_STATE_CHANGED rejections
+                // (E2E: three stale clicks on Google results). Wait, bounded, until two
+                // consecutive reads match before the next part decides.
+                if (changed && after && before && after.url !== before.url) {
+                    for (let poll = 0; poll < STABLE_OBSERVATIONS; poll++) {
+                        await delay(STABLE_DELAY_MS, runSignal);
+                        const fresh = await observe();
+                        if (!fresh)
+                            continue;
+                        const stable = fingerprint(fresh) === fingerprint(after);
+                        after = fresh;
+                        if (stable)
+                            break;
+                    }
+                }
+                prefetched = after;
+                lastKind = outcome.action?.kind;
+                if (!changed && (!TOLERANT_KINDS.has(lastKind ?? '') || parts.length > 1)) {
+                    prefetched = undefined;
+                    return waiting(stop(index, 'STEP_NO_EFFECT', 'dispatched without an observable change', index + 1));
+                }
+                stepChanged = changed;
+                doneParts.push(part);
+            }
+            doneParts = [];
+            if (lastKind === 'new_tab' && parts.length === 1) {
+                completed++;
+                continue;
+            }
+            scrollNoEffect = stepChanged ? 0 : scrollNoEffect + 1;
+            if (!stepChanged && scrollNoEffect >= SCROLL_NO_EFFECT_MAX)
+                return waiting(stop(index, 'STEP_NO_EFFECT', 'dispatched without an observable change', index + 1));
+            if (!stepChanged)
+                unverified.push(index + 1);
+            completed++;
+        }
+        return waiting({ total: input.steps.length, completed, stopReason: 'ALL_STEPS_DONE', remaining: [],
+            ...(unverified.length ? { unverifiedSteps: [...unverified] } : {}), ...(notes.length ? { notes: [...notes] } : {}) });
+    }
+    catch (error) {
+        const safeIndex = Math.min(index, input.steps.length - 1);
+        if (lastAction?.outcome === 'unknown')
+            return finish('blocked', 'OUTCOME_UNKNOWN', stop(safeIndex, 'OUTCOME_UNKNOWN'));
+        if (signal.aborted || deps.interruptSignal?.aborted)
+            return finish('cancelled', deps.interruptSignal?.aborted ? 'REVISION_SUPERSEDED' : 'TASK_CANCELLED', stop(safeIndex, 'CANCELLED'));
+        if (timedOut())
+            return finish('blocked', 'TASK_DEADLINE', stop(safeIndex, 'TIMEOUT'));
+        const code = error instanceof Error && /^[A-Z][A-Z_0-9]{2,79}$/.test(error.message) ? error.message : 'ADAPTER_FAILURE';
+        return finish('failed', code, stop(safeIndex, 'FAILED', code));
+    }
+    finally {
+        if (lease) {
+            // Release the shared lease once; retry so it is not left held.
+            for (let attempt = 0; attempt < 2; attempt++) {
+                try {
+                    await deps.call('browser_task_release', { ...input.scope, lease_token: lease, operation_id: (0, node_crypto_1.randomUUID)() }, AbortSignal.timeout(3000));
+                    break;
+                }
+                catch { /* Lease expiry (60 s) bounds a failed release. */ }
+            }
+        }
+    }
+}
+/** Same page address, ignoring scheme, a leading www., a trailing slash and the fragment. */
+function sameAddress(current, requested) {
+    const key = (value) => {
+        const u = new URL(value);
+        return u.hostname.replace(/^www\./u, '') + u.pathname.replace(/\/+$/u, '') + u.search;
+    };
+    try {
+        return Boolean(current && requested) && key(current) === key(requested);
+    }
+    catch {
+        return false;
+    }
+}
+function safeParse(parse, value) {
+    try {
+        return parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=browser-steps.js.map

package/dist/automation/browser-steps.js.map

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

package/dist/automation/browser-trace.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+/** Safe structural events. Rich target labels and typed values remain ephemeral. */
+export declare const TraceEvent: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    at: z.ZodNumber;
+    phase: z.ZodEnum<{
+        action: "action";
+        decision: "decision";
+        dispatch: "dispatch";
+        effect: "effect";
+        field: "field";
+        recovery: "recovery";
+        terminal: "terminal";
+    }>;
+    requestId: z.ZodOptional<z.ZodString>;
+    operationId: z.ZodOptional<z.ZodString>;
+    operation: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    elapsedMs: z.ZodOptional<z.ZodNumber>;
+    outcome: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        confirmed: "confirmed";
+        not_executed: "not_executed";
+    }>>;
+    targetRef: z.ZodOptional<z.ZodString>;
+    cause: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        blocked: "blocked";
+        succeeded: "succeeded";
+        cancelled: "cancelled";
+        failed: "failed";
+        needs_verification: "needs_verification";
+    }>>;
+    steps: z.ZodOptional<z.ZodNumber>;
+    evaluations: z.ZodOptional<z.ZodNumber>;
+    staleRetries: z.ZodOptional<z.ZodNumber>;
+    consecutiveStale: z.ZodOptional<z.ZodNumber>;
+    effect: z.ZodOptional<z.ZodEnum<{
+        "value-changed": "value-changed";
+        "selection-changed": "selection-changed";
+        "expanded-changed": "expanded-changed";
+    }>>;
+    pageChanged: z.ZodOptional<z.ZodBoolean>;
+    valueMatched: z.ZodOptional<z.ZodBoolean>;
+    optionCount: z.ZodOptional<z.ZodNumber>;
+    recoveryCalls: z.ZodOptional<z.ZodNumber>;
+    fieldsUpdated: z.ZodOptional<z.ZodNumber>;
+    effectObserved: z.ZodOptional<z.ZodBoolean>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type BrowserTraceEvent = z.infer<typeof TraceEvent>;
+export type BrowserTrace = {
+    version: 1;
+    events: BrowserTraceEvent[];
+    truncated: boolean;
+    sinkFailed: boolean;
+};
+//# sourceMappingURL=browser-trace.d.ts.map

package/dist/automation/browser-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-trace.d.ts","sourceRoot":"","sources":["../../src/automation/browser-trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,oFAAoF;AACpF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiBZ,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAC,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACzD,MAAM,MAAM,YAAY,GAAC;IAAC,OAAO,EAAC,CAAC,CAAC;IAAA,MAAM,EAAC,iBAAiB,EAAE,CAAC;IAAA,SAAS,EAAC,OAAO,CAAC;IAAA,UAAU,EAAC,OAAO,CAAA;CAAC,CAAC"}

package/dist/automation/browser-trace.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceEvent = void 0;
+const zod_1 = require("zod");
+/** Safe structural events. Rich target labels and typed values remain ephemeral. */
+exports.TraceEvent = zod_1.z.object({
+    version: zod_1.z.literal(1), sequence: zod_1.z.number().int().positive(), at: zod_1.z.number().int().nonnegative(),
+    phase: zod_1.z.enum(['decision', 'dispatch', 'action', 'effect', 'field', 'recovery', 'terminal']),
+    requestId: zod_1.z.string().uuid().optional(), operationId: zod_1.z.string().uuid().optional(),
+    operation: zod_1.z.string().regex(/^[A-Z_]{1,32}$/).optional(),
+    model: zod_1.z.string().max(200).optional(), elapsedMs: zod_1.z.number().nonnegative().optional(),
+    outcome: zod_1.z.enum(['confirmed', 'unknown', 'not_executed']).optional(),
+    targetRef: zod_1.z.string().max(100).optional(),
+    cause: zod_1.z.string().regex(/^[A-Z][A-Z_0-9]{2,80}$/).optional(),
+    reason: zod_1.z.string().regex(/^[A-Z][A-Z_0-9]{2,80}$/).optional(),
+    status: zod_1.z.enum(['succeeded', 'blocked', 'cancelled', 'failed', 'needs_verification']).optional(),
+    steps: zod_1.z.number().int().nonnegative().optional(), evaluations: zod_1.z.number().int().nonnegative().optional(),
+    staleRetries: zod_1.z.number().int().nonnegative().optional(), consecutiveStale: zod_1.z.number().int().nonnegative().optional(),
+    effect: zod_1.z.enum(['value-changed', 'selection-changed', 'expanded-changed']).optional(),
+    pageChanged: zod_1.z.boolean().optional(), valueMatched: zod_1.z.boolean().optional(), optionCount: zod_1.z.number().int().nonnegative().optional(),
+    recoveryCalls: zod_1.z.number().int().nonnegative().optional(), fieldsUpdated: zod_1.z.number().int().nonnegative().optional(),
+    effectObserved: zod_1.z.boolean().optional(), verified: zod_1.z.boolean().optional(),
+}).strict();
+//# sourceMappingURL=browser-trace.js.map

package/dist/automation/browser-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-trace.js","sourceRoot":"","sources":["../../src/automation/browser-trace.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AACtB,oFAAoF;AACvE,QAAA,UAAU,GAAC,OAAC,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAC,OAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,QAAQ,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAC,EAAE,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3F,KAAK,EAAC,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAC,UAAU,EAAC,QAAQ,EAAC,QAAQ,EAAC,OAAO,EAAC,UAAU,EAAC,UAAU,CAAC,CAAC;IACrF,SAAS,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAC,WAAW,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC/E,SAAS,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IACvD,KAAK,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAC,SAAS,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAClF,OAAO,EAAC,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAC,SAAS,EAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjE,SAAS,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IAC3D,MAAM,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IAC5D,MAAM,EAAC,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAC,SAAS,EAAC,WAAW,EAAC,QAAQ,EAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3F,KAAK,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAC,WAAW,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrG,YAAY,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAC,gBAAgB,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjH,MAAM,EAAC,OAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAC,mBAAmB,EAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClF,WAAW,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAC,YAAY,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAC,WAAW,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC5H,aAAa,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAC,aAAa,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/G,cAAc,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAC,QAAQ,EAAC,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACtE,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/automation/browser-use.d.ts

@@ -0,0 +1,210 @@
+import { BrowserTraceEvent, BrowserTrace } from "./browser-trace";
+import { z } from "zod";
+import { type BrowserStepsInput } from "./browser-steps";
+import { type BrowserCommandOutcome } from "./browser-command";
+export declare const BROWSER_USE_CONTRACT_VERSION: 1;
+/** Optional inputs this runner accepts within contract v1; hosts pass them only when advertised. */
+export declare const BROWSER_USE_FEATURES: readonly ["direct_command", "steps"];
+export declare class BrowserUseInputError extends Error {
+    readonly code = "INVALID_INPUT";
+    constructor();
+}
+export declare const BrowserObservation: z.ZodObject<{
+    protocol_version: z.ZodLiteral<1>;
+    generation: z.ZodString;
+    url: z.ZodString;
+    title: z.ZodString;
+    text: z.ZodString;
+    viewport_text: z.ZodOptional<z.ZodString>;
+    elements: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        label: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        value_now: z.ZodOptional<z.ZodString>;
+        value_text: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>>;
+        tag: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        value_truncated: z.ZodOptional<z.ZodBoolean>;
+        checked: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        selected: z.ZodOptional<z.ZodString>;
+        expanded: z.ZodOptional<z.ZodString>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        readonly: z.ZodOptional<z.ZodBoolean>;
+        sensitive: z.ZodOptional<z.ZodBoolean>;
+        operations: z.ZodArray<z.ZodEnum<{
+            TYPE_TEXT: "TYPE_TEXT";
+            CLICK: "CLICK";
+            SELECT: "SELECT";
+        }>>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            label: z.ZodString;
+            disabled: z.ZodBoolean;
+            selected: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        options_truncated: z.ZodOptional<z.ZodBoolean>;
+        in_viewport: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    scroll: z.ZodObject<{
+        y: z.ZodOptional<z.ZodNumber>;
+        up: z.ZodBoolean;
+        down: z.ZodBoolean;
+    }, z.core.$strip>;
+    truncated: z.ZodObject<{
+        text: z.ZodBoolean;
+        elements: z.ZodBoolean;
+        viewport_elements: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodBoolean>;
+        url: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    navigation: z.ZodOptional<z.ZodObject<{
+        can_go_back: z.ZodBoolean;
+        can_go_forward: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Observation = z.infer<typeof BrowserObservation>;
+export type ChoiceQuestion = {
+    type: "choice";
+    instructions: string;
+    criteria: Record<string, string>;
+};
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type EvaluationRequest = {
+    requestId: string;
+    state: {
+        [key: string]: JsonValue;
+    };
+    questions: Record<string, ChoiceQuestion>;
+};
+export type EvaluationResponse = {
+    model: string;
+    answers: Record<string, unknown>;
+};
+export type BrowserScope = {
+    device_id: string;
+    grant_id: string;
+    tab_id: string;
+};
+export type BrowserToolCall = (name: string, args: Record<string, unknown>, signal: AbortSignal) => Promise<unknown>;
+export type FieldTextRequest = {
+    goal: string;
+    field: Observation["elements"][number];
+    page: {
+        url: string;
+        title: string;
+        text: string;
+    };
+    recent_actions?: unknown[];
+};
+export type BrowserUseDependencies = {
+    /** Private host sink; events contain no page text, labels or field values. */
+    trace?: (event: BrowserTraceEvent) => void;
+    interruptSignal?: AbortSignal;
+    call: BrowserToolCall;
+    evaluate: (request: EvaluationRequest, signal: AbortSignal) => Promise<EvaluationResponse>;
+    /** Host-owned Thinking implementation; no provider credentials live in this adapter. */
+    resolveFieldText?: (request: FieldTextRequest, signal: AbortSignal) => Promise<{
+        text: string | null;
+    }>;
+    /** Trusted code, independent of the chooser. No verifier means needs_verification. */
+    verify?: (observation: Observation, signal: AbortSignal) => Promise<boolean>;
+    progress?: (event: BrowserUseProgress) => void | Promise<void>;
+};
+export type BrowserUseProgress = {
+    contractVersion: 1;
+    phase: "evaluating" | "decided" | "acting" | "acted";
+    steps: number;
+    evaluations: number;
+    requestId?: string;
+    operationId?: string;
+    model?: string;
+    decision_ms?: number;
+    operation_confidence?: number;
+    target_confidence?: number;
+};
+declare const Input: z.ZodObject<{
+    contractVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    goal: z.ZodString;
+    startUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodObject<{
+        device_id: z.ZodString;
+        grant_id: z.ZodString;
+        tab_id: z.ZodString;
+    }, z.core.$strict>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>>;
+    maxStaleRetries: z.ZodDefault<z.ZodNumber>;
+    maxTextCalls: z.ZodDefault<z.ZodNumber>;
+    yieldAfterAction: z.ZodDefault<z.ZodBoolean>;
+    command: z.ZodDefault<z.ZodBoolean>;
+    interactionContext: z.ZodOptional<z.ZodString>;
+    stepPart: z.ZodDefault<z.ZodBoolean>;
+    agentCommand: z.ZodDefault<z.ZodBoolean>;
+    sessionStart: z.ZodDefault<z.ZodBoolean>;
+    confirmation: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    maxSteps: z.ZodDefault<z.ZodNumber>;
+    maxEvaluations: z.ZodDefault<z.ZodNumber>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    operationConfidence: z.ZodDefault<z.ZodNumber>;
+    targetConfidence: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type BrowserUseInput = z.input<typeof Input>;
+export type BrowserUseResult = {
+    contractVersion: 1;
+    trace?: BrowserTrace;
+    lastEvaluation?: {
+        requestId: string;
+        model?: string;
+    };
+    lastConfirmedAction?: {
+        operationId: string;
+        operation: string;
+        outcome: "confirmed";
+    };
+    fieldRequest?: {
+        ref: string;
+        label: string;
+        reason: "missing" | "ambiguous";
+    };
+    status: "succeeded" | "blocked" | "cancelled" | "failed" | "needs_verification";
+    reason: string;
+    steps: number;
+    evaluations: number;
+    staleRetries: number;
+    textCalls: number;
+    lastAction?: {
+        operationId: string;
+        operation: string;
+        outcome: "confirmed" | "unknown" | "not_executed";
+    };
+    observation?: Observation;
+    commandOutcome?: BrowserCommandOutcome;
+};
+export declare const STALE_RETRY_DELAY_MS = 1000;
+export declare function decisionQuestions(page: Observation, goal?: string, exhaustedTextFields?: Set<string>, command?: boolean, readRequest?: boolean, navigate?: boolean, agentCommand?: boolean): {
+    questions: Record<string, ChoiceQuestion>;
+    targets: Map<string, {
+        element: Observation["elements"][number];
+        option?: string;
+    }>;
+};
+/** Run inside the gateway-owned task lifecycle; this function creates no queue or key store. */
+export declare function runBrowserUse(raw: BrowserUseInput, deps: BrowserUseDependencies, signal: AbortSignal): Promise<BrowserUseResult>;
+/** Step mode on one lease; see browser-steps.ts. */
+export declare function runBrowserSteps(raw: BrowserStepsInput, deps: BrowserUseDependencies, signal: AbortSignal): Promise<import("./browser-steps").BrowserStepsResult>;
+/** Adapt an authenticated MCP client. Principal scope and cancellation stay with its owner. */
+export declare function mcpBrowserTransport(invoke: (name: string, args: Record<string, unknown>, signal: AbortSignal) => Promise<{
+    content: unknown[];
+    isError?: boolean;
+}>): BrowserToolCall;
+export {};
+//# sourceMappingURL=browser-use.d.ts.map

package/dist/automation/browser-use.d.ts.map

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