@droz-js/sdk 0.19.20 → 0.19.21

package/package.json

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

package/src/sdks/ai.d.ts

@@ -127,17 +127,408 @@ export type AgentInfo = {
     name: Scalars['String']['output'];
     picture?: Maybe<Scalars['String']['output']>;
 };
+export type AiAgentAuthoringRefInput = {
+    agentId: Scalars['ID']['input'];
+    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']>;
+    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;
+};
+export type AiAgentBudgetInput = {
+    maxCostMicroUsd?: InputMaybe<Scalars['Int']['input']>;
+    maxSteps: Scalars['Int']['input'];
+    maxTokens?: InputMaybe<Scalars['Int']['input']>;
+    maxToolCalls: Scalars['Int']['input'];
+    onExceeded: BudgetExceededAction;
+};
+export type AiAgentCheckResult = {
+    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 AiAgentCompetingPair = {
+    left: Scalars['ID']['output'];
+    right: Scalars['ID']['output'];
+    /** Similaridade entre as duas descricoes, de 0 a 1. */
+    score: Scalars['Number']['output'];
+};
+export type AiAgentConversationMetrics = {
+    channel?: Maybe<Scalars['String']['output']>;
+    costMicroUsd: Scalars['Number']['output'];
+    durationMs: Scalars['Number']['output'];
+    lastOutcome: Scalars['String']['output'];
+    lastTurnAt: Scalars['Number']['output'];
+    sessionId: Scalars['ID']['output'];
+    startedAt: Scalars['Number']['output'];
+    totalTokens: Scalars['Number']['output'];
+    turns: Scalars['Number']['output'];
+};
+export type AiAgentConversationOutcome = {
+    agentId: Scalars['ID']['output'];
+    agentVersion: Scalars['String']['output'];
+    /** 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'];
+    /** Motivo da parada do ultimo turno, quando houve. */
+    haltReason?: Maybe<Scalars['String']['output']>;
+    lastTurnAt: Scalars['Number']['output'];
+    resolution: Scalars['String']['output'];
+    resolutionDefinition: Scalars['String']['output'];
+    sessionId: Scalars['ID']['output'];
+    startedAt: Scalars['Number']['output'];
+    turns: Scalars['Number']['output'];
+};
+/**
+ * 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 = {
+    transition: Scalars['String']['output'];
+};
+export type AiAgentHandoffInput = {
+    transition: Scalars['String']['input'];
+};
+export type AiAgentIdentity = {
+    displayName: Scalars['String']['output'];
+    openingMessage?: Maybe<Scalars['String']['output']>;
+    outOfScopeBehaviour: Scalars['String']['output'];
+    role: Scalars['String']['output'];
+    tone: TonePreset;
+    toneNotes?: Maybe<Scalars['String']['output']>;
+};
+export type AiAgentIdentityInput = {
+    displayName: Scalars['String']['input'];
+    openingMessage?: InputMaybe<Scalars['String']['input']>;
+    outOfScopeBehaviour: Scalars['String']['input'];
+    role: Scalars['String']['input'];
+    tone: TonePreset;
+    toneNotes?: InputMaybe<Scalars['String']['input']>;
+};
+export type AiAgentMetrics = {
+    agentId: Scalars['ID']['output'];
+    answeredTurns: Scalars['Number']['output'];
+    avgLlmLatencyMs: Scalars['Number']['output'];
+    avgTurnDurationMs: Scalars['Number']['output'];
+    budgetExceededTurns: Scalars['Number']['output'];
+    conversations: 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'];
+    /** Conversas resolvidas sob a regra declarada em `resolutionDefinition`. */
+    conversationsResolved: Scalars['Number']['output'];
+    /** Gasto da janela em micro-dolar (1e-6 USD), inteiro. */
+    costMicroUsd: Scalars['Number']['output'];
+    from: Scalars['Number']['output'];
+    haltReasons: Array<AiAgentMetricsCount>;
+    haltedTurns: Scalars['Number']['output'];
+    /** 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'];
+    knowledgeRetrieved: Scalars['Number']['output'];
+    knowledgeSkipped: Scalars['Number']['output'];
+    knowledgeUnavailable: Scalars['Number']['output'];
+    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'];
+    /**
+     * 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.
+     */
+    resolutionRate?: Maybe<Scalars['Number']['output']>;
+    to: Scalars['Number']['output'];
+    toolCalls: Scalars['Number']['output'];
+    /** Chamadas de ferramenta que falharam. */
+    toolCallsFailed: Scalars['Number']['output'];
+    /** Falhas por classe: timeout, upstream, nao configurada, sem identificacao. */
+    toolErrorsByClass: Array<AiAgentMetricsCount>;
+    /** Falhas por conexao externa, identificada pelo host — responde "qual integracao esta caindo". */
+    toolErrorsByConnection: 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>;
+    /**
+     * 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'];
+};
+export type AiAgentMetricsCount = {
+    count: Scalars['Number']['output'];
+    key: Scalars['String']['output'];
+};
+export type AiAgentMetricsInput = {
+    agentId: Scalars['ID']['input'];
+    channel?: InputMaybe<Scalars['String']['input']>;
+    from: Scalars['Number']['input'];
+    to: Scalars['Number']['input'];
+};
+/** A mesma janela, sem agente: a listagem quer todos de uma vez. */
+export type AiAgentMetricsWindowInput = {
+    channel?: InputMaybe<Scalars['String']['input']>;
+    from: Scalars['Number']['input'];
+    to: Scalars['Number']['input'];
+};
+export type AiAgentProcedure = {
+    contingency: Scalars['String']['output'];
+    /** `autonomous` ou `needsApproval`. Ferramenta irreversivel exige `needsApproval`. */
+    executionAutonomy: 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'];
+    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'];
+};
+export type AiAgentRegression = {
+    after: Scalars['Float']['output'];
+    before: Scalars['Float']['output'];
+    scenarioId: Scalars['ID']['output'];
+};
+export type AiAgentRetentionDays = {
+    long_term_memory: Scalars['Int']['output'];
+    session_state: Scalars['Int']['output'];
+    transcript: Scalars['Int']['output'];
+};
+export type AiAgentRetentionPolicy = {
+    days: AiAgentRetentionDays;
+    masksPersonalData: Scalars['Boolean']['output'];
+};
+export type AiAgentScenario = {
+    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 = {
+    passed: Scalars['Int']['output'];
+    /** Fração de execuções em que todas as expectativas valeram, 0..1. */
+    rate: Scalars['Float']['output'];
+    runs: Scalars['Int']['output'];
+    scenarioId: Scalars['ID']['output'];
+};
+export type AiAgentSpec = {
+    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']>>;
+    handoff?: Maybe<AiAgentHandoff>;
+    identity: AiAgentIdentity;
+    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']>;
+};
+export type AiAgentSpecInput = {
+    budget: AiAgentBudgetInput;
+    can: Array<Scalars['String']['input']>;
+    cannot: Array<Scalars['String']['input']>;
+    channels?: InputMaybe<Array<Scalars['String']['input']>>;
+    handoff?: InputMaybe<AiAgentHandoffInput>;
+    identity: AiAgentIdentityInput;
+    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']>;
+};
+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 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;
+    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 AiAgentToolParameter = {
+    description: Scalars['String']['output'];
+    grounding: ParameterGrounding;
+    name: Scalars['String']['output'];
+    required: Scalars['Boolean']['output'];
+    type: ToolParameterType;
+};
+export type AiAgentToolParameterInput = {
+    description: Scalars['String']['input'];
+    groundedBy?: InputMaybe<Array<Scalars['String']['input']>>;
+    grounding?: InputMaybe<ParameterGrounding>;
+    name: Scalars['String']['input'];
+    required: Scalars['Boolean']['input'];
+    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'];
+    effect: ToolEffect;
+    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'];
+};
+export type AiAgentTrace = {
+    agentId: Scalars['ID']['output'];
+    agentVersion: Scalars['String']['output'];
+    answer: Scalars['String']['output'];
+    /** 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']>;
+    outcome: Scalars['String']['output'];
+    promptBuilderVersion: Scalars['Int']['output'];
+    /** Identifica o prompt que gerou este turno sem guardar o prompt inteiro. */
+    promptFingerprint: Scalars['String']['output'];
+    sessionId: Scalars['ID']['output'];
+    startedAt: Scalars['Float']['output'];
+    steps: Scalars['Int']['output'];
+    toolCalls: Array<AiAgentTracedToolCall>;
+    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']>;
+    /** `unauthenticated`, `not_configured`, `timeout` ou `upstream`. */
+    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'];
+};
+export type AiAgentUseCase = {
+    id: Scalars['ID']['output'];
+    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'];
+    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'];
+};
+export type AiAgentVersion = {
+    agentId: Scalars['ID']['output'];
+    createdAt: Scalars['DateTime']['output'];
+    spec: AiAgentSpec;
+    status: AiAgentVersionStatus;
+    version: Scalars['Int']['output'];
+};
+export type AiAgentVersionRefInput = {
+    agentId: Scalars['ID']['input'];
+    version: Scalars['Int']['input'];
+};
+export declare enum AiAgentVersionStatus {
+    Draft = "draft",
+    Live = "live",
+    Published = "published",
+    Removed = "removed"
+}
 export declare enum AppInstanceStatus {
     Active = "Active",
     Failing = "Failing",
     Inactive = "Inactive"
 }
+export declare enum BudgetExceededAction {
+    EndWithNotice = "end_with_notice",
+    TransferToHuman = "transfer_to_human"
+}
 export declare enum Can {
     Manage = "manage",
     Read = "read",
     Remove = "remove",
     Write = "write"
 }
+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']>;
+    version: Scalars['Int']['input'];
+};
 export type CreateNlpInstanceInput = {
     name: Scalars['String']['input'];
     options: Array<NlpOptionInput>;
@@ -147,6 +538,17 @@ export type CreateQnAInstanceInput = {
     name: Scalars['String']['input'];
     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;
+};
 export type ExtractImageMetadataInput = {
     imageUrl: Scalars['String']['input'];
     metadataRequirements: Scalars['JSONObject']['input'];
@@ -166,30 +568,89 @@ export type I18nTextInput = {
     value: Scalars['String']['input'];
 };
 export type Mutation = {
+    /** Roda os cenários contra uma versão candidata e registra o resultado. Custa chamadas de modelo. */
+    checkAiAgentVersion?: Maybe<AiAgentCheckResult>;
     createNlpInstance?: Maybe<NlpInstance>;
     createQnAInstance?: Maybe<QnAInstance>;
+    draftAiAgent?: Maybe<AiAgentVersion>;
     extractImageMetadata: ExtractImageMetadataResult;
+    publishAiAgentVersion: Array<AiAgentVersion>;
+    registerAiAgentTool?: Maybe<AiAgentTool>;
+    removeAiAgentProcedure: 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;
+    /** 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>;
     updateQnAInstance?: Maybe<QnAInstance>;
     version?: Maybe<Scalars['String']['output']>;
 };
+export type MutationCheckAiAgentVersionArgs = {
+    input: CheckAiAgentVersionInput;
+};
 export type MutationCreateNlpInstanceArgs = {
     input: CreateNlpInstanceInput;
 };
 export type MutationCreateQnAInstanceArgs = {
     input: CreateQnAInstanceInput;
 };
+export type MutationDraftAiAgentArgs = {
+    input: DraftAiAgentInput;
+};
 export type MutationExtractImageMetadataArgs = {
     input: ExtractImageMetadataInput;
 };
+export type MutationPublishAiAgentVersionArgs = {
+    input: AiAgentVersionRefInput;
+};
+export type MutationRegisterAiAgentToolArgs = {
+    input: RegisterAiAgentToolInput;
+};
+export type MutationRemoveAiAgentProcedureArgs = {
+    input: AiAgentAuthoringRefInput;
+};
+export type MutationRemoveAiAgentUseCaseArgs = {
+    input: AiAgentAuthoringRefInput;
+};
+export type MutationRemoveAiAgentVersionArgs = {
+    input: AiAgentVersionRefInput;
+};
 export type MutationRemoveNlpInstanceArgs = {
     input: RemoveNlpInstanceInput;
 };
 export type MutationRemoveQnAInstanceArgs = {
     input: RemoveQnAInstanceInput;
 };
+export type MutationResolveAiAgentApprovalArgs = {
+    input: ResolveAiAgentApprovalInput;
+};
+export type MutationRollbackAiAgentVersionArgs = {
+    input: AiAgentVersionRefInput;
+};
+export type MutationSaveAiAgentProcedureArgs = {
+    input: SaveAiAgentProcedureInput;
+};
+export type MutationSaveAiAgentScenarioArgs = {
+    input: SaveAiAgentScenarioInput;
+};
+export type MutationSaveAiAgentUseCaseArgs = {
+    input: SaveAiAgentUseCaseInput;
+};
+export type MutationUnpublishAiAgentVersionArgs = {
+    input: AiAgentVersionRefInput;
+};
+export type MutationUnregisterAiAgentToolArgs = {
+    input: UnregisterAiAgentToolInput;
+};
 export type MutationUpdateNlpInstanceArgs = {
     input: UpdateNlpInstanceInput;
 };
@@ -234,6 +695,10 @@ export type PageInfo = {
     hasNext: Scalars['Boolean']['output'];
     next?: Maybe<Scalars['Base64']['output']>;
 };
+export declare enum ParameterGrounding {
+    Free = "free",
+    Required = "required"
+}
 export type QnAInstance = {
     createdAt: Scalars['DateTime']['output'];
     credentialsId: Scalars['ID']['output'];
@@ -244,22 +709,80 @@ export type QnAInstance = {
     updatedAt: Scalars['DateTime']['output'];
 };
 export type Query = {
+    aiAgentConversationMetrics: Array<AiAgentConversationMetrics>;
+    aiAgentConversationOutcome?: Maybe<AiAgentConversationOutcome>;
+    aiAgentMetrics: AiAgentMetrics;
+    /** As metricas da janela para todos os agentes, numa ida so. Agente sem rastro vem com zeros. */
+    aiAgentMetricsByAgent: Array<AiAgentMetrics>;
+    /**
+     * 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;
+    /**
+     * 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']>;
     getHttpEndpoint?: Maybe<Scalars['String']['output']>;
     getNlpInstance?: Maybe<NlpInstance>;
     getQnAInstance?: Maybe<QnAInstance>;
+    /** 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>;
     listNlpInstances: Array<NlpInstance>;
     listQnAInstances: Array<QnAInstance>;
     testNlpInstance?: Maybe<TestNlpInstanceResult>;
     testQnAInstance?: Maybe<TestQnAInstanceResult>;
     version?: Maybe<Scalars['String']['output']>;
 };
+export type QueryAiAgentConversationMetricsArgs = {
+    input: AiAgentMetricsInput;
+};
+export type QueryAiAgentConversationOutcomeArgs = {
+    sessionId: Scalars['ID']['input'];
+};
+export type QueryAiAgentMetricsArgs = {
+    input: AiAgentMetricsInput;
+};
+export type QueryAiAgentMetricsByAgentArgs = {
+    input: AiAgentMetricsWindowInput;
+};
+export type QueryAiAgentTraceArgs = {
+    sessionId: Scalars['ID']['input'];
+};
+export type QueryAiAgentUseCaseOverlapArgs = {
+    agentId: Scalars['ID']['input'];
+};
 export type QueryGetNlpInstanceArgs = {
     id: Scalars['ID']['input'];
 };
 export type QueryGetQnAInstanceArgs = {
     id: Scalars['ID']['input'];
 };
+export type QueryListAiAgentProceduresArgs = {
+    agentId: Scalars['ID']['input'];
+};
+export type QueryListAiAgentScenariosArgs = {
+    agentId: Scalars['ID']['input'];
+};
+export type QueryListAiAgentUseCasesArgs = {
+    agentId: Scalars['ID']['input'];
+};
+export type QueryListAiAgentVersionsArgs = {
+    agentId: Scalars['ID']['input'];
+};
 export type QueryTestNlpInstanceArgs = {
     id: Scalars['ID']['input'];
     sample: Scalars['String']['input'];
@@ -269,12 +792,53 @@ export type QueryTestQnAInstanceArgs = {
     id: Scalars['ID']['input'];
     input: Scalars['String']['input'];
 };
+export type RegisterAiAgentToolInput = {
+    method: Scalars['String']['input'];
+    spec: AiAgentToolSpecInput;
+    /** Pode conter {param} para parâmetros declarados e {customerId}. Precisa ser https e público. */
+    url: Scalars['String']['input'];
+};
 export type RemoveNlpInstanceInput = {
     id: Scalars['ID']['input'];
 };
 export type RemoveQnAInstanceInput = {
     id: Scalars['ID']['input'];
 };
+export type ResolveAiAgentApprovalInput = {
+    agentId: Scalars['ID']['input'];
+    decidedBy: 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'];
+};
+export type SaveAiAgentProcedureInput = {
+    agentId: Scalars['ID']['input'];
+    contingency: Scalars['String']['input'];
+    executionAutonomy: Scalars['String']['input'];
+    guidanceSteps: Array<Scalars['String']['input']>;
+    id: Scalars['ID']['input'];
+    name: Scalars['String']['input'];
+    status: Scalars['String']['input'];
+    toolIds: Array<Scalars['ID']['input']>;
+};
+export type SaveAiAgentScenarioInput = {
+    agentId: Scalars['ID']['input'];
+    description: Scalars['String']['input'];
+    /** Expectativas de comportamento. `blocked_by_rule` ainda não é observável e é recusada. */
+    expectations: Array<Scalars['JSON']['input']>;
+    scenarioId: Scalars['ID']['input'];
+    turns: Array<Scalars['String']['input']>;
+};
+export type SaveAiAgentUseCaseInput = {
+    agentId: Scalars['ID']['input'];
+    id: Scalars['ID']['input'];
+    name: Scalars['String']['input'];
+    procedureId?: InputMaybe<Scalars['ID']['input']>;
+    status: Scalars['String']['input'];
+    subjectDescription: Scalars['String']['input'];
+};
 export type SearchResultsFacet = {
     name: Scalars['String']['output'];
     stats?: Maybe<SearchResultsFacetStats>;
@@ -342,7 +906,37 @@ export type TokenUsage = {
     prompt?: Maybe<Scalars['Int']['output']>;
     total?: Maybe<Scalars['Int']['output']>;
 };
+export declare enum TonePreset {
+    Cordial = "cordial",
+    Descontraido = "descontraido",
+    Direto = "direto",
+    Formal = "formal",
+    Tecnico = "tecnico"
+}
+export declare enum ToolAvailability {
+    Available = "available",
+    Unavailable = "unavailable"
+}
+export declare enum ToolEffect {
+    Read = "read",
+    Write = "write"
+}
+export declare enum ToolParameterType {
+    Boolean = "boolean",
+    Number = "number",
+    String = "string"
+}
 export declare enum Typenames {
+    AiAgentApproval = "AiAgentApproval",
+    AiAgentEvalReport = "AiAgentEvalReport",
+    AiAgentProcedure = "AiAgentProcedure",
+    AiAgentRetentionPolicy = "AiAgentRetentionPolicy",
+    AiAgentScenario = "AiAgentScenario",
+    AiAgentSession = "AiAgentSession",
+    AiAgentTool = "AiAgentTool",
+    AiAgentTrace = "AiAgentTrace",
+    AiAgentUseCase = "AiAgentUseCase",
+    AiAgentVersion = "AiAgentVersion",
     Any = "Any",
     GraphqlConnections = "GraphqlConnections",
     GraphqlSubscriptions = "GraphqlSubscriptions",
@@ -350,6 +944,9 @@ export declare enum Typenames {
     NlpEmbeddings = "NlpEmbeddings",
     QnA = "QnA"
 }
+export type UnregisterAiAgentToolInput = {
+    toolId: Scalars['ID']['input'];
+};
 export type UpdateNlpInstanceInput = {
     id: Scalars['ID']['input'];
     name?: InputMaybe<Scalars['String']['input']>;

package/src/sdks/ai.js

@@ -1,14 +1,26 @@
 "use strict";
 /* istanbul ignore file */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serviceName = exports.RemoveQnAInstanceDocument = exports.UpdateQnAInstanceDocument = exports.CreateQnAInstanceDocument = exports.TestQnAInstanceDocument = exports.ListQnAInstancesDocument = exports.GetQnAInstanceDocument = exports.TestNlpInstanceDocument = exports.RemoveNlpInstanceDocument = exports.UpdateNlpInstanceDocument = exports.CreateNlpInstanceDocument = exports.ListNlpInstancesDocument = exports.GetNlpInstanceDocument = exports.ExtractImageMetadataDocument = exports.QnaFragmentFragmentDoc = exports.NlpInstanceFragmentDoc = exports.Typenames = exports.Can = exports.AppInstanceStatus = void 0;
+exports.serviceName = exports.RemoveQnAInstanceDocument = exports.UpdateQnAInstanceDocument = exports.CreateQnAInstanceDocument = exports.TestQnAInstanceDocument = exports.ListQnAInstancesDocument = exports.GetQnAInstanceDocument = exports.TestNlpInstanceDocument = exports.RemoveNlpInstanceDocument = exports.UpdateNlpInstanceDocument = exports.CreateNlpInstanceDocument = exports.ListNlpInstancesDocument = exports.GetNlpInstanceDocument = exports.ExtractImageMetadataDocument = exports.QnaFragmentFragmentDoc = exports.NlpInstanceFragmentDoc = exports.Typenames = exports.ToolParameterType = exports.ToolEffect = exports.ToolAvailability = exports.TonePreset = exports.ParameterGrounding = exports.Can = exports.BudgetExceededAction = exports.AppInstanceStatus = exports.AiAgentVersionStatus = void 0;
 exports.getSdk = getSdk;
+var AiAgentVersionStatus;
+(function (AiAgentVersionStatus) {
+    AiAgentVersionStatus["Draft"] = "draft";
+    AiAgentVersionStatus["Live"] = "live";
+    AiAgentVersionStatus["Published"] = "published";
+    AiAgentVersionStatus["Removed"] = "removed";
+})(AiAgentVersionStatus || (exports.AiAgentVersionStatus = AiAgentVersionStatus = {}));
 var AppInstanceStatus;
 (function (AppInstanceStatus) {
     AppInstanceStatus["Active"] = "Active";
     AppInstanceStatus["Failing"] = "Failing";
     AppInstanceStatus["Inactive"] = "Inactive";
 })(AppInstanceStatus || (exports.AppInstanceStatus = AppInstanceStatus = {}));
+var BudgetExceededAction;
+(function (BudgetExceededAction) {
+    BudgetExceededAction["EndWithNotice"] = "end_with_notice";
+    BudgetExceededAction["TransferToHuman"] = "transfer_to_human";
+})(BudgetExceededAction || (exports.BudgetExceededAction = BudgetExceededAction = {}));
 var Can;
 (function (Can) {
     Can["Manage"] = "manage";
@@ -16,8 +28,47 @@ var Can;
     Can["Remove"] = "remove";
     Can["Write"] = "write";
 })(Can || (exports.Can = Can = {}));
+var ParameterGrounding;
+(function (ParameterGrounding) {
+    ParameterGrounding["Free"] = "free";
+    ParameterGrounding["Required"] = "required";
+})(ParameterGrounding || (exports.ParameterGrounding = ParameterGrounding = {}));
+var TonePreset;
+(function (TonePreset) {
+    TonePreset["Cordial"] = "cordial";
+    TonePreset["Descontraido"] = "descontraido";
+    TonePreset["Direto"] = "direto";
+    TonePreset["Formal"] = "formal";
+    TonePreset["Tecnico"] = "tecnico";
+})(TonePreset || (exports.TonePreset = TonePreset = {}));
+var ToolAvailability;
+(function (ToolAvailability) {
+    ToolAvailability["Available"] = "available";
+    ToolAvailability["Unavailable"] = "unavailable";
+})(ToolAvailability || (exports.ToolAvailability = ToolAvailability = {}));
+var ToolEffect;
+(function (ToolEffect) {
+    ToolEffect["Read"] = "read";
+    ToolEffect["Write"] = "write";
+})(ToolEffect || (exports.ToolEffect = ToolEffect = {}));
+var ToolParameterType;
+(function (ToolParameterType) {
+    ToolParameterType["Boolean"] = "boolean";
+    ToolParameterType["Number"] = "number";
+    ToolParameterType["String"] = "string";
+})(ToolParameterType || (exports.ToolParameterType = ToolParameterType = {}));
 var Typenames;
 (function (Typenames) {
+    Typenames["AiAgentApproval"] = "AiAgentApproval";
+    Typenames["AiAgentEvalReport"] = "AiAgentEvalReport";
+    Typenames["AiAgentProcedure"] = "AiAgentProcedure";
+    Typenames["AiAgentRetentionPolicy"] = "AiAgentRetentionPolicy";
+    Typenames["AiAgentScenario"] = "AiAgentScenario";
+    Typenames["AiAgentSession"] = "AiAgentSession";
+    Typenames["AiAgentTool"] = "AiAgentTool";
+    Typenames["AiAgentTrace"] = "AiAgentTrace";
+    Typenames["AiAgentUseCase"] = "AiAgentUseCase";
+    Typenames["AiAgentVersion"] = "AiAgentVersion";
     Typenames["Any"] = "Any";
     Typenames["GraphqlConnections"] = "GraphqlConnections";
     Typenames["GraphqlSubscriptions"] = "GraphqlSubscriptions";