donobu 3.5.5 → 3.6.1

package/dist/managers/DonobuStack.d.ts

@@ -42,11 +42,12 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     OPENAI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     OPENAI_API_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
-    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     AWS_S3_BUCKET: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     AWS_S3_REGION: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     AWS_BEDROCK_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     AWS_REGION: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    AWS_ACCESS_KEY_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    AWS_SECRET_ACCESS_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     DONOBU_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     GOOGLE_CLOUD_STORAGE_BUCKET: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     SUPABASE_JWT_SECRET_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
@@ -60,11 +61,12 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     GOOGLE_GENERATIVE_AI_MODEL_NAME?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     OPENAI_API_MODEL_NAME?: string | undefined;
-    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME?: string | undefined;
     AWS_S3_BUCKET?: string | undefined;
     AWS_S3_REGION?: string | undefined;
     AWS_BEDROCK_MODEL_NAME?: string | undefined;
     AWS_REGION?: string | undefined;
+    AWS_ACCESS_KEY_ID?: string | undefined;
+    AWS_SECRET_ACCESS_KEY?: string | undefined;
     DONOBU_API_KEY?: string | undefined;
     GOOGLE_CLOUD_STORAGE_BUCKET?: string | undefined;
     SUPABASE_JWT_SECRET_KEY?: string | undefined;

