supafone-labs 0.6.3 → 0.7.2

package/src/index.ts

@@ -224,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 {
@@ -692,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;
@@ -1044,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. */
@@ -1086,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>;
@@ -1308,12 +1382,25 @@ export interface LabsVoicePreview {
 export interface LabsRuntimeResponse {
   account_id: string;
   provider: "ultravox" | string;
-  managed: boolean;
-  byok_connected: boolean;
+  /** Optional for compatibility with earlier hosted API deployments. */
+  managed?: boolean;
+  byok_connected?: boolean;
+  configured?: boolean;
+  connected?: boolean;
+  source?: "account" | "platform" | "none" | "invalid";
   base_url?: string;
   updated_at?: string;
 }
 
+export interface LabsRuntimeConfig {
+  agencyId?: string;
+  agency_id?: string;
+  provider?: string;
+  /** Account-wide: managed removes this provider's saved key for future calls. */
+  mode?: "supafone_managed" | "byok";
+  credentials?: { apiKey?: string; api_key?: string; baseUrl?: string; base_url?: string };
+}
+
 export interface LabsCallListOptions {
   agencyId?: string;
   agency_id?: string;
@@ -3764,25 +3851,34 @@ class LabsVoicesNamespace {
 class LabsRuntimeNamespace {
   constructor(private sm: SupafoneLabs) {}
 
-  get(opts: { agencyId?: string; agency_id?: string } = {}): Promise<LabsRuntimeResponse> {
+  get(opts: { agencyId?: string; agency_id?: string; provider?: string } = {}): Promise<LabsRuntimeResponse> {
     const q = new URLSearchParams();
     const agencyId = opts.agency_id ?? opts.agencyId;
     if (agencyId) q.set("agency_id", agencyId);
+    if (opts.provider) q.set("provider", opts.provider);
     const suffix = q.toString() ? `?${q}` : "";
     return this.sm.requestSupafoneApi<LabsRuntimeResponse>("GET", `/api/v1/labs/runtime${suffix}`);
   }
 
-  configure(input: {
-    agencyId?: string;
-    agency_id?: string;
-    provider?: "ultravox" | string;
-    credentials?: { apiKey?: string; api_key?: string; baseUrl?: string; base_url?: string };
-  }): Promise<LabsRuntimeResponse> {
+  /** Set an account speaking key, or restore the selected provider's platform default. */
+  configure(input: LabsRuntimeConfig): Promise<LabsRuntimeResponse> {
+    if (input.mode !== undefined && !["supafone_managed", "byok"].includes(input.mode)) {
+      throw new Error("runtime mode must be supafone_managed or byok");
+    }
     const credentials = input.credentials ?? {};
+    if (typeof credentials !== "object" || Array.isArray(credentials)) {
+      throw new Error("runtime credentials must be an object");
+    }
+    if (input.mode === "supafone_managed" && Object.values(credentials).some(
+      value => typeof value === "string" ? Boolean(value.trim()) : Boolean(value),
+    )) {
+      throw new Error("managed runtime mode cannot include credentials");
+    }
     return this.sm.requestSupafoneApi<LabsRuntimeResponse>("PUT", "/api/v1/labs/runtime", compact({
       agency_id: input.agency_id ?? input.agencyId,
       provider: input.provider ?? "ultravox",
-      credentials: compact({
+      mode: input.mode,
+      credentials: input.mode === "supafone_managed" ? undefined : compact({
         api_key: credentials.api_key ?? credentials.apiKey,
         base_url: credentials.base_url ?? credentials.baseUrl,
       }),
@@ -4363,6 +4459,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;
@@ -4407,6 +4537,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,
@@ -4427,7 +4563,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,
@@ -4575,8 +4711,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;
 }
@@ -4596,8 +4730,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,
@@ -4614,6 +4747,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,
   });
 }
@@ -4856,9 +4995,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,