@e2edev/e2e 0.2.0

package/dist/agent/executor.d.ts

@@ -0,0 +1,238 @@
+/**
+ * The step-executor socket (RFC0001, layer 4).
+ *
+ * The harness owns each `agent.act()` step — observation, action dispatch,
+ * budgets, recording, and verdict mapping — and delegates only the thinking to
+ * a pluggable executor. Swapping executors changes the thinking, never safety,
+ * budgets, or the report.
+ *
+ * This module never imports the AI SDK: a hand-rolled executor with no AI SDK
+ * is a valid implementation. The AI-SDK golden path lives in
+ * `default-agent.ts` behind the same interface.
+ *
+ * Trust model: an executor is trusted project code, in the same trust domain
+ * as the config module that constructed it — it may hold its own model and
+ * credentials. What the harness enforces against it is not secrecy but
+ * accounting: budgets, deadlines, recording, and the verdict grammar hold no
+ * matter whose brain runs the step.
+ */
+import type { AgentErrorCode, JsonValue, ModelInstance, Platform, ScrollDirection, Secret } from '../types.ts';
+import { type AgentError } from './error.ts';
+export type { BlockedCategory } from './error.ts';
+export { blockedCategoryOf } from './error.ts';
+/**
+ * One step handed to an executor. `act` plans and executes a flow; `assert`
+ * judges a condition and must not change application state.
+ */
+export interface ExecutorStep {
+    readonly kind: 'act' | 'assert';
+    /** The natural-language instruction or assertion the test passed. */
+    readonly instruction: string;
+    /**
+     * JSON-safe call parameters. A `Secret` value in the caller's params is
+     * projected to `{ kind: 'secret', name, purpose }` — the plaintext never
+     * reaches the executor; it fills fields only through `actions.typeSecret`.
+     */
+    readonly params: Readonly<Record<string, JsonValue>> | undefined;
+    /** Secrets declared in the params, fillable via `actions.typeSecret`. */
+    readonly secrets: readonly {
+        readonly name: string;
+        readonly purpose: Secret['purpose'];
+    }[];
+}
+/** Redacted, size-bounded observation an executor may show its model. */
+export interface ExecutorObservation {
+    readonly revision: string;
+    /** One node per line as `#id role "name" ...`; already secret-redacted. */
+    readonly text: string;
+    readonly truncated: boolean;
+    readonly viewport: {
+        readonly width: number;
+        readonly height: number;
+        readonly scale: number;
+    };
+}
+/** A node named by its id from the newest observation, e.g. `{ id: 'n42' }`. */
+export interface ExecutorTarget {
+    readonly id: string;
+}
+/**
+ * The action grammar. Every executor action bottoms out here, where the
+ * harness enforces the deadline, the action budget, origin policy, and
+ * recording. Node ids are only valid against the newest observation; a stale
+ * id fails the action rather than acting on the wrong node. Actions and
+ * observations are serialized in call order: a call issued while another is
+ * in flight queues behind it and resolves its target against the newest
+ * observation, so concurrency can never soften the staleness rule. A
+ * committed mutation does not mint a new observation: ids from the newest
+ * observation stay addressable afterward (batching independent targets — a
+ * form fill — is legitimate), the backend rejects references it can no longer
+ * bind (`NODE_STALE`), and the mutation's effects are visible only through a
+ * fresh `observe()`.
+ */
+export interface ExecutorActions {
+    tap(target: ExecutorTarget): Promise<void>;
+    type(target: ExecutorTarget, value: string): Promise<void>;
+    /**
+     * Fills one secret declared in the step's params into a secure input. The
+     * harness authorizes the fill (registered credential, origin policy, an
+     * editable sink whose purpose matches) and hands the plaintext straight to
+     * the backend — it never passes through the executor or any model.
+     */
+    typeSecret(target: ExecutorTarget, name: string): Promise<void>;
+    press(target: ExecutorTarget, key: string): Promise<void>;
+    select(target: ExecutorTarget, value: string): Promise<void>;
+    scroll(direction: ScrollDirection, target?: ExecutorTarget): Promise<void>;
+    /** Navigates within the configured allowed origins. */
+    navigate(url: string): Promise<void>;
+}
+/** Usage detail of one executor-made model call, all fields optional. */
+export interface ExecutorModelCall {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly durationMs?: number;
+    readonly provider?: string;
+    readonly modelId?: string;
+    /** Billed cost of this call in USD, when the provider reports one. */
+    readonly estimatedCostUsd?: number;
+}
+/** Step budgets, read and reported by the executor, enforced by the harness. */
+export interface ExecutorBudgets {
+    readonly maxActions: number;
+    readonly maxModelCalls: number;
+    actionsUsed(): number;
+    remainingMs(): number;
+    /**
+     * Records one executor-made model call. Reported usage feeds the step
+     * metrics, the report's model provenance, and `--debug` accounting.
+     * Throws `STEP_BUDGET_EXHAUSTED` once the call count exceeds
+     * `maxModelCalls`: the budget is enforced, not advisory.
+     */
+    recordModelCall(usage?: ExecutorModelCall): void;
+    /**
+     * Records one executor tool call that did not go through `actions` — a
+     * project tool from `defineTool`. A mutating tool consumes an action-budget
+     * slot and may throw `STEP_BUDGET_EXHAUSTED`; every call is recorded as a
+     * step event, so extensions run the same accounting pipeline as the
+     * grammar.
+     */
+    recordToolCall(call: {
+        name: string;
+        mutates: boolean;
+        durationMs?: number;
+    }): void;
+}
+/**
+ * Why a cached replay stopped before finishing its trace. A closed union: the
+ * executor sees a reason token and prose summaries, never descriptors,
+ * outputs, or error objects.
+ */
+export type ReplayHandOffReason = 'gap' | 'target-not-found' | 'target-ambiguous' | 'action-failed' | 'action-uncertain' | 'end-mismatch';
+/**
+ * The mid-step hand-off from a diverged cache replay (RFC0001 layer 4). The
+ * replayed actions already ran against the live app under the same budgets
+ * and recording as the executor's own; the executor continues the step from
+ * the current application state and must not redo them.
+ */
+export interface ReplayedPrefix {
+    /** Prose summaries of the actions replay performed, in order. */
+    readonly replayedActions: readonly string[];
+    readonly totalActions: number;
+    readonly stopReason: ReplayHandOffReason;
+    /**
+     * Present exactly when `stopReason` is `action-uncertain`: the summary of a
+     * replayed action whose input may have reached the app even though it
+     * failed (spec 09, ACTION_MAY_HAVE_COMMITTED). The executor must verify the
+     * current state before re-attempting anything like it — repeating it blind
+     * would double-commit a mutation the runner promised not to repeat.
+     */
+    readonly uncertainAction?: string;
+}
+/** One verb of the action grammar. */
+export type ExecutorVerb = keyof ExecutorActions;
+export interface StepExecutorContext {
+    readonly step: ExecutorStep;
+    /**
+     * The target this step runs on. Tool packs scope themselves by its platform;
+     * `verbs` is the subset of the action grammar the backend declared, so an
+     * executor offers a model exactly the vocabulary the surface can honor.
+     */
+    readonly target: {
+        readonly name: string;
+        readonly platform: Platform;
+        readonly verbs: ReadonlySet<ExecutorVerb>;
+    };
+    /**
+     * Present when a cached replay ran part of this step before handing it
+     * over. Absent on a cache miss or when caching is off.
+     */
+    readonly replayedPrefix?: ReplayedPrefix;
+    /**
+     * Aborts when the test is cancelled, when the step deadline expires, or on
+     * any other hard stop. An executor must stop promptly on abort; the harness
+     * settles the step at the hard stop either way, so a late verdict from an
+     * executor that ignored the signal is never trusted over it.
+     */
+    readonly signal: AbortSignal;
+    /**
+     * The config-resolved AI SDK language model, when one is configured. An
+     * executor may ignore it and bring its own; a hand-rolled executor may use
+     * no model at all.
+     */
+    readonly model: ModelInstance | undefined;
+    /** Completed prior steps serialized for prompt context; `''` when none. */
+    readonly ledger: string;
+    /** Trusted project/test agent context (config `agent.context` + test). */
+    readonly agentContext: string | undefined;
+    readonly budgets: ExecutorBudgets;
+    /** Captures one fresh, redacted observation. */
+    observe(): Promise<ExecutorObservation>;
+    readonly actions: ExecutorActions;
+    /**
+     * Attaches the executor's model transcript to the step. Persisted as a
+     * `log` artifact when the run collects debug detail (`--debug`); a no-op
+     * otherwise. Call once, at conclusion.
+     */
+    attachTranscript(text: string): void;
+}
+export type StepVerdictStatus = 'passed' | 'failed' | 'blocked';
+/**
+ * The ternary step verdict. `failed` means the application did not behave as
+ * the step required. `blocked` means the environment, credentials, or the
+ * executor's own budget prevented a product verdict — it says nothing about
+ * the product, and it always carries a blockable error code.
+ */
+export interface StepVerdict {
+    readonly status: StepVerdictStatus;
+    readonly summary: string;
+    readonly errorCode?: AgentErrorCode;
+}
+/** The brain socket: one step in, one verdict out. */
+export interface StepExecutor {
+    readonly name: string;
+    readonly version?: string;
+    runStep(context: StepExecutorContext): Promise<StepVerdict>;
+}
+/**
+ * Codes only the runtime may assign. An executor can carry them (they reach
+ * it through hard-stop errors raised by the context) but can never invent
+ * them: the harness rejects a runtime code it did not itself record.
+ */
+export declare const RUNTIME_CODES: ReadonlySet<AgentErrorCode>;
+/**
+ * Whether an error is one of the runtime's own hard stops. Such an error is
+ * the step's truth wherever it lands — inside a tool call, a cache probe, a
+ * replayed action — and is surfaced untouched rather than absorbed as a
+ * divergence, a miss, or an action failure.
+ */
+export declare function isRuntimeHardStop(cause: unknown): cause is AgentError;
+/**
+ * Codes a `blocked` verdict may carry — every code the table assigns a
+ * blocked category: credentials, environment, seed data, or test setup have
+ * external owners; `automation` means the executor ran out of room.
+ * Everything else describes product behavior and belongs to `failed`.
+ */
+export declare const BLOCKABLE_CODES: ReadonlySet<AgentErrorCode>;
+/** Structural executor check, mirroring how model instances are detected. */
+export declare function isStepExecutor(value: unknown): value is StepExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/agent/executor.d.ts.map

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