package/dist/managers/DonobuStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DonobuStack.d.ts","sourceRoot":"","sources":["../../src/managers/DonobuStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAIjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAE5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,YAAY,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,2BAA2B,EAAE,2BAA2B,EACxD,mBAAmB,EAAE,mBAAmB,EACxC,sBAAsB,CAAC,EAAE,sBAAsB,EAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBN,GACA,OAAO,CAAC,WAAW,CAAC,CAmDtB"}
+{"version":3,"file":"DonobuStack.d.ts","sourceRoot":"","sources":["../../src/managers/DonobuStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAIjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAE5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAE7F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,YAAY,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,2BAA2B,EAAE,2BAA2B,EACxD,mBAAmB,EAAE,mBAAmB,EACxC,sBAAsB,CAAC,EAAE,sBAAsB,EAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBN,GACA,OAAO,CAAC,WAAW,CAAC,CAiDtB"}

package/dist/managers/DonobuStack.js

@@ -24,14 +24,14 @@ const RequestContextHolder_1 = require("./RequestContextHolder");
  *       then having this snapshot is relevant so that tests can use normal
  *       environment variables.
  */
-async function setupDonobuStack(donobuDeploymentEnvironment, controlPanelFactory, envPersistenceVolatile, environ = envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_BEDROCK_MODEL_NAME', 'AWS_S3_BUCKET', 'AWS_S3_REGION', 'AWS_REGION', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'GOOGLE_CLOUD_STORAGE_BUCKET', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'SUPABASE_JWT_SECRET_KEY')) {
+async function setupDonobuStack(donobuDeploymentEnvironment, controlPanelFactory, envPersistenceVolatile, environ = envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_REGION', 'AWS_S3_BUCKET', 'AWS_S3_REGION', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'GOOGLE_CLOUD_STORAGE_BUCKET', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'SUPABASE_JWT_SECRET_KEY')) {
     const gptClientFactory = new GptClientFactory_1.GptClientFactoryImpl();
     const requestContextHolder = new RequestContextHolder_1.RequestContextHolder();
     const sqliteDb = await (0, DonobuSqliteDb_1.getDonobuSqliteDatabase)();
     const gptConfigsPersistence = await GptConfigsPersistenceSqlite_1.GptConfigsPersistenceSqlite.create(sqliteDb);
-    const gptConfigsManager = await GptConfigsManager_1.GptConfigsManager.create(gptConfigsPersistence, gptClientFactory, environ);
+    const gptConfigsManager = await GptConfigsManager_1.GptConfigsManager.create(gptConfigsPersistence, gptClientFactory);
     const agentsPersistence = await AgentsPersistenceSqlite_1.AgentsPersistenceSqlite.create(sqliteDb);
-    const agentsManager = await AgentsManager_1.AgentsManager.create(agentsPersistence, gptConfigsManager, environ);
+    const agentsManager = await AgentsManager_1.AgentsManager.create(agentsPersistence, gptConfigsManager);
     const flowsPersistenceFactory = await FlowsPersistenceFactoryImpl_1.FlowsPersistenceFactoryImpl.fromEnvironment(donobuDeploymentEnvironment, requestContextHolder, environ);
     const envPersistenceFactory = await EnvPersistenceFactoryImpl_1.EnvPersistenceFactoryImpl.fromEnvironment(donobuDeploymentEnvironment, requestContextHolder, envPersistenceVolatile ?? null, environ);
     const envDataManager = new EnvDataManager_1.EnvDataManager(envPersistenceFactory);

package/dist/managers/DonobuStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"DonobuStack.js","sourceRoot":"","sources":["../../src/managers/DonobuStack.ts"],"names":[],"mappings":";;AA2CA,4CA0EC;AApHD,kEAAmE;AACnE,wCAAiC;AAIjC,2FAAwF;AACxF,kEAAwE;AACxE,4FAAyF;AAGzF,kGAA+F;AAE/F,uGAAoG;AACpG,mDAAgD;AAChD,6DAA0D;AAC1D,qDAAkD;AAClD,2DAAwD;AACxD,iEAA8D;AAc9D;;;;;;;;;;GAUG;AACI,KAAK,UAAU,gBAAgB,CACpC,2BAAwD,EACxD,mBAAwC,EACxC,sBAA+C,EAC/C,OAAO,GAAG,aAAG,CAAC,IAAI,CAChB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,qCAAqC,EACrC,gBAAgB,EAChB,8BAA8B,EAC9B,iCAAiC,EACjC,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,CAC1B;IAED,MAAM,gBAAgB,GAAG,IAAI,uCAAoB,EAAE,CAAC;IACpD,MAAM,oBAAoB,GAAG,IAAI,2CAAoB,EAAE,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,IAAA,wCAAuB,GAAE,CAAC;IACjD,MAAM,qBAAqB,GACzB,MAAM,yDAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,iBAAiB,GAAG,MAAM,qCAAiB,CAAC,MAAM,CACtD,qBAAqB,EACrB,gBAAgB,EAChB,OAAO,CACR,CAAC;IACF,MAAM,iBAAiB,GAAG,MAAM,iDAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,MAAM,6BAAa,CAAC,MAAM,CAC9C,iBAAiB,EACjB,iBAAiB,EACjB,OAAO,CACR,CAAC;IACF,MAAM,uBAAuB,GAC3B,MAAM,yDAA2B,CAAC,eAAe,CAC/C,2BAA2B,EAC3B,oBAAoB,EACpB,OAAO,CACR,CAAC;IACJ,MAAM,qBAAqB,GAAG,MAAM,qDAAyB,CAAC,eAAe,CAC3E,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,IAAI,IAAI,EAC9B,OAAO,CACR,CAAC;IACF,MAAM,cAAc,GAAG,IAAI,+BAAc,CAAC,qBAAqB,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,uCAAkB,CACzC,2BAA2B,EAC3B,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,OAAO,CACR,CAAC;IACF,OAAO;QACL,gBAAgB;QAChB,qBAAqB;QACrB,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;QACb,uBAAuB;QACvB,YAAY;QACZ,cAAc;QACd,oBAAoB;KACrB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"DonobuStack.js","sourceRoot":"","sources":["../../src/managers/DonobuStack.ts"],"names":[],"mappings":";;AA2CA,4CAyEC;AAnHD,kEAAmE;AACnE,wCAAiC;AAIjC,2FAAwF;AACxF,kEAAwE;AACxE,4FAAyF;AAGzF,kGAA+F;AAE/F,uGAAoG;AACpG,mDAAgD;AAChD,6DAA0D;AAC1D,qDAAkD;AAClD,2DAAwD;AACxD,iEAA8D;AAc9D;;;;;;;;;;GAUG;AACI,KAAK,UAAU,gBAAgB,CACpC,2BAAwD,EACxD,mBAAwC,EACxC,sBAA+C,EAC/C,OAAO,GAAG,aAAG,CAAC,IAAI,CAChB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,8BAA8B,EAC9B,iCAAiC,EACjC,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,CAC1B;IAED,MAAM,gBAAgB,GAAG,IAAI,uCAAoB,EAAE,CAAC;IACpD,MAAM,oBAAoB,GAAG,IAAI,2CAAoB,EAAE,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,IAAA,wCAAuB,GAAE,CAAC;IACjD,MAAM,qBAAqB,GACzB,MAAM,yDAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,iBAAiB,GAAG,MAAM,qCAAiB,CAAC,MAAM,CACtD,qBAAqB,EACrB,gBAAgB,CACjB,CAAC;IACF,MAAM,iBAAiB,GAAG,MAAM,iDAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,MAAM,6BAAa,CAAC,MAAM,CAC9C,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;IACF,MAAM,uBAAuB,GAC3B,MAAM,yDAA2B,CAAC,eAAe,CAC/C,2BAA2B,EAC3B,oBAAoB,EACpB,OAAO,CACR,CAAC;IACJ,MAAM,qBAAqB,GAAG,MAAM,qDAAyB,CAAC,eAAe,CAC3E,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,IAAI,IAAI,EAC9B,OAAO,CACR,CAAC;IACF,MAAM,cAAc,GAAG,IAAI,+BAAc,CAAC,qBAAqB,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,uCAAkB,CACzC,2BAA2B,EAC3B,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,OAAO,CACR,CAAC;IACF,OAAO;QACL,gBAAgB;QAChB,qBAAqB;QACrB,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;QACb,uBAAuB;QACvB,YAAY;QACZ,cAAc;QACd,oBAAoB;KACrB,CAAC;AACJ,CAAC"}

package/dist/managers/EnvDataManager.d.ts

@@ -42,6 +42,17 @@ export declare class EnvDataManager {
      * @returns A record of all environment data where keys are datum keys and values are datum values
      */
     getEnvironmentData(): Promise<Record<string, string>>;
+    /**
+     * Returns a dictionary of environment variable values for the provided names.
+     * Missing variables are simply omitted so callers can pass optional names
+     * without extra guards. Used by flows to hydrate runtime env data from the
+     * persisted allow-list.
+     *
+     * @example
+     * await getByNames(["API_KEY", "BASE_URL", "MISSING_VAR"]);
+     * // => { API_KEY: "abc123", BASE_URL: "https://example.com" }
+     */
+    getByNames(envVarNames: string[]): Promise<Record<string, string>>;
     /**
      * Validates an environment data key against business rules.
      *

package/dist/managers/EnvDataManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvDataManager.d.ts","sourceRoot":"","sources":["../../src/managers/EnvDataManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGtF;;GAEG;AACH,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;aACtB,YAAY,EAAE,MAAM;aACpB,cAAc,EAAE,MAAM;IAbxC;;OAEG;IACH,gBAAuB,sBAAsB,OAAO;IAEpD;;OAEG;IACH,gBAAuB,wBAAwB,SAAe;gBAG3C,qBAAqB,EAAE,qBAAqB,EAC7C,YAAY,GAAE,MAA8C,EAC5D,cAAc,GAAE,MAAgD;IAGlF;;;;;;OAMG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3E;;;;OAIG;IACU,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;;;;OAKG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuB1E;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyBlE;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAKtB"}
+{"version":3,"file":"EnvDataManager.d.ts","sourceRoot":"","sources":["../../src/managers/EnvDataManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGtF;;GAEG;AACH,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;aACtB,YAAY,EAAE,MAAM;aACpB,cAAc,EAAE,MAAM;IAbxC;;OAEG;IACH,gBAAuB,sBAAsB,OAAO;IAEpD;;OAEG;IACH,gBAAuB,wBAAwB,SAAe;gBAG3C,qBAAqB,EAAE,qBAAqB,EAC7C,YAAY,GAAE,MAA8C,EAC5D,cAAc,GAAE,MAAgD;IAGlF;;;;;;OAMG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3E;;;;OAIG;IACU,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;;;;OAKG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuB1E;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyBlE;;;;;;;;;OASG;IACU,UAAU,CACrB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAalC;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAKtB"}

package/dist/managers/EnvDataManager.js

@@ -87,6 +87,26 @@ class EnvDataManager {
         }
         return result;
     }
+    /**
+     * Returns a dictionary of environment variable values for the provided names.
+     * Missing variables are simply omitted so callers can pass optional names
+     * without extra guards. Used by flows to hydrate runtime env data from the
+     * persisted allow-list.
+     *
+     * @example
+     * await getByNames(["API_KEY", "BASE_URL", "MISSING_VAR"]);
+     * // => { API_KEY: "abc123", BASE_URL: "https://example.com" }
+     */
+    async getByNames(envVarNames) {
+        const result = {};
+        for (const envVarName of envVarNames) {
+            const envVarValue = await this.getEnvironmentDatum(envVarName);
+            if (envVarValue) {
+                result[envVarName] = envVarValue;
+            }
+        }
+        return result;
+    }
     /**
      * Validates an environment data key against business rules.
      *

package/dist/managers/EnvDataManager.js.map

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

package/dist/managers/FlowCatalog.d.ts

@@ -0,0 +1,29 @@
+import type { BrowserStorageState } from '../models/BrowserStorageState';
+import type { DonobuDeploymentEnvironment } from '../models/DonobuDeploymentEnvironment';
+import type { FlowMetadata, FlowsQuery } from '../models/FlowMetadata';
+import type { PaginatedResult } from '../models/PaginatedResult';
+import type { ToolCall } from '../models/ToolCall';
+import type { FlowsPersistenceFactory } from '../persistence/flows/FlowsPersistenceFactory';
+import type { FlowRuntime } from './FlowRuntime';
+/**
+ * Centralized access layer for flow metadata, tool calls, and browser state.
+ *
+ * Responsibilities:
+ * - Prefer in-memory runtime state when running locally (so callers see live mutations)
+ * - Federate reads across all configured persistence layers with simple pagination merge
+ * - Provide a single surface for flow metadata, tool call history, browser state, and deletes
+ */
+export declare class FlowCatalog {
+    private readonly flowsPersistenceFactory;
+    private readonly flowRuntime;
+    private readonly deploymentEnvironment;
+    constructor(flowsPersistenceFactory: FlowsPersistenceFactory, flowRuntime: FlowRuntime, deploymentEnvironment: DonobuDeploymentEnvironment);
+    getFlowById(flowId: string): Promise<FlowMetadata>;
+    getFlowByName(flowName: string): Promise<FlowMetadata>;
+    getToolCalls(flowId: string): Promise<ToolCall[]>;
+    deleteFlow(flowId: string): Promise<void>;
+    getBrowserState(flowId: string): Promise<BrowserStorageState | null>;
+    getFlows(query: FlowsQuery): Promise<PaginatedResult<FlowMetadata>>;
+    private isLocal;
+}
+//# sourceMappingURL=FlowCatalog.d.ts.map

package/dist/managers/FlowCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowCatalog.d.ts","sourceRoot":"","sources":["../../src/managers/FlowCatalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQjD;;;;;;;GAOG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAFrB,uBAAuB,EAAE,uBAAuB,EAChD,WAAW,EAAE,WAAW,EACxB,qBAAqB,EAAE,2BAA2B;IAGxD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqBlD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IActD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwBjD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,eAAe,CAC1B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAgBzB,QAAQ,CACnB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IA2DzC,OAAO,CAAC,OAAO;CAGhB"}

package/dist/managers/FlowCatalog.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowCatalog = void 0;
+const FlowNotFoundException_1 = require("../exceptions/FlowNotFoundException");
+/**
+ * Centralized access layer for flow metadata, tool calls, and browser state.
+ *
+ * Responsibilities:
+ * - Prefer in-memory runtime state when running locally (so callers see live mutations)
+ * - Federate reads across all configured persistence layers with simple pagination merge
+ * - Provide a single surface for flow metadata, tool call history, browser state, and deletes
+ */
+class FlowCatalog {
+    constructor(flowsPersistenceFactory, flowRuntime, deploymentEnvironment) {
+        this.flowsPersistenceFactory = flowsPersistenceFactory;
+        this.flowRuntime = flowRuntime;
+        this.deploymentEnvironment = deploymentEnvironment;
+    }
+    async getFlowById(flowId) {
+        if (this.isLocal()) {
+            const activeMetadata = this.flowRuntime.metadataFor(flowId);
+            if (activeMetadata) {
+                return activeMetadata;
+            }
+        }
+        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
+            try {
+                return await persistence.getFlowMetadataById(flowId);
+            }
+            catch (error) {
+                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
+                    throw error;
+                }
+            }
+        }
+        throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+    }
+    async getFlowByName(flowName) {
+        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
+            try {
+                return await persistence.getFlowMetadataByName(flowName);
+            }
+            catch (error) {
+                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
+                    throw error;
+                }
+            }
+        }
+        throw FlowNotFoundException_1.FlowNotFoundException.forName(flowName);
+    }
+    async getToolCalls(flowId) {
+        if (this.isLocal()) {
+            const activeHandle = this.flowRuntime.get(flowId);
+            if (activeHandle) {
+                return [...activeHandle.donobuFlow.invokedToolCalls].sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime());
+            }
+        }
+        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
+            try {
+                return await persistence.getToolCalls(flowId);
+            }
+            catch (error) {
+                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
+                    throw error;
+                }
+            }
+        }
+        throw FlowNotFoundException_1.FlowNotFoundException.forId(flowId);
+    }
+    async deleteFlow(flowId) {
+        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
+            await persistence.deleteFlow(flowId);
+        }
+    }
+    async getBrowserState(flowId) {
+        for (const persistence of await this.flowsPersistenceFactory.createPersistenceLayers()) {
+            try {
+                const browserState = await persistence.getBrowserState(flowId);
+                if (browserState) {
+                    return browserState;
+                }
+            }
+            catch (error) {
+                if (!(error instanceof FlowNotFoundException_1.FlowNotFoundException)) {
+                    throw error;
+                }
+            }
+        }
+        return null;
+    }
+    async getFlows(query) {
+        const paginationState = parseCompositePageToken(query.pageToken);
+        const requestedLimit = Math.min(Math.max(1, query.limit || 100), 100);
+        const combinedResults = [];
+        const persistenceLayers = await this.flowsPersistenceFactory.createPersistenceLayers();
+        for (let i = 0; i < persistenceLayers.length; i++) {
+            if (paginationState.exhaustedSources.includes(i)) {
+                continue;
+            }
+            const sourceLimit = Math.min(requestedLimit * 2, 100);
+            const sourceQuery = {
+                ...query,
+                limit: sourceLimit,
+                pageToken: paginationState.sourceTokens[i],
+            };
+            const sourceResult = await persistenceLayers[i].getFlowsMetadata(sourceQuery);
+            const itemsWithSource = sourceResult.items.map((flow) => ({
+                flow,
+                sourceIndex: i,
+            }));
+            combinedResults.push(...itemsWithSource);
+            if (sourceResult.nextPageToken) {
+                paginationState.sourceTokens[i] = sourceResult.nextPageToken;
+            }
+            else {
+                paginationState.exhaustedSources.push(i);
+            }
+        }
+        combinedResults.sort((a, b) => (b.flow.startedAt || 0) - (a.flow.startedAt || 0));
+        const limitedResults = combinedResults.slice(0, requestedLimit);
+        const lastTimestamp = limitedResults.length > 0
+            ? limitedResults[limitedResults.length - 1].flow.startedAt
+            : null;
+        paginationState.cursorTimestamp = lastTimestamp;
+        const hasMore = combinedResults.length > requestedLimit ||
+            paginationState.exhaustedSources.length < persistenceLayers.length;
+        return {
+            items: limitedResults.map((item) => item.flow),
+            nextPageToken: hasMore
+                ? createCompositePageToken(paginationState)
+                : undefined,
+        };
+    }
+    isLocal() {
+        return this.deploymentEnvironment === 'LOCAL';
+    }
+}
+exports.FlowCatalog = FlowCatalog;
+function createCompositePageToken(state) {
+    return Buffer.from(JSON.stringify(state)).toString('base64');
+}
+function parseCompositePageToken(token) {
+    if (!token) {
+        return { sourceTokens: {}, exhaustedSources: [], cursorTimestamp: null };
+    }
+    try {
+        return JSON.parse(Buffer.from(token, 'base64').toString());
+    }
+    catch (_error) {
+        return { sourceTokens: {}, exhaustedSources: [], cursorTimestamp: null };
+    }
+}
+//# sourceMappingURL=FlowCatalog.js.map

