supafone-labs 0.6.2 → 0.7.0

package/dist/s2s.d.ts

@@ -0,0 +1,42 @@
+import type { CreateLabsAgentRequest, GetLabsAgentOptions, LabsRealtimeSelection, SupafoneLabs } from "./index.js";
+export type S2SProviderName = "ultravox" | "openai" | "google" | "xai" | "smallest";
+export interface S2SModelOptions {
+    model?: string;
+    voice?: string;
+}
+export interface S2SOptions extends S2SModelOptions {
+    provider?: S2SProviderName;
+}
+/** Shared parent for Supafone-hosted S2S agents. Vendor keys stay on the server. */
+export declare class SupafoneS2S {
+    protected readonly client: SupafoneLabs;
+    readonly provider: S2SProviderName;
+    private readonly selection;
+    constructor(client: SupafoneLabs, options?: S2SOptions);
+    /** A fresh wire selection; null explicitly restores the default Ultravox runtime. */
+    get realtime(): LabsRealtimeSelection | null;
+    /** Create through the normal hosted agent factory with this provider. */
+    create(input: Omit<CreateLabsAgentRequest, "realtime">): Promise<import("./index.js").CreateLabsAgentResponse>;
+    /** Change the saved selection for subsequent calls, preserving the agent and number. */
+    apply(agentKey: string, options?: GetLabsAgentOptions): Promise<import("./index.js").LabsAgentLifecycleResponse>;
+    /** Preview the saved agent. Call apply first when switching providers. */
+    testCall(agentKey: string, options?: GetLabsAgentOptions): Promise<import("./index.js").LabsBrowserTestSession>;
+    private checkAgentKey;
+}
+export declare class UltravoxS2S extends SupafoneS2S {
+    constructor(client: SupafoneLabs);
+}
+export declare class OpenAIS2S extends SupafoneS2S {
+    constructor(client: SupafoneLabs, options?: S2SModelOptions);
+}
+export declare class GeminiS2S extends SupafoneS2S {
+    constructor(client: SupafoneLabs, options?: S2SModelOptions);
+}
+export declare class GrokS2S extends SupafoneS2S {
+    constructor(client: SupafoneLabs, options?: S2SModelOptions);
+}
+/** Smallest AI Hydra: full-duplex audio, without transcript events. */
+export declare class HydraS2S extends SupafoneS2S {
+    constructor(client: SupafoneLabs, options?: S2SModelOptions);
+}
+//# sourceMappingURL=s2s.d.ts.map

package/dist/s2s.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s2s.d.ts","sourceRoot":"","sources":["../src/s2s.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;AACpF,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,oFAAoF;AACpF,qBAAa,WAAW;IAIV,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAHnD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;gBAE1B,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,UAAe;IAsB7E,qFAAqF;IACrF,IAAI,QAAQ,IAAI,qBAAqB,GAAG,IAAI,CAE3C;IAED,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC;IAUtD,wFAAwF;IACxF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAKzD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAK5D,OAAO,CAAC,aAAa;CAGtB;AAED,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,MAAM,EAAE,YAAY;CACjC;AACD,qBAAa,SAAU,SAAQ,WAAW;gBAC5B,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB;CAGhE;AACD,qBAAa,SAAU,SAAQ,WAAW;gBAC5B,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB;CAGhE;AACD,qBAAa,OAAQ,SAAQ,WAAW;gBAC1B,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB;CAGhE;AACD,uEAAuE;AACvE,qBAAa,QAAS,SAAQ,WAAW;gBAC3B,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB;CAGhE"}

package/dist/s2s.js

