@droz-js/sdk 0.19.23 → 0.19.25

package/package.json

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

package/src/drozai.d.ts

@@ -93,6 +93,12 @@ declare const DrozAi_base: new (options?: import("./client/http").HttpClientOpti
     aiAgentVersionSpec(variables: import("./sdks/ai").Exact<{
         agentId: import("./sdks/ai").Scalars["ID"]["input"];
     }>, options?: unknown): Promise<import("./sdks/ai").AiAgentVersionSpecQuery>;
+    aiAgentRoutingPreview(variables: import("./sdks/ai").Exact<{
+        input: import("./sdks/ai").AiAgentRoutingPreviewInput;
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentRoutingPreviewQuery>;
+    aiAgentKnowledgeBases(variables: import("./sdks/ai").Exact<{
+        credentialRef: import("./sdks/ai").Scalars["ID"]["input"];
+    }>, options?: unknown): Promise<import("./sdks/ai").AiAgentKnowledgeBasesQuery>;
     extractImageMetadata(variables: import("./sdks/ai").Exact<{
         input: import("./sdks/ai").ExtractImageMetadataInput;
     }>, options?: unknown): Promise<import("./sdks/ai").ExtractImageMetadataMutation>;

package/src/sdks/ai.d.ts

@@ -229,6 +229,10 @@ export type AiAgentIdentityInput = {
     tone: TonePreset;
     toneNotes?: InputMaybe<Scalars['String']['input']>;
 };
+export type AiAgentKnowledgeBase = {
+    id: Scalars['ID']['output'];
+    title: Scalars['String']['output'];
+};
 export type AiAgentMetrics = {
     agentId: Scalars['ID']['output'];
     answeredTurns: Scalars['Number']['output'];
@@ -378,6 +382,26 @@ export type AiAgentRetentionPolicy = {
     days: AiAgentRetentionDays;
     masksPersonalData: Scalars['Boolean']['output'];
 };
+export type AiAgentRoutedExample = {
+    /** `high`, `medium` ou `low`. */
+    confidence: Scalars['String']['output'];
+    message: Scalars['String']['output'];
+    score: Scalars['Number']['output'];
+    /** Ausente quando nenhum caso de uso reconheceu a mensagem. */
+    useCaseId?: Maybe<Scalars['ID']['output']>;
+};
+export type AiAgentRoutingPreview = {
+    examples: Array<AiAgentRoutedExample>;
+    /** Limiar de confianca alta. */
+    high: Scalars['Number']['output'];
+    /** Limiar de confianca media; abaixo dele a previa nao aponta caso de uso. */
+    medium: Scalars['Number']['output'];
+};
+export type AiAgentRoutingPreviewInput = {
+    agentId: Scalars['ID']['input'];
+    /** Mensagens que o autor quer testar. Vazio devolve previa vazia, nao erro. */
+    examples: Array<Scalars['String']['input']>;
+};
 export type AiAgentScenario = {
     description: Scalars['String']['output'];
     expectations: Array<Scalars['JSON']['output']>;
@@ -402,7 +426,13 @@ export type AiAgentSpec = {
     channels?: Maybe<Array<Scalars['String']['output']>>;
     handoff?: Maybe<AiAgentHandoff>;
     identity: AiAgentIdentity;
+    /**
+     * §4.8: bases do Droz Base vinculadas — ids de **space**, nao de credencial. A consulta e recortada
+     * por elas; sem recorte o agente varreria o acervo inteiro do tenant.
+     */
     knowledgeBaseIds: Array<Scalars['ID']['output']>;
+    /** Credencial do Droz Base. Obrigatoria quando ha base vinculada. */
+    knowledgeCredentialRef?: Maybe<Scalars['ID']['output']>;
     /** `inform_limitation` (default) ou `general_knowledge`; ausente vale o mais restritivo. */
     knowledgeFallback?: Maybe<Scalars['String']['output']>;
     toolIds: Array<Scalars['ID']['output']>;
@@ -414,7 +444,13 @@ export type AiAgentSpecInput = {
     channels?: InputMaybe<Array<Scalars['String']['input']>>;
     handoff?: InputMaybe<AiAgentHandoffInput>;
     identity: AiAgentIdentityInput;
+    /**
+     * §4.8: bases do Droz Base vinculadas — ids de **space**, nao de credencial. A consulta e recortada
+     * por elas; sem recorte o agente varreria o acervo inteiro do tenant.
+     */
     knowledgeBaseIds: Array<Scalars['ID']['input']>;
+    /** Credencial do Droz Base. Obrigatoria quando ha base vinculada. */
+    knowledgeCredentialRef?: InputMaybe<Scalars['ID']['input']>;
     /** `inform_limitation` (default) ou `general_knowledge`; ausente vale o mais restritivo. */
     knowledgeFallback?: InputMaybe<Scalars['String']['input']>;
     toolIds: Array<Scalars['ID']['input']>;
@@ -769,6 +805,11 @@ export type QnAInstance = {
 export type Query = {
     aiAgentConversationMetrics: Array<AiAgentConversationMetrics>;
     aiAgentConversationOutcome?: Maybe<AiAgentConversationOutcome>;
+    /**
+     * §4.8: as bases do Droz Base que a credencial enxerga. Quem lista e quem consulta e a mesma
+     * credencial — o autor escolhe o que o agente vai alcancar, nao uma lista maior.
+     */
+    aiAgentKnowledgeBases: Array<AiAgentKnowledgeBase>;
     aiAgentMetrics: AiAgentMetrics;
     /** As metricas da janela para todos os agentes, numa ida so. Agente sem rastro vem com zeros. */
     aiAgentMetricsByAgent: Array<AiAgentMetrics>;
@@ -777,6 +818,8 @@ export type Query = {
      * configurou a propria. Existe para a politica ser verificavel de fora, nao so estar escrita.
      */
     aiAgentRetentionPolicy: AiAgentRetentionPolicy;
+    /** Onde cada mensagem de exemplo cairia (§5.4). Os limiares saem no resultado: `medium` sem o limiar nao diz nada. */
+    aiAgentRoutingPreview: AiAgentRoutingPreview;
     /**
      * 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.
@@ -811,12 +854,18 @@ export type QueryAiAgentConversationMetricsArgs = {
 export type QueryAiAgentConversationOutcomeArgs = {
     sessionId: Scalars['ID']['input'];
 };
+export type QueryAiAgentKnowledgeBasesArgs = {
+    credentialRef: Scalars['ID']['input'];
+};
 export type QueryAiAgentMetricsArgs = {
     input: AiAgentMetricsInput;
 };
 export type QueryAiAgentMetricsByAgentArgs = {
     input: AiAgentMetricsWindowInput;
 };
+export type QueryAiAgentRoutingPreviewArgs = {
+    input: AiAgentRoutingPreviewInput;
+};
 export type QueryAiAgentTraceArgs = {
     sessionId: Scalars['ID']['input'];
 };
@@ -1209,6 +1258,20 @@ export type AiAgentVersionSpecQueryVariables = Exact<{
 export type AiAgentVersionSpecQuery = {
     listAiAgentVersions: Array<AiAgentVersionWithSpecFragment>;
 };
+export type AiAgentRoutingPreviewQueryVariables = Exact<{
+    input: AiAgentRoutingPreviewInput;
+}>;
+export type AiAgentRoutingPreviewQuery = {
+    aiAgentRoutingPreview: (Pick<AiAgentRoutingPreview, 'high' | 'medium'> & {
+        examples: Array<Pick<AiAgentRoutedExample, 'message' | 'useCaseId' | 'score' | 'confidence'>>;
+    });
+};
+export type AiAgentKnowledgeBasesQueryVariables = Exact<{
+    credentialRef: Scalars['ID']['input'];
+}>;
+export type AiAgentKnowledgeBasesQuery = {
+    aiAgentKnowledgeBases: Array<Pick<AiAgentKnowledgeBase, 'id' | 'title'>>;
+};
 export type ExtractImageMetadataMutationVariables = Exact<{
     input: ExtractImageMetadataInput;
 }>;
@@ -1339,6 +1402,8 @@ export declare const SaveAiAgentScenarioDocument = "\n    mutation saveAiAgentSc
 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 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($credentialRef: ID!) {\n  aiAgentKnowledgeBases(credentialRef: $credentialRef) {\n    id\n    title\n  }\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    ";
@@ -1383,6 +1448,8 @@ export declare function getSdk<C>(requester: Requester<C>): {
     checkAiAgentVersion(variables: CheckAiAgentVersionMutationVariables, options?: C): Promise<CheckAiAgentVersionMutation>;
     aiAgentMetrics(variables: AiAgentMetricsQueryVariables, options?: C): Promise<AiAgentMetricsQuery>;
     aiAgentVersionSpec(variables: AiAgentVersionSpecQueryVariables, options?: C): Promise<AiAgentVersionSpecQuery>;
+    aiAgentRoutingPreview(variables: AiAgentRoutingPreviewQueryVariables, options?: C): Promise<AiAgentRoutingPreviewQuery>;
+    aiAgentKnowledgeBases(variables: AiAgentKnowledgeBasesQueryVariables, options?: C): Promise<AiAgentKnowledgeBasesQuery>;
     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

@@ -2,7 +2,7 @@
 /* istanbul ignore file */
 Object.defineProperty(exports, "__esModule", { value: true });
 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.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.AiAgentKnowledgeBasesDocument = exports.AiAgentRoutingPreviewDocument = exports.AiAgentVersionSpecDocument = void 0;
 exports.getSdk = getSdk;
 var AiAgentVersionStatus;
 (function (AiAgentVersionStatus) {
@@ -486,6 +486,28 @@ exports.AiAgentVersionSpecDocument = `
 }
     ${exports.AiAgentVersionWithSpecFragmentDoc}
 ${exports.AiAgentSpecFragmentDoc}`;
+exports.AiAgentRoutingPreviewDocument = `
+    query aiAgentRoutingPreview($input: AiAgentRoutingPreviewInput!) {
+  aiAgentRoutingPreview(input: $input) {
+    high
+    medium
+    examples {
+      message
+      useCaseId
+      score
+      confidence
+    }
+  }
+}
+    `;
+exports.AiAgentKnowledgeBasesDocument = `
+    query aiAgentKnowledgeBases($credentialRef: ID!) {
+  aiAgentKnowledgeBases(credentialRef: $credentialRef) {
+    id
+    title
+  }
+}
+    `;
 exports.ExtractImageMetadataDocument = `
     mutation extractImageMetadata($input: ExtractImageMetadataInput!) {
   extractImageMetadata(input: $input) {
@@ -680,6 +702,12 @@ function getSdk(requester) {
         aiAgentVersionSpec(variables, options) {
             return requester(exports.AiAgentVersionSpecDocument, variables, options);
         },
+        aiAgentRoutingPreview(variables, options) {
+            return requester(exports.AiAgentRoutingPreviewDocument, variables, options);
+        },
+        aiAgentKnowledgeBases(variables, options) {
+            return requester(exports.AiAgentKnowledgeBasesDocument, variables, options);
+        },
         extractImageMetadata(variables, options) {
             return requester(exports.ExtractImageMetadataDocument, variables, options);
         },