package/dist/managers/FlowCatalog.js.map

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

package/dist/managers/FlowDependencyResolver.d.ts

@@ -0,0 +1,20 @@
+import type { FlowCatalog } from './FlowCatalog';
+/**
+ * Resolves flow dependencies (for example, browser state references) across persistence layers.
+ *
+ * Given a set of root flow IDs, this helper discovers transitive dependencies
+ * by following `browser.initialState` references (by ID or name) and returns a
+ * breadth-first ordered list of all flows that must be present to replay the
+ * graph. It defers retrieval and error handling to FlowCatalog, so it stays
+ * agnostic of storage concerns.
+ */
+export declare class FlowDependencyResolver {
+    private readonly flowCatalog;
+    constructor(flowCatalog: FlowCatalog);
+    resolveFlowDependencies(initialFlowIds: string[]): Promise<string[]>;
+    private shouldReplaceFlowMapping;
+    private extractFlowDependencies;
+    private resolveIdReference;
+    private resolveNameReference;
+}
+//# sourceMappingURL=FlowDependencyResolver.d.ts.map

package/dist/managers/FlowDependencyResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowDependencyResolver.d.ts","sourceRoot":"","sources":["../../src/managers/FlowDependencyResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACd,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE/C,uBAAuB,CAClC,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,EAAE,CAAC;YA4CN,wBAAwB;YAaxB,uBAAuB;YAqBvB,kBAAkB;YAWlB,oBAAoB;CAoBnC"}

