@corti/sdk 3.1.0-rc → 3.1.0-rc.2

package/dist/esm/api/types/GuidedNumberNode.d.mts

@@ -1,10 +1,10 @@
 export interface GuidedNumberNode {
     type: "number";
-    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
     description?: string;
-    /** The default to output if nothing to output. */
+    /** If nothing is outputted, this default is used. */
     default?: number | null;
-    /** Can be used to prompt the LLM for specifically allowed numeric values to output. */
+    /** Can be used to guide the LLM with specific values to output. */
     enum?: number[];
     /** Use if a minimum value applies. */
     minimum?: number | null;

package/dist/esm/api/types/GuidedObjectNode.d.mts

@@ -1,14 +1,14 @@
 import type * as Corti from "../index.mjs";
 export interface GuidedObjectNode {
     type: "object";
-    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
     description?: string;
     /**
      * Free-form format string that controls how an object's fields are rendered into the final text output. Operates in one of two modes determined by which placeholders appear:
      *
-     * **Subheading mode** (default: `"{key}: {value}\n"`): triggered when the format contains both `{key}` and `{value}`. Applied per field — each field becomes a key/value line. Fields that render to null are skipped.
+     * **Subheading mode** (default: `"{key}: {value}\n"`): triggered when the format contains both `{key}` and `{value}`. Applied per field — each field becomes a key/value line. When a field has no relevant input/output and no `default` is set, the entire key/value line for that field is omitted from the rendered output.
      *
-     * **Object mode** (e.g. `"{name} ({age})"`): triggered when `{key}` and `{value}` are absent. Placeholders must be actual field keys defined in `fields`. Applied once for the whole object, composing all fields into a single string. Fields rendering to null become empty string.
+     * **Object mode** (e.g. `"{name} ({age})"`): triggered when `{key}` and `{value}` are absent. Placeholders must be actual field keys defined in `fields`. Applied once for the whole object, composing all fields into a single string. When a field has no relevant input/output and no `default` is set, its placeholder is replaced with an empty string (`""`).
      *
      * Validation rules: format must not be empty; if either `{key}` or `{value}` appears, both must be present; in subheading mode no extra placeholders are allowed; in object mode every placeholder must match a defined field key.
      */

package/dist/esm/api/types/GuidedSection.d.mts

@@ -28,6 +28,4 @@ export interface GuidedSection {
     updatedAt: Date;
     /** Present when the section has been deleted. GET by ID still returns the full resource with this field populated. */
     deletedAt?: Date | null;
-    /** Access policies for this section. */
-    policies?: Corti.GuidedSectionPolicy[];
 }

package/dist/esm/api/types/GuidedSectionsCreateBase.d.mts

@@ -14,6 +14,4 @@ export interface GuidedSectionsCreateBase {
     labels?: Corti.GuidedLabel[];
     /** Defaults to true when omitted. Set this to false if you do not want the section to automatically show up in LIST /sections. */
     publish?: boolean;
-    /** Access policies to apply to the section on creation. */
-    policies?: Corti.GuidedSectionsCreatePolicyRequest[];
 }

package/dist/esm/api/types/GuidedStringNode.d.mts

@@ -1,11 +1,11 @@
 export interface GuidedStringNode {
     type: "string";
-    /** Can be used to prompt the LLM with more guidance in addition to the section.instructions */
+    /** Guide the LLM in what to output for this node. Supplements the section-level instructions. */
     description?: string;
-    /** The default to output if nothing to output. */
+    /** If nothing is outputted, this default is used. When `enum` is set, the default must be one of the enum values. */
     default?: string | null;
-    /** Can be used to prompt the LLM with specific values to output. */
+    /** Can be used to guide the LLM with specific values to output. */
     enum?: string[];
-    /** Can be used to prompt the LLM for a specific output pattern. */
+    /** Can be used to constrain the LLM to output a specific pattern. */
     pattern?: string | null;
 }

package/dist/esm/api/types/GuidedTemplate.d.mts

@@ -20,8 +20,6 @@ export interface GuidedTemplate {
     specialties: string[];
     /** The available labels to use as query param filter in the LIST /templates endpoint. */
     labels: Corti.GuidedLabel[];
-    /** Access policies for this template. */
-    policies?: Corti.GuidedTemplatePolicy[];
     /** The currently published version with inheritance fully resolved. Present when a version has been published. */
     publishedVersion?: Corti.GuidedTemplateVersion;
     /** The original timestamp when the template was created. */

package/dist/esm/api/types/GuidedTemplatesCreateBase.d.mts

@@ -14,6 +14,4 @@ export interface GuidedTemplatesCreateBase {
     labels?: Corti.GuidedLabel[];
     /** Defaults to true when omitted. Set this to false if you do not want the template to automatically show up in LIST templates. */
     publish?: boolean;
-    /** Access policies to apply to the template on creation. */
-    policies?: Corti.GuidedTemplatesCreatePolicyRequest[];
 }

package/dist/esm/api/types/StreamConfig.d.mts

@@ -5,6 +5,10 @@ export interface StreamConfig {
     /** Optional parameter to specify data retention policy for the generated transcripts and facts. Use value 'none' to indicate data should not be stored in the database. Use value 'retain' to indicate that the data should be retained according to standard retention policies. If configuration is not provided, then the default retention policy will apply. */
     retentionPolicy?: Corti.StreamConfigRetentionPolicy;
     audioEvents?: Corti.StreamAudioEventsConfig;
-    /** The audio format of the incoming audio stream */
+    /** Define the audio format of the incoming audio stream - optional but recommended. When omitted, the server auto-detects the format from the first audio chunk using ffprobe. Supported audio will be processed. Unsupported return an error but might in some cases error silently. If provided (recommended), the provided MIME type must be supported and the audio must match the MIME type. An unsupported MIME type results in `CONFIG_REJECTED`. Audio that differs from the MIME type will return audio validation errors on the socket. See full list of supported MIME types [here](/stt/audio). */
     audioFormat?: string;
+    /** Define replacements to have terms (single words or multi-word phrases) replaced in final text output with your preferred style. For example, replace "BID" with "twice daily". Configuration is case insensitive and limited to 1,000 replacements per stream. */
+    replacements?: Corti.StreamConfigReplacementsItem[];
+    /** Define words, terms, and phrases to be recognized by Corti speech-to-text. Especially useful for proper nouns (e.g., surnames), but also supportive of words not being recognized consistently. Configuration is case sensitive and limited to 1,000 key terms per stream. */
+    keyterms?: Corti.StreamConfigKeyterms;
 }

package/dist/esm/api/types/StreamConfigKeyterms.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Define words, terms, and phrases to be recognized by Corti speech-to-text. Especially useful for proper nouns (e.g., surnames), but also supportive of words not being recognized consistently. Configuration is case sensitive and limited to 1,000 key terms per stream.
+ */
+export interface StreamConfigKeyterms {
+    /** Ordered list of words to be recognized. */
+    terms?: Corti.StreamConfigKeytermsTermsItem[];
+}

package/dist/esm/api/types/StreamConfigKeytermsTermsItem.d.mts

@@ -0,0 +1,4 @@
+export interface StreamConfigKeytermsTermsItem {
+    /** The word to be recognized, defined in its expected written form. */
+    term: string;
+}

package/dist/esm/api/types/StreamConfigReplacementsItem.d.mts

@@ -0,0 +1,6 @@
+export interface StreamConfigReplacementsItem {
+    /** The term to be replaced, such as "BID". */
+    find: string;
+    /** The preferred replacement for the term, such as "twice daily". */
+    replace: string;
+}

package/dist/esm/api/types/StreamErrorDetail.d.mts

@@ -1,12 +1,14 @@
 export interface StreamErrorDetail {
+    /** Unique identifier for the request, for support and debugging. */
+    requestid?: string;
     /** Error identifier */
-    id: string;
+    id?: string;
     /** Error title */
-    title: string;
+    title?: string;
     /** HTTP status code or similar error code */
-    status: number;
+    status?: number;
     /** Detailed error message */
-    details: string;
+    details?: string;
     /** Link to documentation or further information */
-    doc: string;
+    doc?: string;
 }

package/dist/esm/api/types/TranscribeAudioEventsConfig.d.mts

@@ -1,4 +1,4 @@
 export interface TranscribeAudioEventsConfig {
     /** When true, enables audio quality and speech activity events to be sent over the WebSocket. Disabled by default. */
-    enabled?: boolean;
+    enabled: boolean;
 }

package/dist/esm/api/types/TranscribeCommand.d.mts

@@ -1,9 +1,9 @@
 import type * as Corti from "../index.mjs";
 export interface TranscribeCommand {
-    /** To identify the command when it gets detected and returned over the WebSocket */
+    /** Unique value to identify the command when it is detected and returned over the WebSocket */
     id: string;
-    /** The spoken phrases that should trigger the command */
+    /** One or more word sequence(s) that can be spoken to trigger the command. At least one phrase is required per command. */
     phrases: string[];
-    /** Variables for the command */
+    /** Placeholders that can (optionally) be added in phrases to provide flexibility and extensibility for triggering commands. */
     variables?: Corti.TranscribeCommandVariable[];
 }

package/dist/esm/api/types/TranscribeCommandVariable.d.mts

@@ -1,8 +1,9 @@
+import type * as Corti from "../index.mjs";
 export interface TranscribeCommandVariable {
-    /** Variable key identifier */
+    /** Define the variable used in command phrases. */
     key: string;
-    /** Variable type */
-    type: "enum";
-    /** Enum values for the variable */
-    enum: string[];
+    /** Variable type. Use `enum` to define a fixed list of values that can be recognized for the variable. Use `wildcard` to recognize any undefined, open-ended free-text utterance. When using `wildcard`, the phrase must include a literal trigger word before the wildcard variable (a phrase may not begin with a wildcard variable), and multiple wildcard variables in a single phrase must be separated by a non-empty literal string (e.g. `select {text1} end select {text2}` is valid; `{text1} {text2}` is not). */
+    type: Corti.TranscribeCommandVariableType;
+    /** List of values that should be recognized for the defined variable. Required when `type` is `enum`. Not used (and ignored) when `type` is `wildcard`. */
+    enum?: string[];
 }

package/dist/esm/api/types/TranscribeCommandVariableType.d.mts

@@ -0,0 +1,6 @@
+/** Variable type. Use `enum` to define a fixed list of values that can be recognized for the variable. Use `wildcard` to recognize any undefined, open-ended free-text utterance. When using `wildcard`, the phrase must include a literal trigger word before the wildcard variable (a phrase may not begin with a wildcard variable), and multiple wildcard variables in a single phrase must be separated by a non-empty literal string (e.g. `select {text1} end select {text2}` is valid; `{text1} {text2}` is not). */
+export declare const TranscribeCommandVariableType: {
+    readonly Enum: "enum";
+    readonly Wildcard: "wildcard";
+};
+export type TranscribeCommandVariableType = (typeof TranscribeCommandVariableType)[keyof typeof TranscribeCommandVariableType];

package/dist/esm/api/types/TranscribeCommandVariableType.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Variable type. Use `enum` to define a fixed list of values that can be recognized for the variable. Use `wildcard` to recognize any undefined, open-ended free-text utterance. When using `wildcard`, the phrase must include a literal trigger word before the wildcard variable (a phrase may not begin with a wildcard variable), and multiple wildcard variables in a single phrase must be separated by a non-empty literal string (e.g. `select {text1} end select {text2}` is valid; `{text1} {text2}` is not). */
+export const TranscribeCommandVariableType = {
+    Enum: "enum",
+    Wildcard: "wildcard",
+};

package/dist/esm/api/types/TranscribeConfig.d.mts

@@ -2,16 +2,20 @@ import type * as Corti from "../index.mjs";
 export interface TranscribeConfig {
     /** The locale of the primary spoken language. */
     primaryLanguage: Corti.TranscribeSupportedLanguage;
-    /** When true, returns interim results for reduced latency */
+    /** When true, returns interim (preview) transcript results (`isFinal=false`) for reduced latency than final transcripts. Defaults to false. */
     interimResults?: boolean;
-    /** When true, converts spoken punctuation such as 'period' or 'slash' into '.' or '/' */
+    /** When true, converts spoken punctuation such as 'period' or 'slash' into '.' or '/'. Defaults to false. Overrides automaticPunctuation when both are enabled. */
     spokenPunctuation?: boolean;
-    /** When true, automatically punctuates and capitalizes in the final transcript */
+    /** When true, automatically punctuates and capitalizes in the final transcript. Defaults to false. Overridden by spokenPunctuation when both are enabled. */
     automaticPunctuation?: boolean;
     /** Commands that should be registered and detected */
     commands?: Corti.TranscribeCommand[];
     formatting?: Corti.TranscribeFormatting;
     audioEvents?: Corti.TranscribeAudioEventsConfig;
-    /** The audio format of the incoming audio stream */
+    /** Define the audio format of the incoming audio stream - optional but recommended. When omitted, the server auto-detects the format from the first audio chunk using ffprobe. Supported audio will be processed. Unsupported return an error but might in some cases error silently. If provided (recommended), the provided MIME type must be supported and the audio must match the MIME type. An unsupported MIME type results in `CONFIG_REJECTED`. Audio that differs from the MIME type will return audio validation errors on the socket. See full list of supported MIME types [here](/stt/audio). */
     audioFormat?: string;
+    /** Define replacements to have terms (single words or multi-word phrases) replaced in final text output with your preferred style. For example, replace "BID" with "twice daily". Configuration is case insensitive and limited to 1,000 replacements per stream. */
+    replacements?: Corti.TranscribeConfigReplacementsItem[];
+    /** Define words, terms, and phrases to be recognized by Corti speech-to-text. Especially useful for proper nouns (e.g., surnames), but also supportive of words not being recognized consistently. Configuration is case sensitive and limited to 1,000 key terms per stream. */
+    keyterms?: Corti.TranscribeConfigKeyterms;
 }

package/dist/esm/api/types/TranscribeConfigKeyterms.d.mts

@@ -0,0 +1,8 @@
+import type * as Corti from "../index.mjs";
+/**
+ * Define words, terms, and phrases to be recognized by Corti speech-to-text. Especially useful for proper nouns (e.g., surnames), but also supportive of words not being recognized consistently. Configuration is case sensitive and limited to 1,000 key terms per stream.
+ */
+export interface TranscribeConfigKeyterms {
+    /** Ordered list of words to be recognized. */
+    terms?: Corti.TranscribeConfigKeytermsTermsItem[];
+}

package/dist/esm/api/types/TranscribeConfigKeytermsTermsItem.d.mts

@@ -0,0 +1,4 @@
+export interface TranscribeConfigKeytermsTermsItem {
+    /** The word to be recognized, defined in its expected written form. */
+    term: string;
+}

package/dist/esm/api/types/TranscribeConfigKeytermsTermsItem.mjs

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

package/dist/esm/api/types/TranscribeConfigReplacementsItem.d.mts

@@ -0,0 +1,6 @@
+export interface TranscribeConfigReplacementsItem {
+    /** The term to be replaced, such as "BID". */
+    find: string;
+    /** The preferred replacement for the term, such as "twice daily". */
+    replace: string;
+}

package/dist/esm/api/types/TranscribeConfigReplacementsItem.mjs

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

package/dist/esm/api/types/TranscribeErrorMessageError.d.mts

@@ -1,12 +1,14 @@
 export interface TranscribeErrorMessageError {
+    /** Unique identifier for the request, for support and debugging. */
+    requestid?: string;
     /** Unique error identifier */
-    id: string;
+    id?: string;
     /** Error title */
-    title: string;
+    title?: string;
     /** HTTP status code */
-    status: number;
+    status?: number;
     /** Detailed error description */
-    details: string;
+    details?: string;
     /** Link to documentation */
-    doc: string;
+    doc?: string;
 }

package/dist/esm/api/types/TranscribeSupportedLanguage.d.mts

@@ -1,4 +1,4 @@
 /**
- * Supported language codes for transcription
+ * Supported language codes for transcription. See details and available language codes [here](https://docs.corti.ai/stt/languages).
  */
 export type TranscribeSupportedLanguage = string;

package/dist/esm/api/types/index.d.mts

@@ -143,12 +143,10 @@ export * from "./GuidedSectionInstructionsOverride.mjs";
 export * from "./GuidedSectionInstructionsPartial.mjs";
 export * from "./GuidedSectionOverride.mjs";
 export * from "./GuidedSectionOverrides.mjs";
-export * from "./GuidedSectionPolicy.mjs";
 export * from "./GuidedSectionSource.mjs";
 export * from "./GuidedSectionsCreateBase.mjs";
 export * from "./GuidedSectionsCreateFromInheritanceRequest.mjs";
 export * from "./GuidedSectionsCreateFromScratchRequest.mjs";
-export * from "./GuidedSectionsCreatePolicyRequest.mjs";
 export * from "./GuidedSectionsCreateRequest.mjs";
 export * from "./GuidedSectionVersion.mjs";
 export * from "./GuidedShallowTemplateGeneration.mjs";
@@ -160,8 +158,6 @@ export * from "./GuidedTemplateGeneration.mjs";
 export * from "./GuidedTemplateInstructions.mjs";
 export * from "./GuidedTemplateInstructionsPartial.mjs";
 export * from "./GuidedTemplateOverrides.mjs";
-export * from "./GuidedTemplatePolicy.mjs";
-export * from "./GuidedTemplatePolicyKind.mjs";
 export * from "./GuidedTemplateRef.mjs";
 export * from "./GuidedTemplateSource.mjs";
 export * from "./GuidedTemplatesCreateBase.mjs";
@@ -169,7 +165,6 @@ export * from "./GuidedTemplatesCreateFromInheritanceRequest.mjs";
 export * from "./GuidedTemplatesCreateFromInheritanceRequestGeneration.mjs";
 export * from "./GuidedTemplatesCreateFromScratchRequest.mjs";
 export * from "./GuidedTemplatesCreateFromScratchRequestGeneration.mjs";
-export * from "./GuidedTemplatesCreatePolicyRequest.mjs";
 export * from "./GuidedTemplatesCreateRequest.mjs";
 export * from "./GuidedTemplatesVersionGeneration.mjs";
 export * from "./GuidedTemplatesVersionSectionRequest.mjs";
@@ -195,12 +190,15 @@ export * from "./StreamAudioEventDataEvent.mjs";
 export * from "./StreamAudioEventMessage.mjs";
 export * from "./StreamAudioEventsConfig.mjs";
 export * from "./StreamConfig.mjs";
+export * from "./StreamConfigKeyterms.mjs";
+export * from "./StreamConfigKeytermsTermsItem.mjs";
 export * from "./StreamConfigMessage.mjs";
 export * from "./StreamConfigMode.mjs";
 export * from "./StreamConfigModeFactGenerationInterval.mjs";
 export * from "./StreamConfigModeType.mjs";
 export * from "./StreamConfigParticipant.mjs";
 export * from "./StreamConfigParticipantRole.mjs";
+export * from "./StreamConfigReplacementsItem.mjs";
 export * from "./StreamConfigRetentionPolicy.mjs";
 export * from "./StreamConfigStatusMessage.mjs";
 export * from "./StreamConfigStatusMessageType.mjs";
@@ -238,8 +236,12 @@ export * from "./TranscribeCommand.mjs";
 export * from "./TranscribeCommandData.mjs";
 export * from "./TranscribeCommandMessage.mjs";
 export * from "./TranscribeCommandVariable.mjs";
+export * from "./TranscribeCommandVariableType.mjs";
 export * from "./TranscribeConfig.mjs";
+export * from "./TranscribeConfigKeyterms.mjs";
+export * from "./TranscribeConfigKeytermsTermsItem.mjs";
 export * from "./TranscribeConfigMessage.mjs";
+export * from "./TranscribeConfigReplacementsItem.mjs";
 export * from "./TranscribeConfigStatusMessage.mjs";
 export * from "./TranscribeConfigStatusMessageType.mjs";
 export * from "./TranscribeDeltaUsageMessage.mjs";

package/dist/esm/api/types/index.mjs

@@ -143,12 +143,10 @@ export * from "./GuidedSectionInstructionsOverride.mjs";
 export * from "./GuidedSectionInstructionsPartial.mjs";
 export * from "./GuidedSectionOverride.mjs";
 export * from "./GuidedSectionOverrides.mjs";
-export * from "./GuidedSectionPolicy.mjs";
 export * from "./GuidedSectionSource.mjs";
 export * from "./GuidedSectionsCreateBase.mjs";
 export * from "./GuidedSectionsCreateFromInheritanceRequest.mjs";
 export * from "./GuidedSectionsCreateFromScratchRequest.mjs";
-export * from "./GuidedSectionsCreatePolicyRequest.mjs";
 export * from "./GuidedSectionsCreateRequest.mjs";
 export * from "./GuidedSectionVersion.mjs";
 export * from "./GuidedShallowTemplateGeneration.mjs";
@@ -160,8 +158,6 @@ export * from "./GuidedTemplateGeneration.mjs";
 export * from "./GuidedTemplateInstructions.mjs";
 export * from "./GuidedTemplateInstructionsPartial.mjs";
 export * from "./GuidedTemplateOverrides.mjs";
-export * from "./GuidedTemplatePolicy.mjs";
-export * from "./GuidedTemplatePolicyKind.mjs";
 export * from "./GuidedTemplateRef.mjs";
 export * from "./GuidedTemplateSource.mjs";
 export * from "./GuidedTemplatesCreateBase.mjs";
@@ -169,7 +165,6 @@ export * from "./GuidedTemplatesCreateFromInheritanceRequest.mjs";
 export * from "./GuidedTemplatesCreateFromInheritanceRequestGeneration.mjs";
 export * from "./GuidedTemplatesCreateFromScratchRequest.mjs";
 export * from "./GuidedTemplatesCreateFromScratchRequestGeneration.mjs";
-export * from "./GuidedTemplatesCreatePolicyRequest.mjs";
 export * from "./GuidedTemplatesCreateRequest.mjs";
 export * from "./GuidedTemplatesVersionGeneration.mjs";
 export * from "./GuidedTemplatesVersionSectionRequest.mjs";
@@ -195,12 +190,15 @@ export * from "./StreamAudioEventDataEvent.mjs";
 export * from "./StreamAudioEventMessage.mjs";
 export * from "./StreamAudioEventsConfig.mjs";
 export * from "./StreamConfig.mjs";
+export * from "./StreamConfigKeyterms.mjs";
+export * from "./StreamConfigKeytermsTermsItem.mjs";
 export * from "./StreamConfigMessage.mjs";
 export * from "./StreamConfigMode.mjs";
 export * from "./StreamConfigModeFactGenerationInterval.mjs";
 export * from "./StreamConfigModeType.mjs";
 export * from "./StreamConfigParticipant.mjs";
 export * from "./StreamConfigParticipantRole.mjs";
+export * from "./StreamConfigReplacementsItem.mjs";
 export * from "./StreamConfigRetentionPolicy.mjs";
 export * from "./StreamConfigStatusMessage.mjs";
 export * from "./StreamConfigStatusMessageType.mjs";
@@ -238,8 +236,12 @@ export * from "./TranscribeCommand.mjs";
 export * from "./TranscribeCommandData.mjs";
 export * from "./TranscribeCommandMessage.mjs";
 export * from "./TranscribeCommandVariable.mjs";
+export * from "./TranscribeCommandVariableType.mjs";
 export * from "./TranscribeConfig.mjs";
+export * from "./TranscribeConfigKeyterms.mjs";
+export * from "./TranscribeConfigKeytermsTermsItem.mjs";
 export * from "./TranscribeConfigMessage.mjs";
+export * from "./TranscribeConfigReplacementsItem.mjs";
 export * from "./TranscribeConfigStatusMessage.mjs";
 export * from "./TranscribeConfigStatusMessageType.mjs";
 export * from "./TranscribeDeltaUsageMessage.mjs";

package/dist/esm/custom/utils/dictationTranscript.d.mts

@@ -0,0 +1,26 @@
+import type { TranscribeTranscriptData } from "../../api/types/TranscribeTranscriptData.mjs";
+export interface DictationTranscriptSnapshot {
+    /** Finalized text. Use this for copy, clear, and JSON export. */
+    committedText: string;
+    /**
+     * Active interim preview. Empty string when none.
+     * Includes its leading boundary space so the UI can render it verbatim
+     * immediately after committedText.
+     */
+    interimText: string;
+    /** @internal */
+    _finalizedStarts: ReadonlySet<number>;
+    /** @internal */
+    _latestFinalEnd: number;
+}
+/**
+ * Pure function that applies a single transcript message to the previous
+ * snapshot and returns a new snapshot with updated committed/interim text.
+ *
+ * - Handles the two-layer committed + interim model (DXG-844).
+ * - Ignores late interims that overlap an already-finalized timeline (DXG-1093).
+ *
+ * @param previous - The last snapshot, or `undefined` on first call.
+ * @param message  - The incoming transcript packet (subset of TranscribeTranscriptData).
+ */
+export declare function applyDictationTranscript(previous: DictationTranscriptSnapshot | undefined, message: Pick<TranscribeTranscriptData, "text" | "start" | "end" | "isFinal">): DictationTranscriptSnapshot;

package/dist/esm/custom/utils/dictationTranscript.mjs

@@ -0,0 +1,74 @@
+const NO_SPACE_AFTER = new Set(["(", "[", "{", '"', "'", "\u2018", "\u201c"]);
+const LEFT_ATTACH = new Set([",", ".", ":", ";", "!", "?", ")", "]", "}", "%"]);
+/**
+ * Returns the segment text prefixed with at most one space, applying
+ * punctuation-aware boundary rules so callers never produce double-spaces
+ * or spaces before attachment characters.
+ */
+function buildInsertion(committed, segment) {
+    var _a;
+    if (!segment)
+        return segment;
+    const prevChar = committed.length > 0 ? committed[committed.length - 1] : "";
+    const nextChar = (_a = segment[0]) !== null && _a !== void 0 ? _a : "";
+    const needsSpace = committed.length > 0 && !/\s/.test(prevChar) && !NO_SPACE_AFTER.has(prevChar) && !LEFT_ATTACH.has(nextChar);
+    return needsSpace ? ` ${segment}` : segment;
+}
+/**
+ * Pure function that applies a single transcript message to the previous
+ * snapshot and returns a new snapshot with updated committed/interim text.
+ *
+ * - Handles the two-layer committed + interim model (DXG-844).
+ * - Ignores late interims that overlap an already-finalized timeline (DXG-1093).
+ *
+ * @param previous - The last snapshot, or `undefined` on first call.
+ * @param message  - The incoming transcript packet (subset of TranscribeTranscriptData).
+ */
+export function applyDictationTranscript(previous, message) {
+    var _a, _b, _c;
+    const committedText = (_a = previous === null || previous === void 0 ? void 0 : previous.committedText) !== null && _a !== void 0 ? _a : "";
+    const finalizedStarts = (_b = previous === null || previous === void 0 ? void 0 : previous._finalizedStarts) !== null && _b !== void 0 ? _b : new Set();
+    const latestFinalEnd = (_c = previous === null || previous === void 0 ? void 0 : previous._latestFinalEnd) !== null && _c !== void 0 ? _c : -Infinity;
+    if (message.isFinal) {
+        if (finalizedStarts.has(message.start)) {
+            return {
+                committedText,
+                interimText: "",
+                _finalizedStarts: finalizedStarts,
+                _latestFinalEnd: latestFinalEnd,
+            };
+        }
+        const nextFinalizedStarts = new Set(finalizedStarts);
+        nextFinalizedStarts.add(message.start);
+        const newCommitted = committedText + buildInsertion(committedText, message.text);
+        return {
+            committedText: newCommitted,
+            interimText: "",
+            _finalizedStarts: nextFinalizedStarts,
+            _latestFinalEnd: Math.max(latestFinalEnd, message.end),
+        };
+    }
+    // Interim path.
+    if (finalizedStarts.has(message.start)) {
+        return (previous !== null && previous !== void 0 ? previous : {
+            committedText: "",
+            interimText: "",
+            _finalizedStarts: finalizedStarts,
+            _latestFinalEnd: latestFinalEnd,
+        });
+    }
+    if (message.start < latestFinalEnd) {
+        return (previous !== null && previous !== void 0 ? previous : {
+            committedText: "",
+            interimText: "",
+            _finalizedStarts: finalizedStarts,
+            _latestFinalEnd: latestFinalEnd,
+        });
+    }
+    return {
+        committedText,
+        interimText: buildInsertion(committedText, message.text),
+        _finalizedStarts: finalizedStarts,
+        _latestFinalEnd: latestFinalEnd,
+    };
+}

package/dist/esm/custom/utils/index.d.mts

@@ -1,3 +1,4 @@
 export { type DecodedToken, decodeToken } from "./decodeToken.mjs";
+export { applyDictationTranscript, type DictationTranscriptSnapshot, } from "./dictationTranscript.mjs";
 export { getEnvironment } from "./environment.mjs";
 export { generateCodeChallenge, generateCodeVerifier } from "./pkceHelpers.mjs";

package/dist/esm/custom/utils/index.mjs

@@ -1,3 +1,4 @@
 export { decodeToken } from "./decodeToken.mjs";
+export { applyDictationTranscript, } from "./dictationTranscript.mjs";
 export { getEnvironment } from "./environment.mjs";
 export { generateCodeChallenge, generateCodeVerifier } from "./pkceHelpers.mjs";

package/dist/esm/serialization/resources/transcripts/client/requests/TranscriptsCreateRequest.d.mts

@@ -12,5 +12,6 @@ export declare namespace TranscriptsCreateRequest {
         isMultichannel?: boolean | null;
         diarize?: boolean | null;
         participants?: TranscriptsParticipant.Raw[] | null;
+        async?: boolean | null;
     }
 }

package/dist/esm/serialization/resources/transcripts/client/requests/TranscriptsCreateRequest.mjs

@@ -9,4 +9,5 @@ export const TranscriptsCreateRequest = core.serialization.object({
     isMultichannel: core.serialization.boolean().optional(),
     diarize: core.serialization.boolean().optional(),
     participants: core.serialization.list(TranscriptsParticipant).optional(),
+    async: core.serialization.boolean().optional(),
 });

package/dist/esm/serialization/types/GuidedDocumentsGenerateBase.d.mts

@@ -2,11 +2,13 @@ import type * as Corti from "../../api/index.mjs";
 import * as core from "../../core/index.mjs";
 import type * as serializers from "../index.mjs";
 import { GuidedDocumentContext } from "./GuidedDocumentContext.mjs";
+import { GuidedLabel } from "./GuidedLabel.mjs";
 export declare const GuidedDocumentsGenerateBase: core.serialization.ObjectSchema<serializers.GuidedDocumentsGenerateBase.Raw, Corti.GuidedDocumentsGenerateBase>;
 export declare namespace GuidedDocumentsGenerateBase {
     interface Raw {
         outputLanguage: string;
         context?: GuidedDocumentContext.Raw[] | null;
         interactionId?: string | null;
+        labels?: GuidedLabel.Raw[] | null;
     }
 }

package/dist/esm/serialization/types/GuidedDocumentsGenerateBase.mjs

@@ -1,8 +1,10 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../core/index.mjs";
 import { GuidedDocumentContext } from "./GuidedDocumentContext.mjs";
+import { GuidedLabel } from "./GuidedLabel.mjs";
 export const GuidedDocumentsGenerateBase = core.serialization.object({
     outputLanguage: core.serialization.string(),
     context: core.serialization.list(GuidedDocumentContext).optional(),
     interactionId: core.serialization.string().optional(),
+    labels: core.serialization.list(GuidedLabel).optional(),
 });

package/dist/esm/serialization/types/GuidedEphemeralDocument.d.mts

@@ -1,6 +1,7 @@
 import type * as Corti from "../../api/index.mjs";
 import * as core from "../../core/index.mjs";
 import type * as serializers from "../index.mjs";
+import { GuidedLabel } from "./GuidedLabel.mjs";
 export declare const GuidedEphemeralDocument: core.serialization.ObjectSchema<serializers.GuidedEphemeralDocument.Raw, Corti.GuidedEphemeralDocument>;
 export declare namespace GuidedEphemeralDocument {
     interface Raw {
@@ -8,7 +9,9 @@ export declare namespace GuidedEphemeralDocument {
         templateId: string;
         templateVersionId: string;
         language: string;
+        interactionId?: (string | null | undefined) | null;
         stringDocument: Record<string, string>;
         structuredDocument?: (Record<string, unknown> | null | undefined) | null;
+        labels: GuidedLabel.Raw[];
     }
 }

package/dist/esm/serialization/types/GuidedEphemeralDocument.mjs

@@ -1,12 +1,15 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../core/index.mjs";
+import { GuidedLabel } from "./GuidedLabel.mjs";
 export const GuidedEphemeralDocument = core.serialization.object({
     name: core.serialization.string(),
     templateId: core.serialization.string(),
     templateVersionId: core.serialization.string(),
     language: core.serialization.string(),
+    interactionId: core.serialization.string().optionalNullable(),
     stringDocument: core.serialization.record(core.serialization.string(), core.serialization.string()),
     structuredDocument: core.serialization
         .record(core.serialization.string(), core.serialization.unknown())
         .optionalNullable(),
+    labels: core.serialization.list(GuidedLabel),
 });

package/dist/esm/serialization/types/GuidedFieldDefinition.d.mts

@@ -7,5 +7,6 @@ export declare namespace GuidedFieldDefinition {
         key: string;
         description: string;
         value: serializers.GuidedOutputSchema.Raw;
+        default?: (string | null | undefined) | null;
     }
 }

package/dist/esm/serialization/types/GuidedFieldDefinition.mjs

@@ -5,4 +5,5 @@ export const GuidedFieldDefinition = core.serialization.object({
     key: core.serialization.string(),
     description: core.serialization.string(),
     value: core.serialization.lazy(() => serializers.GuidedOutputSchema),
+    default: core.serialization.string().optionalNullable(),
 });