e2e 0.15.2 → 0.16.0

package/dist/.build.json

@@ -1 +1 @@
-{"version":"0.15.2"}
+{"version":"0.16.0"}

package/dist/agent/act-validation.d.ts

@@ -35,6 +35,15 @@ export declare function validateParams(params: AgentParams | undefined): {
     secrets: ReadonlyMap<string, Secret>;
     templates: readonly ParamTemplate[];
 };
+/**
+ * Projected params with `redact` applied to every string in them, object
+ * keys included, and their `unique()` templates moved with their leaves: a
+ * template's pointer follows the redacted keys and its value is redacted as
+ * the leaf is, so the trace cache slots what the params hold.
+ */
+export declare function redactParams(params: Readonly<Record<string, JsonValue>>, templates: readonly ParamTemplate[], redact: (text: string) => string): {
+    params: Readonly<Record<string, JsonValue>>;
+    templates: readonly ParamTemplate[];
+};
 /** Closes the verdict grammar: the executor cannot invent statuses or codes. */
 export declare function validateVerdict(verdict: unknown, executorName: string): StepVerdict;
-//# sourceMappingURL=act-validation.d.ts.map

package/dist/agent/act-validation.js

@@ -90,6 +90,54 @@ export function validateParams(params) {
         templates: found.templates,
     };
 }
