@droz-js/sdk 0.20.26 → 0.20.27

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@droz-js/sdk",
   "description": "Droz SDK",
-  "version": "0.20.26",
+  "version": "0.20.27",
   "private": false,
   "repository": {
     "type": "git",

package/src/sdks/ai.d.ts

@@ -127,6 +127,10 @@ export type AgentInfo = {
     name: Scalars['String']['output'];
     picture?: Maybe<Scalars['String']['output']>;
 };
+export declare enum AiAgentAnalysisFailureReason {
+    InvalidReply = "invalid_reply",
+    ModelError = "model_error"
+}
 export type AiAgentApproval = {
     agentId: Scalars['ID']['output'];
     args: Scalars['JSON']['output'];
@@ -174,6 +178,10 @@ export type AiAgentBudgetInput = {
     maxToolCalls: Scalars['Int']['input'];
     onExceeded: BudgetExceededAction;
 };
+export declare enum AiAgentChannelType {
+    Web = "web",
+    Whatsapp = "whatsapp"
+}
 export type AiAgentCheckLimits = {
     /** Já dividido pelos cenários deste agente: é o maior valor que a suíte dele sustenta. */
     maxRunsPerScenario: Scalars['Int']['output'];
@@ -219,30 +227,114 @@ export type AiAgentCompetingPair = {
     /** Similaridade entre as duas descricoes, de 0 a 1. */
     score: Scalars['Number']['output'];
 };
+export type AiAgentContactReason = {
+    /** Nome do caso de uso publicado, item do `can`, `Outro` ou `Fora do escopo`. */
+    name: Scalars['String']['output'];
+    /** Mascarado quando a politica de retencao pede. */
+    other?: Maybe<Scalars['String']['output']>;
+    source: AiAgentContactReasonSource;
+    tag?: Maybe<Scalars['String']['output']>;
+    useCaseId?: Maybe<Scalars['ID']['output']>;
+};
+export declare enum AiAgentContactReasonSource {
+    Agent = "agent",
+    Analysis = "analysis"
+}
+export type AiAgentContactReasons = {
+    abandonment: Array<AiAgentMetricsCount>;
+    all: Array<AiAgentMetricsCount>;
+    handoff: Array<AiAgentMetricsCount>;
+};
+export type AiAgentConversationAction = {
+    at: Scalars['Number']['output'];
+    name: Scalars['String']['output'];
+    ok: Scalars['Boolean']['output'];
+    /** Campos que a ferramenta declarou devolver; mascarado quando a politica de retencao pede. */
+    result: Scalars['String']['output'];
+    toolId: Scalars['ID']['output'];
+};
+export type AiAgentConversationAnalysis = {
+    agentClarity?: Maybe<Scalars['Int']['output']>;
+    agentScore?: Maybe<Scalars['Int']['output']>;
+    /** `excelente` a partir de 85, `bom` de 60, `regular` de 40. */
+    agentScoreBand?: Maybe<AiAgentScoreBand>;
+    analysisVersion: Scalars['Int']['output'];
+    analyzedAt: Scalars['Number']['output'];
+    contactReason?: Maybe<Scalars['String']['output']>;
+    contactReasonId?: Maybe<Scalars['ID']['output']>;
+    contactReasonOther?: Maybe<Scalars['String']['output']>;
+    contactReasonSource?: Maybe<AiAgentContactReasonSource>;
+    contactReasonTag?: Maybe<Scalars['String']['output']>;
+    costMicroUsd?: Maybe<Scalars['Number']['output']>;
+    /** De 0 a 100; 100 e o cliente nao ter precisado se esforcar. */
+    customerEffortScore?: Maybe<Scalars['Int']['output']>;
+    /** Estimativa do modelo, de 1 a 5; nao e a pesquisa respondida pelo cliente. */
+    estimatedSatisfaction?: Maybe<Scalars['Int']['output']>;
+    failed?: Maybe<Scalars['Boolean']['output']>;
+    failureReason?: Maybe<AiAgentAnalysisFailureReason>;
+    humanRequests?: Maybe<Scalars['Int']['output']>;
+    /** Mascaradas quando a politica de retencao pede. */
+    knowledgeGaps: Array<Scalars['String']['output']>;
+    model?: Maybe<Scalars['String']['output']>;
+    repeatedInformation?: Maybe<Scalars['Boolean']['output']>;
+    riskAlerts: Array<AiAgentRiskAlert>;
+    sentimentEnd?: Maybe<AiAgentSentiment>;
+    sentimentStart?: Maybe<AiAgentSentiment>;
+    /** Mascarado quando a politica de retencao pede. */
+    summary?: Maybe<Scalars['String']['output']>;
+};
+export declare enum AiAgentConversationClass {
+    NaoElegivel = "NAO_ELEGIVEL",
+    NaoResolvida = "NAO_RESOLVIDA",
+    Resolvida = "RESOLVIDA"
+}
+export type AiAgentConversationClassification = {
+    /** Ausente enquanto a conversa esta em andamento. */
+    classification?: Maybe<AiAgentConversationClass>;
+    consumesAllowance: Scalars['Boolean']['output'];
+    definitionVersion: Scalars['String']['output'];
+    eligibleForResolution: Scalars['Boolean']['output'];
+    inactivityWindowMs: Scalars['Number']['output'];
+    state: AiAgentConversationState;
+    subcategory?: Maybe<AiAgentConversationSubcategory>;
+    technicalFailure?: Maybe<AiAgentTechnicalFailure>;
+};
 export type AiAgentConversationMetrics = {
     channel?: Maybe<Scalars['String']['output']>;
+    channelType?: Maybe<AiAgentChannelType>;
+    contactReason?: Maybe<Scalars['String']['output']>;
+    contactReasonTag?: Maybe<Scalars['String']['output']>;
     costMicroUsd: Scalars['Number']['output'];
     durationMs: Scalars['Number']['output'];
     lastOutcome: Scalars['String']['output'];
     lastTurnAt: Scalars['Number']['output'];
     sessionId: Scalars['ID']['output'];
     startedAt: Scalars['Number']['output'];
+    state: AiAgentConversationState;
+    status?: Maybe<AiAgentConversationClass>;
+    subcategory?: Maybe<AiAgentConversationSubcategory>;
     totalTokens: Scalars['Number']['output'];
     turns: Scalars['Number']['output'];
 };
 export type AiAgentConversationOutcome = {
+    actions: Array<AiAgentConversationAction>;
     agentId: Scalars['ID']['output'];
     /** Escrito pelo modelo ao transferir ou encerrar; nao substitui o que foi medido. */
     agentSummary?: Maybe<Scalars['String']['output']>;
     agentVersion: Scalars['String']['output'];
+    /** Ausente ate a conversa encerrada ser analisada. */
+    analysis?: Maybe<AiAgentConversationAnalysis>;
+    channelType?: Maybe<AiAgentChannelType>;
+    classification: AiAgentConversationClassification;
     /** Fatos da sessao; chave e valor mascarados quando a politica de retencao pede. */
     collectedData: Scalars['JSON']['output'];
     /** false quando a retencao ja apagou a sessao. */
     collectedDataAvailable: Scalars['Boolean']['output'];
+    contactReason?: Maybe<AiAgentContactReason>;
     /** Motivo da parada do ultimo turno, quando houve. */
     haltReason?: Maybe<Scalars['String']['output']>;
     /** Motivo do ultimo pedido de pessoa, com os mesmos valores de `handoffsByReason`. */
-    handoffReason?: Maybe<Scalars['String']['output']>;
+    handoffReason?: Maybe<AiAgentHandoffReason>;
     lastTurnAt: Scalars['Number']['output'];
     /** O que o agente disse ao consumidor que vai acontecer. */
     promisedNextStep?: Maybe<Scalars['String']['output']>;
@@ -252,6 +344,30 @@ export type AiAgentConversationOutcome = {
     startedAt: Scalars['Number']['output'];
     turns: Scalars['Number']['output'];
 };
+export declare enum AiAgentConversationState {
+    EmAndamento = "EM_ANDAMENTO",
+    EncerradaPorConclusao = "ENCERRADA_POR_CONCLUSAO",
+    EncerradaPorFalhaTecnica = "ENCERRADA_POR_FALHA_TECNICA",
+    EncerradaPorInatividade = "ENCERRADA_POR_INATIVIDADE",
+    EncerradaPorTeto = "ENCERRADA_POR_TETO",
+    EncerradaPorTransbordo = "ENCERRADA_POR_TRANSBORDO"
+}
+export declare enum AiAgentConversationSubcategory {
+    AbandonoAposEsclarecimento = "ABANDONO_APOS_ESCLARECIMENTO",
+    EncerradaPorTeto = "ENCERRADA_POR_TETO",
+    FalhaTecnica = "FALHA_TECNICA",
+    Indefinido = "INDEFINIDO",
+    InterlocutorAutomatico = "INTERLOCUTOR_AUTOMATICO",
+    PromptInjection = "PROMPT_INJECTION",
+    ResolvidaConfirmada = "RESOLVIDA_CONFIRMADA",
+    ResolvidaPresumida = "RESOLVIDA_PRESUMIDA",
+    SaudacaoSemDemanda = "SAUDACAO_SEM_DEMANDA",
+    SemCobertura = "SEM_COBERTURA",
+    SemConhecimento = "SEM_CONHECIMENTO",
+    TransbordoPorAutodiagnostico = "TRANSBORDO_POR_AUTODIAGNOSTICO",
+    TransbordoPorNecessidadeCliente = "TRANSBORDO_POR_NECESSIDADE_CLIENTE",
+    TransbordoPorProcedimento = "TRANSBORDO_POR_PROCEDIMENTO"
+}
 /**
  * Como este agente passa o atendimento para uma pessoa.
  *
@@ -269,6 +385,23 @@ export type AiAgentHandoffInput = {
     target?: InputMaybe<Scalars['String']['input']>;
     transition: Scalars['String']['input'];
 };
+export declare enum AiAgentHandoffReason {
+    BudgetExceeded = "budget_exceeded",
+    CannotResolve = "cannot_resolve",
+    CustomerRequest = "customer_request",
+    KnowledgeGap = "knowledge_gap",
+    OutOfScope = "out_of_scope",
+    PeriodBudgetExceeded = "period_budget_exceeded",
+    PolicyRequiresHuman = "policy_requires_human",
+    ProviderUnavailable = "provider_unavailable",
+    ToolFailure = "tool_failure",
+    Undeclared = "undeclared",
+    Unresolved = "unresolved"
+}
+export type AiAgentHandoffReasonCount = {
+    count: Scalars['Number']['output'];
+    key: AiAgentHandoffReason;
+};
 export type AiAgentIdentity = {
     displayName: Scalars['String']['output'];
     openingMessage?: Maybe<Scalars['String']['output']>;
@@ -291,7 +424,17 @@ export type AiAgentKnowledgeBase = {
     title: Scalars['String']['output'];
 };
 export type AiAgentMetrics = {
+    /** Pontos percentuais inteiros sobre `conversationsEligible`; ausente sem conversa elegível. */
+    abandonmentRate?: Maybe<Scalars['Number']['output']>;
+    agentClarityAvg?: Maybe<Scalars['Float']['output']>;
     agentId: Scalars['ID']['output'];
+    agentScoreAvg?: Maybe<Scalars['Float']['output']>;
+    agentScoreAvgBand?: Maybe<AiAgentScoreBand>;
+    agentScoreBands: Array<AiAgentScoreBandCount>;
+    /** true quando os numeros de analise cobrem so parte do periodo. */
+    analysesTruncated: Scalars['Boolean']['output'];
+    analysisCostMicroUsd: Scalars['Number']['output'];
+    analyzedConversations: Scalars['Number']['output'];
     answeredTurns: Scalars['Number']['output'];
     /**
      * Turnos que responderam mesmo com uma conexao falha no meio. E a superficie de risco do guardrail de
@@ -311,7 +454,11 @@ export type AiAgentMetrics = {
     cachedInputTokens: Scalars['Number']['output'];
     /** Turnos respondidos pelo cache, sem chamada ao modelo. E o ganho da otimizacao de §4.9. */
     cachedTurns: Scalars['Number']['output'];
+    classificationDefinitionVersion: Scalars['String']['output'];
+    contactReasons: AiAgentContactReasons;
     conversations: Scalars['Number']['output'];
+    conversationsByClassification: Array<AiAgentMetricsCount>;
+    conversationsEligible: Scalars['Number']['output'];
     /**
      * Conversas em que algum turno **pediu** uma pessoa. Pedido, nao confirmacao: o disparo da transicao
      * e best-effort, entao nem toda solicitacao virou transferencia de fato.
@@ -325,6 +472,7 @@ export type AiAgentMetrics = {
     conversationsInconclusive: Scalars['Number']['output'];
     /** Conversas resolvidas sob a regra declarada em `resolutionDefinition`. */
     conversationsResolved: Scalars['Number']['output'];
+    conversationsResolvedByDefinition: Scalars['Number']['output'];
     /** Gasto da janela em micro-dolar (1e-6 USD), inteiro. */
     costMicroUsd: Scalars['Number']['output'];
     /**
@@ -332,6 +480,7 @@ export type AiAgentMetrics = {
      * conversa resolveu no periodo — dividir por zero nao vira zero.
      */
     costMicroUsdPerResolvedConversation?: Maybe<Scalars['Number']['output']>;
+    customerEffortScoreAvg?: Maybe<Scalars['Float']['output']>;
     /**
      * Escalonou, mas a transicao nao tem destino declarado. Fica a parte de proposito: somar a um dos
      * dois lados seria supor para onde o fluxo do tenant leva.
@@ -341,16 +490,22 @@ export type AiAgentMetrics = {
     escalatedToFlow: Scalars['Number']['output'];
     /** Escalonamentos cujo destino o autor declarou como pessoa. */
     escalatedToHuman: Scalars['Number']['output'];
+    estimatedSatisfactionAvg?: Maybe<Scalars['Float']['output']>;
+    failedAnalyses: Scalars['Number']['output'];
     from: Scalars['Number']['output'];
     haltReasons: Array<AiAgentMetricsCount>;
     haltedTurns: Scalars['Number']['output'];
+    /** Pontos percentuais inteiros sobre `conversationsEligible`; ausente sem conversa elegível. */
+    handoffNeedRate?: Maybe<Scalars['Number']['output']>;
+    /** Pontos percentuais inteiros sobre `conversationsEligible`; ausente sem conversa elegível. */
+    handoffProcedureRate?: Maybe<Scalars['Number']['output']>;
     /**
      * Por que a pessoa foi pedida. Declarado pelo agente: `customer_request`, `out_of_scope`,
      * `knowledge_gap`, `policy_requires_human`, `cannot_resolve`, `tool_failure`; `undeclared` quando ele
      * transferiu sem declarar. Da plataforma: `tool_failure`, `provider_unavailable`, `budget_exceeded`,
      * `period_budget_exceeded` e `unresolved` quando o agente parou sem concluir.
      */
-    handoffsByReason: Array<AiAgentMetricsCount>;
+    handoffsByReason: Array<AiAgentHandoffReasonCount>;
     /** Turnos que terminaram pedindo uma pessoa (pedido, nao transferencia). */
     humanRequestedTurns: Scalars['Number']['output'];
     /** Turnos que precisaram de cliente identificado e nao tinham um — a medida do atrito de identificacao. */
@@ -370,6 +525,11 @@ export type AiAgentMetrics = {
      * janela — sem dado e zero por cento nao sao a mesma coisa.
      */
     resolutionRate?: Maybe<Scalars['Number']['output']>;
+    /** Pontos percentuais inteiros sobre `conversationsEligible`; ausente sem conversa elegível. */
+    resolvedRate?: Maybe<Scalars['Number']['output']>;
+    riskAlerts: Array<AiAgentRiskAlertCount>;
+    sentimentAtEnd: Array<AiAgentSentimentCount>;
+    sentimentAtStart: Array<AiAgentSentimentCount>;
     to: Scalars['Number']['output'];
     toolCalls: Scalars['Number']['output'];
     /** Chamadas de ferramenta que falharam. */
@@ -378,6 +538,7 @@ export type AiAgentMetrics = {
     toolErrorsByClass: Array<AiAgentMetricsCount>;
     /** Falhas por conexao externa, identificada pelo host — responde "qual integracao esta caindo". */
     toolErrorsByConnection: Array<AiAgentMetricsCount>;
+    topKnowledgeGaps: Array<AiAgentMetricsCount>;
     /** Assuntos mais frequentes da janela, escolhidos no conjunto fechado do `can` de cada agente. */
     topTopics: Array<AiAgentMetricsCount>;
     /** As perguntas mais frequentes sem resposta, agrupadas por texto normalizado. */
@@ -399,6 +560,8 @@ export type AiAgentMetrics = {
      * **piso**, nao total — nao decidir preco sem olhar este numero.
      */
     unpricedTurns: Scalars['Number']['output'];
+    /** Pontos percentuais inteiros sobre `conversationsEligible`; ausente sem conversa elegível. */
+    unresolvedRate?: Maybe<Scalars['Number']['output']>;
 };
 export type AiAgentMetricsCount = {
     count: Scalars['Number']['output'];
@@ -455,6 +618,16 @@ export type AiAgentRetentionPolicyInput = {
     days: AiAgentRetentionDaysInput;
     masksPersonalData: Scalars['Boolean']['input'];
 };
+export declare enum AiAgentRiskAlert {
+    Cancelamento = "cancelamento",
+    Justica = "justica",
+    Procon = "procon",
+    ReclameAqui = "reclame_aqui"
+}
+export type AiAgentRiskAlertCount = {
+    count: Scalars['Number']['output'];
+    key: AiAgentRiskAlert;
+};
 export type AiAgentRoutedExample = {
     /** `high`, `medium` ou `low`. */
     confidence: Scalars['String']['output'];
@@ -524,6 +697,25 @@ export type AiAgentScenarioTurn = {
     /** 1 para o primeiro turno do cenário. */
     turn: Scalars['Int']['output'];
 };
+export declare enum AiAgentScoreBand {
+    Bom = "bom",
+    Excelente = "excelente",
+    Regular = "regular",
+    Ruim = "ruim"
+}
+export type AiAgentScoreBandCount = {
+    count: Scalars['Number']['output'];
+    key: AiAgentScoreBand;
+};
+export declare enum AiAgentSentiment {
+    Negativo = "negativo",
+    Neutro = "neutro",
+    Positivo = "positivo"
+}
+export type AiAgentSentimentCount = {
+    count: Scalars['Number']['output'];
+    key: AiAgentSentiment;
+};
 export type AiAgentSpec = {
     /** @deprecated Ignorado. O tipo da ferramenta sai do método do conector. O campo sai na próxima versão. */
     allowWriteTools?: Maybe<Scalars['Boolean']['output']>;
@@ -582,6 +774,12 @@ export type AiAgentSummary = {
     /** Momento da versao mais recente, no ar ou nao — o "ultima alteracao" da listagem. */
     updatedAt: Scalars['Number']['output'];
 };
+export declare enum AiAgentTechnicalFailure {
+    Erro_5Xx = "ERRO_5XX",
+    FerramentaIndisponivel = "FERRAMENTA_INDISPONIVEL",
+    LimiteOperacional = "LIMITE_OPERACIONAL",
+    Timeout = "TIMEOUT"
+}
 export type AiAgentTool = {
     /** `pre_approved` (padrao) ou `human_approval`. */
     approval?: Maybe<Scalars['String']['output']>;
@@ -644,6 +842,7 @@ export type AiAgentTrace = {
     agentId: Scalars['ID']['output'];
     agentVersion: Scalars['String']['output'];
     answer: Scalars['String']['output'];
+    channelType?: Maybe<AiAgentChannelType>;
     /** Ausente no turno que não selecionou ferramentas (cache, contraparte automática) e no registrado antes do campo existir. */
     excludedTools?: Maybe<Array<AiAgentToolExclusion>>;
     /** Presente so quando o turno parou por limite; ausente quando respondeu. */
@@ -689,6 +888,8 @@ export type AiAgentUseCase = {
      * produz roteamento ruim.
      */
     subjectDescription: Scalars['String']['output'];
+    /** Minusculas e digitos, separados por - ou _. */
+    tag?: Maybe<Scalars['String']['output']>;
     updatedAt: Scalars['Number']['output'];
 };
 export type AiAgentUseCaseOverlap = {
@@ -1126,6 +1327,8 @@ export type SaveAiAgentUseCaseInput = {
     procedureId?: InputMaybe<Scalars['ID']['input']>;
     status: Scalars['String']['input'];
     subjectDescription: Scalars['String']['input'];
+    /** Ausente apaga a tag gravada. */
+    tag?: InputMaybe<Scalars['String']['input']>;
 };
 export type SearchResultsFacet = {
     name: Scalars['String']['output'];
@@ -1218,6 +1421,7 @@ export declare enum Typenames {
     AiAgentAnswerCache = "AiAgentAnswerCache",
     AiAgentApproval = "AiAgentApproval",
     AiAgentCheckRun = "AiAgentCheckRun",
+    AiAgentConversationAnalysis = "AiAgentConversationAnalysis",
     AiAgentEvalReport = "AiAgentEvalReport",
     AiAgentProcedure = "AiAgentProcedure",
     AiAgentRetentionPolicy = "AiAgentRetentionPolicy",
@@ -1318,7 +1522,7 @@ export type RemoveAiAgentMutationVariables = Exact<{
     input: AiAgentRefInput;
 }>;
 export type RemoveAiAgentMutation = Pick<Mutation, 'removeAiAgent'>;
-export type AiAgentUseCaseFragment = Pick<AiAgentUseCase, 'id' | 'name' | 'subjectDescription' | 'procedureId' | 'status' | 'updatedAt'>;
+export type AiAgentUseCaseFragment = Pick<AiAgentUseCase, 'id' | 'name' | 'subjectDescription' | 'procedureId' | 'tag' | 'status' | 'updatedAt'>;
 export type AiAgentProcedureFragment = Pick<AiAgentProcedure, 'id' | 'name' | 'guidanceSteps' | 'toolIds' | 'contingency' | 'executionAutonomy' | 'status' | 'updatedAt'>;
 export type AiAgentToolFragment = (Pick<AiAgentTool, 'toolId' | 'name' | 'description' | 'effect' | 'availability' | 'requiresAuthenticatedCustomer' | 'onFailure' | 'customerScope' | 'returns' | 'approval'> & {
     parameters: Array<Pick<AiAgentToolParameter, 'name' | 'type' | 'required' | 'description' | 'grounding'>>;
@@ -1386,13 +1590,18 @@ export type AiAgentConversationMetricsQueryVariables = Exact<{
     input: AiAgentMetricsInput;
 }>;
 export type AiAgentConversationMetricsQuery = {
-    aiAgentConversationMetrics: Array<Pick<AiAgentConversationMetrics, 'sessionId' | 'channel' | 'turns' | 'startedAt' | 'lastTurnAt' | 'totalTokens' | 'costMicroUsd' | 'durationMs' | 'lastOutcome'>>;
+    aiAgentConversationMetrics: Array<Pick<AiAgentConversationMetrics, 'sessionId' | 'channel' | 'turns' | 'startedAt' | 'lastTurnAt' | 'totalTokens' | 'costMicroUsd' | 'durationMs' | 'lastOutcome' | 'state' | 'status' | 'subcategory' | 'contactReason' | 'contactReasonTag' | 'channelType'>>;
 };
 export type AiAgentConversationOutcomeQueryVariables = Exact<{
     sessionId: Scalars['ID']['input'];
 }>;
 export type AiAgentConversationOutcomeQuery = {
-    aiAgentConversationOutcome?: Maybe<Pick<AiAgentConversationOutcome, 'sessionId' | 'agentId' | 'agentVersion' | 'resolution' | 'resolutionDefinition' | 'collectedData' | 'collectedDataAvailable' | 'turns' | 'startedAt' | 'lastTurnAt' | 'haltReason'>>;
+    aiAgentConversationOutcome?: Maybe<(Pick<AiAgentConversationOutcome, 'sessionId' | 'agentId' | 'agentVersion' | 'resolution' | 'resolutionDefinition' | 'collectedData' | 'collectedDataAvailable' | 'turns' | 'startedAt' | 'lastTurnAt' | 'haltReason' | 'handoffReason' | 'agentSummary' | 'promisedNextStep' | 'channelType'> & {
+        classification: Pick<AiAgentConversationClassification, 'state' | 'classification' | 'subcategory' | 'technicalFailure' | 'eligibleForResolution' | 'consumesAllowance' | 'inactivityWindowMs' | 'definitionVersion'>;
+        actions: Array<Pick<AiAgentConversationAction, 'toolId' | 'name' | 'ok' | 'result' | 'at'>>;
+        contactReason?: Maybe<Pick<AiAgentContactReason, 'name' | 'useCaseId' | 'tag' | 'other' | 'source'>>;
+        analysis?: Maybe<Pick<AiAgentConversationAnalysis, 'analysisVersion' | 'failed' | 'failureReason' | 'sentimentStart' | 'sentimentEnd' | 'estimatedSatisfaction' | 'riskAlerts' | 'knowledgeGaps' | 'repeatedInformation' | 'humanRequests' | 'contactReason' | 'contactReasonId' | 'contactReasonTag' | 'contactReasonOther' | 'contactReasonSource' | 'summary' | 'agentScore' | 'agentScoreBand' | 'agentClarity' | 'customerEffortScore' | 'model' | 'costMicroUsd' | 'analyzedAt'>>;
+    })>;
 };
 export type SaveAiAgentUseCaseMutationVariables = Exact<{
     input: SaveAiAgentUseCaseInput;
@@ -1482,8 +1691,19 @@ export type AiAgentCheckLimitsQueryVariables = Exact<{
 export type AiAgentCheckLimitsQuery = {
     aiAgentCheckLimits: Pick<AiAgentCheckLimits, 'minRunsPerScenario' | 'maxRunsPerScenario' | 'maxSuiteRuns' | 'scenarioCount'>;
 };
-export type AiAgentMetricsReportFragment = (Pick<AiAgentMetrics, 'agentId' | 'from' | 'to' | 'truncated' | 'conversations' | 'conversationsResolved' | 'conversationsInconclusive' | 'conversationsHandoffRequested' | 'resolutionRate' | 'resolutionDefinition' | 'escalatedToHuman' | 'escalatedToFlow' | 'escalatedTargetUndeclared' | 'humanRequestedTurns' | 'costMicroUsd' | 'costMicroUsdPerResolvedConversation' | 'unpricedTurns' | 'inputTokens' | 'outputTokens' | 'totalTokens' | 'cachedInputTokens' | 'cachedTurns' | 'llmCalls' | 'avgTurnDurationMs' | 'p95TurnDurationMs' | 'avgLlmLatencyMs' | 'turns' | 'answeredTurns' | 'answeredWithFailedConnectionTurns' | 'unansweredTurns' | 'unansweredDefinition' | 'blockedTurns' | 'haltedTurns' | 'budgetExceededTurns' | 'identificationRequiredTurns' | 'toolCalls' | 'toolCallsFailed' | 'knowledgeRetrieved' | 'knowledgeEmpty' | 'knowledgeUnavailable' | 'knowledgeSkipped'> & {
-    handoffsByReason: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
+export type AiAgentMetricsReportFragment = (Pick<AiAgentMetrics, 'agentId' | 'from' | 'to' | 'truncated' | 'conversations' | 'conversationsResolved' | 'conversationsInconclusive' | 'conversationsHandoffRequested' | 'resolutionRate' | 'resolutionDefinition' | 'conversationsEligible' | 'conversationsResolvedByDefinition' | 'resolvedRate' | 'unresolvedRate' | 'handoffProcedureRate' | 'handoffNeedRate' | 'abandonmentRate' | 'classificationDefinitionVersion' | 'analyzedConversations' | 'estimatedSatisfactionAvg' | 'analysisCostMicroUsd' | 'failedAnalyses' | 'analysesTruncated' | 'agentScoreAvg' | 'agentScoreAvgBand' | 'agentClarityAvg' | 'customerEffortScoreAvg' | 'escalatedToHuman' | 'escalatedToFlow' | 'escalatedTargetUndeclared' | 'humanRequestedTurns' | 'costMicroUsd' | 'costMicroUsdPerResolvedConversation' | 'unpricedTurns' | 'inputTokens' | 'outputTokens' | 'totalTokens' | 'cachedInputTokens' | 'cachedTurns' | 'llmCalls' | 'avgTurnDurationMs' | 'p95TurnDurationMs' | 'avgLlmLatencyMs' | 'turns' | 'answeredTurns' | 'answeredWithFailedConnectionTurns' | 'unansweredTurns' | 'unansweredDefinition' | 'blockedTurns' | 'haltedTurns' | 'budgetExceededTurns' | 'identificationRequiredTurns' | 'toolCalls' | 'toolCallsFailed' | 'knowledgeRetrieved' | 'knowledgeEmpty' | 'knowledgeUnavailable' | 'knowledgeSkipped'> & {
+    conversationsByClassification: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
+    sentimentAtStart: Array<Pick<AiAgentSentimentCount, 'key' | 'count'>>;
+    sentimentAtEnd: Array<Pick<AiAgentSentimentCount, 'key' | 'count'>>;
+    riskAlerts: Array<Pick<AiAgentRiskAlertCount, 'key' | 'count'>>;
+    topKnowledgeGaps: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
+    agentScoreBands: Array<Pick<AiAgentScoreBandCount, 'key' | 'count'>>;
+    contactReasons: {
+        all: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
+        handoff: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
+        abandonment: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
+    };
+    handoffsByReason: Array<Pick<AiAgentHandoffReasonCount, 'key' | 'count'>>;
     turnsByModel: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     topTopics: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     topUnansweredQuestions: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
@@ -1613,14 +1833,14 @@ export declare const AiAgentSpecFragmentDoc = "\n    fragment aiAgentSpec on AiA
 export declare const AiAgentToolExclusionFragmentDoc = "\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 export declare const AiAgentVersionWithSpecFragmentDoc = "\n    fragment aiAgentVersionWithSpec on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n  spec {\n    ...aiAgentSpec\n  }\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n}\n    ";
 export declare const AiAgentListingMetricsFragmentDoc = "\n    fragment aiAgentListingMetrics on AiAgentMetrics {\n  agentId\n  conversations\n  conversationsResolved\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  costMicroUsd\n}\n    ";
-export declare const AiAgentUseCaseFragmentDoc = "\n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  status\n  updatedAt\n}\n    ";
+export declare const AiAgentUseCaseFragmentDoc = "\n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  tag\n  status\n  updatedAt\n}\n    ";
 export declare const AiAgentProcedureFragmentDoc = "\n    fragment aiAgentProcedure on AiAgentProcedure {\n  id\n  name\n  guidanceSteps\n  toolIds\n  contingency\n  executionAutonomy\n  status\n  updatedAt\n}\n    ";
 export declare const AiAgentToolFragmentDoc = "\n    fragment aiAgentTool on AiAgentTool {\n  toolId\n  name\n  description\n  effect\n  availability\n  requiresAuthenticatedCustomer\n  onFailure\n  customerScope\n  returns\n  approval\n  parameters {\n    name\n    type\n    required\n    description\n    grounding\n  }\n}\n    ";
 export declare const AiAgentTraceFragmentDoc = "\n    fragment aiAgentTrace on AiAgentTrace {\n  sessionId\n  turn\n  agentId\n  agentVersion\n  input\n  promptBuilderVersion\n  masterRuleVersion\n  identificationRequired\n  promptFingerprint\n  knowledgeOrigins\n  outcome\n  haltReason\n  steps\n  answer\n  startedAt\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  toolCalls {\n    toolId\n    name\n    result\n    ok\n    connection\n    errorClass\n  }\n}\n    ";
 export declare const AiAgentScenarioFragmentDoc = "\n    fragment aiAgentScenario on AiAgentScenario {\n  scenarioId\n  description\n  customerId\n  turns\n  expectations\n}\n    ";
 export declare const AiAgentApprovalFragmentDoc = "\n    fragment aiAgentApproval on AiAgentApproval {\n  agentId\n  sessionId\n  toolId\n  toolName\n  args\n  channelId\n  customerId\n  requestedAt\n  expiresAt\n  status\n  decidedBy\n  decidedAt\n}\n    ";
 export declare const AiAgentCheckRunFragmentDoc = "\n    fragment aiAgentCheckRun on AiAgentCheckRun {\n  runId\n  agentId\n  version\n  status\n  requestedAt\n  startedAt\n  finishedAt\n  totalRuns\n  completedRuns\n  error\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\n      handoffReasons {\n        key\n        count\n      }\n      turns {\n        turn\n        runs\n        answered\n        grounded\n        blocked\n        identificationRequired\n        toolNames {\n          key\n          count\n        }\n        blockCategories {\n          key\n          count\n        }\n      }\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    ";
-export declare const AiAgentMetricsReportFragmentDoc = "\n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
+export declare const AiAgentMetricsReportFragmentDoc = "\n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  conversationsByClassification {\n    key\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  analyzedConversations\n  estimatedSatisfactionAvg\n  sentimentAtStart {\n    key\n    count\n  }\n  sentimentAtEnd {\n    key\n    count\n  }\n  riskAlerts {\n    key\n    count\n  }\n  topKnowledgeGaps {\n    key\n    count\n  }\n  analysisCostMicroUsd\n  failedAnalyses\n  analysesTruncated\n  agentScoreAvg\n  agentScoreAvgBand\n  agentScoreBands {\n    key\n    count\n  }\n  agentClarityAvg\n  customerEffortScoreAvg\n  contactReasons {\n    all {\n      key\n      count\n    }\n    handoff {\n      key\n      count\n    }\n    abandonment {\n      key\n      count\n    }\n  }\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
 export declare const NlpInstanceFragmentDoc = "\n    fragment nlpInstance on NlpInstance {\n  id\n  name\n  drn\n  options {\n    transition\n    samples\n  }\n  createdAt\n  updatedAt\n}\n    ";
 export declare const QnaFragmentFragmentDoc = "\n    fragment qnaFragment on QnAInstance {\n  id\n  name\n  drn\n  credentialsId\n  tryToReplyOnTransition\n  createdAt\n  updatedAt\n}\n    ";
 export declare const ListAiAgentsDocument = "\n    query listAiAgents {\n  listAiAgents {\n    ...aiAgentSummary\n  }\n}\n    \n    fragment aiAgentSummary on AiAgentSummary {\n  agentId\n  name\n  liveVersion\n  channels\n  updatedAt\n  queuedApprovals\n  status\n}\n    ";
@@ -1632,7 +1852,7 @@ export declare const UnpublishAiAgentVersionDocument = "\n    mutation unpublish
 export declare const RollbackAiAgentVersionDocument = "\n    mutation rollbackAiAgentVersion($input: AiAgentVersionRefInput!) {\n  rollbackAiAgentVersion(input: $input) {\n    ...aiAgentVersion\n  }\n}\n    \n    fragment aiAgentVersion on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n}\n    ";
 export declare const RemoveAiAgentVersionDocument = "\n    mutation removeAiAgentVersion($input: AiAgentVersionRefInput!) {\n  removeAiAgentVersion(input: $input) {\n    ...aiAgentVersion\n  }\n}\n    \n    fragment aiAgentVersion on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n}\n    ";
 export declare const RemoveAiAgentDocument = "\n    mutation removeAiAgent($input: AiAgentRefInput!) {\n  removeAiAgent(input: $input)\n}\n    ";
-export declare const ListAiAgentUseCasesDocument = "\n    query listAiAgentUseCases($agentId: ID!) {\n  listAiAgentUseCases(agentId: $agentId) {\n    ...aiAgentUseCase\n  }\n}\n    \n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  status\n  updatedAt\n}\n    ";
+export declare const ListAiAgentUseCasesDocument = "\n    query listAiAgentUseCases($agentId: ID!) {\n  listAiAgentUseCases(agentId: $agentId) {\n    ...aiAgentUseCase\n  }\n}\n    \n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  tag\n  status\n  updatedAt\n}\n    ";
 export declare const ListAiAgentProceduresDocument = "\n    query listAiAgentProcedures($agentId: ID!) {\n  listAiAgentProcedures(agentId: $agentId) {\n    ...aiAgentProcedure\n  }\n}\n    \n    fragment aiAgentProcedure on AiAgentProcedure {\n  id\n  name\n  guidanceSteps\n  toolIds\n  contingency\n  executionAutonomy\n  status\n  updatedAt\n}\n    ";
 export declare const ListAiAgentToolsDocument = "\n    query listAiAgentTools {\n  listAiAgentTools {\n    ...aiAgentTool\n  }\n}\n    \n    fragment aiAgentTool on AiAgentTool {\n  toolId\n  name\n  description\n  effect\n  availability\n  requiresAuthenticatedCustomer\n  onFailure\n  customerScope\n  returns\n  approval\n  parameters {\n    name\n    type\n    required\n    description\n    grounding\n  }\n}\n    ";
 export declare const AiAgentUseCaseOverlapDocument = "\n    query aiAgentUseCaseOverlap($agentId: ID!) {\n  aiAgentUseCaseOverlap(agentId: $agentId) {\n    threshold\n    pairs {\n      left\n      right\n      score\n    }\n  }\n}\n    ";
@@ -1640,9 +1860,9 @@ export declare const AiAgentTraceDocument = "\n    query aiAgentTrace($sessionId
 export declare const ListAiAgentScenariosDocument = "\n    query listAiAgentScenarios($agentId: ID!) {\n  listAiAgentScenarios(agentId: $agentId) {\n    ...aiAgentScenario\n  }\n}\n    \n    fragment aiAgentScenario on AiAgentScenario {\n  scenarioId\n  description\n  customerId\n  turns\n  expectations\n}\n    ";
 export declare const SetAiAgentRetentionPolicyDocument = "\n    mutation setAiAgentRetentionPolicy($input: AiAgentRetentionPolicyInput!) {\n  setAiAgentRetentionPolicy(input: $input) {\n    days {\n      transcript\n      session_state\n      long_term_memory\n    }\n    masksPersonalData\n  }\n}\n    ";
 export declare const AiAgentRetentionPolicyDocument = "\n    query aiAgentRetentionPolicy {\n  aiAgentRetentionPolicy {\n    days {\n      transcript\n      session_state\n      long_term_memory\n    }\n    masksPersonalData\n  }\n}\n    ";
-export declare const AiAgentConversationMetricsDocument = "\n    query aiAgentConversationMetrics($input: AiAgentMetricsInput!) {\n  aiAgentConversationMetrics(input: $input) {\n    sessionId\n    channel\n    turns\n    startedAt\n    lastTurnAt\n    totalTokens\n    costMicroUsd\n    durationMs\n    lastOutcome\n  }\n}\n    ";
-export declare const AiAgentConversationOutcomeDocument = "\n    query aiAgentConversationOutcome($sessionId: ID!) {\n  aiAgentConversationOutcome(sessionId: $sessionId) {\n    sessionId\n    agentId\n    agentVersion\n    resolution\n    resolutionDefinition\n    collectedData\n    collectedDataAvailable\n    turns\n    startedAt\n    lastTurnAt\n    haltReason\n  }\n}\n    ";
-export declare const SaveAiAgentUseCaseDocument = "\n    mutation saveAiAgentUseCase($input: SaveAiAgentUseCaseInput!) {\n  saveAiAgentUseCase(input: $input) {\n    ...aiAgentUseCase\n  }\n}\n    \n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  status\n  updatedAt\n}\n    ";
+export declare const AiAgentConversationMetricsDocument = "\n    query aiAgentConversationMetrics($input: AiAgentMetricsInput!) {\n  aiAgentConversationMetrics(input: $input) {\n    sessionId\n    channel\n    turns\n    startedAt\n    lastTurnAt\n    totalTokens\n    costMicroUsd\n    durationMs\n    lastOutcome\n    state\n    status\n    subcategory\n    contactReason\n    contactReasonTag\n    channelType\n  }\n}\n    ";
+export declare const AiAgentConversationOutcomeDocument = "\n    query aiAgentConversationOutcome($sessionId: ID!) {\n  aiAgentConversationOutcome(sessionId: $sessionId) {\n    sessionId\n    agentId\n    agentVersion\n    resolution\n    resolutionDefinition\n    collectedData\n    collectedDataAvailable\n    turns\n    startedAt\n    lastTurnAt\n    haltReason\n    handoffReason\n    agentSummary\n    promisedNextStep\n    classification {\n      state\n      classification\n      subcategory\n      technicalFailure\n      eligibleForResolution\n      consumesAllowance\n      inactivityWindowMs\n      definitionVersion\n    }\n    channelType\n    actions {\n      toolId\n      name\n      ok\n      result\n      at\n    }\n    contactReason {\n      name\n      useCaseId\n      tag\n      other\n      source\n    }\n    analysis {\n      analysisVersion\n      failed\n      failureReason\n      sentimentStart\n      sentimentEnd\n      estimatedSatisfaction\n      riskAlerts\n      knowledgeGaps\n      repeatedInformation\n      humanRequests\n      contactReason\n      contactReasonId\n      contactReasonTag\n      contactReasonOther\n      contactReasonSource\n      summary\n      agentScore\n      agentScoreBand\n      agentClarity\n      customerEffortScore\n      model\n      costMicroUsd\n      analyzedAt\n    }\n  }\n}\n    ";
+export declare const SaveAiAgentUseCaseDocument = "\n    mutation saveAiAgentUseCase($input: SaveAiAgentUseCaseInput!) {\n  saveAiAgentUseCase(input: $input) {\n    ...aiAgentUseCase\n  }\n}\n    \n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  tag\n  status\n  updatedAt\n}\n    ";
 export declare const SaveAiAgentProcedureDocument = "\n    mutation saveAiAgentProcedure($input: SaveAiAgentProcedureInput!) {\n  saveAiAgentProcedure(input: $input) {\n    ...aiAgentProcedure\n  }\n}\n    \n    fragment aiAgentProcedure on AiAgentProcedure {\n  id\n  name\n  guidanceSteps\n  toolIds\n  contingency\n  executionAutonomy\n  status\n  updatedAt\n}\n    ";
 export declare const RemoveAiAgentUseCaseDocument = "\n    mutation removeAiAgentUseCase($input: AiAgentAuthoringRefInput!) {\n  removeAiAgentUseCase(input: $input)\n}\n    ";
 export declare const RemoveAiAgentProcedureDocument = "\n    mutation removeAiAgentProcedure($input: AiAgentAuthoringRefInput!) {\n  removeAiAgentProcedure(input: $input)\n}\n    ";
@@ -1656,7 +1876,7 @@ export declare const SaveAiAgentScenarioDocument = "\n    mutation saveAiAgentSc
 export declare const CheckAiAgentVersionDocument = "\n    mutation checkAiAgentVersion($input: CheckAiAgentVersionInput!) {\n  checkAiAgentVersion(input: $input) {\n    ...aiAgentCheckRun\n  }\n}\n    \n    fragment aiAgentCheckRun on AiAgentCheckRun {\n  runId\n  agentId\n  version\n  status\n  requestedAt\n  startedAt\n  finishedAt\n  totalRuns\n  completedRuns\n  error\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\n      handoffReasons {\n        key\n        count\n      }\n      turns {\n        turn\n        runs\n        answered\n        grounded\n        blocked\n        identificationRequired\n        toolNames {\n          key\n          count\n        }\n        blockCategories {\n          key\n          count\n        }\n      }\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 export declare const GetAiAgentCheckRunDocument = "\n    query getAiAgentCheckRun($agentId: ID!, $runId: ID!) {\n  getAiAgentCheckRun(agentId: $agentId, runId: $runId) {\n    ...aiAgentCheckRun\n  }\n}\n    \n    fragment aiAgentCheckRun on AiAgentCheckRun {\n  runId\n  agentId\n  version\n  status\n  requestedAt\n  startedAt\n  finishedAt\n  totalRuns\n  completedRuns\n  error\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\n      handoffReasons {\n        key\n        count\n      }\n      turns {\n        turn\n        runs\n        answered\n        grounded\n        blocked\n        identificationRequired\n        toolNames {\n          key\n          count\n        }\n        blockCategories {\n          key\n          count\n        }\n      }\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 export declare const AiAgentCheckLimitsDocument = "\n    query aiAgentCheckLimits($agentId: ID!) {\n  aiAgentCheckLimits(agentId: $agentId) {\n    minRunsPerScenario\n    maxRunsPerScenario\n    maxSuiteRuns\n    scenarioCount\n  }\n}\n    ";
-export declare const AiAgentMetricsDocument = "\n    query aiAgentMetrics($input: AiAgentMetricsInput!) {\n  aiAgentMetrics(input: $input) {\n    ...aiAgentMetricsReport\n  }\n}\n    \n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
+export declare const AiAgentMetricsDocument = "\n    query aiAgentMetrics($input: AiAgentMetricsInput!) {\n  aiAgentMetrics(input: $input) {\n    ...aiAgentMetricsReport\n  }\n}\n    \n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  conversationsByClassification {\n    key\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  analyzedConversations\n  estimatedSatisfactionAvg\n  sentimentAtStart {\n    key\n    count\n  }\n  sentimentAtEnd {\n    key\n    count\n  }\n  riskAlerts {\n    key\n    count\n  }\n  topKnowledgeGaps {\n    key\n    count\n  }\n  analysisCostMicroUsd\n  failedAnalyses\n  analysesTruncated\n  agentScoreAvg\n  agentScoreAvgBand\n  agentScoreBands {\n    key\n    count\n  }\n  agentClarityAvg\n  customerEffortScoreAvg\n  contactReasons {\n    all {\n      key\n      count\n    }\n    handoff {\n      key\n      count\n    }\n    abandonment {\n      key\n      count\n    }\n  }\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
 export declare const AiAgentVersionSpecDocument = "\n    query aiAgentVersionSpec($agentId: ID!) {\n  listAiAgentVersions(agentId: $agentId) {\n    ...aiAgentVersionWithSpec\n  }\n}\n    \n    fragment aiAgentVersionWithSpec on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n  spec {\n    ...aiAgentSpec\n  }\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n}\n    \n\n    fragment aiAgentSpec on AiAgentSpec {\n  identity {\n    displayName\n    role\n    tone\n    toneNotes\n    openingMessage\n    outOfScopeBehaviour\n  }\n  can\n  cannot\n  knowledgeBaseIds\n  knowledgeFallback\n  toolIds\n  budget {\n    maxSteps\n    maxToolCalls\n    maxTokens\n    maxCostMicroUsd\n    maxPeriodCostMicroUsd\n    onExceeded\n  }\n  handoff {\n    transition\n    target\n  }\n  channels\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 export declare const AiAgentRoutingPreviewDocument = "\n    query aiAgentRoutingPreview($input: AiAgentRoutingPreviewInput!) {\n  aiAgentRoutingPreview(input: $input) {\n    high\n    medium\n    examples {\n      message\n      useCaseId\n      score\n      confidence\n    }\n  }\n}\n    ";
 export declare const AiAgentKnowledgeBasesDocument = "\n    query aiAgentKnowledgeBases {\n  aiAgentKnowledgeBases {\n    id\n    title\n    isPublic\n  }\n}\n    ";

package/src/sdks/ai.js

@@ -1,9 +1,19 @@
 "use strict";
 /* istanbul ignore file */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RemoveAiAgentProcedureDocument = exports.RemoveAiAgentUseCaseDocument = exports.SaveAiAgentProcedureDocument = exports.SaveAiAgentUseCaseDocument = exports.AiAgentConversationOutcomeDocument = exports.AiAgentConversationMetricsDocument = exports.AiAgentRetentionPolicyDocument = exports.SetAiAgentRetentionPolicyDocument = exports.ListAiAgentScenariosDocument = exports.AiAgentTraceDocument = exports.AiAgentUseCaseOverlapDocument = exports.ListAiAgentToolsDocument = exports.ListAiAgentProceduresDocument = exports.ListAiAgentUseCasesDocument = exports.RemoveAiAgentDocument = exports.RemoveAiAgentVersionDocument = exports.RollbackAiAgentVersionDocument = exports.UnpublishAiAgentVersionDocument = exports.PublishAiAgentVersionDocument = exports.DraftAiAgentDocument = exports.AiAgentMetricsByAgentDocument = exports.ListAiAgentVersionsDocument = exports.ListAiAgentsDocument = exports.QnaFragmentFragmentDoc = exports.NlpInstanceFragmentDoc = exports.AiAgentMetricsReportFragmentDoc = exports.AiAgentCheckRunFragmentDoc = exports.AiAgentApprovalFragmentDoc = exports.AiAgentScenarioFragmentDoc = exports.AiAgentTraceFragmentDoc = exports.AiAgentToolFragmentDoc = exports.AiAgentProcedureFragmentDoc = exports.AiAgentUseCaseFragmentDoc = exports.AiAgentListingMetricsFragmentDoc = exports.AiAgentVersionWithSpecFragmentDoc = exports.AiAgentToolExclusionFragmentDoc = exports.AiAgentSpecFragmentDoc = exports.AiAgentVersionFragmentDoc = exports.AiAgentSummaryFragmentDoc = exports.Typenames = exports.ToolParameterType = exports.ToolEffect = exports.ToolAvailability = exports.TonePreset = exports.ParameterGrounding = exports.Can = exports.BudgetExceededAction = exports.AppInstanceStatus = exports.AiAgentVersionStatus = exports.AiAgentCheckRunStatus = void 0;
-exports.serviceName = exports.RemoveQnAInstanceDocument = exports.UpdateQnAInstanceDocument = exports.CreateQnAInstanceDocument = exports.TestQnAInstanceDocument = exports.ListQnAInstancesDocument = exports.GetQnAInstanceDocument = exports.TestNlpInstanceDocument = exports.RemoveNlpInstanceDocument = exports.UpdateNlpInstanceDocument = exports.CreateNlpInstanceDocument = exports.ListNlpInstancesDocument = exports.GetNlpInstanceDocument = exports.ExtractImageMetadataDocument = exports.AiAgentKnowledgeBasesDocument = exports.AiAgentRoutingPreviewDocument = exports.AiAgentVersionSpecDocument = exports.AiAgentMetricsDocument = exports.AiAgentCheckLimitsDocument = exports.GetAiAgentCheckRunDocument = exports.CheckAiAgentVersionDocument = exports.SaveAiAgentScenarioDocument = exports.RemoveAiAgentScenarioDocument = exports.UnregisterAiAgentToolDocument = exports.RegisterAiAgentToolDocument = exports.ResolveAiAgentApprovalDocument = exports.ListAiAgentApprovalsDocument = exports.RememberAiAgentSessionFactsDocument = void 0;
+exports.ListAiAgentToolsDocument = exports.ListAiAgentProceduresDocument = exports.ListAiAgentUseCasesDocument = exports.RemoveAiAgentDocument = exports.RemoveAiAgentVersionDocument = exports.RollbackAiAgentVersionDocument = exports.UnpublishAiAgentVersionDocument = exports.PublishAiAgentVersionDocument = exports.DraftAiAgentDocument = exports.AiAgentMetricsByAgentDocument = exports.ListAiAgentVersionsDocument = exports.ListAiAgentsDocument = exports.QnaFragmentFragmentDoc = exports.NlpInstanceFragmentDoc = exports.AiAgentMetricsReportFragmentDoc = exports.AiAgentCheckRunFragmentDoc = exports.AiAgentApprovalFragmentDoc = exports.AiAgentScenarioFragmentDoc = exports.AiAgentTraceFragmentDoc = exports.AiAgentToolFragmentDoc = exports.AiAgentProcedureFragmentDoc = exports.AiAgentUseCaseFragmentDoc = exports.AiAgentListingMetricsFragmentDoc = exports.AiAgentVersionWithSpecFragmentDoc = exports.AiAgentToolExclusionFragmentDoc = exports.AiAgentSpecFragmentDoc = exports.AiAgentVersionFragmentDoc = exports.AiAgentSummaryFragmentDoc = exports.Typenames = exports.ToolParameterType = exports.ToolEffect = exports.ToolAvailability = exports.TonePreset = exports.ParameterGrounding = exports.Can = exports.BudgetExceededAction = exports.AppInstanceStatus = exports.AiAgentVersionStatus = exports.AiAgentTechnicalFailure = exports.AiAgentSentiment = exports.AiAgentScoreBand = exports.AiAgentRiskAlert = exports.AiAgentHandoffReason = exports.AiAgentConversationSubcategory = exports.AiAgentConversationState = exports.AiAgentConversationClass = exports.AiAgentContactReasonSource = exports.AiAgentCheckRunStatus = exports.AiAgentChannelType = exports.AiAgentAnalysisFailureReason = void 0;
+exports.serviceName = exports.RemoveQnAInstanceDocument = exports.UpdateQnAInstanceDocument = exports.CreateQnAInstanceDocument = exports.TestQnAInstanceDocument = exports.ListQnAInstancesDocument = exports.GetQnAInstanceDocument = exports.TestNlpInstanceDocument = exports.RemoveNlpInstanceDocument = exports.UpdateNlpInstanceDocument = exports.CreateNlpInstanceDocument = exports.ListNlpInstancesDocument = exports.GetNlpInstanceDocument = exports.ExtractImageMetadataDocument = exports.AiAgentKnowledgeBasesDocument = exports.AiAgentRoutingPreviewDocument = exports.AiAgentVersionSpecDocument = exports.AiAgentMetricsDocument = exports.AiAgentCheckLimitsDocument = exports.GetAiAgentCheckRunDocument = exports.CheckAiAgentVersionDocument = exports.SaveAiAgentScenarioDocument = exports.RemoveAiAgentScenarioDocument = exports.UnregisterAiAgentToolDocument = exports.RegisterAiAgentToolDocument = exports.ResolveAiAgentApprovalDocument = exports.ListAiAgentApprovalsDocument = exports.RememberAiAgentSessionFactsDocument = exports.RemoveAiAgentProcedureDocument = exports.RemoveAiAgentUseCaseDocument = exports.SaveAiAgentProcedureDocument = exports.SaveAiAgentUseCaseDocument = exports.AiAgentConversationOutcomeDocument = exports.AiAgentConversationMetricsDocument = exports.AiAgentRetentionPolicyDocument = exports.SetAiAgentRetentionPolicyDocument = exports.ListAiAgentScenariosDocument = exports.AiAgentTraceDocument = exports.AiAgentUseCaseOverlapDocument = void 0;
 exports.getSdk = getSdk;
+var AiAgentAnalysisFailureReason;
+(function (AiAgentAnalysisFailureReason) {
+    AiAgentAnalysisFailureReason["InvalidReply"] = "invalid_reply";
+    AiAgentAnalysisFailureReason["ModelError"] = "model_error";
+})(AiAgentAnalysisFailureReason || (exports.AiAgentAnalysisFailureReason = AiAgentAnalysisFailureReason = {}));
+var AiAgentChannelType;
+(function (AiAgentChannelType) {
+    AiAgentChannelType["Web"] = "web";
+    AiAgentChannelType["Whatsapp"] = "whatsapp";
+})(AiAgentChannelType || (exports.AiAgentChannelType = AiAgentChannelType = {}));
 var AiAgentCheckRunStatus;
 (function (AiAgentCheckRunStatus) {
     AiAgentCheckRunStatus["Failed"] = "failed";
@@ -11,6 +21,84 @@ var AiAgentCheckRunStatus;
     AiAgentCheckRunStatus["Running"] = "running";
     AiAgentCheckRunStatus["Succeeded"] = "succeeded";
 })(AiAgentCheckRunStatus || (exports.AiAgentCheckRunStatus = AiAgentCheckRunStatus = {}));
+var AiAgentContactReasonSource;
+(function (AiAgentContactReasonSource) {
+    AiAgentContactReasonSource["Agent"] = "agent";
+    AiAgentContactReasonSource["Analysis"] = "analysis";
+})(AiAgentContactReasonSource || (exports.AiAgentContactReasonSource = AiAgentContactReasonSource = {}));
+var AiAgentConversationClass;
+(function (AiAgentConversationClass) {
+    AiAgentConversationClass["NaoElegivel"] = "NAO_ELEGIVEL";
+    AiAgentConversationClass["NaoResolvida"] = "NAO_RESOLVIDA";
+    AiAgentConversationClass["Resolvida"] = "RESOLVIDA";
+})(AiAgentConversationClass || (exports.AiAgentConversationClass = AiAgentConversationClass = {}));
+var AiAgentConversationState;
+(function (AiAgentConversationState) {
+    AiAgentConversationState["EmAndamento"] = "EM_ANDAMENTO";
+    AiAgentConversationState["EncerradaPorConclusao"] = "ENCERRADA_POR_CONCLUSAO";
+    AiAgentConversationState["EncerradaPorFalhaTecnica"] = "ENCERRADA_POR_FALHA_TECNICA";
+    AiAgentConversationState["EncerradaPorInatividade"] = "ENCERRADA_POR_INATIVIDADE";
+    AiAgentConversationState["EncerradaPorTeto"] = "ENCERRADA_POR_TETO";
+    AiAgentConversationState["EncerradaPorTransbordo"] = "ENCERRADA_POR_TRANSBORDO";
+})(AiAgentConversationState || (exports.AiAgentConversationState = AiAgentConversationState = {}));
+var AiAgentConversationSubcategory;
+(function (AiAgentConversationSubcategory) {
+    AiAgentConversationSubcategory["AbandonoAposEsclarecimento"] = "ABANDONO_APOS_ESCLARECIMENTO";
+    AiAgentConversationSubcategory["EncerradaPorTeto"] = "ENCERRADA_POR_TETO";
+    AiAgentConversationSubcategory["FalhaTecnica"] = "FALHA_TECNICA";
+    AiAgentConversationSubcategory["Indefinido"] = "INDEFINIDO";
+    AiAgentConversationSubcategory["InterlocutorAutomatico"] = "INTERLOCUTOR_AUTOMATICO";
+    AiAgentConversationSubcategory["PromptInjection"] = "PROMPT_INJECTION";
+    AiAgentConversationSubcategory["ResolvidaConfirmada"] = "RESOLVIDA_CONFIRMADA";
+    AiAgentConversationSubcategory["ResolvidaPresumida"] = "RESOLVIDA_PRESUMIDA";
+    AiAgentConversationSubcategory["SaudacaoSemDemanda"] = "SAUDACAO_SEM_DEMANDA";
+    AiAgentConversationSubcategory["SemCobertura"] = "SEM_COBERTURA";
+    AiAgentConversationSubcategory["SemConhecimento"] = "SEM_CONHECIMENTO";
+    AiAgentConversationSubcategory["TransbordoPorAutodiagnostico"] = "TRANSBORDO_POR_AUTODIAGNOSTICO";
+    AiAgentConversationSubcategory["TransbordoPorNecessidadeCliente"] = "TRANSBORDO_POR_NECESSIDADE_CLIENTE";
+    AiAgentConversationSubcategory["TransbordoPorProcedimento"] = "TRANSBORDO_POR_PROCEDIMENTO";
+})(AiAgentConversationSubcategory || (exports.AiAgentConversationSubcategory = AiAgentConversationSubcategory = {}));
+var AiAgentHandoffReason;
+(function (AiAgentHandoffReason) {
+    AiAgentHandoffReason["BudgetExceeded"] = "budget_exceeded";
+    AiAgentHandoffReason["CannotResolve"] = "cannot_resolve";
+    AiAgentHandoffReason["CustomerRequest"] = "customer_request";
+    AiAgentHandoffReason["KnowledgeGap"] = "knowledge_gap";
+    AiAgentHandoffReason["OutOfScope"] = "out_of_scope";
+    AiAgentHandoffReason["PeriodBudgetExceeded"] = "period_budget_exceeded";
+    AiAgentHandoffReason["PolicyRequiresHuman"] = "policy_requires_human";
+    AiAgentHandoffReason["ProviderUnavailable"] = "provider_unavailable";
+    AiAgentHandoffReason["ToolFailure"] = "tool_failure";
+    AiAgentHandoffReason["Undeclared"] = "undeclared";
+    AiAgentHandoffReason["Unresolved"] = "unresolved";
+})(AiAgentHandoffReason || (exports.AiAgentHandoffReason = AiAgentHandoffReason = {}));
+var AiAgentRiskAlert;
+(function (AiAgentRiskAlert) {
+    AiAgentRiskAlert["Cancelamento"] = "cancelamento";
+    AiAgentRiskAlert["Justica"] = "justica";
+    AiAgentRiskAlert["Procon"] = "procon";
+    AiAgentRiskAlert["ReclameAqui"] = "reclame_aqui";
+})(AiAgentRiskAlert || (exports.AiAgentRiskAlert = AiAgentRiskAlert = {}));
+var AiAgentScoreBand;
+(function (AiAgentScoreBand) {
+    AiAgentScoreBand["Bom"] = "bom";
+    AiAgentScoreBand["Excelente"] = "excelente";
+    AiAgentScoreBand["Regular"] = "regular";
+    AiAgentScoreBand["Ruim"] = "ruim";
+})(AiAgentScoreBand || (exports.AiAgentScoreBand = AiAgentScoreBand = {}));
+var AiAgentSentiment;
+(function (AiAgentSentiment) {
+    AiAgentSentiment["Negativo"] = "negativo";
+    AiAgentSentiment["Neutro"] = "neutro";
+    AiAgentSentiment["Positivo"] = "positivo";
+})(AiAgentSentiment || (exports.AiAgentSentiment = AiAgentSentiment = {}));
+var AiAgentTechnicalFailure;
+(function (AiAgentTechnicalFailure) {
+    AiAgentTechnicalFailure["Erro_5Xx"] = "ERRO_5XX";
+    AiAgentTechnicalFailure["FerramentaIndisponivel"] = "FERRAMENTA_INDISPONIVEL";
+    AiAgentTechnicalFailure["LimiteOperacional"] = "LIMITE_OPERACIONAL";
+    AiAgentTechnicalFailure["Timeout"] = "TIMEOUT";
+})(AiAgentTechnicalFailure || (exports.AiAgentTechnicalFailure = AiAgentTechnicalFailure = {}));
 var AiAgentVersionStatus;
 (function (AiAgentVersionStatus) {
     AiAgentVersionStatus["Draft"] = "draft";
@@ -71,6 +159,7 @@ var Typenames;
     Typenames["AiAgentAnswerCache"] = "AiAgentAnswerCache";
     Typenames["AiAgentApproval"] = "AiAgentApproval";
     Typenames["AiAgentCheckRun"] = "AiAgentCheckRun";
+    Typenames["AiAgentConversationAnalysis"] = "AiAgentConversationAnalysis";
     Typenames["AiAgentEvalReport"] = "AiAgentEvalReport";
     Typenames["AiAgentProcedure"] = "AiAgentProcedure";
     Typenames["AiAgentRetentionPolicy"] = "AiAgentRetentionPolicy";
@@ -174,6 +263,7 @@ exports.AiAgentUseCaseFragmentDoc = `
   name
   subjectDescription
   procedureId
+  tag
   status
   updatedAt
 }
@@ -331,6 +421,61 @@ exports.AiAgentMetricsReportFragmentDoc = `
   conversationsHandoffRequested
   resolutionRate
   resolutionDefinition
+  conversationsByClassification {
+    key
+    count
+  }
+  conversationsEligible
+  conversationsResolvedByDefinition
+  resolvedRate
+  unresolvedRate
+  handoffProcedureRate
+  handoffNeedRate
+  abandonmentRate
+  classificationDefinitionVersion
+  analyzedConversations
+  estimatedSatisfactionAvg
+  sentimentAtStart {
+    key
+    count
+  }
+  sentimentAtEnd {
+    key
+    count
+  }
+  riskAlerts {
+    key
+    count
+  }
+  topKnowledgeGaps {
+    key
+    count
+  }
+  analysisCostMicroUsd
+  failedAnalyses
+  analysesTruncated
+  agentScoreAvg
+  agentScoreAvgBand
+  agentScoreBands {
+    key
+    count
+  }
+  agentClarityAvg
+  customerEffortScoreAvg
+  contactReasons {
+    all {
+      key
+      count
+    }
+    handoff {
+      key
+      count
+    }
+    abandonment {
+      key
+      count
+    }
+  }
   escalatedToHuman
   escalatedToFlow
   escalatedTargetUndeclared
@@ -573,6 +718,12 @@ exports.AiAgentConversationMetricsDocument = `
     costMicroUsd
     durationMs
     lastOutcome
+    state
+    status
+    subcategory
+    contactReason
+    contactReasonTag
+    channelType
   }
 }
     `;
@@ -590,6 +741,59 @@ exports.AiAgentConversationOutcomeDocument = `
     startedAt
     lastTurnAt
     haltReason
+    handoffReason
+    agentSummary
+    promisedNextStep
+    classification {
+      state
+      classification
+      subcategory
+      technicalFailure
+      eligibleForResolution
+      consumesAllowance
+      inactivityWindowMs
+      definitionVersion
+    }
+    channelType
+    actions {
+      toolId
+      name
+      ok
+      result
+      at
+    }
+    contactReason {
+      name
+      useCaseId
+      tag
+      other
+      source
+    }
+    analysis {
+      analysisVersion
+      failed
+      failureReason
+      sentimentStart
+      sentimentEnd
+      estimatedSatisfaction
+      riskAlerts
+      knowledgeGaps
+      repeatedInformation
+      humanRequests
+      contactReason
+      contactReasonId
+      contactReasonTag
+      contactReasonOther
+      contactReasonSource
+      summary
+      agentScore
+      agentScoreBand
+      agentClarity
+      customerEffortScore
+      model
+      costMicroUsd
+      analyzedAt
+    }
   }
 }
     `;