@e2edev/e2e 0.2.0

package/dist/expect/async.js

@@ -0,0 +1,186 @@
+/** Runner-owned polling locator assertions (spec 03-assertions.md). */
+import { TestError } from '../internal/errors.js';
+import { normalizeText, containsText, matchesText, toTextPattern, describePattern } from '../internal/text.js';
+import { Deadline, pollCondition } from '../internal/time.js';
+import { isNodeVisible } from '../locator/engine.js';
+import { describeExpression } from '../locator/expression.js';
+const STATE_MATCHERS = {
+    toBeEnabled: { key: 'disabled', expected: false, describeExpected: 'enabled' },
+    toBeDisabled: { key: 'disabled', expected: true, describeExpected: 'disabled' },
+    toBeChecked: { key: 'checked', expected: true, describeExpected: 'checked' },
+    toBeSelected: { key: 'selected', expected: true, describeExpected: 'selected' },
+    toBeExpanded: { key: 'expanded', expected: true, describeExpected: 'expanded' },
+};
+const TEXT_MATCHERS = {
+    toHaveText: {
+        field: 'text',
+        match: matchesText,
+        describeExpected: (pattern) => `text ${pattern}`,
+        normalize: true,
+    },
+    toContainText: {
+        field: 'text',
+        match: containsText,
+        describeExpected: (pattern) => `text containing ${pattern}`,
+        normalize: true,
+    },
+    toHaveValue: {
+        field: 'value',
+        match: matchesText,
+        describeExpected: (pattern) => `value ${pattern}`,
+        normalize: false,
+    },
+    toHaveAccessibleName: {
+        field: 'name',
+        match: matchesText,
+        describeExpected: (pattern) => `accessible name ${pattern}`,
+        normalize: false,
+    },
+};
+class AsyncExpectationImpl {
+    internals;
+    negated;
+    constructor(internals, negated) {
+        this.internals = internals;
+        this.negated = negated;
+    }
+    get not() {
+        return new AsyncExpectationImpl(this.internals, !this.negated);
+    }
+    get label() {
+        return describeExpression(this.internals.expression);
+    }
+    async poll(spec, timeout) {
+        const { engine } = this.internals.context;
+        const api = `expect.${this.negated ? 'not.' : ''}${spec.name}`;
+        await this.internals.context.steps.run('assertion', api, this.label, async () => {
+            const deadline = engine.deadline(timeout ?? engine.assertionTimeout);
+            let lastSample = { count: 0, node: null };
+            await pollCondition({
+                deadline,
+                signal: engine.signal,
+                negated: this.negated,
+                evaluate: async () => {
+                    const sample = await this.sample(spec, deadline);
+                    lastSample = sample;
+                    if (!this.conditionEvaluable(spec, sample))
+                        return undefined;
+                    return spec.predicate(sample);
+                },
+                onTimeout: () => new TestError('ASSERTION_FAILED', [
+                    `${api} failed`,
+                    `locator: ${this.label}`,
+                    `expected: ${this.negated ? 'not ' : ''}${spec.describeExpected}`,
+                    `observed: ${spec.observed(lastSample)} (match count ${lastSample.count})`,
+                ].join('\n')),
+            });
+        }, { verifies: true });
+    }
+    /**
+     * Single-node matchers require an unambiguous node before their predicate
+     * means anything; visibility matchers also accept zero matches.
+     */
+    conditionEvaluable(spec, sample) {
+        return spec.wholeSet === true || sample.node !== null || spec.evaluableWithoutNode === true;
+    }
+    async sample(spec, deadline) {
+        const { engine } = this.internals.context;
+        if (spec.wholeSet === true) {
+            const refs = await engine.resolveAll(this.internals.expression, deadline);
+            return { count: refs.length, node: null };
+        }
+        const { node, count } = await engine.tryRead(this.internals.expression, deadline);
+        return { count, node };
+    }
+    stateMatcher(name, timeout) {
+        const def = STATE_MATCHERS[name];
+        return this.poll({
+            name,
+            predicate: (sample) => sample.node !== null && (sample.node.states?.[def.key] === true) === def.expected,
+            describeExpected: def.describeExpected,
+            observed: observedState,
+        }, timeout);
+    }
+    textMatcher(name, expected, timeout) {
+        const def = TEXT_MATCHERS[name];
+        const pattern = toTextPattern(expected, { exact: true });
+        return this.poll({
+            name,
+            predicate: (sample) => sample.node !== null && def.match(sample.node[def.field] ?? '', pattern),
+            describeExpected: def.describeExpected(describePattern(pattern)),
+            observed: (sample) => {
+                if (sample.node === null)
+                    return 'no node';
+                const raw = sample.node[def.field] ?? '';
+                return `${def.field} ${JSON.stringify(def.normalize ? normalizeText(raw) : raw)}`;
+            },
+        }, timeout);
+    }
+    toBeVisible(options) {
+        return this.poll({
+            name: 'toBeVisible',
+            evaluableWithoutNode: true,
+            predicate: (sample) => isNodeVisible(sample.node),
+            describeExpected: 'visible',
+            observed: observedState,
+        }, options?.timeout);
+    }
+    toBeHidden(options) {
+        return this.poll({
+            name: 'toBeHidden',
+            evaluableWithoutNode: true,
+            predicate: (sample) => !isNodeVisible(sample.node),
+            describeExpected: 'hidden or absent',
+            observed: observedState,
+        }, options?.timeout);
+    }
+    toBeEnabled(options) {
+        return this.stateMatcher('toBeEnabled', options?.timeout);
+    }
+    toBeDisabled(options) {
+        return this.stateMatcher('toBeDisabled', options?.timeout);
+    }
+    toBeChecked(options) {
+        return this.stateMatcher('toBeChecked', options?.timeout);
+    }
+    toBeSelected(options) {
+        return this.stateMatcher('toBeSelected', options?.timeout);
+    }
+    toBeExpanded(options) {
+        return this.stateMatcher('toBeExpanded', options?.timeout);
+    }
+    toHaveText(expected, options) {
+        return this.textMatcher('toHaveText', expected, options?.timeout);
+    }
+    toContainText(expected, options) {
+        return this.textMatcher('toContainText', expected, options?.timeout);
+    }
+    toHaveValue(expected, options) {
+        return this.textMatcher('toHaveValue', expected, options?.timeout);
+    }
+    toHaveAccessibleName(expected, options) {
+        return this.textMatcher('toHaveAccessibleName', expected, options?.timeout);
+    }
+    toHaveCount(expected, options) {
+        return this.poll({
+            name: 'toHaveCount',
+            wholeSet: true,
+            predicate: (sample) => sample.count === expected,
+            describeExpected: `count ${expected}`,
+            observed: (sample) => `count ${sample.count}`,
+        }, options?.timeout);
+    }
+}
+function observedState(sample) {
+    if (sample.node === null)
+        return 'no node';
+    const states = sample.node.states ?? {};
+    const active = Object.entries(states)
+        .filter(([, value]) => value === true)
+        .map(([key]) => key);
+    return active.length === 0 ? 'default states' : `states: ${active.join(', ')}`;
+}
+export function createAsyncExpectation(internals) {
+    return new AsyncExpectationImpl(internals, false);
+}
+//# sourceMappingURL=async.js.map