@@ -0,0 +1,81 @@
+/** Shared parent for Supafone-hosted S2S agents. Vendor keys stay on the server. */
+export class SupafoneS2S {
+    client;
+    provider;
+    selection;
+    constructor(client, options = {}) {
+        this.client = client;
+        const provider = options.provider ?? "ultravox";
+        if (!["ultravox", "openai", "google", "xai", "smallest"].includes(provider)) {
+            throw new Error("Unsupported Supafone S2S provider");
+        }
+        if (provider === "ultravox" && (options.model !== undefined || options.voice !== undefined)) {
+            throw new Error("Configure Ultravox voices through the agent's voice settings");
+        }
+        for (const field of ["model", "voice"]) {
+            const value = options[field];
+            if (value !== undefined && (typeof value !== "string" || !value.trim())) {
+                throw new Error(`${field} must be a non-empty string`);
+            }
+        }
+        this.provider = provider;
+        this.selection = provider === "ultravox" ? null : {
+            provider,
+            ...(options.model !== undefined ? { model: options.model.trim() } : {}),
+            ...(options.voice !== undefined ? { voice: options.voice.trim() } : {}),
+        };
+    }
+    /** A fresh wire selection; null explicitly restores the default Ultravox runtime. */
+    get realtime() {
+        return this.selection ? { ...this.selection } : null;
+    }
+    /** Create through the normal hosted agent factory with this provider. */
+    create(input) {
+        if ("realtime" in input) {
+            throw new Error("Set provider/model/voice on the S2S adapter, not create({realtime: ...})");
+        }
+        return this.client.labs.agents.create({
+            ...input,
+            ...(this.realtime ? { realtime: this.realtime } : {}),
+        });
+    }
+    /** Change the saved selection for subsequent calls, preserving the agent and number. */
+    apply(agentKey, options = {}) {
+        this.checkAgentKey(agentKey);
+        return this.client.labs.agents.update(agentKey, { realtime: this.realtime }, options);
+    }
+    /** Preview the saved agent. Call apply first when switching providers. */
+    testCall(agentKey, options = {}) {
+        this.checkAgentKey(agentKey);
+        return this.client.labs.agents.testCall(agentKey, options);
+    }
+    checkAgentKey(agentKey) {
+        if (typeof agentKey !== "string" || !agentKey.trim())
+            throw new Error("agentKey is required");
+    }
+}
+export class UltravoxS2S extends SupafoneS2S {
+    constructor(client) { super(client, { provider: "ultravox" }); }
+}
+export class OpenAIS2S extends SupafoneS2S {
+    constructor(client, options = {}) {
+        super(client, { ...options, provider: "openai" });
+    }
+}
+export class GeminiS2S extends SupafoneS2S {
+    constructor(client, options = {}) {
+        super(client, { ...options, provider: "google" });
+    }
+}
+export class GrokS2S extends SupafoneS2S {
+    constructor(client, options = {}) {
+        super(client, { ...options, provider: "xai" });
+    }
+}
+/** Smallest AI Hydra: full-duplex audio, without transcript events. */
+export class HydraS2S extends SupafoneS2S {
+    constructor(client, options = {}) {
+        super(client, { ...options, provider: "smallest" });
+    }
+}
+//# sourceMappingURL=s2s.js.map

package/dist/s2s.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supafone-labs",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Build voice agents with one speech-to-speech harness and swappable models.",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/src/index.ts

@@ -1,3 +1,6 @@
+export { SupafoneS2S, UltravoxS2S, OpenAIS2S, GeminiS2S, GrokS2S, HydraS2S } from "./s2s.js";
+export type { S2SProviderName, S2SModelOptions, S2SOptions } from "./s2s.js";
+
 /**
  * Supafone Labs — the agent framework behind Supafone.
  *
@@ -221,9 +224,70 @@ export interface LabsCallStage {
   temperature?: number;
   nextStages?: string[];
   next_stages?: string[];
+  /** Server-enforced exit gates, independent of conversational exit criteria. */
+  requirements?: LabsStageRequirements;
+  role?: string;
+  specialistId?: string;
+  specialist_id?: string;
   metadata?: Record<string, unknown>;
 }
 
