@droz-js/sdk 0.20.8 → 0.20.9

package/package.json

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

package/src/sdks/ai.d.ts

@@ -463,6 +463,12 @@ export type AiAgentScenario = {
 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. `customer_request` é
+     * entrega por decisão do agente; `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'];
@@ -1042,7 +1048,10 @@ export type SaveAiAgentScenarioInput = {
      * 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`,
+     * 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.
      */
@@ -1365,6 +1374,7 @@ export type SaveAiAgentScenarioMutation = {
 export type AiAgentCheckRunFragment = (Pick<AiAgentCheckRun, 'runId' | 'agentId' | 'version' | 'status' | 'requestedAt' | 'startedAt' | 'finishedAt' | 'totalRuns' | 'completedRuns' | 'error'> & {
     result?: Maybe<(Pick<AiAgentCheckResult, 'safeToPublish'> & {
         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'>>;
                 blockCategories: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
@@ -1527,7 +1537,7 @@ export declare const AiAgentProcedureFragmentDoc = "\n    fragment aiAgentProced
 export declare const AiAgentToolFragmentDoc = "\n    fragment aiAgentTool on AiAgentTool {\n  toolId\n  name\n  description\n  effect\n  availability\n  requiresAuthenticatedCustomer\n  onFailure\n  customerScope\n  returns\n  approval\n  parameters {\n    name\n    type\n    required\n    description\n    grounding\n  }\n}\n    ";
 export declare const AiAgentTraceFragmentDoc = "\n    fragment aiAgentTrace on AiAgentTrace {\n  sessionId\n  turn\n  agentId\n  agentVersion\n  input\n  promptBuilderVersion\n  masterRuleVersion\n  identificationRequired\n  promptFingerprint\n  knowledgeOrigins\n  outcome\n  haltReason\n  steps\n  answer\n  startedAt\n  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 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  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\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 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  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\n      handoffReasons {\n        key\n        count\n      }\n      turns {\n        turn\n        runs\n        answered\n        grounded\n        blocked\n        identificationRequired\n        toolNames {\n          key\n          count\n        }\n        blockCategories {\n          key\n          count\n        }\n      }\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    ";
 export declare const AiAgentMetricsReportFragmentDoc = "\n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
 export declare const 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    ";
@@ -1559,8 +1569,8 @@ export declare const RegisterAiAgentToolDocument = "\n    mutation registerAiAge
 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  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\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 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  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\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 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  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 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  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 AiAgentCheckLimitsDocument = "\n    query aiAgentCheckLimits($agentId: ID!) {\n  aiAgentCheckLimits(agentId: $agentId) {\n    minRunsPerScenario\n    maxRunsPerScenario\n    maxSuiteRuns\n    scenarioCount\n  }\n}\n    ";
 export declare const AiAgentMetricsDocument = "\n    query aiAgentMetrics($input: AiAgentMetricsInput!) {\n  aiAgentMetrics(input: $input) {\n    ...aiAgentMetricsReport\n  }\n}\n    \n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
 export declare const 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}\n    \n\n    fragment aiAgentSpec on AiAgentSpec {\n  identity {\n    displayName\n    role\n    tone\n    toneNotes\n    openingMessage\n    outOfScopeBehaviour\n  }\n  can\n  cannot\n  knowledgeBaseIds\n  knowledgeFallback\n  toolIds\n  budget {\n    maxSteps\n    maxToolCalls\n    maxTokens\n    maxCostMicroUsd\n    maxPeriodCostMicroUsd\n    onExceeded\n  }\n  handoff {\n    transition\n    target\n  }\n  channels\n}\n    ";

package/src/sdks/ai.js

@@ -259,6 +259,10 @@ exports.AiAgentCheckRunFragmentDoc = `
       measured
       passed
       rate
+      handoffReasons {
+        key
+        count
+      }
       turns {
         turn
         runs