package/dist/expect/async.js.map

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

package/dist/expect/index.d.ts

@@ -0,0 +1,7 @@
+/** Public expect() dispatcher (spec api/e2e.d.ts). */
+import type { AsyncExpectation, Expectable, Locator, ValueExpectation } from '../types.ts';
+/** Creates deterministic or async e2e expectations. */
+export declare function expect(actual: Locator): AsyncExpectation;
+export declare function expect<E extends object>(actual: Expectable<E>): E;
+export declare function expect<T>(actual: T): ValueExpectation<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/expect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expect/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAe3F,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC;AAC1D,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACnE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC"}

package/dist/expect/index.js

@@ -0,0 +1,23 @@
+/** Public expect() dispatcher (spec api/e2e.d.ts). */
+import { expectationBrand } from '../internal/brands.js';
+import { realmSlot } from '../internal/realm-slot.js';
+import { locatorInternals } from '../locator/screen.js';
+import { createAsyncExpectation } from './async.js';
+import { createValueExpectation } from './values.js';
+/**
+ * A fixture's attached expectation surface hangs off the fixture object under
+ * a global symbol (`BackendFixtureContext.expectable`), so an expect()
+ * imported in an isolated test-module realm can still reach it. Core routes
+ * to the surface and never knows which matchers a platform contributed.
+ */
+const expectationSlot = realmSlot(expectationBrand);
+export function expect(actual) {
+    const internals = locatorInternals(actual);
+    if (internals !== undefined)
+        return createAsyncExpectation(internals);
+    const attached = expectationSlot.get(actual);
+    if (attached !== undefined)
+        return attached;
+    return createValueExpectation(actual);
+}
+//# sourceMappingURL=index.js.map

