@e2edev/e2e 0.2.0

package/dist/agent/ledger.js

@@ -0,0 +1,48 @@
+/**
+ * Prior-step context for agent prompts (spec 10-determinism.md).
+ *
+ * The ledger is not stored anywhere: it is derived on demand from the step
+ * timeline the run layer already records, so there is exactly one account of
+ * what happened. Serial-group members see each other's prior steps through the
+ * shared accumulator the run layer maintains; independent tests never do.
+ * Entries are untrusted quoted evidence and never carry policy authority.
+ */
+import { sanitizeText, truncateUtf8 } from '../internal/errors.js';
+/** Maximum size of one handoff, before ledger-wide compaction. */
+export const MAX_HANDOFF_BYTES = 700;
+const MAX_LABEL_BYTES = 256;
+/**
+ * Serializes completed steps as prompt context: newest entries first until the
+ * byte budget is reached, then emitted chronologically with the dropped count
+ * prepended. Labels and handoffs are sanitized and bounded here, at the trust
+ * boundary where they become model input.
+ */
+export function serializeLedger(steps, maxBytes) {
+    const encoder = new TextEncoder();
+    const lines = [];
+    let bytes = 0;
+    let index = steps.length - 1;
+    for (; index >= 0; index -= 1) {
+        const line = formatEntry(steps[index], index + 1);
+        const size = encoder.encode(`${line}\n`).byteLength;
+        if (bytes + size > maxBytes)
+            break;
+        bytes += size;
+        lines.push(line);
+    }
+    lines.reverse();
+    const dropped = index + 1;
+    if (dropped > 0)
+        lines.unshift(`[${dropped} earlier step(s) omitted]`);
+    const text = lines.join('\n');
+    return { text, bytes: encoder.encode(text).byteLength };
+}
+function formatEntry(step, position) {
+    const label = truncateUtf8(sanitizeText(step.label), MAX_LABEL_BYTES);
+    const head = `${position}. ${step.api} ${step.status}${label === '' ? '' : ` :: ${label}`}`;
+    if (step.explanation === undefined)
+        return head;
+    const handoff = truncateUtf8(sanitizeText(step.explanation), MAX_HANDOFF_BYTES);
+    return `${head}\n   observed: ${handoff}`;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/agent/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../src/agent/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGnE,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,MAAM,eAAe,GAAG,GAAG,CAAC;AAO5B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAA4B,EAAE,QAAgB;IAC5E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,OAAO,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC;QACpD,IAAI,KAAK,GAAG,IAAI,GAAG,QAAQ;YAAE,MAAM;QACnC,KAAK,IAAI,IAAI,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAChB,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1B,IAAI,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,2BAA2B,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,IAAgB,EAAE,QAAgB;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,GAAG,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;IAC5F,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAChF,OAAO,GAAG,IAAI,kBAAkB,OAAO,EAAE,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Loop guards: pure detectors over the tool-call transcript that catch an
+ * executor loop going in circles before the budget does. Ported from the
+ * shape proven in production — a wandering model repeats itself long before
+ * it runs out of calls, and every repeated turn is spent money.
+ *
+ * A guard never invents a verdict: a warning injects a notice the model can
+ * react to, and a stop forces the conclusion tool so the model still writes
+ * its own summary. Budgets remain the outer bound either way.
+ */
+import type { ModelMessage } from 'ai';
+/** One tool call as identity: the name plus its exact serialized input. */
+export interface GuardToolCall {
+    readonly toolName: string;
+    readonly input: string;
+}
+export type LoopGuardVerdict = {
+    readonly kind: 'clear';
+} | {
+    readonly kind: 'warn' | 'stop';
+    readonly reason: string;
+};
+/**
+ * Extracts the tool-call identity sequence from a model transcript,
+ * excluding the conclusion tool: concluding attempts are never "loops".
+ */
+export declare function extractGuardCalls(messages: readonly ModelMessage[], concludeToolName: string): GuardToolCall[];
+/**
+ * Checks the trailing calls for exact repetition (period 1) and short exact
+ * cycles (periods 2..4). Identity includes the serialized input, so two taps
+ * on different targets never count as a repeat — only literally re-issuing
+ * the same work does.
+ */
+export declare function checkLoopGuards(calls: readonly GuardToolCall[]): LoopGuardVerdict;
+//# sourceMappingURL=loop-guards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loop-guards.d.ts","sourceRoot":"","sources":["../../src/agent/loop-guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAahE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,gBAAgB,EAAE,MAAM,GACvB,aAAa,EAAE,CAUjB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,gBAAgB,CAajF"}

package/dist/agent/loop-guards.js

@@ -0,0 +1,110 @@
+/**
+ * Loop guards: pure detectors over the tool-call transcript that catch an
+ * executor loop going in circles before the budget does. Ported from the
+ * shape proven in production — a wandering model repeats itself long before
+ * it runs out of calls, and every repeated turn is spent money.
+ *
+ * A guard never invents a verdict: a warning injects a notice the model can
+ * react to, and a stop forces the conclusion tool so the model still writes
+ * its own summary. Budgets remain the outer bound either way.
+ */
+/** Longest cycle period the detector considers. */
+const MAX_CYCLE_PERIOD = 4;
+/** Identical-call (period 1) thresholds: warn, then force the conclusion. */
+const REPEAT_WARN = 3;
+const REPEAT_STOP = 5;
+/** Cycle (period 2..4) thresholds, counted in whole repetitions. */
+const CYCLE_WARN = 2;
+const CYCLE_STOP = 3;
+/**
+ * Extracts the tool-call identity sequence from a model transcript,
+ * excluding the conclusion tool: concluding attempts are never "loops".
+ */
+export function extractGuardCalls(messages, concludeToolName) {
+    const calls = [];
+    for (const message of messages) {
+        if (message.role !== 'assistant' || !Array.isArray(message.content))
+            continue;
+        for (const part of message.content) {
+            if (part.type !== 'tool-call' || part.toolName === concludeToolName)
+                continue;
+            calls.push({ toolName: part.toolName, input: safeStringify(part.input) });
+        }
+    }
+    return calls;
+}
+/**
+ * Checks the trailing calls for exact repetition (period 1) and short exact
+ * cycles (periods 2..4). Identity includes the serialized input, so two taps
+ * on different targets never count as a repeat — only literally re-issuing
+ * the same work does.
+ */
+export function checkLoopGuards(calls) {
+    let warning;
+    for (let period = 1; period <= MAX_CYCLE_PERIOD; period += 1) {
+        const repeats = trailingRepeats(calls, period);
+        const [warnAt, stopAt] = period === 1 ? [REPEAT_WARN, REPEAT_STOP] : [CYCLE_WARN, CYCLE_STOP];
+        if (repeats >= stopAt) {
+            return { kind: 'stop', reason: describe(calls, period, repeats) };
+        }
+        if (repeats >= warnAt && warning === undefined) {
+            warning = { kind: 'warn', reason: describe(calls, period, repeats) };
+        }
+    }
+    return warning ?? { kind: 'clear' };
+}
+/** How many times the trailing window of `period` calls repeats consecutively. */
+function trailingRepeats(calls, period) {
+    if (calls.length < period)
+        return 0;
+    // A period-p cycle must not be a disguised shorter cycle: "A A A A" matches
+    // period 2 as well, but period 1 owns it and applies the stricter policy.
+    if (period > 1 && isUniformWindow(calls, period))
+        return 0;
+    const same = (a, b) => a !== undefined && b !== undefined && a.toolName === b.toolName && a.input === b.input;
+    let repeats = 1;
+    for (let offset = period; calls.length - offset - period >= 0; offset += period) {
+        let matches = true;
+        for (let index = 0; index < period; index += 1) {
+            if (!same(calls[calls.length - period + index], calls[calls.length - offset - period + index])) {
+                matches = false;
+                break;
+            }
+        }
+        if (!matches)
+            break;
+        repeats += 1;
+    }
+    return repeats;
+}
+/** True when the trailing window consists of one identical call repeated. */
+function isUniformWindow(calls, period) {
+    const first = calls[calls.length - period];
+    if (first === undefined)
+        return false;
+    for (let index = 1; index < period; index += 1) {
+        const call = calls[calls.length - period + index];
+        if (call === undefined || call.toolName !== first.toolName || call.input !== first.input) {
+            return false;
+        }
+    }
+    return true;
+}
+function describe(calls, period, repeats) {
+    const names = calls
+        .slice(calls.length - period)
+        .map((call) => call.toolName)
+        .join(', ');
+    return period === 1
+        ? `the same "${names}" call with identical input was issued ${repeats} times in a row`
+        : `the same ${period}-call sequence (${names}) repeated ${repeats} times with identical inputs`;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value) ?? 'undefined';
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=loop-guards.js.map

package/dist/agent/loop-guards.js.map

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

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

@@ -0,0 +1,97 @@
+/** Model adapter contract (spec 05-config.md, 10-determinism.md, 14-security.md). */
+import type { JSONSchema7 } from 'ai';
+import { AgentError } from '../error.ts';
+import type { ProtocolValidation } from '../protocol.ts';
+/** Token accounting for one model call. */
+export interface ModelUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly accounting: 'provider' | 'adapter-upper-bound';
+    readonly estimatedCostUsd: number | undefined;
+}
+/** Provenance recorded for every model-backed step (13-reporting.md). */
+export interface ModelProvenance {
+    readonly provider: string;
+    readonly model: string;
+    /**
+     * `local` for in-process adapters, `provider-default` when a caller-supplied
+     * model instance owns its own transport, otherwise an absolute endpoint URI.
+     */
+    readonly endpoint: string;
+    readonly adapterVersion: string;
+}
+/** Untrusted pixel evidence sent alongside the prompt (spec 14-security.md). */
+export interface ModelImage {
+    readonly data: Uint8Array;
+    readonly mediaType: string;
+    /** CSS pixel geometry, used for the pre-flight token bound. */
+    readonly width: number;
+    readonly height: number;
+}
+/** One bounded, stateless model request. There is no shared transcript. */
+export interface ModelCall<Value> {
+    /** Trusted runner policy followed by trusted project context. */
+    readonly system: string;
+    /** Untrusted evidence and the method instruction. */
+    readonly prompt: string;
+    /**
+     * Untrusted image evidence attached to the same user message. Present only
+     * for vision calls; a non-multimodal provider rejects the request.
+     */
+    readonly images?: readonly ModelImage[] | undefined;
+    readonly schemaName: string;
+    /**
+     * Closed response grammar sent to the provider as a structured-output
+     * schema. Omitted when only the runner can validate the payload, in which
+     * case the adapter parses one JSON object from the response text.
+     */
+    readonly schema: JSONSchema7 | undefined;
+    readonly validate: (value: unknown) => ProtocolValidation<Value>;
+    readonly maxOutputTokens: number;
+    readonly maxInputTokens: number;
+    readonly signal: AbortSignal;
+    readonly timeoutMs: number;
+}
+export interface ModelResult<Value> {
+    readonly value: Value;
+    readonly usage: ModelUsage;
+}
+export interface ModelAdapter {
+    readonly provenance: ModelProvenance;
+    /** Performs exactly one model request and validates its response. */
+    generate<Value>(call: ModelCall<Value>): Promise<ModelResult<Value>>;
+}
+/**
+ * Raised when a provider response cannot be parsed or fails the closed
+ * grammar. The raw text is carried so the caller may spend remaining budget on
+ * one repair attempt.
+ */
+export declare class ModelOutputInvalidError extends AgentError {
+    readonly rawText: string | undefined;
+    constructor(issue: string, options?: {
+        rawText?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Conservative token upper bound. UTF-8 byte length bounds every byte-level
+ * tokenizer from above, so it is used when a provider reports no usage and for
+ * the pre-flight ceiling required by 14-security.md.
+ *
+ * Every budget that mixes with this one — reserves, ledger size, observation
+ * size — is therefore in the same byte-scaled units, not in real tokens.
+ */
+export declare function tokenUpperBound(text: string): number;
+/**
+ * Conservative token bound for one image. Vision providers bill images by
+ * fixed-size patches rather than bytes, so the count of patches covering the
+ * image bounds every such encoder from above closely enough to keep a vision
+ * call inside `limits.maxModelTokensPerCall`. Compressed byte length would be
+ * meaningless here: a blank screenshot is small and a photograph is not, while
+ * both cost the same number of patches.
+ */
+export declare function imageTokenUpperBound(image: {
+    width: number;
+    height: number;
+}): number;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/model/adapter.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,qBAAqB,CAAC;IACxD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,SAAS,CAAC,KAAK;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW,CAAC,KAAK;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;CACtE;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,EAG7E;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAKD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKrF"}

package/dist/agent/model/adapter.js

@@ -0,0 +1,40 @@
+/** Model adapter contract (spec 05-config.md, 10-determinism.md, 14-security.md). */
+import { AgentError } from '../error.js';
+/**
+ * Raised when a provider response cannot be parsed or fails the closed
+ * grammar. The raw text is carried so the caller may spend remaining budget on
+ * one repair attempt.
+ */
+export class ModelOutputInvalidError extends AgentError {
+    rawText;
+    constructor(issue, options = {}) {
+        super('MODEL_OUTPUT_INVALID', issue, options.cause === undefined ? {} : { cause: options.cause });
+        this.rawText = options.rawText;
+    }
+}
+/**
+ * Conservative token upper bound. UTF-8 byte length bounds every byte-level
+ * tokenizer from above, so it is used when a provider reports no usage and for
+ * the pre-flight ceiling required by 14-security.md.
+ *
+ * Every budget that mixes with this one — reserves, ledger size, observation
+ * size — is therefore in the same byte-scaled units, not in real tokens.
+ */
+export function tokenUpperBound(text) {
+    return new TextEncoder().encode(text).byteLength;
+}
+/** Side of the square patch tile-based vision encoders consume an image in. */
+const IMAGE_TILE_PX = 28;
+/**
+ * Conservative token bound for one image. Vision providers bill images by
+ * fixed-size patches rather than bytes, so the count of patches covering the
+ * image bounds every such encoder from above closely enough to keep a vision
+ * call inside `limits.maxModelTokensPerCall`. Compressed byte length would be
+ * meaningless here: a blank screenshot is small and a photograph is not, while
+ * both cost the same number of patches.
+ */
+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/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/agent/model/adapter.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAGrF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoEzC;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IAC5C,OAAO,CAAqB;IAErC,YAAY,KAAa,EAAE,OAAO,GAA0C,EAAE;QAC5E,KAAK,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC;AACnD,CAAC;AAED,+EAA+E;AAC/E,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAwC;IAC3E,OAAO,CACL,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,CACrD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+/** Which model an invocation talks to (spec 05-config.md). */
+import type { ResolvedAgentConfig } from '../../config/agent.ts';
+import type { ModelAdapter } from './adapter.ts';
+/**
+ * Picks the adapter for one invocation.
+ *
+ * `agent.visionModel` exists because visual grounding is a much higher bar than
+ * accepting an image, and pinning it separately keeps every text-only call on the
+ * cheaper model. The vision adapter is built on first use rather than at fixture
+ * acquisition: a project that pins a vision model must not fail a run that never
+ * asks for pixels, for example because that model's credential is absent from
+ * this environment.
+ */
+export declare class ModelRouter {
+    private readonly buildBase;
+    private readonly buildVision;
+    private baseAdapter;
+    private visionAdapter;
+    constructor(buildBase: () => ModelAdapter, buildVision: (() => ModelAdapter) | undefined);
+    /**
+     * The adapter for a call. An invocation that is sending pixels keeps the vision
+     * model for the rest of its lifetime, including rounds whose pixels were
+     * withheld, so a polling method never switches models between rounds.
+     */
+    select(vision: boolean): ModelAdapter;
+}
+/**
+ * Builds the router for one attempt from resolved agent config.
+ *
+ * The base adapter is built on first use, like the vision adapter: a run whose
+ * `agent.act()` steps go to a custom executor may legitimately have no model at
+ * all, and must not fail on a MODEL_UNAVAILABLE it would never hit. Judgment
+ * and locate methods still fail with MODEL_UNAVAILABLE on their first call.
+ */
+export declare function createModelRouter(agent: ResolvedAgentConfig, build: (model: ResolvedAgentConfig['model']) => ModelAdapter): ModelRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/agent/model/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/agent/model/router.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAL9B,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,aAAa,CAA2B;IAEhD,YACmB,SAAS,EAAE,MAAM,YAAY,EAC7B,WAAW,EAAE,CAAC,MAAM,YAAY,CAAC,GAAG,SAAS,EAC5D;IAEJ;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAKpC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,KAAK,YAAY,GAC3D,WAAW,CAMb"}

package/dist/agent/model/router.js

@@ -0,0 +1,45 @@
+/** Which model an invocation talks to (spec 05-config.md). */
+/**
+ * Picks the adapter for one invocation.
+ *
+ * `agent.visionModel` exists because visual grounding is a much higher bar than
+ * accepting an image, and pinning it separately keeps every text-only call on the
+ * cheaper model. The vision adapter is built on first use rather than at fixture
+ * acquisition: a project that pins a vision model must not fail a run that never
+ * asks for pixels, for example because that model's credential is absent from
+ * this environment.
+ */
+export class ModelRouter {
+    buildBase;
+    buildVision;
+    baseAdapter;
+    visionAdapter;
+    constructor(buildBase, buildVision) {
+        this.buildBase = buildBase;
+        this.buildVision = buildVision;
+    }
+    /**
+     * The adapter for a call. An invocation that is sending pixels keeps the vision
+     * model for the rest of its lifetime, including rounds whose pixels were
+     * withheld, so a polling method never switches models between rounds.
+     */
+    select(vision) {
+        if (!vision || this.buildVision === undefined) {
+            return (this.baseAdapter ??= this.buildBase());
+        }
+        return (this.visionAdapter ??= this.buildVision());
+    }
+}
+/**
+ * Builds the router for one attempt from resolved agent config.
+ *
+ * The base adapter is built on first use, like the vision adapter: a run whose
+ * `agent.act()` steps go to a custom executor may legitimately have no model at
+ * all, and must not fail on a MODEL_UNAVAILABLE it would never hit. Judgment
+ * and locate methods still fail with MODEL_UNAVAILABLE on their first call.
+ */
+export function createModelRouter(agent, build) {
+    const visionModel = agent.visionModel;
+    return new ModelRouter(() => build(agent.model), visionModel === undefined ? undefined : () => build(visionModel));
+}
+//# sourceMappingURL=router.js.map

package/dist/agent/model/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/agent/model/router.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAK9D;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IAKH,SAAS;IACT,WAAW;IALtB,WAAW,CAA2B;IACtC,aAAa,CAA2B;IAEhD,YACmB,SAA6B,EAC7B,WAA6C;yBAD7C,SAAS;2BACT,WAAW;IAC3B,CAAC;IAEJ;;;;OAIG;IACH,MAAM,CAAC,MAAe;QACpB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA0B,EAC1B,KAA4D;IAE5D,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,OAAO,IAAI,WAAW,CACpB,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EACxB,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CACjE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Best-effort JSON Schema projection of a caller-supplied Standard Schema v1.
+ *
+ * Standard Schema v1 has no required JSON Schema projection, but zod and any
+ * vendor exposing the `~standard.jsonSchema` converter can produce one. When a
+ * projection exists the runner sends it as a provider structured-output schema
+ * so the shape is enforced instead of guessed; otherwise the extraction falls
+ * back to text mode plus the validation-issue repair loop.
+ *
+ * The projection is only a provider hint. The caller's `~standard.validate`
+ * remains the sole authority over the extracted value.
+ */
+import type { JSONSchema7 } from 'ai';
+import type { StandardSchemaV1 } from '../../types.ts';
+export declare function deriveJsonSchema(schema: StandardSchemaV1): Promise<JSONSchema7 | undefined>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/agent/model/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAUlC"}

package/dist/agent/model/schema.js

@@ -0,0 +1,37 @@
+/**
+ * Best-effort JSON Schema projection of a caller-supplied Standard Schema v1.
+ *
+ * Standard Schema v1 has no required JSON Schema projection, but zod and any
+ * vendor exposing the `~standard.jsonSchema` converter can produce one. When a
+ * projection exists the runner sends it as a provider structured-output schema
+ * so the shape is enforced instead of guessed; otherwise the extraction falls
+ * back to text mode plus the validation-issue repair loop.
+ *
+ * The projection is only a provider hint. The caller's `~standard.validate`
+ * remains the sole authority over the extracted value.
+ */
+import { loadAiSdk } from '../ai-sdk.js';
+export async function deriveJsonSchema(schema) {
+    try {
+        // The projection is best-effort by contract, so a missing optional AI SDK
+        // degrades to text mode here; the model call itself reports it properly.
+        const { asSchema } = await loadAiSdk();
+        const projected = await asSchema(schema).jsonSchema;
+        return isUsable(projected) ? projected : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A schema with no type or members constrains nothing and is rejected by some providers. */
+function isUsable(schema) {
+    if (typeof schema !== 'object' || schema === null || Array.isArray(schema))
+        return false;
+    const record = schema;
+    return (record['type'] !== undefined ||
+        record['properties'] !== undefined ||
+        record['anyOf'] !== undefined ||
+        record['oneOf'] !== undefined ||
+        record['$ref'] !== undefined);
+}
+//# sourceMappingURL=schema.js.map

package/dist/agent/model/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/agent/model/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAwB;IAExB,IAAI,CAAC;QACH,0EAA0E;QAC1E,yEAAyE;QACzE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,MAAe,CAAC,CAAC,UAAU,CAAC;QAC7D,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE,SAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,SAAS,QAAQ,CAAC,MAAe;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzF,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,OAAO,CACL,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS;QAC5B,MAAM,CAAC,YAAY,CAAC,KAAK,SAAS;QAClC,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;QAC7B,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,CAC7B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * AI SDK adapter (spec 05-config.md). One implementation serves every
+ * provider: a `provider/model-id` reference resolves through the AI Gateway,
+ * and a caller-supplied AI SDK model instance (`openai('gpt-4o')`, a local
+ * provider, a scripted test model) is used directly. Everything after model
+ * construction — bounded requests, closed-grammar validation, usage and error
+ * translation — is provider-independent.
+ */
+import { type ResolvedModel, type SdkLanguageModel } from '../../config/agent.ts';
+import { type ModelAdapter } from './adapter.ts';
+/** Creates the adapter for one resolved model, or fails with MODEL_UNAVAILABLE. */
+export declare function createModelAdapter(model: ResolvedModel | undefined): ModelAdapter;
+/**
+ * Builds the bare AI SDK language model for one resolved model reference, for
+ * callers that drive the SDK directly (the default step executor) rather than
+ * through the adapter. Fails with MODEL_UNAVAILABLE exactly like the adapter.
+ * Gateway references require the AI SDK to be loaded (loadAiSdk) first; model
+ * instances never touch it.
+ */
+export declare function instantiateLanguageModel(model: ResolvedModel): SdkLanguageModel;
+/**
+ * The AI Gateway reports per-request cost in provider metadata when available;
+ * other providers simply lack the key. `cost` is what the gateway bills; BYOK
+ * routes bill the provider key directly and report `cost: "0"`, so fall back
+ * to `marketCost`, the list-price estimate of the same request.
+ */
+export declare function readCost(metadata: Readonly<Record<string, Readonly<Record<string, unknown>>>> | undefined): number | undefined;
+//# sourceMappingURL=sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/agent/model/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAIL,KAAK,YAAY,EAKlB,MAAM,cAAc,CAAC;AAmBtB,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAqFjF;AAsBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAE/E;AA6ED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GAChF,MAAM,GAAG,SAAS,CAIpB"}