generated(api-spec): API specification updates

.fern/metadata.json

@@ -1,5 +1,5 @@
 {
-    "cliVersion": "4.86.1",
+    "cliVersion": "5.17.0",
     "generatorName": "fernapi/fern-typescript-node-sdk",
     "generatorVersion": "3.54.0",
     "generatorConfig": {
@@ -15,7 +15,9 @@
         },
         "packageJson": {
             "scripts": {
-                "test:integration": "vitest --config vitest.integration.config.mts"
+                "test:integration": "pnpm test:integration:main && pnpm test:integration:empty-state",
+                "test:integration:main": "vitest run --config vitest.integration.config.mts --project integration",
+                "test:integration:empty-state": "vitest run --config vitest.integration.config.mts --project integration-empty-state"
             },
             "exports": {
                 "./utils": {
@@ -32,6 +34,6 @@
             }
         }
     },
-    "originGitCommit": "23bce53307f0836f2dcd50e82ef0aba136e7ec2f",
+    "originGitCommit": "1f12feddb4e52d5d77f67aa2f37c22a4d357a59a",
     "sdkVersion": "0.0.0-dev"
 }

src/api/resources/stream/client/Socket.ts

@@ -21,7 +21,8 @@ export declare namespace StreamSocket {
         | Corti.StreamEndedMessage
         | Corti.StreamUsageMessage
         | Corti.StreamErrorMessage
-        | Corti.StreamConfigStatusMessage;
+        | Corti.StreamConfigStatusMessage
+        | Corti.StreamAudioEventMessage;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;

src/api/resources/transcribe/client/Socket.ts

@@ -21,7 +21,8 @@ export declare namespace TranscribeSocket {
         | Corti.TranscribeErrorMessage
         | Corti.TranscribeTranscriptMessage
         | Corti.TranscribeCommandMessage
-        | Corti.TranscribeConfigStatusMessage;
+        | Corti.TranscribeConfigStatusMessage
+        | Corti.TranscribeAudioEventMessage;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;

src/api/types/AgentsCreateExpertReference.ts

@@ -13,4 +13,6 @@ export interface AgentsCreateExpertReference {
     name?: string;
     /** Optional. Additional system instructions appended to the default system prompt when creating an expert from the registry, extending the expert's behavior. */
     systemPrompt?: string;
+    /** Optional configuration override for the registry expert. Values provided here are deep-merged with the schema defaults declared on the registry expert and validated against its `configSchema`. Ignored when the registry expert has no schema. */
+    config?: Record<string, unknown>;
 }

src/api/types/AgentsExpertReference.ts

@@ -13,4 +13,6 @@ export interface AgentsExpertReference {
     name: string;
     /** Optional. Additional system instructions appended to the default system prompt when creating an expert from the registry, extending the expert's behavior. */
     systemPrompt?: string;
+    /** The fully resolved configuration for this expert: schema defaults from the registry expert deep-merged with any `config` override supplied at creation. Present only when the source registry expert defined a `configSchema`. */
+    resolvedConfig?: Record<string, unknown>;
 }

src/api/types/AgentsRegistryExpert.ts

@@ -13,4 +13,6 @@ export interface AgentsRegistryExpert {
     description: string;
     /** A list of MCP servers the expert can call, including their authorization types. */
     mcpServers?: Corti.AgentsRegistryMcpServer[];
+    /** Optional JSON Schema describing the configuration this expert accepts. When present, callers may supply a matching `config` object on `AgentsCreateExpertReference`; values are deep-merged with schema defaults and validated against this schema. */
+    configSchema?: Record<string, unknown>;
 }

src/api/types/StreamAudioEventData.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Corti from "../index.js";
+
+export interface StreamAudioEventData {
+    /** The type of audio quality or speech activity event */
+    event: Corti.StreamAudioEventDataEvent;
+    /** Audio channel identifier */
+    channel: number;
+    /** Start time of the event in milliseconds */
+    startTimeMs: number;
+}

src/api/types/StreamAudioEventDataEvent.ts

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/** The type of audio quality or speech activity event */
+export const StreamAudioEventDataEvent = {
+    SpeechQualityIssueDetected: "speechQualityIssueDetected",
+    SpeechQualityIssueRecovered: "speechQualityIssueRecovered",
+    LongSilenceDetected: "longSilenceDetected",
+    LongSilenceRecovered: "longSilenceRecovered",
+} as const;
+export type StreamAudioEventDataEvent = (typeof StreamAudioEventDataEvent)[keyof typeof StreamAudioEventDataEvent];

src/api/types/StreamAudioEventMessage.ts

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Corti from "../index.js";
+
+export interface StreamAudioEventMessage {
+    type: "audioEvent";
+    data: Corti.StreamAudioEventData;
+}

src/api/types/StreamAudioEventsConfig.ts

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface StreamAudioEventsConfig {
+    /** When true, enables audio quality and speech activity events to be sent over the WebSocket. Disabled by default. */
+    enabled?: boolean;
+}

src/api/types/StreamConfig.ts

@@ -7,6 +7,7 @@ export interface StreamConfig {
     mode: Corti.StreamConfigMode;
     /** 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 */
     audioFormat?: string;
 }

src/api/types/StreamConfigMode.ts

@@ -7,4 +7,6 @@ export interface StreamConfigMode {
     type: Corti.StreamConfigModeType;
     /** Output language locale specific to facts. */
     outputLocale?: Corti.StreamSupportedLanguage;
+    /** Rate at which fact generation should process and return results. If no value is set, the default is `fixed` and will trigger fact generation at the standard interval of around 60s. With `fast_init`, fact generation will follow a logarithmic curve. */
+    factGenerationInterval?: Corti.StreamConfigModeFactGenerationInterval;
 }

src/api/types/StreamConfigModeFactGenerationInterval.ts

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/** Rate at which fact generation should process and return results. If no value is set, the default is `fixed` and will trigger fact generation at the standard interval of around 60s. With `fast_init`, fact generation will follow a logarithmic curve. */
+export const StreamConfigModeFactGenerationInterval = {
+    Fixed: "fixed",
+    FastInit: "fast_init",
+} as const;
+export type StreamConfigModeFactGenerationInterval =
+    (typeof StreamConfigModeFactGenerationInterval)[keyof typeof StreamConfigModeFactGenerationInterval];

src/api/types/TranscribeAudioEventData.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Corti from "../index.js";
+
+export interface TranscribeAudioEventData {
+    /** The type of audio quality or speech activity event */
+    event: Corti.TranscribeAudioEventDataEvent;
+    /** Audio channel identifier */
+    channel: number;
+    /** Start time of the event in milliseconds */
+    startTimeMs: number;
+}

src/api/types/TranscribeAudioEventDataEvent.ts

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/** The type of audio quality or speech activity event */
+export const TranscribeAudioEventDataEvent = {
+    SpeechQualityIssueDetected: "speechQualityIssueDetected",
+    SpeechQualityIssueRecovered: "speechQualityIssueRecovered",
+    LongSilenceDetected: "longSilenceDetected",
+    LongSilenceRecovered: "longSilenceRecovered",
+} as const;
+export type TranscribeAudioEventDataEvent =
+    (typeof TranscribeAudioEventDataEvent)[keyof typeof TranscribeAudioEventDataEvent];

src/api/types/TranscribeAudioEventMessage.ts

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Corti from "../index.js";
+
+export interface TranscribeAudioEventMessage {
+    type: "audioEvent";
+    data: Corti.TranscribeAudioEventData;
+}

src/api/types/TranscribeAudioEventsConfig.ts

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface TranscribeAudioEventsConfig {
+    /** When true, enables audio quality and speech activity events to be sent over the WebSocket. Disabled by default. */
+    enabled?: boolean;
+}

src/api/types/TranscribeConfig.ts

@@ -14,6 +14,7 @@ export interface TranscribeConfig {
     /** Commands that should be registered and detected */
     commands?: Corti.TranscribeCommand[];
     formatting?: Corti.TranscribeFormatting;
+    audioEvents?: Corti.TranscribeAudioEventsConfig;
     /** The audio format of the incoming audio stream */
     audioFormat?: string;
 }

src/api/types/index.ts

@@ -127,9 +127,14 @@ export * from "./InteractionsPatient.js";
 export * from "./OAuthTokenRequest.js";
 export * from "./RecordingsCreateResponse.js";
 export * from "./RecordingsListResponse.js";
+export * from "./StreamAudioEventData.js";
+export * from "./StreamAudioEventDataEvent.js";
+export * from "./StreamAudioEventMessage.js";
+export * from "./StreamAudioEventsConfig.js";
 export * from "./StreamConfig.js";
 export * from "./StreamConfigMessage.js";
 export * from "./StreamConfigMode.js";
+export * from "./StreamConfigModeFactGenerationInterval.js";
 export * from "./StreamConfigModeType.js";
 export * from "./StreamConfigParticipant.js";
 export * from "./StreamConfigParticipantRole.js";
@@ -162,6 +167,10 @@ export * from "./TemplatesSectionSorted.js";
 export * from "./TemplatesSectionTranslation.js";
 export * from "./TemplatesTranslation.js";
 export * from "./TemplatesWritingStyle.js";
+export * from "./TranscribeAudioEventData.js";
+export * from "./TranscribeAudioEventDataEvent.js";
+export * from "./TranscribeAudioEventMessage.js";
+export * from "./TranscribeAudioEventsConfig.js";
 export * from "./TranscribeCommand.js";
 export * from "./TranscribeCommandData.js";
 export * from "./TranscribeCommandMessage.js";

src/serialization/resources/stream/client/socket/StreamSocketResponse.ts

@@ -3,6 +3,7 @@
 import type * as Corti from "../../../../../api/index.js";
 import * as core from "../../../../../core/index.js";
 import type * as serializers from "../../../../index.js";
+import { StreamAudioEventMessage } from "../../../../types/StreamAudioEventMessage.js";
 import { StreamConfigStatusMessage } from "../../../../types/StreamConfigStatusMessage.js";
 import { StreamDeltaUsageMessage } from "../../../../types/StreamDeltaUsageMessage.js";
 import { StreamEndedMessage } from "../../../../types/StreamEndedMessage.js";
@@ -22,6 +23,7 @@ export const StreamSocketResponse: core.serialization.Schema<
     | Corti.StreamUsageMessage
     | Corti.StreamErrorMessage
     | Corti.StreamConfigStatusMessage
+    | Corti.StreamAudioEventMessage
 > = core.serialization.undiscriminatedUnion([
     StreamTranscriptMessage,
     StreamFactsMessage,
@@ -31,6 +33,7 @@ export const StreamSocketResponse: core.serialization.Schema<
     StreamUsageMessage,
     StreamErrorMessage,
     StreamConfigStatusMessage,
+    StreamAudioEventMessage,
 ]);
 
 export declare namespace StreamSocketResponse {
@@ -42,5 +45,6 @@ export declare namespace StreamSocketResponse {
         | StreamEndedMessage.Raw
         | StreamUsageMessage.Raw
         | StreamErrorMessage.Raw
-        | StreamConfigStatusMessage.Raw;
+        | StreamConfigStatusMessage.Raw
+        | StreamAudioEventMessage.Raw;
 }

src/serialization/resources/transcribe/client/socket/TranscribeSocketResponse.ts

@@ -3,6 +3,7 @@
 import type * as Corti from "../../../../../api/index.js";
 import * as core from "../../../../../core/index.js";
 import type * as serializers from "../../../../index.js";
+import { TranscribeAudioEventMessage } from "../../../../types/TranscribeAudioEventMessage.js";
 import { TranscribeCommandMessage } from "../../../../types/TranscribeCommandMessage.js";
 import { TranscribeConfigStatusMessage } from "../../../../types/TranscribeConfigStatusMessage.js";
 import { TranscribeDeltaUsageMessage } from "../../../../types/TranscribeDeltaUsageMessage.js";
@@ -22,6 +23,7 @@ export const TranscribeSocketResponse: core.serialization.Schema<
     | Corti.TranscribeTranscriptMessage
     | Corti.TranscribeCommandMessage
     | Corti.TranscribeConfigStatusMessage
+    | Corti.TranscribeAudioEventMessage
 > = core.serialization.undiscriminatedUnion([
     TranscribeUsageMessage,
     TranscribeFlushedMessage,
@@ -31,6 +33,7 @@ export const TranscribeSocketResponse: core.serialization.Schema<
     TranscribeTranscriptMessage,
     TranscribeCommandMessage,
     TranscribeConfigStatusMessage,
+    TranscribeAudioEventMessage,
 ]);
 
 export declare namespace TranscribeSocketResponse {
@@ -42,5 +45,6 @@ export declare namespace TranscribeSocketResponse {
         | TranscribeErrorMessage.Raw
         | TranscribeTranscriptMessage.Raw
         | TranscribeCommandMessage.Raw
-        | TranscribeConfigStatusMessage.Raw;
+        | TranscribeConfigStatusMessage.Raw
+        | TranscribeAudioEventMessage.Raw;
 }

src/serialization/types/AgentsCreateExpertReference.ts

@@ -13,6 +13,7 @@ export const AgentsCreateExpertReference: core.serialization.ObjectSchema<
     id: core.serialization.string().optional(),
     name: core.serialization.string().optional(),
     systemPrompt: core.serialization.string().optional(),
+    config: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
 });
 
 export declare namespace AgentsCreateExpertReference {
@@ -21,5 +22,6 @@ export declare namespace AgentsCreateExpertReference {
         id?: string | null;
         name?: string | null;
         systemPrompt?: string | null;
+        config?: Record<string, unknown> | null;
     }
 }

src/serialization/types/AgentsExpertReference.ts

@@ -13,6 +13,7 @@ export const AgentsExpertReference: core.serialization.ObjectSchema<
     id: core.serialization.string(),
     name: core.serialization.string(),
     systemPrompt: core.serialization.string().optional(),
+    resolvedConfig: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
 });
 
 export declare namespace AgentsExpertReference {
@@ -21,5 +22,6 @@ export declare namespace AgentsExpertReference {
         id: string;
         name: string;
         systemPrompt?: string | null;
+        resolvedConfig?: Record<string, unknown> | null;
     }
 }