package/dist/agent/executor.js

@@ -0,0 +1,56 @@
+/**
+ * The step-executor socket (RFC0001, layer 4).
+ *
+ * The harness owns each `agent.act()` step — observation, action dispatch,
+ * budgets, recording, and verdict mapping — and delegates only the thinking to
+ * a pluggable executor. Swapping executors changes the thinking, never safety,
+ * budgets, or the report.
+ *
+ * This module never imports the AI SDK: a hand-rolled executor with no AI SDK
+ * is a valid implementation. The AI-SDK golden path lives in
+ * `default-agent.ts` behind the same interface.
+ *
+ * Trust model: an executor is trusted project code, in the same trust domain
+ * as the config module that constructed it — it may hold its own model and
+ * credentials. What the harness enforces against it is not secrecy but
+ * accounting: budgets, deadlines, recording, and the verdict grammar hold no
+ * matter whose brain runs the step.
+ */
+import { AGENT_CODE_TABLE, isAgentError } from './error.js';
+export { blockedCategoryOf } from './error.js';
+/**
+ * Codes only the runtime may assign. An executor can carry them (they reach
+ * it through hard-stop errors raised by the context) but can never invent
+ * them: the harness rejects a runtime code it did not itself record.
+ */
+export const RUNTIME_CODES = new Set([
+    'STEP_BUDGET_EXHAUSTED',
+    'STEP_TIMEOUT',
+    'CANCELLED',
+]);
+/**
+ * Whether an error is one of the runtime's own hard stops. Such an error is
+ * the step's truth wherever it lands — inside a tool call, a cache probe, a
+ * replayed action — and is surfaced untouched rather than absorbed as a
+ * divergence, a miss, or an action failure.
+ */
+export function isRuntimeHardStop(cause) {
+    return isAgentError(cause) && RUNTIME_CODES.has(cause.code);
+}
+/**
+ * Codes a `blocked` verdict may carry — every code the table assigns a
+ * blocked category: credentials, environment, seed data, or test setup have
+ * external owners; `automation` means the executor ran out of room.
+ * Everything else describes product behavior and belongs to `failed`.
+ */
+export const BLOCKABLE_CODES = new Set(Object.keys(AGENT_CODE_TABLE).filter((code) => AGENT_CODE_TABLE[code].blockedCategory !== undefined));
+/** Structural executor check, mirroring how model instances are detected. */
+export function isStepExecutor(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate['name'] === 'string' &&
+        candidate['name'] !== '' &&
+        typeof candidate['runStep'] === 'function');
+}
+//# sourceMappingURL=executor.js.map

