@droz-js/sdk 0.25.16 → 0.25.17

package/package.json

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

package/src/sdks/ai.d.ts

@@ -199,6 +199,11 @@ 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'];
@@ -208,6 +213,7 @@ export type AiAgentCheckLimits = {
     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. */
@@ -707,8 +713,6 @@ export type AiAgentMetrics = {
     /** 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
@@ -1084,8 +1088,9 @@ export type AiAgentTool = {
     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}`. */
+    /** `{kind: message|retry|handoff, message?, attempts?, byStatus?}`; `byStatus` mapeia status HTTP de erro para o texto que o modelo lê. */
     onFailure?: Maybe<Scalars['JSON']['output']>;
     parameters: Array<AiAgentToolParameter>;
     requiresAuthenticatedCustomer: Scalars['Boolean']['output'];
@@ -1125,9 +1130,10 @@ export type AiAgentToolSpecInput = {
     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}`. */
+    /** `{kind: message|retry|handoff, message?, attempts?, byStatus?}`; `byStatus` mapeia status HTTP de erro para o texto que o modelo lê. */
     onFailure?: InputMaybe<Scalars['JSON']['input']>;
     parameters: Array<AiAgentToolParameterInput>;
     requiresAuthenticatedCustomer: Scalars['Boolean']['input'];
@@ -1164,6 +1170,7 @@ export type AiAgentTrace = {
 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.
@@ -1881,12 +1888,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' | 'customerScope' | 'returns' | 'approval'> & {
+export type AiAgentToolFragment = (Pick<AiAgentTool, 'toolId' | 'name' | 'description' | 'effect' | 'availability' | 'requiresAuthenticatedCustomer' | 'onFailure' | 'emptyResultMessage' | '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'> & {
     excludedTools?: Maybe<Array<AiAgentToolExclusionFragment>>;
-    toolCalls: Array<Pick<AiAgentTracedToolCall, 'toolId' | 'name' | 'result' | 'ok' | 'connection' | 'errorClass'>>;
+    toolCalls: Array<Pick<AiAgentTracedToolCall, 'toolId' | 'name' | 'result' | 'ok' | 'empty' | 'connection' | 'errorClass'>>;
 });
 export type AiAgentScenarioFragment = Pick<AiAgentScenario, 'scenarioId' | 'description' | 'customerId' | 'turns' | 'expectations'>;
 export type ListAiAgentUseCasesQueryVariables = Exact<{
@@ -2079,6 +2086,7 @@ 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'> & {
@@ -2109,7 +2117,6 @@ 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'>>;
@@ -2255,15 +2262,15 @@ export declare const AiAgentListingMetricsFragmentDoc = "\n    fragment aiAgentL
 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  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 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  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 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    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 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        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  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    ";
@@ -2278,9 +2285,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  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  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 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  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 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    empty\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    ";
@@ -2296,14 +2303,14 @@ 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  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  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 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    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 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        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        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  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 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  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    ";

package/src/sdks/ai.js

@@ -392,6 +392,7 @@ exports.AiAgentToolFragmentDoc = `
   availability
   requiresAuthenticatedCustomer
   onFailure
+  emptyResultMessage
   customerScope
   returns
   approval
@@ -430,6 +431,7 @@ exports.AiAgentTraceFragmentDoc = `
     name
     result
     ok
+    empty
     connection
     errorClass
   }
@@ -506,6 +508,11 @@ exports.AiAgentCheckRunFragmentDoc = `
   }
   result {
     safeToPublish
+    authoring {
+      useCases
+      procedures
+      updatedAt
+    }
     reports {
       scenarioId
       runs
@@ -554,10 +561,6 @@ exports.AiAgentMetricsReportFragmentDoc = `
   conversationsHandoffRequested
   resolutionRate
   resolutionDefinition
-  conversationsByClassification {
-    key
-    count
-  }
   classificationBreakdown {
     state
     subcategory