@droz-js/sdk 0.19.24 → 0.19.25

package/package.json

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

package/src/drozai.d.ts

@@ -96,6 +96,9 @@ declare const DrozAi_base: new (options?: import("./client/http").HttpClientOpti
     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'];
@@ -422,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']>;
@@ -434,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']>;
@@ -789,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>;
@@ -833,6 +854,9 @@ export type QueryAiAgentConversationMetricsArgs = {
 export type QueryAiAgentConversationOutcomeArgs = {
     sessionId: Scalars['ID']['input'];
 };
+export type QueryAiAgentKnowledgeBasesArgs = {
+    credentialRef: Scalars['ID']['input'];
+};
 export type QueryAiAgentMetricsArgs = {
     input: AiAgentMetricsInput;
 };
@@ -1242,6 +1266,12 @@ export type AiAgentRoutingPreviewQuery = {
         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;
 }>;
@@ -1373,6 +1403,7 @@ export declare const CheckAiAgentVersionDocument = "\n    mutation checkAiAgentV
 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    ";
@@ -1418,6 +1449,7 @@ export declare function getSdk<C>(requester: Requester<C>): {
     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.AiAgentRoutingPreviewDocument = 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) {
@@ -500,6 +500,14 @@ exports.AiAgentRoutingPreviewDocument = `
   }
 }
     `;
+exports.AiAgentKnowledgeBasesDocument = `
+    query aiAgentKnowledgeBases($credentialRef: ID!) {
+  aiAgentKnowledgeBases(credentialRef: $credentialRef) {
+    id
+    title
+  }
+}
+    `;
 exports.ExtractImageMetadataDocument = `
     mutation extractImageMetadata($input: ExtractImageMetadataInput!) {
   extractImageMetadata(input: $input) {
@@ -697,6 +705,9 @@ function getSdk(requester) {
         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);
         },