@amigo-ai/platform-sdk 0.92.0 → 0.94.0

package/dist/resources/voice.js

@@ -1,7 +1,12 @@
+// Voice MODEL FAMILIES (2026-07-09 rename): amigo = Amigo's own pipeline (the default),
+// gpt_realtime = OpenAI's GPT-Realtime family, gpt_live = OpenAI's GPT-Live full-duplex
+// family (dark until its API is GA — accepted by the contract, never selected by default).
+// Families name models; runtimes are platform-internal. Legacy values
+// (inhouse/atlas/openai_realtime) are normalized server-side and never appear here.
 const voiceSessionProviders = [
-    'inhouse',
-    'openai_realtime',
-    'atlas',
+    'amigo',
+    'gpt_realtime',
+    'gpt_live',
 ];
 export const VOICE_SESSION_PROVIDERS = voiceSessionProviders;
 const sttProviders = ['deepgram', 'openai', 'cartesia'];

package/dist/resources/voice.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/resources/voice.ts"],"names":[],"mappings":"AAoBA,MAAM,qBAAqB,GAAG;IAC5B,SAAS;IACT,iBAAiB;IACjB,OAAO;CAC2C,CAAA;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAGtC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAA2C,CAAA;AACjG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,YAG5B,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAA2C,CAAA;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG,YAG5B,CAAA"}
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/resources/voice.ts"],"names":[],"mappings":"AAoBA,wFAAwF;AACxF,wFAAwF;AACxF,2FAA2F;AAC3F,sEAAsE;AACtE,oFAAoF;AACpF,MAAM,qBAAqB,GAAG;IAC5B,OAAO;IACP,cAAc;IACd,UAAU;CACwC,CAAA;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAGtC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAA2C,CAAA;AACjG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,YAG5B,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAA2C,CAAA;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG,YAG5B,CAAA"}

package/dist/types/generated/api.d.ts

@@ -7716,7 +7716,6 @@ export interface components {
             channel_overrides?: {
                 [key: string]: components["schemas"]["ChannelOverride"];
             };
-            escalation_config?: components["schemas"]["StateRiskOverride"] | null;
             /**
              * Exit Condition Tool Call Specs
              * @default []
@@ -7770,7 +7769,6 @@ export interface components {
             channel_overrides?: {
                 [key: string]: components["schemas"]["ChannelOverride"];
             };
-            escalation_config?: components["schemas"]["StateRiskOverride"] | null;
             /**
              * Exit Condition Tool Call Specs
              * @default []
@@ -10988,6 +10986,32 @@ export interface components {
             /** Total */
             total: number;
         };
