openai 6.48.0 → 6.49.0

package/helpers/standard-schema.js

@@ -0,0 +1,320 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.standardResponseFormat = standardResponseFormat;
+exports.standardTextFormat = standardTextFormat;
+exports.standardFunction = standardFunction;
+exports.standardResponsesFunction = standardResponsesFunction;
+const error_1 = require("../error.js");
+const parser_1 = require("../lib/parser.js");
+const ResponsesParser_1 = require("../lib/ResponsesParser.js");
+const transform_1 = require("../lib/transform.js");
+function isPromiseLike(value) {
+    return typeof value === 'object' && value !== null && 'then' in value && typeof value.then === 'function';
+}
+function formatStandardSchemaIssues(issues) {
+    return issues
+        .map((issue) => {
+        const path = issue.path
+            ?.map((segment) => typeof segment === 'object' && segment !== null && 'key' in segment ? segment.key : segment)
+            .map(String)
+            .join('.');
+        return path ? `${path}: ${issue.message}` : issue.message;
+    })
+        .join('; ');
+}
+const JSON_SCHEMA_TYPES = new Set(['string', 'number', 'integer', 'boolean', 'object', 'array', 'null']);
+function getSchemaTypes(schema) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return undefined;
+    const type = schema['type'];
+    if (type === undefined) {
+        return getLiteralSchemaTypes(schema);
+    }
+    const types = Array.isArray(type) ? type : [type];
+    if (types.length === 0 ||
+        !types.every((value) => typeof value === 'string' && JSON_SCHEMA_TYPES.has(value))) {
+        return undefined;
+    }
+    return new Set(types);
+}
+function isJSONPrimitive(value) {
+    return (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)));
+}
+function getLiteralValues(schema) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return undefined;
+    const record = schema;
+    if ('const' in record && isJSONPrimitive(record['const'])) {
+        return [record['const']];
+    }
+    const enumValues = record['enum'];
+    if (Array.isArray(enumValues) && enumValues.length > 0 && enumValues.every(isJSONPrimitive)) {
+        return enumValues;
+    }
+    return undefined;
+}
+function getLiteralSchemaTypes(schema) {
+    const literalValues = getLiteralValues(schema);
+    if (!literalValues)
+        return undefined;
+    return new Set(literalValues.map((value) => {
+        if (value === null)
+            return 'null';
+        return typeof value;
+    }));
+}
+function haveDisjointLiteralValues(left, right) {
+    const leftValues = getLiteralValues(left);
+    const rightValues = getLiteralValues(right);
+    if (!leftValues || !rightValues)
+        return false;
+    return leftValues.every((leftValue) => !rightValues.some((rightValue) => leftValue === rightValue));
+}
+function schemaTypesOverlap(left, right) {
+    return (left === right || (left === 'integer' && right === 'number') || (left === 'number' && right === 'integer'));
+}
+function isObjectOnlySchema(schema) {
+    const types = getSchemaTypes(schema);
+    return types?.size === 1 && types.has('object');
+}
+function haveDisjointObjectDiscriminator(left, right, root) {
+    if (!isObjectOnlySchema(left) || !isObjectOnlySchema(right))
+        return false;
+    const leftRecord = left;
+    const rightRecord = right;
+    const leftProperties = leftRecord['properties'];
+    const rightProperties = rightRecord['properties'];
+    const leftRequired = leftRecord['required'];
+    const rightRequired = rightRecord['required'];
+    if (!leftProperties ||
+        typeof leftProperties !== 'object' ||
+        Array.isArray(leftProperties) ||
+        !rightProperties ||
+        typeof rightProperties !== 'object' ||
+        Array.isArray(rightProperties) ||
+        !Array.isArray(leftRequired) ||
+        !Array.isArray(rightRequired)) {
+        return false;
+    }
+    for (const property of leftRequired) {
+        if (typeof property === 'string' &&
+            rightRequired.includes(property) &&
+            haveDisjointLiteralValues(resolveLocalRefForExclusivity(leftProperties[property], root), resolveLocalRefForExclusivity(rightProperties[property], root))) {
+            return true;
+        }
+    }
+    return false;
+}
+function getClosedObjectPropertySet(schema) {
+    if (!isObjectOnlySchema(schema))
+        return undefined;
+    const record = schema;
+    const properties = record['properties'];
+    const required = record['required'];
+    if (record['additionalProperties'] !== false ||
+        !properties ||
+        typeof properties !== 'object' ||
+        Array.isArray(properties) ||
+        !Array.isArray(required) ||
+        required.some((property) => typeof property !== 'string')) {
+        return undefined;
+    }
+    const propertySet = new Set(Object.keys(properties));
+    const requiredProperties = required;
+    // A required undeclared property makes a closed branch unsatisfiable, but
+    // the strictifier rejects that shape rather than representing it. Keep this
+    // exclusivity proof conservative and let the normal validation path fail.
+    if (requiredProperties.some((property) => !propertySet.has(property))) {
+        return undefined;
+    }
+    return { properties: propertySet, required: requiredProperties };
+}
+function haveDisjointClosedObjectPropertySets(left, right) {
+    const leftShape = getClosedObjectPropertySet(left);
+    const rightShape = getClosedObjectPropertySet(right);
+    if (!leftShape || !rightShape)
+        return false;
+    // If either closed branch requires a property the other branch does not
+    // declare, every instance satisfying the first is rejected by the second as
+    // an additional property. This proves oneOf exclusivity without widening
+    // overlapping closed shapes.
+    return (leftShape.required.some((property) => !rightShape.properties.has(property)) ||
+        rightShape.required.some((property) => !leftShape.properties.has(property)));
+}
+function areMutuallyExclusive(left, right, root) {
+    const leftTypes = getSchemaTypes(left);
+    const rightTypes = getSchemaTypes(right);
+    if (leftTypes &&
+        rightTypes &&
+        [...leftTypes].every((leftType) => [...rightTypes].every((rightType) => !schemaTypesOverlap(leftType, rightType)))) {
+        return true;
+    }
+    return (haveDisjointLiteralValues(left, right) ||
+        haveDisjointObjectDiscriminator(left, right, root) ||
+        haveDisjointClosedObjectPropertySets(left, right));
+}
+function resolveLocalRefForExclusivity(schema, root, seenRefs = new Set()) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return schema;
+    const record = schema;
+    const ref = record['$ref'];
+    if (ref !== undefined) {
+        // Annotation keywords do not affect Draft 7 validation, so they are safe
+        // to retain while proving the referenced branches are mutually exclusive.
+        // Keep the proof conservative for every other sibling constraint.
+        if (typeof ref !== 'string' || !(0, transform_1.hasOnlyRefAndAnnotations)(record)) {
+            return undefined;
+        }
+        if (seenRefs.has(ref))
+            return undefined;
+        const resolved = (0, transform_1.resolveLocalRef)(root, ref);
+        if (resolved === undefined)
+            return undefined;
+        return resolveLocalRefForExclusivity(resolved, root, new Set([...seenRefs, ref]));
+    }
+    if (record['allOf'] !== undefined) {
+        if (!Array.isArray(record['allOf']))
+            return undefined;
+        const normalized = (0, transform_1.normalizeObjectAllOfForExclusivity)(record, root);
+        if (normalized === undefined)
+            return undefined;
+        // Flattening a singleton allOf can expose a bare local ref. Feed that
+        // result through this same resolver so URI-fragment decoding and the
+        // existing local-ref cycle guard still apply before exclusivity analysis.
+        return resolveLocalRefForExclusivity(normalized, root, seenRefs);
+    }
+    return schema;
+}
+function areOneOfBranchesMutuallyExclusive(branches, root) {
+    for (let index = 0; index < branches.length; index++) {
+        for (let otherIndex = index + 1; otherIndex < branches.length; otherIndex++) {
+            const left = resolveLocalRefForExclusivity(branches[index], root);
+            const right = resolveLocalRefForExclusivity(branches[otherIndex], root);
+            if (left === undefined || right === undefined || !areMutuallyExclusive(left, right, root)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+function normalizeStructuredOutputSchema(schema) {
+    (0, transform_1.assertNoNestedSchemaIds)(schema);
+    const normalizedSchema = structuredClone(schema);
+    const oneOfSchemas = [];
+    const visitedSchemas = new Set();
+    const visitSchema = (value) => {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return;
+        const record = value;
+        if (visitedSchemas.has(record))
+            return;
+        visitedSchemas.add(record);
+        if (record['oneOf'] !== undefined) {
+            if (!Array.isArray(record['oneOf'])) {
+                throw new error_1.OpenAIError('Standard JSON Schema generated an invalid `oneOf`, which cannot be represented in an OpenAI strict schema');
+            }
+            if (record['anyOf'] !== undefined) {
+                throw new error_1.OpenAIError('Standard JSON Schema generated both `anyOf` and `oneOf`, which cannot be represented in an OpenAI strict schema');
+            }
+            // `false` can never validate, so it cannot overlap another oneOf
+            // branch. Keep it in place until the existing anyOf normalization runs
+            // so local refs into surviving branch indices can be rewritten before
+            // the impossible alternatives are removed.
+            const possibleBranches = record['oneOf'].filter((branch) => branch !== false);
+            if (!areOneOfBranchesMutuallyExclusive(possibleBranches, normalizedSchema)) {
+                throw new error_1.OpenAIError('Standard JSON Schema generated a `oneOf` whose branches are not provably mutually exclusive. OpenAI strict schemas do not support `oneOf`; use `anyOf` or add a discriminator with distinct literal values.');
+            }
+            oneOfSchemas.push(record);
+        }
+        (0, transform_1.forEachJSONSchemaChild)(record, [], (child) => visitSchema(child));
+    };
+    visitSchema(normalizedSchema);
+    (0, transform_1.rewriteLocalRefsIntoMovedOneOfBranches)(normalizedSchema);
+    for (const record of oneOfSchemas) {
+        record['anyOf'] = record['oneOf'];
+        delete record['oneOf'];
+    }
+    return normalizedSchema;
+}
+function parseStandardSchema(standardSchema, content) {
+    const result = standardSchema['~standard'].validate(JSON.parse(content));
+    if (isPromiseLike(result)) {
+        void Promise.resolve(result).catch(() => undefined);
+        throw new error_1.OpenAIError('Standard Schema helpers only support synchronous validation. Use a schema with a synchronous `~standard.validate()` implementation.');
+    }
+    if (result.issues) {
+        throw new error_1.OpenAIError(`Standard Schema validation failed: ${formatStandardSchemaIssues(result.issues)}`);
+    }
+    return result.value;
+}
+function resolveStandardJSONSchema(standardSchema, schemaOverride) {
+    const schema = (schemaOverride ?? standardSchema['~standard'].jsonSchema?.input({ target: 'draft-07' }));
+    if (!schema) {
+        throw new error_1.OpenAIError('Standard Schema helpers require a JSON Schema. Pass `schema` or use a schema that implements `~standard.jsonSchema.input()`.');
+    }
+    return (0, transform_1.toStrictJsonSchema)(normalizeStructuredOutputSchema(schema));
+}
+/**
+ * Creates a chat completion `JSONSchema` response format from a Standard
+ * Schema validator.
+ *
+ * The helper uses `~standard.jsonSchema.input()` for the model-facing schema
+ * and `~standard.validate()` for parsed output. Validation must be
+ * synchronous because the SDK's parse helpers are synchronous.
+ */
+function standardResponseFormat(standardSchema, name, props) {
+    const { schema, ...formatProps } = props ?? {};
+    return (0, parser_1.makeParseableResponseFormat)({
+        type: 'json_schema',
+        json_schema: {
+            ...formatProps,
+            name,
+            strict: true,
+            schema: resolveStandardJSONSchema(standardSchema, schema),
+        },
+    }, (content) => parseStandardSchema(standardSchema, content));
+}
+/**
+ * Creates a Responses API `json_schema` text format from a Standard Schema
+ * validator.
+ */
+function standardTextFormat(standardSchema, name, props) {
+    const { schema, ...formatProps } = props ?? {};
+    return (0, parser_1.makeParseableTextFormat)({
+        type: 'json_schema',
+        ...formatProps,
+        name,
+        strict: true,
+        schema: resolveStandardJSONSchema(standardSchema, schema),
+    }, (content) => parseStandardSchema(standardSchema, content));
+}
+function standardFunction(options) {
+    return (0, parser_1.makeParseableTool)({
+        type: 'function',
+        function: {
+            name: options.name,
+            parameters: resolveStandardJSONSchema(options.parameters, options.schema),
+            strict: true,
+            ...(options.description ? { description: options.description } : undefined),
+        },
+    }, {
+        callback: options.function,
+        parser: (args) => parseStandardSchema(options.parameters, args),
+    });
+}
+function standardResponsesFunction(options) {
+    return (0, ResponsesParser_1.makeParseableResponseTool)({
+        type: 'function',
+        name: options.name,
+        parameters: resolveStandardJSONSchema(options.parameters, options.schema),
+        strict: true,
+        ...(options.description ? { description: options.description } : undefined),
+    }, {
+        callback: options.function,
+        parser: (args) => parseStandardSchema(options.parameters, args),
+    });
+}
+//# sourceMappingURL=standard-schema.js.map

package/helpers/standard-schema.js.map

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

package/helpers/standard-schema.mjs

@@ -0,0 +1,314 @@
+import { OpenAIError } from "../error.mjs";
+import { makeParseableResponseFormat, makeParseableTextFormat, makeParseableTool, } from "../lib/parser.mjs";
+import { makeParseableResponseTool } from "../lib/ResponsesParser.mjs";
+import { assertNoNestedSchemaIds, forEachJSONSchemaChild, hasOnlyRefAndAnnotations, normalizeObjectAllOfForExclusivity, resolveLocalRef, rewriteLocalRefsIntoMovedOneOfBranches, toStrictJsonSchema, } from "../lib/transform.mjs";
+function isPromiseLike(value) {
+    return typeof value === 'object' && value !== null && 'then' in value && typeof value.then === 'function';
+}
+function formatStandardSchemaIssues(issues) {
+    return issues
+        .map((issue) => {
+        const path = issue.path
+            ?.map((segment) => typeof segment === 'object' && segment !== null && 'key' in segment ? segment.key : segment)
+            .map(String)
+            .join('.');
+        return path ? `${path}: ${issue.message}` : issue.message;
+    })
+        .join('; ');
+}
+const JSON_SCHEMA_TYPES = new Set(['string', 'number', 'integer', 'boolean', 'object', 'array', 'null']);
+function getSchemaTypes(schema) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return undefined;
+    const type = schema['type'];
+    if (type === undefined) {
+        return getLiteralSchemaTypes(schema);
+    }
+    const types = Array.isArray(type) ? type : [type];
+    if (types.length === 0 ||
+        !types.every((value) => typeof value === 'string' && JSON_SCHEMA_TYPES.has(value))) {
+        return undefined;
+    }
+    return new Set(types);
+}
+function isJSONPrimitive(value) {
+    return (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)));
+}
+function getLiteralValues(schema) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return undefined;
+    const record = schema;
+    if ('const' in record && isJSONPrimitive(record['const'])) {
+        return [record['const']];
+    }
+    const enumValues = record['enum'];
+    if (Array.isArray(enumValues) && enumValues.length > 0 && enumValues.every(isJSONPrimitive)) {
+        return enumValues;
+    }
+    return undefined;
+}
+function getLiteralSchemaTypes(schema) {
+    const literalValues = getLiteralValues(schema);
+    if (!literalValues)
+        return undefined;
+    return new Set(literalValues.map((value) => {
+        if (value === null)
+            return 'null';
+        return typeof value;
+    }));
+}
+function haveDisjointLiteralValues(left, right) {
+    const leftValues = getLiteralValues(left);
+    const rightValues = getLiteralValues(right);
+    if (!leftValues || !rightValues)
+        return false;
+    return leftValues.every((leftValue) => !rightValues.some((rightValue) => leftValue === rightValue));
+}
+function schemaTypesOverlap(left, right) {
+    return (left === right || (left === 'integer' && right === 'number') || (left === 'number' && right === 'integer'));
+}
+function isObjectOnlySchema(schema) {
+    const types = getSchemaTypes(schema);
+    return types?.size === 1 && types.has('object');
+}
+function haveDisjointObjectDiscriminator(left, right, root) {
+    if (!isObjectOnlySchema(left) || !isObjectOnlySchema(right))
+        return false;
+    const leftRecord = left;
+    const rightRecord = right;
+    const leftProperties = leftRecord['properties'];
+    const rightProperties = rightRecord['properties'];
+    const leftRequired = leftRecord['required'];
+    const rightRequired = rightRecord['required'];
+    if (!leftProperties ||
+        typeof leftProperties !== 'object' ||
+        Array.isArray(leftProperties) ||
+        !rightProperties ||
+        typeof rightProperties !== 'object' ||
+        Array.isArray(rightProperties) ||
+        !Array.isArray(leftRequired) ||
+        !Array.isArray(rightRequired)) {
+        return false;
+    }
+    for (const property of leftRequired) {
+        if (typeof property === 'string' &&
+            rightRequired.includes(property) &&
+            haveDisjointLiteralValues(resolveLocalRefForExclusivity(leftProperties[property], root), resolveLocalRefForExclusivity(rightProperties[property], root))) {
+            return true;
+        }
+    }
+    return false;
+}
+function getClosedObjectPropertySet(schema) {
+    if (!isObjectOnlySchema(schema))
+        return undefined;
+    const record = schema;
+    const properties = record['properties'];
+    const required = record['required'];
+    if (record['additionalProperties'] !== false ||
+        !properties ||
+        typeof properties !== 'object' ||
+        Array.isArray(properties) ||
+        !Array.isArray(required) ||
+        required.some((property) => typeof property !== 'string')) {
+        return undefined;
+    }
+    const propertySet = new Set(Object.keys(properties));
+    const requiredProperties = required;
+    // A required undeclared property makes a closed branch unsatisfiable, but
+    // the strictifier rejects that shape rather than representing it. Keep this
+    // exclusivity proof conservative and let the normal validation path fail.
+    if (requiredProperties.some((property) => !propertySet.has(property))) {
+        return undefined;
+    }
+    return { properties: propertySet, required: requiredProperties };
+}
+function haveDisjointClosedObjectPropertySets(left, right) {
+    const leftShape = getClosedObjectPropertySet(left);
+    const rightShape = getClosedObjectPropertySet(right);
+    if (!leftShape || !rightShape)
+        return false;
+    // If either closed branch requires a property the other branch does not
+    // declare, every instance satisfying the first is rejected by the second as
+    // an additional property. This proves oneOf exclusivity without widening
+    // overlapping closed shapes.
+    return (leftShape.required.some((property) => !rightShape.properties.has(property)) ||
+        rightShape.required.some((property) => !leftShape.properties.has(property)));
+}
+function areMutuallyExclusive(left, right, root) {
+    const leftTypes = getSchemaTypes(left);
+    const rightTypes = getSchemaTypes(right);
+    if (leftTypes &&
+        rightTypes &&
+        [...leftTypes].every((leftType) => [...rightTypes].every((rightType) => !schemaTypesOverlap(leftType, rightType)))) {
+        return true;
+    }
+    return (haveDisjointLiteralValues(left, right) ||
+        haveDisjointObjectDiscriminator(left, right, root) ||
+        haveDisjointClosedObjectPropertySets(left, right));
+}
+function resolveLocalRefForExclusivity(schema, root, seenRefs = new Set()) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return schema;
+    const record = schema;
+    const ref = record['$ref'];
+    if (ref !== undefined) {
+        // Annotation keywords do not affect Draft 7 validation, so they are safe
+        // to retain while proving the referenced branches are mutually exclusive.
+        // Keep the proof conservative for every other sibling constraint.
+        if (typeof ref !== 'string' || !hasOnlyRefAndAnnotations(record)) {
+            return undefined;
+        }
+        if (seenRefs.has(ref))
+            return undefined;
+        const resolved = resolveLocalRef(root, ref);
+        if (resolved === undefined)
+            return undefined;
+        return resolveLocalRefForExclusivity(resolved, root, new Set([...seenRefs, ref]));
+    }
+    if (record['allOf'] !== undefined) {
+        if (!Array.isArray(record['allOf']))
+            return undefined;
+        const normalized = normalizeObjectAllOfForExclusivity(record, root);
+        if (normalized === undefined)
+            return undefined;
+        // Flattening a singleton allOf can expose a bare local ref. Feed that
+        // result through this same resolver so URI-fragment decoding and the
+        // existing local-ref cycle guard still apply before exclusivity analysis.
+        return resolveLocalRefForExclusivity(normalized, root, seenRefs);
+    }
+    return schema;
+}
+function areOneOfBranchesMutuallyExclusive(branches, root) {
+    for (let index = 0; index < branches.length; index++) {
+        for (let otherIndex = index + 1; otherIndex < branches.length; otherIndex++) {
+            const left = resolveLocalRefForExclusivity(branches[index], root);
+            const right = resolveLocalRefForExclusivity(branches[otherIndex], root);
+            if (left === undefined || right === undefined || !areMutuallyExclusive(left, right, root)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+function normalizeStructuredOutputSchema(schema) {
+    assertNoNestedSchemaIds(schema);
+    const normalizedSchema = structuredClone(schema);
+    const oneOfSchemas = [];
+    const visitedSchemas = new Set();
+    const visitSchema = (value) => {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            return;
+        const record = value;
+        if (visitedSchemas.has(record))
+            return;
+        visitedSchemas.add(record);
+        if (record['oneOf'] !== undefined) {
+            if (!Array.isArray(record['oneOf'])) {
+                throw new OpenAIError('Standard JSON Schema generated an invalid `oneOf`, which cannot be represented in an OpenAI strict schema');
+            }
+            if (record['anyOf'] !== undefined) {
+                throw new OpenAIError('Standard JSON Schema generated both `anyOf` and `oneOf`, which cannot be represented in an OpenAI strict schema');
+            }
+            // `false` can never validate, so it cannot overlap another oneOf
+            // branch. Keep it in place until the existing anyOf normalization runs
+            // so local refs into surviving branch indices can be rewritten before
+            // the impossible alternatives are removed.
+            const possibleBranches = record['oneOf'].filter((branch) => branch !== false);
+            if (!areOneOfBranchesMutuallyExclusive(possibleBranches, normalizedSchema)) {
+                throw new OpenAIError('Standard JSON Schema generated a `oneOf` whose branches are not provably mutually exclusive. OpenAI strict schemas do not support `oneOf`; use `anyOf` or add a discriminator with distinct literal values.');
+            }
+            oneOfSchemas.push(record);
+        }
+        forEachJSONSchemaChild(record, [], (child) => visitSchema(child));
+    };
+    visitSchema(normalizedSchema);
+    rewriteLocalRefsIntoMovedOneOfBranches(normalizedSchema);
+    for (const record of oneOfSchemas) {
+        record['anyOf'] = record['oneOf'];
+        delete record['oneOf'];
+    }
+    return normalizedSchema;
+}
+function parseStandardSchema(standardSchema, content) {
+    const result = standardSchema['~standard'].validate(JSON.parse(content));
+    if (isPromiseLike(result)) {
+        void Promise.resolve(result).catch(() => undefined);
+        throw new OpenAIError('Standard Schema helpers only support synchronous validation. Use a schema with a synchronous `~standard.validate()` implementation.');
+    }
+    if (result.issues) {
+        throw new OpenAIError(`Standard Schema validation failed: ${formatStandardSchemaIssues(result.issues)}`);
+    }
+    return result.value;
+}
+function resolveStandardJSONSchema(standardSchema, schemaOverride) {
+    const schema = (schemaOverride ?? standardSchema['~standard'].jsonSchema?.input({ target: 'draft-07' }));
+    if (!schema) {
+        throw new OpenAIError('Standard Schema helpers require a JSON Schema. Pass `schema` or use a schema that implements `~standard.jsonSchema.input()`.');
+    }
+    return toStrictJsonSchema(normalizeStructuredOutputSchema(schema));
+}
+/**
+ * Creates a chat completion `JSONSchema` response format from a Standard
+ * Schema validator.
+ *
+ * The helper uses `~standard.jsonSchema.input()` for the model-facing schema
+ * and `~standard.validate()` for parsed output. Validation must be
+ * synchronous because the SDK's parse helpers are synchronous.
+ */
+export function standardResponseFormat(standardSchema, name, props) {
+    const { schema, ...formatProps } = props ?? {};
+    return makeParseableResponseFormat({
+        type: 'json_schema',
+        json_schema: {
+            ...formatProps,
+            name,
+            strict: true,
+            schema: resolveStandardJSONSchema(standardSchema, schema),
+        },
+    }, (content) => parseStandardSchema(standardSchema, content));
+}
+/**
+ * Creates a Responses API `json_schema` text format from a Standard Schema
+ * validator.
+ */
+export function standardTextFormat(standardSchema, name, props) {
+    const { schema, ...formatProps } = props ?? {};
+    return makeParseableTextFormat({
+        type: 'json_schema',
+        ...formatProps,
+        name,
+        strict: true,
+        schema: resolveStandardJSONSchema(standardSchema, schema),
+    }, (content) => parseStandardSchema(standardSchema, content));
+}
+export function standardFunction(options) {
+    return makeParseableTool({
+        type: 'function',
+        function: {
+            name: options.name,
+            parameters: resolveStandardJSONSchema(options.parameters, options.schema),
+            strict: true,
+            ...(options.description ? { description: options.description } : undefined),
+        },
+    }, {
+        callback: options.function,
+        parser: (args) => parseStandardSchema(options.parameters, args),
+    });
+}
+export function standardResponsesFunction(options) {
+    return makeParseableResponseTool({
+        type: 'function',
+        name: options.name,
+        parameters: resolveStandardJSONSchema(options.parameters, options.schema),
+        strict: true,
+        ...(options.description ? { description: options.description } : undefined),
+    }, {
+        callback: options.function,
+        parser: (args) => parseStandardSchema(options.parameters, args),
+    });
+}
+//# sourceMappingURL=standard-schema.mjs.map