@amigo-ai/platform-sdk 0.75.0 → 0.77.0

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

@@ -3229,6 +3229,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/{workspace_id}/intake/files/{file_id}/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Write Back Intake File Status
+         * @description Advance a file's status from the async CDC job (P4).
+         *
+         *     The job authenticates with the workspace's API key (Bearer) — the same
+         *     Databricks→platform-api path launch_dpc uses — so RLS scopes the update to
+         *     that workspace. Moves the row to its terminal verdict and records the
+         *     curated/cdc paths.
+         */
+        post: operations["write_back_intake_file_status_v1__workspace_id__intake_files__file_id__status_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/{workspace_id}/intake/links": {
         parameters: {
             query?: never;
@@ -6730,6 +6755,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/{workspace_id}/traces:export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Export gen_ai.* + voice.* traces as OTLP/JSON
+         * @description Export the workspace's durable trace spans over a time window as OpenTelemetry Protocol (OTLP/HTTP JSON) spans: ``gen_ai.*`` tool-call spans and the per-call voice-isolation ``voice.*`` infra spans (allocate / media-attach / reap). Read-only; admin/owner role required; dark behind ``OTEL_TRACE_EXPORT_ENABLED`` (404 when off). Paginated PULL API — extract ``.resourceSpans`` before forwarding to an OTLP collector. Attributes are an allowlist of tool-call + infra metadata; the raw tool-result ``error`` text is NOT exported (PHI-safe by construction).
+         */
+        post: operations["export_traces_v1__workspace_id__traces_export_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/{workspace_id}/triggers": {
         parameters: {
             query?: never;
@@ -7708,6 +7753,61 @@ export interface components {
             /** Workspace Id */
             workspace_id?: string | null;
         };
+        /**
+         * ActorAllocatedEvent
+         * @description The call was bound to its isolated runtime — one call = one Agones GameServer.
+         *
+         *     Emitted by the dispatcher the moment it allocates a warm GameServer for the call,
+         *     so an observer can see WHICH pod/node powers this call and how long allocation took.
+         */
+        ActorAllocatedEvent: {
+            /**
+             * Alloc Latency Ms
+             * @default null
+             */
+            alloc_latency_ms?: number | null;
+            /** Gameserver */
+            gameserver: string;
+            /**
+             * Node
+             * @default null
+             */
+            node?: string | null;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "actor_allocated";
+        };
+        /**
+         * ActorShutdownEvent
+         * @description The call's GameServer was reaped (Allocated GameServers are deploy-immune).
+         *
+         *     Today only ``reason=call_ended`` is produced (normal call-end teardown).
+         *     ``orphan_no_media`` is reserved in the contract for the orphan reaper — a pod that
+         *     went Allocated but never received media — but that emit is not yet wired: at reap
+         *     time the reaper pod has no call identity (allocation is cross-pod), so plumbing the
+         *     call_sid to it is a follow-up. The value is pre-declared so adding it later is a
+         *     non-breaking widening for SDK consumers, not a breaking enum change.
+         */
+        ActorShutdownEvent: {
+            /**
+             * Lifetime S
+             * @default null
+             */
+            lifetime_s?: number | null;
+            /**
+             * Reason
+             * @default call_ended
+             * @enum {string}
+             */
+            reason?: "call_ended" | "orphan_no_media";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "actor_shutdown";
+        };
         /** AddColumnAction */
         AddColumnAction: {
             column: components["schemas"]["Column-Input"];
@@ -7982,6 +8082,9 @@ export interface components {
              */
             workspace_id: string;
         };
+        AnyValue: {
+            [key: string]: unknown;
+        };
         /** ApiKeyResponse */
         ApiKeyResponse: {
             /**
@@ -11974,6 +12077,11 @@ export interface components {
             field_count: number;
             /** File Type */
             file_type: string;
+            /**
+             * Ingestion Mode
+             * @description `snapshot` (CSV/Excel → CDC) or `document` (PDF/docx → extraction).
+             */
+            ingestion_mode: string;
             limits: components["schemas"]["Limits"];
             /**
              * Name
@@ -12231,6 +12339,28 @@ export interface components {
              */
             verified: boolean;
         };
+        /**
+         * DocumentProcessingSpec
+         * @description Processing config for a document dataset (``ingestion_mode=document``).
+         *
+         *     Documents have no schema/primary-key/CDC; this is what the contract carries
+         *     instead (docs/plans/intake_file_processing_pipeline.md §5.9). Page-split /
+         *     output-metadata rules are stored in the same jsonb and may be added later
+         *     without a migration.
+         */
+        DocumentProcessingSpec: {
+            /**
+             * Extraction Mode
+             * @default text_extract
+             * @enum {string}
+             */
+            extraction_mode?: "text_extract" | "OCR" | "hybrid";
+            /**
+             * Retain Source
+             * @default true
+             */
+            retain_source?: boolean;
+        };
         /** DropColumnAction */
         DropColumnAction: {
             name: components["schemas"]["IdentifierString"];
@@ -15316,6 +15446,13 @@ export interface components {
              */
             status: "delivered" | "queued_no_subscriber";
         };
+        /** InstrumentationScope */
+        InstrumentationScope: {
+            /** Name */
+            name: string;
+            /** Version */
+            version: string;
+        };
         /**
          * IntakeFieldType
          * @description Allowed ``schema[].type`` values for a registered contract.
@@ -15886,6 +16023,15 @@ export interface components {
              */
             type: "latency_spike" | "silence" | "barge_in" | "loop" | "tool_failure" | "escalation" | "safety_flag" | "high_risk" | "elevated_risk";
         };
+        /**
+         * KeyValue
+         * @description OTLP ``KeyValue`` attribute pair.
+         */
+        KeyValue: {
+            /** Key */
+            key: string;
+            value: components["schemas"]["AnyValue"];
+        };
         /** LLMConfig */
         LLMConfig: {
             experience_controls?: components["schemas"]["LLMExperienceControls"] | null;
@@ -16211,6 +16357,29 @@ export interface components {
              */
             workspace_id: string;
         };
+        /**
+         * MediaAttachedEvent
+         * @description A media WebSocket actually reached the call's GameServer — the audio-path signal.
+         *
+         *     Fires once per leg (caller / agent). Its ABSENCE for a leg is the no-audio failure
+         *     mode (media never landed on the pod). The per-call cold-start / time-to-first-speech
+         *     metric is deliberately NOT carried here yet: TTFS is measured against the first
+         *     synthesized-audio frame, a signal not available at attach time, so it is wired in a
+         *     focused follow-up (Front 3) rather than shipped as a permanently-null field that would
+         *     lock a misleading shape into the SDK contract.
+         */
+        MediaAttachedEvent: {
+            /**
+             * Leg
+             * @enum {string}
+             */
+            leg: "caller" | "agent" | "operator";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "media_attached";
+        };
         /** MergedEntitiesResponse */
         MergedEntitiesResponse: {
             /**
@@ -17056,7 +17225,7 @@ export interface components {
              */
             type: "oauth2_jwt_bearer";
         };
-        ObserverSSEEvent: components["schemas"]["AgentTranscriptDeltaEvent"] | components["schemas"]["AgentTranscriptEvent"] | components["schemas"]["BargeInEvent"] | components["schemas"]["CompoundEmotionEvent"] | components["schemas"]["EmotionEvent"] | components["schemas"]["EmpathyClassifiedEvent"] | components["schemas"]["ForwardCallResolvedEvent"] | components["schemas"]["LatencyEvent"] | components["schemas"]["NavTimingEvent"] | components["schemas"]["ParticipantJoinedEvent"] | components["schemas"]["ParticipantLeftEvent"] | components["schemas"]["SessionEndEvent"] | components["schemas"]["SessionInfoEvent"] | components["schemas"]["SessionStartEvent"] | components["schemas"]["SpeakerMutedEvent"] | components["schemas"]["StateTransitionEvent"] | components["schemas"]["ToolCallCompletedEvent"] | components["schemas"]["ToolCallStartedEvent"] | components["schemas"]["UserTranscriptEvent"] | components["schemas"]["VoiceContextAppliedEvent"];
+        ObserverSSEEvent: components["schemas"]["ActorAllocatedEvent"] | components["schemas"]["ActorShutdownEvent"] | components["schemas"]["AgentTranscriptDeltaEvent"] | components["schemas"]["AgentTranscriptEvent"] | components["schemas"]["BargeInEvent"] | components["schemas"]["CompoundEmotionEvent"] | components["schemas"]["EmotionEvent"] | components["schemas"]["EmpathyClassifiedEvent"] | components["schemas"]["ForwardCallResolvedEvent"] | components["schemas"]["LatencyEvent"] | components["schemas"]["MediaAttachedEvent"] | components["schemas"]["NavTimingEvent"] | components["schemas"]["ParticipantJoinedEvent"] | components["schemas"]["ParticipantLeftEvent"] | components["schemas"]["SessionEndEvent"] | components["schemas"]["SessionInfoEvent"] | components["schemas"]["SessionStartEvent"] | components["schemas"]["SpeakerMutedEvent"] | components["schemas"]["StateTransitionEvent"] | components["schemas"]["ToolCallCompletedEvent"] | components["schemas"]["ToolCallStartedEvent"] | components["schemas"]["UserTranscriptEvent"] | components["schemas"]["VoiceContextAppliedEvent"];
         /** OcrRequest */
         OcrRequest: {
             /**
@@ -18898,7 +19067,7 @@ export interface components {
          *     Multiple providers may serve the same ChannelKind.
          * @enum {string}
          */
-        ProviderType: "twilio" | "websocket" | "ses" | "sendblue";
+        ProviderType: "twilio" | "websocket" | "ses" | "sendblue" | "infobip";
         /** ProvisionResponse */
         ProvisionResponse: {
             workspace: components["schemas"]["WorkspaceResponse"];
@@ -19203,28 +19372,34 @@ export interface components {
         };
         /**
          * RegisterSchemaRequest
-         * @description Create Schema payload (intake-ui-mvp-design.md §5.4).
+         * @description Create Schema payload (intake-ui-mvp-design.md §5.4, §5.9).
          *
-         *     The backend applies the hidden defaults (``ingestion_mode=snapshot``,
-         *     ``on_schema_change=additive``, ``schema_version`` auto) — they are not part
-         *     of the wire contract.
+         *     ``ingestion_mode`` is inferred from ``file_type`` (csv/xls/xlsx → snapshot;
+         *     else document) — not part of the wire contract. Snapshot datasets require
+         *     ``primary_key`` + ``schema``; document datasets take an optional
+         *     ``document_processing`` config and ignore primary_key/schema. The backend
+         *     applies the other hidden defaults (``on_schema_change=additive``,
+         *     ``schema_version`` auto).
          */
         RegisterSchemaRequest: {
-            /**
-             * File Type
-             * @constant
-             */
-            file_type: "csv";
+            /** @description Document only — extraction config; defaulted server-side when omitted. */
+            document_processing?: components["schemas"]["DocumentProcessingSpec"] | null;
+            file_type: components["schemas"]["_FileType"];
             /** Max Size Mb */
             max_size_mb?: number | null;
             name: components["schemas"]["_DatasetSlug"];
-            /** Primary Key */
-            primary_key: components["schemas"]["_FieldName"][];
+            /**
+             * Primary Key
+             * @description Snapshot only — the canonical PK column(s). Empty/ignored for documents.
+             * @default []
+             */
+            primary_key?: components["schemas"]["_FieldName"][];
             /**
              * Schema
-             * @description Canonical field list ``[{name, type}]`` (wire key ``schema``).
+             * @description Snapshot only — canonical field list ``[{name, type}]`` (wire key ``schema``).
+             * @default []
              */
-            schema: components["schemas"]["SchemaFieldSpec"][];
+            schema?: components["schemas"]["SchemaFieldSpec"][];
         };
         /**
          * RegisteredFunction
@@ -19429,6 +19604,17 @@ export interface components {
             /** Tool Type */
             tool_type: string;
         };
+        /** Resource */
+        Resource: {
+            /** Attributes */
+            attributes: components["schemas"]["KeyValue"][];
+        };
+        /** ResourceSpans */
+        ResourceSpans: {
+            resource: components["schemas"]["Resource"];
+            /** Scopespans */
+            scopeSpans: components["schemas"]["ScopeSpans"][];
+        };
         /**
          * RestIntegrationResponse
          * @description REST variant — base URL, auth config, endpoint count.
@@ -20049,6 +20235,12 @@ export interface components {
                 [key: string]: string;
             }[];
         };
+        /** ScopeSpans */
+        ScopeSpans: {
+            scope: components["schemas"]["InstrumentationScope"];
+            /** Spans */
+            spans: components["schemas"]["Span"][];
+        };
         /** ScoreSessionRequest */
         ScoreSessionRequest: {
             /** Score */
@@ -20358,7 +20550,7 @@ export interface components {
             /** Progress Vocabulary */
             progress_vocabulary?: string[] | null;
             /** Session Provider */
-            session_provider?: ("inhouse" | "openai_realtime") | null;
+            session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
             /** Transition Deadline Ms */
             transition_deadline_ms?: number | null;
             /** Tts Config */
@@ -20428,7 +20620,7 @@ export interface components {
             /** Progress Vocabulary */
             progress_vocabulary?: string[] | null;
             /** Session Provider */
-            session_provider?: ("inhouse" | "openai_realtime") | null;
+            session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
             /** Transition Deadline Ms */
             transition_deadline_ms?: number | null;
             /** Tts Config */
@@ -21913,6 +22105,27 @@ export interface components {
              */
             workspace_id: string;
         };
+        /**
+         * Span
+         * @description OTLP ``Span`` in OTLP/JSON encoding (ids hex, timestamps decimal-string).
+         */
+        Span: {
+            /** Attributes */
+            attributes: components["schemas"]["KeyValue"][];
+            /** Endtimeunixnano */
+            endTimeUnixNano: string;
+            /** Kind */
+            kind: number;
+            /** Name */
+            name: string;
+            /** Spanid */
+            spanId: string;
+            /** Starttimeunixnano */
+            startTimeUnixNano: string;
+            status: components["schemas"]["Status"];
+            /** Traceid */
+            traceId: string;
+        };
         /** SpeakerAcoustics */
         SpeakerAcoustics: {
             /**
@@ -22136,6 +22349,29 @@ export interface components {
             /** Name */
             name: string;
         };
+        /**
+         * Status
+         * @description OTLP ``Status`` — 0=UNSET, 1=OK, 2=ERROR.
+         */
+        Status: {
+            /** Code */
+            code: number;
+        };
+        /**
+         * StatusWriteBackRequest
+         * @description Status advance written by the async CDC job (P4).
+         *
+         *     The job posts the terminal verdict after conform/validate/diff. ``error_reason``
+         *     must be PHI-safe (the engine reports column + type + counts only — never cell
+         *     values). ``curated_path``/``cdc_path`` are set only on a clean verdict.
+         */
+        StatusWriteBackRequest: {
+            cdc_path?: components["schemas"]["_VolumePath"] | null;
+            curated_path?: components["schemas"]["_VolumePath"] | null;
+            /** Error Reason */
+            error_reason?: string | null;
+            status: components["schemas"]["_FileStatus"];
+        };
         /** StepRequest */
         StepRequest: {
             /** Caller Text */
@@ -23097,6 +23333,8 @@ export interface components {
          * @description Request body for ``POST /v1/{ws}/services/{service_id}/text-turn``.
          */
         TextTurnRequest: {
+            /** Agent Phone */
+            agent_phone: string;
             /** Phone Number */
             phone_number: string;
             /** Text */
@@ -23826,6 +24064,52 @@ export interface components {
              */
             what_happened: string;
         };
+        /** TracesExportRequest */
+        TracesExportRequest: {
+            /**
+             * Continuation Token
+             * @description Opaque page cursor — round-trip the value from the previous response.
+             */
+            continuation_token?: unknown;
+            /**
+             * End Time
+             * Format: date-time
+             * @description Exclusive upper bound on span ``effective_at`` (ISO-8601).
+             */
+            end_time: string;
+            /**
+             * Limit
+             * @description Max spans per page (1-1000).
+             * @default 500
+             */
+            limit?: number;
+            /**
+             * Start Time
+             * Format: date-time
+             * @description Inclusive lower bound on span ``effective_at`` (ISO-8601).
+             */
+            start_time: string;
+        };
+        /**
+         * TracesExportResponse
+         * @description Paginated PULL response — NOT a bare OTLP ``ExportTraceServiceRequest``.
+         *
+         *     ``resourceSpans`` is OTLP/JSON-conformant; to forward to an OTLP collector,
+         *     extract ``.resourceSpans`` and re-wrap as ``{"resourceSpans": [...]}`` (a
+         *     strict protojson push receiver rejects the ``has_more``/``continuation_token``
+         *     siblings). Round-trip ``continuation_token`` to page.
+         */
+        TracesExportResponse: {
+            /** Continuation Token */
+            continuation_token?: unknown;
+            /** Has More */
+            has_more: boolean;
+            /**
+             * Resourcespans
+             * @description OTLP/JSON ``ResourceSpans`` envelope (empty list when no spans match).
+             */
+            resourceSpans: components["schemas"]["ResourceSpans"][];
+        };
         /** TranscriptSegment */
         TranscriptSegment: {
             /** Confidence */
@@ -25054,7 +25338,7 @@ export interface components {
                 [key: string]: components["schemas"]["LanguageProviderEntry"];
             } | null;
             /** Session Provider */
-            session_provider?: ("inhouse" | "openai_realtime") | null;
+            session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
             /**
              * Similarity Boost
              * @default 0
@@ -25653,10 +25937,12 @@ export interface components {
         _FieldName: string;
         /** @enum {string} */
         _FileStatus: "received" | "scanned" | "processing" | "curated" | "rejected" | "failed" | "held";
+        _FileType: string;
         /** @enum {string} */
         _ResourceType: "integration_endpoint" | "skill" | "kb_scope";
         _ToolMockKey: string;
         _ToolMockValue: string;
+        _VolumePath: string;
         /**
          * Parameter
          * @description Typed declaration of one input parameter.
@@ -35158,6 +35444,42 @@ export interface operations {
             };
         };
     };
+    write_back_intake_file_status_v1__workspace_id__intake_files__file_id__status_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                file_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StatusWriteBackRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IntakeFileRow"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     "list-intake-links": {
         parameters: {
             query?: {
@@ -43502,6 +43824,41 @@ export interface operations {
             };
         };
     };
+    export_traces_v1__workspace_id__traces_export_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TracesExportRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TracesExportResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     "list-triggers": {
         parameters: {
             query?: {