@droz-js/sdk 0.25.19 → 0.25.21

package/src/sdks/ai.d.ts

@@ -138,9 +138,12 @@ export type AiAgentApproval = {
     customerId?: Maybe<Scalars['String']['output']>;
     decidedAt?: Maybe<Scalars['Number']['output']>;
     decidedBy?: Maybe<Scalars['String']['output']>;
+    /** Epoch ms. Depois disso a pendencia nao pode mais ser decidida. */
     expiresAt: Scalars['Number']['output'];
+    /** Epoch ms. Junto de `sessionId`, identifica a pendencia em `resolveAiAgentApproval`. */
     requestedAt: Scalars['Number']['output'];
     sessionId: Scalars['ID']['output'];
+    /** `pending`, `approved`, `rejected` ou `expired`. */
     status: Scalars['String']['output'];
     toolId: Scalars['ID']['output'];
     toolName: Scalars['String']['output'];
@@ -150,9 +153,19 @@ export type AiAgentAuthoringRefInput = {
     id: Scalars['ID']['input'];
 };
 export type AiAgentBudget = {
+    /**
+     * Teto de gasto da conversa em micro-dolar (1e-6 USD). So vale para chamada com preco conhecido:
+     * modelo fora da tabela de preco produz custo desconhecido, nunca zero. Combine com `maxTokens`,
+     * que sempre vale.
+     */
     maxCostMicroUsd?: Maybe<Scalars['Int']['output']>;
+    /**
+     * Teto de gasto do agente no periodo (mes calendario UTC), em micro-dolar. Ausente = sem teto de
+     * periodo. Independe de `maxCostMicroUsd`, que vale por conversa.
+     */
     maxPeriodCostMicroUsd?: Maybe<Scalars['Int']['output']>;
     maxSteps: Scalars['Int']['output'];
+    /** Teto de token da conversa inteira. Ausente = sem teto de token. */
     maxTokens?: Maybe<Scalars['Int']['output']>;
     maxToolCalls: Scalars['Int']['output'];
     onExceeded: BudgetExceededAction;
@@ -186,34 +199,36 @@ export declare enum AiAgentChannelType {
     Web = "web",
     Whatsapp = "whatsapp"
 }
-export type AiAgentCheckAuthoring = {
-    procedures: Scalars['Int']['output'];
-    updatedAt?: Maybe<Scalars['Number']['output']>;
-    useCases: Scalars['Int']['output'];
-};
 export type AiAgentCheckLimits = {
+    /** Já dividido pelos cenários deste agente: é o maior valor que a suíte dele sustenta. */
     maxRunsPerScenario: Scalars['Int']['output'];
+    /** Teto do total, cenários × execuções. */
     maxSuiteRuns: Scalars['Int']['output'];
     minRunsPerScenario: Scalars['Int']['output'];
     scenarioCount: Scalars['Int']['output'];
 };
 export type AiAgentCheckResult = {
-    authoring?: Maybe<AiAgentCheckAuthoring>;
     regressions: Array<AiAgentRegression>;
     reports: Array<AiAgentScenarioReport>;
+    /** Falso quando um cenário piorou além da tolerância em relação à versão live. */
     safeToPublish: Scalars['Boolean']['output'];
 };
 export type AiAgentCheckRun = {
     agentId: Scalars['ID']['output'];
+    /** Execuções já terminadas. Avança durante a suíte, não só no fim. */
     completedRuns: Scalars['Int']['output'];
+    /** Presente só quando a execução falhou. */
     error?: Maybe<Scalars['String']['output']>;
+    /** Ferramentas vinculadas que a versão avaliada não oferece ao modelo, pelo catálogo atual. Nulo quando a versão foi removida. */
     excludedTools?: Maybe<Array<AiAgentToolExclusion>>;
     finishedAt?: Maybe<Scalars['Number']['output']>;
     requestedAt: Scalars['Number']['output'];
+    /** Presente só quando a execução terminou bem. */
     result?: Maybe<AiAgentCheckResult>;
     runId: Scalars['ID']['output'];
     startedAt?: Maybe<Scalars['Number']['output']>;
     status: AiAgentCheckRunStatus;
+    /** Execuções que a suíte terá ao todo, definido no momento do pedido. */
     totalRuns: Scalars['Int']['output'];
     version: Scalars['Int']['output'];
 };
@@ -232,10 +247,13 @@ export type AiAgentClassificationCount = {
 export type AiAgentCompetingPair = {
     left: Scalars['ID']['output'];
     right: Scalars['ID']['output'];
+    /** 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` ou `Outro`. Analise anterior a versao 2 pode trazer `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']>;
@@ -254,12 +272,14 @@ 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'];
@@ -269,17 +289,21 @@ export type AiAgentConversationAnalysis = {
     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 {
@@ -288,6 +312,7 @@ export declare enum AiAgentConversationClass {
     Unresolved = "UNRESOLVED"
 }
 export type AiAgentConversationClassification = {
+    /** Ausente enquanto a conversa esta em andamento. */
     classification?: Maybe<AiAgentConversationClass>;
     consumesAllowance: Scalars['Boolean']['output'];
     definitionVersion: Scalars['String']['output'];
@@ -315,6 +340,7 @@ export type AiAgentConversationMetrics = {
     channelType?: Maybe<AiAgentChannelType>;
     contactReason?: Maybe<Scalars['String']['output']>;
     contactReasonTag?: Maybe<Scalars['String']['output']>;
+    /** Ausente quando a sessão não tem conversa registrada: a linha cobre a sessão inteira. */
     conversationId?: Maybe<Scalars['ID']['output']>;
     costMicroUsd: Scalars['Number']['output'];
     durationMs: Scalars['Number']['output'];
@@ -352,33 +378,49 @@ export type AiAgentConversationMetricsInput = {
     useCaseId?: InputMaybe<Array<Scalars['ID']['input']>>;
 };
 export type AiAgentConversationMetricsPage = {
+    /** Intervalo de `lastTurnAt` do conjunto filtrado pelos outros filtros, sem `dateFrom` e `dateTo`. Ausente quando o conjunto é vazio. */
     dateRange?: Maybe<AiAgentConversationDateRange>;
+    /** Cada faceta conta sobre o conjunto filtrado pelos outros filtros, sem o seu próprio. */
     facets: Array<AiAgentConversationFacet>;
+    /** true quando há conversa com alerta de risco no conjunto filtrado pelos outros filtros, sem `hasRiskAlert`. Mesma base do facet `riskAlert`. */
     hasRiskAlerts: Scalars['Boolean']['output'];
     items: Array<AiAgentConversationMetrics>;
     limit: Scalars['Number']['output'];
     offset: Scalars['Number']['output'];
     total: Scalars['Number']['output'];
+    /** true quando o teto de leitura foi atingido: a página cobre parte do período. */
     truncated: Scalars['Boolean']['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>;
+    /**
+     * Presente quando a ficha foi pedida por conversa: turnos, classificação e resolução só dela. A análise é
+     * gravada por sessão e só vem na última conversa da sessão.
+     */
     conversationId?: Maybe<Scalars['ID']['output']>;
+    /** 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<AiAgentHandoffReason>;
     lastTurnAt: Scalars['Number']['output'];
+    /** O que o agente disse ao consumidor que vai acontecer. */
     promisedNextStep?: Maybe<Scalars['String']['output']>;
     resolution: Scalars['String']['output'];
     resolutionDefinition: Scalars['String']['output'];
+    /** Fim da janela de reversão por recontato. Ausente quando a conversa não reverte. */
     reversibleUntil?: Maybe<Scalars['Number']['output']>;
     sessionId: Scalars['ID']['output'];
     startedAt: Scalars['Number']['output'];
@@ -440,8 +482,10 @@ export declare enum AiAgentConversationSubcategory {
 }
 export type AiAgentDashboard = {
     abandonment: AiAgentDashboardIndicator;
+    /** Absent when no dispatch was sent in the window. Absent is not zero. */
     activeDispatches?: Maybe<AiAgentDashboardActiveDispatches>;
     agentId: Scalars['ID']['output'];
+    /** Absent when no conversation was analyzed in the window. Absent is not zero. */
     agentScoreAvg?: Maybe<Scalars['Float']['output']>;
     agentScoreAvgBand?: Maybe<AiAgentScoreBand>;
     analysesTruncated: Scalars['Boolean']['output'];
@@ -453,6 +497,7 @@ export type AiAgentDashboard = {
     conversationsProvisional: Scalars['Number']['output'];
     handoffNeed: AiAgentDashboardIndicator;
     handoffProcedure: AiAgentDashboardIndicator;
+    /** Do agente, não da janela. Vira true na primeira conversa aberta pela resposta a um disparo ativo. */
     hasActiveDispatches: Scalars['Boolean']['output'];
     knowledgeGaps: Array<AiAgentDashboardKnowledgeGap>;
     previousWindow: AiAgentDashboardWindow;
@@ -463,15 +508,18 @@ export type AiAgentDashboard = {
     sentimentAtStart: Array<AiAgentDashboardSentiment>;
     series: Array<AiAgentDashboardSeriesPoint>;
     timezone: Scalars['String']['output'];
+    /** true when the numbers cover part of the period: the read cap was reached in any window, or the search index does not cover the whole window. */
     truncated: Scalars['Boolean']['output'];
     unresolved: AiAgentDashboardIndicator;
     window: AiAgentDashboardWindow;
 };
+/** `answered` and `unanswered` are the share of the dispatches whose window is closed, one decimal. Absent while none is closed. */
 export type AiAgentDashboardActiveDispatches = {
     answered: AiAgentDashboardIndicator;
     sent: AiAgentDashboardIndicator;
     unanswered: AiAgentDashboardIndicator;
 };
+/** Sorted by count, highest first. */
 export type AiAgentDashboardContactReason = {
     count: Scalars['Number']['output'];
     key: Scalars['String']['output'];
@@ -482,6 +530,7 @@ export type AiAgentDashboardContactReasons = {
     all: Array<AiAgentDashboardContactReason>;
     handoff: Array<AiAgentDashboardContactReason>;
 };
+/** `value` is absent when the window has no data. */
 export type AiAgentDashboardIndicator = {
     polarity: AiAgentMetricPolarity;
     value?: Maybe<Scalars['Float']['output']>;
@@ -494,17 +543,20 @@ export type AiAgentDashboardInput = {
     timezone: Scalars['String']['input'];
     to: Scalars['Number']['input'];
 };
+/** Counted once per conversation. `level` is over the conversations that consulted the knowledge base. */
 export type AiAgentDashboardKnowledgeGap = {
     count: Scalars['Number']['output'];
     key: Scalars['String']['output'];
     level: AiAgentFrequencyLevel;
 };
+/** The procedure of the use case assigned to each conversation. `level` is over all conversations of the window. */
 export type AiAgentDashboardProcedure = {
     count: Scalars['Number']['output'];
     key: Scalars['ID']['output'];
     level: AiAgentFrequencyLevel;
     name: Scalars['String']['output'];
 };
+/** `percent` is the share of the band in the window total, with one decimal. Absent when the total is zero. */
 export type AiAgentDashboardScoreBand = {
     band: AiAgentScoreBand;
     count: Scalars['Number']['output'];
@@ -519,6 +571,7 @@ export type AiAgentDashboardSentiment = {
     sentiment: AiAgentSentiment;
     variation: AiAgentVariation;
 };
+/** `date` and `endDate` are local dates (YYYY-MM-DD) of the first and last day of the bucket, inside the window. */
 export type AiAgentDashboardSeriesPoint = {
     abandonmentRate?: Maybe<Scalars['Number']['output']>;
     conversations: Scalars['Number']['output'];
@@ -541,12 +594,22 @@ export declare enum AiAgentExecutionAutonomy {
     Autonomous = "autonomous",
     NeedsApproval = "needsApproval"
 }
+/** Selo de frequência de um item das listas do dashboard: Muito frequente, Frequente ou Pouco frequente. */
 export declare enum AiAgentFrequencyLevel {
     Frequent = "FREQUENT",
     Rare = "RARE",
     VeryFrequent = "VERY_FREQUENT"
 }
+/**
+ * Como este agente passa o atendimento para uma pessoa.
+ *
+ * A transicao vive no fluxo do tenant — e a state machine dele que sabe qual estado atende gente —,
+ * por isso e configuracao e nao constante da plataforma. Ausente significa que o agente nao passa
+ * para ninguem: ele diz que o caso precisa de uma pessoa e usa o comportamento fora de escopo do
+ * autor para dizer onde procura-la, em vez de prometer transferencia que nao acontece.
+ */
 export type AiAgentHandoff = {
+    /** `human` ou `flow`. Ausente = nao declarado: a metrica conta a parte, sem supor destino. */
     target?: Maybe<Scalars['String']['output']>;
     transition: Scalars['String']['output'];
 };
@@ -606,51 +669,98 @@ export declare enum AiAgentMetricPolarity {
     Neutral = "NEUTRAL"
 }
 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
+     * §4.7 — nao prova resposta inventada, mas e onde ela poderia acontecer.
+     */
     answeredWithFailedConnectionTurns: Scalars['Number']['output'];
     avgLlmLatencyMs: Scalars['Number']['output'];
     avgTurnDurationMs: Scalars['Number']['output'];
+    /** Turnos cuja resposta foi bloqueada na validacao antes do envio. */
     blockedTurns: Scalars['Number']['output'];
     blocksByCategory: Array<AiAgentMetricsCount>;
     budgetExceededTurns: Scalars['Number']['output'];
+    /**
+     * Entrada servida pelo cache do proprio provedor: quanto do contexto nao foi pago a preco cheio.
+     * Provedor que nao reporta cache vale zero.
+     */
     cachedInputTokens: Scalars['Number']['output'];
+    /** Turnos respondidos pelo cache, sem chamada ao modelo. E o ganho da otimizacao de §4.9. */
     cachedTurns: Scalars['Number']['output'];
     classificationBreakdown: Array<AiAgentClassificationCount>;
+    /** Versão da definição que classificou as conversas da janela. Mais de uma vem separada por vírgula, da mais nova para a mais antiga. */
     classificationDefinitionVersion: Scalars['String']['output'];
     classificationDefinitionVersions: Array<AiAgentMetricsCount>;
     contactReasons: AiAgentContactReasons;
+    /** Conversas com turno na janela. Uma sessão pode ter mais de uma conversa. */
     conversations: Scalars['Number']['output'];
     conversationsAwaitingClassification: Scalars['Number']['output'];
+    /** @deprecated A chave junta subcategoria e falha tecnica numa string. Use classificationBreakdown. */
+    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.
+     */
     conversationsHandoffRequested: Scalars['Number']['output'];
+    /**
+     * Nem uma nem outra: parou por prazo, por repeticao, ou ainda esta acontecendo. Existe para nao
+     * inflar a resolucao — contar "nao transferiu" como "resolveu" transformaria conversa abandonada
+     * em sucesso.
+     */
     conversationsInconclusive: Scalars['Number']['output'];
     conversationsProvisional: 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'];
+    /**
+     * Gasto da janela dividido pelas conversas resolvidas, em micro-dolar. **Ausente** quando nenhuma
+     * 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.
+     */
     escalatedTargetUndeclared: Scalars['Number']['output'];
+    /** Escalonamentos cujo destino o autor declarou como fluxo. */
     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<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. */
     identificationRequiredTurns: Scalars['Number']['output'];
     inputTokens: Scalars['Number']['output'];
     knowledgeEmpty: Scalars['Number']['output'];
@@ -660,29 +770,50 @@ export type AiAgentMetrics = {
     llmCalls: Scalars['Number']['output'];
     outputTokens: Scalars['Number']['output'];
     p95TurnDurationMs: Scalars['Number']['output'];
+    /** A regra aplicada para contar resolucao, junto do numero, para ele nao ser lido como cada um quiser. */
     resolutionDefinition: Scalars['String']['output'];
-    /** @deprecated Regra v2, por sessão. Use resolvedRate, por conversa e pela classificação da conversa. */
+    /**
+     * Sessões resolvidas pela regra v2 sobre o total de sessões, em pontos percentuais. **Ausente** quando não
+     * houve sessão na janela: sem dado e zero por cento não são a mesma coisa.
+     * @deprecated Regra v2, por sessão. Use resolvedRate, por conversa e pela classificação da conversa.
+     */
     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. */
     toolCallsFailed: Scalars['Number']['output'];
+    /** Falhas por classe, com os valores de `AiAgentTracedToolCall.errorClass`. */
     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. */
     topUnansweredQuestions: Array<AiAgentMetricsCount>;
     totalTokens: Scalars['Number']['output'];
+    /** true quando o teto de leitura foi atingido: os numeros cobrem parte do periodo. */
     truncated: Scalars['Boolean']['output'];
     turns: Scalars['Number']['output'];
     turnsByModel: Array<AiAgentMetricsCount>;
-    turnsByModelAndReasoningEffort: Array<AiAgentMetricsCount>;
+    /**
+     * A regra aplicada para contar turno sem resposta, junto do numero, para ele nao ser lido como cada
+     * um quiser. Deterministica: qualidade da resposta nao e medivel aqui.
+     */
     unansweredDefinition: Scalars['String']['output'];
+    /** Turnos sem resposta satisfatoria sob a regra declarada em `unansweredDefinition`. */
     unansweredTurns: Scalars['Number']['output'];
+    /**
+     * Turnos com ao menos uma chamada ao modelo sem preco conhecido. Com isto > 0, `costMicroUsd` e
+     * **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 declare enum AiAgentMetricsBucket {
@@ -701,8 +832,10 @@ export type AiAgentMetricsInput = {
 };
 export type AiAgentMetricsSeries = {
     points: Array<AiAgentMetricsSeriesPoint>;
+    /** true quando o teto de leitura foi atingido: a série cobre parte do período. */
     truncated: Scalars['Boolean']['output'];
 };
+/** IANA name of the viewer time zone, e.g. America/Sao_Paulo. A week starts on Monday. */
 export type AiAgentMetricsSeriesInput = {
     agentId: Scalars['ID']['input'];
     bucket: AiAgentMetricsBucket;
@@ -719,11 +852,13 @@ export type AiAgentMetricsSeriesPoint = {
     conversationsHandoffNeed: Scalars['Number']['output'];
     conversationsResolved: Scalars['Number']['output'];
     conversationsUnresolved: Scalars['Number']['output'];
+    /** Local date (YYYY-MM-DD) of the first day of the bucket. */
     date: Scalars['String']['output'];
     handoffNeedRate?: Maybe<Scalars['Number']['output']>;
     resolvedRate?: Maybe<Scalars['Number']['output']>;
     unresolvedRate?: Maybe<Scalars['Number']['output']>;
 };
+/** A mesma janela, sem agente: a listagem quer todos de uma vez. */
 export type AiAgentMetricsWindowInput = {
     channel?: InputMaybe<Scalars['String']['input']>;
     from: Scalars['Number']['input'];
@@ -737,11 +872,13 @@ export type AiAgentProcedure = {
     endsConversationAfterInforming: Scalars['Boolean']['output'];
     executionAutonomy: AiAgentExecutionAutonomy;
     expiredReplyTemplate?: Maybe<Scalars['String']['output']>;
+    /** As etapas como o autor instruiria uma pessoa. O texto e a fonte da verdade (§6.2). */
     guidanceSteps: Array<Scalars['String']['output']>;
     id: Scalars['ID']['output'];
     name: Scalars['String']['output'];
     replyEmailSubject?: Maybe<Scalars['String']['output']>;
     status: Scalars['String']['output'];
+    /** Ferramentas que as etapas usam. Declaradas: e o que da para validar sem interpretar o texto. */
     toolIds: Array<Scalars['ID']['output']>;
     updatedAt: Scalars['Number']['output'];
 };
@@ -753,11 +890,6 @@ export type AiAgentRegression = {
     before: Scalars['Float']['output'];
     scenarioId: Scalars['ID']['output'];
 };
-export type AiAgentRejectedCall = {
-    count: Scalars['Int']['output'];
-    reason: Scalars['String']['output'];
-    toolName: Scalars['String']['output'];
-};
 export type AiAgentRetentionDays = {
     long_term_memory: Scalars['Int']['output'];
     session_state: Scalars['Int']['output'];
@@ -787,47 +919,72 @@ export type AiAgentRiskAlertCount = {
     key: AiAgentRiskAlert;
 };
 export type AiAgentRoutedExample = {
+    /** `high`, `medium` ou `low`. */
     confidence: Scalars['String']['output'];
     message: Scalars['String']['output'];
     score: Scalars['Number']['output'];
+    /** Ausente quando nenhum caso de uso reconheceu a mensagem. */
     useCaseId?: Maybe<Scalars['ID']['output']>;
 };
 export type AiAgentRoutingPreview = {
     examples: Array<AiAgentRoutedExample>;
+    /** Limiar de confianca alta. */
     high: Scalars['Number']['output'];
+    /** Limiar de confianca media; abaixo dele a previa nao aponta caso de uso. */
     medium: Scalars['Number']['output'];
 };
 export type AiAgentRoutingPreviewInput = {
     agentId: Scalars['ID']['input'];
+    /** Mensagens a testar. Vazio cai em `subject`; sem os dois, previa vazia e nao erro. */
     examples: Array<Scalars['String']['input']>;
+    /** Descricao do assunto: as mensagens sao geradas a partir dela (§5.4). Ignorada se `examples` vier. */
     subject?: InputMaybe<Scalars['String']['input']>;
 };
 export type AiAgentScenario = {
+    /** Quem é o cliente nesta conversa. Ausente roda como anônimo. */
     customerId?: Maybe<Scalars['ID']['output']>;
     description: Scalars['String']['output'];
     expectations: Array<Scalars['JSON']['output']>;
     scenarioId: Scalars['ID']['output'];
+    /** O que o cliente diz, em ordem. */
     turns: Array<Scalars['String']['output']>;
 };
 export type AiAgentScenarioReport = {
+    /** Execuções que o prazo interrompeu antes de poderem ser julgadas. */
     cut: Scalars['Int']['output'];
+    /**
+     * Por que a conversa foi para uma pessoa, contado entre as execuções julgadas. Os motivos declarados
+     * pelo agente (`customer_request`, `out_of_scope`, `knowledge_gap`, `policy_requires_human`,
+     * `cannot_resolve`) são entrega por decisão dele; `provider_unavailable` e `unresolved` são desistência.
+     * A taxa sozinha não separa as duas.
+     */
     handoffReasons: Array<AiAgentMetricsCount>;
+    /** Execuções efetivamente julgadas. Zero significa que este cenário não produziu evidência. */
     measured: Scalars['Int']['output'];
     passed: Scalars['Int']['output'];
+    /** Fração das execuções MEDIDAS em que todas as expectativas valeram, 0..1. Sem sentido com measured 0. */
     rate: Scalars['Float']['output'];
     runs: Scalars['Int']['output'];
     scenarioId: Scalars['ID']['output'];
+    /** Um item por turno do cenário, na ordem, agregado entre as execuções. */
     turns: Array<AiAgentScenarioTurn>;
 };
 export type AiAgentScenarioTurn = {
+    /** Execuções em que o agente respondeu neste turno. */
     answered: Scalars['Int']['output'];
+    /** Categorias que bloquearam a resposta deste turno, e em quantas execuções. */
     blockCategories: Array<AiAgentMetricsCount>;
+    /** Execuções em que a resposta deste turno foi bloqueada antes do envio. */
     blocked: Scalars['Int']['output'];
+    /** Execuções em que a resposta deste turno se apoiou em conhecimento ou ferramenta. */
     grounded: Scalars['Int']['output'];
+    /** Execuções em que uma ferramenta deste turno foi recusada por falta de cliente identificado. */
     identificationRequired: Scalars['Int']['output'];
-    rejectedCalls?: Maybe<Array<AiAgentRejectedCall>>;
+    /** Execuções que chegaram a este turno. */
     runs: Scalars['Int']['output'];
+    /** Ferramentas chamadas neste turno, e em quantas execuções. */
     toolNames: Array<AiAgentMetricsCount>;
+    /** 1 para o primeiro turno do cenário. */
     turn: Scalars['Int']['output'];
 };
 export declare enum AiAgentScoreBand {
@@ -857,16 +1014,24 @@ 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']>;
     budget: AiAgentBudget;
+    /** One natural-language permission per item. */
     can: Array<Scalars['String']['output']>;
+    /** Restrictions. On conflict these win over `can`, without exception. */
     cannot: Array<Scalars['String']['output']>;
+    /** Canais em que o agente atende. Ausente = ainda nao vinculado; declarado vazio e erro. */
     channels?: Maybe<Array<Scalars['String']['output']>>;
     conversationTiming?: Maybe<Array<AiAgentChannelTiming>>;
     handoff?: Maybe<AiAgentHandoff>;
     identity: AiAgentIdentity;
+    /**
+     * §4.8: bases do Droz Base vinculadas — ids de **space**, nao de credencial. A consulta e recortada
+     * por elas. Vazia, o agente sem nenhum vinculo consulta o acervo do tenant e o agente so-ferramenta
+     * nao consulta nada.
+     */
     knowledgeBaseIds: Array<Scalars['ID']['output']>;
+    /** `inform_limitation` (default) ou `general_knowledge`; ausente vale o mais restritivo. */
     knowledgeFallback?: Maybe<Scalars['String']['output']>;
     toolIds: Array<Scalars['ID']['output']>;
-    typingIndicator?: Maybe<Scalars['Boolean']['output']>;
 };
 export type AiAgentSpecInput = {
     /** @deprecated Ignorado. O tipo da ferramenta sai do método do conector. O campo sai na próxima versão. */
@@ -878,18 +1043,31 @@ export type AiAgentSpecInput = {
     conversationTiming?: InputMaybe<Array<AiAgentChannelTimingInput>>;
     handoff?: InputMaybe<AiAgentHandoffInput>;
     identity: AiAgentIdentityInput;
+    /**
+     * §4.8: bases do Droz Base vinculadas — ids de **space**, nao de credencial. A consulta e recortada
+     * por elas. Vazia, o agente sem nenhum vinculo consulta o acervo do tenant e o agente so-ferramenta
+     * nao consulta nada.
+     */
     knowledgeBaseIds: Array<Scalars['ID']['input']>;
+    /** `inform_limitation` (default) ou `general_knowledge`; ausente vale o mais restritivo. */
     knowledgeFallback?: InputMaybe<Scalars['String']['input']>;
     toolIds: Array<Scalars['ID']['input']>;
-    typingIndicator?: InputMaybe<Scalars['Boolean']['input']>;
 };
 export type AiAgentSummary = {
     agentId: Scalars['ID']['output'];
+    /** Canais da versao no ar; sem versao no ar, os da mais recente. Vazio quando nenhuma declarou canal. */
     channels: Array<Scalars['String']['output']>;
+    /** Absent until a version is published. An agent with no live version answers nobody. */
     liveVersion?: Maybe<Scalars['Int']['output']>;
     name: Scalars['String']['output'];
+    /** Acoes esperando aprovacao humana (§5.5.3). Zero tambem quando a fila nao pode ser lida. */
     queuedApprovals: Scalars['Number']['output'];
+    /**
+     * `draft` (nunca publicado), `live` (no ar) ou `paused` (ja esteve no ar e foi tirado). `liveVersion`
+     * sozinho nao distingue quem nunca publicou de quem foi pausado.
+     */
     status: Scalars['String']['output'];
+    /** Momento da versao mais recente, no ar ou nao — o "ultima alteracao" da listagem. */
     updatedAt: Scalars['Number']['output'];
 };
 export declare enum AiAgentTechnicalFailure {
@@ -899,20 +1077,24 @@ export declare enum AiAgentTechnicalFailure {
     ToolUnavailable = "TOOL_UNAVAILABLE"
 }
 export type AiAgentTool = {
+    /** `pre_approved` (padrao) ou `human_approval`. */
     approval?: Maybe<Scalars['String']['output']>;
     availability: ToolAvailability;
+    /** `url` (default): a plataforma impoe o recorte via `{customerId}` na URL; `credential`: a credencial ja e do cliente (declarado, nunca inferido). */
     customerScope?: Maybe<Scalars['String']['output']>;
     description: Scalars['String']['output'];
     effect: ToolEffect;
-    emptyResultMessage?: Maybe<Scalars['String']['output']>;
     name: Scalars['String']['output'];
+    /** `{kind: message, message?}` (default), `{kind: retry, attempts, message?}` ou `{kind: handoff}`. */
     onFailure?: Maybe<Scalars['JSON']['output']>;
     parameters: Array<AiAgentToolParameter>;
     requiresAuthenticatedCustomer: Scalars['Boolean']['output'];
+    /** Fields the agent is allowed to see. Anything not listed never reaches the model. */
     returns: Array<Scalars['String']['output']>;
     toolId: Scalars['ID']['output'];
 };
 export type AiAgentToolExclusion = {
+    /** `not_bound`, `unavailable` ou `human_approval_unavailable`. */
     reason: Scalars['String']['output'];
     toolId: Scalars['ID']['output'];
 };
@@ -934,18 +1116,22 @@ export type AiAgentToolParameterInput = {
     type: ToolParameterType;
 };
 export type AiAgentToolSpecInput = {
+    /** `pre_approved` (padrao) ou `human_approval`. */
     approval?: InputMaybe<Scalars['String']['input']>;
     availability: ToolAvailability;
     credentialRef?: InputMaybe<CredentialRefInput>;
+    /** `url` (default): a plataforma impoe o recorte via `{customerId}` na URL; `credential`: a credencial ja e do cliente (declarado, nunca inferido). */
     customerScope?: InputMaybe<Scalars['String']['input']>;
     description: Scalars['String']['input'];
+    /** Ignorado: a plataforma calcula pelo método do conector (GET consulta, os demais agem). */
     effect?: InputMaybe<ToolEffect>;
-    emptyResultMessage?: InputMaybe<Scalars['String']['input']>;
     idempotent: Scalars['Boolean']['input'];
     name: Scalars['String']['input'];
+    /** `{kind: message, message?}` (default), `{kind: retry, attempts, message?}` ou `{kind: handoff}`. */
     onFailure?: InputMaybe<Scalars['JSON']['input']>;
     parameters: Array<AiAgentToolParameterInput>;
     requiresAuthenticatedCustomer: Scalars['Boolean']['input'];
+    /** Campos que o agente pode ver. O que não estiver aqui nunca chega ao modelo. */
     returns: Array<Scalars['String']['input']>;
     reversible: Scalars['Boolean']['input'];
     toolId: Scalars['ID']['input'];
@@ -955,17 +1141,20 @@ export type AiAgentTrace = {
     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. */
     haltReason?: Maybe<Scalars['String']['output']>;
+    /** O turno tentou usar ferramenta que exige cliente identificado, sem ter um. */
     identificationRequired?: Maybe<Scalars['Boolean']['output']>;
     input: Scalars['String']['output'];
     knowledgeOrigins: Array<Scalars['String']['output']>;
+    /** Versao da regra mestra da plataforma vigente no turno — atribui a conversa a regra sob a qual ela rodou. */
     masterRuleVersion?: Maybe<Scalars['Int']['output']>;
-    model?: Maybe<Scalars['String']['output']>;
     outcome: Scalars['String']['output'];
     promptBuilderVersion: Scalars['Int']['output'];
+    /** Identifica o prompt que gerou este turno sem guardar o prompt inteiro. */
     promptFingerprint?: Maybe<Scalars['String']['output']>;
-    reasoningEffort?: Maybe<Scalars['String']['output']>;
     sessionId: Scalars['ID']['output'];
     startedAt: Scalars['Float']['output'];
     steps: Scalars['Int']['output'];
@@ -973,11 +1162,21 @@ export type AiAgentTrace = {
     turn: Scalars['Int']['output'];
 };
 export type AiAgentTracedToolCall = {
+    /** O sistema externo, pelo host. Sem path nem query, que carregam parametro do cliente. */
     connection?: Maybe<Scalars['String']['output']>;
-    empty?: Maybe<Scalars['Boolean']['output']>;
+    /**
+     * `unauthenticated`, `not_configured`, `not_migrated`, `needs_approval`, `rejected_arguments`, `timeout`, `upstream` ou `indeterminate_write`.
+     * `timeout` cobre o tempo esgotado no sistema do cliente e na chamada ao apiconnectors.
+     * `indeterminate_write` e o timeout de escrita nao idempotente: nao se sabe se a acao foi feita.
+     */
     errorClass?: Maybe<Scalars['String']['output']>;
     name: Scalars['String']['output'];
+    /**
+     * Se a chamada deu certo. Ausente em chamada gravada antes do desfecho estruturado existir — e
+     * ausente nao significa falha.
+     */
     ok?: Maybe<Scalars['Boolean']['output']>;
+    /** Ja restrito aos campos que a ferramenta declarou em `returns`. */
     result: Scalars['String']['output'];
     toolId: Scalars['ID']['output'];
 };
@@ -986,14 +1185,22 @@ export type AiAgentUseCase = {
     name: Scalars['String']['output'];
     procedureId?: Maybe<Scalars['ID']['output']>;
     status: Scalars['String']['output'];
+    /**
+     * NAO e documentacao: e o texto que o roteador le para classificar a mensagem (§6.1). Descricao vaga
+     * 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 = {
+    /** Do par mais parecido para o menos: e a ordem em que o autor deve olhar. */
     pairs: Array<AiAgentCompetingPair>;
+    /** O limiar aplicado, publicado junto do resultado para o aviso nao ser lido como cada um quiser. */
     threshold: Scalars['Number']['output'];
 };
+/** `value` is absent when there is no base to compare: no previous data, or a previous count of zero for PERCENT. */
 export type AiAgentVariation = {
     unit: AiAgentVariationUnit;
     value?: Maybe<Scalars['Number']['output']>;
@@ -1005,6 +1212,7 @@ export declare enum AiAgentVariationUnit {
 export type AiAgentVersion = {
     agentId: Scalars['ID']['output'];
     createdAt: Scalars['DateTime']['output'];
+    /** Ferramentas vinculadas que esta versão não oferece ao modelo, pelo catálogo atual. Nulo quando o catálogo não pôde ser lido. */
     excludedTools?: Maybe<Array<AiAgentToolExclusion>>;
     spec: AiAgentSpec;
     status: AiAgentVersionStatus;
@@ -1038,7 +1246,9 @@ export declare enum Can {
 }
 export type CheckAiAgentVersionInput = {
     agentId: Scalars['ID']['input'];
+    /** De 2 a 20. Uma execução só não prova nada num sistema probabilístico. */
     runsPerScenario?: InputMaybe<Scalars['Int']['input']>;
+    /** Cenários a rodar. Ausente roda todos; o resultado cobre só os cenários rodados. */
     scenarioIds?: InputMaybe<Array<Scalars['ID']['input']>>;
     version: Scalars['Int']['input'];
 };
@@ -1052,10 +1262,12 @@ export type CreateQnAInstanceInput = {
     tryToReplyOnTransition?: InputMaybe<Scalars['Boolean']['input']>;
 };
 export type CredentialRefInput = {
+    /** Nome do parâmetro no cofre do tenant. O valor nunca é armazenado aqui. */
     name: Scalars['String']['input'];
     vault: Scalars['String']['input'];
 };
 export type DraftAiAgentInput = {
+    /** Omitted for a brand new agent; supplied to draft the next version of an existing one. */
     agentId?: InputMaybe<Scalars['ID']['input']>;
     name: Scalars['String']['input'];
     spec: AiAgentSpecInput;
@@ -1079,28 +1291,37 @@ export type I18nTextInput = {
     value: Scalars['String']['input'];
 };
 export type Mutation = {
+    /**
+     * Enfileira a suíte contra uma versão candidata e devolve a execução em `queued`. Rodar custa
+     * chamadas de modelo e leva minutos, então o resultado se lê depois por `getAiAgentCheckRun`.
+     */
     checkAiAgentVersion?: Maybe<AiAgentCheckRun>;
     createNlpInstance?: Maybe<NlpInstance>;
     createQnAInstance?: Maybe<QnAInstance>;
     draftAiAgent?: Maybe<AiAgentVersion>;
     extractImageMetadata: ExtractImageMetadataResult;
     publishAiAgentVersion: Array<AiAgentVersion>;
+    /** Cadastre o backend da ferramenta como Connector (Nexo > Conectores) primeiro, depois amarre o spec do agente a ele aqui. */
     registerAiAgentTool?: Maybe<AiAgentTool>;
     reindexAiAgentDashboard: Scalars['Number']['output'];
     rememberAiAgentSessionFacts: Scalars['Boolean']['output'];
+    /** Apaga o agente e a autoria dele. Agente no ar precisa ser pausado antes. */
     removeAiAgent: Scalars['Boolean']['output'];
     removeAiAgentProcedure: Scalars['Boolean']['output'];
+    /** O relatório já gravado para o cenário não é removido. */
     removeAiAgentScenario: Scalars['Boolean']['output'];
     removeAiAgentUseCase: Scalars['Boolean']['output'];
     removeAiAgentVersion: Array<AiAgentVersion>;
     removeNlpInstance?: Maybe<NlpInstance>;
     removeQnAInstance?: Maybe<QnAInstance>;
+    /** Decide uma acao que ficou esperando aprovacao humana (§5.5.3). Decidir de novo nao repete a acao. */
     resolveAiAgentApproval: Scalars['Boolean']['output'];
     rollbackAiAgentVersion: Array<AiAgentVersion>;
     saveAiAgentProcedure: AiAgentProcedure;
     saveAiAgentScenario?: Maybe<AiAgentScenario>;
     saveAiAgentUseCase: AiAgentUseCase;
     setAiAgentRetentionPolicy: AiAgentRetentionPolicy;
+    /** Tira a versao do ar sem apagar (pausar). Publicar de novo e o caminho de volta. */
     unpublishAiAgentVersion: Array<AiAgentVersion>;
     unregisterAiAgentTool?: Maybe<Scalars['Boolean']['output']>;
     updateNlpInstance?: Maybe<NlpInstance>;
@@ -1237,28 +1458,54 @@ export type QnAInstance = {
     updatedAt: Scalars['DateTime']['output'];
 };
 export type Query = {
+    /** O que a suíte deste agente aceita hoje. O teto por cenário já vem dividido pelos cenários dele. */
     aiAgentCheckLimits: AiAgentCheckLimits;
     aiAgentConversationMetrics: AiAgentConversationMetricsPage;
     aiAgentConversationOutcome?: Maybe<AiAgentConversationOutcome>;
     aiAgentDashboard: AiAgentDashboard;
+    /**
+     * §4.8: as bases do Droz Base do tenant. A chamada e entre services, com App Token — nao ha
+     * credencial de cliente. O recorte do agente e a selecao do autor em `knowledgeBaseIds`.
+     */
     aiAgentKnowledgeBases: Array<AiAgentKnowledgeBase>;
     aiAgentListingMetrics: Array<AiAgentListingMetrics>;
     aiAgentMetrics: AiAgentMetrics;
+    /** As metricas da janela para todos os agentes, numa ida so. Agente sem rastro vem com zeros. */
     aiAgentMetricsByAgent: Array<AiAgentMetrics>;
     aiAgentMetricsSeries: AiAgentMetricsSeries;
+    /**
+     * A politica de retencao em vigor para o tenant, com os padroes aplicados quando ele nao
+     * configurou a propria. Existe para a politica ser verificavel de fora, nao so estar escrita.
+     */
     aiAgentRetentionPolicy: AiAgentRetentionPolicy;
+    /** Onde cada mensagem de exemplo cairia (§5.4). Os limiares saem no resultado: `medium` sem o limiar nao diz nada. */
     aiAgentRoutingPreview: AiAgentRoutingPreview;
+    /**
+     * Os turnos de um atendimento, do primeiro ao ultimo. E o que responde "o que aconteceu nesta
+     * conversa" sem depender de ler o DynamoDB por fora.
+     */
     aiAgentTrace: Array<AiAgentTrace>;
+    /**
+     * Casos de uso cujas descricoes competem no roteador (§6.1). Aviso de autoria, nao bloqueio: descricoes
+     * parecidas podem ser intencionais.
+     */
     aiAgentUseCaseOverlap: AiAgentUseCaseOverlap;
     app?: Maybe<Scalars['DRN']['output']>;
+    /** Uma execução da suíte. Ausente quando o identificador não é de uma execução deste agente. */
     getAiAgentCheckRun?: Maybe<AiAgentCheckRun>;
     getHttpEndpoint?: Maybe<Scalars['String']['output']>;
     getNlpInstance?: Maybe<NlpInstance>;
     getQnAInstance?: Maybe<QnAInstance>;
+    /**
+     * A fila e o historico de aprovacao humana do agente, da mais recente para a mais antiga. `status`
+     * filtra por `pending`, `approved`, `rejected` ou `expired`; pendente fora do prazo ja vem `expired`.
+     */
     listAiAgentApprovals: Array<AiAgentApproval>;
+    /** Os procedimentos do agente (§6.2): o plano em linguagem natural. */
     listAiAgentProcedures: Array<AiAgentProcedure>;
     listAiAgentScenarios: Array<AiAgentScenario>;
     listAiAgentTools: Array<AiAgentTool>;
+    /** Os casos de uso do agente (§6.1): os motivos de contato. */
     listAiAgentUseCases: Array<AiAgentUseCase>;
     listAiAgentVersions: Array<AiAgentVersion>;
     listAiAgents: Array<AiAgentSummary>;
@@ -1339,6 +1586,7 @@ export type QueryTestQnAInstanceArgs = {
     input: Scalars['String']['input'];
 };
 export type RegisterAiAgentToolInput = {
+    /** Connector ja cadastrado (Nexo > Conectores) que executa a chamada HTTP desta ferramenta. */
     connectorId: Scalars['ID']['input'];
     spec: AiAgentToolSpecInput;
 };
@@ -1362,8 +1610,11 @@ export type RemoveQnAInstanceInput = {
 };
 export type ResolveAiAgentApprovalInput = {
     agentId: Scalars['ID']['input'];
+    /** Ignorado: quem decidiu e o usuario autenticado. */
     decidedBy?: InputMaybe<Scalars['String']['input']>;
+    /** `approved` executa a acao guardada; `rejected` avisa o consumidor e nao executa nada. */
     decision: Scalars['String']['input'];
+    /** Identifica a pendencia junto da sessao: e o momento em que a acao foi enfileirada. */
     requestedAt: Scalars['Number']['input'];
     sessionId: Scalars['ID']['input'];
 };
@@ -1385,8 +1636,24 @@ export type SaveAiAgentProcedureInput = {
 };
 export type SaveAiAgentScenarioInput = {
     agentId: Scalars['ID']['input'];
+    /**
+     * Quem é o cliente nesta conversa. Ausente roda como anônimo. Ferramenta que exige cliente
+     * identificado substitui este valor na URL ou na credencial, e o simulador chama a integração
+     * real com ele — não é um identificador de mentira sem efeito.
+     */
     customerId?: InputMaybe<Scalars['ID']['input']>;
     description: Scalars['String']['input'];
+    /**
+     * Expectativas de comportamento, uma por objeto, cada uma com `kind`. `tool_called` aceita
+     * `toolName` e `withArgs`; `tool_not_called` aceita `toolName`; `blocked_by_rule` aceita `category`
+     * para exigir o motivo; `stopped_for` aceita `reason`; `answer_omits` exige `terms`, e vale quando
+     * nenhum termo aparece em nenhuma resposta da execucao, sem acento e sem caixa. `transferred` vale
+     * para qualquer passagem a uma pessoa — pedida pelo agente ou por orcamento estourado — e aceita
+     * `reason` para cobrar um motivo especifico (`customer_request`, `tool_failure`,
+     * `provider_unavailable`, `budget_exceeded`, `period_budget_exceeded`, `unresolved`).
+     * `not_transferred`, `answer_grounded` e `identification_required` nao levam campo — este ultimo
+     * vale quando alguma ferramenta do cenario foi recusada por falta de cliente identificado.
+     */
     expectations: Array<Scalars['JSON']['input']>;
     scenarioId: Scalars['ID']['input'];
     turns: Array<Scalars['String']['input']>;
@@ -1398,6 +1665,7 @@ 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 = {
@@ -1536,7 +1804,7 @@ export type UpdateQnAInstanceInput = {
 };
 export type AiAgentSummaryFragment = Pick<AiAgentSummary, 'agentId' | 'name' | 'liveVersion' | 'channels' | 'updatedAt' | 'queuedApprovals' | 'status'>;
 export type AiAgentVersionFragment = Pick<AiAgentVersion, 'agentId' | 'version' | 'status' | 'createdAt'>;
-export type AiAgentSpecFragment = (Pick<AiAgentSpec, 'can' | 'cannot' | 'knowledgeBaseIds' | 'knowledgeFallback' | 'toolIds' | 'channels' | 'typingIndicator'> & {
+export type AiAgentSpecFragment = (Pick<AiAgentSpec, 'can' | 'cannot' | 'knowledgeBaseIds' | 'knowledgeFallback' | 'toolIds' | 'channels'> & {
     identity: Pick<AiAgentIdentity, 'displayName' | 'role' | 'tone' | 'toneNotes' | 'openingMessage' | 'outOfScopeBehaviour'>;
     budget: Pick<AiAgentBudget, 'maxSteps' | 'maxToolCalls' | 'maxTokens' | 'maxCostMicroUsd' | 'maxPeriodCostMicroUsd' | 'onExceeded'>;
     handoff?: Maybe<Pick<AiAgentHandoff, 'transition' | 'target'>>;
@@ -1613,12 +1881,12 @@ export type RemoveAiAgentMutationVariables = Exact<{
 export type RemoveAiAgentMutation = Pick<Mutation, 'removeAiAgent'>;
 export type AiAgentUseCaseFragment = Pick<AiAgentUseCase, 'id' | 'name' | 'subjectDescription' | 'procedureId' | 'tag' | 'status' | 'updatedAt'>;
 export type AiAgentProcedureFragment = Pick<AiAgentProcedure, 'id' | 'name' | 'guidanceSteps' | 'toolIds' | 'contingency' | 'executionAutonomy' | 'endsConversationAfterInforming' | 'continuesAfterApproval' | 'approvedReplyTemplate' | 'deniedReplyTemplate' | 'expiredReplyTemplate' | 'replyEmailSubject' | 'status' | 'updatedAt'>;
-export type AiAgentToolFragment = (Pick<AiAgentTool, 'toolId' | 'name' | 'description' | 'effect' | 'availability' | 'requiresAuthenticatedCustomer' | 'onFailure' | 'emptyResultMessage' | 'customerScope' | 'returns' | 'approval'> & {
+export type AiAgentToolFragment = (Pick<AiAgentTool, 'toolId' | 'name' | 'description' | 'effect' | 'availability' | 'requiresAuthenticatedCustomer' | 'onFailure' | 'customerScope' | 'returns' | 'approval'> & {
     parameters: Array<Pick<AiAgentToolParameter, 'name' | 'type' | 'required' | 'description' | 'grounding' | 'format'>>;
 });
-export type AiAgentTraceFragment = (Pick<AiAgentTrace, 'sessionId' | 'turn' | 'agentId' | 'agentVersion' | 'input' | 'promptBuilderVersion' | 'masterRuleVersion' | 'identificationRequired' | 'promptFingerprint' | 'knowledgeOrigins' | 'outcome' | 'haltReason' | 'steps' | 'answer' | 'startedAt' | 'model' | 'reasoningEffort'> & {
+export type AiAgentTraceFragment = (Pick<AiAgentTrace, 'sessionId' | 'turn' | 'agentId' | 'agentVersion' | 'input' | 'promptBuilderVersion' | 'masterRuleVersion' | 'identificationRequired' | 'promptFingerprint' | 'knowledgeOrigins' | 'outcome' | 'haltReason' | 'steps' | 'answer' | 'startedAt'> & {
     excludedTools?: Maybe<Array<AiAgentToolExclusionFragment>>;
-    toolCalls: Array<Pick<AiAgentTracedToolCall, 'toolId' | 'name' | 'result' | 'ok' | 'empty' | 'connection' | 'errorClass'>>;
+    toolCalls: Array<Pick<AiAgentTracedToolCall, 'toolId' | 'name' | 'result' | 'ok' | 'connection' | 'errorClass'>>;
 });
 export type AiAgentScenarioFragment = Pick<AiAgentScenario, 'scenarioId' | 'description' | 'customerId' | 'turns' | 'expectations'>;
 export type ListAiAgentUseCasesQueryVariables = Exact<{
@@ -1811,12 +2079,10 @@ export type SaveAiAgentScenarioMutation = {
 export type AiAgentCheckRunFragment = (Pick<AiAgentCheckRun, 'runId' | 'agentId' | 'version' | 'status' | 'requestedAt' | 'startedAt' | 'finishedAt' | 'totalRuns' | 'completedRuns' | 'error'> & {
     excludedTools?: Maybe<Array<AiAgentToolExclusionFragment>>;
     result?: Maybe<(Pick<AiAgentCheckResult, 'safeToPublish'> & {
-        authoring?: Maybe<Pick<AiAgentCheckAuthoring, 'useCases' | 'procedures' | 'updatedAt'>>;
         reports: Array<(Pick<AiAgentScenarioReport, 'scenarioId' | 'runs' | 'cut' | 'measured' | 'passed' | 'rate'> & {
             handoffReasons: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
             turns: Array<(Pick<AiAgentScenarioTurn, 'turn' | 'runs' | 'answered' | 'grounded' | 'blocked' | 'identificationRequired'> & {
                 toolNames: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
-                rejectedCalls?: Maybe<Array<Pick<AiAgentRejectedCall, 'toolName' | 'reason' | 'count'>>>;
                 blockCategories: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
             })>;
         })>;
@@ -1843,6 +2109,7 @@ 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' | 'conversationsEligible' | 'conversationsResolvedByDefinition' | 'conversationsProvisional' | 'conversationsAwaitingClassification' | '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'>>;
     classificationBreakdown: Array<Pick<AiAgentClassificationCount, 'state' | 'subcategory' | 'technicalFailure' | 'count'>>;
     classificationDefinitionVersions: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     sentimentAtStart: Array<Pick<AiAgentSentimentCount, 'key' | 'count'>>;
@@ -1857,7 +2124,6 @@ export type AiAgentMetricsReportFragment = (Pick<AiAgentMetrics, 'agentId' | 'fr
     };
     handoffsByReason: Array<Pick<AiAgentHandoffReasonCount, 'key' | 'count'>>;
     turnsByModel: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
-    turnsByModelAndReasoningEffort: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     topTopics: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     topUnansweredQuestions: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     blocksByCategory: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
@@ -1982,22 +2248,22 @@ export type RemoveQnAInstanceMutation = {
 };
 export declare const AiAgentSummaryFragmentDoc = "\n    fragment aiAgentSummary on AiAgentSummary {\n  agentId\n  name\n  liveVersion\n  channels\n  updatedAt\n  queuedApprovals\n  status\n}\n    ";
 export declare const AiAgentVersionFragmentDoc = "\n    fragment aiAgentVersion on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n}\n    ";
-export declare const AiAgentSpecFragmentDoc = "\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  conversationTiming {\n    channel\n    abandonAfterMs\n    remindAfterMs\n    metaWindowMs\n    reminderMessage\n    renewalMessage\n  }\n  typingIndicator\n}\n    ";
+export declare const AiAgentSpecFragmentDoc = "\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  conversationTiming {\n    channel\n    abandonAfterMs\n    remindAfterMs\n    metaWindowMs\n    reminderMessage\n    renewalMessage\n  }\n}\n    ";
 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 AiAgentListingMetricsFieldsFragmentDoc = "\n    fragment aiAgentListingMetricsFields on AiAgentListingMetrics {\n  agentId\n  conversations\n  conversationsResolved\n  conversationsHandoffRequested\n  resolutionRate\n  costMicroUsd\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  endsConversationAfterInforming\n  continuesAfterApproval\n  approvedReplyTemplate\n  deniedReplyTemplate\n  expiredReplyTemplate\n  replyEmailSubject\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  emptyResultMessage\n  customerScope\n  returns\n  approval\n  parameters {\n    name\n    type\n    required\n    description\n    grounding\n    format\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  model\n  reasoningEffort\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  toolCalls {\n    toolId\n    name\n    result\n    ok\n    empty\n    connection\n    errorClass\n  }\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    format\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 AiAgentDashboardIndicatorFragmentDoc = "\n    fragment aiAgentDashboardIndicator on AiAgentDashboardIndicator {\n  value\n  polarity\n  variation {\n    unit\n    value\n  }\n}\n    ";
 export declare const AiAgentDashboardSentimentFragmentDoc = "\n    fragment aiAgentDashboardSentiment on AiAgentDashboardSentiment {\n  sentiment\n  count\n  percent\n  polarity\n  variation {\n    unit\n    value\n  }\n}\n    ";
 export declare const AiAgentDashboardContactReasonFragmentDoc = "\n    fragment aiAgentDashboardContactReason on AiAgentDashboardContactReason {\n  key\n  count\n  percent\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    authoring {\n      useCases\n      procedures\n      updatedAt\n    }\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        rejectedCalls {\n          toolName\n          reason\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  classificationBreakdown {\n    state\n    subcategory\n    technicalFailure\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  conversationsProvisional\n  conversationsAwaitingClassification\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  classificationDefinitionVersions {\n    key\n    count\n  }\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  turnsByModelAndReasoningEffort {\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 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  conversationsByClassification {\n    key\n    count\n  }\n  classificationBreakdown {\n    state\n    subcategory\n    technicalFailure\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  conversationsProvisional\n  conversationsAwaitingClassification\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  classificationDefinitionVersions {\n    key\n    count\n  }\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    ";
@@ -2012,9 +2278,9 @@ export declare const RemoveAiAgentVersionDocument = "\n    mutation removeAiAgen
 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  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  endsConversationAfterInforming\n  continuesAfterApproval\n  approvedReplyTemplate\n  deniedReplyTemplate\n  expiredReplyTemplate\n  replyEmailSubject\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  emptyResultMessage\n  customerScope\n  returns\n  approval\n  parameters {\n    name\n    type\n    required\n    description\n    grounding\n    format\n  }\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    format\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    ";
-export declare const AiAgentTraceDocument = "\n    query aiAgentTrace($sessionId: ID!, $conversationId: ID) {\n  aiAgentTrace(sessionId: $sessionId, conversationId: $conversationId) {\n    ...aiAgentTrace\n  }\n}\n    \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  model\n  reasoningEffort\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  toolCalls {\n    toolId\n    name\n    result\n    ok\n    empty\n    connection\n    errorClass\n  }\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
+export declare const AiAgentTraceDocument = "\n    query aiAgentTrace($sessionId: ID!, $conversationId: ID) {\n  aiAgentTrace(sessionId: $sessionId, conversationId: $conversationId) {\n    ...aiAgentTrace\n  }\n}\n    \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    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 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 ReindexAiAgentDashboardDocument = "\n    mutation reindexAiAgentDashboard($input: ReindexAiAgentDashboardInput!) {\n  reindexAiAgentDashboard(input: $input)\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    ";
@@ -2030,15 +2296,15 @@ export declare const RemoveAiAgentProcedureDocument = "\n    mutation removeAiAg
 export declare const RememberAiAgentSessionFactsDocument = "\n    mutation rememberAiAgentSessionFacts($input: RememberAiAgentSessionFactsInput!) {\n  rememberAiAgentSessionFacts(input: $input)\n}\n    ";
 export declare const ListAiAgentApprovalsDocument = "\n    query listAiAgentApprovals($agentId: ID!, $status: String) {\n  listAiAgentApprovals(agentId: $agentId, status: $status) {\n    ...aiAgentApproval\n  }\n}\n    \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 ResolveAiAgentApprovalDocument = "\n    mutation resolveAiAgentApproval($input: ResolveAiAgentApprovalInput!) {\n  resolveAiAgentApproval(input: $input)\n}\n    ";
-export declare const RegisterAiAgentToolDocument = "\n    mutation registerAiAgentTool($input: RegisterAiAgentToolInput!) {\n  registerAiAgentTool(input: $input) {\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  emptyResultMessage\n  customerScope\n  returns\n  approval\n  parameters {\n    name\n    type\n    required\n    description\n    grounding\n    format\n  }\n}\n    ";
+export declare const RegisterAiAgentToolDocument = "\n    mutation registerAiAgentTool($input: RegisterAiAgentToolInput!) {\n  registerAiAgentTool(input: $input) {\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    format\n  }\n}\n    ";
 export declare const UnregisterAiAgentToolDocument = "\n    mutation unregisterAiAgentTool($input: UnregisterAiAgentToolInput!) {\n  unregisterAiAgentTool(input: $input)\n}\n    ";
 export declare const RemoveAiAgentScenarioDocument = "\n    mutation removeAiAgentScenario($input: RemoveAiAgentScenarioInput!) {\n  removeAiAgentScenario(input: $input)\n}\n    ";
 export declare const SaveAiAgentScenarioDocument = "\n    mutation saveAiAgentScenario($input: SaveAiAgentScenarioInput!) {\n  saveAiAgentScenario(input: $input) {\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 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    authoring {\n      useCases\n      procedures\n      updatedAt\n    }\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        rejectedCalls {\n          toolName\n          reason\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    authoring {\n      useCases\n      procedures\n      updatedAt\n    }\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        rejectedCalls {\n          toolName\n          reason\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 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  classificationBreakdown {\n    state\n    subcategory\n    technicalFailure\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  conversationsProvisional\n  conversationsAwaitingClassification\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  classificationDefinitionVersions {\n    key\n    count\n  }\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  turnsByModelAndReasoningEffort {\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  conversationTiming {\n    channel\n    abandonAfterMs\n    remindAfterMs\n    metaWindowMs\n    reminderMessage\n    renewalMessage\n  }\n  typingIndicator\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\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  classificationBreakdown {\n    state\n    subcategory\n    technicalFailure\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  conversationsProvisional\n  conversationsAwaitingClassification\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  classificationDefinitionVersions {\n    key\n    count\n  }\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  conversationTiming {\n    channel\n    abandonAfterMs\n    remindAfterMs\n    metaWindowMs\n    reminderMessage\n    renewalMessage\n  }\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    ";
 export declare const ExtractImageMetadataDocument = "\n    mutation extractImageMetadata($input: ExtractImageMetadataInput!) {\n  extractImageMetadata(input: $input) {\n    success\n    model\n    extractedMetadata\n    tokenUsage {\n      prompt\n      completion\n      total\n    }\n  }\n}\n    ";