src/serialization/types/AgentsRegistryExpert.ts

@@ -14,6 +14,7 @@ export const AgentsRegistryExpert: core.serialization.ObjectSchema<
     displayDescription: core.serialization.string().optional(),
     description: core.serialization.string(),
     mcpServers: core.serialization.list(AgentsRegistryMcpServer).optional(),
+    configSchema: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
 });
 
 export declare namespace AgentsRegistryExpert {
@@ -23,5 +24,6 @@ export declare namespace AgentsRegistryExpert {
         displayDescription?: string | null;
         description: string;
         mcpServers?: AgentsRegistryMcpServer.Raw[] | null;
+        configSchema?: Record<string, unknown> | null;
     }
 }

src/serialization/types/StreamAudioEventData.ts

@@ -0,0 +1,23 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Corti from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { StreamAudioEventDataEvent } from "./StreamAudioEventDataEvent.js";
+
+export const StreamAudioEventData: core.serialization.ObjectSchema<
+    serializers.StreamAudioEventData.Raw,
+    Corti.StreamAudioEventData
+> = core.serialization.object({
+    event: StreamAudioEventDataEvent,
+    channel: core.serialization.number(),
+    startTimeMs: core.serialization.number(),
+});
+
+export declare namespace StreamAudioEventData {
+    export interface Raw {
+        event: StreamAudioEventDataEvent.Raw;
+        channel: number;
+        startTimeMs: number;
+    }
+}

src/serialization/types/StreamAudioEventDataEvent.ts

@@ -0,0 +1,23 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as Corti from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+
+export const StreamAudioEventDataEvent: core.serialization.Schema<
+    serializers.StreamAudioEventDataEvent.Raw,
+    Corti.StreamAudioEventDataEvent
+> = core.serialization.enum_([
+    "speechQualityIssueDetected",
+    "speechQualityIssueRecovered",
+    "longSilenceDetected",
+    "longSilenceRecovered",
+]);
+
+export declare namespace StreamAudioEventDataEvent {
+    export type Raw =
+        | "speechQualityIssueDetected"
+        | "speechQualityIssueRecovered"
+        | "longSilenceDetected"
+        | "longSilenceRecovered";
+}