@pyai/sdk 0.4.0 → 0.6.0

package/src/index.ts

@@ -165,8 +165,15 @@ function assertActiveSpeechParams(params: SpeechParams): void {
   }
 }
 
-export interface CreateJobParams {
-  audio_url: string;
+export type CreateJobParams = CreateJobOptions & (
+  | { audio_url: string; gpt_live?: never }
+  | { gpt_live: { session_id: string }; audio_url?: never }
+);
+
+export interface CreateJobOptions {
+  /** Requires Trace entitlement; incompatible with channel/diarize. */
+  trace?: boolean;
+  rule_pack?: Record<string, unknown>;
   model?: string;
   diarize?: boolean;
   channel?: boolean;
@@ -731,6 +738,8 @@ export const OmniEvent = {
   Hello: "hello",
   /** Ack for your `configure` frame (echoes the resolved `voice_id`). */
   Configured: "configured",
+  /** Served voice capabilities changed, for example after synthesis fallback. */
+  VoiceCapabilities: "voice_capabilities",
   /** Session is live; includes the resolved agent + audio caps. */
   SessionStarted: "session_started",
   /** Turn boundary (user/assistant speaking). */
@@ -1066,6 +1075,17 @@ export class OmniConnection {
         try {
           const parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes.subarray(1))) as OmniServerFrame;
           if (parsed?.event === OmniEvent.Transcript) {
+            // The deployed engine also sends this bounded synthesis-input
+            // advisory. It is not caller ASR or proof that speech was played.
+            const keys = Object.keys(parsed);
+            const text = omniTranscriptText(parsed.text);
+            if (parsed.role === "assistant" && parsed.final === true && text?.trim()
+              && keys.length === 4
+              && keys.every((key) => ["event", "role", "text", "final"].includes(key))) {
+              this.opts.onEvent?.(parsed);
+              this.opts.onTranscript?.({ event: "transcript", role: "assistant", text, final: true, mode: "replace" });
+              return;
+            }
             this.opts.onError?.(new Error("Omni transcript events must use a binary 0x02 frame"));
             return;
           }
@@ -1593,16 +1613,21 @@ export interface AmdCall extends AmdCallSummary {
 
 /**
  * A mid-call AMD decision event pushed on the stream (and to the per-call
- * TwiML `webhook`). Carries the coarse routing class; the machine subtype
- * (`voicemail`/`ivr`/`screening`/`music`) is on the stored call record
- * (`AmdCall`) and the `amd.call.completed` webhook instead.
+ * TwiML `webhook`). Carries the routing class and an optional machine subtype.
+ * Stored `AmdCall` records fold the subtype into `answered_by`.
  */
 export interface AmdDecisionEvent {
   event?: "amd";
   call_id?: string;
   answered_by?: AmdWireAnsweredBy;
   answered_by_twilio?: string | null;
+  subtype?: string;
+  /** A human or automated answering party was identified. */
+  party_detected?: boolean;
+  /** Classification events return false; detection does not establish recording readiness. */
+  voicemail_ready?: boolean;
   confidence?: number | null;
+  /** Processed inbound audio through the decision, not time since carrier answer. */
   decision_ms?: number | null;
   reason?: string | null;
   [k: string]: unknown;