package/dist/expect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expect/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;GAKG;AACH,MAAM,eAAe,GAAG,SAAS,CAAS,gBAAgB,CAAC,CAAC;AAM5D,MAAM,UAAU,MAAM,CAAC,MAAe;IACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/expect/values.d.ts

@@ -0,0 +1,4 @@
+/** Synchronous plain-value matchers (spec 03-assertions.md). */
+import type { ValueExpectation } from '../types.ts';
+export declare function createValueExpectation<T>(actual: T): ValueExpectation<T>;
+//# sourceMappingURL=values.d.ts.map

package/dist/expect/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/expect/values.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAIhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAwJpD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAExE"}

package/dist/expect/values.js

@@ -0,0 +1,108 @@
+/** Synchronous plain-value matchers (spec 03-assertions.md). */
+import { equals, iterableEquality } from '@vitest/expect';
+import { TestError } from '../internal/errors.js';
+function fail(message) {
+    throw new TestError('ASSERTION_FAILED', message);
+}
+function format(value) {
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'bigint')
+        return `${value}n`;
+    if (typeof value === 'function')
+        return `[Function ${value.name || 'anonymous'}]`;
+    if (typeof value === 'symbol')
+        return value.toString();
+    try {
+        const json = JSON.stringify(value);
+        if (json !== undefined)
+            return json;
+    }
+    catch {
+        // fall through
+    }
+    return String(value);
+}
+class ValueExpectationImpl {
+    actual;
+    negated;
+    constructor(actual, negated) {
+        this.actual = actual;
+        this.negated = negated;
+    }
+    get not() {
+        return new ValueExpectationImpl(this.actual, !this.negated);
+    }
+    /** Messages are thunks: formatting large values is paid only on failure. */
+    check(condition, positive, negative) {
+        if (this.negated) {
+            if (condition)
+                fail(negative());
+            return;
+        }
+        if (!condition)
+            fail(positive());
+    }
+    toBe(expected) {
+        this.check(Object.is(this.actual, expected), () => `expected ${format(this.actual)} to be ${format(expected)}`, () => `expected ${format(this.actual)} not to be ${format(expected)}`);
+    }
+    toEqual(expected) {
+        this.check(equals(this.actual, expected, [iterableEquality]), () => `expected ${format(this.actual)} to equal ${format(expected)}`, () => `expected ${format(this.actual)} not to equal ${format(expected)}`);
+    }
+    toBeTruthy() {
+        this.check(Boolean(this.actual), () => `expected ${format(this.actual)} to be truthy`, () => `expected ${format(this.actual)} not to be truthy`);
+    }
+    toBeFalsy() {
+        this.check(!this.actual, () => `expected ${format(this.actual)} to be falsy`, () => `expected ${format(this.actual)} not to be falsy`);
+    }
+    toBeNull() {
+        this.check(this.actual === null, () => `expected ${format(this.actual)} to be null`, () => `expected value not to be null`);
+    }
+    toBeUndefined() {
+        this.check(this.actual === undefined, () => `expected ${format(this.actual)} to be undefined`, () => `expected value not to be undefined`);
+    }
+    toBeDefined() {
+        this.check(this.actual !== undefined && this.actual !== null, () => `expected ${format(this.actual)} to be defined`, () => `expected ${format(this.actual)} not to be defined`);
+    }
+    toContain(expected) {
+        let contains;
+        const actual = this.actual;
+        if (typeof actual === 'string') {
+            if (typeof expected !== 'string') {
+                fail(`toContain on a string requires a string, got ${format(expected)}`);
+            }
+            contains = actual.includes(expected);
+        }
+        else if (typeof actual === 'object' && actual !== null && Symbol.iterator in actual) {
+            contains = [...actual].some((item) => equals(item, expected, [iterableEquality]));
+        }
+        else {
+            fail(`toContain requires a string or collection, got ${format(actual)}`);
+        }
+        this.check(contains, () => `expected ${format(this.actual)} to contain ${format(expected)}`, () => `expected ${format(this.actual)} not to contain ${format(expected)}`);
+    }
+    toMatch(expected) {
+        const actual = this.actual;
+        if (typeof actual !== 'string') {
+            fail(`toMatch requires a string, got ${format(actual)}`);
+        }
+        const matches = typeof expected === 'string' ? actual.includes(expected) : expected.test(actual);
+        this.check(matches, () => `expected ${format(actual)} to match ${format(expected)}`, () => `expected ${format(actual)} not to match ${format(expected)}`);
+    }
+    toBeGreaterThan(expected) {
+        const actual = this.actual;
+        if (typeof actual !== 'number')
+            fail(`toBeGreaterThan requires a number, got ${format(actual)}`);
+        this.check(actual > expected, () => `expected ${actual} to be greater than ${expected}`, () => `expected ${actual} not to be greater than ${expected}`);
+    }
+    toBeLessThan(expected) {
+        const actual = this.actual;
+        if (typeof actual !== 'number')
+            fail(`toBeLessThan requires a number, got ${format(actual)}`);
+        this.check(actual < expected, () => `expected ${actual} to be less than ${expected}`, () => `expected ${actual} not to be less than ${expected}`);
+    }
+}
+export function createValueExpectation(actual) {
+    return new ValueExpectationImpl(actual, false);
+}
+//# sourceMappingURL=values.js.map

