tracegrove 0.0.0-stage → 0.3.0

package/dist/adapters/browser/driver.js

@@ -0,0 +1,295 @@
+import { chromium } from 'playwright';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Deadline } from "../../core/deadline.js";
+import { readBoundedFile } from "../../core/boundedFile.js";
+import { BrowserCommand, BrowserObservation, BrowserNetworkObservation } from "../../protocol/schemas/browser.js";
+export class BrowserStepError extends Error {
+    code;
+    phase;
+    constructor(code, phase) {
+        super(phase ? `${code}:${phase}` : code);
+        this.code = code;
+        this.phase = phase;
+        this.name = 'BrowserStepError';
+    }
+}
+/** Local browser facts only. Qualification and artifact admission belong to the controller. */
+export class BrowserDriver {
+    origin;
+    browser;
+    context;
+    page;
+    mediaDir;
+    inputMode;
+    closing;
+    busy = false;
+    latestFrameAt = 0;
+    onFrame;
+    constructor(origin, browser, context, page, mediaDir, inputMode) {
+        this.origin = origin;
+        this.browser = browser;
+        this.context = context;
+        this.page = page;
+        this.mediaDir = mediaDir;
+        this.inputMode = inputMode;
+    }
+    static async start(input) {
+        const origin = new URL(input.origin);
+        if (!['http:', 'https:'].includes(origin.protocol) || origin.href !== `${origin.origin}/` || origin.username || origin.password) {
+            throw new BrowserStepError('invalid_origin');
+        }
+        const signal = input.deadline.signal(input.signal);
+        signal.throwIfAborted();
+        const mediaDir = await mkdtemp(join(tmpdir(), 'tracegrove-browser-'));
+        let browser;
+        const abort = () => { void browser?.close().catch(() => { }); };
+        signal.addEventListener('abort', abort, { once: true });
+        try {
+            browser = await chromium.launch({ headless: true, timeout: Math.max(1, input.deadline.remainingMs()) });
+            signal.throwIfAborted();
+            const context = await browser.newContext({
+                serviceWorkers: 'block', acceptDownloads: false,
+                viewport: input.viewport ?? { width: 1280, height: 720 },
+                hasTouch: input.inputMode === 'touch',
+                ...(input.locale ? { locale: input.locale } : {}),
+                ...(input.timezoneId ? { timezoneId: input.timezoneId } : {}),
+                reducedMotion: input.reducedMotion ? 'reduce' : 'no-preference',
+            });
+            await context.routeWebSocket('**/*', socket => socket.close());
+            const page = await context.newPage();
+            const requests = new WeakMap();
+            let nextRequest = 0;
+            const observeNetwork = (kind, request, status) => {
+                if (!input.onNetwork)
+                    return;
+                try {
+                    let requestId = requests.get(request);
+                    if (requestId === undefined) {
+                        requestId = ++nextRequest;
+                        requests.set(request, requestId);
+                    }
+                    const url = new URL(request.url());
+                    input.onNetwork(BrowserNetworkObservation.parse({ kind, requestId, method: request.method(), url: `${url.origin}${url.pathname}`.slice(0, 4096), status }));
+                }
+                catch {
+                    void context.close().catch(() => { });
+                }
+            };
+            page.on('request', request => observeNetwork('request', request, null));
+            page.on('response', response => observeNetwork('response', response.request(), response.status()));
+            page.on('requestfailed', request => observeNetwork('failed', request, null));
+            // CDP pauses every redirect hop. Continue the native response stream rather
+            // than buffering/proxying it through route.fetch (which breaks chat/SSE).
+            const network = await context.newCDPSession(page);
+            network.on('Fetch.requestPaused', event => {
+                const url = new URL(event.request.url);
+                const allowed = url.origin === origin.origin
+                    && (!input.allowedMethods || input.allowedMethods.includes(event.request.method))
+                    && (!input.allowedResourcePrefixes || input.allowedResourcePrefixes.some(prefix => url.pathname.startsWith(prefix)));
+                const operation = allowed
+                    ? network.send('Fetch.continueRequest', { requestId: event.requestId,
+                        ...(input.bearer ? { headers: [...Object.entries(event.request.headers).filter(([name]) => name.toLowerCase() !== 'authorization').map(([name, value]) => ({ name, value: String(value) })), { name: 'Authorization', value: `Bearer ${input.bearer}` }] } : {}),
+                    })
+                    : network.send('Fetch.failRequest', { requestId: event.requestId, errorReason: 'BlockedByClient' });
+                void operation.catch(() => context.close().catch(() => { }));
+            });
+            await network.send('Fetch.enable', { patterns: [{ urlPattern: '*', requestStage: 'Request' }] });
+            context.on('page', extra => { if (extra !== page)
+                void extra.close().catch(() => { }); });
+            page.on('dialog', dialog => { void dialog.dismiss().catch(() => { }); });
+            signal.throwIfAborted();
+            const driver = new BrowserDriver(origin.origin, browser, context, page, mediaDir, input.inputMode ?? 'pointer');
+            // Keep mobile pixels at their native size; VP9's chroma grid needs even dimensions.
+            const viewport = input.viewport ?? { width: 1280, height: 720 };
+            const videoSize = { width: Math.ceil(viewport.width / 2) * 2, height: Math.ceil(viewport.height / 2) * 2 };
+            await page.screencast.start({ path: join(mediaDir, 'recording.webm'), size: videoSize,
+                onFrame: frame => { driver.latestFrameAt = frame.timestamp; driver.onFrame?.(frame.timestamp); },
+            });
+            signal.throwIfAborted();
+            return driver;
+        }
+        catch (error) {
+            await browser?.close();
+            await rm(mediaDir, { recursive: true, force: true });
+            throw error;
+        }
+        finally {
+            signal.removeEventListener('abort', abort);
+        }
+    }
+    locator(target) {
+        switch (target.by) {
+            case 'role': return this.page.getByRole(target.role, { name: target.name, exact: true });
+            case 'label': return this.page.getByLabel(target.name, { exact: true });
+            case 'testId': return this.page.getByTestId(target.name);
+        }
+    }
+    async execute(input, deadline, parent) {
+        const command = BrowserCommand.parse(input);
+        if (this.closing)
+            throw new BrowserStepError('browser_closed');
+        if (this.busy)
+            throw new BrowserStepError('browser_busy');
+        const signal = deadline.signal(parent);
+        signal.throwIfAborted();
+        this.busy = true;
+        // A read timeout has no late mutation to revoke. Keep its recording alive;
+        // user cancellation and mutating operations still close the context.
+        const abort = () => {
+            if (command.kind !== 'read' || parent?.aborted)
+                void this.close().catch(() => { });
+        };
+        signal.addEventListener('abort', abort, { once: true });
+        try {
+            signal.throwIfAborted();
+            const timeout = Math.max(1, deadline.remainingMs());
+            let status = null;
+            let text = null;
+            let textTruncated = false;
+            if (command.kind === 'navigate') {
+                const url = new URL(command.path, this.origin);
+                if (url.origin !== this.origin || url.username || url.password)
+                    throw new BrowserStepError('origin_not_admitted');
+                status = (await this.page.goto(url.href, { timeout, waitUntil: 'domcontentloaded' }))?.status() ?? null;
+            }
+            else {
+                const locator = this.locator(command.target);
+                if (command.kind === 'click') {
+                    if (this.inputMode === 'touch')
+                        await locator.tap({ timeout });
+                    else if (this.inputMode === 'keyboard') {
+                        await locator.focus({ timeout });
+                        const key = await locator.evaluate(element => {
+                            if (element.matches('input[type=checkbox],input[type=radio],[role=checkbox],[role=radio],[role=switch]'))
+                                return 'Space';
+                            if (element.matches('button,a,input[type=button],input[type=submit],input[type=reset],[role=button],[role=link]'))
+                                return 'Enter';
+                            return null; // A keyboard click on a text input means focus, not form submission.
+                        });
+                        if (key)
+                            await locator.press(key, { timeout });
+                    }
+                    else
+                        await locator.click({ timeout });
+                }
+                if (command.kind === 'fill') {
+                    if (this.inputMode === 'keyboard') {
+                        await locator.fill('', { timeout });
+                        await locator.pressSequentially(command.value, { timeout });
+                    }
+                    else
+                        await locator.fill(command.value, { timeout });
+                }
+                if (command.kind === 'read') {
+                    await locator.waitFor({ state: 'visible', timeout });
+                    // Bound the text before transporting it out of the page.
+                    const result = await locator.evaluate(element => {
+                        const value = element.textContent ?? '';
+                        return { text: value.slice(0, 8192), truncated: value.length > 8192 };
+                    }, undefined, { timeout: Math.max(1, deadline.remainingMs()) });
+                    text = result.text;
+                    textTruncated = result.truncated;
+                }
+            }
+            signal.throwIfAborted();
+            if (new URL(this.page.url()).origin !== this.origin)
+                throw new BrowserStepError('origin_not_admitted');
+            return BrowserObservation.parse({ kind: command.kind, url: this.page.url().slice(0, 4096), status, text, textTruncated });
+        }
+        catch (error) {
+            const cancelled = parent?.aborted === true;
+            const timedOut = deadline.expired() || (error instanceof Error && error.name === 'TimeoutError');
+            // Revoke failed mutating actions; a bounded read timeout can retain its video.
+            if (cancelled || !timedOut || command.kind !== 'read')
+                await this.close();
+            if (cancelled)
+                throw new BrowserStepError('browser_cancelled');
+            if (timedOut)
+                throw new BrowserStepError('browser_timeout');
+            if (error instanceof BrowserStepError)
+                throw error;
+            // Playwright diagnostics may include filled values or page text. Never emit them as errors.
+            throw new BrowserStepError('browser_operation_failed');
+        }
+        finally {
+            this.busy = false;
+            signal.removeEventListener('abort', abort);
+        }
+    }
+    /** RPC closure acknowledgement, not a process-tree cleanup attestation. */
+    close() {
+        this.closing ??= this.context.close().finally(() => this.browser.close());
+        return this.closing;
+    }
+    /** Wait for a presented recording frame, then flush the encoder before closure. */
+    async collectVideo(maxBytes = 32 * 1024 * 1024, deadline = Deadline.in(5000)) {
+        if (!this.closing) {
+            const signal = deadline.signal();
+            let phase = 'capture';
+            try {
+                signal.throwIfAborted();
+                // Complete a layout-aware capture before defining the freshness barrier;
+                // a newly delivered frame can still contain pixels queued before this capture.
+                await this.page.screenshot({ type: 'png', animations: 'allow', caret: 'initial', timeout: Math.max(1, deadline.remainingMs()) });
+                signal.throwIfAborted();
+                // A DOM read or screenshot acknowledgement can precede recording delivery.
+                // Browser presentation timestamps exclude frames already in flight.
+                const since = Date.now() + 1;
+                await new Promise((resolve, reject) => {
+                    let captured = false;
+                    let presented = false;
+                    const finish = (error) => {
+                        this.onFrame = undefined;
+                        signal.removeEventListener('abort', abort);
+                        if (error)
+                            reject(error);
+                        else
+                            resolve();
+                    };
+                    const abort = () => finish(signal.reason);
+                    this.onFrame = timestamp => {
+                        presented ||= timestamp >= since;
+                        if (captured && presented)
+                            finish();
+                    };
+                    signal.addEventListener('abort', abort, { once: true });
+                    void this.page.screenshot({ type: 'png', animations: 'allow', caret: 'initial', timeout: Math.max(1, deadline.remainingMs()) })
+                        .then(() => {
+                        captured = true;
+                        phase = 'frame';
+                        presented ||= this.latestFrameAt >= since;
+                        if (presented)
+                            finish();
+                    }, finish);
+                });
+                signal.throwIfAborted();
+                phase = 'flush';
+                const abort = () => { void this.close().catch(() => { }); };
+                signal.addEventListener('abort', abort, { once: true });
+                try {
+                    await this.page.screencast.stop();
+                    signal.throwIfAborted();
+                }
+                finally {
+                    signal.removeEventListener('abort', abort);
+                }
+            }
+            catch {
+                await this.close();
+                throw new BrowserStepError('video_final_frame_unavailable', phase);
+            }
+        }
+        await this.close();
+        const bytes = readBoundedFile(join(this.mediaDir, 'recording.webm'), maxBytes);
+        if (!bytes.length)
+            throw new BrowserStepError('video_empty');
+        return bytes;
+    }
+    async dispose() {
+        await this.close();
+        await rm(this.mediaDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/adapters/browser/driver.js.map

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

package/dist/adapters/browser/session.d.ts

@@ -0,0 +1,21 @@
+import { type BrowserObservation, type BrowserNetworkObservation, type CaseSpec, type Persona, type Step } from '../../protocol/index.ts';
+import { Deadline } from '../../core/deadline.ts';
+/** One lazy browser per case; all polls count against the same action budget. */
+export declare class CaseBrowserSession {
+    private readonly input;
+    private browser;
+    private actions;
+    private started;
+    private elapsed;
+    private networkEvents;
+    constructor(input: {
+        origin: string;
+        spec: CaseSpec;
+        persona: Persona;
+        bearer: string | null;
+        onNetwork: (observation: BrowserNetworkObservation) => void;
+    });
+    execute(step: Step, variables: Record<string, unknown>, deadline: Deadline, signal: AbortSignal): Promise<BrowserObservation>;
+    get seconds(): number;
+    collectVideo(deadline: Deadline): Promise<Buffer | null>;
+}

package/dist/adapters/browser/session.js

@@ -0,0 +1,87 @@
+import { BrowserDriver, BrowserStepError } from "./driver.js";
+import { BrowserAction, BrowserLocator } from "../../protocol/index.js";
+import { applyTemplate, applyTemplateDeep } from "../../core/compiler.js";
+import { Deadline, sleep } from "../../core/deadline.js";
+import { monotonicMs } from "../../core/clock.js";
+import { evaluatePredicate } from "../../core/reducer.js";
+/** One lazy browser per case; all polls count against the same action budget. */
+export class CaseBrowserSession {
+    input;
+    browser;
+    actions = 0;
+    started;
+    elapsed = 0;
+    networkEvents = 0;
+    constructor(input) {
+        this.input = input;
+    }
+    async execute(step, variables, deadline, signal) {
+        if (!step.kind.startsWith('ui.'))
+            throw new BrowserStepError('not_browser_step');
+        if (!this.browser) {
+            this.started = monotonicMs();
+            const { persona, spec } = this.input;
+            this.browser = await BrowserDriver.start({ origin: this.input.origin, deadline, signal,
+                allowedMethods: spec.effects.allowedMethods.filter(method => spec.effects.mode !== 'read_only' || method === 'GET' || method === 'HEAD'), allowedResourcePrefixes: spec.effects.allowedResourcePrefixes,
+                ...(this.input.bearer ? { bearer: this.input.bearer } : {}),
+                onNetwork: observation => {
+                    if (++this.networkEvents > 512)
+                        throw new BrowserStepError('browser_network_metadata_limit');
+                    this.input.onNetwork(observation);
+                },
+                viewport: persona.viewport, locale: persona.locale, timezoneId: persona.timezone, reducedMotion: persona.reducedMotion, inputMode: persona.inputMode });
+        }
+        const command = step.kind === 'ui.navigate' ? { kind: 'navigate', path: applyTemplate(step.path, variables) }
+            : step.kind === 'ui.action' ? BrowserAction.parse(applyTemplateDeep(step.command, variables))
+                : step.kind === 'ui.observe' ? { kind: 'read', target: BrowserLocator.parse(applyTemplateDeep(step.target, variables)) } : null;
+        if (!command)
+            throw new BrowserStepError('not_browser_step');
+        let last = null;
+        for (;;) {
+            if (signal.aborted)
+                throw new BrowserStepError('browser_cancelled');
+            if (last && deadline.expired())
+                return last;
+            if (++this.actions > this.input.spec.limits.maxBrowserActions)
+                throw new BrowserStepError('browser_action_limit');
+            try {
+                last = await this.browser.execute(command, deadline, signal);
+                if (step.kind !== 'ui.observe' || evaluatePredicate(step.predicate, { browser: last }).pass)
+                    return last;
+                if (deadline.remainingMs() <= step.pollIntervalMs)
+                    return last;
+                await sleep(step.pollIntervalMs, deadline.signal(signal));
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw new BrowserStepError('browser_cancelled');
+                const timeout = error instanceof BrowserStepError ? error.code === 'browser_timeout'
+                    : error instanceof Error && error.name === 'TimeoutError';
+                // A later polling timeout cannot erase a completed product observation.
+                // Cancellation and actual browser failures still propagate.
+                if (last && timeout && deadline.expired())
+                    return last;
+                throw error;
+            }
+        }
+    }
+    get seconds() { return this.started === undefined ? 0 : this.elapsed || (monotonicMs() - this.started) / 1000; }
+    async collectVideo(deadline) {
+        if (!this.browser)
+            return null;
+        try {
+            if (this.networkEvents > 512)
+                throw new BrowserStepError('browser_network_metadata_limit');
+            return await this.browser.collectVideo(Math.min(this.input.spec.limits.maxArtifactBytes, 16 * 1024 * 1024), deadline.child(5000));
+        }
+        finally {
+            try {
+                await this.browser.dispose();
+            }
+            finally {
+                this.elapsed = this.seconds;
+            }
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/adapters/browser/session.js.map

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

package/dist/adapters/http/capabilities.d.ts

@@ -0,0 +1,2 @@
+import { RunnerCapabilities } from '../../protocol/index.ts';
+export declare const HTTP_RUNNER_CAPABILITIES: RunnerCapabilities;

package/dist/adapters/http/capabilities.js

@@ -0,0 +1,21 @@
+import { RunnerCapabilities, digestOfValue, parseAs } from "../../protocol/index.js";
+const base = {
+    ref: { id: 'tracegrove.runner.http', revision: '0.1.0', digest: { algorithm: 'sha256', hex: '0'.repeat(64) } },
+    operations: ['http.request', 'observe'],
+    oracles: ['http.observation/1', 'step.result/1'],
+    fixtureOperations: ['fixture.http'],
+    faultOperations: [],
+    variableCaptureFormats: ['application/json'],
+    cleanupOperations: ['fixture.http'],
+    maxStepsPerCase: 50,
+    environmentClasses: ['isolated_candidate', 'deployed_preview', 'deployed_canary', 'production_observation'],
+    captureFormats: ['application/json'],
+    surfacePackRefs: [],
+    hostConstraintRef: null,
+    cancellation: 'confirmed',
+    protocol: 'http',
+    conformanceReceiptRef: null,
+};
+const digest = digestOfValue({ ...base, ref: { id: base.ref.id, revision: base.ref.revision } });
+export const HTTP_RUNNER_CAPABILITIES = parseAs(RunnerCapabilities, { ...base, ref: { ...base.ref, digest } }, 'runner capabilities');
+//# sourceMappingURL=capabilities.js.map

package/dist/adapters/http/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/adapters/http/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAErF,MAAM,IAAI,GAAG;IACX,GAAG,EAAE,EAAE,EAAE,EAAE,wBAAwB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,QAAiB,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE;IACvH,UAAU,EAAE,CAAC,cAAc,EAAE,SAAS,CAAC;IACvC,OAAO,EAAE,CAAC,oBAAoB,EAAE,eAAe,CAAC;IAChD,iBAAiB,EAAE,CAAC,cAAc,CAAC;IACnC,eAAe,EAAE,EAAE;IACnB,sBAAsB,EAAE,CAAC,kBAAkB,CAAC;IAC5C,iBAAiB,EAAE,CAAC,cAAc,CAAC;IACnC,eAAe,EAAE,EAAE;IACnB,kBAAkB,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,wBAAwB,CAAU;IACpH,cAAc,EAAE,CAAC,kBAAkB,CAAC;IACpC,eAAe,EAAE,EAAE;IACnB,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,WAAoB;IAClC,QAAQ,EAAE,MAAe;IACzB,qBAAqB,EAAE,IAAI;CAC5B,CAAC;AACF,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,wBAAwB,GAAuB,OAAO,CAAC,kBAAkB,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/adapters/http/driver.d.ts

@@ -0,0 +1,55 @@
+import { Deadline } from '../../core/deadline.ts';
+import type { PredicateT } from '../../protocol/index.ts';
+import type { z } from 'zod';
+import type { Capture as CaptureSchema } from '../../protocol/index.ts';
+type Capture = z.infer<typeof CaptureSchema>;
+export declare const MAX_BODY_TEXT: number;
+export type HttpObservation = {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+    bodyText: string | null;
+    requestId: string | null;
+    method: string;
+    url: string;
+    durationMs: number;
+    attempts: number;
+};
+export type HttpCredentials = {
+    persona: string | null;
+    named: Record<string, string>;
+};
+export type HttpRequestSpec = {
+    origin: string;
+    method: string;
+    path: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    auth: {
+        kind: 'none';
+    } | {
+        kind: 'persona';
+    } | {
+        kind: 'credential';
+        name: string;
+    };
+    variables: Record<string, unknown>;
+    deadline: Deadline;
+    signal?: AbortSignal;
+};
+export declare class HttpStepError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function bearerFor(spec: Pick<HttpRequestSpec, 'auth'>, credentials: HttpCredentials): string | null;
+export declare class HttpDriver {
+    private readonly credentials;
+    private readonly allowedOrigins;
+    constructor(credentials: HttpCredentials, allowedOrigins: Set<string>);
+    request(spec: HttpRequestSpec): Promise<HttpObservation>;
+    /** Poll an independent readback until the predicate holds or the deadline expires. */
+    observe(spec: HttpRequestSpec, predicate: PredicateT, pollIntervalMs: number): Promise<HttpObservation>;
+}
+export declare function captureValues(observation: Pick<HttpObservation, 'body'> & Partial<Pick<HttpObservation, 'status' | 'headers'>>, captures: Capture[]): Record<string, unknown>;
+export declare function redactObservation(observation: HttpObservation): Record<string, unknown>;
+export {};

package/dist/adapters/http/driver.js

@@ -0,0 +1,125 @@
+/**
+ * Real bounded HTTP surface driver. Every request carries a deadline-derived AbortSignal.
+ * Observations are bounded, redacted records the trusted reducer evaluates; the driver never
+ * decides pass/fail. No interceptor exists in this driver; the mock lane is a separate host.
+ */
+import { applyTemplate, applyTemplateDeep } from "../../core/compiler.js";
+import { Deadline } from "../../core/deadline.js";
+import { pollObservation } from "../poll.js";
+import { monotonicMs } from "../../core/clock.js";
+import { evaluatePredicate } from "../../core/reducer.js";
+export const MAX_BODY_TEXT = 8 * 1024;
+const RECORDED_HEADERS = ['content-type', 'x-request-id', 'content-length'];
+export class HttpStepError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'HttpStepError';
+    }
+}
+export function bearerFor(spec, credentials) {
+    if (spec.auth.kind === 'none')
+        return null;
+    if (spec.auth.kind === 'persona') {
+        if (!credentials.persona)
+            throw new HttpStepError('missing_persona_credential', 'persona credential was not issued for this attempt');
+        return credentials.persona;
+    }
+    const named = credentials.named[spec.auth.name];
+    if (!named)
+        throw new HttpStepError('missing_named_credential', `credential ${spec.auth.name} was not issued for this attempt`);
+    return named;
+}
+export class HttpDriver {
+    credentials;
+    allowedOrigins;
+    constructor(credentials, allowedOrigins) {
+        this.credentials = credentials;
+        this.allowedOrigins = allowedOrigins;
+    }
+    async request(spec) {
+        if (!this.allowedOrigins.has(spec.origin))
+            throw new HttpStepError('origin_not_admitted', `${spec.origin} is not an admitted origin`);
+        const path = applyTemplate(spec.path, spec.variables);
+        if (!path.startsWith('/'))
+            throw new HttpStepError('invalid_path', path);
+        const url = `${spec.origin}${path}`;
+        const headers = { ...(spec.headers ?? {}) };
+        const bearer = bearerFor(spec, this.credentials);
+        if (bearer)
+            headers.authorization = `Bearer ${bearer}`;
+        let bodyText;
+        if (spec.body !== undefined && spec.body !== null && spec.method !== 'GET' && spec.method !== 'HEAD') {
+            headers['content-type'] = headers['content-type'] ?? 'application/json';
+            bodyText = JSON.stringify(applyTemplateDeep(spec.body, spec.variables));
+        }
+        const started = monotonicMs();
+        const signal = spec.deadline.signal(spec.signal);
+        let response;
+        let text;
+        try {
+            response = await fetch(url, { method: spec.method, headers, ...(bodyText !== undefined ? { body: bodyText } : {}), signal, redirect: 'manual' });
+            text = await response.text();
+        }
+        catch (error) {
+            const err = error;
+            if (spec.signal?.aborted)
+                throw new HttpStepError('cancelled', 'request cancelled');
+            if (err.name === 'TimeoutError' || err.name === 'AbortError' || signal.aborted)
+                throw new HttpStepError('deadline_exceeded', `${spec.method} ${path} exceeded its deadline`);
+            throw new HttpStepError('transport_failure', `${spec.method} ${path}: ${err.message}`);
+        }
+        const durationMs = monotonicMs() - started;
+        const recorded = {};
+        for (const name of RECORDED_HEADERS) {
+            const value = response.headers.get(name);
+            if (value)
+                recorded[name] = value;
+        }
+        let body = null;
+        let bodyOut = null;
+        if (text.length > 0) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                bodyOut = text.slice(0, MAX_BODY_TEXT);
+            }
+        }
+        return { status: response.status, headers: recorded, body, bodyText: bodyOut, requestId: response.headers.get('x-request-id'), method: spec.method, url: `${spec.origin}${path}`, durationMs, attempts: 1 };
+    }
+    /** Poll an independent readback until the predicate holds or the deadline expires. */
+    async observe(spec, predicate, pollIntervalMs) {
+        return pollObservation({ read: () => this.request(spec), accepts: observation => evaluatePredicate(predicate, { status: observation.status, body: observation.body }).pass,
+            deadline: spec.deadline, pollIntervalMs, signal: spec.signal, cancelled: () => new HttpStepError('cancelled', 'observation cancelled') });
+    }
+}
+export function captureValues(observation, captures) {
+    const values = {};
+    for (const capture of captures) {
+        switch (capture.from) {
+            case 'status':
+                values[capture.name] = observation.status;
+                break;
+            case 'header':
+                values[capture.name] = capture.path ? observation.headers?.[capture.path.toLowerCase()] ?? null : null;
+                break;
+            case 'json': {
+                let current = observation.body;
+                for (const segment of (capture.path ?? '').split('.').filter(Boolean)) {
+                    current = current && typeof current === 'object' ? current[segment] : undefined;
+                }
+                if (current === undefined)
+                    throw new HttpStepError('capture_missing', `capture ${capture.name}: path ${capture.path} absent from response`);
+                values[capture.name] = current;
+                break;
+            }
+        }
+    }
+    return values;
+}
+export function redactObservation(observation) {
+    return { status: observation.status, headers: observation.headers, body: observation.body, bodyText: observation.bodyText, requestId: observation.requestId, method: observation.method, url: observation.url, durationMs: observation.durationMs, attempts: observation.attempts };
+}
+//# sourceMappingURL=driver.js.map