package/dist/agent/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/agent/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA2M/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgC,IAAI,GAAG,CAAiB;IAChF,uBAAuB;IACvB,cAAc;IACd,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgC,IAAI,GAAG,CAChE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAsB,CAAC,MAAM,CACxD,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS,CAC/D,CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,CACL,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,QAAQ;QACrC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE;QACxB,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,UAAU,CAC3C,CAAC;AACJ,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The `agent` fixture (spec 02-test-api.md).
+ *
+ * Two tiers, deliberately few methods. `act` plans and executes a flow on the
+ * executor socket; `assert`, `waitFor`, and `extract` are the judgment tier —
+ * each one bounded invocation with a fresh observation, an explicit deadline,
+ * and a model-call budget. The located action verbs of v1 were retired: an
+ * action either has an exact deterministic address (`screen.*`) or it is part
+ * of a planned flow (`agent.act`), and one cache design serves the latter.
+ */
+import type { Agent } from '../types.ts';
+import { type AgentContext } from './invocation.ts';
+/** Builds the agent fixture for one attempt. */
+export declare function createAgentFixture(runtime: AgentContext): Agent;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAgC,MAAM,aAAa,CAAC;AAKvE,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AAqBzB,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CA6M/D"}

package/dist/agent/index.js

@@ -0,0 +1,304 @@
+/**
+ * The `agent` fixture (spec 02-test-api.md).
+ *
+ * Two tiers, deliberately few methods. `act` plans and executes a flow on the
+ * executor socket; `assert`, `waitFor`, and `extract` are the judgment tier —
+ * each one bounded invocation with a fresh observation, an explicit deadline,
+ * and a model-call budget. The located action verbs of v1 were retired: an
+ * action either has an exact deterministic address (`screen.*`) or it is part
+ * of a planned flow (`agent.act`), and one cache design serves the latter.
+ */
+import { isVisionMode } from '../config/agent.js';
+import { TestError } from '../internal/errors.js';
+import { sleep } from '../internal/time.js';
+import { AgentError, isAgentError, toAgentError } from './error.js';
+import { resolveBoundedBudget, resolveTimeout } from './call-options.js';
+import { runActStep, runAssertStep } from './act.js';
+import { observationShape } from './observation.js';
+import { Invocation, } from './invocation.js';
+import { acceptAnyJson, JUDGMENT_SCHEMA, validateJudgmentResponse } from './protocol.js';
+import { EXTRACT_REQUEST, JUDGMENT_REQUEST } from './prompts.js';
+import { deriveJsonSchema } from './model/schema.js';
+const MIN_STEP_TIMEOUT_MS = 30_000;
+const DEFAULT_WAIT_INTERVAL_MS = 3_000;
+/**
+ * How often `waitFor` looks at the screen between judgments.
+ *
+ * An observation is backend-only work, so it is far cheaper than a model call —
+ * but it is not free: it walks the document and swaps the session's reference
+ * generation, which invalidates any node reference taken from the previous one.
+ * That is safe here because a judgment reads only the observation text, and it
+ * is the reason this interval is not shorter.
+ */
+const CHANGE_POLL_MS = 500;
+const EXTRACT_MODEL_CALLS = 2;
+/** Builds the agent fixture for one attempt. */
+export function createAgentFixture(runtime) {
+    /**
+     * Default budget for polling, judgment, and extraction steps: the action
+     * timeout expresses the suite's model-latency headroom in one place, with a
+     * 30 s floor (spec 02-test-api.md). Tests then rarely need per-call
+     * timeouts.
+     */
+    const stepTimeout = Math.max(MIN_STEP_TIMEOUT_MS, runtime.config.actionTimeout);
+    /** A per-call `vision` value always wins over the project default. */
+    const resolveVision = (requested) => {
+        if (requested === undefined)
+            return runtime.config.agent.vision;
+        if (!isVisionMode(requested)) {
+            throw new TestError('INVALID_ARGUMENT', "vision must be true, false, 'fallback', or 'only'");
+        }
+        return requested;
+    };
+    /**
+     * Runs one agent method as a top-level step carrying agent metrics. A
+     * judgment (`assert`, `waitFor`) is a verification step: its passing is what
+     * confirms the action traces staged before it (cache/context.ts).
+     */
+    const step = async (options, label, body, stepOptions = {}) => runtime.steps.run('agent', options.api, label, async () => {
+        const invocation = new Invocation(runtime, { ...options, label });
+        try {
+            return await body(invocation);
+        }
+        catch (cause) {
+            throw toAgentError(cause);
+        }
+        finally {
+            invocation.finish();
+        }
+    }, stepOptions);
+    /** One judgment call against a fresh observation. */
+    const askJudgment = (invocation, instruction, observation) => invocation.ask({
+        schemaName: 'agent-judgment-1',
+        schema: JUDGMENT_SCHEMA,
+        validate: validateJudgmentResponse,
+        prompt: { request: JUDGMENT_REQUEST, instruction, observation },
+    });
+    const agent = {
+        act: ((instruction, params, options) => runActStep(runtime, instruction, params, options)),
+        waitFor(condition, options) {
+            const intervalMs = validateInterval(options?.intervalMs);
+            return step({
+                api: 'agent.waitFor',
+                task: 'judge whether a condition holds',
+                timeoutMs: resolveTimeout(options?.timeout, stepTimeout),
+                maxModelCalls: resolveBoundedBudget(options?.maxModelCalls, runtime.config.agent.maxModelCalls, 'maxModelCalls'),
+                vision: resolveVision(options?.vision),
+            }, condition, async (invocation) => {
+                let observation = await invocation.observe();
+                for (let round = 1;; round += 1) {
+                    invocation.recordPoll('waitFor', round);
+                    const judgment = await askJudgment(invocation, condition, observation);
+                    invocation.note({ explanation: judgment.explanation });
+                    if (judgment.result)
+                        return;
+                    observation = await waitForNextJudgment(invocation, {
+                        since: observation,
+                        intervalMs,
+                        lastExplanation: judgment.explanation,
+                        signal: runtime.signal,
+                    });
+                }
+            }, { verifies: true });
+        },
+        extract(instruction, options) {
+            requireStandardSchema(options.schema);
+            const schema = options.schema;
+            return step({
+                api: 'agent.extract',
+                task: 'extract structured data from the observation',
+                timeoutMs: resolveTimeout(options.timeout, stepTimeout),
+                maxModelCalls: resolveBoundedBudget(options.maxModelCalls, EXTRACT_MODEL_CALLS, 'maxModelCalls'),
+                vision: resolveVision(options.vision),
+            }, instruction, async (invocation) => {
+                // A projection of the caller's schema lets the provider enforce the
+                // shape; without one the repair loop is the only shape signal.
+                const projected = await deriveJsonSchema(schema);
+                const observation = await invocation.observe();
+                let repair;
+                for (;;) {
+                    const candidate = await invocation.ask({
+                        schemaName: 'agent-extract-1',
+                        schema: projected,
+                        validate: acceptAnyJson,
+                        prompt: {
+                            request: EXTRACT_REQUEST,
+                            instruction,
+                            observation,
+                            ...(repair === undefined ? {} : { repair }),
+                        },
+                    });
+                    const validation = await schema['~standard'].validate(candidate);
+                    if (validation.issues === undefined)
+                        return validation.value;
+                    const issue = validation.issues.map(describeIssue).join('; ');
+                    invocation.recordSchemaRejection('agent-extract-1');
+                    if (!invocation.canAsk()) {
+                        throw new AgentError('MODEL_OUTPUT_INVALID', `extracted data failed schema validation: ${issue}`);
+                    }
+                    repair = {
+                        issue,
+                        rawText: safeJson(candidate),
+                        requiredFields: requiredFields(validation.issues),
+                    };
+                }
+            });
+        },
+        assert(assertion, options) {
+            // A custom executor judges assertions through the socket: swapping
+            // brains swaps all the thinking. The built-in path keeps the optimized
+            // single-judgment tier below (one model call, vision-capable).
+            if (runtime.customExecutor) {
+                return runAssertStep(runtime, assertion, options);
+            }
+            return step({
+                api: 'agent.assert',
+                task: 'judge whether an assertion holds',
+                timeoutMs: resolveTimeout(options?.timeout, stepTimeout),
+                maxModelCalls: 1,
+                vision: resolveVision(options?.vision),
+            }, assertion, async (invocation) => {
+                const observation = await invocation.observe();
+                const judgment = await askJudgment(invocation, assertion, observation);
+                invocation.note({ explanation: judgment.explanation });
+                // Spec 03-assertions.md: the report keeps the redacted screenshot
+                // whenever `screenshot` allows it, on a passing judgment too.
+                const screenshot = evidenceAllowed(invocation, options?.screenshot)
+                    ? await captureEvidence(invocation)
+                    : undefined;
+                if (judgment.result)
+                    return;
+                throw new AgentError('ASSERTION_FAILED', judgment.explanation, (screenshot === undefined ? {} : { screenshot }));
+            }, { verifies: true });
+        },
+    };
+    /**
+     * Whether judgment evidence may be captured. Pixel evidence is omitted for
+     * the rest of the attempt once any secret has been filled: an untrusted app
+     * may mirror a secret anywhere on screen, so rectangle masking cannot prove
+     * redaction. The denial is recorded whether or not a capture follows.
+     */
+    function evidenceAllowed(invocation, requested) {
+        if (requested === false)
+            return false;
+        if (runtime.taint.value) {
+            invocation.recordPolicy('assert.screenshot', 'denied', 'PIXEL_TAINTED');
+            return false;
+        }
+        return true;
+    }
+    /** Captures redacted judgment evidence; best-effort, never fails the step. */
+    async function captureEvidence(invocation) {
+        try {
+            const relative = await invocation.session.artifacts.screenshot('assert', invocation.operation());
+            runtime.steps.attachArtifact(runtime.artifacts.register('screenshot', relative));
+            return relative;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return agent;
+}
+/**
+ * Waits until the next judgment is worth spending, and returns the observation
+ * to spend it on.
+ *
+ * A judgment reads the observation and nothing else, so while the screen looks the
+ * same the answer is the same and re-asking is a model call that can only repeat
+ * itself. So a false judgment is followed by backend-only observations until the
+ * screen actually changes, which is also what makes a condition that came true two
+ * seconds ago cost two seconds rather than a full interval.
+ *
+ * `intervalMs` stays the rate limit it always was: at most one judgment per
+ * interval, so a screen that changes continuously — a spinner, a countdown —
+ * cannot spend the budget in a second.
+ *
+ * A vision call waits on the interval alone. An animation the tree cannot see is
+ * still a real change, so there is nothing to compare and nothing to gain.
+ *
+ * Throws rather than returning on exhaustion, and checks before every
+ * observation, so a timeout reports the caller's last judgment instead of a bare
+ * deadline error.
+ */
+async function waitForNextJudgment(invocation, options) {
+    const watchTree = !invocation.pixelTier;
+    const tickMs = Math.min(options.intervalMs, CHANGE_POLL_MS);
+    const judgedAt = Date.now();
+    const judgedShape = observationShape(options.since);
+    const timedOut = (cause) => new AgentError('STEP_TIMEOUT', `waitFor timed out; last judgment: ${options.lastExplanation}`, cause === undefined ? {} : { cause });
+    for (;;) {
+        if (invocation.deadline.expired())
+            throw timedOut();
+        if (!invocation.canAsk()) {
+            throw new AgentError('STEP_BUDGET_EXHAUSTED', `waitFor exhausted its model-call budget; last judgment: ${options.lastExplanation}`);
+        }
+        // Nothing is judged before the interval elapses, so nothing is observed
+        // before it either: the first wait covers what remains of the interval,
+        // and only then does the loop poll the tree at the change cadence.
+        const untilInterval = options.intervalMs - (Date.now() - judgedAt);
+        const wait = untilInterval > 0 ? untilInterval : tickMs;
+        const remainder = Math.min(wait, invocation.deadline.remaining());
+        if (remainder > 0)
+            await sleep(remainder, options.signal);
+        // An observation can outlive the deadline it was bounded by, and the bare
+        // timeout it then reports would drop the judgment the author needs. The
+        // wait owns that message whether the clock runs out between rounds or
+        // during one.
+        const observation = await invocation.observe().catch((cause) => {
+            if (isAgentError(cause) && cause.code === 'STEP_TIMEOUT')
+                throw timedOut(cause);
+            throw cause;
+        });
+        if (Date.now() - judgedAt < options.intervalMs)
+            continue;
+        if (!watchTree || observationShape(observation) !== judgedShape)
+            return observation;
+    }
+}
+function validateInterval(intervalMs) {
+    const value = intervalMs ?? DEFAULT_WAIT_INTERVAL_MS;
+    if (!Number.isInteger(value) || value < 100 || value > 60_000) {
+        throw new TestError('INVALID_ARGUMENT', `intervalMs must be an integer from 100 through 60000, got ${String(intervalMs)}`);
+    }
+    return value;
+}
+function requireStandardSchema(schema) {
+    const props = schema?.['~standard'];
+    if (props === undefined || props.version !== 1 || typeof props.validate !== 'function') {
+        throw new TestError('INVALID_ARGUMENT', 'schema must implement Standard Schema v1');
+    }
+}
+/**
+ * Top-level fields the caller's schema requires, derived from issue paths. This
+ * is the only shape signal Standard Schema exposes, and it is what lets one
+ * repair attempt converge.
+ */
+function requiredFields(issues) {
+    const fields = new Set();
+    for (const issue of issues) {
+        const first = issue.path?.[0];
+        if (first === undefined)
+            continue;
+        const key = typeof first === 'object' ? first.key : first;
+        if (typeof key === 'string')
+            fields.add(key);
+    }
+    return [...fields];
+}
+/** Serializes a rejected value for the repair prompt without throwing. */
+function safeJson(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function describeIssue(issue) {
+    const fieldPath = (issue.path ?? [])
+        .map((segment) => (typeof segment === 'object' ? String(segment.key) : String(segment)))
+        .join('.');
+    return fieldPath === '' ? issue.message : `${fieldPath}: ${issue.message}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

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