supafone-labs 0.6.1 → 0.6.3

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.
  *
@@ -385,7 +388,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;
 }
@@ -402,10 +405,21 @@ export interface LabsBrowserTestSession {
     provider: string;
     transport: "ultravox" | "supafone_realtime";
     join_url?: string | null;
-    websocket_url?: string;
-    token?: string;
+    websocket_url?: string | null;
+    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 +497,9 @@ export interface LabsProviderKeys {
   xai?: string;
   xaiApiKey?: string;
   xai_api_key?: string;
+  smallest?: string;
+  smallestApiKey?: string;
+  smallest_api_key?: string;
   [extra: string]: unknown;
 }
 
@@ -1123,7 +1140,10 @@ export interface LabsAgentReadiness {
   [extra: string]: unknown;
 }
 
-export type UpdateLabsAgentRequest = Partial<CreateLabsAgentRequest>;
+export type UpdateLabsAgentRequest = Omit<Partial<CreateLabsAgentRequest>, "realtime"> & {
+  /** Select another native model, or null to return to the default Ultravox runtime. */
+  realtime?: LabsRealtimeSelection | null;
+};
 
 export interface LabsAgentLifecycleResponse {
   success?: boolean;
@@ -3340,7 +3360,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",
@@ -4351,7 +4371,9 @@ function labsAgentMetadataPayload(input: CreateLabsAgentRequest): Record<string,
 }
 
 function labsAgentUpdatePayload(input: UpdateLabsAgentRequest): Record<string, unknown> {
-  return labsAgentPayload(input as CreateLabsAgentRequest);
+  const payload = labsAgentPayload(input as CreateLabsAgentRequest);
+  if (input.realtime === null) payload.realtime = null;
+  return payload;
 }
 
 function campaignSettingsPayload(
@@ -4752,6 +4774,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,
   });
 }
 

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" });
+  }
+}