@humeai/audio-decisions 0.0.1 → 0.1.0

package/dist/esm/api/resources/decisions/client/Client.mjs

@@ -0,0 +1,527 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { downmixUpload } from "../../../../audio-helpers/files.mjs";
+import { collectResults, sendChunks, } from "../../../../audio-helpers/results.mjs";
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import { toJson } from "../../../../core/json.mjs";
+import { mergeAdditionalBodyParameters } from "../../../../core/requestBody.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as serializers from "../../../../serialization/index.mjs";
+import { DecisionsRequest } from "../../../../serialization/types/DecisionsRequest.mjs";
+import * as Decisions from "../../../index.mjs";
+/**
+ * Evaluate one audio file against one or more questions, or estimate the input tokens of a request.
+ */
+export class DecisionsClient {
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Asks questions about one audio file and returns an answer to each, with the `run_id` of the model run that produced them. Each answer estimates how human raters would respond, so you choose the thresholds for acting on it.
+     *
+     * All the questions in a request are answered in one model inference, so an answer can change when other questions are added, removed or reordered. To compare answers across recordings, send the same questions in the same order. To evaluate several files, send one request per file.
+     *
+     * @param {Decisions.DecisionsUpload} request
+     * @param {DecisionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Decisions.BadRequestError}
+     * @throws {@link Decisions.UnauthorizedError}
+     * @throws {@link Decisions.PaymentRequiredError}
+     * @throws {@link Decisions.ForbiddenError}
+     * @throws {@link Decisions.ContentTooLargeError}
+     * @throws {@link Decisions.UnsupportedMediaTypeError}
+     * @throws {@link Decisions.TooManyRequestsError}
+     * @throws {@link Decisions.InternalServerError}
+     * @throws {@link Decisions.ServiceUnavailableError}
+     * @throws {@link errors.DecisionsError}
+     * @throws {@link errors.DecisionsTimeoutError}
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.decisions.create({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         request: {
+     *             context: "A simulated test call in which a voice AI agent helps a caller reschedule an appointment. Both voices are synthetic, and the agent speaks first.",
+     *             questions: {
+     *                 "talks_over_caller": {
+     *                     type: "noul",
+     *                     instructions: "Does the agent talk over the caller?"
+     *                 },
+     *                 "agent_tone": {
+     *                     type: "choice",
+     *                     instructions: "Which best describes the tone of the agent?",
+     *                     criteria: [{
+     *                             name: "warm",
+     *                             description: "Warm and friendly toward the caller"
+     *                         }, {
+     *                             name: "neutral",
+     *                             description: "Polite but impersonal"
+     *                         }, {
+     *                             name: "curt",
+     *                             description: "Short or dismissive with the caller"
+     *                         }]
+     *                 },
+     *                 "agent_naturalness": {
+     *                     type: "score",
+     *                     instructions: "How natural does the agent sound?",
+     *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
+     *                 },
+     *                 "agent_glitches": {
+     *                     type: "moment",
+     *                     instructions: "Where does the agent glitch, slur or sound robotic?"
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.decisions.create({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         request: {
+     *             context: "Speech generated by an instruction-following text-to-speech model. The prompt asked for a whispered read.",
+     *             questions: {
+     *                 "whispered": {
+     *                     type: "noul",
+     *                     instructions: "Is the voice whispering?"
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.decisions.create({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         request: {
+     *             context: "A clip from a licensed corpus of scripted speech by consenting voice actors, being labeled to train an expressive text-to-speech model.",
+     *             questions: {
+     *                 "emotion": {
+     *                     type: "choice",
+     *                     instructions: "Which emotion does the speaker convey?",
+     *                     criteria: [{
+     *                             name: "happiness",
+     *                             description: "Happiness or amusement"
+     *                         }, {
+     *                             name: "sadness",
+     *                             description: "Sadness or grief"
+     *                         }, {
+     *                             name: "anger",
+     *                             description: "Anger, whether shouted or held back"
+     *                         }, {
+     *                             name: "fear",
+     *                             description: "Fear or anxiety"
+     *                         }, {
+     *                             name: "neutral",
+     *                             description: "No clear emotion"
+     *                         }]
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.decisions.create({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         request: {
+     *             context: "Output from a text-to-speech model under evaluation, reading a product announcement.",
+     *             questions: {
+     *                 "naturalness": {
+     *                     type: "score",
+     *                     instructions: "How natural does the voice sound?",
+     *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     import { createReadStream } from "fs";
+     *     await client.decisions.create({
+     *         file: fs.createReadStream("/path/to/your/file"),
+     *         request: {
+     *             context: "A clip from a licensed corpus of scripted speech by consenting voice actors, being labeled to train an expressive text-to-speech model.",
+     *             questions: {
+     *                 "vocal_bursts": {
+     *                     type: "moment",
+     *                     instructions: "Where does the speaker laugh, sigh, gasp or make another vocal burst?"
+     *                 }
+     *             }
+     *         }
+     *     })
+     */
+    create(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(downmixUpload(request, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal).then((upload) => this.__create(upload, requestOptions)));
+    }
+    __create(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _body = yield core.newFormData();
+            _body.append("request", toJson(DecisionsRequest.jsonOrThrow(request.request, { unrecognizedObjectKeys: "strip", omitUndefined: true })));
+            yield _body.appendFile("file", request.file);
+            const _maybeEncodedRequest = yield _body.getRequest();
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.DecisionsEnvironment.Production, "v0/decisions/file"),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.DecisionsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Decisions.BadRequestError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 401:
+                        throw new Decisions.UnauthorizedError(serializers.GatewayError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 402:
+                        throw new Decisions.PaymentRequiredError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new Decisions.ForbiddenError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 413:
+                        throw new Decisions.ContentTooLargeError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 415:
+                        throw new Decisions.UnsupportedMediaTypeError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 429:
+                        throw new Decisions.TooManyRequestsError(serializers.GatewayError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 500:
+                        throw new Decisions.InternalServerError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 503:
+                        throw new Decisions.ServiceUnavailableError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.DecisionsError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/decisions/file");
+        });
+    }
+    /**
+     * Estimates the input tokens of a decisions request from its questions and the duration of its audio. The body takes the same `context` and `questions` as the `request` part of a `POST /v0/decisions/file` request, plus `audio_duration_ms`, the duration of the audio file in milliseconds.
+     *
+     * @param {Decisions.InputTokensRequest} request
+     * @param {DecisionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Decisions.BadRequestError}
+     * @throws {@link Decisions.UnauthorizedError}
+     * @throws {@link Decisions.ForbiddenError}
+     * @throws {@link Decisions.ContentTooLargeError}
+     * @throws {@link Decisions.UnsupportedMediaTypeError}
+     * @throws {@link Decisions.TooManyRequestsError}
+     * @throws {@link Decisions.InternalServerError}
+     * @throws {@link errors.DecisionsError}
+     * @throws {@link errors.DecisionsTimeoutError}
+     *
+     * @example
+     *     await client.decisions.inputTokens({
+     *         audioDurationMs: 135000,
+     *         context: "A simulated test call in which a voice AI agent helps a caller reschedule an appointment. Both voices are synthetic, and the agent speaks first.",
+     *         questions: {
+     *             "talks_over_caller": {
+     *                 type: "noul",
+     *                 instructions: "Does the agent talk over the caller?"
+     *             },
+     *             "agent_tone": {
+     *                 type: "choice",
+     *                 instructions: "Which best describes the tone of the agent?",
+     *                 criteria: [{
+     *                         name: "warm",
+     *                         description: "Warm and friendly toward the caller"
+     *                     }, {
+     *                         name: "neutral",
+     *                         description: "Polite but impersonal"
+     *                     }, {
+     *                         name: "curt",
+     *                         description: "Short or dismissive with the caller"
+     *                     }]
+     *             },
+     *             "agent_naturalness": {
+     *                 type: "score",
+     *                 instructions: "How natural does the agent sound?",
+     *                 criteria: ["Not at all", "2", "3", "4", "Extremely"]
+     *             },
+     *             "agent_glitches": {
+     *                 type: "moment",
+     *                 instructions: "Where does the agent glitch, slur or sound robotic?"
+     *             }
+     *         }
+     *     })
+     */
+    inputTokens(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__inputTokens(request, requestOptions));
+    }
+    __inputTokens(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.DecisionsEnvironment.Production, "v0/decisions/file/input_tokens"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(serializers.InputTokensRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.InputTokensResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Decisions.BadRequestError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 401:
+                        throw new Decisions.UnauthorizedError(serializers.GatewayError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new Decisions.ForbiddenError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 413:
+                        throw new Decisions.ContentTooLargeError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 415:
+                        throw new Decisions.UnsupportedMediaTypeError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 429:
+                        throw new Decisions.TooManyRequestsError(serializers.GatewayError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 500:
+                        throw new Decisions.InternalServerError(serializers.Error_.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.DecisionsError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/decisions/file/input_tokens");
+        });
+    }
+    /**
+     * Cuts a recording longer than `create` accepts into chunks and sends each chunk to the model in its own `create` request. The recording is never sent as one file. The model processes each chunk independently, hearing only that chunk, so every answer describes its chunk alone and nothing combines the answers across chunks. Each request has its own `runId` and its own billing. Each chunk's result is yielded as soon as its request is done, so it can be saved or reported before the next chunk is sent.
+     *
+     * The chunks are cut by `iterAudioChunks` in `@humeai/audio-decisions/audio-helpers`, which describes where cuts fall in MP3 and WAV files and how each option works, and are sent one at a time, in order. Each request asks the same questions with the same context. A moment's times are measured from the start of its chunk, so add the chunk's `startMs` to place it in the recording.
+     *
+     * The whole recording is read into memory before the first request, so that a file that cannot be split is rejected before anything is sent and billed. A WAV file is mixed down before it is cut, as `downmixStrategy` asks. Each chunk is copied only while its request is sent, so memory use stays near the size of the recording and its mixed-down copy. An hour of 16-bit stereo WAV at 48 kHz is about 690 MB, and about 230 MB once mixed down.
+     *
+     * A request the API rejects, or whose connection fails, does not throw. Its error is recorded on the chunk's result, so check each result's `status`. A chunk whose audio could not be decoded (`audio_decode_failed`) fails alone and the remaining chunks are still sent, but only once an earlier chunk has succeeded; before then, the whole file is the likely cause, so the job stops. Any other error stops the job, and the chunks after it are recorded as not attempted, with no request sent and nothing billed. Rate limits and server errors are retried first, as for `create`, so a job stops on them only once the retries set by `requestOptions` run out. Aborting `requestOptions.abortSignal` does not record an error: iteration throws the `DecisionsError` that `create` throws when aborted, and no further chunk is sent.
+     *
+     * @param request `request` is sent unchanged with every chunk. `file` is the recording, an MP3 or WAV file, and each chunk is uploaded with the filename and content type it gives. The other fields are the options of `iterAudioChunks`.
+     * @param {DecisionsClient.RequestOptions} requestOptions - Request-specific configuration, applied to every chunk's request.
+     * @returns Each chunk's position in the recording and its response or error, in the order of the chunks.
+     *
+     * @throws {TypeError} From this call, if `maxChunkMs`, `startMs` or `endMs` is not a safe integer, or `file` is a string.
+     * @throws {RangeError} From this call, if an option is out of range, and from iteration, if the recording cannot be split as requested. Nothing has been sent when either is thrown.
+     * @throws {UnsupportedAudioError} From iteration, if the recording is empty or not a file `iterAudioChunks` supports.
+     * @throws {@link errors.DecisionsError} From iteration, if `requestOptions.abortSignal` aborts.
+     *
+     * @example
+     *     for await (const chunk of client.decisions.iterCreateChunked({
+     *         file: { path: "call.mp3" },
+     *         request: {
+     *             questions: {
+     *                 "agent_glitches": {
+     *                     type: "moment",
+     *                     instructions: "Where does the agent glitch, slur or sound robotic?"
+     *                 }
+     *             }
+     *         },
+     *         maxChunkMs: 300000
+     *     })) {
+     *         if (chunk.status === "succeeded") {
+     *             console.log(chunk.startMs, chunk.response.runId);
+     *         } else {
+     *             console.log(chunk.startMs, chunk.status, chunk.error);
+     *         }
+     *     }
+     */
+    iterCreateChunked(request, requestOptions) {
+        return sendChunks((upload) => this.create(upload, requestOptions), request, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal);
+    }
+    /**
+     * Cuts a recording longer than `create` accepts into chunks, sends each chunk to the model in its own `create` request, and resolves with every chunk's result once all are done. The model hears only its chunk, so every answer describes its chunk alone, and each request has its own `runId` and its own billing. {@link DecisionsClient.iterCreateChunked} describes how the chunks are cut and sent, the memory the job uses, and which failures stop it. If the process stops partway through, the responses already received are lost although they were billed, so use `iterCreateChunked` to keep each response as it arrives.
+     *
+     * A request the API rejects, or whose connection fails, does not reject. Its error is recorded on the chunk, and the responses already received are returned with it, so check `complete` before relying on the result. Aborting `requestOptions.abortSignal` rejects with the `DecisionsError` that `create` rejects with when aborted, and no further chunk is sent. To resume a job that stopped, pass the result's `resumeMs` as `startMs` to a new job with the same `endMs`. Chunks that failed before the stop because their audio could not be decoded are not sent again, so the new job's `complete` covers only the range it sent.
+     *
+     * @param request `request` is sent unchanged with every chunk. `file` is the recording, an MP3 or WAV file, and each chunk is uploaded with the filename and content type it gives. The other fields are the options of `iterAudioChunks`.
+     * @param {DecisionsClient.RequestOptions} requestOptions - Request-specific configuration, applied to every chunk's request.
+     * @returns Each chunk's position in the recording and its response or error, in the order of the chunks.
+     *
+     * @throws {TypeError} If `maxChunkMs`, `startMs` or `endMs` is not a safe integer, or `file` is a string. Nothing has been sent.
+     * @throws {RangeError} If an option is out of range or the recording cannot be split as requested. Nothing has been sent.
+     * @throws {UnsupportedAudioError} If the recording is empty or not a file `iterAudioChunks` supports.
+     * @throws {@link errors.DecisionsError} If `requestOptions.abortSignal` aborts.
+     *
+     * @example
+     *     const result = await client.decisions.createChunked({
+     *         file: { path: "call.mp3" },
+     *         request: {
+     *             questions: {
+     *                 "agent_glitches": {
+     *                     type: "moment",
+     *                     instructions: "Where does the agent glitch, slur or sound robotic?"
+     *                 }
+     *             }
+     *         },
+     *         maxChunkMs: 300000
+     *     });
+     *     for (const chunk of result.chunks) {
+     *         if (chunk.status === "succeeded") {
+     *             console.log(chunk.startMs, chunk.response.runId);
+     *         } else {
+     *             console.log(chunk.startMs, chunk.status, chunk.error);
+     *         }
+     *     }
+     */
+    createChunked(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return collectResults(this.iterCreateChunked(request, requestOptions), request.startMs);
+        });
+    }
+}

package/dist/esm/api/resources/decisions/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/decisions/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/decisions/client/requests/DecisionsUpload.d.mts

@@ -0,0 +1,118 @@
+import type * as core from "../../../../../core/index.mjs";
+import type * as Decisions from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         request: {
+ *             context: "A simulated test call in which a voice AI agent helps a caller reschedule an appointment. Both voices are synthetic, and the agent speaks first.",
+ *             questions: {
+ *                 "talks_over_caller": {
+ *                     type: "noul",
+ *                     instructions: "Does the agent talk over the caller?"
+ *                 },
+ *                 "agent_tone": {
+ *                     type: "choice",
+ *                     instructions: "Which best describes the tone of the agent?",
+ *                     criteria: [{
+ *                             name: "warm",
+ *                             description: "Warm and friendly toward the caller"
+ *                         }, {
+ *                             name: "neutral",
+ *                             description: "Polite but impersonal"
+ *                         }, {
+ *                             name: "curt",
+ *                             description: "Short or dismissive with the caller"
+ *                         }]
+ *                 },
+ *                 "agent_naturalness": {
+ *                     type: "score",
+ *                     instructions: "How natural does the agent sound?",
+ *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
+ *                 },
+ *                 "agent_glitches": {
+ *                     type: "moment",
+ *                     instructions: "Where does the agent glitch, slur or sound robotic?"
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         request: {
+ *             context: "Speech generated by an instruction-following text-to-speech model. The prompt asked for a whispered read.",
+ *             questions: {
+ *                 "whispered": {
+ *                     type: "noul",
+ *                     instructions: "Is the voice whispering?"
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         request: {
+ *             context: "A clip from a licensed corpus of scripted speech by consenting voice actors, being labeled to train an expressive text-to-speech model.",
+ *             questions: {
+ *                 "emotion": {
+ *                     type: "choice",
+ *                     instructions: "Which emotion does the speaker convey?",
+ *                     criteria: [{
+ *                             name: "happiness",
+ *                             description: "Happiness or amusement"
+ *                         }, {
+ *                             name: "sadness",
+ *                             description: "Sadness or grief"
+ *                         }, {
+ *                             name: "anger",
+ *                             description: "Anger, whether shouted or held back"
+ *                         }, {
+ *                             name: "fear",
+ *                             description: "Fear or anxiety"
+ *                         }, {
+ *                             name: "neutral",
+ *                             description: "No clear emotion"
+ *                         }]
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         request: {
+ *             context: "Output from a text-to-speech model under evaluation, reading a product announcement.",
+ *             questions: {
+ *                 "naturalness": {
+ *                     type: "score",
+ *                     instructions: "How natural does the voice sound?",
+ *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         file: fs.createReadStream("/path/to/your/file"),
+ *         request: {
+ *             context: "A clip from a licensed corpus of scripted speech by consenting voice actors, being labeled to train an expressive text-to-speech model.",
+ *             questions: {
+ *                 "vocal_bursts": {
+ *                     type: "moment",
+ *                     instructions: "Where does the speaker laugh, sigh, gasp or make another vocal burst?"
+ *                 }
+ *             }
+ *         }
+ *     }
+ */
+export interface DecisionsUpload {
+    request: Decisions.DecisionsRequest;
+    /** The audio file, MP3 or WAV, in a part named `file`. */
+    file: core.file.Uploadable;
+}

package/dist/esm/api/resources/decisions/client/requests/DecisionsUpload.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};