package/dist/managers/FlowDependencyResolver.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowDependencyResolver = void 0;
+const FlowDependencyAnalyzer_1 = require("./FlowDependencyAnalyzer");
+/**
+ * Resolves flow dependencies (for example, browser state references) across persistence layers.
+ *
+ * Given a set of root flow IDs, this helper discovers transitive dependencies
+ * by following `browser.initialState` references (by ID or name) and returns a
+ * breadth-first ordered list of all flows that must be present to replay the
+ * graph. It defers retrieval and error handling to FlowCatalog, so it stays
+ * agnostic of storage concerns.
+ */
+class FlowDependencyResolver {
+    constructor(flowCatalog) {
+        this.flowCatalog = flowCatalog;
+    }
+    async resolveFlowDependencies(initialFlowIds) {
+        const resolvedFlowIds = new Set();
+        const flowsToProcess = [...initialFlowIds];
+        const nameToIdMap = new Map();
+        while (flowsToProcess.length > 0) {
+            const currentFlowId = flowsToProcess.shift();
+            if (resolvedFlowIds.has(currentFlowId)) {
+                continue;
+            }
+            try {
+                const flowMetadata = await this.flowCatalog.getFlowById(currentFlowId);
+                resolvedFlowIds.add(currentFlowId);
+                if (flowMetadata.name) {
+                    const existingFlowId = nameToIdMap.get(flowMetadata.name);
+                    if (!existingFlowId ||
+                        (await this.shouldReplaceFlowMapping(existingFlowId, currentFlowId))) {
+                        nameToIdMap.set(flowMetadata.name, currentFlowId);
+                    }
+                }
+                const dependencies = await this.extractFlowDependencies(flowMetadata, nameToIdMap);
+                dependencies.forEach((depId) => {
+                    if (!resolvedFlowIds.has(depId)) {
+                        flowsToProcess.push(depId);
+                    }
+                });
+            }
+            catch (_error) {
+                // Skip missing flows but continue resolving others.
+            }
+        }
+        return Array.from(resolvedFlowIds);
+    }
+    async shouldReplaceFlowMapping(existingFlowId, newFlowId) {
+        try {
+            const existingFlow = await this.flowCatalog.getFlowById(existingFlowId);
+            const newFlow = await this.flowCatalog.getFlowById(newFlowId);
+            return FlowDependencyAnalyzer_1.FlowDependencyAnalyzer.shouldReplaceFlow(existingFlow, newFlow);
+        }
+        catch (_error) {
+            return true;
+        }
+    }
+    async extractFlowDependencies(flow, nameToIdMap) {
+        const initialState = flow.browser?.initialState;
+        if (!initialState) {
+            return [];
+        }
+        switch (initialState.type) {
+            case 'id':
+                return this.resolveIdReference(initialState);
+            case 'name':
+                return this.resolveNameReference(initialState, nameToIdMap);
+            case 'json':
+                return [];
+            default:
+                return [];
+        }
+    }
+    async resolveIdReference(initialState) {
+        try {
+            await this.flowCatalog.getFlowById(initialState.value);
+            return [initialState.value];
+        }
+        catch (_error) {
+            return [];
+        }
+    }
+    async resolveNameReference(initialState, nameToIdMap) {
+        const cachedFlowId = nameToIdMap.get(initialState.value);
+        if (cachedFlowId) {
+            return [cachedFlowId];
+        }
+        try {
+            const dependentFlow = await this.flowCatalog.getFlowByName(initialState.value);
+            nameToIdMap.set(initialState.value, dependentFlow.id);
+            return [dependentFlow.id];
+        }
+        catch (_error) {
+            return [];
+        }
+    }
+}
+exports.FlowDependencyResolver = FlowDependencyResolver;
+//# sourceMappingURL=FlowDependencyResolver.js.map

