@humeai/audio-decisions 0.1.0 → 0.2.0

package/README.md

@@ -201,7 +201,7 @@ const result = await client.decisions.createChunked({
         context: "A call in which a voice AI agent helps a caller reschedule an appointment.",
         questions: {
             agent_glitches: {
-                type: "moment",
+                type: "span",
                 instructions: "Where does the agent glitch, slur or sound robotic?",
             },
             talks_over_caller: {
@@ -219,16 +219,16 @@ for (const chunk of result.chunks) {
         continue;
     }
     const answer = chunk.response.answers.agent_glitches;
-    if (answer.type === "moment") {
-        for (const moment of answer.moments) {
-            // Moments are measured from the start of the chunk.
-            console.log(`${chunk.startMs + moment.audioStartMs} to ${chunk.startMs + moment.audioEndMs} ms`);
+    if (answer.type === "span") {
+        for (const span of answer.spans) {
+            // Span times are measured from the start of the chunk.
+            console.log(`${chunk.startMs + span.audioStartMs} to ${chunk.startMs + span.audioEndMs} ms`);
         }
     }
 }
 ```
 
-Each chunk's `startMs` and `endMs` give where it starts and ends in the recording, so add its `startMs` to a moment's times to place the moment in the recording. Pass `startMs` and `endMs` to `createChunked` to send only part of the recording.
+Each chunk's `startMs` and `endMs` give where it starts and ends in the recording, so add its `startMs` to a span's times to place the span in the recording. Pass `startMs` and `endMs` to `createChunked` to send only part of the recording.
 
 ### Chunk length
 
@@ -265,14 +265,14 @@ if (result.complete) {
 }
 ```
 
-To ask how much of the call something describes, count the chunks whose `noul` passes a threshold instead. A `moment` answer needs no combining once its times are placed in the recording.
+To ask how much of the call something describes, count the chunks whose `noul` passes a threshold instead. A `span` answer needs no combining once its times are placed in the recording.
 
 ### Where cuts fall
 
 1. A WAV file is cut between samples, after it is mixed down.
-2. An MP3 file is cut between frames, without being decoded, so chunks can differ in length by a frame or more; a frame lasts 24 to 72 ms. A frame can depend on the frames before it, so every chunk after the first starts with frames repeated from the end of the chunk before, usually a fraction of a second and up to about 2 seconds at the lowest bitrates. They count toward `maxChunkMs` and are included in the chunk's `startMs`, so a moment near a cut can appear in both chunks. Most MP3 files also start with a few tens of milliseconds of silence that the encoder added and players skip. Times are measured from where a player starts the file, so the first chunk's `startMs` can be below 0.
+2. An MP3 file is cut between frames, without being decoded, so chunks can differ in length by a frame or more; a frame lasts 24 to 72 ms. A frame can depend on the frames before it, so every chunk after the first starts with frames repeated from the end of the chunk before, usually a fraction of a second and up to about 2 seconds at the lowest bitrates. They count toward `maxChunkMs` and are included in the chunk's `startMs`, so a span near a cut can appear in both chunks. Most MP3 files also start with a few tens of milliseconds of silence that the encoder added and players skip. Times are measured from where a player starts the file, so the first chunk's `startMs` can be below 0.
 
-In both formats, an event that crosses a cut, such as the agent talking over the caller for a second or two around it, is heard in part by each chunk. A `moment` question can return it as two shorter moments, as one that ends or starts at the cut, or not at all, and a `noul` answer about it can come out lower in both chunks than for audio that holds the whole event. The frames an MP3 chunk repeats are there so it can be decoded, and cannot be relied on to cover an event at a cut.
+In both formats, an event that crosses a cut, such as the agent talking over the caller for a second or two around it, is heard in part by each chunk. A `span` question can return it as two shorter spans, as one that ends or starts at the cut, or not at all, and a `noul` answer about it can come out lower in both chunks than for audio that holds the whole event. The frames an MP3 chunk repeats are there so it can be decoded, and cannot be relied on to cover an event at a cut.
 
 ### Failures and resuming
 
@@ -304,7 +304,7 @@ for await (const chunk of client.decisions.iterCreateChunked({
     request: {
         questions: {
             agent_glitches: {
-                type: "moment",
+                type: "span",
                 instructions: "Where does the agent glitch, slur or sound robotic?",
             },
         },

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@humeai/audio-decisions",
-        "X-Fern-SDK-Version": "0.1.0",
-        "User-Agent": "@humeai/audio-decisions/0.1.0",
+        "X-Fern-SDK-Version": "0.2.0",
+        "User-Agent": "@humeai/audio-decisions/0.2.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/decisions/client/Client.d.ts

@@ -67,7 +67,7 @@ export declare class DecisionsClient {
      *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
      *                 },
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }
@@ -144,7 +144,7 @@ export declare class DecisionsClient {
      *             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",
+     *                     type: "span",
      *                     instructions: "Where does the speaker laugh, sigh, gasp or make another vocal burst?"
      *                 }
      *             }
@@ -198,7 +198,7 @@ export declare class DecisionsClient {
      *                 criteria: ["Not at all", "2", "3", "4", "Extremely"]
      *             },
      *             "agent_glitches": {
-     *                 type: "moment",
+     *                 type: "span",
      *                 instructions: "Where does the agent glitch, slur or sound robotic?"
      *             }
      *         }
@@ -209,7 +209,7 @@ export declare class DecisionsClient {
     /**
      * 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 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 span'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.
      *
@@ -230,7 +230,7 @@ export declare class DecisionsClient {
      *         request: {
      *             questions: {
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }
@@ -265,7 +265,7 @@ export declare class DecisionsClient {
      *         request: {
      *             questions: {
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }

package/dist/cjs/api/resources/decisions/client/Client.js

@@ -115,7 +115,7 @@ class DecisionsClient {
      *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
      *                 },
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }
@@ -192,7 +192,7 @@ class DecisionsClient {
      *             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",
+     *                     type: "span",
      *                     instructions: "Where does the speaker laugh, sigh, gasp or make another vocal burst?"
      *                 }
      *             }
@@ -367,7 +367,7 @@ class DecisionsClient {
      *                 criteria: ["Not at all", "2", "3", "4", "Extremely"]
      *             },
      *             "agent_glitches": {
-     *                 type: "moment",
+     *                 type: "span",
      *                 instructions: "Where does the agent glitch, slur or sound robotic?"
      *             }
      *         }
@@ -482,7 +482,7 @@ class DecisionsClient {
     /**
      * 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 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 span'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.
      *
@@ -503,7 +503,7 @@ class DecisionsClient {
      *         request: {
      *             questions: {
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }
@@ -540,7 +540,7 @@ class DecisionsClient {
      *         request: {
      *             questions: {
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }

package/dist/cjs/api/resources/decisions/client/requests/DecisionsUpload.d.ts

@@ -31,7 +31,7 @@ import type * as Decisions from "../../../../index.js";
  *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
  *                 },
  *                 "agent_glitches": {
- *                     type: "moment",
+ *                     type: "span",
  *                     instructions: "Where does the agent glitch, slur or sound robotic?"
  *                 }
  *             }
@@ -104,7 +104,7 @@ import type * as Decisions from "../../../../index.js";
  *             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",
+ *                     type: "span",
  *                     instructions: "Where does the speaker laugh, sigh, gasp or make another vocal burst?"
  *                 }
  *             }

package/dist/cjs/api/resources/decisions/client/requests/InputTokensRequest.d.ts

@@ -29,7 +29,7 @@ import type * as Decisions from "../../../../index.js";
  *                 criteria: ["Not at all", "2", "3", "4", "Extremely"]
  *             },
  *             "agent_glitches": {
- *                 type: "moment",
+ *                 type: "span",
  *                 instructions: "Where does the agent glitch, slur or sound robotic?"
  *             }
  *         }

package/dist/cjs/api/types/Answer.d.ts

@@ -2,7 +2,7 @@ import type * as Decisions from "../index.js";
 /**
  * The answer to one question. `type` names the question's primitive and determines the answer's fields. Treat an unrecognized `type` as unknown rather than as an error.
  */
-export type Answer = Decisions.Answer.Noul | Decisions.Answer.Choice | Decisions.Answer.Score | Decisions.Answer.Moment;
+export type Answer = Decisions.Answer.Noul | Decisions.Answer.Choice | Decisions.Answer.Score | Decisions.Answer.Span;
 export declare namespace Answer {
     interface Noul extends Decisions.NoulAnswer {
         type: "noul";
@@ -13,7 +13,7 @@ export declare namespace Answer {
     interface Score extends Decisions.ScoreAnswer {
         type: "score";
     }
-    interface Moment extends Decisions.MomentAnswer {
-        type: "moment";
+    interface Span extends Decisions.SpanAnswer {
+        type: "span";
     }
 }

package/dist/cjs/api/types/Question.d.ts

@@ -2,7 +2,7 @@ import type * as Decisions from "../index.js";
 /**
  * A question. `type` names its primitive, which determines the question's options and the structure of its answer.
  */
-export type Question = Decisions.Question.Noul | Decisions.Question.Choice | Decisions.Question.Score | Decisions.Question.Moment;
+export type Question = Decisions.Question.Noul | Decisions.Question.Choice | Decisions.Question.Score | Decisions.Question.Span;
 export declare namespace Question {
     interface Noul extends Decisions.NoulQuestion {
         type: "noul";
@@ -13,7 +13,7 @@ export declare namespace Question {
     interface Score extends Decisions.ScoreQuestion {
         type: "score";
     }
-    interface Moment extends Decisions.MomentQuestion {
-        type: "moment";
+    interface Span extends Decisions.SpanQuestion {
+        type: "span";
     }
 }

package/dist/cjs/api/types/Questions.d.ts

@@ -1,6 +1,6 @@
 import type * as Decisions from "../index.js";
 /**
- * The questions to answer: at most 20 `noul`, `choice` and `score` questions together, and at most 5 `moment` questions. Each key is a question ID you choose, such as `agent_tone`, and can be any non-empty string of up to 256 characters. The response returns each answer under the same ID.
+ * The questions to answer: at most 20 `noul`, `choice` and `score` questions together, and at most 5 `span` questions. Each key is a question ID you choose, such as `agent_tone`, and can be any non-empty string of up to 256 characters. The response returns each answer under the same ID.
  */
 export type Questions = {
     [key: string]: Decisions.Question;

package/dist/cjs/api/types/Span.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A span where the described event may occur.
+ */
+export interface Span {
+    /** Where the span begins, in milliseconds from the start of the audio file. */
+    audioStartMs: number;
+    /** Where the span ends, in milliseconds from the start of the audio file. */
+    audioEndMs: number;
+    /** The probability that the event occurs in the span. */
+    probability: number;
+}

package/dist/cjs/api/types/SpanAnswer.d.ts

@@ -0,0 +1,8 @@
+import type * as Decisions from "../index.js";
+/**
+ * The answer to a `span` question.
+ */
+export interface SpanAnswer {
+    /** The spans where the described event may occur, in order of `audio_start_ms`. Overlapping candidates are merged. An empty array means the event was not found. */
+    spans: Decisions.Span[];
+}

package/dist/cjs/api/types/{MomentQuestion.d.ts → SpanQuestion.d.ts}

@@ -1,7 +1,7 @@
 /**
  * Asks when an event occurs in the audio.
  */
-export interface MomentQuestion {
+export interface SpanQuestion {
     /** The question, written in natural language. */
     instructions: string;
 }

package/dist/cjs/api/types/index.d.ts

@@ -10,9 +10,6 @@ export * from "./ErrorCode.js";
 export * from "./ErrorType.js";
 export * from "./GatewayError.js";
 export * from "./InputTokensResponse.js";
-export * from "./Moment.js";
-export * from "./MomentAnswer.js";
-export * from "./MomentQuestion.js";
 export * from "./NoulAnswer.js";
 export * from "./NoulCriteria.js";
 export * from "./NoulQuestion.js";
@@ -26,3 +23,6 @@ export * from "./RunSummary.js";
 export * from "./RunsPage.js";
 export * from "./ScoreAnswer.js";
 export * from "./ScoreQuestion.js";
+export * from "./Span.js";
+export * from "./SpanAnswer.js";
+export * from "./SpanQuestion.js";

package/dist/cjs/api/types/index.js

@@ -26,9 +26,6 @@ __exportStar(require("./ErrorCode.js"), exports);
 __exportStar(require("./ErrorType.js"), exports);
 __exportStar(require("./GatewayError.js"), exports);
 __exportStar(require("./InputTokensResponse.js"), exports);
-__exportStar(require("./Moment.js"), exports);
-__exportStar(require("./MomentAnswer.js"), exports);
-__exportStar(require("./MomentQuestion.js"), exports);
 __exportStar(require("./NoulAnswer.js"), exports);
 __exportStar(require("./NoulCriteria.js"), exports);
 __exportStar(require("./NoulQuestion.js"), exports);
@@ -42,3 +39,6 @@ __exportStar(require("./RunSummary.js"), exports);
 __exportStar(require("./RunsPage.js"), exports);
 __exportStar(require("./ScoreAnswer.js"), exports);
 __exportStar(require("./ScoreQuestion.js"), exports);
+__exportStar(require("./Span.js"), exports);
+__exportStar(require("./SpanAnswer.js"), exports);
+__exportStar(require("./SpanQuestion.js"), exports);

package/dist/cjs/audio-helpers/results.d.ts

@@ -7,8 +7,8 @@ interface ChunkPosition {
     /** Position of the chunk in the recording, starting at 0. */
     readonly index: number;
     /**
-     * Where the chunk starts in the recording, in milliseconds. A moment's `audioStartMs` and
-     * `audioEndMs` are measured from the start of the chunk, so add this to place the moment in the
+     * Where the chunk starts in the recording, in milliseconds. A span's `audioStartMs` and
+     * `audioEndMs` are measured from the start of the chunk, so add this to place the span in the
      * recording. The first chunk of an MP3 file can start a few tens of milliseconds before 0.
      */
     readonly startMs: number;

package/dist/cjs/serialization/types/Answer.d.ts

@@ -2,12 +2,12 @@ import type * as Decisions from "../../api/index.js";
 import * as core from "../../core/index.js";
 import type * as serializers from "../index.js";
 import { ChoiceAnswer } from "./ChoiceAnswer.js";
-import { MomentAnswer } from "./MomentAnswer.js";
 import { NoulAnswer } from "./NoulAnswer.js";
 import { ScoreAnswer } from "./ScoreAnswer.js";
+import { SpanAnswer } from "./SpanAnswer.js";
 export declare const Answer: core.serialization.Schema<serializers.Answer.Raw, Decisions.Answer>;
 export declare namespace Answer {
-    type Raw = Answer.Noul | Answer.Choice | Answer.Score | Answer.Moment;
+    type Raw = Answer.Noul | Answer.Choice | Answer.Score | Answer.Span;
     interface Noul extends NoulAnswer.Raw {
         type: "noul";
     }
@@ -17,7 +17,7 @@ export declare namespace Answer {
     interface Score extends ScoreAnswer.Raw {
         type: "score";
     }
-    interface Moment extends MomentAnswer.Raw {
-        type: "moment";
+    interface Span extends SpanAnswer.Raw {
+        type: "span";
     }
 }

package/dist/cjs/serialization/types/Answer.js

@@ -37,15 +37,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Answer = void 0;
 const core = __importStar(require("../../core/index.js"));
 const ChoiceAnswer_js_1 = require("./ChoiceAnswer.js");
-const MomentAnswer_js_1 = require("./MomentAnswer.js");
 const NoulAnswer_js_1 = require("./NoulAnswer.js");
 const ScoreAnswer_js_1 = require("./ScoreAnswer.js");
+const SpanAnswer_js_1 = require("./SpanAnswer.js");
 exports.Answer = core.serialization
     .union("type", {
     noul: NoulAnswer_js_1.NoulAnswer,
     choice: ChoiceAnswer_js_1.ChoiceAnswer,
     score: ScoreAnswer_js_1.ScoreAnswer,
-    moment: MomentAnswer_js_1.MomentAnswer,
+    span: SpanAnswer_js_1.SpanAnswer,
 })
     .transform({
     transform: (value) => value,

package/dist/cjs/serialization/types/Question.d.ts

@@ -2,12 +2,12 @@ import type * as Decisions from "../../api/index.js";
 import * as core from "../../core/index.js";
 import type * as serializers from "../index.js";
 import { ChoiceQuestion } from "./ChoiceQuestion.js";
-import { MomentQuestion } from "./MomentQuestion.js";
 import { NoulQuestion } from "./NoulQuestion.js";
 import { ScoreQuestion } from "./ScoreQuestion.js";
+import { SpanQuestion } from "./SpanQuestion.js";
 export declare const Question: core.serialization.Schema<serializers.Question.Raw, Decisions.Question>;
 export declare namespace Question {
-    type Raw = Question.Noul | Question.Choice | Question.Score | Question.Moment;
+    type Raw = Question.Noul | Question.Choice | Question.Score | Question.Span;
     interface Noul extends NoulQuestion.Raw {
         type: "noul";
     }
@@ -17,7 +17,7 @@ export declare namespace Question {
     interface Score extends ScoreQuestion.Raw {
         type: "score";
     }
-    interface Moment extends MomentQuestion.Raw {
-        type: "moment";
+    interface Span extends SpanQuestion.Raw {
+        type: "span";
     }
 }

package/dist/cjs/serialization/types/Question.js

@@ -37,15 +37,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Question = void 0;
 const core = __importStar(require("../../core/index.js"));
 const ChoiceQuestion_js_1 = require("./ChoiceQuestion.js");
-const MomentQuestion_js_1 = require("./MomentQuestion.js");
 const NoulQuestion_js_1 = require("./NoulQuestion.js");
 const ScoreQuestion_js_1 = require("./ScoreQuestion.js");
+const SpanQuestion_js_1 = require("./SpanQuestion.js");
 exports.Question = core.serialization
     .union("type", {
     noul: NoulQuestion_js_1.NoulQuestion,
     choice: ChoiceQuestion_js_1.ChoiceQuestion,
     score: ScoreQuestion_js_1.ScoreQuestion,
-    moment: MomentQuestion_js_1.MomentQuestion,
+    span: SpanQuestion_js_1.SpanQuestion,
 })
     .transform({
     transform: (value) => value,

package/dist/cjs/serialization/types/{Moment.d.ts → Span.d.ts}

@@ -1,8 +1,8 @@
 import type * as Decisions from "../../api/index.js";
 import * as core from "../../core/index.js";
 import type * as serializers from "../index.js";
-export declare const Moment: core.serialization.ObjectSchema<serializers.Moment.Raw, Decisions.Moment>;
-export declare namespace Moment {
+export declare const Span: core.serialization.ObjectSchema<serializers.Span.Raw, Decisions.Span>;
+export declare namespace Span {
     interface Raw {
         audio_start_ms: number;
         audio_end_ms: number;

package/dist/cjs/serialization/types/{Moment.js → Span.js}

@@ -34,9 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Moment = void 0;
+exports.Span = void 0;
 const core = __importStar(require("../../core/index.js"));
-exports.Moment = core.serialization.object({
+exports.Span = core.serialization.object({
     audioStartMs: core.serialization.property("audio_start_ms", core.serialization.number()),
     audioEndMs: core.serialization.property("audio_end_ms", core.serialization.number()),
     probability: core.serialization.number(),

package/dist/cjs/serialization/types/SpanAnswer.d.ts

@@ -0,0 +1,10 @@
+import type * as Decisions from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { Span } from "./Span.js";
+export declare const SpanAnswer: core.serialization.ObjectSchema<serializers.SpanAnswer.Raw, Decisions.SpanAnswer>;
+export declare namespace SpanAnswer {
+    interface Raw {
+        spans: Span.Raw[];
+    }
+}

package/dist/cjs/serialization/types/{MomentAnswer.js → SpanAnswer.js}

@@ -34,9 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MomentAnswer = void 0;
+exports.SpanAnswer = void 0;
 const core = __importStar(require("../../core/index.js"));
-const Moment_js_1 = require("./Moment.js");
-exports.MomentAnswer = core.serialization.object({
-    moments: core.serialization.list(Moment_js_1.Moment),
+const Span_js_1 = require("./Span.js");
+exports.SpanAnswer = core.serialization.object({
+    spans: core.serialization.list(Span_js_1.Span),
 });

package/dist/cjs/serialization/types/{MomentQuestion.d.ts → SpanQuestion.d.ts}

@@ -1,8 +1,8 @@
 import type * as Decisions from "../../api/index.js";
 import * as core from "../../core/index.js";
 import type * as serializers from "../index.js";
-export declare const MomentQuestion: core.serialization.ObjectSchema<serializers.MomentQuestion.Raw, Decisions.MomentQuestion>;
-export declare namespace MomentQuestion {
+export declare const SpanQuestion: core.serialization.ObjectSchema<serializers.SpanQuestion.Raw, Decisions.SpanQuestion>;
+export declare namespace SpanQuestion {
     interface Raw {
         instructions: string;
     }

package/dist/cjs/serialization/types/{MomentQuestion.js → SpanQuestion.js}

@@ -34,8 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MomentQuestion = void 0;
+exports.SpanQuestion = void 0;
 const core = __importStar(require("../../core/index.js"));
-exports.MomentQuestion = core.serialization.object({
+exports.SpanQuestion = core.serialization.object({
     instructions: core.serialization.string(),
 });

package/dist/cjs/serialization/types/index.d.ts

@@ -10,9 +10,6 @@ export * from "./ErrorCode.js";
 export * from "./ErrorType.js";
 export * from "./GatewayError.js";
 export * from "./InputTokensResponse.js";
-export * from "./Moment.js";
-export * from "./MomentAnswer.js";
-export * from "./MomentQuestion.js";
 export * from "./NoulAnswer.js";
 export * from "./NoulCriteria.js";
 export * from "./NoulQuestion.js";
@@ -26,3 +23,6 @@ export * from "./RunSummary.js";
 export * from "./RunsPage.js";
 export * from "./ScoreAnswer.js";
 export * from "./ScoreQuestion.js";
+export * from "./Span.js";
+export * from "./SpanAnswer.js";
+export * from "./SpanQuestion.js";

package/dist/cjs/serialization/types/index.js

@@ -26,9 +26,6 @@ __exportStar(require("./ErrorCode.js"), exports);
 __exportStar(require("./ErrorType.js"), exports);
 __exportStar(require("./GatewayError.js"), exports);
 __exportStar(require("./InputTokensResponse.js"), exports);
-__exportStar(require("./Moment.js"), exports);
-__exportStar(require("./MomentAnswer.js"), exports);
-__exportStar(require("./MomentQuestion.js"), exports);
 __exportStar(require("./NoulAnswer.js"), exports);
 __exportStar(require("./NoulCriteria.js"), exports);
 __exportStar(require("./NoulQuestion.js"), exports);
@@ -42,3 +39,6 @@ __exportStar(require("./RunSummary.js"), exports);
 __exportStar(require("./RunsPage.js"), exports);
 __exportStar(require("./ScoreAnswer.js"), exports);
 __exportStar(require("./ScoreQuestion.js"), exports);
+__exportStar(require("./Span.js"), exports);
+__exportStar(require("./SpanAnswer.js"), exports);
+__exportStar(require("./SpanQuestion.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.2.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.1.0";
+exports.SDK_VERSION = "0.2.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@humeai/audio-decisions",
-        "X-Fern-SDK-Version": "0.1.0",
-        "User-Agent": "@humeai/audio-decisions/0.1.0",
+        "X-Fern-SDK-Version": "0.2.0",
+        "User-Agent": "@humeai/audio-decisions/0.2.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -67,7 +67,7 @@ export declare class DecisionsClient {
      *                     criteria: ["Not at all", "2", "3", "4", "Extremely"]
      *                 },
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }
@@ -144,7 +144,7 @@ export declare class DecisionsClient {
      *             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",
+     *                     type: "span",
      *                     instructions: "Where does the speaker laugh, sigh, gasp or make another vocal burst?"
      *                 }
      *             }
@@ -198,7 +198,7 @@ export declare class DecisionsClient {
      *                 criteria: ["Not at all", "2", "3", "4", "Extremely"]
      *             },
      *             "agent_glitches": {
-     *                 type: "moment",
+     *                 type: "span",
      *                 instructions: "Where does the agent glitch, slur or sound robotic?"
      *             }
      *         }
@@ -209,7 +209,7 @@ export declare class DecisionsClient {
     /**
      * 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 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 span'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.
      *
@@ -230,7 +230,7 @@ export declare class DecisionsClient {
      *         request: {
      *             questions: {
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }
@@ -265,7 +265,7 @@ export declare class DecisionsClient {
      *         request: {
      *             questions: {
      *                 "agent_glitches": {
-     *                     type: "moment",
+     *                     type: "span",
      *                     instructions: "Where does the agent glitch, slur or sound robotic?"
      *                 }
      *             }