package/dist/expect/values.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/** Public sdk-0.1 entrypoint. */
+import type { E2EConfig } from './types.ts';
+export { test } from './collect/registry.ts';
+export { expect } from './expect/index.ts';
+export { credentials } from './credentials.ts';
+export { AgentError } from './agent/error.ts';
+export { BLOCKABLE_CODES, blockedCategoryOf } from './agent/executor.ts';
+export { buildTraceEntry, readTraceEntry } from './cache/trace.ts';
+/** Type-checks and returns an e2e configuration object. */
+export declare function defineConfig(config: E2EConfig): E2EConfig;
+export type * from './types.ts';
+export type { BlockedCategory, ExecutorActions, ExecutorBudgets, ExecutorModelCall, ExecutorObservation, ExecutorStep, ExecutorTarget, ReplayedPrefix, ReplayHandOffReason, StepExecutor, StepExecutorContext, StepVerdict, StepVerdictStatus, } from './agent/executor.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIzE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAEzD;AAED,mBAAmB,YAAY,CAAC;AAChC,YAAY,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/** Public sdk-0.1 entrypoint. */
+export { test } from './collect/registry.js';
+export { expect } from './expect/index.js';
+export { credentials } from './credentials.js';
+export { AgentError } from './agent/error.js';
+export { BLOCKABLE_CODES, blockedCategoryOf } from './agent/executor.js';
+// Entry framing for custom TraceCacheStore implementations: a remote store
+// serializes buildTraceEntry(payload) on write and validates documents with
+// readTraceEntry on read — the same framing the default file store uses.
+export { buildTraceEntry, readTraceEntry } from './cache/trace.js';
+/** Type-checks and returns an e2e configuration object. */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAIjC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/internal/ai-trace.d.ts

