agentfootprint/dist/provider-contract/nativeOutputSchema.js

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

"use strict";
/**
 * nativeOutputSchema — whether a provider puts a structured-output format
 * (`LLMRequest.outputFormat`) on its wire FOR A MODEL, and the one error for
 * a model or adapter that does not.
 *
 * Pattern: capability declaration + readers (the `forcedToolChoice.ts`
 *          twin). The adapter declares `LLMProvider.carriesNativeOutputSchema`
 *          plus `supportsNativeOutputSchema(model)`, and everything that sends
 *          `LLMRequest.outputFormat` asks HERE with the model it will call:
 *          the agent's `'native'` output strategy at run start and again at
 *          request assembly. Auto additionally requires the positive model
 *          knowledge declared by `supportsAutoNativeOutputSchema`.
 * Role:    Port-level, beside `types.ts`.
 *
 * Why per model: Anthropic's structured outputs are available on the models
 * its page lists — Claude Haiku 4.5, Sonnet 4.5, Opus 4.5 and every later
 * model — and not on Opus 4.1 and earlier
 * (https://platform.claude.com/docs/en/build-with-claude/structured-outputs).
 * The per-model facts are the `nativeOutputSchema` column of
 * `../adapters/llm/anthropicModels.ts · ANTHROPIC_MODELS`.
 *
 * @example
 * ```ts
 * import { anthropic, nativeOutputSchemaFor } from 'agentfootprint/providers';
 *
 * nativeOutputSchemaFor(anthropic(), 'claude-haiku-4-5'); // true
 * nativeOutputSchemaFor(anthropic(), 'claude-opus-4-1');  // false
 * ```
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.UnsupportedNativeOutputError = exports.autoNativeOutputSchemaFor = exports.nativeOutputSchemaFor = void 0;
/**
 * Whether `provider` puts a structured-output format on its wire for `model`.
 * Absence — or anything but `true` — means NO: a format that quietly vanishes
 * costs the guarantee it was asked for.
 */
function nativeOutputSchemaFor(provider, model) {
    return (provider.carriesNativeOutputSchema === true &&
        (provider.supportsNativeOutputSchema === undefined ||
            provider.supportsNativeOutputSchema(model) === true));
}
exports.nativeOutputSchemaFor = nativeOutputSchemaFor;
/** Auto requires positive model knowledge; explicit native keeps its existing
 * forward-compatible capability policy. Never infer knowledge from a name. */
function autoNativeOutputSchemaFor(provider, model) {
    return (nativeOutputSchemaFor(provider, model) &&
        provider.supportsAutoNativeOutputSchema?.(model) === true);
}
exports.autoNativeOutputSchemaFor = autoNativeOutputSchemaFor;
/**
 * UnsupportedNativeOutputError — a structured-output format for a model or
 * adapter that does not take one, refused by name BEFORE anything is sent.
 *
 * Asking again sends the same request: `retryable: false`, which `withRetry`'s
 * default policy honours; `withFallback` does not move the call to its other
 * side and `withCircuitBreaker` does not count it (`requestRefusal.ts`).
 *
 * @example
 * ```ts
 * import { UnsupportedNativeOutputError } from 'agentfootprint/providers';
 *
 * try {
 *   await agent.run('…');
 * } catch (err) {
 *   if (err instanceof UnsupportedNativeOutputError) console.error(err.provider, err.model);
 * }
 * ```
 */
class UnsupportedNativeOutputError extends Error {
    /** The provider that answered for the model — `'anthropic'`, `'bedrock'`, … */
    provider;
    /** The model the request named. */
    model;
    /** Asking again cannot mend it — read by `withRetry`'s default predicate. */
    retryable = false;
    constructor(args) {
        super(`[${args.provider}] '${args.model}' does not take a native structured-output format on ` +
            `this adapter. .outputSchema(…, { strategy: 'native' }) requires it; use ` +
            `{ strategy: 'instruct' } here, or a provider and model that take one ` +
            `(anthropic() or browserAnthropic() with Claude Haiku 4.5, Sonnet 4.5, Opus 4.5 or later).`);
        this.name = 'UnsupportedNativeOutputError';
        this.provider = args.provider;
        this.model = args.model;
    }
}
exports.UnsupportedNativeOutputError = UnsupportedNativeOutputError;
//# sourceMappingURL=nativeOutputSchema.js.map