donobu 2.20.1 → 2.22.0

package/dist/bindings/ToggleDonobuAnnotations.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToggleDonobuAnnotations = void 0;
+exports.SetDonobuAnnotations = void 0;
+const JsonUtils_1 = require("../utils/JsonUtils");
+const zod_1 = require("zod");
 /**
- * A binding that toggles the annotations on the page executing this callback.
+ * A binding that sets or unsets the annotations on the page executing this callback.
  * This is used for debugging purposes to show the interactable elements on the page
  * as understood by the Donobu engine.
  */
-class ToggleDonobuAnnotations {
+class SetDonobuAnnotations {
     static async register(pageInspector, browserContext) {
-        const instance = new ToggleDonobuAnnotations(pageInspector);
+        const instance = new SetDonobuAnnotations(pageInspector);
         await browserContext.exposeBinding(instance.name(), instance.call.bind(instance));
         return instance;
     }
@@ -16,13 +18,27 @@ class ToggleDonobuAnnotations {
         this.pageInspector = pageInspector;
     }
     name() {
-        return ToggleDonobuAnnotations.NAME;
+        return SetDonobuAnnotations.NAME;
     }
     async call(source, ...args) {
-        const isToggled = args[0];
+        let isToggled;
+        try {
+            isToggled = zod_1.z.boolean().parse(args[0]);
+        }
+        catch (error) {
+            await source.page.evaluate((message) => {
+                console.error(message);
+            }, `First argument must be a boolean value: ${error.message}`);
+            return;
+        }
         if (isToggled) {
             await this.pageInspector.attributeInteractableElements(source.page);
             await this.pageInspector.annotateInteractableElements(source.page);
+            const elements = await this.pageInspector.getAttributedInteractableElements(source.page);
+            const message = JSON.stringify(JsonUtils_1.JsonUtils.objectToJson(elements), null, 2);
+            await source.page.evaluate((message) => {
+                console.info(message);
+            }, message);
         }
         else {
             await this.pageInspector.removeDonobuAnnotations(source.page);
@@ -30,6 +46,6 @@ class ToggleDonobuAnnotations {
         return;
     }
 }
-exports.ToggleDonobuAnnotations = ToggleDonobuAnnotations;
-ToggleDonobuAnnotations.NAME = '__donobuToggleAnnotations';
+exports.SetDonobuAnnotations = SetDonobuAnnotations;
+SetDonobuAnnotations.NAME = '__donobuSetAnnotations';
 //# sourceMappingURL=ToggleDonobuAnnotations.js.map

package/dist/bindings/ToggleDonobuAnnotations.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToggleDonobuAnnotations.js","sourceRoot":"","sources":["../../src/bindings/ToggleDonobuAnnotations.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AACH,MAAa,uBAAuB;IAG3B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAC1B,aAA4B,EAC5B,cAA8B;QAE9B,MAAM,QAAQ,GAAG,IAAI,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,cAAc,CAAC,aAAa,CAChC,QAAQ,CAAC,IAAI,EAAE,EACf,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAC7B,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,YAAoC,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAE7D,IAAI;QACT,OAAO,uBAAuB,CAAC,IAAI,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,MAA6D,EAC7D,GAAG,IAAW;QAEd,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAY,CAAC;QAErC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,aAAa,CAAC,6BAA6B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpE,MAAM,IAAI,CAAC,aAAa,CAAC,4BAA4B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,OAAO;IACT,CAAC;;AAnCH,0DAoCC;AAnCwB,4BAAI,GAAG,2BAA2B,CAAC"}
+{"version":3,"file":"ToggleDonobuAnnotations.js","sourceRoot":"","sources":["../../src/bindings/ToggleDonobuAnnotations.ts"],"names":[],"mappings":";;;AACA,kDAA+C;AAG/C,6BAAkC;AAElC;;;;GAIG;AACH,MAAa,oBAAoB;IAGxB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAC1B,aAA4B,EAC5B,cAA8B;QAE9B,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,cAAc,CAAC,aAAa,CAChC,QAAQ,CAAC,IAAI,EAAE,EACf,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAC7B,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,YAAoC,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAE7D,IAAI;QACT,OAAO,oBAAoB,CAAC,IAAI,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,MAA6D,EAC7D,GAAG,IAAW;QAEd,IAAI,SAAkB,CAAC;QAEvB,IAAI,CAAC;YACH,SAAS,GAAG,OAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CACxB,CAAC,OAAO,EAAE,EAAE;gBACV,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC,EACD,2CAA4C,KAAkB,CAAC,OAAO,EAAE,CACzE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,aAAa,CAAC,6BAA6B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpE,MAAM,IAAI,CAAC,aAAa,CAAC,4BAA4B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,QAAQ,GACZ,MAAM,IAAI,CAAC,aAAa,CAAC,iCAAiC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,qBAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1E,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;gBACrC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,OAAO;IACT,CAAC;;AArDH,oDAsDC;AArDwB,yBAAI,GAAG,wBAAwB,CAAC"}

package/dist/clients/AnthropicAwsBedrockGptClient.d.ts

@@ -7,9 +7,8 @@ import { z } from 'zod';
  * @see https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude.html
  */
 export declare class AnthropicAwsBedrockGptClient extends GptClient {
-    private readonly anthropicAwsBedrockConfig;
     private readonly delegate;
-    constructor(anthropicAwsBedrockConfig: AnthropicAwsBedrockConfig);
+    constructor(config: AnthropicAwsBedrockConfig);
     ping(): Promise<void>;
     getMessage(messages: GptMessage[]): Promise<AssistantMessage>;
     getStructuredOutput(messages: GptMessage[], jsonSchema: z.ZodSchema<any>): Promise<StructuredOutputMessage>;

package/dist/clients/AnthropicAwsBedrockGptClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnthropicAwsBedrockGptClient.d.ts","sourceRoot":"","sources":["../../src/clients/AnthropicAwsBedrockGptClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,4BAA6B,SAAQ,SAAS;IAIvD,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAH5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;gBAGlB,yBAAyB,EAAE,yBAAyB;IAY1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM7D,mBAAmB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,uBAAuB,CAAC;IAOtB,YAAY,CACvB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,wBAAwB,CAAC;CAMrC"}
+{"version":3,"file":"AnthropicAwsBedrockGptClient.d.ts","sourceRoot":"","sources":["../../src/clients/AnthropicAwsBedrockGptClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,4BAA6B,SAAQ,SAAS;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;gBAElB,MAAM,EAAE,yBAAyB;IAWvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM7D,mBAAmB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,uBAAuB,CAAC;IAOtB,YAAY,CACvB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,wBAAwB,CAAC;CAMrC"}

package/dist/clients/AnthropicAwsBedrockGptClient.js

@@ -10,15 +10,14 @@ const MiscUtils_1 = require("../utils/MiscUtils");
  * @see https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude.html
  */
 class AnthropicAwsBedrockGptClient extends GptClient_1.GptClient {
-    constructor(anthropicAwsBedrockConfig) {
-        super(anthropicAwsBedrockConfig);
-        this.anthropicAwsBedrockConfig = anthropicAwsBedrockConfig;
+    constructor(config) {
+        super(config);
         const bedrock = (0, amazon_bedrock_1.createAmazonBedrock)({
-            region: anthropicAwsBedrockConfig.region,
-            accessKeyId: anthropicAwsBedrockConfig.accessKeyId,
-            secretAccessKey: anthropicAwsBedrockConfig.secretAccessKey,
+            region: config.region,
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
         });
-        const model = bedrock(anthropicAwsBedrockConfig.modelName);
+        const model = bedrock(config.modelName);
         this.delegate = new VercelAiGptClient_1.VercelAiGptClient(model);
     }
     async ping() {

package/dist/clients/AnthropicAwsBedrockGptClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnthropicAwsBedrockGptClient.js","sourceRoot":"","sources":["../../src/clients/AnthropicAwsBedrockGptClient.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAQpD,2DAA6D;AAC7D,2DAAwD;AACxD,kDAA+C;AAG/C;;;GAGG;AACH,MAAa,4BAA6B,SAAQ,qBAAS;IAGzD,YACmB,yBAAoD;QAErE,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAFhB,8BAAyB,GAAzB,yBAAyB,CAA2B;QAGrE,MAAM,OAAO,GAAG,IAAA,oCAAmB,EAAC;YAClC,MAAM,EAAE,yBAAyB,CAAC,MAAM;YACxC,WAAW,EAAE,yBAAyB,CAAC,WAAW;YAClD,eAAe,EAAE,yBAAyB,CAAC,eAAe;SAC3D,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,GAAG,IAAI,qCAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,QAAsB;QAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAC7B,qBAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAC9C,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAC9B,QAAsB,EACtB,UAA4B;QAE5B,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CACtC,qBAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAC7C,UAAU,CACX,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,QAAsB,EACtB,KAAmB;QAEnB,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAC/B,qBAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAC7C,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AA7CD,oEA6CC"}
+{"version":3,"file":"AnthropicAwsBedrockGptClient.js","sourceRoot":"","sources":["../../src/clients/AnthropicAwsBedrockGptClient.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAQpD,2DAA6D;AAC7D,2DAAwD;AACxD,kDAA+C;AAG/C;;;GAGG;AACH,MAAa,4BAA6B,SAAQ,qBAAS;IAGzD,YAAmB,MAAiC;QAClD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,IAAA,oCAAmB,EAAC;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,qCAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,QAAsB;QAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAC7B,qBAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAC9C,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAC9B,QAAsB,EACtB,UAA4B;QAE5B,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CACtC,qBAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAC7C,UAAU,CACX,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,QAAsB,EACtB,KAAmB;QAEnB,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAC/B,qBAAS,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAC7C,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AA3CD,oEA2CC"}

package/dist/clients/GoogleGptClient.d.ts

@@ -7,9 +7,8 @@ import { z } from 'zod';
  * @see https://ai.google.dev/api/all-methods#service:-generativelanguage.googleapis.com
  */
 export declare class GoogleGptClient extends GptClient {
-    private readonly googleGeminiConfig;
     private readonly delegate;
-    constructor(googleGeminiConfig: GoogleGeminiConfig);
+    constructor(config: GoogleGeminiConfig);
     ping(): Promise<void>;
     getMessage(messages: GptMessage[]): Promise<AssistantMessage>;
     getStructuredOutput(messages: GptMessage[], jsonSchema: z.ZodSchema<any>): Promise<StructuredOutputMessage>;

package/dist/clients/GoogleGptClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GoogleGptClient.d.ts","sourceRoot":"","sources":["../../src/clients/GoogleGptClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAGzB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAFtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;gBAED,kBAAkB,EAAE,kBAAkB;IAS7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM7D,mBAAmB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,uBAAuB,CAAC;IAYtB,YAAY,CACvB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,wBAAwB,CAAC;IAmBpC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAqC/B"}
+{"version":3,"file":"GoogleGptClient.d.ts","sourceRoot":"","sources":["../../src/clients/GoogleGptClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;gBAElB,MAAM,EAAE,kBAAkB;IAShC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAM7D,mBAAmB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,uBAAuB,CAAC;IAYtB,YAAY,CACvB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,wBAAwB,CAAC;IAmBpC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CAqC/B"}

package/dist/clients/GoogleGptClient.js

@@ -11,13 +11,12 @@ const zod_1 = require("zod");
  * @see https://ai.google.dev/api/all-methods#service:-generativelanguage.googleapis.com
  */
 class GoogleGptClient extends GptClient_1.GptClient {
-    constructor(googleGeminiConfig) {
-        super(googleGeminiConfig);
-        this.googleGeminiConfig = googleGeminiConfig;
+    constructor(config) {
+        super(config);
         const google = (0, google_1.createGoogleGenerativeAI)({
-            apiKey: googleGeminiConfig.apiKey,
+            apiKey: config.apiKey,
         });
-        const model = google(googleGeminiConfig.modelName);
+        const model = google(config.modelName);
         this.delegate = new VercelAiGptClient_1.VercelAiGptClient(model);
     }
     async ping() {

package/dist/clients/GoogleGptClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"GoogleGptClient.js","sourceRoot":"","sources":["../../src/clients/GoogleGptClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GoogleGptClient.js","sourceRoot":"","sources":["../../src/clients/GoogleGptClient.ts"],"names":[],"mappings":"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"}

package/dist/clients/VercelAiGptClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VercelAiGptClient.d.ts","sourceRoot":"","sources":["../../src/clients/VercelAiGptClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,aAAa,EAcd,MAAM,IAAI,CAAC;AAGZ,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAO5C,OAAO,CAAC,QAAQ,CAAC,KAAK;aACN,aAAa;IAP/B,gBAAuB,oCAAoC,SAAS;IAEpE;;OAEG;gBAEgB,KAAK,EAAE,aAAa,EACrB,aAAa,SAAyD;IAS3E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsB7D,mBAAmB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,uBAAuB,CAAC;IAuBtB,YAAY,CACvB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,wBAAwB,CAAC;IA4CpC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0F7B;;OAEG;YACW,yBAAyB;CA8BxC"}
+{"version":3,"file":"VercelAiGptClient.d.ts","sourceRoot":"","sources":["../../src/clients/VercelAiGptClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,aAAa,EAcd,MAAM,IAAI,CAAC;AAGZ,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAO5C,OAAO,CAAC,QAAQ,CAAC,KAAK;aACN,aAAa;IAP/B,gBAAuB,oCAAoC,SAAS;IAEpE;;OAEG;gBAEgB,KAAK,EAAE,aAAa,EACrB,aAAa,SAAyD;IAS3E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB7D,mBAAmB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,uBAAuB,CAAC;IAwBtB,YAAY,CACvB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,wBAAwB,CAAC;IA8CpC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0F7B;;OAEG;YACW,yBAAyB;CA8BxC"}

package/dist/clients/VercelAiGptClient.js

@@ -33,6 +33,7 @@ class VercelAiGptClient extends GptClient_1.GptClient {
                 temperature: 0,
                 maxTokens: 1,
                 abortSignal: AbortSignal.timeout(this.timeoutMillis),
+                experimental_telemetry: { isEnabled: false },
             });
         }
         catch (error) {
@@ -52,6 +53,7 @@ class VercelAiGptClient extends GptClient_1.GptClient {
                 messages: coreMessages,
                 temperature: 0,
                 abortSignal: AbortSignal.timeout(this.timeoutMillis),
+                experimental_telemetry: { isEnabled: false },
             });
             return {
                 type: 'assistant',
@@ -74,6 +76,7 @@ class VercelAiGptClient extends GptClient_1.GptClient {
                 temperature: 0,
                 output: 'object',
                 abortSignal: AbortSignal.timeout(this.timeoutMillis),
+                experimental_telemetry: { isEnabled: false },
             });
             return {
                 type: 'structured_output',
@@ -105,6 +108,7 @@ class VercelAiGptClient extends GptClient_1.GptClient {
                 temperature: 0,
                 toolChoice: 'required',
                 abortSignal: AbortSignal.timeout(this.timeoutMillis),
+                experimental_telemetry: { isEnabled: false },
             });
             // Map the tool calls to the expected format
             const proposedCalls = result.toolCalls.map((tc) => {

package/dist/clients/VercelAiGptClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"VercelAiGptClient.js","sourceRoot":"","sources":["../../src/clients/VercelAiGptClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VercelAiGptClient.js","sourceRoot":"","sources":["../../src/clients/VercelAiGptClient.ts"],"names":[],"mappings":"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"}

package/dist/esm/apis/AgentsApi.d.ts

@@ -1,13 +1,57 @@
 import { Request, Response } from 'express';
 import { AgentsManager } from '../managers/AgentsManager';
 /**
- * This API manages the mapping of Donobu agents to GPT configurations.
+ * API controller for managing the mapping between Donobu agents and GPT configurations.
+ *
+ * The AgentsApi provides endpoints for associating Donobu agents (like 'flow-runner')
+ * with specific GPT configurations. This mapping system allows flows to use different
+ * AI models and configurations based on their requirements. The API maintains a
+ * many-to-one relationship where multiple agents can reference the same GPT configuration,
+ * but each agent can only have one active configuration at a time.
+ *
+ * **Agent Types:**
+ * - `flow-runner`: The primary agent used for autonomous flow execution
+ *
+ * **Key Features:**
+ * - Validates GPT configuration existence before assignment
+ * - Supports null assignments to unlink agents from configurations
+ * - Provides both individual and bulk retrieval of agent mappings
+ * - Maintains referential integrity with the GPT configurations system
  */
 export declare class AgentsApi {
     private readonly agentsManager;
     constructor(agentsManager: AgentsManager);
+    /**
+     * Sets the GPT configuration for a specific Donobu agent.
+     *
+     * This endpoint allows updating the GPT configuration associated with a particular
+     * agent. The operation validates that:
+     * 1. The agent name is a valid Donobu agent type
+     * 2. The GPT configuration exists (if non-null)
+     * 3. The assignment can be persisted successfully
+     *
+     * Setting a null configuration effectively unlinks the agent from any GPT configuration,
+     * which may prevent the agent from being used in autonomous flows.
+     *
+     * @throws {InvalidParamValueException} When the agent name is not a valid DonobuAgent
+     */
     set(req: Request, res: Response): Promise<void>;
+    /**
+     * Retrieves the GPT configuration name for a specific agent.
+     *
+     * Returns the currently assigned GPT configuration for the specified agent.
+     * If no configuration is assigned, returns null. The response includes
+     * validation to ensure the referenced configuration still exists.
+     */
     get(req: Request, res: Response): Promise<void>;
+    /**
+     * Retrieves all agent-to-GPT-configuration mappings.
+     *
+     * Returns a complete mapping of all Donobu agents to their assigned GPT configurations.
+     * This endpoint is useful for administrative interfaces and system configuration
+     * overviews. The response includes all defined agents, even those without
+     * assigned configurations (which will have null values).
+     */
     getAll(_req: Request, res: Response): Promise<void>;
 }
 //# sourceMappingURL=AgentsApi.d.ts.map

package/dist/esm/apis/AgentsApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentsApi.d.ts","sourceRoot":"","sources":["../../../src/apis/AgentsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;GAEG;AACH,qBAAa,SAAS;IACD,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEnD,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjE"}
+{"version":3,"file":"AgentsApi.d.ts","sourceRoot":"","sources":["../../../src/apis/AgentsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS;IACD,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhE;;;;;;;;;;;;;OAaG;IACU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5D;;;;;;OAMG;IACU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D;;;;;;;OAOG;IACU,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjE"}

package/dist/esm/apis/AgentsApi.js

@@ -3,22 +3,63 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentsApi = void 0;
 const DonobuAgentType_1 = require("../models/DonobuAgentType");
 const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
+const zod_1 = require("zod");
 /**
- * This API manages the mapping of Donobu agents to GPT configurations.
+ * API controller for managing the mapping between Donobu agents and GPT configurations.
+ *
+ * The AgentsApi provides endpoints for associating Donobu agents (like 'flow-runner')
+ * with specific GPT configurations. This mapping system allows flows to use different
+ * AI models and configurations based on their requirements. The API maintains a
+ * many-to-one relationship where multiple agents can reference the same GPT configuration,
+ * but each agent can only have one active configuration at a time.
+ *
+ * **Agent Types:**
+ * - `flow-runner`: The primary agent used for autonomous flow execution
+ *
+ * **Key Features:**
+ * - Validates GPT configuration existence before assignment
+ * - Supports null assignments to unlink agents from configurations
+ * - Provides both individual and bulk retrieval of agent mappings
+ * - Maintains referential integrity with the GPT configurations system
  */
 class AgentsApi {
     constructor(agentsManager) {
         this.agentsManager = agentsManager;
     }
+    /**
+     * Sets the GPT configuration for a specific Donobu agent.
+     *
+     * This endpoint allows updating the GPT configuration associated with a particular
+     * agent. The operation validates that:
+     * 1. The agent name is a valid Donobu agent type
+     * 2. The GPT configuration exists (if non-null)
+     * 3. The assignment can be persisted successfully
+     *
+     * Setting a null configuration effectively unlinks the agent from any GPT configuration,
+     * which may prevent the agent from being used in autonomous flows.
+     *
+     * @throws {InvalidParamValueException} When the agent name is not a valid DonobuAgent
+     */
     async set(req, res) {
-        const gptConfigNameBody = req.body;
+        const parsedBody = zod_1.z
+            .object({
+            gptConfigName: zod_1.z.string().nullable(),
+        })
+            .parse(req.body);
         const agentName = req.params.name;
         if (!DonobuAgentType_1.DonobuAgent.includes(agentName)) {
             throw new InvalidParamValueException_1.InvalidParamValueException('/api/agents/:name', agentName);
         }
-        await this.agentsManager.set(agentName, gptConfigNameBody.gptConfigName ?? null);
-        res.json(gptConfigNameBody);
+        await this.agentsManager.set(agentName, parsedBody.gptConfigName);
+        res.json(parsedBody);
     }
+    /**
+     * Retrieves the GPT configuration name for a specific agent.
+     *
+     * Returns the currently assigned GPT configuration for the specified agent.
+     * If no configuration is assigned, returns null. The response includes
+     * validation to ensure the referenced configuration still exists.
+     */
     async get(req, res) {
         const agentName = req.params.name;
         const gptConfigName = await this.agentsManager.get(agentName);
@@ -26,6 +67,14 @@ class AgentsApi {
             gptConfigName: gptConfigName,
         });
     }
+    /**
+     * Retrieves all agent-to-GPT-configuration mappings.
+     *
+     * Returns a complete mapping of all Donobu agents to their assigned GPT configurations.
+     * This endpoint is useful for administrative interfaces and system configuration
+     * overviews. The response includes all defined agents, even those without
+     * assigned configurations (which will have null values).
+     */
     async getAll(_req, res) {
         const agentsMapping = await this.agentsManager.getAll();
         res.json(Object.fromEntries(agentsMapping));

package/dist/esm/apis/AgentsApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentsApi.js","sourceRoot":"","sources":["../../../src/apis/AgentsApi.ts"],"names":[],"mappings":";;;AAEA,+DAAwD;AACxD,yFAAsF;AAEtF;;GAEG;AACH,MAAa,SAAS;IACpB,YAAoC,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAE7D,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,GAAa;QAC1C,MAAM,iBAAiB,GAAG,GAAG,CAAC,IAE7B,CAAC;QACF,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAmB,CAAC;QAEjD,IAAI,CAAC,6BAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,uDAA0B,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAC1B,SAAwB,EACxB,iBAAiB,CAAC,aAAa,IAAI,IAAI,CACxC,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,GAAa;QAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAmB,CAAC;QACjD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC;YACP,aAAa,EAAE,aAAa;SAC7B,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAa,EAAE,GAAa;QAC9C,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QACxD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF;AAhCD,8BAgCC"}
+{"version":3,"file":"AgentsApi.js","sourceRoot":"","sources":["../../../src/apis/AgentsApi.ts"],"names":[],"mappings":";;;AAEA,+DAAwD;AACxD,yFAAsF;AACtF,6BAAwB;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,SAAS;IACpB,YAAoC,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpE;;;;;;;;;;;;;OAaG;IACI,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,GAAa;QAC1C,MAAM,UAAU,GAAG,OAAC;aACjB,MAAM,CAAC;YACN,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC,CAAC;aACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAmB,CAAC;QAEjD,IAAI,CAAC,6BAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,uDAA0B,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;QAClE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,GAAa;QAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAmB,CAAC;QACjD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC;YACP,aAAa,EAAE,aAAa;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,MAAM,CAAC,IAAa,EAAE,GAAa;QAC9C,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QACxD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF;AA5DD,8BA4DC"}

package/dist/esm/apis/AskAiApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AskAiApi.d.ts","sourceRoot":"","sources":["../../../src/apis/AskAiApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAS1D;;GAEG;AACH,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa;IAGlC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B5D;;;OAGG;YACW,gBAAgB;CAe/B"}
+{"version":3,"file":"AskAiApi.d.ts","sourceRoot":"","sources":["../../../src/apis/AskAiApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ1D;;GAEG;AACH,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa;IAGlC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC5D;;;OAGG;YACW,gBAAgB;CAe/B"}

package/dist/esm/apis/AskAiApi.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AskAiApi = void 0;
 const GptApiKeysNotSetupException_1 = require("../exceptions/GptApiKeysNotSetupException");
 const GptClientFactory_1 = require("../clients/GptClientFactory");
-const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
 const JsonSchemaUtils_1 = require("../utils/JsonSchemaUtils");
+const zod_1 = require("zod");
 /**
  * This API is a lightweight wrapper for a GPT client.
  */
@@ -14,11 +14,22 @@ class AskAiApi {
         this.agentsManager = agentsManager;
     }
     async ask(req, res) {
-        const askAiRequest = req.body;
-        if (!askAiRequest.prompt) {
-            throw new InvalidParamValueException_1.InvalidParamValueException('prompt', askAiRequest.prompt);
-        }
-        const gptConfig = await this.resolveGptConfig(askAiRequest.gptConfigNameOverride);
+        const parsedBody = zod_1.z
+            .object({
+            /**
+             * The prompt to use with the AI to generate a response from.
+             */
+            prompt: zod_1.z.string(),
+            /**
+             * The name of a specific GPT configuration to use. If this is not defined,
+             * the default agent configuration will be used.
+             **/
+            gptConfigNameOverride: zod_1.z.string().optional(),
+            /** If non-null, will attempt to respond using this JSON-schema. */
+            resultJsonSchema: zod_1.z.custom().optional(),
+        })
+            .parse(req.body);
+        const gptConfig = await this.resolveGptConfig(parsedBody.gptConfigNameOverride);
         const gptClient = await GptClientFactory_1.GptClientFactory.createFromGptConfig(gptConfig);
         const gptRequestMessages = [
             {
@@ -26,13 +37,13 @@ class AskAiApi {
                 items: [
                     {
                         type: 'text',
-                        text: askAiRequest.prompt,
+                        text: parsedBody.prompt,
                     },
                 ],
             },
         ];
-        const response = askAiRequest.resultJsonSchema
-            ? await gptClient.getStructuredOutput(gptRequestMessages, (0, JsonSchemaUtils_1.jsonSchemaToZod)(askAiRequest.resultJsonSchema))
+        const response = parsedBody.resultJsonSchema
+            ? await gptClient.getStructuredOutput(gptRequestMessages, (0, JsonSchemaUtils_1.jsonSchemaToZod)(parsedBody.resultJsonSchema))
             : await gptClient.getMessage(gptRequestMessages);
         res.json(response);
     }

package/dist/esm/apis/AskAiApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"AskAiApi.js","sourceRoot":"","sources":["../../../src/apis/AskAiApi.ts"],"names":[],"mappings":";;;AAKA,2FAAwF;AACxF,kEAA+D;AAE/D,yFAAsF;AACtF,8DAA2D;AAG3D;;GAEG;AACH,MAAa,QAAQ;IACnB,YACmB,iBAAoC,EACpC,aAA4B;QAD5B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,kBAAa,GAAb,aAAa,CAAe;IAC5C,CAAC;IAEG,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,GAAa;QAC1C,MAAM,YAAY,GAAG,GAAG,CAAC,IAAoB,CAAC;QAE9C,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,uDAA0B,CAAC,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC3C,YAAY,CAAC,qBAAqB,CACnC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,mCAAgB,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACxE,MAAM,kBAAkB,GAAG;YACzB;gBACE,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,CAAC,MAAM;qBAC1B;iBACF;aACoB;SACxB,CAAC;QACF,MAAM,QAAQ,GAAG,YAAY,CAAC,gBAAgB;YAC5C,CAAC,CAAC,MAAM,SAAS,CAAC,mBAAmB,CACjC,kBAAkB,EAClB,IAAA,iCAAe,EAAC,YAAY,CAAC,gBAAgB,CAAqB,CACnE;YACH,CAAC,CAAC,MAAM,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAC5B,qBAA8B;QAE9B,IAAI,qBAAqB,EAAE,CAAC;YAC1B,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAElE,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,yDAA2B,EAAE,CAAC;YAC1C,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AAxDD,4BAwDC"}
+{"version":3,"file":"AskAiApi.js","sourceRoot":"","sources":["../../../src/apis/AskAiApi.ts"],"names":[],"mappings":";;;AAIA,2FAAwF;AACxF,kEAA+D;AAE/D,8DAA2D;AAE3D,6BAAwB;AAExB;;GAEG;AACH,MAAa,QAAQ;IACnB,YACmB,iBAAoC,EACpC,aAA4B;QAD5B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,kBAAa,GAAb,aAAa,CAAe;IAC5C,CAAC;IAEG,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,GAAa;QAC1C,MAAM,UAAU,GAAG,OAAC;aACjB,MAAM,CAAC;YACN;;eAEG;YACH,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;YAClB;;;gBAGI;YACJ,qBAAqB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5C,mEAAmE;YACnE,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAe,CAAC,QAAQ,EAAE;SACrD,CAAC;aACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC3C,UAAU,CAAC,qBAAqB,CACjC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,mCAAgB,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACxE,MAAM,kBAAkB,GAAG;YACzB;gBACE,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,CAAC,MAAM;qBACxB;iBACF;aACoB;SACxB,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB;YAC1C,CAAC,CAAC,MAAM,SAAS,CAAC,mBAAmB,CACjC,kBAAkB,EAClB,IAAA,iCAAe,EAAC,UAAU,CAAC,gBAAgB,CAAqB,CACjE;YACH,CAAC,CAAC,MAAM,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAC5B,qBAA8B;QAE9B,IAAI,qBAAqB,EAAE,CAAC;YAC1B,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAElE,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,yDAA2B,EAAE,CAAC;YAC1C,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AAjED,4BAiEC"}

package/dist/esm/apis/DefaultApiAuthApi.d.ts

@@ -1,17 +1,53 @@
 import { Request, Response } from 'express';
 import { RequestContextHolder } from '../managers/RequestContextHolder';
 /**
- * API handler for managing default API authentication settings
+ * API controller for managing default API authentication settings in LOCAL deployment environments.
+ *
+ * The DefaultApiAuthApi provides a mechanism to set fallback authentication credentials
+ * that are used when individual requests don't include explicit authorization headers.
+ * This functionality is particularly useful during development and testing phases where
+ * setting up per-request authentication may be cumbersome.
+ *
+ * **Important Security Notes:**
+ * - This API is only available in LOCAL deployment environments
+ * - Should not be used in production or multi-tenant environments
+ * - Authentication tokens are stored in memory only (not persisted)
+ * - All requests without explicit auth headers will use the default credentials
+ *
+ * **Use Cases:**
+ * - Development environment setup and testing
+ * - Simplified authentication during API exploration
+ * - Batch operations where individual request auth is impractical
+ * - Internal tooling and administrative scripts
+ *
+ * **Authentication Flow:**
+ * 1. Client sets default auth token via this API
+ * 2. Subsequent requests without Authorization header use the default token
+ * 3. Requests with explicit Authorization header take precedence
+ * 4. Default token remains active until explicitly changed or server restart
  */
 export declare class DefaultApiAuthApi {
     private readonly requestContextHolder;
+    /**
+     * Creates a new DefaultApiAuthApi instance.
+     *
+     * The API requires a RequestContextHolder to manage authentication state
+     * across different request contexts and threads. This holder maintains
+     * both per-request authentication tokens and the fallback default token.
+     */
     constructor(requestContextHolder: RequestContextHolder);
     /**
-     * Sets the default API authentication context
+     * Sets the default API authentication token for all subsequent requests.
+     *
+     * This endpoint establishes a fallback authentication token that will be used
+     * for any API requests that don't include an explicit Authorization header.
+     * The token is stored in memory and will be applied to all future requests
+     * until explicitly changed or the server is restarted.
      *
-     * @param req - Express request object
-     * @param res - Express response object
-     * @throws UnparseableJsonBodyException if the request body cannot be parsed
+     * **Token Format:**
+     * - Should be a valid Supabase access token
+     * - Must be properly formatted and not expired
+     * - Token validation occurs during actual API usage, not during this call
      */
     setDefaultApiAuth(req: Request, res: Response): Promise<void>;
 }

package/dist/esm/apis/DefaultApiAuthApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultApiAuthApi.d.ts","sourceRoot":"","sources":["../../../src/apis/DefaultApiAuthApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAIxE;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,oBAAoB;IAEvE;;;;;;OAMG;IACU,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAc3E"}
+{"version":3,"file":"DefaultApiAuthApi.d.ts","sourceRoot":"","sources":["../../../src/apis/DefaultApiAuthApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,iBAAiB;IAS1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IARvC;;;;;;OAMG;gBAEgB,oBAAoB,EAAE,oBAAoB;IAG7D;;;;;;;;;;;;OAYG;IACU,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAM3E"}

package/dist/esm/apis/DefaultApiAuthApi.js

@@ -1,30 +1,62 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultApiAuthApi = void 0;
-const UnparseableJsonBodyException_1 = require("../exceptions/UnparseableJsonBodyException");
+const RequestContext_1 = require("../models/RequestContext");
+const zod_1 = require("zod");
 /**
- * API handler for managing default API authentication settings
+ * API controller for managing default API authentication settings in LOCAL deployment environments.
+ *
+ * The DefaultApiAuthApi provides a mechanism to set fallback authentication credentials
+ * that are used when individual requests don't include explicit authorization headers.
+ * This functionality is particularly useful during development and testing phases where
+ * setting up per-request authentication may be cumbersome.
+ *
+ * **Important Security Notes:**
+ * - This API is only available in LOCAL deployment environments
+ * - Should not be used in production or multi-tenant environments
+ * - Authentication tokens are stored in memory only (not persisted)
+ * - All requests without explicit auth headers will use the default credentials
+ *
+ * **Use Cases:**
+ * - Development environment setup and testing
+ * - Simplified authentication during API exploration
+ * - Batch operations where individual request auth is impractical
+ * - Internal tooling and administrative scripts
+ *
+ * **Authentication Flow:**
+ * 1. Client sets default auth token via this API
+ * 2. Subsequent requests without Authorization header use the default token
+ * 3. Requests with explicit Authorization header take precedence
+ * 4. Default token remains active until explicitly changed or server restart
  */
 class DefaultApiAuthApi {
+    /**
+     * Creates a new DefaultApiAuthApi instance.
+     *
+     * The API requires a RequestContextHolder to manage authentication state
+     * across different request contexts and threads. This holder maintains
+     * both per-request authentication tokens and the fallback default token.
+     */
     constructor(requestContextHolder) {
         this.requestContextHolder = requestContextHolder;
     }
     /**
-     * Sets the default API authentication context
+     * Sets the default API authentication token for all subsequent requests.
+     *
+     * This endpoint establishes a fallback authentication token that will be used
+     * for any API requests that don't include an explicit Authorization header.
+     * The token is stored in memory and will be applied to all future requests
+     * until explicitly changed or the server is restarted.
      *
-     * @param req - Express request object
-     * @param res - Express response object
-     * @throws UnparseableJsonBodyException if the request body cannot be parsed
+     * **Token Format:**
+     * - Should be a valid Supabase access token
+     * - Must be properly formatted and not expired
+     * - Token validation occurs during actual API usage, not during this call
      */
     async setDefaultApiAuth(req, res) {
-        // Validate and parse the request body as RequestContext
-        if (!req.body || typeof req.body !== 'object') {
-            throw new UnparseableJsonBodyException_1.UnparseableJsonBodyException();
-        }
-        const defaultRequestContext = req.body;
-        // Set the fallback context
+        const parsedBody = zod_1.z.object({ accessToken: zod_1.z.string() }).parse(req.body);
+        const defaultRequestContext = new RequestContext_1.RequestContext(parsedBody.accessToken);
         this.requestContextHolder.setFallbackContext(defaultRequestContext);
-        // Send success response
         res.status(200).send();
     }
 }