@droz-js/sdk 0.25.12 → 0.25.13

package/package.json

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

package/src/sdks/ai.d.ts

@@ -696,8 +696,11 @@ export type AiAgentMetrics = {
     /** 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'];
     /** @deprecated A chave junta subcategoria e falha tecnica numa string. Use classificationBreakdown. */
     conversationsByClassification: Array<AiAgentMetricsCount>;
@@ -764,8 +767,9 @@ export type AiAgentMetrics = {
     /** A regra aplicada para contar resolucao, junto do numero, para ele nao ser lido como cada um quiser. */
     resolutionDefinition: Scalars['String']['output'];
     /**
-     * Conversas resolvidas sobre o total, em pontos percentuais. **Ausente** quando nao houve conversa na
-     * janela — sem dado e zero por cento nao sao a mesma coisa.
+     * 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. */
@@ -2096,6 +2100,7 @@ export type AiAgentCheckLimitsQuery = {
 export type AiAgentMetricsReportFragment = (Pick<AiAgentMetrics, 'agentId' | 'from' | 'to' | 'truncated' | 'conversations' | 'conversationsResolved' | 'conversationsInconclusive' | 'conversationsHandoffRequested' | 'resolutionRate' | 'resolutionDefinition' | 'conversationsEligible' | 'conversationsResolvedByDefinition' | 'resolvedRate' | 'unresolvedRate' | 'handoffProcedureRate' | 'handoffNeedRate' | 'abandonmentRate' | 'classificationDefinitionVersion' | 'analyzedConversations' | 'estimatedSatisfactionAvg' | 'analysisCostMicroUsd' | 'failedAnalyses' | 'analysesTruncated' | 'agentScoreAvg' | 'agentScoreAvgBand' | 'agentClarityAvg' | 'customerEffortScoreAvg' | 'escalatedToHuman' | 'escalatedToFlow' | 'escalatedTargetUndeclared' | 'humanRequestedTurns' | 'costMicroUsd' | 'costMicroUsdPerResolvedConversation' | 'unpricedTurns' | 'inputTokens' | 'outputTokens' | 'totalTokens' | 'cachedInputTokens' | 'cachedTurns' | 'llmCalls' | 'avgTurnDurationMs' | 'p95TurnDurationMs' | 'avgLlmLatencyMs' | 'turns' | 'answeredTurns' | 'answeredWithFailedConnectionTurns' | 'unansweredTurns' | 'unansweredDefinition' | 'blockedTurns' | 'haltedTurns' | 'budgetExceededTurns' | 'identificationRequiredTurns' | 'toolCalls' | 'toolCallsFailed' | 'knowledgeRetrieved' | 'knowledgeEmpty' | 'knowledgeUnavailable' | 'knowledgeSkipped'> & {
     conversationsByClassification: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     classificationBreakdown: Array<Pick<AiAgentClassificationCount, 'state' | 'subcategory' | 'technicalFailure' | 'count'>>;
+    classificationDefinitionVersions: Array<Pick<AiAgentMetricsCount, 'key' | 'count'>>;
     sentimentAtStart: Array<Pick<AiAgentSentimentCount, 'key' | 'count'>>;
     sentimentAtEnd: Array<Pick<AiAgentSentimentCount, 'key' | 'count'>>;
     riskAlerts: Array<Pick<AiAgentRiskAlertCount, 'key' | 'count'>>;
@@ -2247,7 +2252,7 @@ export declare const AiAgentDashboardSentimentFragmentDoc = "\n    fragment aiAg
 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  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  analyzedConversations\n  estimatedSatisfactionAvg\n  sentimentAtStart {\n    key\n    count\n  }\n  sentimentAtEnd {\n    key\n    count\n  }\n  riskAlerts {\n    key\n    count\n  }\n  topKnowledgeGaps {\n    key\n    count\n  }\n  analysisCostMicroUsd\n  failedAnalyses\n  analysesTruncated\n  agentScoreAvg\n  agentScoreAvgBand\n  agentScoreBands {\n    key\n    count\n  }\n  agentClarityAvg\n  customerEffortScoreAvg\n  contactReasons {\n    all {\n      key\n      count\n    }\n    handoff {\n      key\n      count\n    }\n    abandonment {\n      key\n      count\n    }\n  }\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
+export declare const 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  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    ";
@@ -2287,7 +2292,7 @@ export declare const SaveAiAgentScenarioDocument = "\n    mutation saveAiAgentSc
 export declare const CheckAiAgentVersionDocument = "\n    mutation checkAiAgentVersion($input: CheckAiAgentVersionInput!) {\n  checkAiAgentVersion(input: $input) {\n    ...aiAgentCheckRun\n  }\n}\n    \n    fragment aiAgentCheckRun on AiAgentCheckRun {\n  runId\n  agentId\n  version\n  status\n  requestedAt\n  startedAt\n  finishedAt\n  totalRuns\n  completedRuns\n  error\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\n      handoffReasons {\n        key\n        count\n      }\n      turns {\n        turn\n        runs\n        answered\n        grounded\n        blocked\n        identificationRequired\n        toolNames {\n          key\n          count\n        }\n        blockCategories {\n          key\n          count\n        }\n      }\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 export declare const GetAiAgentCheckRunDocument = "\n    query getAiAgentCheckRun($agentId: ID!, $runId: ID!) {\n  getAiAgentCheckRun(agentId: $agentId, runId: $runId) {\n    ...aiAgentCheckRun\n  }\n}\n    \n    fragment aiAgentCheckRun on AiAgentCheckRun {\n  runId\n  agentId\n  version\n  status\n  requestedAt\n  startedAt\n  finishedAt\n  totalRuns\n  completedRuns\n  error\n  excludedTools {\n    ...aiAgentToolExclusion\n  }\n  result {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      cut\n      measured\n      passed\n      rate\n      handoffReasons {\n        key\n        count\n      }\n      turns {\n        turn\n        runs\n        answered\n        grounded\n        blocked\n        identificationRequired\n        toolNames {\n          key\n          count\n        }\n        blockCategories {\n          key\n          count\n        }\n      }\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    \n\n    fragment aiAgentToolExclusion on AiAgentToolExclusion {\n  toolId\n  reason\n}\n    ";
 export declare const AiAgentCheckLimitsDocument = "\n    query aiAgentCheckLimits($agentId: ID!) {\n  aiAgentCheckLimits(agentId: $agentId) {\n    minRunsPerScenario\n    maxRunsPerScenario\n    maxSuiteRuns\n    scenarioCount\n  }\n}\n    ";
-export declare const AiAgentMetricsDocument = "\n    query aiAgentMetrics($input: AiAgentMetricsInput!) {\n  aiAgentMetrics(input: $input) {\n    ...aiAgentMetricsReport\n  }\n}\n    \n    fragment aiAgentMetricsReport on AiAgentMetrics {\n  agentId\n  from\n  to\n  truncated\n  conversations\n  conversationsResolved\n  conversationsInconclusive\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  conversationsByClassification {\n    key\n    count\n  }\n  classificationBreakdown {\n    state\n    subcategory\n    technicalFailure\n    count\n  }\n  conversationsEligible\n  conversationsResolvedByDefinition\n  resolvedRate\n  unresolvedRate\n  handoffProcedureRate\n  handoffNeedRate\n  abandonmentRate\n  classificationDefinitionVersion\n  analyzedConversations\n  estimatedSatisfactionAvg\n  sentimentAtStart {\n    key\n    count\n  }\n  sentimentAtEnd {\n    key\n    count\n  }\n  riskAlerts {\n    key\n    count\n  }\n  topKnowledgeGaps {\n    key\n    count\n  }\n  analysisCostMicroUsd\n  failedAnalyses\n  analysesTruncated\n  agentScoreAvg\n  agentScoreAvgBand\n  agentScoreBands {\n    key\n    count\n  }\n  agentClarityAvg\n  customerEffortScoreAvg\n  contactReasons {\n    all {\n      key\n      count\n    }\n    handoff {\n      key\n      count\n    }\n    abandonment {\n      key\n      count\n    }\n  }\n  escalatedToHuman\n  escalatedToFlow\n  escalatedTargetUndeclared\n  handoffsByReason {\n    key\n    count\n  }\n  humanRequestedTurns\n  costMicroUsd\n  costMicroUsdPerResolvedConversation\n  unpricedTurns\n  inputTokens\n  outputTokens\n  totalTokens\n  cachedInputTokens\n  cachedTurns\n  llmCalls\n  turnsByModel {\n    key\n    count\n  }\n  avgTurnDurationMs\n  p95TurnDurationMs\n  avgLlmLatencyMs\n  turns\n  answeredTurns\n  answeredWithFailedConnectionTurns\n  unansweredTurns\n  unansweredDefinition\n  topTopics {\n    key\n    count\n  }\n  topUnansweredQuestions {\n    key\n    count\n  }\n  blockedTurns\n  blocksByCategory {\n    key\n    count\n  }\n  haltedTurns\n  haltReasons {\n    key\n    count\n  }\n  budgetExceededTurns\n  identificationRequiredTurns\n  toolCalls\n  toolCallsFailed\n  toolErrorsByConnection {\n    key\n    count\n  }\n  toolErrorsByClass {\n    key\n    count\n  }\n  knowledgeRetrieved\n  knowledgeEmpty\n  knowledgeUnavailable\n  knowledgeSkipped\n}\n    ";
+export declare const 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  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

@@ -567,6 +567,10 @@ exports.AiAgentMetricsReportFragmentDoc = `
   handoffNeedRate
   abandonmentRate
   classificationDefinitionVersion
+  classificationDefinitionVersions {
+    key
+    count
+  }
   analyzedConversations
   estimatedSatisfactionAvg
   sentimentAtStart {