package/dist/managers/FlowDependencyResolver.js.map

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

package/dist/managers/FlowRuntime.d.ts

@@ -0,0 +1,18 @@
+import type { FlowHandle } from '../models/FlowHandle';
+import type { FlowMetadata } from '../models/FlowMetadata';
+/**
+ * Tracks active Donobu flows and their associated metadata.
+ *
+ * This class is intentionally tiny: it is the single source of truth for
+ * in-memory flow state so consumers don't need to juggle multiple maps or
+ * embed lifecycle bookkeeping in higher-level managers.
+ */
+export declare class FlowRuntime {
+    private readonly activeFlows;
+    register(flowHandle: FlowHandle): void;
+    get(flowId: string): FlowHandle | undefined;
+    remove(flowId: string): void;
+    metadataFor(flowId: string): FlowMetadata | undefined;
+    handles(): Iterable<FlowHandle>;
+}
+//# sourceMappingURL=FlowRuntime.d.ts.map

package/dist/managers/FlowRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowRuntime.d.ts","sourceRoot":"","sources":["../../src/managers/FlowRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAE3D,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAItC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKrD,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC;CAGvC"}

package/dist/managers/FlowRuntime.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowRuntime = void 0;
+/**
+ * Tracks active Donobu flows and their associated metadata.
+ *
+ * This class is intentionally tiny: it is the single source of truth for
+ * in-memory flow state so consumers don't need to juggle multiple maps or
+ * embed lifecycle bookkeeping in higher-level managers.
+ */
+class FlowRuntime {
+    constructor() {
+        this.activeFlows = new Map();
+    }
+    register(flowHandle) {
+        this.activeFlows.set(flowHandle.donobuFlow.metadata.id, flowHandle);
+    }
+    get(flowId) {
+        return this.activeFlows.get(flowId);
+    }
+    remove(flowId) {
+        this.activeFlows.delete(flowId);
+    }
+    metadataFor(flowId) {
+        const handle = this.activeFlows.get(flowId);
+        return handle?.donobuFlow.metadata;
+    }
+    handles() {
+        return this.activeFlows.values();
+    }
+}
+exports.FlowRuntime = FlowRuntime;
+//# sourceMappingURL=FlowRuntime.js.map

