@amigo-ai/platform-sdk 0.47.1 → 0.48.0

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

@@ -2476,70 +2476,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/{workspace_id}/demo-pulse/start": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Start synthetic event emission for an internal demo workspace
-         * @description Start a synthetic pulse on the workspace.
-         *
-         *     Guardrails: admin/owner role + workspace must be in the allowlist env.
-         *     Replaces any currently-running pulse on the same workspace.
-         */
-        post: operations["start-demo-pulse"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/{workspace_id}/demo-pulse/status": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** Inspect the active pulse on a workspace */
-        get: operations["get-demo-pulse-status"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/{workspace_id}/demo-pulse/stop": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Stop the synthetic pulse on a workspace
-         * @description Stop the pulse on this workspace.
-         *
-         *     ``body.task_id`` is optional; if provided, only that task is stopped (useful
-         *     for idempotence after a background race). Otherwise the workspace's
-         *     current task (if any) is stopped.
-         */
-        post: operations["stop-demo-pulse"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/v1/{workspace_id}/desktop-sessions": {
         parameters: {
             query?: never;
@@ -7986,7 +7922,7 @@ export interface paths {
         post?: never;
         /**
          * Delete a channel use case
-         * @description Delete a use case. Refuses (409) while any workspace has the use case bound — call DELETE `/use-cases/{id}/bindings` first. Also refuses if a Twilio use case still has phone-number assignments. Requires Channel.delete permission.
+         * @description Delete a use case. Refuses (409) while any service still binds the use case — call DELETE `/use-cases/{id}/service-binding` first. Also refuses if a Twilio use case still has phone-number assignments. Requires Channel.delete permission.
          */
         delete: operations["delete-use-case"];
         options?: never;
@@ -7994,25 +7930,29 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/{workspace_id}/use-cases/{use_case_id}/bindings": {
+    "/v1/{workspace_id}/use-cases/{use_case_id}/service-binding": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Bind a use case to this workspace
-         * @description Claim a use case for this workspace. Inbound webhook events for the use case will resolve to this workspace. Idempotent for the same workspace; 409 if another workspace owns the binding; revives a soft-deleted binding (after a prior unbind) and re-points it at this workspace. Requires Channel.create permission.
+         * Get the service binding for a use case
+         * @description Return the platform service this use case is bound to in this workspace, or 404 if unbound. Requires Channel.view permission.
          */
-        post: operations["bind-use-case"];
+        get: operations["get-use-case-service-binding"];
         /**
-         * Unbind a use case from this workspace
-         * @description Release a use case from this workspace. Soft-delete on the binding row. 404 if the use case is not currently bound to this workspace (covers both 'never bound' and 'already unbound'). Requires Channel.delete permission.
+         * Bind a use case to a platform service
+         * @description Bind this use case to a platform service in the current workspace. PUT semantics — rebinding to a different service replaces the prior binding. Inbound webhook events for the use case will resolve to this workspace; outbound dispatch from the service will route through this use case for its channel. 409 if a different use case already binds the same (service, channel) pair. 404 if the service or use case is missing or belongs to another workspace. Requires Channel.create permission.
          */
-        delete: operations["unbind-use-case"];
+        put: operations["bind-use-case-to-service"];
+        post?: never;
+        /**
+         * Unbind a use case from its platform service
+         * @description Release a use case from its bound service in this workspace. Soft-delete on the binding row. 404 if the use case is not currently bound (covers both 'never bound' and 'already unbound'). Requires Channel.delete permission.
+         */
+        delete: operations["unbind-use-case-from-service"];
         options?: never;
         head?: never;
         patch?: never;
@@ -8077,15 +8017,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Verify Voiceprint
-         * @description Verify a speaker against their enrolled voiceprint.
-         *
-         *     Loads the enrolled embedding from world events, sends audio + embedding
-         *     to emotion-engine for cosine similarity comparison.
-         *
-         *     Permissions: authenticated (any role).
-         */
+        /** Verify Voiceprint */
         post: operations["verify-voiceprint"];
         delete?: never;
         options?: never;
@@ -8100,17 +8032,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Get Voiceprint Status
-         * @description Check voiceprint enrollment status for any entity.
-         *
-         *     Queries world.entities for voiceprint enrollment status.
-         *     This works for both world entities (patients/practitioners) and identity
-         *     entities (developer console users) — the entity state projection is the
-         *     read surface (world.events table has been dropped).
-         *
-         *     Permissions: authenticated (any role).
-         */
+        /** Get Voiceprint Status */
         get: operations["get-voiceprint-status"];
         put?: never;
         post?: never;
@@ -10051,18 +9973,6 @@ export interface components {
              */
             setup_id: string;
         };
-        /** BindingResponse */
-        BindingResponse: {
-            /**
-             * Channel
-             * @enum {string}
-             */
-            channel: "voice" | "voicemail" | "email";
-            /** Use Case Id */
-            use_case_id: string;
-            /** Workspace Id */
-            workspace_id: string;
-        };
         /** Body_enroll-voiceprint */
         "Body_enroll-voiceprint": {
             /** Audio */
@@ -12207,6 +12117,11 @@ export interface components {
         ConversationToolCallDetail: {
             /** Call Id */
             call_id: string;
+            /**
+             * Duration Ms
+             * @description Wall-clock tool execution time in milliseconds, measured at the engage_step call site. Omitted (null) on legacy turns that did not capture timing.
+             */
+            duration_ms?: number | null;
             /** Input */
             input?: {
                 [key: string]: unknown;
@@ -12541,7 +12456,7 @@ export interface components {
              * Source Type
              * @enum {string}
              */
-            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir";
+            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir" | "customer_intake";
             /** Sync Schedule */
             sync_schedule?: string | null;
             /**
@@ -14014,7 +13929,7 @@ export interface components {
              * Source Type
              * @enum {string}
              */
-            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir";
+            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir" | "customer_intake";
             /** Sync Schedule */
             sync_schedule: string | null;
             /**
@@ -14305,66 +14220,6 @@ export interface components {
             /** Event Type */
             event_type: string;
         };
-        /** DemoPulseStartRequest */
-        DemoPulseStartRequest: {
-            /**
-             * Duration Seconds
-             * @description How long to emit events before auto-terminating (max 3600).
-             * @default 600
-             */
-            duration_seconds?: number;
-            /**
-             * Events Per Minute
-             * @description Emission rate per minute, 1 to 120.
-             * @default 30
-             */
-            events_per_minute?: number;
-        };
-        /** DemoPulseStatusResponse */
-        DemoPulseStatusResponse: {
-            /** Tasks */
-            tasks: components["schemas"]["DemoPulseTaskResponse"][];
-        };
-        /** DemoPulseStopRequest */
-        DemoPulseStopRequest: {
-            /**
-             * Task Id
-             * @description Optional task_id to stop. When set, only a matching active task is stopped — useful for idempotent retries after a background race. Omit to stop whatever pulse is currently active on the workspace.
-             */
-            task_id?: string | null;
-        };
-        /** DemoPulseStopResponse */
-        DemoPulseStopResponse: {
-            /** Stopped */
-            stopped: boolean;
-            task?: components["schemas"]["DemoPulseTaskResponse"] | null;
-        };
-        /** DemoPulseTaskResponse */
-        DemoPulseTaskResponse: {
-            /** Active */
-            active: boolean;
-            /** Events Attempted */
-            events_attempted: number;
-            /** Events Per Minute */
-            events_per_minute: number;
-            /**
-             * Expires At
-             * Format: date-time
-             */
-            expires_at: string;
-            /**
-             * Started At
-             * Format: date-time
-             */
-            started_at: string;
-            /** Task Id */
-            task_id: string;
-            /**
-             * Workspace Id
-             * Format: uuid
-             */
-            workspace_id: string;
-        };
         DescriptionString: string;
         /** DestroySessionResponse */
         DestroySessionResponse: {
@@ -16251,6 +16106,12 @@ export interface components {
             };
             /** Data Source Id */
             data_source_id?: string | null;
+            /**
+             * Dedup
+             * @description When true, identical re-uploads of the same FHIR resource are skipped via content-hash dedup. Set to false to force emission regardless of content changes.
+             * @default true
+             */
+            dedup?: boolean;
             /**
              * Source
              * @default fhir_import
@@ -20401,13 +20262,18 @@ export interface components {
         };
         /**
          * Parameter
-         * @description Typed declaration of one SQL bind parameter.
+         * @description Typed declaration of one input parameter.
+         *
+         *     For SQL function types, ``name`` becomes the ``:name`` placeholder
+         *     in the SQL template. For Python function types, ``name`` becomes
+         *     the positional argument name in ``def main(...)`` and the input
+         *     column name on the UC UDF signature.
          *
-         *     The ``name`` becomes the ``:name`` placeholder in the SQL template.
-         *     The ``description`` propagates into the LLM tool spec (this is what
-         *     Databricks' Agent Framework reads, and what Anthropic's tool-use
-         *     spec exposes to the model). Missing descriptions silently break
-         *     tool selection — the registration layer rejects empty strings.
+         *     The ``description`` propagates into the LLM tool spec (this is
+         *     what Databricks' Agent Framework reads, and what Anthropic's
+         *     tool-use spec exposes to the model). Missing descriptions
+         *     silently break tool selection — the registration layer rejects
+         *     empty strings.
          */
         Parameter: {
             /** Default */
@@ -21994,9 +21860,14 @@ export interface components {
          *     repo or POSTed to ``/v1/{ws}/functions/deploy``. The deploy
          *     pipeline validates this, derives the JSON Schema for the LLM tool
          *     spec, and INSERTs a row into ``platform.functions`` with the next
-         *     monotonic ``version`` per ``(workspace_id, name)``.
+         *     monotonic ``version`` per ``(workspace_id, name)``. For
+         *     ``python`` / ``udtf`` rows, deploy ALSO issues
+         *     ``CREATE OR REPLACE FUNCTION`` against the warehouse to materialize
+         *     the UC UDF.
          */
         RegisteredFunction: {
+            /** Body */
+            body: string;
             /** Description */
             description: string;
             /** Examples */
@@ -22017,8 +21888,14 @@ export interface components {
              * @enum {string}
              */
             returns?: "table" | "scalar";
-            /** Sql */
-            sql: string;
+            /** Returns Columns */
+            returns_columns?: components["schemas"]["ReturnColumn"][];
+            /**
+             * Returns Type
+             * @default string
+             * @enum {string}
+             */
+            returns_type?: "string" | "integer" | "number" | "boolean";
             /**
              * Timeout Ms
              * @default 30000
@@ -22193,6 +22070,30 @@ export interface components {
              */
             retry_on_status?: number[];
         };
+        /**
+         * ReturnColumn
+         * @description One column in a UDTF's output schema.
+         *
+         *     UC ``RETURNS TABLE(<col1> <type1>, <col2> <type2>, ...)`` requires
+         *     declaring the schema at deploy time. This list anchors that
+         *     schema for ``function_type=udtf`` rows. ``name`` becomes the
+         *     column name in the result rows; ``type`` maps to a Databricks
+         *     SQL type via the same ``ParameterType`` Literal we use for inputs.
+         */
+        ReturnColumn: {
+            /**
+             * Description
+             * @default
+             */
+            description?: string;
+            /** Name */
+            name: string;
+            /**
+             * Type
+             * @enum {string}
+             */
+            type: "string" | "integer" | "number" | "boolean";
+        };
         /** ReviewActionResponse */
         ReviewActionResponse: {
             /**
@@ -23161,6 +23062,47 @@ export interface components {
             };
             voice_config?: components["schemas"]["ServiceVoiceConfig"] | null;
         };
+        /** ServiceBindingRequest */
+        ServiceBindingRequest: {
+            /**
+             * Service Id
+             * Format: uuid
+             */
+            service_id: string;
+        };
+        /** ServiceBindingResponse */
+        ServiceBindingResponse: {
+            /**
+             * Channel
+             * @enum {string}
+             */
+            channel: "inbound_voice" | "outbound_voice" | "ringless_voicemail" | "email";
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /**
+             * Service Id
+             * Format: uuid
+             */
+            service_id: string;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+            /**
+             * Use Case Id
+             * Format: uuid
+             */
+            use_case_id: string;
+            /**
+             * Workspace Id
+             * Format: uuid
+             */
+            workspace_id: string;
+        };
         /** ServiceResponse */
         ServiceResponse: {
             /**
@@ -24415,7 +24357,7 @@ export interface components {
              * Source Type
              * @enum {string}
              */
-            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir";
+            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir" | "customer_intake";
         };
         /** SourceOverviewResponse */
         SourceOverviewResponse: {
@@ -24475,7 +24417,7 @@ export interface components {
              * Source Type
              * @enum {string}
              */
-            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir";
+            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir" | "customer_intake";
         };
         /** SourceStatus */
         SourceStatus: {
@@ -24514,7 +24456,7 @@ export interface components {
              * Source Type
              * @enum {string}
              */
-            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir";
+            source_type: "rest_api" | "webhook" | "file_drop" | "fhir" | "fhir_store" | "ehr" | "crm" | "database" | "custom" | "smart_fhir" | "customer_intake";
             /** Status */
             status: string;
             /**
@@ -27227,6 +27169,12 @@ export interface components {
         TurnToolCallCompletedEvent: {
             /** Call Id */
             call_id: string;
+            /**
+             * Duration Ms
+             * @description Wall-clock tool execution time in milliseconds, measured at the engage_step call site. Null when the upstream did not report timing (legacy/test paths).
+             * @default null
+             */
+            duration_ms?: number | null;
             /**
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
@@ -35505,98 +35453,6 @@ export interface operations {
             };
         };
     };
-    "start-demo-pulse": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspace_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["DemoPulseStartRequest"];
-            };
-        };
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["DemoPulseTaskResponse"];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["HTTPValidationError"];
-                };
-            };
-        };
-    };
-    "get-demo-pulse-status": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspace_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["DemoPulseStatusResponse"];
-                };
-            };
-        };
-    };
-    "stop-demo-pulse": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                workspace_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["DemoPulseStopRequest"];
-            };
-        };
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["DemoPulseStopResponse"];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["HTTPValidationError"];
-                };
-            };
-        };
-    };
     create_desktop_session_v1__workspace_id__desktop_sessions_post: {
         parameters: {
             query?: never;
@@ -36130,6 +35986,8 @@ export interface operations {
                 source?: string;
                 source_system?: string | null;
                 data_source_id?: string | null;
+                /** @description Skip identical re-uploads via content-hash dedup */
+                dedup?: boolean;
             };
             header?: never;
             path: {
@@ -48462,7 +48320,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Use case is bound to a workspace, or still has active phone assignments. */
+            /** @description Use case is bound to a service, or still has active phone assignments. */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -48494,7 +48352,7 @@ export interface operations {
             };
         };
     };
-    "bind-use-case": {
+    "get-use-case-service-binding": {
         parameters: {
             query?: never;
             header?: never;
@@ -48507,12 +48365,12 @@ export interface operations {
         requestBody?: never;
         responses: {
             /** @description Successful Response */
-            201: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["BindingResponse"];
+                    "application/json": components["schemas"]["ServiceBindingResponse"];
                 };
             };
             /** @description Insufficient permissions. */
@@ -48522,28 +48380,76 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Use case not found. */
+            /** @description Use case is not bound to a service in this workspace. */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Use case is already bound to a different workspace. */
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    "bind-use-case-to-service": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspace_id: string;
+                use_case_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ServiceBindingRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ServiceBindingResponse"];
+                };
+            };
+            /** @description Insufficient permissions. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Use case or service not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Service already has a different use case bound for this channel. */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Validation Error */
+            /** @description Unsupported use case channel. */
             422: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["HTTPValidationError"];
-                };
+                content?: never;
             };
             /** @description Channel manager unavailable. */
             502: {
@@ -48561,7 +48467,7 @@ export interface operations {
             };
         };
     };
-    "unbind-use-case": {
+    "unbind-use-case-from-service": {
         parameters: {
             query?: never;
             header?: never;
@@ -48587,7 +48493,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Use case is not bound to this workspace. */
+            /** @description Use case is not bound to a service in this workspace. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -49488,10 +49394,8 @@ export interface operations {
                 source?: string | null;
                 /** @description Filter by source system name (e.g. hubspot, revolution) */
                 source_system?: string | null;
-                /** @description Semantic search via pgvector cosine similarity on entity embeddings. Entity embeddings encode the full projected state — clinical conditions, demographics, relationships. Example: 'diabetes patients in Abu Dhabi'. */
-                semantic?: string | null;
-                /** @description Filter by entity tags (array overlap) */
-                tags?: string[] | null;
+                /** @description Filter by FHIR resource type (e.g. Patient, Practitioner) */
+                fhir_resource_type?: string | null;
             };
             header?: never;
             path: {