@talqing/sdk 0.5.0 → 0.6.0

package/src/gen/types.gen.ts

@@ -1358,7 +1358,7 @@ export type CallDetailResponse = {
     /**
      * Transcript
      */
-    transcript: Array<TranscriptItemResponse>;
+    transcript: Array<ConversationItemResponse>;
     usage: UsageResponse;
     /**
      * Vars
@@ -1773,6 +1773,27 @@ export type CatalogResponse = {
     turn_detector_languages: Array<LanguageOption>;
 };
 
+/**
+ * ChatDetailResponse
+ *
+ * One chat with what explains it: health, priced lines, vars and trace.
+ */
+export type ChatDetailResponse = {
+    chat: ChatResponse;
+    cost: CostDetailResponse | null;
+    /**
+     * Events
+     */
+    events: Array<SessionEventResponse>;
+    snapshot: HealthSnapshotResponse;
+    /**
+     * Vars
+     */
+    vars: {
+        [key: string]: string;
+    };
+};
+
 /**
  * ChatMessageRequest
  *
@@ -2083,7 +2104,7 @@ export type ConversationItemResponse = {
     /**
      * Agent Version
      */
-    agent_version: number | null;
+    agent_version: number | 'draft' | null;
     /**
      * Attachments
      */
@@ -2113,6 +2134,7 @@ export type ConversationItemResponse = {
      * Id
      */
     id: string;
+    latency: ReplyLatency | null;
     /**
      * Metadata
      */
@@ -2120,6 +2142,10 @@ export type ConversationItemResponse = {
         [key: string]: unknown;
     };
     metrics: TurnMetrics | null;
+    /**
+     * Origin
+     */
+    origin: 'speech' | 'typed' | 'keypad' | null;
     /**
      * Provider Message Id
      */
@@ -2281,14 +2307,16 @@ export type ConversationResponse = {
  * One agent execution within a conversation: a call, or a chat.
  */
 export type ConversationSessionResponse = {
+    agent: AgentMetadata;
     /**
-     * Agent Id
+     * Agent Version
      */
-    agent_id: string | null;
+    agent_version: number | 'draft' | null;
     /**
      * Agent Version Id
      */
     agent_version_id: string | null;
+    analysis: AnalysisResponse;
     /**
      * Channel
      */
@@ -2297,6 +2325,10 @@ export type ConversationSessionResponse = {
      * Close Reason
      */
     close_reason: string | null;
+    /**
+     * Close Reason Label
+     */
+    close_reason_label: string | null;
     /**
      * Conversation Id
      */
@@ -2305,11 +2337,15 @@ export type ConversationSessionResponse = {
      * Conversation Ref Id
      */
     conversation_ref_id: string | null;
-    cost: SessionCostResponse | null;
+    cost: CostResponse | null;
     /**
      * Created At
      */
     created_at: string;
+    /**
+     * Duration S
+     */
+    duration_s: number | null;
     /**
      * Ended At
      */
@@ -2324,18 +2360,6 @@ export type ConversationSessionResponse = {
      */
     integration_id: string | null;
     metrics: SessionMetrics;
-    /**
-     * Outcome
-     */
-    outcome: 'success' | 'failure' | 'unknown' | null;
-    /**
-     * Output Item Ids
-     */
-    output_item_ids: Array<string>;
-    /**
-     * Session Id
-     */
-    session_id: string | null;
     /**
      * Started At
      */
@@ -2344,18 +2368,10 @@ export type ConversationSessionResponse = {
      * Status
      */
     status: string;
-    /**
-     * Summary
-     */
-    summary: string | null;
     /**
      * Trigger Id
      */
     trigger_id: string | null;
-    /**
-     * Trigger Item Ids
-     */
-    trigger_item_ids: Array<string>;
     /**
      * Type
      */
@@ -2443,6 +2459,48 @@ export type ConversationSpecOverride = {
     summary_limit?: number | null;
 };
 
+/**
+ * ConversationTraceEventResponse
+ *
+ * One trace row of a conversation, and the session it belongs to.
+ */
+export type ConversationTraceEventResponse = {
+    /**
+     * Created At
+     */
+    created_at: string;
+    /**
+     * Payload
+     */
+    payload: {
+        [key: string]: unknown;
+    };
+    /**
+     * Seq
+     */
+    seq: number;
+    /**
+     * Session Id
+     */
+    session_id: string;
+    /**
+     * Type
+     */
+    type: string;
+};
+
+/**
+ * ConversationTraceResponse
+ *
+ * A conversation's trace over one window, oldest first.
+ */
+export type ConversationTraceResponse = {
+    /**
+     * Events
+     */
+    events: Array<ConversationTraceEventResponse>;
+};
+
 /**
  * CopilotFunctionCallItem
  *
@@ -4389,6 +4447,22 @@ export type HandoffTarget = {
     summary_prompt?: string | null;
 };
 
+/**
+ * HealthIssue
+ *
+ * One problem found, and what kind it is.
+ */
+export type HealthIssue = {
+    /**
+     * Kind
+     */
+    kind: 'failed' | 'never_ready' | 'provider_errors' | 'provider_failover' | 'tool_failures' | 'tools_unfinished' | 'slow_tools' | 'slow_responses' | 'slow_after_filler' | 'connection' | 'noise_cancellation' | 'unpriceable';
+    /**
+     * Message
+     */
+    message: string;
+};
+
 /**
  * HealthResponse
  *
@@ -4438,10 +4512,6 @@ export type HealthSnapshotResponse = {
      * Duration Seconds
      */
     duration_seconds: number | null;
-    /**
-     * End Of Turn Avg Ms
-     */
-    end_of_turn_avg_ms: number | null;
     /**
      * Errors
      */
@@ -4465,7 +4535,7 @@ export type HealthSnapshotResponse = {
     /**
      * Issues
      */
-    issues: Array<string>;
+    issues: Array<HealthIssue>;
     /**
      * Noise Cancellation Failed
      */
@@ -4492,6 +4562,14 @@ export type HealthSnapshotResponse = {
      */
     providers: Array<string>;
     response_latency: LatencyStats;
+    /**
+     * Response Stages
+     */
+    response_stages: Array<LatencyStage>;
+    /**
+     * Slow Replies After Filler
+     */
+    slow_replies_after_filler: number;
     /**
      * Slow Response Threshold Ms
      */
@@ -4528,18 +4606,6 @@ export type HealthSnapshotResponse = {
      * Total Cost Usd
      */
     total_cost_usd: number | null;
-    /**
-     * Transcription Avg Ms
-     */
-    transcription_avg_ms: number | null;
-    /**
-     * Ttfb Avg Ms
-     */
-    ttfb_avg_ms: number | null;
-    /**
-     * Ttft Avg Ms
-     */
-    ttft_avg_ms: number | null;
     /**
      * Tts Audio Ms
      */
@@ -5236,7 +5302,7 @@ export type ItemCreatedEvent = {
     /**
      * Agent Version
      */
-    agent_version: number | null;
+    agent_version: number | 'draft' | null;
     /**
      * Attachments
      */
@@ -5270,6 +5336,7 @@ export type ItemCreatedEvent = {
      * Id
      */
     id: string;
+    latency: ReplyLatency | null;
     /**
      * Metadata
      */
@@ -5277,6 +5344,10 @@ export type ItemCreatedEvent = {
         [key: string]: unknown;
     };
     metrics: TurnMetrics | null;
+    /**
+     * Origin
+     */
+    origin: 'speech' | 'typed' | 'keypad' | null;
     /**
      * Provider Message Id
      */
@@ -6124,6 +6195,26 @@ export type LanguageOption = {
     name: string;
 };
 
+/**
+ * LatencyStage
+ *
+ * One leg of a wait: what the time went on.
+ */
+export type LatencyStage = {
+    /**
+     * Kind
+     */
+    kind: 'stt' | 'endpoint' | 'hook' | 'llm_step' | 'tool' | 'llm' | 'tts' | 'other';
+    /**
+     * Label
+     */
+    label: string;
+    /**
+     * Ms
+     */
+    ms: number;
+};
+
 /**
  * LatencyStats
  */
@@ -9314,6 +9405,26 @@ export type RemoteNumber = {
     provider_number_id?: string | null;
 };
 
+/**
+ * ReplyLatency
+ *
+ * How long the caller waited for this reply, in the order it was spent.
+ */
+export type ReplyLatency = {
+    /**
+     * Kind
+     */
+    kind: 'response' | 'reply' | 'after_filler';
+    /**
+     * Stages
+     */
+    stages: Array<LatencyStage>;
+    /**
+     * Total Ms
+     */
+    total_ms: number;
+};
+
 /**
  * RunStepResponse
  *
@@ -9899,30 +10010,6 @@ export type SendWhatsAppBatchRequest = {
     window?: TimeWindow | null;
 };
 
-/**
- * SessionCostResponse
- *
- * Priced money columns for one session. Absent when billing has not run.
- */
-export type SessionCostResponse = {
-    /**
-     * Duration S
-     */
-    duration_s?: number | null;
-    /**
-     * Platform Fee
-     */
-    platform_fee: number;
-    /**
-     * Provider Cost
-     */
-    provider_cost: number;
-    /**
-     * Total Charge
-     */
-    total_charge: number;
-};
-
 /**
  * SessionError
  *
@@ -9975,6 +10062,7 @@ export type SessionEventResponse = {
  * Latency averages are milliseconds over every message that reported the
  * metric (same rule as call detail / workspace observability). Turn-level
  * samples live on conversation_items.metrics for workspace daily aggregates.
+ * On a chat, `e2e_latency` is a message arriving → the first token back.
  */
 export type SessionMetrics = {
     /**
@@ -11638,52 +11726,6 @@ export type TraceStepResponse = {
     truncated?: boolean;
 };
 
-/**
- * TranscriptItemResponse
- */
-export type TranscriptItemResponse = {
-    /**
-     * Agent Id
-     */
-    agent_id: string | null;
-    /**
-     * Agent Version
-     */
-    agent_version: number | 'draft' | null;
-    /**
-     * Attachments
-     */
-    attachments: Array<ConversationAttachment>;
-    /**
-     * Data
-     */
-    data: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Id
-     */
-    id: string;
-    /**
-     * Item Id
-     */
-    item_id: string;
-    /**
-     * Metrics
-     */
-    metrics: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Timestamp
-     */
-    timestamp: string;
-    /**
-     * Type
-     */
-    type: 'message' | 'function_call' | 'function_call_output' | 'agent_handoff' | 'agent_config_update';
-};
-
 /**
  * TransferConfig
  */
@@ -15113,6 +15155,156 @@ export type ChatsGetResults = {
 
 export type ChatsGetResult = ChatsGetResults[keyof ChatsGetResults];
 
+export type ChatsAnalysisRerunData = {
+    body?: never;
+    path: {
+        /**
+         * Chat Id
+         */
+        chat_id: string;
+    };
+    query?: never;
+    url: '/v1/chats/{chat_id}/analysis';
+};
+
+export type ChatsAnalysisRerunErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * No such resource in this organization.
+     */
+    404: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type ChatsAnalysisRerunError = ChatsAnalysisRerunErrors[keyof ChatsAnalysisRerunErrors];
+
+export type ChatsAnalysisRerunResults = {
+    /**
+     * Successful Response
+     */
+    200: ChatResponse;
+};
+
+export type ChatsAnalysisRerunResult = ChatsAnalysisRerunResults[keyof ChatsAnalysisRerunResults];
+
+export type ChatsAnalysisPreviewData = {
+    body: PreviewAnalysisRequest;
+    path: {
+        /**
+         * Chat Id
+         */
+        chat_id: string;
+    };
+    query?: never;
+    url: '/v1/chats/{chat_id}/analysis/preview';
+};
+
+export type ChatsAnalysisPreviewErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * No such resource in this organization.
+     */
+    404: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type ChatsAnalysisPreviewError = ChatsAnalysisPreviewErrors[keyof ChatsAnalysisPreviewErrors];
+
+export type ChatsAnalysisPreviewResults = {
+    /**
+     * Successful Response
+     */
+    200: PreviewAnalysisResponse;
+};
+
+export type ChatsAnalysisPreviewResult = ChatsAnalysisPreviewResults[keyof ChatsAnalysisPreviewResults];
+
+export type ChatsDetailData = {
+    body?: never;
+    path: {
+        /**
+         * Chat Id
+         */
+        chat_id: string;
+    };
+    query?: never;
+    url: '/v1/chats/{chat_id}/detail';
+};
+
+export type ChatsDetailErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * No such resource in this organization.
+     */
+    404: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type ChatsDetailError = ChatsDetailErrors[keyof ChatsDetailErrors];
+
+export type ChatsDetailResults = {
+    /**
+     * Successful Response
+     */
+    200: ChatDetailResponse;
+};
+
+export type ChatsDetailResult = ChatsDetailResults[keyof ChatsDetailResults];
+
 export type ChatsEndData = {
     body?: never;
     path: {
@@ -15696,6 +15888,61 @@ export type ConversationsSnapshotResults = {
 
 export type ConversationsSnapshotResult = ConversationsSnapshotResults[keyof ConversationsSnapshotResults];
 
+export type ConversationsTraceData = {
+    body?: never;
+    path: {
+        /**
+         * Conversation Id
+         */
+        conversation_id: string;
+    };
+    query?: {
+        /**
+         * After
+         *
+         * Only events at or after this.
+         */
+        after?: string | null;
+        /**
+         * Before
+         *
+         * Only events before this.
+         */
+        before?: string | null;
+    };
+    url: '/v1/conversations/{conversation_id}/trace';
+};
+
+export type ConversationsTraceErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * No such resource in this organization.
+     */
+    404: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type ConversationsTraceError = ConversationsTraceErrors[keyof ConversationsTraceErrors];
+
+export type ConversationsTraceResults = {
+    /**
+     * Successful Response
+     */
+    200: ConversationTraceResponse;
+};
+
+export type ConversationsTraceResult = ConversationsTraceResults[keyof ConversationsTraceResults];
+
 export type CopilotAgentsSendData = {
     body: SendMessageRequest;
     path: {