@droz-js/sdk 0.19.22 → 0.19.23

package/package.json

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

package/src/drozai.d.ts

@@ -33,6 +33,66 @@ declare const DrozAi_base: new (options?: import("./client/http").HttpClientOpti
     removeAiAgent(variables: import("./sdks/ai").Exact<{
         input: import("./sdks/ai").AiAgentRefInput;
     }>, options?: unknown): Promise<import("./sdks/ai").RemoveAiAgentMutation>;
+    listAiAgentUseCases(variables: import("./sdks/ai").Exact<{
+        agentId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").ListAiAgentUseCasesQuery>;
+    listAiAgentProcedures(variables: import("./sdks/ai").Exact<{
+        agentId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").ListAiAgentProceduresQuery>;
+    listAiAgentTools(variables?: import("./sdks/ai").Exact<{
+        [key: string]: never;
+    }>, options?: unknown): Promise<import("./sdks/ai").ListAiAgentToolsQuery>;
+    aiAgentUseCaseOverlap(variables: import("./sdks/ai").Exact<{
+        agentId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentUseCaseOverlapQuery>;
+    aiAgentTrace(variables: import("./sdks/ai").Exact<{
+        sessionId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentTraceQuery>;
+    listAiAgentScenarios(variables: import("./sdks/ai").Exact<{
+        agentId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").ListAiAgentScenariosQuery>;
+    aiAgentRetentionPolicy(variables?: import("./sdks/ai").Exact<{
+        [key: string]: never;
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentRetentionPolicyQuery>;
+    aiAgentConversationMetrics(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").AiAgentMetricsInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentConversationMetricsQuery>;
+    aiAgentConversationOutcome(variables: import("./sdks/ai").Exact<{
+        sessionId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentConversationOutcomeQuery>;
+    saveAiAgentUseCase(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").SaveAiAgentUseCaseInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").SaveAiAgentUseCaseMutation>;
+    saveAiAgentProcedure(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").SaveAiAgentProcedureInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").SaveAiAgentProcedureMutation>;
+    removeAiAgentUseCase(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").AiAgentAuthoringRefInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").RemoveAiAgentUseCaseMutation>;
+    removeAiAgentProcedure(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").AiAgentAuthoringRefInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").RemoveAiAgentProcedureMutation>;
+    resolveAiAgentApproval(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").ResolveAiAgentApprovalInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").ResolveAiAgentApprovalMutation>;
+    registerAiAgentTool(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").RegisterAiAgentToolInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").RegisterAiAgentToolMutation>;
+    unregisterAiAgentTool(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").UnregisterAiAgentToolInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").UnregisterAiAgentToolMutation>;
+    saveAiAgentScenario(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").SaveAiAgentScenarioInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").SaveAiAgentScenarioMutation>;
+    checkAiAgentVersion(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").CheckAiAgentVersionInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").CheckAiAgentVersionMutation>;
+    aiAgentMetrics(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").AiAgentMetricsInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentMetricsQuery>;
+    aiAgentVersionSpec(variables: import("./sdks/ai").Exact<{
+        agentId: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentVersionSpecQuery>;
     extractImageMetadata(variables: import("./sdks/ai").Exact<{
         input: import("./sdks/ai").ExtractImageMetadataInput;
     }>, options?: unknown): Promise<import("./sdks/ai").ExtractImageMetadataMutation>;

package/src/sdks/ai.d.ts

@@ -138,6 +138,11 @@ export type AiAgentBudget = {
      * que sempre vale.
      */
     maxCostMicroUsd?: Maybe<Scalars['Int']['output']>;
+    /**
+     * Teto de gasto do agente no periodo (mes calendario UTC), em micro-dolar. Ausente = sem teto de
+     * periodo. Independe de `maxCostMicroUsd`, que vale por conversa.
+     */
+    maxPeriodCostMicroUsd?: Maybe<Scalars['Int']['output']>;
     maxSteps: Scalars['Int']['output'];
     /** Teto de token da conversa inteira. Ausente = sem teto de token. */
     maxTokens?: Maybe<Scalars['Int']['output']>;
@@ -146,6 +151,7 @@ export type AiAgentBudget = {
 };
 export type AiAgentBudgetInput = {
     maxCostMicroUsd?: InputMaybe<Scalars['Int']['input']>;
+    maxPeriodCostMicroUsd?: InputMaybe<Scalars['Int']['input']>;
     maxSteps: Scalars['Int']['input'];
     maxTokens?: InputMaybe<Scalars['Int']['input']>;
     maxToolCalls: Scalars['Int']['input'];
@@ -199,9 +205,12 @@ export type AiAgentConversationOutcome = {
  * autor para dizer onde procura-la, em vez de prometer transferencia que nao acontece.
  */
 export type AiAgentHandoff = {
+    /** `human` ou `flow`. Ausente = nao declarado: a metrica conta a parte, sem supor destino. */
+    target?: Maybe<Scalars['String']['output']>;
     transition: Scalars['String']['output'];
 };
 export type AiAgentHandoffInput = {
+    target?: InputMaybe<Scalars['String']['input']>;
     transition: Scalars['String']['input'];
 };
 export type AiAgentIdentity = {
@@ -223,9 +232,24 @@ export type AiAgentIdentityInput = {
 export type AiAgentMetrics = {
     agentId: Scalars['ID']['output'];
     answeredTurns: Scalars['Number']['output'];
+    /**
+     * Turnos que responderam mesmo com uma conexao falha no meio. E a superficie de risco do guardrail de
+     * §4.7 — nao prova resposta inventada, mas e onde ela poderia acontecer.
+     */
+    answeredWithFailedConnectionTurns: Scalars['Number']['output'];
     avgLlmLatencyMs: Scalars['Number']['output'];
     avgTurnDurationMs: Scalars['Number']['output'];
+    /** Turnos cuja resposta foi bloqueada na validacao antes do envio. */
+    blockedTurns: Scalars['Number']['output'];
+    blocksByCategory: Array<AiAgentMetricsCount>;
     budgetExceededTurns: Scalars['Number']['output'];
+    /**
+     * Entrada servida pelo cache do proprio provedor: quanto do contexto nao foi pago a preco cheio.
+     * Provedor que nao reporta cache vale zero.
+     */
+    cachedInputTokens: Scalars['Number']['output'];
+    /** Turnos respondidos pelo cache, sem chamada ao modelo. E o ganho da otimizacao de §4.9. */
+    cachedTurns: Scalars['Number']['output'];
     conversations: Scalars['Number']['output'];
     /**
      * Conversas em que algum turno **pediu** uma pessoa. Pedido, nao confirmacao: o disparo da transicao
@@ -242,6 +266,20 @@ export type AiAgentMetrics = {
     conversationsResolved: Scalars['Number']['output'];
     /** Gasto da janela em micro-dolar (1e-6 USD), inteiro. */
     costMicroUsd: Scalars['Number']['output'];
+    /**
+     * Gasto da janela dividido pelas conversas resolvidas, em micro-dolar. **Ausente** quando nenhuma
+     * conversa resolveu no periodo — dividir por zero nao vira zero.
+     */
+    costMicroUsdPerResolvedConversation?: Maybe<Scalars['Number']['output']>;
+    /**
+     * Escalonou, mas a transicao nao tem destino declarado. Fica a parte de proposito: somar a um dos
+     * dois lados seria supor para onde o fluxo do tenant leva.
+     */
+    escalatedTargetUndeclared: Scalars['Number']['output'];
+    /** Escalonamentos cujo destino o autor declarou como fluxo. */
+    escalatedToFlow: Scalars['Number']['output'];
+    /** Escalonamentos cujo destino o autor declarou como pessoa. */
+    escalatedToHuman: Scalars['Number']['output'];
     from: Scalars['Number']['output'];
     haltReasons: Array<AiAgentMetricsCount>;
     haltedTurns: Scalars['Number']['output'];
@@ -272,11 +310,22 @@ export type AiAgentMetrics = {
     toolErrorsByClass: Array<AiAgentMetricsCount>;
     /** Falhas por conexao externa, identificada pelo host — responde "qual integracao esta caindo". */
     toolErrorsByConnection: Array<AiAgentMetricsCount>;
+    /** Assuntos mais frequentes da janela, escolhidos no conjunto fechado do `can` de cada agente. */
+    topTopics: Array<AiAgentMetricsCount>;
+    /** As perguntas mais frequentes sem resposta, agrupadas por texto normalizado. */
+    topUnansweredQuestions: Array<AiAgentMetricsCount>;
     totalTokens: Scalars['Number']['output'];
     /** true quando o teto de leitura foi atingido: os numeros cobrem parte do periodo. */
     truncated: Scalars['Boolean']['output'];
     turns: Scalars['Number']['output'];
     turnsByModel: Array<AiAgentMetricsCount>;
+    /**
+     * A regra aplicada para contar turno sem resposta, junto do numero, para ele nao ser lido como cada
+     * um quiser. Deterministica: qualidade da resposta nao e medivel aqui.
+     */
+    unansweredDefinition: Scalars['String']['output'];
+    /** Turnos sem resposta satisfatoria sob a regra declarada em `unansweredDefinition`. */
+    unansweredTurns: Scalars['Number']['output'];
     /**
      * Turnos com ao menos uma chamada ao modelo sem preco conhecido. Com isto > 0, `costMicroUsd` e
      * **piso**, nao total — nao decidir preco sem olhar este numero.
@@ -517,6 +566,7 @@ export declare enum AppInstanceStatus {
     Inactive = "Inactive"
 }
 export declare enum BudgetExceededAction {
+    DegradeModel = "degrade_model",
     EndWithNotice = "end_with_notice",
     TransferToHuman = "transfer_to_human"
 }
@@ -935,12 +985,14 @@ export declare enum ToolParameterType {
     String = "string"
 }
 export declare enum Typenames {
+    AiAgentAnswerCache = "AiAgentAnswerCache",
     AiAgentApproval = "AiAgentApproval",
     AiAgentEvalReport = "AiAgentEvalReport",
     AiAgentProcedure = "AiAgentProcedure",
     AiAgentRetentionPolicy = "AiAgentRetentionPolicy",
     AiAgentScenario = "AiAgentScenario",
     AiAgentSession = "AiAgentSession",
+    AiAgentSpend = "AiAgentSpend",
     AiAgentTool = "AiAgentTool",
     AiAgentTrace = "AiAgentTrace",
     AiAgentUseCase = "AiAgentUseCase",
@@ -968,6 +1020,14 @@ export type UpdateQnAInstanceInput = {
 };
 export type AiAgentSummaryFragment = Pick<AiAgentSummary, 'agentId' | 'name' | 'liveVersion' | 'channels' | 'updatedAt' | 'queuedApprovals' | 'status'>;
 export type AiAgentVersionFragment = Pick<AiAgentVersion, 'agentId' | 'version' | 'status' | 'createdAt'>;
+export type AiAgentSpecFragment = (Pick<AiAgentSpec, 'can' | 'cannot' | 'knowledgeBaseIds' | 'knowledgeFallback' | 'toolIds' | 'channels'> & {
+    identity: Pick<AiAgentIdentity, 'displayName' | 'role' | 'tone' | 'toneNotes' | 'openingMessage' | 'outOfScopeBehaviour'>;
+    budget: Pick<AiAgentBudget, 'maxSteps' | 'maxToolCalls' | 'maxTokens' | 'maxCostMicroUsd' | 'maxPeriodCostMicroUsd' | 'onExceeded'>;
+    handoff?: Maybe<Pick<AiAgentHandoff, 'transition' | 'target'>>;
+});
+export type AiAgentVersionWithSpecFragment = (Pick<AiAgentVersion, 'agentId' | 'version' | 'status' | 'createdAt'> & {
+    spec: AiAgentSpecFragment;
+});
 export type AiAgentListingMetricsFragment = Pick<AiAgentMetrics, 'agentId' | 'conversations' | 'conversationsResolved' | 'conversationsHandoffRequested' | 'resolutionRate' | 'resolutionDefinition' | 'costMicroUsd'>;
 export type ListAiAgentsQueryVariables = Exact<{
     [key: string]: never;
@@ -1021,6 +1081,134 @@ export type RemoveAiAgentMutationVariables = Exact<{
     input: AiAgentRefInput;
 }>;
 export type RemoveAiAgentMutation = Pick<Mutation, 'removeAiAgent'>;
+export type AiAgentUseCaseFragment = Pick<AiAgentUseCase, 'id' | 'name' | 'subjectDescription' | 'procedureId' | 'status' | 'updatedAt'>;
+export type AiAgentProcedureFragment = Pick<AiAgentProcedure, 'id' | 'name' | 'guidanceSteps' | 'toolIds' | 'contingency' | 'executionAutonomy' | 'status' | 'updatedAt'>;
+export type AiAgentToolFragment = (Pick<AiAgentTool, 'toolId' | 'name' | 'description' | 'effect' | 'availability' | 'requiresAuthenticatedCustomer' | 'onFailure' | 'customerScope' | 'returns' | 'approval'> & {
+    parameters: Array<Pick<AiAgentToolParameter, 'name' | 'type' | 'required' | 'description' | 'grounding'>>;
+});
+export type AiAgentTraceFragment = (Pick<AiAgentTrace, 'sessionId' | 'turn' | 'agentId' | 'agentVersion' | 'input' | 'promptBuilderVersion' | 'masterRuleVersion' | 'identificationRequired' | 'promptFingerprint' | 'knowledgeOrigins' | 'outcome' | 'haltReason' | 'steps' | 'answer' | 'startedAt'> & {
+    toolCalls: Array<Pick<AiAgentTracedToolCall, 'toolId' | 'name' | 'result' | 'ok' | 'connection' | 'errorClass'>>;
+});
+export type AiAgentScenarioFragment = Pick<AiAgentScenario, 'scenarioId' | 'description' | 'turns' | 'expectations'>;
+export type ListAiAgentUseCasesQueryVariables = Exact<{
+    agentId: Scalars['ID']['input'];
+}>;
+export type ListAiAgentUseCasesQuery = {
+    listAiAgentUseCases: Array<AiAgentUseCaseFragment>;
+};
+export type ListAiAgentProceduresQueryVariables = Exact<{
+    agentId: Scalars['ID']['input'];
+}>;
+export type ListAiAgentProceduresQuery = {
+    listAiAgentProcedures: Array<AiAgentProcedureFragment>;
+};
+export type ListAiAgentToolsQueryVariables = Exact<{
+    [key: string]: never;
+}>;
+export type ListAiAgentToolsQuery = {
+    listAiAgentTools: Array<AiAgentToolFragment>;
+};
+export type AiAgentUseCaseOverlapQueryVariables = Exact<{
+    agentId: Scalars['ID']['input'];
+}>;
+export type AiAgentUseCaseOverlapQuery = {
+    aiAgentUseCaseOverlap: (Pick<AiAgentUseCaseOverlap, 'threshold'> & {
+        pairs: Array<Pick<AiAgentCompetingPair, 'left' | 'right' | 'score'>>;
+    });
+};
+export type AiAgentTraceQueryVariables = Exact<{
+    sessionId: Scalars['ID']['input'];
+}>;
+export type AiAgentTraceQuery = {
+    aiAgentTrace: Array<AiAgentTraceFragment>;
+};
+export type ListAiAgentScenariosQueryVariables = Exact<{
+    agentId: Scalars['ID']['input'];
+}>;
+export type ListAiAgentScenariosQuery = {
+    listAiAgentScenarios: Array<AiAgentScenarioFragment>;
+};
+export type AiAgentRetentionPolicyQueryVariables = Exact<{
+    [key: string]: never;
+}>;
+export type AiAgentRetentionPolicyQuery = {
+    aiAgentRetentionPolicy: (Pick<AiAgentRetentionPolicy, 'masksPersonalData'> & {
+        days: Pick<AiAgentRetentionDays, 'transcript' | 'session_state' | 'long_term_memory'>;
+    });
+};
+export type AiAgentConversationMetricsQueryVariables = Exact<{
+    input: AiAgentMetricsInput;
+}>;
+export type AiAgentConversationMetricsQuery = {
+    aiAgentConversationMetrics: Array<Pick<AiAgentConversationMetrics, 'sessionId' | 'channel' | 'turns' | 'startedAt' | 'lastTurnAt' | 'totalTokens' | 'costMicroUsd' | 'durationMs' | 'lastOutcome'>>;
+};
+export type AiAgentConversationOutcomeQueryVariables = Exact<{
+    sessionId: Scalars['ID']['input'];
+}>;
+export type AiAgentConversationOutcomeQuery = {
+    aiAgentConversationOutcome?: Maybe<Pick<AiAgentConversationOutcome, 'sessionId' | 'agentId' | 'agentVersion' | 'resolution' | 'resolutionDefinition' | 'collectedData' | 'collectedDataAvailable' | 'turns' | 'startedAt' | 'lastTurnAt' | 'haltReason'>>;
+};
+export type SaveAiAgentUseCaseMutationVariables = Exact<{
+    input: SaveAiAgentUseCaseInput;
+}>;
+export type SaveAiAgentUseCaseMutation = {
+    saveAiAgentUseCase: AiAgentUseCaseFragment;
+};
+export type SaveAiAgentProcedureMutationVariables = Exact<{
+    input: SaveAiAgentProcedureInput;
+}>;
+export type SaveAiAgentProcedureMutation = {
+    saveAiAgentProcedure: AiAgentProcedureFragment;
+};
+export type RemoveAiAgentUseCaseMutationVariables = Exact<{
+    input: AiAgentAuthoringRefInput;
+}>;
+export type RemoveAiAgentUseCaseMutation = Pick<Mutation, 'removeAiAgentUseCase'>;
+export type RemoveAiAgentProcedureMutationVariables = Exact<{
+    input: AiAgentAuthoringRefInput;
+}>;
+export type RemoveAiAgentProcedureMutation = Pick<Mutation, 'removeAiAgentProcedure'>;
+export type ResolveAiAgentApprovalMutationVariables = Exact<{
+    input: ResolveAiAgentApprovalInput;
+}>;
+export type ResolveAiAgentApprovalMutation = Pick<Mutation, 'resolveAiAgentApproval'>;
+export type RegisterAiAgentToolMutationVariables = Exact<{
+    input: RegisterAiAgentToolInput;
+}>;
+export type RegisterAiAgentToolMutation = {
+    registerAiAgentTool?: Maybe<AiAgentToolFragment>;
+};
+export type UnregisterAiAgentToolMutationVariables = Exact<{
+    input: UnregisterAiAgentToolInput;
+}>;
+export type UnregisterAiAgentToolMutation = Pick<Mutation, 'unregisterAiAgentTool'>;
+export type SaveAiAgentScenarioMutationVariables = Exact<{
+    input: SaveAiAgentScenarioInput;
+}>;
+export type SaveAiAgentScenarioMutation = {
+    saveAiAgentScenario?: Maybe<AiAgentScenarioFragment>;
+};
+export type CheckAiAgentVersionMutationVariables = Exact<{
+    input: CheckAiAgentVersionInput;
+}>;
+export type CheckAiAgentVersionMutation = {
+    checkAiAgentVersion?: Maybe<(Pick<AiAgentCheckResult, 'safeToPublish'> & {
+        reports: Array<Pick<AiAgentScenarioReport, 'scenarioId' | 'runs' | 'passed' | 'rate'>>;
+        regressions: Array<Pick<AiAgentRegression, 'scenarioId' | 'before' | 'after'>>;
+    })>;
+};
+export type AiAgentMetricsQueryVariables = Exact<{
+    input: AiAgentMetricsInput;
+}>;
+export type AiAgentMetricsQuery = {
+    aiAgentMetrics: AiAgentListingMetricsFragment;
+};
+export type AiAgentVersionSpecQueryVariables = Exact<{
+    agentId: Scalars['ID']['input'];
+}>;
+export type AiAgentVersionSpecQuery = {
+    listAiAgentVersions: Array<AiAgentVersionWithSpecFragment>;
+};
 export type ExtractImageMetadataMutationVariables = Exact<{
     input: ExtractImageMetadataInput;
 }>;
@@ -1112,7 +1300,14 @@ export type RemoveQnAInstanceMutation = {
 };
 export declare const AiAgentSummaryFragmentDoc = "\n    fragment aiAgentSummary on AiAgentSummary {\n  agentId\n  name\n  liveVersion\n  channels\n  updatedAt\n  queuedApprovals\n  status\n}\n    ";
 export declare const AiAgentVersionFragmentDoc = "\n    fragment aiAgentVersion on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n}\n    ";
+export declare const AiAgentSpecFragmentDoc = "\n    fragment aiAgentSpec on AiAgentSpec {\n  identity {\n    displayName\n    role\n    tone\n    toneNotes\n    openingMessage\n    outOfScopeBehaviour\n  }\n  can\n  cannot\n  knowledgeBaseIds\n  knowledgeFallback\n  toolIds\n  budget {\n    maxSteps\n    maxToolCalls\n    maxTokens\n    maxCostMicroUsd\n    maxPeriodCostMicroUsd\n    onExceeded\n  }\n  handoff {\n    transition\n    target\n  }\n  channels\n}\n    ";
+export declare const AiAgentVersionWithSpecFragmentDoc = "\n    fragment aiAgentVersionWithSpec on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n  spec {\n    ...aiAgentSpec\n  }\n}\n    ";
 export declare const AiAgentListingMetricsFragmentDoc = "\n    fragment aiAgentListingMetrics on AiAgentMetrics {\n  agentId\n  conversations\n  conversationsResolved\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  costMicroUsd\n}\n    ";
+export declare const AiAgentUseCaseFragmentDoc = "\n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\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  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  }\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  turns\n  expectations\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    ";
@@ -1124,6 +1319,26 @@ export declare const UnpublishAiAgentVersionDocument = "\n    mutation unpublish
 export declare const RollbackAiAgentVersionDocument = "\n    mutation rollbackAiAgentVersion($input: AiAgentVersionRefInput!) {\n  rollbackAiAgentVersion(input: $input) {\n    ...aiAgentVersion\n  }\n}\n    \n    fragment aiAgentVersion on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n}\n    ";
 export declare const RemoveAiAgentVersionDocument = "\n    mutation removeAiAgentVersion($input: AiAgentVersionRefInput!) {\n  removeAiAgentVersion(input: $input) {\n    ...aiAgentVersion\n  }\n}\n    \n    fragment aiAgentVersion on AiAgentVersion {\n  agentId\n  version\n  status\n  createdAt\n}\n    ";
 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  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  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  }\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!) {\n  aiAgentTrace(sessionId: $sessionId) {\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  toolCalls {\n    toolId\n    name\n    result\n    ok\n    connection\n    errorClass\n  }\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  turns\n  expectations\n}\n    ";
+export declare const AiAgentRetentionPolicyDocument = "\n    query aiAgentRetentionPolicy {\n  aiAgentRetentionPolicy {\n    days {\n      transcript\n      session_state\n      long_term_memory\n    }\n    masksPersonalData\n  }\n}\n    ";
+export declare const AiAgentConversationMetricsDocument = "\n    query aiAgentConversationMetrics($input: AiAgentMetricsInput!) {\n  aiAgentConversationMetrics(input: $input) {\n    sessionId\n    channel\n    turns\n    startedAt\n    lastTurnAt\n    totalTokens\n    costMicroUsd\n    durationMs\n    lastOutcome\n  }\n}\n    ";
+export declare const AiAgentConversationOutcomeDocument = "\n    query aiAgentConversationOutcome($sessionId: ID!) {\n  aiAgentConversationOutcome(sessionId: $sessionId) {\n    sessionId\n    agentId\n    agentVersion\n    resolution\n    resolutionDefinition\n    collectedData\n    collectedDataAvailable\n    turns\n    startedAt\n    lastTurnAt\n    haltReason\n  }\n}\n    ";
+export declare const SaveAiAgentUseCaseDocument = "\n    mutation saveAiAgentUseCase($input: SaveAiAgentUseCaseInput!) {\n  saveAiAgentUseCase(input: $input) {\n    ...aiAgentUseCase\n  }\n}\n    \n    fragment aiAgentUseCase on AiAgentUseCase {\n  id\n  name\n  subjectDescription\n  procedureId\n  status\n  updatedAt\n}\n    ";
+export declare const SaveAiAgentProcedureDocument = "\n    mutation saveAiAgentProcedure($input: SaveAiAgentProcedureInput!) {\n  saveAiAgentProcedure(input: $input) {\n    ...aiAgentProcedure\n  }\n}\n    \n    fragment aiAgentProcedure on AiAgentProcedure {\n  id\n  name\n  guidanceSteps\n  toolIds\n  contingency\n  executionAutonomy\n  status\n  updatedAt\n}\n    ";
+export declare const RemoveAiAgentUseCaseDocument = "\n    mutation removeAiAgentUseCase($input: AiAgentAuthoringRefInput!) {\n  removeAiAgentUseCase(input: $input)\n}\n    ";
+export declare const RemoveAiAgentProcedureDocument = "\n    mutation removeAiAgentProcedure($input: AiAgentAuthoringRefInput!) {\n  removeAiAgentProcedure(input: $input)\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  }\n}\n    ";
+export declare const UnregisterAiAgentToolDocument = "\n    mutation unregisterAiAgentTool($input: UnregisterAiAgentToolInput!) {\n  unregisterAiAgentTool(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  turns\n  expectations\n}\n    ";
+export declare const CheckAiAgentVersionDocument = "\n    mutation checkAiAgentVersion($input: CheckAiAgentVersionInput!) {\n  checkAiAgentVersion(input: $input) {\n    safeToPublish\n    reports {\n      scenarioId\n      runs\n      passed\n      rate\n    }\n    regressions {\n      scenarioId\n      before\n      after\n    }\n  }\n}\n    ";
+export declare const AiAgentMetricsDocument = "\n    query aiAgentMetrics($input: AiAgentMetricsInput!) {\n  aiAgentMetrics(input: $input) {\n    ...aiAgentListingMetrics\n  }\n}\n    \n    fragment aiAgentListingMetrics on AiAgentMetrics {\n  agentId\n  conversations\n  conversationsResolved\n  conversationsHandoffRequested\n  resolutionRate\n  resolutionDefinition\n  costMicroUsd\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    ";
 export declare const ExtractImageMetadataDocument = "\n    mutation extractImageMetadata($input: ExtractImageMetadataInput!) {\n  extractImageMetadata(input: $input) {\n    success\n    model\n    extractedMetadata\n    tokenUsage {\n      prompt\n      completion\n      total\n    }\n  }\n}\n    ";
 export declare const GetNlpInstanceDocument = "\n    query getNlpInstance($id: ID!) {\n  getNlpInstance(id: $id) {\n    ...nlpInstance\n  }\n}\n    \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 ListNlpInstancesDocument = "\n    query listNlpInstances {\n  listNlpInstances {\n    ...nlpInstance\n  }\n}\n    \n    fragment nlpInstance on NlpInstance {\n  id\n  name\n  drn\n  options {\n    transition\n    samples\n  }\n  createdAt\n  updatedAt\n}\n    ";
@@ -1148,6 +1363,26 @@ export declare function getSdk<C>(requester: Requester<C>): {
     rollbackAiAgentVersion(variables: RollbackAiAgentVersionMutationVariables, options?: C): Promise<RollbackAiAgentVersionMutation>;
     removeAiAgentVersion(variables: RemoveAiAgentVersionMutationVariables, options?: C): Promise<RemoveAiAgentVersionMutation>;
     removeAiAgent(variables: RemoveAiAgentMutationVariables, options?: C): Promise<RemoveAiAgentMutation>;
+    listAiAgentUseCases(variables: ListAiAgentUseCasesQueryVariables, options?: C): Promise<ListAiAgentUseCasesQuery>;
+    listAiAgentProcedures(variables: ListAiAgentProceduresQueryVariables, options?: C): Promise<ListAiAgentProceduresQuery>;
+    listAiAgentTools(variables?: ListAiAgentToolsQueryVariables, options?: C): Promise<ListAiAgentToolsQuery>;
+    aiAgentUseCaseOverlap(variables: AiAgentUseCaseOverlapQueryVariables, options?: C): Promise<AiAgentUseCaseOverlapQuery>;
+    aiAgentTrace(variables: AiAgentTraceQueryVariables, options?: C): Promise<AiAgentTraceQuery>;
+    listAiAgentScenarios(variables: ListAiAgentScenariosQueryVariables, options?: C): Promise<ListAiAgentScenariosQuery>;
+    aiAgentRetentionPolicy(variables?: AiAgentRetentionPolicyQueryVariables, options?: C): Promise<AiAgentRetentionPolicyQuery>;
+    aiAgentConversationMetrics(variables: AiAgentConversationMetricsQueryVariables, options?: C): Promise<AiAgentConversationMetricsQuery>;
+    aiAgentConversationOutcome(variables: AiAgentConversationOutcomeQueryVariables, options?: C): Promise<AiAgentConversationOutcomeQuery>;
+    saveAiAgentUseCase(variables: SaveAiAgentUseCaseMutationVariables, options?: C): Promise<SaveAiAgentUseCaseMutation>;
+    saveAiAgentProcedure(variables: SaveAiAgentProcedureMutationVariables, options?: C): Promise<SaveAiAgentProcedureMutation>;
+    removeAiAgentUseCase(variables: RemoveAiAgentUseCaseMutationVariables, options?: C): Promise<RemoveAiAgentUseCaseMutation>;
+    removeAiAgentProcedure(variables: RemoveAiAgentProcedureMutationVariables, options?: C): Promise<RemoveAiAgentProcedureMutation>;
+    resolveAiAgentApproval(variables: ResolveAiAgentApprovalMutationVariables, options?: C): Promise<ResolveAiAgentApprovalMutation>;
+    registerAiAgentTool(variables: RegisterAiAgentToolMutationVariables, options?: C): Promise<RegisterAiAgentToolMutation>;
+    unregisterAiAgentTool(variables: UnregisterAiAgentToolMutationVariables, options?: C): Promise<UnregisterAiAgentToolMutation>;
+    saveAiAgentScenario(variables: SaveAiAgentScenarioMutationVariables, options?: C): Promise<SaveAiAgentScenarioMutation>;
+    checkAiAgentVersion(variables: CheckAiAgentVersionMutationVariables, options?: C): Promise<CheckAiAgentVersionMutation>;
+    aiAgentMetrics(variables: AiAgentMetricsQueryVariables, options?: C): Promise<AiAgentMetricsQuery>;
+    aiAgentVersionSpec(variables: AiAgentVersionSpecQueryVariables, options?: C): Promise<AiAgentVersionSpecQuery>;
     extractImageMetadata(variables: ExtractImageMetadataMutationVariables, options?: C): Promise<ExtractImageMetadataMutation>;
     getNlpInstance(variables: GetNlpInstanceQueryVariables, options?: C): Promise<GetNlpInstanceQuery>;
     listNlpInstances(variables?: ListNlpInstancesQueryVariables, options?: C): Promise<ListNlpInstancesQuery>;

package/src/sdks/ai.js

@@ -1,7 +1,8 @@
 "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.RemoveAiAgentDocument = exports.RemoveAiAgentVersionDocument = exports.RollbackAiAgentVersionDocument = exports.UnpublishAiAgentVersionDocument = exports.PublishAiAgentVersionDocument = exports.DraftAiAgentDocument = exports.AiAgentMetricsByAgentDocument = exports.ListAiAgentVersionsDocument = exports.ListAiAgentsDocument = exports.QnaFragmentFragmentDoc = exports.NlpInstanceFragmentDoc = exports.AiAgentListingMetricsFragmentDoc = exports.AiAgentVersionFragmentDoc = exports.AiAgentSummaryFragmentDoc = exports.Typenames = exports.ToolParameterType = exports.ToolEffect = exports.ToolAvailability = exports.TonePreset = exports.ParameterGrounding = exports.Can = exports.BudgetExceededAction = exports.AppInstanceStatus = exports.AiAgentVersionStatus = void 0;
+exports.AiAgentMetricsDocument = exports.CheckAiAgentVersionDocument = exports.SaveAiAgentScenarioDocument = exports.UnregisterAiAgentToolDocument = exports.RegisterAiAgentToolDocument = exports.ResolveAiAgentApprovalDocument = exports.RemoveAiAgentProcedureDocument = exports.RemoveAiAgentUseCaseDocument = exports.SaveAiAgentProcedureDocument = exports.SaveAiAgentUseCaseDocument = exports.AiAgentConversationOutcomeDocument = exports.AiAgentConversationMetricsDocument = exports.AiAgentRetentionPolicyDocument = exports.ListAiAgentScenariosDocument = exports.AiAgentTraceDocument = exports.AiAgentUseCaseOverlapDocument = exports.ListAiAgentToolsDocument = exports.ListAiAgentProceduresDocument = exports.ListAiAgentUseCasesDocument = exports.RemoveAiAgentDocument = exports.RemoveAiAgentVersionDocument = exports.RollbackAiAgentVersionDocument = exports.UnpublishAiAgentVersionDocument = exports.PublishAiAgentVersionDocument = exports.DraftAiAgentDocument = exports.AiAgentMetricsByAgentDocument = exports.ListAiAgentVersionsDocument = exports.ListAiAgentsDocument = exports.QnaFragmentFragmentDoc = exports.NlpInstanceFragmentDoc = exports.AiAgentScenarioFragmentDoc = exports.AiAgentTraceFragmentDoc = exports.AiAgentToolFragmentDoc = exports.AiAgentProcedureFragmentDoc = exports.AiAgentUseCaseFragmentDoc = exports.AiAgentListingMetricsFragmentDoc = exports.AiAgentVersionWithSpecFragmentDoc = exports.AiAgentSpecFragmentDoc = exports.AiAgentVersionFragmentDoc = exports.AiAgentSummaryFragmentDoc = exports.Typenames = exports.ToolParameterType = exports.ToolEffect = exports.ToolAvailability = exports.TonePreset = exports.ParameterGrounding = exports.Can = exports.BudgetExceededAction = exports.AppInstanceStatus = exports.AiAgentVersionStatus = 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.AiAgentVersionSpecDocument = void 0;
 exports.getSdk = getSdk;
 var AiAgentVersionStatus;
 (function (AiAgentVersionStatus) {
@@ -18,6 +19,7 @@ var AppInstanceStatus;
 })(AppInstanceStatus || (exports.AppInstanceStatus = AppInstanceStatus = {}));
 var BudgetExceededAction;
 (function (BudgetExceededAction) {
+    BudgetExceededAction["DegradeModel"] = "degrade_model";
     BudgetExceededAction["EndWithNotice"] = "end_with_notice";
     BudgetExceededAction["TransferToHuman"] = "transfer_to_human";
 })(BudgetExceededAction || (exports.BudgetExceededAction = BudgetExceededAction = {}));
@@ -59,12 +61,14 @@ var ToolParameterType;
 })(ToolParameterType || (exports.ToolParameterType = ToolParameterType = {}));
 var Typenames;
 (function (Typenames) {
+    Typenames["AiAgentAnswerCache"] = "AiAgentAnswerCache";
     Typenames["AiAgentApproval"] = "AiAgentApproval";
     Typenames["AiAgentEvalReport"] = "AiAgentEvalReport";
     Typenames["AiAgentProcedure"] = "AiAgentProcedure";
     Typenames["AiAgentRetentionPolicy"] = "AiAgentRetentionPolicy";
     Typenames["AiAgentScenario"] = "AiAgentScenario";
     Typenames["AiAgentSession"] = "AiAgentSession";
+    Typenames["AiAgentSpend"] = "AiAgentSpend";
     Typenames["AiAgentTool"] = "AiAgentTool";
     Typenames["AiAgentTrace"] = "AiAgentTrace";
     Typenames["AiAgentUseCase"] = "AiAgentUseCase";
@@ -95,6 +99,47 @@ exports.AiAgentVersionFragmentDoc = `
   createdAt
 }
     `;
+exports.AiAgentSpecFragmentDoc = `
+    fragment aiAgentSpec on AiAgentSpec {
+  identity {
+    displayName
+    role
+    tone
+    toneNotes
+    openingMessage
+    outOfScopeBehaviour
+  }
+  can
+  cannot
+  knowledgeBaseIds
+  knowledgeFallback
+  toolIds
+  budget {
+    maxSteps
+    maxToolCalls
+    maxTokens
+    maxCostMicroUsd
+    maxPeriodCostMicroUsd
+    onExceeded
+  }
+  handoff {
+    transition
+    target
+  }
+  channels
+}
+    `;
+exports.AiAgentVersionWithSpecFragmentDoc = `
+    fragment aiAgentVersionWithSpec on AiAgentVersion {
+  agentId
+  version
+  status
+  createdAt
+  spec {
+    ...aiAgentSpec
+  }
+}
+    `;
 exports.AiAgentListingMetricsFragmentDoc = `
     fragment aiAgentListingMetrics on AiAgentMetrics {
   agentId
@@ -106,6 +151,84 @@ exports.AiAgentListingMetricsFragmentDoc = `
   costMicroUsd
 }
     `;
+exports.AiAgentUseCaseFragmentDoc = `
+    fragment aiAgentUseCase on AiAgentUseCase {
+  id
+  name
+  subjectDescription
+  procedureId
+  status
+  updatedAt
+}
+    `;
+exports.AiAgentProcedureFragmentDoc = `
+    fragment aiAgentProcedure on AiAgentProcedure {
+  id
+  name
+  guidanceSteps
+  toolIds
+  contingency
+  executionAutonomy
+  status
+  updatedAt
+}
+    `;
+exports.AiAgentToolFragmentDoc = `
+    fragment aiAgentTool on AiAgentTool {
+  toolId
+  name
+  description
+  effect
+  availability
+  requiresAuthenticatedCustomer
+  onFailure
+  customerScope
+  returns
+  approval
+  parameters {
+    name
+    type
+    required
+    description
+    grounding
+  }
+}
+    `;
+exports.AiAgentTraceFragmentDoc = `
+    fragment aiAgentTrace on AiAgentTrace {
+  sessionId
+  turn
+  agentId
+  agentVersion
+  input
+  promptBuilderVersion
+  masterRuleVersion
+  identificationRequired
+  promptFingerprint
+  knowledgeOrigins
+  outcome
+  haltReason
+  steps
+  answer
+  startedAt
+  toolCalls {
+    toolId
+    name
+    result
+    ok
+    connection
+    errorClass
+  }
+}
+    `;
+exports.AiAgentScenarioFragmentDoc = `
+    fragment aiAgentScenario on AiAgentScenario {
+  scenarioId
+  description
+  turns
+  expectations
+}
+    `;
 exports.NlpInstanceFragmentDoc = `
     fragment nlpInstance on NlpInstance {
   id
@@ -191,6 +314,178 @@ exports.RemoveAiAgentDocument = `
   removeAiAgent(input: $input)
 }
     `;
+exports.ListAiAgentUseCasesDocument = `
+    query listAiAgentUseCases($agentId: ID!) {
+  listAiAgentUseCases(agentId: $agentId) {
+    ...aiAgentUseCase
+  }
+}
+    ${exports.AiAgentUseCaseFragmentDoc}`;
+exports.ListAiAgentProceduresDocument = `
+    query listAiAgentProcedures($agentId: ID!) {
+  listAiAgentProcedures(agentId: $agentId) {
+    ...aiAgentProcedure
+  }
+}
+    ${exports.AiAgentProcedureFragmentDoc}`;
+exports.ListAiAgentToolsDocument = `
+    query listAiAgentTools {
+  listAiAgentTools {
+    ...aiAgentTool
+  }
+}
+    ${exports.AiAgentToolFragmentDoc}`;
+exports.AiAgentUseCaseOverlapDocument = `
+    query aiAgentUseCaseOverlap($agentId: ID!) {
+  aiAgentUseCaseOverlap(agentId: $agentId) {
+    threshold
+    pairs {
+      left
+      right
+      score
+    }
+  }
+}
+    `;
+exports.AiAgentTraceDocument = `
+    query aiAgentTrace($sessionId: ID!) {
+  aiAgentTrace(sessionId: $sessionId) {
+    ...aiAgentTrace
+  }
+}
+    ${exports.AiAgentTraceFragmentDoc}`;
+exports.ListAiAgentScenariosDocument = `
+    query listAiAgentScenarios($agentId: ID!) {
+  listAiAgentScenarios(agentId: $agentId) {
+    ...aiAgentScenario
+  }
+}
+    ${exports.AiAgentScenarioFragmentDoc}`;
+exports.AiAgentRetentionPolicyDocument = `
+    query aiAgentRetentionPolicy {
+  aiAgentRetentionPolicy {
+    days {
+      transcript
+      session_state
+      long_term_memory
+    }
+    masksPersonalData
+  }
+}
+    `;
+exports.AiAgentConversationMetricsDocument = `
+    query aiAgentConversationMetrics($input: AiAgentMetricsInput!) {
+  aiAgentConversationMetrics(input: $input) {
+    sessionId
+    channel
+    turns
+    startedAt
+    lastTurnAt
+    totalTokens
+    costMicroUsd
+    durationMs
+    lastOutcome
+  }
+}
+    `;
+exports.AiAgentConversationOutcomeDocument = `
+    query aiAgentConversationOutcome($sessionId: ID!) {
+  aiAgentConversationOutcome(sessionId: $sessionId) {
+    sessionId
+    agentId
+    agentVersion
+    resolution
+    resolutionDefinition
+    collectedData
+    collectedDataAvailable
+    turns
+    startedAt
+    lastTurnAt
+    haltReason
+  }
+}
+    `;
+exports.SaveAiAgentUseCaseDocument = `
+    mutation saveAiAgentUseCase($input: SaveAiAgentUseCaseInput!) {
+  saveAiAgentUseCase(input: $input) {
+    ...aiAgentUseCase
+  }
+}
+    ${exports.AiAgentUseCaseFragmentDoc}`;
+exports.SaveAiAgentProcedureDocument = `
+    mutation saveAiAgentProcedure($input: SaveAiAgentProcedureInput!) {
+  saveAiAgentProcedure(input: $input) {
+    ...aiAgentProcedure
+  }
+}
+    ${exports.AiAgentProcedureFragmentDoc}`;
+exports.RemoveAiAgentUseCaseDocument = `
+    mutation removeAiAgentUseCase($input: AiAgentAuthoringRefInput!) {
+  removeAiAgentUseCase(input: $input)
+}
+    `;
+exports.RemoveAiAgentProcedureDocument = `
+    mutation removeAiAgentProcedure($input: AiAgentAuthoringRefInput!) {
+  removeAiAgentProcedure(input: $input)
+}
+    `;
+exports.ResolveAiAgentApprovalDocument = `
+    mutation resolveAiAgentApproval($input: ResolveAiAgentApprovalInput!) {
+  resolveAiAgentApproval(input: $input)
+}
+    `;
+exports.RegisterAiAgentToolDocument = `
+    mutation registerAiAgentTool($input: RegisterAiAgentToolInput!) {
+  registerAiAgentTool(input: $input) {
+    ...aiAgentTool
+  }
+}
+    ${exports.AiAgentToolFragmentDoc}`;
+exports.UnregisterAiAgentToolDocument = `
+    mutation unregisterAiAgentTool($input: UnregisterAiAgentToolInput!) {
+  unregisterAiAgentTool(input: $input)
+}
+    `;
+exports.SaveAiAgentScenarioDocument = `
+    mutation saveAiAgentScenario($input: SaveAiAgentScenarioInput!) {
+  saveAiAgentScenario(input: $input) {
+    ...aiAgentScenario
+  }
+}
+    ${exports.AiAgentScenarioFragmentDoc}`;
+exports.CheckAiAgentVersionDocument = `
+    mutation checkAiAgentVersion($input: CheckAiAgentVersionInput!) {
+  checkAiAgentVersion(input: $input) {
+    safeToPublish
+    reports {
+      scenarioId
+      runs
+      passed
+      rate
+    }
+    regressions {
+      scenarioId
+      before
+      after
+    }
+  }
+}
+    `;
+exports.AiAgentMetricsDocument = `
+    query aiAgentMetrics($input: AiAgentMetricsInput!) {
+  aiAgentMetrics(input: $input) {
+    ...aiAgentListingMetrics
+  }
+}
+    ${exports.AiAgentListingMetricsFragmentDoc}`;
+exports.AiAgentVersionSpecDocument = `
+    query aiAgentVersionSpec($agentId: ID!) {
+  listAiAgentVersions(agentId: $agentId) {
+    ...aiAgentVersionWithSpec
+  }
+}
+    ${exports.AiAgentVersionWithSpecFragmentDoc}
+${exports.AiAgentSpecFragmentDoc}`;
 exports.ExtractImageMetadataDocument = `
     mutation extractImageMetadata($input: ExtractImageMetadataInput!) {
   extractImageMetadata(input: $input) {
@@ -325,6 +620,66 @@ function getSdk(requester) {
         removeAiAgent(variables, options) {
             return requester(exports.RemoveAiAgentDocument, variables, options);
         },
+        listAiAgentUseCases(variables, options) {
+            return requester(exports.ListAiAgentUseCasesDocument, variables, options);
+        },
+        listAiAgentProcedures(variables, options) {
+            return requester(exports.ListAiAgentProceduresDocument, variables, options);
+        },
+        listAiAgentTools(variables, options) {
+            return requester(exports.ListAiAgentToolsDocument, variables, options);
+        },
+        aiAgentUseCaseOverlap(variables, options) {
+            return requester(exports.AiAgentUseCaseOverlapDocument, variables, options);
+        },
+        aiAgentTrace(variables, options) {
+            return requester(exports.AiAgentTraceDocument, variables, options);
+        },
+        listAiAgentScenarios(variables, options) {
+            return requester(exports.ListAiAgentScenariosDocument, variables, options);
+        },
+        aiAgentRetentionPolicy(variables, options) {
+            return requester(exports.AiAgentRetentionPolicyDocument, variables, options);
+        },
+        aiAgentConversationMetrics(variables, options) {
+            return requester(exports.AiAgentConversationMetricsDocument, variables, options);
+        },
+        aiAgentConversationOutcome(variables, options) {
+            return requester(exports.AiAgentConversationOutcomeDocument, variables, options);
+        },
+        saveAiAgentUseCase(variables, options) {
+            return requester(exports.SaveAiAgentUseCaseDocument, variables, options);
+        },
+        saveAiAgentProcedure(variables, options) {
+            return requester(exports.SaveAiAgentProcedureDocument, variables, options);
+        },
+        removeAiAgentUseCase(variables, options) {
+            return requester(exports.RemoveAiAgentUseCaseDocument, variables, options);
+        },
+        removeAiAgentProcedure(variables, options) {
+            return requester(exports.RemoveAiAgentProcedureDocument, variables, options);
+        },
+        resolveAiAgentApproval(variables, options) {
+            return requester(exports.ResolveAiAgentApprovalDocument, variables, options);
+        },
+        registerAiAgentTool(variables, options) {
+            return requester(exports.RegisterAiAgentToolDocument, variables, options);
+        },
+        unregisterAiAgentTool(variables, options) {
+            return requester(exports.UnregisterAiAgentToolDocument, variables, options);
+        },
+        saveAiAgentScenario(variables, options) {
+            return requester(exports.SaveAiAgentScenarioDocument, variables, options);
+        },
+        checkAiAgentVersion(variables, options) {
+            return requester(exports.CheckAiAgentVersionDocument, variables, options);
+        },
+        aiAgentMetrics(variables, options) {
+            return requester(exports.AiAgentMetricsDocument, variables, options);
+        },
+        aiAgentVersionSpec(variables, options) {
+            return requester(exports.AiAgentVersionSpecDocument, variables, options);
+        },
         extractImageMetadata(variables, options) {
             return requester(exports.ExtractImageMetadataDocument, variables, options);
         },