experimental-ash 0.26.0 → 0.28.0

package/dist/src/harness/model-call-error.js

@@ -1,368 +1 @@
-import { isObject } from "#shared/guards.js";
-const RESPONSE_BODY_SNIPPET_LIMIT = 1_000;
-const GATEWAY_MODEL_REQUEST_REJECTED_MESSAGE = "AI Gateway rejected the model request before the agent produced a response.";
-/**
- * Anchored regex for the upstream "unsupported tool" rejection message
- * that AI Gateway returns when a fallback provider cannot serve a
- * provider-specific tool (e.g. Bedrock rejecting `web_search_20250305`).
- *
- * The phrasing comes from the gateway's own provider attempt projection
- * and is stable across the Bedrock and Vertex Anthropic backends. We
- * anchor the match on the literal `tool type` prefix to avoid sweeping
- * in unrelated "not supported" errors.
- */
-const UNSUPPORTED_TOOL_TYPE_REGEX = /tool type ['"]([\w.-]+)['"] is not supported/i;
-/**
- * Returns a concise actionable summary for known terminal configuration
- * errors raised during a model call. Returns `null` for everything else
- * so the caller falls back to the raw SDK message.
- */
-export function summarizeKnownModelCallConfigError(error) {
-    const rawName = readErrorName(error);
-    const rawMessage = readErrorMessage(error);
-    if (rawName === "GatewayAuthenticationError" || /AI Gateway authentication/i.test(rawMessage)) {
-        // The upstream `GatewayAuthenticationError` builds one of three
-        // contextual messages depending on which credential was offered
-        // (api-key, oidc, neither). Surface a remediation that matches the
-        // one that actually failed — collapsing all three into a single
-        // "set AI_GATEWAY_API_KEY" hint misleads users whose shell already
-        // exports a stale `AI_GATEWAY_API_KEY` that shadows the OIDC fallback.
-        if (/Invalid API key/i.test(rawMessage)) {
-            return {
-                name: "AI Gateway authentication failed",
-                message: "AI Gateway rejected the provided API key. Update or unset `AI_GATEWAY_API_KEY` (check your shell profile if you did not set it for this project) — manage keys at https://vercel.com/dashboard/ai/api-keys. Unsetting it falls back to OIDC via `vercel link` + `vercel env pull`.",
-            };
-        }
-        if (/Invalid OIDC token/i.test(rawMessage)) {
-            return {
-                name: "AI Gateway authentication failed",
-                message: "AI Gateway rejected the OIDC token. Run `vercel env pull` to refresh `VERCEL_OIDC_TOKEN` in `.env.local`, or set `AI_GATEWAY_API_KEY` — create a key at https://vercel.com/dashboard/ai/api-keys.",
-            };
-        }
-        return {
-            name: "AI Gateway authentication failed",
-            message: "AI Gateway received no credentials. Run `vercel link` + `vercel env pull` to populate `VERCEL_OIDC_TOKEN`, or set `AI_GATEWAY_API_KEY` — create a key at https://vercel.com/dashboard/ai/api-keys.",
-        };
-    }
-    if (rawName === "LoadAPIKeyError" || /API key is missing/i.test(rawMessage)) {
-        return {
-            name: "Model provider API key missing",
-            message: "The model provider could not load an API key. Export the provider's API key environment variable (for example `AI_GATEWAY_API_KEY` or `OPENAI_API_KEY`) and try again.",
-        };
-    }
-    return null;
-}
-/**
- * Returns a concise summary for known model-call request failures that are not
- * configuration errors. These failures happen before the agent can produce a
- * response, so the user-facing message should avoid implying a bad tool call.
- */
-export function summarizeKnownModelCallRequestError(error) {
-    const signals = readModelCallErrorSignals(error);
-    if (signals.statusCode === 400 && isGatewayErrorSignal(signals)) {
-        return {
-            name: "AI Gateway model request rejected",
-            message: GATEWAY_MODEL_REQUEST_REJECTED_MESSAGE,
-        };
-    }
-    return null;
-}
-/**
- * Returns the distinct upstream tool types referenced by any
- * "tool type 'X' is not supported" rejection in an AI Gateway error's
- * provider attempt list.
- *
- * Walks the cause chain to find the gateway error and inspects both the
- * structured `data` field and the raw `responseBody` JSON. Returns an
- * empty array for errors that are not of this shape.
- *
- * Used by the harness recovery path to identify which framework tools
- * to drop before retrying the failing step. Detection is by string
- * match on the upstream tool type — see
- * {@link resolveFrameworkToolFromUpstreamType} for the mapping back to
- * framework tool names.
- */
-export function extractUnsupportedProviderToolTypes(error) {
-    const found = new Set();
-    for (const candidate of walkCauseChain(error)) {
-        collectUnsupportedToolTypesFromValue(readObjectField(candidate, "data"), found);
-        const responseBody = readStringField(candidate, "responseBody");
-        if (responseBody !== undefined) {
-            try {
-                collectUnsupportedToolTypesFromValue(JSON.parse(responseBody), found);
-            }
-            catch {
-                // The response body may be truncated mid-JSON when the upstream
-                // includes a large request snapshot. Fall back to a raw string
-                // scan so we still surface the tool name when the regex match
-                // lies before the truncation boundary.
-                const match = UNSUPPORTED_TOOL_TYPE_REGEX.exec(responseBody);
-                if (match?.[1] !== undefined) {
-                    found.add(match[1]);
-                }
-            }
-        }
-    }
-    return [...found];
-}
-function collectUnsupportedToolTypesFromValue(value, out) {
-    if (value === null || value === undefined)
-        return;
-    if (typeof value === "string") {
-        const match = UNSUPPORTED_TOOL_TYPE_REGEX.exec(value);
-        if (match?.[1] !== undefined) {
-            out.add(match[1]);
-        }
-        return;
-    }
-    if (Array.isArray(value)) {
-        for (const entry of value) {
-            collectUnsupportedToolTypesFromValue(entry, out);
-        }
-        return;
-    }
-    if (isObject(value)) {
-        for (const entry of Object.values(value)) {
-            collectUnsupportedToolTypesFromValue(entry, out);
-        }
-    }
-}
-/**
- * Extracts compact, structured diagnostics from AI SDK / AI Gateway model-call
- * errors. The full SDK error can include very large request bodies (especially
- * tool schemas), so this shape lifts the important upstream response fields into
- * `step.failed.details` before any inspector output gets truncated.
- */
-export function extractModelCallErrorDetails(error) {
-    const signals = readModelCallErrorSignals(error);
-    const details = {};
-    appendJsonField(details, "gatewayName", signals.gatewayName);
-    appendJsonField(details, "gatewayType", signals.gatewayType);
-    appendJsonField(details, "statusCode", signals.statusCode);
-    appendJsonField(details, "generationId", signals.generationId);
-    appendJsonField(details, "upstreamStatusCode", signals.upstreamStatusCode);
-    appendJsonField(details, "upstreamType", signals.upstreamType);
-    appendJsonField(details, "upstreamMessage", signals.upstreamMessage);
-    appendJsonField(details, "responseBodySnippet", signals.responseBodySnippet);
-    return details;
-}
-function readErrorName(error) {
-    if (error instanceof Error) {
-        return error.name;
-    }
-    if (isObject(error) && typeof error.name === "string") {
-        return error.name;
-    }
-    return undefined;
-}
-function readErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    if (isObject(error) && typeof error.message === "string") {
-        return error.message;
-    }
-    return "";
-}
-/**
- * Classifies a model-call failure into the runtime's recovery policy.
- */
-export function classifyModelCallError(error) {
-    // `APICallError` exposes `isRetryable`, populated by provider
-    // adapters that already know what's transient on their side. We
-    // read it via duck typing so the check survives a minor-version
-    // bump of `@ai-sdk/provider`.
-    if (hasRetryableFlag(error)) {
-        return "retry";
-    }
-    if (summarizeKnownModelCallConfigError(error) !== null) {
-        return "terminal";
-    }
-    const signals = readModelCallErrorSignals(error);
-    if (isRetryableGatewayType(signals.gatewayType) || isRetryableGatewayType(signals.upstreamType)) {
-        return "retry";
-    }
-    if (isTerminalGatewayType(signals.gatewayType) ||
-        isTerminalGatewayType(signals.upstreamType) ||
-        signals.gatewayName === "GatewayInvalidRequestError") {
-        return "terminal";
-    }
-    const status = signals.statusCode;
-    if (status !== undefined) {
-        // 408/409/429 and 5xx are retryable server conditions. Non-retryable
-        // 4xx responses usually point to a structural problem (invalid key,
-        // context exceeded, malformed prompt) that repeating the same request
-        // will not fix.
-        if (status === 408 || status === 409 || status === 429 || status >= 500)
-            return "retry";
-        if (isAmbiguousGatewayInternalBadRequest(signals))
-            return "recoverable";
-        if (status >= 400 && status < 500)
-            return "terminal";
-    }
-    if (isLikelyNetworkError(error)) {
-        return "retry";
-    }
-    return "recoverable";
-}
-function hasRetryableFlag(error) {
-    for (const candidate of walkCauseChain(error)) {
-        if (isObject(candidate) && candidate.isRetryable === true) {
-            return true;
-        }
-    }
-    return false;
-}
-function isLikelyNetworkError(error) {
-    if (!(error instanceof Error))
-        return false;
-    const message = error.message.toLowerCase();
-    if (message.includes("econnreset") ||
-        message.includes("etimedout") ||
-        message.includes("eai_again") ||
-        message.includes("socket hang up") ||
-        message.includes("network") ||
-        message.includes("fetch failed")) {
-        return true;
-    }
-    if (error.cause !== undefined && error.cause !== error) {
-        return isLikelyNetworkError(error.cause);
-    }
-    return false;
-}
-function readModelCallErrorSignals(error) {
-    const gatewayError = findGatewayError(error);
-    const upstreamError = findUpstreamApiCallError(error);
-    const responseBody = readStringField(upstreamError, "responseBody");
-    const upstreamBody = readGatewayErrorBody(upstreamError);
-    return {
-        gatewayName: readErrorName(gatewayError),
-        gatewayType: readStringField(gatewayError, "type"),
-        generationId: readStringField(gatewayError, "generationId") ?? upstreamBody?.generationId,
-        responseBodySnippet: responseBody === undefined
-            ? undefined
-            : truncateSnippet(responseBody, RESPONSE_BODY_SNIPPET_LIMIT),
-        statusCode: readStatusCode(gatewayError) ?? readStatusCode(upstreamError) ?? findStatusCode(error),
-        upstreamMessage: upstreamBody?.message,
-        upstreamStatusCode: readStatusCode(upstreamError),
-        upstreamType: upstreamBody?.type,
-    };
-}
-function findGatewayError(error) {
-    for (const candidate of walkCauseChain(error)) {
-        const name = readErrorName(candidate);
-        const type = readStringField(candidate, "type");
-        if (name?.startsWith("Gateway") || type?.endsWith("_error") || type === "rate_limit_exceeded") {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-function findUpstreamApiCallError(error) {
-    for (const candidate of walkCauseChain(error)) {
-        const name = readErrorName(candidate);
-        if (name === "AI_APICallError" ||
-            readStringField(candidate, "responseBody") !== undefined ||
-            readObjectField(candidate, "data") !== undefined ||
-            readObjectField(candidate, "requestBodyValues") !== undefined) {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-function readGatewayErrorBody(error) {
-    const dataBody = readGatewayErrorBodyFromValue(readObjectField(error, "data"));
-    if (dataBody !== undefined) {
-        return dataBody;
-    }
-    const responseBody = readStringField(error, "responseBody");
-    if (responseBody === undefined) {
-        return undefined;
-    }
-    try {
-        return readGatewayErrorBodyFromValue(JSON.parse(responseBody));
-    }
-    catch {
-        return undefined;
-    }
-}
-function readGatewayErrorBodyFromValue(value) {
-    if (!isObject(value))
-        return undefined;
-    const error = readObjectField(value, "error");
-    if (error === undefined)
-        return undefined;
-    const generationId = readStringField(value, "generationId");
-    const message = readStringField(error, "message");
-    const type = readStringField(error, "type");
-    return message === undefined && type === undefined && generationId === undefined
-        ? undefined
-        : { generationId, message, type };
-}
-function readStatusCode(error) {
-    if (!isObject(error))
-        return undefined;
-    return typeof error.statusCode === "number" ? error.statusCode : undefined;
-}
-function findStatusCode(error) {
-    for (const candidate of walkCauseChain(error)) {
-        const statusCode = readStatusCode(candidate);
-        if (statusCode !== undefined) {
-            return statusCode;
-        }
-    }
-    return undefined;
-}
-function readStringField(value, key) {
-    if (!isObject(value))
-        return undefined;
-    const field = value[key];
-    return typeof field === "string" && field.length > 0 ? field : undefined;
-}
-function readObjectField(value, key) {
-    if (!isObject(value))
-        return undefined;
-    const field = value[key];
-    return isObject(field) ? field : undefined;
-}
-function isRetryableGatewayType(type) {
-    return type === "rate_limit_exceeded" || type === "timeout_error";
-}
-function isTerminalGatewayType(type) {
-    return (type === "authentication_error" ||
-        type === "invalid_request_error" ||
-        type === "model_not_found");
-}
-function isGatewayErrorSignal(signals) {
-    return signals.gatewayName !== undefined || signals.gatewayType !== undefined;
-}
-function isAmbiguousGatewayInternalBadRequest(signals) {
-    return (signals.statusCode === 400 &&
-        (signals.gatewayName === "GatewayInternalServerError" ||
-            signals.gatewayType === "internal_server_error") &&
-        (signals.upstreamType === undefined || signals.upstreamType === "internal_server_error"));
-}
-function* walkCauseChain(error) {
-    const seen = new Set();
-    let current = error;
-    while (isObject(current) && !seen.has(current)) {
-        seen.add(current);
-        yield current;
-        current = current.cause;
-    }
-}
-function appendJsonField(target, key, value) {
-    if (typeof value === "string" && value.length > 0) {
-        target[key] = value;
-        return;
-    }
-    if (typeof value === "number" && Number.isFinite(value)) {
-        target[key] = value;
-    }
-}
-function truncateSnippet(value, maxLength) {
-    if (value.length <= maxLength) {
-        return value;
-    }
-    return `${value.slice(0, maxLength)}...<truncated>`;
-}
+import{isObject}from"#shared/guards.js";var RESPONSE_BODY_SNIPPET_LIMIT=1e3,GATEWAY_MODEL_REQUEST_REJECTED_MESSAGE=`AI Gateway rejected the model request before the agent produced a response.`,UNSUPPORTED_TOOL_TYPE_REGEX=/tool type ['"]([\w.-]+)['"] is not supported/i;function summarizeKnownModelCallConfigError(e){let t=readErrorName(e),n=readErrorMessage(e);return t===`GatewayAuthenticationError`||/AI Gateway authentication/i.test(n)?/Invalid API key/i.test(n)?{name:`AI Gateway authentication failed`,message:"AI Gateway rejected the provided API key. Update or unset `AI_GATEWAY_API_KEY` (check your shell profile if you did not set it for this project) — manage keys at https://vercel.com/dashboard/ai/api-keys. Unsetting it falls back to OIDC via `vercel link` + `vercel env pull`."}:/Invalid OIDC token/i.test(n)?{name:`AI Gateway authentication failed`,message:"AI Gateway rejected the OIDC token. Run `vercel env pull` to refresh `VERCEL_OIDC_TOKEN` in `.env.local`, or set `AI_GATEWAY_API_KEY` — create a key at https://vercel.com/dashboard/ai/api-keys."}:{name:`AI Gateway authentication failed`,message:"AI Gateway received no credentials. Run `vercel link` + `vercel env pull` to populate `VERCEL_OIDC_TOKEN`, or set `AI_GATEWAY_API_KEY` — create a key at https://vercel.com/dashboard/ai/api-keys."}:t===`LoadAPIKeyError`||/API key is missing/i.test(n)?{name:`Model provider API key missing`,message:"The model provider could not load an API key. Export the provider's API key environment variable (for example `AI_GATEWAY_API_KEY` or `OPENAI_API_KEY`) and try again."}:null}function summarizeKnownModelCallRequestError(e){let t=readModelCallErrorSignals(e);return t.statusCode===400&&isGatewayErrorSignal(t)?{name:`AI Gateway model request rejected`,message:GATEWAY_MODEL_REQUEST_REJECTED_MESSAGE}:null}function extractUnsupportedProviderToolTypes(e){let t=new Set;for(let n of walkCauseChain(e)){collectUnsupportedToolTypesFromValue(readObjectField(n,`data`),t);let e=readStringField(n,`responseBody`);if(e!==void 0)try{collectUnsupportedToolTypesFromValue(JSON.parse(e),t)}catch{let n=UNSUPPORTED_TOOL_TYPE_REGEX.exec(e);n?.[1]!==void 0&&t.add(n[1])}}return[...t]}function collectUnsupportedToolTypesFromValue(t,n){if(t!=null){if(typeof t==`string`){let e=UNSUPPORTED_TOOL_TYPE_REGEX.exec(t);e?.[1]!==void 0&&n.add(e[1]);return}if(Array.isArray(t)){for(let e of t)collectUnsupportedToolTypesFromValue(e,n);return}if(isObject(t))for(let e of Object.values(t))collectUnsupportedToolTypesFromValue(e,n)}}function extractModelCallErrorDetails(e){let t=readModelCallErrorSignals(e),n={};return appendJsonField(n,`gatewayName`,t.gatewayName),appendJsonField(n,`gatewayType`,t.gatewayType),appendJsonField(n,`statusCode`,t.statusCode),appendJsonField(n,`generationId`,t.generationId),appendJsonField(n,`upstreamStatusCode`,t.upstreamStatusCode),appendJsonField(n,`upstreamType`,t.upstreamType),appendJsonField(n,`upstreamMessage`,t.upstreamMessage),appendJsonField(n,`responseBodySnippet`,t.responseBodySnippet),n}function readErrorName(t){if(t instanceof Error||isObject(t)&&typeof t.name==`string`)return t.name}function readErrorMessage(t){return t instanceof Error||isObject(t)&&typeof t.message==`string`?t.message:``}function classifyModelCallError(e){if(hasRetryableFlag(e))return`retry`;if(summarizeKnownModelCallConfigError(e)!==null)return`terminal`;let t=readModelCallErrorSignals(e);if(isRetryableGatewayType(t.gatewayType)||isRetryableGatewayType(t.upstreamType))return`retry`;if(isTerminalGatewayType(t.gatewayType)||isTerminalGatewayType(t.upstreamType)||t.gatewayName===`GatewayInvalidRequestError`)return`terminal`;let n=t.statusCode;if(n!==void 0){if(n===408||n===409||n===429||n>=500)return`retry`;if(isAmbiguousGatewayInternalBadRequest(t))return`recoverable`;if(n>=400&&n<500)return`terminal`}return isLikelyNetworkError(e)?`retry`:`recoverable`}function hasRetryableFlag(t){for(let n of walkCauseChain(t))if(isObject(n)&&n.isRetryable===!0)return!0;return!1}function isLikelyNetworkError(e){if(!(e instanceof Error))return!1;let t=e.message.toLowerCase();return t.includes(`econnreset`)||t.includes(`etimedout`)||t.includes(`eai_again`)||t.includes(`socket hang up`)||t.includes(`network`)||t.includes(`fetch failed`)?!0:e.cause!==void 0&&e.cause!==e?isLikelyNetworkError(e.cause):!1}function readModelCallErrorSignals(e){let n=findGatewayError(e),r=findUpstreamApiCallError(e),i=readStringField(r,`responseBody`),a=readGatewayErrorBody(r);return{gatewayName:readErrorName(n),gatewayType:readStringField(n,`type`),generationId:readStringField(n,`generationId`)??a?.generationId,responseBodySnippet:i===void 0?void 0:truncateSnippet(i,RESPONSE_BODY_SNIPPET_LIMIT),statusCode:readStatusCode(n)??readStatusCode(r)??findStatusCode(e),upstreamMessage:a?.message,upstreamStatusCode:readStatusCode(r),upstreamType:a?.type}}function findGatewayError(e){for(let t of walkCauseChain(e)){let e=readErrorName(t),n=readStringField(t,`type`);if(e?.startsWith(`Gateway`)||n?.endsWith(`_error`)||n===`rate_limit_exceeded`)return t}}function findUpstreamApiCallError(e){for(let t of walkCauseChain(e))if(readErrorName(t)===`AI_APICallError`||readStringField(t,`responseBody`)!==void 0||readObjectField(t,`data`)!==void 0||readObjectField(t,`requestBodyValues`)!==void 0)return t}function readGatewayErrorBody(e){let t=readGatewayErrorBodyFromValue(readObjectField(e,`data`));if(t!==void 0)return t;let n=readStringField(e,`responseBody`);if(n!==void 0)try{return readGatewayErrorBodyFromValue(JSON.parse(n))}catch{return}}function readGatewayErrorBodyFromValue(t){if(!isObject(t))return;let n=readObjectField(t,`error`);if(n===void 0)return;let r=readStringField(t,`generationId`),i=readStringField(n,`message`),a=readStringField(n,`type`);return i===void 0&&a===void 0&&r===void 0?void 0:{generationId:r,message:i,type:a}}function readStatusCode(t){if(isObject(t))return typeof t.statusCode==`number`?t.statusCode:void 0}function findStatusCode(e){for(let t of walkCauseChain(e)){let e=readStatusCode(t);if(e!==void 0)return e}}function readStringField(t,n){if(!isObject(t))return;let r=t[n];return typeof r==`string`&&r.length>0?r:void 0}function readObjectField(t,n){if(!isObject(t))return;let r=t[n];return isObject(r)?r:void 0}function isRetryableGatewayType(e){return e===`rate_limit_exceeded`||e===`timeout_error`}function isTerminalGatewayType(e){return e===`authentication_error`||e===`invalid_request_error`||e===`model_not_found`}function isGatewayErrorSignal(e){return e.gatewayName!==void 0||e.gatewayType!==void 0}function isAmbiguousGatewayInternalBadRequest(e){return e.statusCode===400&&(e.gatewayName===`GatewayInternalServerError`||e.gatewayType===`internal_server_error`)&&(e.upstreamType===void 0||e.upstreamType===`internal_server_error`)}function*walkCauseChain(t){let n=new Set,r=t;for(;isObject(r)&&!n.has(r);)n.add(r),yield r,r=r.cause}function appendJsonField(e,t,n){if(typeof n==`string`&&n.length>0){e[t]=n;return}typeof n==`number`&&Number.isFinite(n)&&(e[t]=n)}function truncateSnippet(e,t){return e.length<=t?e:`${e.slice(0,t)}...<truncated>`}export{classifyModelCallError,extractModelCallErrorDetails,extractUnsupportedProviderToolTypes,summarizeKnownModelCallConfigError,summarizeKnownModelCallRequestError};

package/dist/src/harness/otel-integration.js

@@ -1,18 +1 @@
-import { OpenTelemetry } from "#compiled/@ai-sdk/otel/index.js";
-import { registerTelemetry } from "ai";
-let registered = false;
-/**
- * Registers the AI SDK OpenTelemetry integration once so that model
- * calls emit OTel spans. Safe to call multiple times — only the first
- * call has an effect.
- *
- * In AI SDK v7 the built-in OTel tracing was moved to `@ai-sdk/otel`
- * and must be registered explicitly.
- */
-export function ensureOtelIntegration() {
-    if (registered) {
-        return;
-    }
-    registered = true;
-    registerTelemetry(new OpenTelemetry());
-}
+import{registerTelemetry}from"ai";import{OpenTelemetry}from"#compiled/@ai-sdk/otel/index.js";var registered=!1;function ensureOtelIntegration(){registered||(registered=!0,registerTelemetry(new OpenTelemetry))}export{ensureOtelIntegration};

package/dist/src/harness/prompt-cache.js

@@ -1,137 +1 @@
-/**
- * Shared frozen marker. All direct-Anthropic breakpoints in the harness share
- * this instance to avoid allocating per-message.
- */
-const ANTHROPIC_CACHE_MARKER = Object.freeze({
-    anthropic: Object.freeze({
-        cacheControl: Object.freeze({ type: "ephemeral" }),
-    }),
-});
-/**
- * Detects which prompt caching path applies to a resolved model.
- *
- * Runs once per harness step right after `resolveModel()`.
- */
-export function detectPromptCachePath(model) {
-    if (typeof model === "string") {
-        return { kind: "gateway-auto" };
-    }
-    const providerName = typeof model.provider === "string" ? model.provider.toLowerCase() : "";
-    if (providerName.includes("anthropic")) {
-        return { kind: "anthropic-direct" };
-    }
-    return { kind: "none" };
-}
-/**
- * Returns the shared Anthropic cache marker used on the `anthropic-direct`
- * path. Exposed for unit tests and for the harness wiring layer.
- */
-export function getAnthropicCacheMarker() {
-    return ANTHROPIC_CACHE_MARKER;
-}
-/**
- * Returns a new `providerOptions` object with
- * `gateway.caching = "auto"` merged into the existing `gateway` sub-object.
- *
- * Preserves any existing author-provided `gateway` keys (such as
- * `order: ["anthropic", "bedrock"]` load balancing), and leaves an
- * explicit author override on `gateway.caching` untouched so callers can
- * opt out by setting `providerOptions.gateway.caching` to `false` or
- * another value.
- */
-export function mergeGatewayAutoCaching(base) {
-    const baseGateway = base?.gateway !== undefined && typeof base.gateway === "object" && base.gateway !== null
-        ? base.gateway
-        : undefined;
-    const mergedGateway = {
-        ...baseGateway,
-        caching: baseGateway?.caching ?? "auto",
-    };
-    return {
-        ...base,
-        gateway: mergedGateway,
-    };
-}
-/**
- * Returns a new ToolSet where the last tool entry carries the Anthropic
- * cache marker on `providerOptions`. Used on the `anthropic-direct` path
- * to place a stable breakpoint at the end of the tools block, caching the
- * full tool definitions across every turn.
- *
- * No-op when `tools` has no entries. Preserves existing `providerOptions`
- * on tools (merges the cache marker in via spread).
- */
-export function applyLastToolCacheBreakpoint(tools, marker) {
-    const entries = Object.entries(tools);
-    if (entries.length === 0) {
-        return tools;
-    }
-    const result = {};
-    for (let i = 0; i < entries.length; i++) {
-        const [name, tool] = entries[i];
-        if (i === entries.length - 1) {
-            const existingProviderOptions = tool.providerOptions !== undefined && typeof tool.providerOptions === "object"
-                ? tool.providerOptions
-                : undefined;
-            result[name] = {
-                ...tool,
-                providerOptions: {
-                    ...existingProviderOptions,
-                    ...marker,
-                },
-            };
-        }
-        else {
-            result[name] = tool;
-        }
-    }
-    return result;
-}
-/**
- * Walks backward through `messages` and attaches the Anthropic cache marker
- * to the most recent `assistant` and most recent `user` message. Returns a
- * new array; does not mutate the input.
- *
- * This implements the "automatic cache advancement" pattern: each turn the
- * breakpoints move forward, and the prior turn's breakpoints still warm the
- * cache prefix, so the new breakpoints just extend the cached region.
- *
- * Tool-result messages (`role: "tool"`) are intentionally skipped — the
- * adjacent assistant message's cache marker already covers the prefix
- * through any preceding tool results.
- */
-export function applyConversationCacheControl(messages, marker) {
-    if (messages.length === 0) {
-        return [...messages];
-    }
-    const out = [...messages];
-    let foundAssistant = false;
-    let foundUser = false;
-    for (let i = out.length - 1; i >= 0 && (!foundAssistant || !foundUser); i--) {
-        const message = out[i];
-        if (message === undefined) {
-            continue;
-        }
-        if (!foundAssistant && message.role === "assistant") {
-            out[i] = {
-                ...message,
-                providerOptions: {
-                    ...message.providerOptions,
-                    ...marker,
-                },
-            };
-            foundAssistant = true;
-        }
-        else if (!foundUser && message.role === "user") {
-            out[i] = {
-                ...message,
-                providerOptions: {
-                    ...message.providerOptions,
-                    ...marker,
-                },
-            };
-            foundUser = true;
-        }
-    }
-    return out;
-}
+var ANTHROPIC_CACHE_MARKER=Object.freeze({anthropic:Object.freeze({cacheControl:Object.freeze({type:`ephemeral`})})});function detectPromptCachePath(e){return typeof e==`string`?{kind:`gateway-auto`}:(typeof e.provider==`string`?e.provider.toLowerCase():``).includes(`anthropic`)?{kind:`anthropic-direct`}:{kind:`none`}}function getAnthropicCacheMarker(){return ANTHROPIC_CACHE_MARKER}function mergeGatewayAutoCaching(e){let t=e?.gateway!==void 0&&typeof e.gateway==`object`&&e.gateway!==null?e.gateway:void 0,n={...t,caching:t?.caching??`auto`};return{...e,gateway:n}}function applyLastToolCacheBreakpoint(e,t){let n=Object.entries(e);if(n.length===0)return e;let r={};for(let e=0;e<n.length;e++){let[i,a]=n[e];if(e===n.length-1){let e=a.providerOptions!==void 0&&typeof a.providerOptions==`object`?a.providerOptions:void 0;r[i]={...a,providerOptions:{...e,...t}}}else r[i]=a}return r}function applyConversationCacheControl(e,t){if(e.length===0)return[...e];let n=[...e],r=!1,i=!1;for(let e=n.length-1;e>=0&&(!r||!i);e--){let a=n[e];a!==void 0&&(!r&&a.role===`assistant`?(n[e]={...a,providerOptions:{...a.providerOptions,...t}},r=!0):!i&&a.role===`user`&&(n[e]={...a,providerOptions:{...a.providerOptions,...t}},i=!0))}return n}export{applyConversationCacheControl,applyLastToolCacheBreakpoint,detectPromptCachePath,getAnthropicCacheMarker,mergeGatewayAutoCaching};

package/dist/src/harness/provider-tools.js

@@ -1,137 +1 @@
-import { WEB_SEARCH_TOOL_DEFINITION } from "#runtime/framework-tools/web-search.js";
-import { isObject } from "#shared/guards.js";
-/**
- * Maps an upstream provider tool type (the literal `type` string the AI SDK
- * sends to the provider) back to the framework tool name that injected it.
- *
- * Used when the AI Gateway routes a request to a fallback provider that
- * does not support a provider-specific tool — the upstream error references
- * the provider-specific type (e.g. `web_search_20250305`), but the harness
- * needs to drop the framework tool by its public name (`web_search`).
- *
- * Adding a new provider tool requires adding the corresponding mapping
- * entry here alongside its {@link resolveWebSearchProviderTool} switch
- * arm so detection stays in lockstep with injection.
- */
-const UPSTREAM_TOOL_TYPE_TO_FRAMEWORK_NAME = {
-    // Anthropic's stable web search tool. The Bedrock and Vertex
-    // Anthropic backends reject this type because they only host the
-    // older Claude Messages surface.
-    web_search_20250305: WEB_SEARCH_TOOL_DEFINITION.name,
-};
-/**
- * Returns the framework tool name that produced an upstream provider tool
- * `type`, or `null` when the type is not one we know how to remove.
- *
- * Used by the harness recovery path to decide which tools to drop when a
- * gateway fallback provider rejects a tool. Unknown types fall through to
- * the existing terminal/recoverable handling.
- */
-export function resolveFrameworkToolFromUpstreamType(type) {
-    return UPSTREAM_TOOL_TYPE_TO_FRAMEWORK_NAME[type] ?? null;
-}
-/**
- * Maps a {@link WebSearchBackend} to the gateway provider slug used in
- * `providerOptions.gateway.only` to pin routing to that provider.
- *
- * Returns `null` for the `"gateway"` backend (Perplexity via AI Gateway),
- * which is served by the gateway directly and does not need pinning.
- */
-export function resolveGatewayPinForWebSearchBackend(backend) {
-    switch (backend) {
-        case "anthropic":
-            return "anthropic";
-        case "openai":
-            return "openai";
-        case "google":
-            return "google";
-        case "gateway":
-            return null;
-    }
-}
-/**
- * Returns a new `providerOptions` object with
- * `gateway.only = [provider]` merged into the existing `gateway`
- * sub-object so the AI Gateway only attempts the given provider.
- *
- * Used by the harness to pin routing when a provider-specific tool
- * (e.g. Anthropic's `web_search_20250305`) is in the per-step toolset,
- * so a transient primary outage produces a clean retryable 503 instead
- * of a fallback-to-incompatible-provider 400.
- *
- * Author overrides win — if `base.gateway.only` or `base.gateway.order`
- * is already set, the input is returned unchanged so explicit routing
- * preferences are never silently overwritten.
- */
-export function mergeGatewayProviderPin(base, provider) {
-    const baseGateway = isObject(base?.gateway)
-        ? base.gateway
-        : undefined;
-    if (baseGateway?.only !== undefined || baseGateway?.order !== undefined) {
-        return { ...base };
-    }
-    const mergedGateway = {
-        ...baseGateway,
-        only: [provider],
-    };
-    return {
-        ...base,
-        gateway: mergedGateway,
-    };
-}
-/**
- * Determines the web search backend for a model reference.
- *
- * - OpenAI models (gateway or BYO): native OpenAI search
- * - Anthropic models (gateway or BYO): native Anthropic search
- * - Direct/BYO Google models: native Google search grounding
- * - Other models on AI Gateway (including `google/...`): Perplexity search via gateway
- * - Other BYO models: not available (returns `null`)
- */
-export function resolveWebSearchBackend(modelRef) {
-    const providerId = modelRef.id.split("/")[0] ?? "";
-    if (providerId === "openai" || providerId.startsWith("openai.")) {
-        return "openai";
-    }
-    if (providerId === "anthropic" || providerId.startsWith("anthropic.")) {
-        return "anthropic";
-    }
-    if (providerId.startsWith("google.")) {
-        return "google";
-    }
-    if (modelRef.source === undefined) {
-        return "gateway";
-    }
-    return null;
-}
-/**
- * Constructs the AI SDK provider tool for web search based on the resolved
- * backend. Called once per harness step when web search is enabled.
- *
- * Dynamic imports keep unused provider SDKs out of the bundle — only the
- * provider matching the current model is loaded.
- */
-export async function resolveWebSearchProviderTool(backend) {
-    switch (backend) {
-        case "openai": {
-            const { openai } = await import("#compiled/@ai-sdk/openai/index.js");
-            return openai.tools.webSearch({});
-        }
-        case "anthropic": {
-            const { anthropic } = await import("#compiled/@ai-sdk/anthropic/index.js");
-            // `webSearch_20260209()` in @ai-sdk/anthropic@3.0.68 adds the
-            // `code-execution-web-tools-2026-02-09` beta header, which Anthropic
-            // currently rejects. Keep Anthropic web search working by using the
-            // stable tool version until the upstream helper is fixed.
-            return anthropic.tools.webSearch_20250305();
-        }
-        case "google": {
-            const { google } = await import("#compiled/@ai-sdk/google/index.js");
-            return google.tools.googleSearch({});
-        }
-        case "gateway": {
-            const { gateway } = await import("ai");
-            return gateway.tools.perplexitySearch();
-        }
-    }
-}
+import{isObject}from"#shared/guards.js";import{WEB_SEARCH_TOOL_DEFINITION}from"#runtime/framework-tools/web-search.js";var UPSTREAM_TOOL_TYPE_TO_FRAMEWORK_NAME={web_search_20250305:WEB_SEARCH_TOOL_DEFINITION.name};function resolveFrameworkToolFromUpstreamType(e){return UPSTREAM_TOOL_TYPE_TO_FRAMEWORK_NAME[e]??null}function resolveGatewayPinForWebSearchBackend(e){switch(e){case`anthropic`:return`anthropic`;case`openai`:return`openai`;case`google`:return`google`;case`gateway`:return null}}function mergeGatewayProviderPin(t,n){let r=isObject(t?.gateway)?t.gateway:void 0;if(r?.only!==void 0||r?.order!==void 0)return{...t};let i={...r,only:[n]};return{...t,gateway:i}}function resolveWebSearchBackend(e){let t=e.id.split(`/`)[0]??``;return t===`openai`||t.startsWith(`openai.`)?`openai`:t===`anthropic`||t.startsWith(`anthropic.`)?`anthropic`:t.startsWith(`google.`)?`google`:e.source===void 0?`gateway`:null}async function resolveWebSearchProviderTool(e){switch(e){case`openai`:{let{openai:e}=await import(`#compiled/@ai-sdk/openai/index.js`);return e.tools.webSearch({})}case`anthropic`:{let{anthropic:e}=await import(`#compiled/@ai-sdk/anthropic/index.js`);return e.tools.webSearch_20250305()}case`google`:{let{google:e}=await import(`#compiled/@ai-sdk/google/index.js`);return e.tools.googleSearch({})}case`gateway`:{let{gateway:e}=await import(`ai`);return e.tools.perplexitySearch()}}}export{mergeGatewayProviderPin,resolveFrameworkToolFromUpstreamType,resolveGatewayPinForWebSearchBackend,resolveWebSearchBackend,resolveWebSearchProviderTool};