donobu 2.20.0 → 2.21.0

package/dist/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/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/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/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/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;AAO1D;;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/apis/AskAiApi.js

@@ -3,7 +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.
  */
@@ -13,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 = [
             {
@@ -25,13 +37,13 @@ class AskAiApi {
                 items: [
                     {
                         type: 'text',
-                        text: askAiRequest.prompt,
+                        text: parsedBody.prompt,
                     },
                 ],
             },
         ];
-        const response = askAiRequest.resultJsonSchema
-            ? await gptClient.getStructuredOutput(gptRequestMessages, 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/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;AAEtF;;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,YAAY,CAAC,gBAAgB,CAC9B;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/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/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/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('Invalid request body');
-        }
-        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();
     }
 }

package/dist/apis/DefaultApiAuthApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultApiAuthApi.js","sourceRoot":"","sources":["../../src/apis/DefaultApiAuthApi.ts"],"names":[],"mappings":";;;AAGA,6FAA0F;AAE1F;;GAEG;AACH,MAAa,iBAAiB;IAC5B,YAA6B,oBAA0C;QAA1C,yBAAoB,GAApB,oBAAoB,CAAsB;IAAG,CAAC;IAE3E;;;;;;OAMG;IACI,KAAK,CAAC,iBAAiB,CAAC,GAAY,EAAE,GAAa;QACxD,wDAAwD;QACxD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,2DAA4B,CAAC,sBAAsB,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,qBAAqB,GAAG,GAAG,CAAC,IAAsB,CAAC;QAEzD,2BAA2B;QAC3B,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;QAEpE,wBAAwB;QACxB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF;AAxBD,8CAwBC"}
+{"version":3,"file":"DefaultApiAuthApi.js","sourceRoot":"","sources":["../../src/apis/DefaultApiAuthApi.ts"],"names":[],"mappings":";;;AAEA,6DAA0D;AAC1D,6BAAwB;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,YACmB,oBAA0C;QAA1C,yBAAoB,GAApB,oBAAoB,CAAsB;IAC1D,CAAC;IAEJ;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,iBAAiB,CAAC,GAAY,EAAE,GAAa;QACxD,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,qBAAqB,GAAG,IAAI,+BAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF;AA/BD,8CA+BC"}

package/dist/apis/EnvDataApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvDataApi.d.ts","sourceRoot":"","sources":["../../src/apis/EnvDataApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D;;GAEG;AACH,qBAAa,UAAU;IACF,OAAO,CAAC,QAAQ,CAAC,sBAAsB;gBAAtB,sBAAsB,EAAE,cAAc;IAE1E;;OAEG;IACU,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E;;OAEG;IACU,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5E;;OAEG;IACU,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5E;;OAEG;IACU,sBAAsB,CACjC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC;CAKjB"}
+{"version":3,"file":"EnvDataApi.d.ts","sourceRoot":"","sources":["../../src/apis/EnvDataApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D;;GAEG;AACH,qBAAa,UAAU;IACF,OAAO,CAAC,QAAQ,CAAC,sBAAsB;gBAAtB,sBAAsB,EAAE,cAAc;IAE1E;;OAEG;IACU,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E;;OAEG;IACU,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5E;;OAEG;IACU,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5E;;OAEG;IACU,sBAAsB,CACjC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC;CAKjB"}

package/dist/apis/EnvDataApi.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnvDataApi = void 0;
-const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
+const zod_1 = require("zod");
 /**
  * API controller for environment data management endpoints.
  */
@@ -33,18 +33,13 @@ class EnvDataApi {
      */
     async setEnvironmentDatum(req, res) {
         const key = req.params.key;
-        // Validate value
-        const { value } = req.body;
-        if (value === undefined) {
-            throw new InvalidParamValueException_1.InvalidParamValueException('value', value, 'value is required');
-        }
-        if (typeof value !== 'string') {
-            throw new InvalidParamValueException_1.InvalidParamValueException('value', typeof value, 'value must be a string');
-        }
-        // Store the environment datum
-        await this.environmentDataManager.setEnvironmentDatum(key, value);
-        // Return success response
-        res.status(201).json({ key, value });
+        const parsedBody = zod_1.z
+            .object({
+            value: zod_1.z.string(),
+        })
+            .parse(req.body);
+        await this.environmentDataManager.setEnvironmentDatum(key, parsedBody.value);
+        res.status(201).json({ key: key, value: parsedBody.value });
     }
     /**
      * Delete an environment datum by key.

package/dist/apis/EnvDataApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"EnvDataApi.js","sourceRoot":"","sources":["../../src/apis/EnvDataApi.ts"],"names":[],"mappings":";;;AAEA,yFAAsF;AAEtF;;GAEG;AACH,MAAa,UAAU;IACrB,YAAoC,sBAAsC;QAAtC,2BAAsB,GAAtB,sBAAsB,CAAgB;IAAG,CAAC;IAE9E;;OAEG;IACI,KAAK,CAAC,kBAAkB,CAAC,IAAa,EAAE,GAAa;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,CAAC;QACpE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,GAAY,EAAE,GAAa;QAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAEzE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,GAAG,aAAa,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,GAAY,EAAE,GAAa;QAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,iBAAiB;QACjB,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QAE3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,uDAA0B,CAAC,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,uDAA0B,CAClC,OAAO,EACP,OAAO,KAAK,EACZ,wBAAwB,CACzB,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,MAAM,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAElE,0BAA0B;QAC1B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,sBAAsB,CACjC,GAAY,EACZ,GAAa;QAEb,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC9D,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAhED,gCAgEC"}
+{"version":3,"file":"EnvDataApi.js","sourceRoot":"","sources":["../../src/apis/EnvDataApi.ts"],"names":[],"mappings":";;;AAEA,6BAAwB;AAExB;;GAEG;AACH,MAAa,UAAU;IACrB,YAAoC,sBAAsC;QAAtC,2BAAsB,GAAtB,sBAAsB,CAAgB;IAAG,CAAC;IAE9E;;OAEG;IACI,KAAK,CAAC,kBAAkB,CAAC,IAAa,EAAE,GAAa;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,kBAAkB,EAAE,CAAC;QACpE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,GAAY,EAAE,GAAa;QAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAEzE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,GAAG,aAAa,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,mBAAmB,CAAC,GAAY,EAAE,GAAa;QAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,UAAU,GAAG,OAAC;aACjB,MAAM,CAAC;YACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,CAAC;aACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CACnD,GAAG,EACH,UAAU,CAAC,KAAK,CACjB,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,sBAAsB,CACjC,GAAY,EACZ,GAAa;QAEb,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,MAAM,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC9D,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAtDD,gCAsDC"}