@@ -0,0 +1,151 @@
+/**
+ * AI trace recording for `e2e run --ai-trace`: every model round trip the
+ * run makes, in the AI SDK devtools database shape (`{ runs[], steps[] }`)
+ * that trace viewers such as unbox-ai already read.
+ *
+ * This is a debugging aid, not a report: the report stays the canonical
+ * record and the trace is written next to it only on request. The recorder
+ * is an AI SDK telemetry integration, so it sees the exact prompt, tool
+ * definitions, response, and usage of each generation — including calls a
+ * custom executor makes through its own `ai` import, because the SDK
+ * resolves registered integrations process-wide. What the model saw is
+ * already redacted and size-bounded by the observation pipeline, so the
+ * trace carries no secret the model could not have seen either.
+ *
+ * Attribution comes from an async-local scope the run layer enters per
+ * attempt and per step, so no model call site needs to know it is traced.
+ */
+import type { Telemetry } from 'ai';
+/** A run record: one `generateText` call, which for `agent.act` is one whole step. */
+export interface AiTraceRun {
+    readonly id: string;
+    readonly started_at: string;
+    readonly parent_run_id: string | null;
+    readonly parent_step_id: string | null;
+    /** Human-readable run name: test title, agent API, and step label. */
+    readonly function_id: string | null;
+    /** e2e attribution beyond what the devtools shape carries. */
+    readonly e2e: AiTraceScope | undefined;
+}
+/** A step record: one model round trip inside a run, JSON columns as strings. */
+export interface AiTraceStep {
+    readonly id: string;
+    readonly run_id: string;
+    readonly step_number: number;
+    readonly type: 'generate';
+    readonly model_id: string;
+    readonly provider: string | null;
+    readonly started_at: string;
+    readonly duration_ms: number | null;
+    readonly input: string;
+    readonly output: string | null;
+    readonly usage: string | null;
+    readonly error: string | null;
+}
+/** The on-disk document: exactly what `@ai-sdk/devtools` writes. */
+export interface AiTraceDocument {
+    readonly runs: AiTraceRun[];
+    readonly steps: AiTraceStep[];
+}
+/** Records drained from one worker since its previous drain. */
+export type AiTraceSnapshot = AiTraceDocument;
+/** What the run layer knows about the code that is calling the model. */
+export interface AiTraceScope {
+    readonly test: string;
+    readonly testId: string;
+    readonly target: string;
+    /** Zero-based attempt index. */
+    readonly attempt: number;
+    readonly api?: string;
+    readonly label?: string;
+}
+/** Runs `work` with `scope` as the attribution for every model call inside. */
+export declare function withAiTraceScope<T>(scope: AiTraceScope, work: () => Promise<T>): Promise<T>;
+/**
+ * Narrows the current attempt scope to one public API step. Outside an
+ * attempt scope there is nothing to narrow, and the work runs as is.
+ */
+export declare function withAiTraceStep<T>(api: string, label: string, work: () => Promise<T>): Promise<T>;
+/**
+ * Collects one process's model calls. Registered once with the AI SDK via
+ * `registerTelemetry`; `drain()` hands the completed records to the run
+ * layer, which ships them to the runner over the worker channel.
+ */
+export declare class AiTraceRecorder {
+    private readonly calls;
+    /**
+     * One run per agent step: every generation made under the same step scope
+     * — a `waitFor` poll, a judgment repair round — continues the step's run
+     * rather than starting its own, so a viewer's run list reads as the test's
+     * step list. Keyed by scope identity, which is fresh per step.
+     */
+    private readonly stepRuns;
+    private runs;
+    private steps;
+    /**
+     * The tool a generation is being made from, carried by async context so
+     * tools that execute in parallel each see only their own ancestry.
+     */
+    private readonly toolAncestry;
+    private disposed;
+    /** The integration object to hand to `registerTelemetry`. */
+    readonly telemetry: Telemetry;
+    /**
+     * Stops recording. The SDK offers no unregister, so a disposed recorder
+     * simply ignores every later event; the entry it leaves in the global
+     * integration list is removed when that list is where the SDK keeps it.
+     */
+    dispose(): void;
+    /**
+     * Returns every run created and every step closed since the previous
+     * drain. Open steps stay until they close, so a step that finishes after a
+     * unit boundary is never reported half-written; `drain({ all: true })` at
+     * shutdown takes them as they are.
+     */
+    drain(options?: {
+        all?: boolean;
+    }): AiTraceSnapshot;
+    /** True while any step has started and not yet ended; useful in tests. */
+    get pending(): boolean;
+    private onStart;
+    private onStepStart;
+    /**
+     * The request as actually sent: after `prepareStep`, with the prepared tool
+     * definitions carrying their JSON schemas. This supersedes the step-start
+     * view, which predates per-step message compaction and tool filtering.
+     */
+    private onModelCallStart;
+    private onModelCallEnd;
+    private onStepEnd;
+    private onEnd;
+    private onError;
+    private newestOpen;
+    private closeStep;
+}
+/**
+ * Registers a recorder with the AI SDK. The SDK is an optional peer: when it
+ * is absent no model call can go through it, so there is nothing to record
+ * and the absence is not an error here.
+ */
+export declare function registerAiTraceRecorder(recorder: AiTraceRecorder, load: () => Promise<{
+    registerTelemetry: (...integrations: Telemetry[]) => void;
+}>): Promise<void>;
+/** Merges drained snapshots into one document; call order is arrival order. */
+export declare class AiTraceCollector {
+    private readonly runs;
+    private readonly steps;
+    merge(snapshot: AiTraceSnapshot): void;
+    /**
+     * The document to write. Workers drain in batches, so records are put back
+     * in start order: viewers read file order as time order.
+     */
+    document(): AiTraceDocument;
+    get size(): number;
+}
+/**
+ * JSON with binary payloads replaced by a size note. Image evidence travels
+ * as bytes in vision calls; the trace records that pixels were sent and how
+ * many, never the pixels, which keeps the file small and screenshot-free.
+ */
+export declare function stringify(value: unknown): string;
+//# sourceMappingURL=ai-trace.d.ts.map

package/dist/internal/ai-trace.d.ts.map

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