+        /** ConversationStatusTransitionRequest */
+        ConversationStatusTransitionRequest: {
+            /**
+             * Reason
+             * @description Low-cardinality transition tag (e.g. hsm_terminal, use_case_rebind) recorded on the audit event and the conversation world event.
+             */
+            reason: string;
+            /**
+             * Status
+             * @enum {string}
+             */
+            status: "completed" | "closed";
+        };
+        /** ConversationStatusTransitionResponse */
+        ConversationStatusTransitionResponse: {
+            /**
+             * Conversation Id
+             * Format: uuid
+             */
+            conversation_id: string;
+            /**
+             * Status
+             * @enum {string}
+             */
+            status: "completed" | "closed";
+        };
         /** ConversationThreadRequest */
         ConversationThreadRequest: {
             channel_kind: components["schemas"]["ChannelKind"];
@@ -11106,6 +11130,16 @@ export interface components {
              * @default []
              */
             tool_calls?: components["schemas"]["ConversationToolCallDetail"][];
+            /**
+             * Turn Id
+             * @description Stable identifier of the user exchange this message belongs to, derived deterministically from (conversation_id, turn_index) — identical across ``POST /turns`` responses and re-reads of the conversation history. User and agent messages from the same exchange share this value. Null on messages that precede the first user turn (proactive greetings, channel-event preludes).
+             */
+            turn_id?: string | null;
+            /**
+             * Turn Index
+             * @description Zero-based ordinal of the user exchange this message belongs to (0 = first user turn). Derived server-side from the conversation's user-turn count — never stored. Null exactly when ``turn_id`` is null.
+             */
+            turn_index?: number | null;
         };
         /** ConversationTurnAvailableAction */
         ConversationTurnAvailableAction: {
@@ -11310,6 +11344,12 @@ export interface components {
             channel?: components["schemas"]["ChannelKind"];
             /** Entity Id */
             entity_id?: string | null;
+            /**
+             * Force New
+             * @description Outbound thread-keyed channels (sms/imessage) only: close any existing ACTIVE conversation on the computed provider thread (recipient + use case) before dispatching, so the opener materializes a brand-new conversation instead of continuing the old thread. Rejected with 422 on channel=web — every web create already starts a new conversation, so force_new is meaningless there.
+             * @default false
+             */
+            force_new?: boolean;
             /** @description Optional context steering what the agent opens with on an outbound conversation. */
             instruction?: components["schemas"]["BackgroundString"] | null;
             /** @description Destination address for an outbound conversation (E.164 for sms/imessage). Required for non-web. */
@@ -11619,7 +11659,6 @@ export interface components {
              * @enum {string}
              */
             environment?: "sandbox" | "production";
-            escalation_policy?: components["schemas"]["EscalationPolicy"] | null;
             /**
              * Is Active
              * @default true
@@ -11628,11 +11667,6 @@ export interface components {
             /** Keyterms */
             keyterms?: string[];
             name: components["schemas"]["NameString"];
-            /**
-             * Safety Filters Enabled
-             * @default true
-             */
-            safety_filters_enabled?: boolean;
             /** Tags */
             tags?: components["schemas"]["ServiceTag"][];
             /**
@@ -14200,34 +14234,6 @@ export interface components {
              */
             workspace_id: string;
         };
-        /**
-         * EscalationPolicy
-         * @description Per-service routing for engine-detected escalation triggers.
-         *
-         *     Each trigger source maps to one EscalationAction. The three enumerated
-         *     fields below are the trigger_sources actually emitted by the agent-engine
-         *     today; new triggers can be added as fields without breaking back-compat.
-         *
-         *     Partial policies are intentional: every field defaults to OperatorAction,
-         *     so a PUT body like ``{"context_window_exhaustion": {"type": "forward"}}``
-         *     overrides only that trigger and leaves the others on the operator default.
-         *     To opt the entire service back to today's behavior, set
-         *     ``Service.escalation_policy = None`` (caveat: the platform-api Service
-         *     update path uses ``exclude_none=True`` and currently has no clears-via-null
-         *     branch, so this requires a direct config edit; see follow-up issue).
-         *
-         *     Resolution lookup is done against ``model_fields``: a trigger_source that
-         *     is not an enumerated field name falls through to OperatorAction, never
-         *     a non-Action Pydantic internal.
-         */
-        EscalationPolicy: {
-            /** Context Window Exhaustion */
-            context_window_exhaustion?: components["schemas"]["OperatorAction"] | components["schemas"]["ForwardAction"] | components["schemas"]["HangupAction"];
-            /** Conversation Monitor */
-            conversation_monitor?: components["schemas"]["OperatorAction"] | components["schemas"]["ForwardAction"] | components["schemas"]["HangupAction"];
-            /** Risk Scorer */
-            risk_scorer?: components["schemas"]["OperatorAction"] | components["schemas"]["ForwardAction"] | components["schemas"]["HangupAction"];
-        };
         /** EscalationState */
         EscalationState: {
             /** Agent Confidence */
@@ -15702,26 +15708,6 @@ export interface components {
             /** Templates */
             templates: components["schemas"]["FormTemplate-Input"][];
         };
-        /**
-         * ForwardAction
-         * @description Cold-transfer the caller to the service's configured forwarding
-         *     destination (set via ``Service.voice_config.forwarding``).
-         *
-         *     No agent-side decision and no operator dashboard required — the engine
-         *     invokes the same forwarding callback used by the LLM-driven
-         *     ``forward_call`` tool, with no location override, which falls through to
-         *     the per-service ``ServiceForwardingConfig``.
-         *
-         *     If ``voice_config.forwarding`` is unset, the dispatcher falls back to the
-         *     operator path (audit event + SSE only).
-         */
-        ForwardAction: {
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            type: "forward";
-        };
         /** ForwardCallResolvedEvent */
         ForwardCallResolvedEvent: {
             /**
@@ -15973,43 +15959,6 @@ export interface components {
             /** Detail */
             detail?: components["schemas"]["ValidationError"][];
         };
-        /**
-         * HangupAction
-         * @description End the call gracefully via the existing speaker-drain hangup path.
-         */
-        HangupAction: {
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            type: "hangup";
-        };
-        /**
-         * HardEscalationRule
-         * @description Non-negotiable escalation rule for healthcare compliance.
-         */
-        HardEscalationRule: {
-            /**
-             * Detection
-             * @enum {string}
-             */
-            detection: "intent" | "state" | "fhir";
-            /**
-             * Immediate
-             * @default false
-             */
-            immediate?: boolean;
-            /** Intent Patterns */
-            intent_patterns?: string[] | null;
-            /** Name */
-            name: string;
-            /** Operator Type */
-            operator_type: string;
-            /** Reason */
-            reason: string;
-            /** Regulatory Basis */
-            regulatory_basis: string;
-        };
         /**
          * HarnessContext
          * @description The neutral, retrievable session-bootstrap context for ANY framework.
@@ -18144,18 +18093,6 @@ export interface components {
                 [key: string]: unknown;
             };
         };
-        /**
-         * OperatorAction
-         * @description Today's behavior — write escalation.requested + publish SSE, wait for a
-         *     human operator to join via the dashboard. No-op if no operators are staffed.
-         */
-        OperatorAction: {
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            type: "operator";
-        };
         /**
          * OperatorIntelligenceSummary
          * @description Operator intervention summary.
@@ -20874,39 +20811,6 @@ export interface components {
              */
             item_id?: string | null;
         };
-        /**
-         * RiskSignalConfig
-         * @description Per-workspace risk scoring config. Stored on Service.
-         */
-        RiskSignalConfig: {
-            /**
-             * Alert Threshold
-             * @default 50
-             */
-            alert_threshold?: number;
-            /**
-             * Auto Escalate Threshold
-             * @default 70
-             */
-            auto_escalate_threshold?: number;
-            /**
-             * Enabled
-             * @default true
-             */
-            enabled?: boolean;
-            /**
-             * Monitor Threshold
-             * @default 30
-             */
-            monitor_threshold?: number;
-            /**
-             * Weights
-             * @default {}
-             */
-            weights?: {
-                [key: string]: number;
-            };
-        };
         /**
          * RiskSummary
          * @description Aggregated risk signals across the call.
@@ -21402,12 +21306,6 @@ export interface components {
              * @enum {string}
              */
             environment?: "sandbox" | "production";
-            escalation_policy?: components["schemas"]["EscalationPolicy"] | null;
-            /**
-             * Hard Escalation Rules
-             * @default []
-             */
-            hard_escalation_rules?: components["schemas"]["HardEscalationRule"][];
             /**
              * Id
              * Format: uuid
@@ -21419,12 +21317,6 @@ export interface components {
             keyterms: string[];
             /** Name */
             name: string;
-            risk_signal_config?: components["schemas"]["RiskSignalConfig"] | null;
-            /**
-             * Safety Filters Enabled
-             * @default true
-             */
-            safety_filters_enabled?: boolean;
             /** Tags */
             tags: components["schemas"]["ServiceTag"][];
             /**
@@ -21485,11 +21377,8 @@ export interface components {
          * ServiceForwardingConfig
          * @description Per-service call-forwarding destination + transfer mechanism.
          *
-         *     Read by:
-         *       - LLM-driven ``forward_call`` tool (tier 3 fallback when the LLM doesn't
-         *         pass an explicit ``phone_number`` and no EHR location is configured).
-         *       - ``EscalationPolicy.ForwardAction`` — engine-fired escalation with no
-         *         overrides falls through to the same path.
+         *     Read by the LLM-driven ``forward_call`` tool (tier 3 fallback when the LLM
+         *     doesn't pass an explicit ``phone_number`` and no EHR location is configured).
          *
          *     Per-service forwarding is a binary presence — set means tier 3 resolves
          *     to it, None means tier 3 has no static target. (The legacy per-phone
@@ -21544,7 +21433,6 @@ export interface components {
              * @enum {string}
              */
             environment?: "sandbox" | "production";
-            escalation_policy?: components["schemas"]["EscalationPolicy"] | null;
             /**
              * Id
              * Format: uuid
@@ -21561,11 +21449,6 @@ export interface components {
             keyterms: string[];
             /** Name */
             name: string;
-            /**
-             * Safety Filters Enabled
-             * @default true
-             */
-            safety_filters_enabled?: boolean;
             /** Tags */
             tags: components["schemas"]["ServiceTag"][];
             /** Tool Capacity */
@@ -21651,7 +21534,7 @@ export interface components {
             /** Progress Vocabulary */
             progress_vocabulary?: string[] | null;
             /** Session Provider */
-            session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
+            session_provider?: ("amigo" | "gpt_realtime" | "gpt_live") | null;
             /** Transition Deadline Ms */
             transition_deadline_ms?: number | null;
             /** Tts Config */
@@ -21721,7 +21604,7 @@ export interface components {
             /** Progress Vocabulary */
             progress_vocabulary?: string[] | null;
             /** Session Provider */
-            session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
+            session_provider?: ("amigo" | "gpt_realtime" | "gpt_live") | null;
             /** Transition Deadline Ms */
             transition_deadline_ms?: number | null;
             /** Tts Config */
@@ -23486,26 +23369,6 @@ export interface components {
              */
             session_status: "created" | "already_active";
         };
-        /**
-         * StateRiskOverride
-         * @description Per-state escalation tuning. Stored on ActionState.
-         */
-        StateRiskOverride: {
-            /** Auto Escalate Threshold */
-            auto_escalate_threshold?: number | null;
-            /**
-             * Max Loop Count
-             * @default 3
-             */
-            max_loop_count?: number;
-            /** Operator Skill */
-            operator_skill?: string | null;
-            /**
-             * Topic Risk Score
-             * @default 0
-             */
-            topic_risk_score?: number;
-        };
         /** StateTransition */
         StateTransition: {
             /** Annotation */
@@ -26018,7 +25881,7 @@ export interface components {
              * @default full
              * @enum {string}
              */
-            context_strategy?: "full" | "summarize" | "compact";
+            context_strategy?: "full" | "compact";
             /**
              * Degradation Threshold
              * @default -1
@@ -26107,8 +25970,11 @@ export interface components {
              * @default []
              */
             tool_calls?: components["schemas"]["ConversationToolCallDetail"][];
-            /** Turn Id */
-            turn_id: string;
+            /**
+             * Turn Id
+             * @description Identifier of the user exchange this turn created — or, for ``poll=true`` and greeting-kickoff turns (empty ``message``), the latest exchange the returned messages attach to. Deterministic: matches the ``turn_id`` on this conversation's history turns, so it can anchor durable per-turn artifacts (e.g. feedback) across page reloads. Null only when the conversation has no user exchange yet (a poll or kickoff before the first user message).
+             */
+            turn_id: string | null;
         };
         TurnStreamEvent: components["schemas"]["TurnTokenEvent"] | components["schemas"]["TurnToolCallStartedEvent"] | components["schemas"]["TurnToolCallCompletedEvent"] | components["schemas"]["TurnThinkingEvent"] | components["schemas"]["TurnMessageEvent"] | components["schemas"]["TurnDoneEvent"] | components["schemas"]["TurnErrorEvent"];
         /** TurnThinkingEvent */
@@ -26328,14 +26194,11 @@ export interface components {
             description?: components["schemas"]["DescriptionString"] | null;
             /** Environment */
             environment?: ("sandbox" | "production") | null;
-            escalation_policy?: components["schemas"]["EscalationPolicy"] | null;
             /** Is Active */
             is_active?: boolean | null;
             /** Keyterms */
             keyterms?: string[] | null;
             name?: components["schemas"]["NameString"] | null;
-            /** Safety Filters Enabled */
-            safety_filters_enabled?: boolean | null;
             /** Tags */
             tags?: components["schemas"]["ServiceTag"][] | null;
             /** Tool Capacity */
@@ -26867,7 +26730,7 @@ export interface components {
                 [key: string]: components["schemas"]["LanguageProviderEntry"];
             } | null;
             /** Session Provider */
-            session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
+            session_provider?: ("amigo" | "gpt_realtime" | "gpt_live") | null;
             /**
              * Similarity Boost
              * @default 0