+/**
+ * Projected params with `redact` applied to every string in them, object
+ * keys included, and their `unique()` templates moved with their leaves: a
+ * template's pointer follows the redacted keys and its value is redacted as
+ * the leaf is, so the trace cache slots what the params hold.
+ */
+export function redactParams(params, templates, redact) {
+    const pointers = new Map();
+    const redacted = redactJson(params, redact, { from: '', to: '' }, pointers);
+    return {
+        params: redacted,
+        templates: templates.map((template) => ({
+            pointer: pointers.get(template.pointer) ?? template.pointer,
+            value: redact(template.value),
+        })),
+    };
+}
+/**
+ * `value` with `redact` applied to every string in it, object keys included.
+ * Records in `pointers` where each node's pointer (`at.from`) lands once its
+ * keys are redacted (`at.to`). Two keys of one object that redact alike would
+ * leave one value standing for both, so that is `INVALID_ARGUMENT`.
+ */
+function redactJson(value, redact, at, pointers) {
+    pointers.set(at.from, at.to);
+    if (typeof value === 'string')
+        return redact(value);
+    if (Array.isArray(value)) {
+        return value.map((entry, index) => redactJson(entry, redact, { from: paramPointer(at.from, index), to: paramPointer(at.to, index) }, pointers));
+    }
+    if (typeof value !== 'object' || value === null)
+        return value;
+    const out = {};
+    for (const [key, entry] of Object.entries(value)) {
+        const clean = redact(key);
+        if (Object.hasOwn(out, clean)) {
+            throw new TestError('INVALID_ARGUMENT', `agent.act params has two keys that read ${JSON.stringify(clean)} once secret values are redacted; a key cannot be told apart by a secret`);
+        }
+        // Defined, not assigned, so a `__proto__` key stays an own property.
+        Object.defineProperty(out, clean, {
+            value: redactJson(entry, redact, { from: paramPointer(at.from, key), to: paramPointer(at.to, clean) }, pointers),
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+    }
+    return out;
+}
 /** Replaces every Secret leaf with its placeholder and every Unique leaf with its value, collecting both. */
 function projectParams(value, pointer, found, seen) {
     if (isSecret(value)) {
@@ -146,4 +194,3 @@ export function validateVerdict(verdict, executorName) {
         ...(code === undefined ? {} : { errorCode: code }),
     };
 }
-//# sourceMappingURL=act-validation.js.map

package/dist/agent/act.d.ts

@@ -66,5 +66,4 @@ export declare function runAssertStep(runtime: AgentContext, assertion: string,
  * passing is what confirms the traces staged before it at attempt end
  * (cache/context.ts).
  */
-export declare function dispatchAgentStep(runtime: AgentContext, spec: DispatchSpec, agent?: DispatchAgent): Promise<ActResult>;
-//# sourceMappingURL=act.d.ts.map
+export declare function dispatchAgentStep(runtime: AgentContext, raw: DispatchSpec, agent?: DispatchAgent): Promise<ActResult>;

package/dist/agent/act.js

@@ -21,7 +21,7 @@ import { join } from 'node:path';
 import { ConfigurationError } from '../internal/errors.js';
 import { withAbort, withTimeout } from '../internal/time.js';
 import { AgentError, CATEGORY_BY_CODE, toAgentError } from './error.js';
-import { validateActOptions, validateInstruction, validateParams, validateVerdict } from './act-validation.js';
+import { redactParams, validateActOptions, validateInstruction, validateParams, validateVerdict } from './act-validation.js';
 import { ActionDispatcher } from './action-dispatcher.js';
 import { resolveBoundedBudget, resolveTimeout } from './call-options.js';
 import { RUNTIME_CODES } from './executor.js';
@@ -88,12 +88,16 @@ export async function runAssertStep(runtime, assertion, options) {
  * passing is what confirms the traces staged before it at attempt end
  * (cache/context.ts).
  */
-export async function dispatchAgentStep(runtime, spec, 
+export async function dispatchAgentStep(runtime, raw, 
 // Resolved before the step opens, so an unknown name fails the call, not a
 // recorded step, and the step carries the agent it ran with.
-agent = runtime.select(spec.agent)) {
+agent = runtime.select(raw.agent)) {
+    const spec = redactSpec(raw, runtime.redact);
+    // Redacted per step, not once per agent: the ledger is live, so a value
+    // resolved since the agent was selected is covered too.
+    const context = agent.agentContext === undefined ? undefined : runtime.redact(agent.agentContext);
     return runtime.steps.run('agent', spec.api, spec.instruction, async () => {
-        const dispatch = new ActDispatch(runtime, spec, agent);
+        const dispatch = new ActDispatch(runtime, spec, { ...agent, agentContext: context });
         try {
             let verdict;
             try {
@@ -116,6 +120,20 @@ agent = runtime.select(spec.agent)) {
         }
     }, { verifies: spec.kind === 'assert', agent: agent.name });
 }
+/**
+ * The spec with every registered secret value the test spelled into the
+ * instruction or a param string (a key or a leaf) rewritten to its marker,
+ * before anything reads it: the executor, its model, the step label, the
+ * trace cache, and the prior-step ledger all see the same redacted step. A
+ * `Secret` handle is already a placeholder here and stays fillable through
+ * `typeSecret`.
+ */
+function redactSpec(spec, redact) {
+    const instruction = redact(spec.instruction);
+    if (spec.params === undefined)
+        return { ...spec, instruction };
+    return { ...spec, instruction, ...redactParams(spec.params, spec.templates, redact) };
+}
 /** One step's wiring: the collaborators, the executor's context, and the verdict mapping. */
 class ActDispatch {
     runtime;
@@ -465,4 +483,3 @@ function screenOf(observation) {
         ? { ...metadata, kind: 'semantic', nodes: observation.nodes }
         : { ...metadata, kind: 'pixels' };
 }
-//# sourceMappingURL=act.js.map

package/dist/agent/action-dispatcher.d.ts

@@ -184,4 +184,3 @@ export declare class ActionDispatcher {
     /** The seam a policy records its decisions through, onto this step's events. */
     private policyHost;
 }
-//# sourceMappingURL=action-dispatcher.d.ts.map

package/dist/agent/action-dispatcher.js

@@ -598,4 +598,3 @@ function isInViewport(rect, viewport) {
         return true;
     return rect.x < viewport.width && rect.y < viewport.height && rect.x + rect.width > 0 && rect.y + rect.height > 0;
 }
-//# sourceMappingURL=action-dispatcher.js.map

package/dist/agent/action-names.d.ts

@@ -25,4 +25,3 @@ export declare const HARNESS_TOOL_NAMES: ReadonlyMap<string, string>;
  * take one: it would be silently shadowed on one engine and live on another.
  */
 export declare const GRAMMAR_TOOL_NAMES: ReadonlySet<string>;
-//# sourceMappingURL=action-names.d.ts.map

package/dist/agent/action-names.js

@@ -78,4 +78,3 @@ export const GRAMMAR_TOOL_NAMES = new Set([
     'select_at',
     'dismiss_keyboard',
 ]);
-//# sourceMappingURL=action-names.js.map

package/dist/agent/actions.d.ts

@@ -134,4 +134,3 @@ export declare function describeAction(action: RecordableAction, redact: (text:
  * node is named, not what it contains.
  */
 export declare function describeTarget(node: SemanticNode, redact: (text: string) => string): TraceTargetDescriptor | undefined;
-//# sourceMappingURL=actions.d.ts.map

package/dist/agent/actions.js

@@ -193,4 +193,3 @@ function describeWhere(target) {
 function quote(value) {
     return JSON.stringify(bound(value, 40));
 }
-//# sourceMappingURL=actions.js.map

package/dist/agent/agent-brand.d.ts

@@ -11,4 +11,3 @@ export declare const BUILT_IN_AGENT: {
     readonly name: 'e2e-default-agent';
     readonly version: '2';
 };
-//# sourceMappingURL=agent-brand.d.ts.map

package/dist/agent/agent-brand.js

@@ -8,4 +8,3 @@
  * valid whatever options an agents entry sets.
  */
 export const BUILT_IN_AGENT = { name: 'e2e-default-agent', version: '2' };
-//# sourceMappingURL=agent-brand.js.map

package/dist/agent/ai-sdk.d.ts

@@ -19,9 +19,15 @@ export type SdkLanguageModel = Exclude<LanguageModel, string>;
 export declare function asSdkLanguageModel(instance: ModelInstance): SdkLanguageModel;
 /** Loads and caches the AI SDK, or fails with MODEL_UNAVAILABLE. */
 export declare function loadAiSdk(): Promise<AiSdk>;
+/**
+ * The SDK when the optional peer is installed, else undefined: for the seams
+ * that have a way to do their job without it.
+ */
+export declare function loadAiSdkIfInstalled(): Promise<AiSdk | undefined>;
+/** The SDK when an earlier call loaded it, else undefined; never loads it. */
+export declare function loadedAiSdk(): AiSdk | undefined;
 /**
  * The already-loaded SDK, for the few synchronous seams (error-class checks)
  * that run strictly after an async caller primed the cache.
  */
 export declare function aiSdk(): AiSdk;
-//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/agent/ai-sdk.js

@@ -53,6 +53,17 @@ export async function loadAiSdk() {
         throw missing(state.failure);
     }
 }
+/**
+ * The SDK when the optional peer is installed, else undefined: for the seams
+ * that have a way to do their job without it.
+ */
+export async function loadAiSdkIfInstalled() {
+    return loadAiSdk().catch(() => undefined);
+}
+/** The SDK when an earlier call loaded it, else undefined; never loads it. */
+export function loadedAiSdk() {
+    return cache().loaded;
+}
 /**
  * The already-loaded SDK, for the few synchronous seams (error-class checks)
  * that run strictly after an async caller primed the cache.
@@ -69,4 +80,3 @@ function missing(cause) {
         'peer dependency ai@^7 — install it, or configure an agent that brings ' +
         'its own model transport', { cause });
 }
-//# sourceMappingURL=ai-sdk.js.map

package/dist/agent/call-options.d.ts

@@ -7,4 +7,3 @@
 export declare function resolveTimeout(requested: number | undefined, fallback: number): number;
 /** Resolves a per-call budget override, capped at the configured limit. */
 export declare function resolveBoundedBudget(requested: number | undefined, limit: number, label: string): number;
-//# sourceMappingURL=call-options.d.ts.map

package/dist/agent/call-options.js

@@ -25,4 +25,3 @@ export function resolveBoundedBudget(requested, limit, label) {
     }
     return requested;
 }
-//# sourceMappingURL=call-options.js.map

package/dist/agent/default-agent.d.ts

@@ -28,4 +28,3 @@ export declare function createBuiltInAgent(options?: BuiltInAgentOptions): StepE
  * and a host outside the loop reports them its own way.
  */
 export declare function projectTools(context: StepExecutorContext, tools: Readonly<Record<string, AgentTool>>): ToolSet;
-//# sourceMappingURL=default-agent.d.ts.map

package/dist/agent/default-agent.js

@@ -170,4 +170,3 @@ function guardedTools(helpers, tools) {
     }
     return guarded;
 }
-//# sourceMappingURL=default-agent.js.map

package/dist/agent/derived.d.ts

@@ -57,4 +57,3 @@ export interface StepEvidence {
  * the model composed itself.
  */
 export declare function derivedReason(value: string, instruction: string, params: Readonly<Record<string, JsonValue>> | undefined, evidence?: StepEvidence): DerivedReason | undefined;
-//# sourceMappingURL=derived.d.ts.map

package/dist/agent/derived.js

@@ -125,4 +125,3 @@ function paramStrings(params) {
 function normalize(text) {
     return text.toLowerCase().replace(/\s+/g, ' ').trim();
 }
-//# sourceMappingURL=derived.js.map

package/dist/agent/error.d.ts

@@ -64,4 +64,3 @@ export declare function toAgentError(cause: unknown): AgentError;
  * keep honest names and `instanceof` never spans realms.
  */
 export declare function isAgentError(value: unknown): value is AgentError;
-//# sourceMappingURL=error.d.ts.map

package/dist/agent/error.js

@@ -118,4 +118,3 @@ export function isAgentError(value) {
         typeof value.code === 'string' &&
         value.code in CATEGORY_BY_CODE);
 }
-//# sourceMappingURL=error.js.map

package/dist/agent/executor.d.ts

@@ -495,4 +495,3 @@ export declare function isRuntimeHardStop(cause: unknown): cause is AgentError;
 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.js

@@ -52,4 +52,3 @@ export function isStepExecutor(value) {
         candidate['name'] !== '' &&
         typeof candidate['runStep'] === 'function');
 }
-//# sourceMappingURL=executor.js.map

package/dist/agent/index.d.ts

@@ -12,4 +12,3 @@ 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.js

@@ -350,4 +350,3 @@ function safeJson(value) {
         return undefined;
     }
 }
-//# sourceMappingURL=index.js.map

package/dist/agent/interactive-step.d.ts

@@ -35,4 +35,3 @@ export interface InteractiveStep {
  * never resolved and the budgets a model loop needs do not apply.
  */
 export declare function openInteractiveStep(runtime: AgentContext, options: InteractiveStepOptions): Promise<InteractiveStep>;
-//# sourceMappingURL=interactive-step.d.ts.map

package/dist/agent/interactive-step.js

@@ -129,4 +129,3 @@ class HostExecutor {
             job.settle({ error: reason });
     }
 }
-//# sourceMappingURL=interactive-step.js.map

package/dist/agent/invocation.d.ts

@@ -210,4 +210,3 @@ export declare class Invocation {
     private modelInfo;
     private consumeModelCall;
 }
-//# sourceMappingURL=invocation.d.ts.map

package/dist/agent/invocation.js

@@ -53,7 +53,7 @@ export class Invocation {
         this.agent = runtime.select(options.agent);
         this.deadline = runtime.engine.deadline(options.timeoutMs);
         this.pixelTier = options.vision === true || options.vision === 'only';
-        this.system = buildSystem(options.task, this.agent.agentContext);
+        this.system = runtime.redact(buildSystem(options.task, this.agent.agentContext));
         this.systemBytes = tokenUpperBound(this.system);
     }
     get session() {
@@ -179,11 +179,17 @@ export class Invocation {
         for (;;) {
             this.checkDeadline();
             this.consumeModelCall();
-            const prompt = buildPrompt({
+            // The observation is redacted already; the instruction is the test's
+            // own text, which may spell out a registered value. The repair's raw
+            // text is redacted before the prompt cuts it, so the cut never splits a
+            // value into a fragment whole-value matching would miss.
+            const prompt = this.runtime.redact(buildPrompt({
                 ...request.prompt,
                 ...(this.treeWithheld ? { withholdTree: true } : {}),
-                ...(repair === undefined ? {} : { repair }),
-            });
+                ...(repair === undefined
+                    ? {}
+                    : { repair: { ...repair, rawText: repair.rawText === undefined ? undefined : this.runtime.redact(repair.rawText) } }),
+            }));
             // Pixels travel with the observation they were captured for, so the
             // image and the tree in one request always describe one revision.
             const images = imagesFor(request.prompt.observation);
@@ -322,4 +328,3 @@ function imagesFor(observation) {
         },
     ];
 }
-//# sourceMappingURL=invocation.js.map

package/dist/agent/ledger.d.ts

@@ -36,4 +36,3 @@ export interface LedgerContext {
  * handoff to the ledger's own line budget.
  */
 export declare function serializeLedger(steps: readonly PriorStep[], maxBytes: number): LedgerContext;
-//# sourceMappingURL=ledger.d.ts.map

package/dist/agent/ledger.js

@@ -72,4 +72,3 @@ function formatEntry(step, position) {
     const handoff = truncateUtf8(step.explanation, MAX_HANDOFF_BYTES);
     return `${head}\n   observed: ${handoff}`;
 }
-//# sourceMappingURL=ledger.js.map

package/dist/agent/loop-guards.d.ts

@@ -84,4 +84,3 @@ export declare function isFailedResult(toolName: string, text: string): boolean;
  * that the last id was. Warns first, then forces the conclusion.
  */
 export declare function checkFailureStreak(results: readonly GuardToolResult[], thresholds?: LoopGuardThresholds): LoopGuardVerdict;
-//# sourceMappingURL=loop-guards.d.ts.map

package/dist/agent/loop-guards.js

@@ -184,4 +184,3 @@ export function checkFailureStreak(results, thresholds = DEFAULT_LOOP_GUARD_THRE
     }
     return { kind: 'clear' };
 }
-//# sourceMappingURL=loop-guards.js.map

package/dist/agent/model/adapter.d.ts

@@ -102,4 +102,3 @@ export declare function imageTokenUpperBound(image: {
     width: number;
     height: number;
 }): number;
-//# sourceMappingURL=adapter.d.ts.map

package/dist/agent/model/adapter.js

@@ -37,4 +37,3 @@ export function imageTokenUpperBound(image) {
     return (Math.ceil(Math.max(1, image.width) / IMAGE_TILE_PX) *
         Math.ceil(Math.max(1, image.height) / IMAGE_TILE_PX));
 }
-//# sourceMappingURL=adapter.js.map

package/dist/agent/model/overflow.d.ts

@@ -17,4 +17,3 @@
  * provider's words.
  */
 export declare function isContextOverflow(error: unknown): boolean;
-//# sourceMappingURL=overflow.d.ts.map

package/dist/agent/model/overflow.js

@@ -79,4 +79,3 @@ function describesOverflow(error) {
         OVERFLOW_PATTERNS.some((pattern) => pattern.test(text)) &&
         !NON_OVERFLOW_PATTERNS.some((pattern) => pattern.test(text)));
 }
-//# sourceMappingURL=overflow.js.map

package/dist/agent/model/provider-hints.d.ts

@@ -43,4 +43,3 @@ export interface ProviderHints {
 export declare function providerHints(model: ProviderModelRef | undefined): ProviderHints;
 /** A stable key for one system prompt, so every call sharing the prefix routes alike. */
 export declare function promptCacheKey(system: string): string;
-//# sourceMappingURL=provider-hints.d.ts.map

package/dist/agent/model/provider-hints.js

@@ -85,4 +85,3 @@ function withoutBreakpoint(message) {
     }
     return { ...message, providerOptions };
 }
-//# sourceMappingURL=provider-hints.js.map

package/dist/agent/model/schema.d.ts

@@ -17,4 +17,3 @@ import type { JSONSchema7 } from 'ai';
 import type { StandardSchemaV1 } from '../../types.ts';
 /** The caller schema's shape as JSON Schema, or undefined when it has no usable projection. */
 export declare function deriveJsonSchema(schema: StandardSchemaV1): Promise<JSONSchema7 | undefined>;
-//# sourceMappingURL=schema.d.ts.map

package/dist/agent/model/schema.js

@@ -80,4 +80,3 @@ function refinesOnly(member, type) {
 function isSchemaObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
-//# sourceMappingURL=schema.js.map

package/dist/agent/model/sdk.d.ts

@@ -72,4 +72,3 @@ export declare function failureHint(cause: unknown): string;
  * the SDK to be loaded, which every caller has done by the time a call failed.
  */
 export declare function isAbort(cause: unknown): boolean;
-//# sourceMappingURL=sdk.d.ts.map

package/dist/agent/model/sdk.js

@@ -303,4 +303,3 @@ export function isAbort(cause) {
         return true;
     return cause instanceof Error && (cause.name === 'AbortError' || cause.name === 'TimeoutError');
 }
-//# sourceMappingURL=sdk.js.map

package/dist/agent/model/stall.d.ts

@@ -8,4 +8,3 @@ import type { AiSdk, SdkLanguageModel } from '../ai-sdk.ts';
  * The caller's cancellation is not a stall and passes through as it was.
  */
 export declare function withStallGuard(ai: AiSdk, model: SdkLanguageModel, onStall?: (stallMs: number) => void, stallMs?: number): SdkLanguageModel;
-//# sourceMappingURL=stall.d.ts.map

package/dist/agent/model/stall.js

@@ -50,4 +50,3 @@ export function withStallGuard(ai, model, onStall = () => undefined, stallMs = M
         },
     });
 }
-//# sourceMappingURL=stall.js.map

package/dist/agent/model/tool-choice.d.ts

@@ -41,4 +41,3 @@ export declare function isForcedToolCallSkipped(error: unknown): error is {
  * quoting the request never reads as a model limitation.
  */
 export declare function isForcedToolChoiceRejected(error: unknown): boolean;
-//# sourceMappingURL=tool-choice.d.ts.map

package/dist/agent/model/tool-choice.js

@@ -72,4 +72,3 @@ function describesRejection(error) {
         return false;
     return [record.message, record.responseBody].some((text) => typeof text === 'string' && FORCED_CHOICE_PATTERNS.some((pattern) => pattern.test(text)));
 }
-//# sourceMappingURL=tool-choice.js.map

package/dist/agent/observation-budget.d.ts

@@ -24,4 +24,3 @@ export interface ObservationBudgetRequest {
  * than fail the adapter's pre-flight check.
  */
 export declare function observationByteBudget(limits: ObservationBudgetLimits, request: ObservationBudgetRequest): number;
-//# sourceMappingURL=observation-budget.d.ts.map

package/dist/agent/observation-budget.js

@@ -40,4 +40,3 @@ export function observationByteBudget(limits, request) {
     const withinTokenCeiling = Math.max(MIN_OBSERVATION_BYTES, limits.maxInputTokens - overhead);
     return Math.min(limits.maxObservationBytes, withinTokenCeiling);
 }
-//# sourceMappingURL=observation-budget.js.map

package/dist/agent/observation-feed.d.ts

@@ -170,4 +170,3 @@ export declare class ObservationFeed {
 }
 /** The error for a target id the newest screen no longer lists. */
 export declare function nodeGone(id: string, latest: SemanticAgentObservation): AgentError;
-//# sourceMappingURL=observation-feed.d.ts.map

package/dist/agent/observation-feed.js

@@ -392,4 +392,3 @@ function echoesInput(node) {
 export function nodeGone(id, latest) {
     return new AgentError('LOCATOR_NOT_FOUND', `node #${id} is not on the current screen (observation ${latest.revision}); it was removed or never existed`);
 }
-//# sourceMappingURL=observation-feed.js.map

package/dist/agent/observation.d.ts

@@ -190,4 +190,3 @@ export declare function settleObservation<T>(capture: () => Promise<T>, shapeOf:
  */
 export declare function isTransitionalObservation(observation: AgentObservation): boolean;
 export {};
-//# sourceMappingURL=observation.d.ts.map

package/dist/agent/observation.js

@@ -474,4 +474,3 @@ function indexNodes(node, into, parents) {
         indexNodes(child, into, parents);
     }
 }
-//# sourceMappingURL=observation.js.map

package/dist/agent/operation-queue.d.ts

@@ -18,4 +18,3 @@ export declare class OperationQueue {
     /** Runs `body` after every operation queued before it, in call order. */
     run<T>(body: () => Promise<T>): Promise<T>;
 }
-//# sourceMappingURL=operation-queue.d.ts.map

package/dist/agent/operation-queue.js

@@ -24,4 +24,3 @@ export class OperationQueue {
         return run;
     }
 }
-//# sourceMappingURL=operation-queue.js.map

package/dist/agent/phases.d.ts

@@ -75,4 +75,3 @@ export declare function retryingObserve(options: {
     readonly signal: AbortSignal;
     readonly api: string;
 }): Promise<Observation>;
-//# sourceMappingURL=phases.d.ts.map

package/dist/agent/phases.js

@@ -140,4 +140,3 @@ function phaseErrorCode(cause) {
         return engineError.code;
     return cause instanceof Error ? cause.name : 'ERROR';
 }
-//# sourceMappingURL=phases.js.map

package/dist/agent/pixels.d.ts

@@ -18,4 +18,3 @@ export declare function sizeForModel<P extends ObservationPixels>(pixels: P): P;
  * the caller's pixels carry (a masked-region count) rides along unchanged.
  */
 export declare function downscalePixels<P extends ObservationPixels>(pixels: P, maxLongSide: number): P;
-//# sourceMappingURL=pixels.d.ts.map

package/dist/agent/pixels.js

@@ -82,4 +82,3 @@ function boxResample(source, sourceWidth, sourceHeight, target, targetWidth, tar
         }
     }
 }
-//# sourceMappingURL=pixels.js.map

package/dist/agent/point-tap.d.ts

@@ -63,4 +63,3 @@ export declare function describePointHit(input: PointProse & {
     readonly control: SemanticNode | undefined;
     readonly under: SemanticNode | undefined;
 }): string;
-//# sourceMappingURL=point-tap.d.ts.map

package/dist/agent/point-tap.js

@@ -112,4 +112,3 @@ export function describePointHit(input) {
 function describeNode(prose, node) {
     return nodeLine(prose.observation, node.ref.id);
 }
-//# sourceMappingURL=point-tap.js.map

package/dist/agent/primitives.d.ts

@@ -46,6 +46,12 @@ export interface GrammarToolOptions {
      * otherwise.
      */
     readonly screen?: ScreenPresenter;
+    /**
+     * Told the cause of every action that failed into a result rather than a
+     * throw, before it becomes the result's text: the one place its runner
+     * code is still structured.
+     */
+    readonly onActionFailed?: ((cause: unknown) => void) | undefined;
 }
 /**
  * AI SDK tools over the harness action grammar, limited to the verbs the
@@ -78,4 +84,3 @@ export declare function trackModelCalls(context: StepExecutorContext, model?: {
     readonly provider?: string;
     readonly modelId?: string;
 }): ModelCallTracker;
-//# sourceMappingURL=primitives.d.ts.map

package/dist/agent/primitives.js

@@ -666,7 +666,10 @@ function verbKit(context, options) {
         catch (cause) {
             if (isRuntimeHardStop(cause))
                 throw cause;
-            return present(failureLead(label, cause));
+            const failed = await present(failureLead(label, cause));
+            // After the look, so a look that throws fails the call once, as itself.
+            options.onActionFailed?.(cause);
+            return failed;
         }
         return present(outcome.lead, { expectChange: outcome.expectChange, ...update });
     });
@@ -717,4 +720,3 @@ export function trackModelCalls(context, model) {
         },
     };
 }
-//# sourceMappingURL=primitives.js.map

package/dist/agent/prompts.d.ts

@@ -49,4 +49,3 @@ export declare const JUDGMENT_REQUEST: string;
 export declare const EXTRACT_REQUEST: string;
 /** The extraction's answer to a rejection the screen cannot satisfy: say so rather than change the data. */
 export declare const EXTRACT_REPAIR_OUTLET = "Correct a misread or a wrong shape. When the data the observation shows cannot satisfy the errors, respond with \"found\": false and say why in \"missing\" rather than change a value to fit.";
-//# sourceMappingURL=prompts.d.ts.map

package/dist/agent/prompts.js

@@ -118,4 +118,3 @@ export const EXTRACT_REQUEST = [
 ].join('\n');
 /** The extraction's answer to a rejection the screen cannot satisfy: say so rather than change the data. */
 export const EXTRACT_REPAIR_OUTLET = 'Correct a misread or a wrong shape. When the data the observation shows cannot satisfy the errors, respond with "found": false and say why in "missing" rather than change a value to fit.';
-//# sourceMappingURL=prompts.js.map

package/dist/agent/protocol.d.ts

@@ -65,4 +65,3 @@ export declare function extractSchema(shape: JSONSchema7): JSONSchema7;
  */
 export declare function validateExtractResponse(value: unknown): ProtocolValidation<ExtractResponse>;
 export {};
-//# sourceMappingURL=protocol.d.ts.map