@rebyteai/agent-sdk 0.2.0

package/helpers/standard-schema.d.ts

@@ -0,0 +1,240 @@
+import type { AutoParseableResponseFormat, AutoParseableTextFormat, AutoParseableTool } from "../lib/parser.js";
+import type { AutoParseableResponseTool } from "../lib/ResponsesParser.js";
+import type { JSONSchema } from "../lib/jsonschema.js";
+import type { ResponseFormatJSONSchema } from "../resources/index.js";
+import type { ResponseFormatTextJSONSchemaConfig } from "../resources/responses/responses.js";
+/** Validation issue returned by a Standard Schema-compatible validator. */
+type StandardSchemaIssue = {
+    /** Human-readable explanation of the validation failure. */
+    readonly message: string;
+    /** Optional path identifying the input property or array element that failed validation. */
+    readonly path?: readonly (PropertyKey | {
+        /** Property name, symbol, or array index associated with this path segment. */
+        readonly key: PropertyKey;
+    })[] | undefined;
+};
+/** Successful parsed output or validation issues produced by a Standard Schema validator. */
+type StandardSchemaResult<Output> = {
+    /** Parsed and validated value returned by a successful validation. */
+    readonly value: Output;
+    /** Validation issues are absent when parsing succeeds. */
+    readonly issues?: undefined;
+} | {
+    /** Validation issues describing why the input could not be parsed. */
+    readonly issues: readonly StandardSchemaIssue[];
+};
+/** JSON Schema conversion settings passed to a Standard Schema implementation. */
+type StandardJSONSchemaOptions = {
+    /** JSON Schema dialect required by the SDK's structured-output helpers. */
+    readonly target: 'draft-07';
+    /** Optional validator-specific JSON Schema conversion settings. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+};
+/** Minimal Standard Schema v1 validator contract accepted by the public parsing helpers. */
+type StandardSchemaLike<Input = unknown, Output = Input> = {
+    /** Standard Schema metadata, validation entrypoint, and optional JSON Schema conversion. */
+    readonly '~standard': {
+        /** Standard Schema specification version supported by the validator. */
+        readonly version: 1;
+        /** Identifier of the library that implements this Standard Schema validator. */
+        readonly vendor: string;
+        /** Optional type-level input and output metadata used to infer parsed result types. */
+        readonly types?: {
+            /** Type accepted by the validator before parsing or transformation. */
+            readonly input: Input;
+            /** Type produced after successful validation or transformation. */
+            readonly output: Output;
+        } | undefined;
+        /**
+         * Validates model output; SDK parsing helpers require this method to finish synchronously.
+         * Promise-returning validators are rejected when a response is parsed.
+         */
+        readonly validate: (value: unknown) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>;
+        /** Optional JSON Schema conversion methods; provide an explicit `schema` when absent. */
+        readonly jsonSchema?: {
+            /** Produces the model-facing input JSON Schema for the requested dialect. */
+            readonly input: (options: StandardJSONSchemaOptions) => Record<string, unknown>;
+            /** Produces an optional output JSON Schema; structured-output helpers use `input` instead. */
+            readonly output?: (options: StandardJSONSchemaOptions) => Record<string, unknown>;
+        } | undefined;
+    };
+};
+/** Extracts parsed Standard Schema output, falling back to `unknown` without type metadata. */
+type InferStandardOutput<Schema extends StandardSchemaLike> = [
+    NonNullable<Schema['~standard']['types']>
+] extends [never] ? unknown : NonNullable<Schema['~standard']['types']> extends {
+    /** Parsed output type declared by the Standard Schema validator's type metadata. */
+    readonly output: infer Output;
+} ? Output : unknown;
+/** Supplies a model-facing JSON Schema when a validator cannot generate one itself. */
+type StandardSchemaJSONSchemaProps = {
+    /**
+     * A JSON Schema override for Standard Schema implementations that do not
+     * expose `~standard.jsonSchema.input()`.
+     */
+    schema?: JSONSchema | Record<string, unknown> | undefined;
+};
+/** Optional Chat Completions response-format metadata and explicit JSON Schema override. */
+type StandardResponseFormatProps = Omit<ResponseFormatJSONSchema.JSONSchema, 'schema' | 'strict' | 'name'> & StandardSchemaJSONSchemaProps;
+/** Optional Responses API text-format metadata and explicit JSON Schema override. */
+type StandardTextFormatProps = Omit<ResponseFormatTextJSONSchemaConfig, 'schema' | 'type' | 'strict' | 'name'> & StandardSchemaJSONSchemaProps;
+/** Function callback invoked with arguments validated by a Standard Schema implementation. */
+type StandardToolFunction<Parameters extends StandardSchemaLike> = (args: InferStandardOutput<Parameters>) => unknown | Promise<unknown>;
+/** Model-facing function-tool settings and optional Standard Schema validation callback. */
+type StandardToolOptions<Parameters extends StandardSchemaLike> = {
+    /** Model-visible function name used to identify matching tool calls. */
+    name: string;
+    /** Standard Schema validator used to describe and validate the function's arguments. */
+    parameters: Parameters;
+    /**
+     * A JSON Schema override for Standard Schema implementations that do not
+     * expose `~standard.jsonSchema.input()`.
+     */
+    schema?: JSONSchema | Record<string, unknown> | undefined;
+    /** Optional callback retained on the tool and invoked by compatible chat `runTools()` helpers. */
+    function?: StandardToolFunction<Parameters> | undefined;
+    /** Optional model-visible explanation of when and how the function should be used. */
+    description?: string | undefined;
+};
+/** Type-level function-tool metadata preserving validated arguments and callback availability. */
+type StandardToolReturnOptions<Parameters extends StandardSchemaLike, ToolFunction extends StandardToolFunction<Parameters> | undefined> = {
+    /** Inferred argument type returned by the Standard Schema validator. */
+    arguments: InferStandardOutput<Parameters>;
+    /** Model-visible name used to match generated function calls. */
+    name: string;
+    /** Callback type when supplied, or `undefined` for a parse-only function tool. */
+    function: ToolFunction;
+};
+/**
+ * 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.
+ *
+ * Pass the returned format to `client.chat.completions.parse()` to populate
+ * `message.parsed`. Supply `props.schema` when the validator does not implement
+ * `~standard.jsonSchema.input()`.
+ *
+ * @param standardSchema Standard Schema v1 validator used to describe and parse output.
+ * @param name Model-visible name of the generated strict JSON Schema.
+ * @param props Optional response-format metadata and explicit JSON Schema override.
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardResponseFormat<Schema extends StandardSchemaLike>(standardSchema: Schema, name: string, props?: StandardResponseFormatProps): AutoParseableResponseFormat<InferStandardOutput<Schema>>;
+/**
+ * Creates a Responses API `json_schema` text format from a Standard Schema
+ * validator.
+ *
+ * Pass the returned format as `text.format` to `client.responses.parse()` to
+ * populate `response.output_parsed`. Validation must be synchronous. Supply
+ * `props.schema` when the validator cannot generate its own input JSON Schema.
+ *
+ * @param standardSchema Standard Schema v1 validator used to describe and parse output.
+ * @param name Model-visible name of the generated strict JSON Schema.
+ * @param props Optional text-format metadata and explicit JSON Schema override.
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardTextFormat<Schema extends StandardSchemaLike>(standardSchema: Schema, name: string, props?: StandardTextFormatProps): AutoParseableTextFormat<InferStandardOutput<Schema>>;
+/**
+ * Creates a chat completion `function` tool from a Standard Schema
+ * validator and a callback that can be invoked by `chat.completions.runTools()`.
+ *
+ * The generated tool uses strict JSON Schema, and arguments are validated
+ * synchronously before the callback receives them. Supply `options.schema`
+ * when the validator cannot generate an input JSON Schema.
+ *
+ * @param options Model-visible function details, synchronous parameter validator,
+ * optional schema override, and required execution callback.
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardFunction<Parameters extends StandardSchemaLike, ToolFunction extends StandardToolFunction<Parameters>>(options: StandardToolOptions<Parameters> & {
+    /** Callback invoked with synchronously validated arguments by chat `runTools()`. */
+    function: ToolFunction;
+}): AutoParseableTool<StandardToolReturnOptions<Parameters, ToolFunction>>;
+/**
+ * Creates a parse-only Chat Completions function tool without an execution callback.
+ *
+ * Arguments are validated synchronously by `chat.completions.parse()` or
+ * `.stream()`. Callback-free tools cannot be executed by `runTools()`.
+ *
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardFunction<Parameters extends StandardSchemaLike>(options: StandardToolOptions<Parameters> & {
+    /** No execution callback is attached to this parse-only function tool. */
+    function?: undefined;
+}): AutoParseableTool<StandardToolReturnOptions<Parameters, undefined>>;
+/**
+ * Creates a strict Chat Completions function tool with an optionally available callback.
+ * The validator must support synchronous validation and provide or receive a JSON Schema.
+ *
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardFunction<Parameters extends StandardSchemaLike>(options: StandardToolOptions<Parameters>): AutoParseableTool<StandardToolReturnOptions<Parameters, StandardToolFunction<Parameters> | undefined>>;
+/**
+ * Creates a strict Responses API function tool from a Standard Schema validator and callback.
+ *
+ * `client.responses.parse()` validates matching function-call arguments and
+ * exposes them as `parsed_arguments`; it does not execute the attached callback
+ * or submit tool results. Validation must complete synchronously.
+ *
+ * @param options Model-visible function details, synchronous parameter validator,
+ * optional schema override, and callback metadata.
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardResponsesFunction<Parameters extends StandardSchemaLike, ToolFunction extends StandardToolFunction<Parameters>>(options: StandardToolOptions<Parameters> & {
+    /** Callback retained on the tool; `responses.parse()` does not execute it. */
+    function: ToolFunction;
+}): AutoParseableResponseTool<StandardToolReturnOptions<Parameters, ToolFunction>>;
+/**
+ * Creates a parse-only Responses API function tool without an execution callback.
+ * `responses.parse()` exposes synchronously validated arguments as `parsed_arguments`.
+ *
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardResponsesFunction<Parameters extends StandardSchemaLike>(options: StandardToolOptions<Parameters> & {
+    /** No execution callback is attached to this parse-only function tool. */
+    function?: undefined;
+}): AutoParseableResponseTool<StandardToolReturnOptions<Parameters, undefined>>;
+/**
+ * Creates a strict Responses API function tool with an optionally available callback.
+ * Argument validation is synchronous; `responses.parse()` does not execute callbacks.
+ *
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+export declare function standardResponsesFunction<Parameters extends StandardSchemaLike>(options: StandardToolOptions<Parameters>): AutoParseableResponseTool<StandardToolReturnOptions<Parameters, StandardToolFunction<Parameters> | undefined>>;
+export {};
+//# sourceMappingURL=standard-schema.d.ts.map

package/helpers/standard-schema.d.ts.map

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

package/helpers/standard-schema.js

@@ -0,0 +1,383 @@
+"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 bindStandardSchema(standardSchema) {
+    let binding;
+    return () => {
+        if (!binding) {
+            const standard = standardSchema['~standard'];
+            binding = { standard, validate: standard.validate };
+        }
+        return binding;
+    };
+}
+function parseStandardSchema(getBinding, content) {
+    const parsed = (0, parser_1.parseResponseFormatContent)({ type: 'json_schema', $parseRaw: undefined }, content);
+    const { standard, validate } = getBinding();
+    const result = Reflect.apply(validate, standard, [parsed]);
+    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(getBinding, schemaOverride) {
+    const schema = (schemaOverride ?? getBinding().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.
+ *
+ * Pass the returned format to `client.chat.completions.parse()` to populate
+ * `message.parsed`. Supply `props.schema` when the validator does not implement
+ * `~standard.jsonSchema.input()`.
+ *
+ * @param standardSchema Standard Schema v1 validator used to describe and parse output.
+ * @param name Model-visible name of the generated strict JSON Schema.
+ * @param props Optional response-format metadata and explicit JSON Schema override.
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+function standardResponseFormat(standardSchema, name, props) {
+    const { schema, ...formatProps } = props ?? {};
+    const getBinding = bindStandardSchema(standardSchema);
+    return (0, parser_1.makeParseableResponseFormat)({
+        type: 'json_schema',
+        json_schema: {
+            ...formatProps,
+            name,
+            strict: true,
+            schema: resolveStandardJSONSchema(getBinding, schema),
+        },
+    }, (content) => parseStandardSchema(getBinding, content));
+}
+/**
+ * Creates a Responses API `json_schema` text format from a Standard Schema
+ * validator.
+ *
+ * Pass the returned format as `text.format` to `client.responses.parse()` to
+ * populate `response.output_parsed`. Validation must be synchronous. Supply
+ * `props.schema` when the validator cannot generate its own input JSON Schema.
+ *
+ * @param standardSchema Standard Schema v1 validator used to describe and parse output.
+ * @param name Model-visible name of the generated strict JSON Schema.
+ * @param props Optional text-format metadata and explicit JSON Schema override.
+ * @throws {OpenAIError} If no JSON Schema is available or its `oneOf` branches
+ * cannot be represented safely.
+ * @throws {Error} If strict normalization rejects another unsupported or
+ * unrepresentable JSON Schema feature.
+ * @throws {TypeError} If malformed JSON Schema values have unexpected structural types.
+ */
+function standardTextFormat(standardSchema, name, props) {
+    const { schema, ...formatProps } = props ?? {};
+    const getBinding = bindStandardSchema(standardSchema);
+    return (0, parser_1.makeParseableTextFormat)({
+        type: 'json_schema',
+        ...formatProps,
+        name,
+        strict: true,
+        schema: resolveStandardJSONSchema(getBinding, schema),
+    }, (content) => parseStandardSchema(getBinding, content));
+}
+/** Builds a strict Chat Completions function tool from a synchronous Standard Schema validator. */
+function standardFunction(options) {
+    const name = options.name;
+    const parameters = options.parameters;
+    const getBinding = bindStandardSchema(parameters);
+    return (0, parser_1.makeParseableTool)({
+        type: 'function',
+        function: {
+            name,
+            parameters: resolveStandardJSONSchema(getBinding, options.schema),
+            strict: true,
+            ...(options.description ? { description: options.description } : undefined),
+        },
+    }, {
+        callback: options.function,
+        parser: (args) => parseStandardSchema(getBinding, args),
+    });
+}
+/** Builds a strict Responses API function tool from a synchronous Standard Schema validator. */
+function standardResponsesFunction(options) {
+    const name = options.name;
+    const parameters = options.parameters;
+    const getBinding = bindStandardSchema(parameters);
+    return (0, ResponsesParser_1.makeParseableResponseTool)({
+        type: 'function',
+        name,
+        parameters: resolveStandardJSONSchema(getBinding, options.schema),
+        strict: true,
+        ...(options.description ? { description: options.description } : undefined),
+    }, {
+        callback: options.function,
+        parser: (args) => parseStandardSchema(getBinding, 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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"}