package/dist/managers/FlowRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowRuntime.js","sourceRoot":"","sources":["../../src/managers/FlowRuntime.ts"],"names":[],"mappings":";;;AAGA;;;;;;GAMG;AACH,MAAa,WAAW;IAAxB;QACmB,gBAAW,GAA4B,IAAI,GAAG,EAAE,CAAC;IAsBpE,CAAC;IApBQ,QAAQ,CAAC,UAAsB;QACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IAEM,GAAG,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,MAAc;QAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAEM,WAAW,CAAC,MAAc;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;IACrC,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;CACF;AAvBD,kCAuBC"}

package/dist/managers/GptConfigsManager.d.ts

@@ -1,6 +1,4 @@
-import type { EnvPick } from 'env-struct';
 import type { GptClientFactory } from '../clients/GptClientFactory';
-import type { env } from '../envVars';
 import type { GptConfig } from '../models/GptConfig';
 import type { GptConfigsPersistence } from '../persistence/gptconfigs/GptConfigsPersistence';
 /**
@@ -11,7 +9,7 @@ export declare class GptConfigsManager {
     private readonly persistence;
     private readonly gptClientFactory;
     private constructor();
-    static create(persistence: GptConfigsPersistence, gptClientFactory: GptClientFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'OPENAI_API_KEY'>): Promise<GptConfigsManager>;
+    static create(persistence: GptConfigsPersistence, gptClientFactory: GptClientFactory): Promise<GptConfigsManager>;
     /**
      * Attempt to save the given GPT config. Where possible, a zero-cost
      * request is attempted to be made with the GPT config before saving it.
@@ -34,10 +32,5 @@ export declare class GptConfigsManager {
      * Verifies the given GPT config and name or throws if they are invalid.
      */
     private verifyGptConfigOrThrow;
-    /**
-     * Inspects environment variables and legacy GPT platform keys files to
-     * initialize default GPT configurations.
-     */
-    private initializeDefaultConfigurations;
 }
 //# sourceMappingURL=GptConfigsManager.d.ts.map

package/dist/managers/GptConfigsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GptConfigsManager.d.ts","sourceRoot":"","sources":["../../src/managers/GptConfigsManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAI7F;;;GAGG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAFnC,OAAO;WAKa,MAAM,CACxB,WAAW,EAAE,qBAAqB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,OAAO,EAAE,OAAO,CACd,OAAO,GAAG,EACR,mBAAmB,GACnB,gBAAgB,GAChB,8BAA8B,GAC9B,gBAAgB,CACnB,GACA,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;OAIG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlD;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAItD;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;YACW,sBAAsB;IASpC;;;OAGG;YACW,+BAA+B;CAuK9C"}
+{"version":3,"file":"GptConfigsManager.d.ts","sourceRoot":"","sources":["../../src/managers/GptConfigsManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAE7F;;;GAGG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAFnC,OAAO;WAKa,MAAM,CACxB,WAAW,EAAE,qBAAqB,EAClC,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAK7B;;;;OAIG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlD;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAItD;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;YACW,sBAAsB;CAQrC"}