+export interface LabsStageRequirements {
+  requiredFields?: string[];
+  required_fields?: string[];
+  successfulTools?: string[];
+  successful_tools?: string[];
+}
+
+export interface LabsManagerConfig {
+  enabled?: boolean;
+  /** Reuse the existing encrypted Supervisor profile, or use managed reasoning. */
+  reasoning?: "managed" | "supervisor";
+  model?: "supafone-manager" | "supafone-manager-pro";
+  maxTasks?: number;
+  max_tasks?: number;
+  maxParallel?: number;
+  max_parallel?: number;
+  timeoutSeconds?: number;
+  timeout_seconds?: number;
+}
+
+export interface LabsSpecialist {
+  id: string;
+  role?: string;
+  label?: string;
+  description?: string;
+  instructions?: string;
+  enabled?: boolean;
+  stageKeys?: string[];
+  stage_keys?: string[];
+  tools?: string[];
+}
+
+export interface LabsAgentTeam {
+  enabled?: boolean;
+  routingMode?: "auto" | "sequential";
+  routing_mode?: "auto" | "sequential";
+  fallbackMemberId?: string;
+  fallback_member_id?: string;
+  members?: LabsSpecialist[];
+  routingRules?: Array<{ intent: string; member_id: string; priority?: string; action?: string }>;
+  routing_rules?: Array<{ intent: string; member_id: string; priority?: string; action?: string }>;
+}
+
+export interface LabsRuntimeRoutingConfig {
+  enabled?: boolean;
+  allowedModels?: LabsRealtimeSelection[];
+  allowed_models?: LabsRealtimeSelection[];
+  /** Server-supported range is 1–3 handoffs per call. */
+  maxHandoffs?: number;
+  max_handoffs?: number;
+  recoverOnDisconnect?: boolean;
+  recover_on_disconnect?: boolean;
+  allowedLanguages?: string[];
+  allowed_languages?: string[];
+}
+
 export type LabsStageGeneration = "managed" | "template" | "off" | "oracle";
 
 export interface LabsCallPlan {
@@ -385,7 +449,7 @@ export interface LabsVoicePreference {
 
 /** Direct speech-to-speech configuration for browser previews and carrier phone calls. */
 export interface LabsRealtimeSelection {
-  provider: "openai" | "google" | "xai";
+  provider: "openai" | "google" | "xai" | "smallest";
   model?: string;
   voice?: string;
 }
@@ -406,6 +470,17 @@ export interface LabsBrowserTestSession {
     token?: string | null;
     input_sample_rate?: number;
     output_sample_rate?: number;
+    capabilities?: {
+      stages?: boolean;
+      tools?: boolean;
+      transcripts?: boolean;
+      recording?: boolean;
+      supervisor?: boolean;
+      transfer?: boolean;
+      mutable_instructions?: boolean;
+      stage_update_mode?: string;
+      languages?: string[];
+    };
   };
 }
 
@@ -483,6 +558,9 @@ export interface LabsProviderKeys {
   xai?: string;
   xaiApiKey?: string;
   xai_api_key?: string;
+  smallest?: string;
+  smallestApiKey?: string;
+  smallest_api_key?: string;
   [extra: string]: unknown;
 }
 
@@ -675,6 +753,8 @@ export interface LabsEmailConfig {
 
 export interface LabsRecordingConfig {
   enabled?: boolean;
+  /** Request post-call transcription of the recording where configured. */
+  transcribe?: boolean;
   recordAudio?: boolean;
   record_audio?: boolean;
   consentRequired?: boolean;
@@ -1027,6 +1107,17 @@ export interface CreateLabsAgentRequest {
   presetKey?: string;
   preset_key?: string;
   realtime?: LabsRealtimeSelection;
+  manager?: boolean | LabsManagerConfig;
+  agentTeam?: LabsAgentTeam;
+  agent_team?: LabsAgentTeam;
+  runtimeRouting?: LabsRuntimeRoutingConfig;
+  runtime_routing?: LabsRuntimeRoutingConfig;
+  captureFields?: string[];
+  capture_fields?: string[];
+  timezone?: string;
+  businessTimezone?: string;
+  timeAwareness?: boolean;
+  time_awareness?: boolean;
   runtimeMode?: LabsRuntimeMode;
   runtime_mode?: LabsRuntimeMode;
   /** Defaults to Supafone's hosted planner; model credentials remain server-side. */
@@ -1069,7 +1160,7 @@ export interface CreateLabsAgentRequest {
   customSip?: LabsCustomSipConfig;
   custom_sip?: LabsCustomSipConfig;
   sip?: LabsCustomSipConfig;
-  recording?: LabsRecordingConfig;
+  recording?: boolean | LabsRecordingConfig;
   transcription?: LabsTranscriptionConfig;
   artifacts?: LabsArtifactsConfig;
   compliance?: Record<string, unknown>;
@@ -3343,7 +3434,7 @@ class LabsBillingNamespace {
 class LabsAgentsNamespace {
   constructor(private sm: SupafoneLabs) {}
 
-  /** Spawn a durable hosted Supafone agent backed by Ultravox and Supafone-managed providers. */
+  /** Create a hosted Supafone agent with the default Ultravox runtime or a selected native S2S model. */
   create(input: CreateLabsAgentRequest): Promise<CreateLabsAgentResponse> {
     return this.sm.requestSupafoneApi<CreateLabsAgentResponse>(
       "POST",
@@ -4346,6 +4437,40 @@ function outboundCallModeRequiredCapabilities(payload: Record<string, unknown>):
   return required;
 }
 
+function managerPayload(input?: boolean | LabsManagerConfig): boolean | Record<string, unknown> | undefined {
+  if (typeof input !== "object" || input === null) return input;
+  return compact({
+    enabled: input.enabled, reasoning: input.reasoning, model: input.model,
+    max_tasks: input.max_tasks ?? input.maxTasks,
+    max_parallel: input.max_parallel ?? input.maxParallel,
+    timeout_seconds: input.timeout_seconds ?? input.timeoutSeconds,
+  });
+}
+
+function agentTeamPayload(input?: LabsAgentTeam): Record<string, unknown> | undefined {
+  if (!input) return undefined;
+  return compact({
+    enabled: input.enabled, routing_mode: input.routing_mode ?? input.routingMode,
+    fallback_member_id: input.fallback_member_id ?? input.fallbackMemberId,
+    routing_rules: input.routing_rules ?? input.routingRules,
+    members: input.members?.map((member) => compact({
+      id: member.id, role: member.role, label: member.label, description: member.description,
+      instructions: member.instructions, enabled: member.enabled, tools: member.tools,
+      stage_keys: member.stage_keys ?? member.stageKeys,
+    })),
+  });
+}
+
+function runtimeRoutingPayload(input?: LabsRuntimeRoutingConfig): Record<string, unknown> | undefined {
+  if (!input) return undefined;
+  return compact({
+    enabled: input.enabled, allowed_models: input.allowed_models ?? input.allowedModels,
+    max_handoffs: input.max_handoffs ?? input.maxHandoffs,
+    recover_on_disconnect: input.recover_on_disconnect ?? input.recoverOnDisconnect,
+    allowed_languages: input.allowed_languages ?? input.allowedLanguages,
+  });
+}
+
 function labsAgentMetadataPayload(input: CreateLabsAgentRequest): Record<string, unknown> | undefined {
   const metadata = { ...(input.metadata ?? {}) };
   const mode = input.outboundCallMode ?? input.outbound_call_mode;
@@ -4390,6 +4515,12 @@ function labsAgentPayload(input: CreateLabsAgentRequest): Record<string, unknown
     preset_key: input.preset_key ?? input.presetKey,
     runtime_mode: input.runtime_mode ?? input.runtimeMode,
     realtime: input.realtime,
+    manager: managerPayload(input.manager),
+    agent_team: agentTeamPayload(input.agent_team ?? input.agentTeam),
+    runtime_routing: runtimeRoutingPayload(input.runtime_routing ?? input.runtimeRouting),
+    capture_fields: input.capture_fields ?? input.captureFields,
+    timezone: input.timezone ?? input.businessTimezone,
+    time_awareness: input.time_awareness ?? input.timeAwareness,
     call_stages: callStagesPayload(input),
     stage_generation: input.stage_generation ?? input.stageGeneration,
     stage_count: input.stage_count ?? input.stageCount,
@@ -4410,7 +4541,7 @@ function labsAgentPayload(input: CreateLabsAgentRequest): Record<string, unknown
     byok: input.byok ? byokPayload(input.byok) : undefined,
     telephony: input.telephony ? telephonyPayload(input.telephony) : undefined,
     custom_sip: customSipPayload(input.custom_sip ?? input.customSip ?? input.sip),
-    recording: input.recording ? recordingPayload(input.recording) : undefined,
+    recording: input.recording !== undefined ? recordingPayload(input.recording) : undefined,
     transcription: input.transcription ? transcriptionPayload(input.transcription) : undefined,
     artifacts: input.artifacts ? artifactsPayload(input.artifacts) : undefined,
     compliance: input.compliance,
@@ -4558,8 +4689,6 @@ function callStagesPayload(
   if (explicit === false || auto === false) return false;
   if (explicit === "managed" || explicit === "template" || explicit === "off") return explicit;
   if (explicit === "oracle") return "managed";
-  // The S2S backend owns its validated intake → booking → confirmation flow.
-  if (input.realtime) return undefined;
   // Omitted means the private Supafone API generates and compiles the plan.
   return undefined;
 }
@@ -4579,8 +4708,7 @@ function stagePlanPayload(
     system_prompt: input.system_prompt ?? input.systemPrompt,
     tools: input.tools ? toolsPayload(input.tools) : undefined,
     call_stages: Array.isArray(input.call_stages ?? input.callStages ?? input.stages)
-      ? (input.call_stages ?? input.callStages ?? input.stages)
-      : undefined,
+      ? callStagesPayload(input) : undefined,
     stage_generation: input.stage_generation ?? input.stageGeneration,
     stage_count: input.stage_count ?? input.stageCount,
     stage_detail: input.stage_detail ?? input.stageDetail,
@@ -4597,6 +4725,12 @@ function callStagePayload(input: LabsCallStage): Record<string, unknown> {
     tools: input.tools,
     temperature: input.temperature,
     next_stages: input.next_stages ?? input.nextStages,
+    requirements: input.requirements ? compact({
+      required_fields: input.requirements.required_fields ?? input.requirements.requiredFields,
+      successful_tools: input.requirements.successful_tools ?? input.requirements.successfulTools,
+    }) : undefined,
+    role: input.role,
+    specialist_id: input.specialist_id ?? input.specialistId,
     metadata: input.metadata,
   });
 }
@@ -4757,6 +4891,8 @@ function providerKeysPayload(input: LabsProviderKeys): Record<string, unknown> {
     openai_api_key: input.openai_api_key ?? input.openaiApiKey,
     xai: input.xai,
     xai_api_key: input.xai_api_key ?? input.xaiApiKey,
+    smallest: input.smallest,
+    smallest_api_key: input.smallest_api_key ?? input.smallestApiKey,
   });
 }
 
@@ -4837,9 +4973,11 @@ function emailPayload(input: LabsEmailConfig): Record<string, unknown> {
   });
 }
 
-function recordingPayload(input: LabsRecordingConfig): Record<string, unknown> {
+function recordingPayload(input: LabsRecordingConfig | boolean): Record<string, unknown> | boolean {
+  if (typeof input === "boolean") return input;
   return compact({
     enabled: input.enabled,
+    transcribe: input.transcribe,
     record_audio: input.record_audio ?? input.recordAudio,
     consent_required: input.consent_required ?? input.consentRequired,
     announcement: input.announcement,

package/src/s2s.ts

@@ -0,0 +1,100 @@
+import type {
+  CreateLabsAgentRequest,
+  GetLabsAgentOptions,
+  LabsRealtimeSelection,
+  SupafoneLabs,
+} from "./index.js";
+
+export type S2SProviderName = "ultravox" | "openai" | "google" | "xai" | "smallest";
+export interface S2SModelOptions {
+  model?: string;
+  voice?: string;
+}
+export interface S2SOptions extends S2SModelOptions {
+  provider?: S2SProviderName;
+}
+
+/** Shared parent for Supafone-hosted S2S agents. Vendor keys stay on the server. */
+export class SupafoneS2S {
+  readonly provider: S2SProviderName;
+  private readonly selection: LabsRealtimeSelection | null;
+
+  constructor(protected readonly client: SupafoneLabs, options: S2SOptions = {}) {
+    const provider = options.provider ?? "ultravox";
+    if (!["ultravox", "openai", "google", "xai", "smallest"].includes(provider)) {
+      throw new Error("Unsupported Supafone S2S provider");
+    }
+    if (provider === "ultravox" && (options.model !== undefined || options.voice !== undefined)) {
+      throw new Error("Configure Ultravox voices through the agent's voice settings");
+    }
+    for (const field of ["model", "voice"] as const) {
+      const value = options[field];
+      if (value !== undefined && (typeof value !== "string" || !value.trim())) {
+        throw new Error(`${field} must be a non-empty string`);
+      }
+    }
+    this.provider = provider;
+    this.selection = provider === "ultravox" ? null : {
+      provider,
+      ...(options.model !== undefined ? { model: options.model.trim() } : {}),
+      ...(options.voice !== undefined ? { voice: options.voice.trim() } : {}),
+    };
+  }
+
+  /** A fresh wire selection; null explicitly restores the default Ultravox runtime. */
+  get realtime(): LabsRealtimeSelection | null {
+    return this.selection ? { ...this.selection } : null;
+  }
+
+  /** Create through the normal hosted agent factory with this provider. */
+  create(input: Omit<CreateLabsAgentRequest, "realtime">) {
+    if ("realtime" in input) {
+      throw new Error("Set provider/model/voice on the S2S adapter, not create({realtime: ...})");
+    }
+    return this.client.labs.agents.create({
+      ...input,
+      ...(this.realtime ? { realtime: this.realtime } : {}),
+    });
+  }
+
+  /** Change the saved selection for subsequent calls, preserving the agent and number. */
+  apply(agentKey: string, options: GetLabsAgentOptions = {}) {
+    this.checkAgentKey(agentKey);
+    return this.client.labs.agents.update(agentKey, { realtime: this.realtime }, options);
+  }
+
+  /** Preview the saved agent. Call apply first when switching providers. */
+  testCall(agentKey: string, options: GetLabsAgentOptions = {}) {
+    this.checkAgentKey(agentKey);
+    return this.client.labs.agents.testCall(agentKey, options);
+  }
+
+  private checkAgentKey(agentKey: string): void {
+    if (typeof agentKey !== "string" || !agentKey.trim()) throw new Error("agentKey is required");
+  }
+}
+
+export class UltravoxS2S extends SupafoneS2S {
+  constructor(client: SupafoneLabs) { super(client, { provider: "ultravox" }); }
+}
+export class OpenAIS2S extends SupafoneS2S {
+  constructor(client: SupafoneLabs, options: S2SModelOptions = {}) {
+    super(client, { ...options, provider: "openai" });
+  }
+}
+export class GeminiS2S extends SupafoneS2S {
+  constructor(client: SupafoneLabs, options: S2SModelOptions = {}) {
+    super(client, { ...options, provider: "google" });
+  }
+}
+export class GrokS2S extends SupafoneS2S {
+  constructor(client: SupafoneLabs, options: S2SModelOptions = {}) {
+    super(client, { ...options, provider: "xai" });
+  }
+}
+/** Smallest AI Hydra: full-duplex audio, without transcript events. */
+export class HydraS2S extends SupafoneS2S {
+  constructor(client: SupafoneLabs, options: S2SModelOptions = {}) {
+    super(client, { ...options, provider: "smallest" });
+  }
+}