donobu 2.46.1 → 2.46.4

package/dist/assets/generated/version

@@ -1 +1 @@
-1401
+1409

package/dist/envVars.d.ts

@@ -1,64 +1,147 @@
+import { Env } from 'env-struct';
+import { z } from 'zod/v4';
 /**
  * This is the set of environment variable (for the process) names that Donobu may use.
  * This should not be confused with the user-defined API-based environment variables
  * that may be used in a flow.
  */
-declare const ENV_VAR_LIST: readonly ["BASE_WORKING_DIR", "BASE64_GPT_CONFIG", "BROWSERBASE_API_KEY", "BROWSERBASE_PROJECT_ID", "DONOBU_DEPLOYMENT_ENVIRONMENT", "ANTHROPIC_API_KEY", "ANTHROPIC_MODEL_NAME", "GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_GENERATIVE_AI_MODEL_NAME", "OPENAI_API_KEY", "OPENAI_API_MODEL_NAME", "DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME", "AWS_S3_BUCKET", "AWS_S3_REGION", "AWS_BEDROCK_MODEL_NAME", "AWS_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "GOOGLE_CLOUD_STORAGE_BUCKET", "SUPABASE_JWT_SECRET_KEY", "SELF_HEAL_TESTS_ENABLED", "PROXY_SERVER", "PROXY_USERNAME", "PROXY_PASSWORD"];
-type ReadonlyEnvAccessor<T extends Record<string, string>> = {
-    readonly [K in keyof T]: string | undefined;
-};
-export type EnvName = (typeof ENV_VAR_LIST)[number];
-export declare const ENV_NAMES: Readonly<{
-    BASE_WORKING_DIR: "BASE_WORKING_DIR";
-    BASE64_GPT_CONFIG: "BASE64_GPT_CONFIG";
-    BROWSERBASE_API_KEY: "BROWSERBASE_API_KEY";
-    BROWSERBASE_PROJECT_ID: "BROWSERBASE_PROJECT_ID";
-    DONOBU_DEPLOYMENT_ENVIRONMENT: "DONOBU_DEPLOYMENT_ENVIRONMENT";
-    ANTHROPIC_API_KEY: "ANTHROPIC_API_KEY";
-    ANTHROPIC_MODEL_NAME: "ANTHROPIC_MODEL_NAME";
-    GOOGLE_GENERATIVE_AI_API_KEY: "GOOGLE_GENERATIVE_AI_API_KEY";
-    GOOGLE_GENERATIVE_AI_MODEL_NAME: "GOOGLE_GENERATIVE_AI_MODEL_NAME";
-    OPENAI_API_KEY: "OPENAI_API_KEY";
-    OPENAI_API_MODEL_NAME: "OPENAI_API_MODEL_NAME";
-    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: "DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME";
-    AWS_S3_BUCKET: "AWS_S3_BUCKET";
-    AWS_S3_REGION: "AWS_S3_REGION";
-    AWS_BEDROCK_MODEL_NAME: "AWS_BEDROCK_MODEL_NAME";
-    AWS_REGION: "AWS_REGION";
-    AWS_ACCESS_KEY_ID: "AWS_ACCESS_KEY_ID";
-    AWS_SECRET_ACCESS_KEY: "AWS_SECRET_ACCESS_KEY";
-    GOOGLE_CLOUD_STORAGE_BUCKET: "GOOGLE_CLOUD_STORAGE_BUCKET";
-    SUPABASE_JWT_SECRET_KEY: "SUPABASE_JWT_SECRET_KEY";
-    SELF_HEAL_TESTS_ENABLED: "SELF_HEAL_TESTS_ENABLED";
-    PROXY_SERVER: "PROXY_SERVER";
-    PROXY_USERNAME: "PROXY_USERNAME";
-    PROXY_PASSWORD: "PROXY_PASSWORD";
+export declare const env: Env<{
+    /**
+     * Windows-specific roaming application data directory. This is typically set
+     * by the OS and used to derive platform default storage paths. This is
+     * ignored if BASE_WORKING_DIR is explicitly set.
+     */
+    APPDATA: z.ZodOptional<z.ZodString>;
+    /**
+     * Overrides the effective working/persistence directory.
+     */
+    BASE_WORKING_DIR: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, use this base-64 JSON GPT configuration for running flows.
+     * This takes priority over all other GPT configuration options.
+     */
+    BASE64_GPT_CONFIG: z.ZodOptional<z.ZodString>;
+    /**
+     * The API key to use for the BrowserBase API.
+     */
+    BROWSERBASE_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * The project ID to use for the BrowserBase API.
+     */
+    BROWSERBASE_PROJECT_ID: z.ZodOptional<z.ZodString>;
+    /**
+     * The deployment environment for this application.
+     *
+     * If this is set to "DONOBU_HOSTED_MULTI_TENANT" then the
+     * SUPABASE_JWT_SECRET_KEY environment variable must also be set.
+     */
+    DONOBU_DEPLOYMENT_ENVIRONMENT: z.ZodOptional<z.ZodEnum<{
+        LOCAL: "LOCAL";
+        DONOBU_HOSTED_MULTI_TENANT: "DONOBU_HOSTED_MULTI_TENANT";
+        DONOBU_HOSTED_SINGLE_TENANT: "DONOBU_HOSTED_SINGLE_TENANT";
+    }>>;
+    /**
+     * Automatically create GPT configurations for Anthropic using this API key.
+     * For convenience, the created configuration names will reflect the
+     * underlying models they map to (ex: "claude-3-7-sonnet-latest", etc).
+     */
+    ANTHROPIC_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, ANTHROPIC_API_KEY must also be specified.
+     */
+    ANTHROPIC_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Automatically create GPT configurations for Google Gemini using this API key.
+     * For convenience, the created configuration names will reflect the
+     * underlying models they map to (ex: "gemini-2.0-flash", etc).
+     */
+    GOOGLE_GENERATIVE_AI_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, GOOGLE_GENERATIVE_AI_API_KEY must also be specified.
+     */
+    GOOGLE_GENERATIVE_AI_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Automatically create GPT configurations for OpenAI using this API key.
+     * For convenience, the created configuration names will reflect the
+     * underlying models they map to (ex: "gpt-4o", etc).
+     */
+    OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, OPENAI_API_KEY must also be specified.
+     */
+    OPENAI_API_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Automatically set the 'flow-runner' agent to use this GPT configuration by name.
+     */
+    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Directs Donobu flows to be persisted using this AWS S3 bucket. Takes
+     * priority over GOOGLE_CLOUD_STORAGE_BUCKET being specified.
+     */
+    AWS_S3_BUCKET: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS S3 region the corresponding AWS_S3_BUCKET lives in. Fails over to
+     * the AWS_REGION environment variable if not specified.
+     */
+    AWS_S3_REGION: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, AWS credentials must also be present.
+     */
+    AWS_BEDROCK_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS region to use for operations using the AWS SDK.
+     */
+    AWS_REGION: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS access key ID to use for operations using the AWS SDK.
+     */
+    AWS_ACCESS_KEY_ID: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS access key to use for operations using the AWS SDK.
+     */
+    AWS_SECRET_ACCESS_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * Directs Donobu flows to be persisted using this Google Cloud Storage
+     * bucket.
+     */
+    GOOGLE_CLOUD_STORAGE_BUCKET: z.ZodOptional<z.ZodString>;
+    /**
+     * Directs Donobu flows to be persisted using Supabase using this key.
+     *
+     * This environment variable MUST be specified if the
+     * DONOBU_DEPLOYMENT_ENVIRONMENT environment variable is set to
+     * "DONOBU_HOSTED_MULTI_TENANT".
+     */
+    SUPABASE_JWT_SECRET_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If set to 'true', then Donobu will attempt to self-heal tests. This option
+     * is only used when using Donobu as a library to run Playwright-based tests.
+     */
+    SELF_HEAL_TESTS_ENABLED: z.ZodOptional<z.ZodString>;
+    /**
+     * Default URL for the browser proxy configuration. Only applies when running
+     * flows using the 'device' type and a proxy URL is not otherwise specified.
+     */
+    PROXY_SERVER: z.ZodOptional<z.ZodString>;
+    /**
+     * Default user name for the browser proxy configuration. Only applies when running
+     * flows using the 'device' type and a proxy username is not otherwise specified.
+     */
+    PROXY_USERNAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Default password for the browser proxy configuration. Only applies when running
+     * flows using the 'device' type and a proxy password is not otherwise specified.
+     */
+    PROXY_PASSWORD: z.ZodOptional<z.ZodString>;
+    /**
+     * Linux-specific configuration directory root following the XDG Base
+     * Directory specification. Used to derive platform default storage paths.
+     * This is ignored if BASE_WORKING_DIR is explicitly set.
+     */
+    XDG_CONFIG_HOME: z.ZodOptional<z.ZodString>;
 }>;
-export declare const ENV: ReadonlyEnvAccessor<Readonly<{
-    BASE_WORKING_DIR: "BASE_WORKING_DIR";
-    BASE64_GPT_CONFIG: "BASE64_GPT_CONFIG";
-    BROWSERBASE_API_KEY: "BROWSERBASE_API_KEY";
-    BROWSERBASE_PROJECT_ID: "BROWSERBASE_PROJECT_ID";
-    DONOBU_DEPLOYMENT_ENVIRONMENT: "DONOBU_DEPLOYMENT_ENVIRONMENT";
-    ANTHROPIC_API_KEY: "ANTHROPIC_API_KEY";
-    ANTHROPIC_MODEL_NAME: "ANTHROPIC_MODEL_NAME";
-    GOOGLE_GENERATIVE_AI_API_KEY: "GOOGLE_GENERATIVE_AI_API_KEY";
-    GOOGLE_GENERATIVE_AI_MODEL_NAME: "GOOGLE_GENERATIVE_AI_MODEL_NAME";
-    OPENAI_API_KEY: "OPENAI_API_KEY";
-    OPENAI_API_MODEL_NAME: "OPENAI_API_MODEL_NAME";
-    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: "DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME";
-    AWS_S3_BUCKET: "AWS_S3_BUCKET";
-    AWS_S3_REGION: "AWS_S3_REGION";
-    AWS_BEDROCK_MODEL_NAME: "AWS_BEDROCK_MODEL_NAME";
-    AWS_REGION: "AWS_REGION";
-    AWS_ACCESS_KEY_ID: "AWS_ACCESS_KEY_ID";
-    AWS_SECRET_ACCESS_KEY: "AWS_SECRET_ACCESS_KEY";
-    GOOGLE_CLOUD_STORAGE_BUCKET: "GOOGLE_CLOUD_STORAGE_BUCKET";
-    SUPABASE_JWT_SECRET_KEY: "SUPABASE_JWT_SECRET_KEY";
-    SELF_HEAL_TESTS_ENABLED: "SELF_HEAL_TESTS_ENABLED";
-    PROXY_SERVER: "PROXY_SERVER";
-    PROXY_USERNAME: "PROXY_USERNAME";
-    PROXY_PASSWORD: "PROXY_PASSWORD";
-}>>;
-export {};
 //# sourceMappingURL=envVars.d.ts.map

package/dist/envVars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,YAAY,ykBA0HR,CAAC;AAoBX,KAAK,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;IAC3D,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS;CAC5C,CAAC;AAqBF,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACpD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAAkC,CAAC;AACzD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;GAA+B,CAAC"}
+{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B;;;;GAIG;AACH,eAAO,MAAM,GAAG;IACd;;;;OAIG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;;;;OAKG;;;;;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;;;;;OAMG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;EAEH,CAAC"}

package/dist/envVars.js

@@ -1,105 +1,114 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENV = exports.ENV_NAMES = void 0;
+exports.env = void 0;
+const env_struct_1 = require("env-struct");
+const v4_1 = require("zod/v4");
+const DonobuDeploymentEnvironment_1 = require("./models/DonobuDeploymentEnvironment");
 /**
  * This is the set of environment variable (for the process) names that Donobu may use.
  * This should not be confused with the user-defined API-based environment variables
  * that may be used in a flow.
  */
-const ENV_VAR_LIST = [
+exports.env = env_struct_1.Env.fromSchema({
+    /**
+     * Windows-specific roaming application data directory. This is typically set
+     * by the OS and used to derive platform default storage paths. This is
+     * ignored if BASE_WORKING_DIR is explicitly set.
+     */
+    APPDATA: v4_1.z.string().optional(),
     /**
      * Overrides the effective working/persistence directory.
      */
-    'BASE_WORKING_DIR',
+    BASE_WORKING_DIR: v4_1.z.string().optional(),
     /**
      * If specified, use this base-64 JSON GPT configuration for running flows.
      * This takes priority over all other GPT configuration options.
      */
-    'BASE64_GPT_CONFIG',
+    BASE64_GPT_CONFIG: v4_1.z.string().optional(),
     /**
      * The API key to use for the BrowserBase API.
      */
-    'BROWSERBASE_API_KEY',
+    BROWSERBASE_API_KEY: v4_1.z.string().optional(),
     /**
      * The project ID to use for the BrowserBase API.
      */
-    'BROWSERBASE_PROJECT_ID',
+    BROWSERBASE_PROJECT_ID: v4_1.z.string().optional(),
     /**
      * The deployment environment for this application.
      *
      * If this is set to "DONOBU_HOSTED_MULTI_TENANT" then the
      * SUPABASE_JWT_SECRET_KEY environment variable must also be set.
      */
-    'DONOBU_DEPLOYMENT_ENVIRONMENT',
+    DONOBU_DEPLOYMENT_ENVIRONMENT: DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironmentSchema.optional(),
     /**
      * Automatically create GPT configurations for Anthropic using this API key.
      * For convenience, the created configuration names will reflect the
      * underlying models they map to (ex: "claude-3-7-sonnet-latest", etc).
      */
-    'ANTHROPIC_API_KEY',
+    ANTHROPIC_API_KEY: v4_1.z.string().optional(),
     /**
      * If specified, this will shade the default flow runner agent when running
      * flows. If specified, ANTHROPIC_API_KEY must also be specified.
      */
-    'ANTHROPIC_MODEL_NAME',
+    ANTHROPIC_MODEL_NAME: v4_1.z.string().optional(),
     /**
      * Automatically create GPT configurations for Google Gemini using this API key.
      * For convenience, the created configuration names will reflect the
      * underlying models they map to (ex: "gemini-2.0-flash", etc).
      */
-    'GOOGLE_GENERATIVE_AI_API_KEY',
+    GOOGLE_GENERATIVE_AI_API_KEY: v4_1.z.string().optional(),
     /**
      * If specified, this will shade the default flow runner agent when running
      * flows. If specified, GOOGLE_GENERATIVE_AI_API_KEY must also be specified.
      */
-    'GOOGLE_GENERATIVE_AI_MODEL_NAME',
+    GOOGLE_GENERATIVE_AI_MODEL_NAME: v4_1.z.string().optional(),
     /**
      * Automatically create GPT configurations for OpenAI using this API key.
      * For convenience, the created configuration names will reflect the
      * underlying models they map to (ex: "gpt-4o", etc).
      */
-    'OPENAI_API_KEY',
+    OPENAI_API_KEY: v4_1.z.string().optional(),
     /**
      * If specified, this will shade the default flow runner agent when running
      * flows. If specified, OPENAI_API_KEY must also be specified.
      */
-    'OPENAI_API_MODEL_NAME',
+    OPENAI_API_MODEL_NAME: v4_1.z.string().optional(),
     /**
      * Automatically set the 'flow-runner' agent to use this GPT configuration by name.
      */
-    'DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME',
+    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: v4_1.z.string().optional(),
     /**
      * Directs Donobu flows to be persisted using this AWS S3 bucket. Takes
      * priority over GOOGLE_CLOUD_STORAGE_BUCKET being specified.
      */
-    'AWS_S3_BUCKET',
+    AWS_S3_BUCKET: v4_1.z.string().optional(),
     /**
      * The AWS S3 region the corresponding AWS_S3_BUCKET lives in. Fails over to
      * the AWS_REGION environment variable if not specified.
      */
-    'AWS_S3_REGION',
+    AWS_S3_REGION: v4_1.z.string().optional(),
     /**
      * If specified, this will shade the default flow runner agent when running
      * flows. If specified, AWS credentials must also be present.
      */
-    'AWS_BEDROCK_MODEL_NAME',
+    AWS_BEDROCK_MODEL_NAME: v4_1.z.string().optional(),
     /**
      * The AWS region to use for operations using the AWS SDK.
      */
-    'AWS_REGION',
+    AWS_REGION: v4_1.z.string().optional(),
     /**
      * The AWS access key ID to use for operations using the AWS SDK.
      */
-    'AWS_ACCESS_KEY_ID',
+    AWS_ACCESS_KEY_ID: v4_1.z.string().optional(),
     /**
      * The AWS access key to use for operations using the AWS SDK.
      */
-    'AWS_SECRET_ACCESS_KEY',
+    AWS_SECRET_ACCESS_KEY: v4_1.z.string().optional(),
     /**
      * Directs Donobu flows to be persisted using this Google Cloud Storage
      * bucket.
      */
-    'GOOGLE_CLOUD_STORAGE_BUCKET',
+    GOOGLE_CLOUD_STORAGE_BUCKET: v4_1.z.string().optional(),
     /**
      * Directs Donobu flows to be persisted using Supabase using this key.
      *
@@ -107,54 +116,32 @@ const ENV_VAR_LIST = [
      * DONOBU_DEPLOYMENT_ENVIRONMENT environment variable is set to
      * "DONOBU_HOSTED_MULTI_TENANT".
      */
-    'SUPABASE_JWT_SECRET_KEY',
+    SUPABASE_JWT_SECRET_KEY: v4_1.z.string().optional(),
     /**
      * If set to 'true', then Donobu will attempt to self-heal tests. This option
      * is only used when using Donobu as a library to run Playwright-based tests.
      */
-    'SELF_HEAL_TESTS_ENABLED',
+    SELF_HEAL_TESTS_ENABLED: v4_1.z.string().optional(),
     /**
      * Default URL for the browser proxy configuration. Only applies when running
      * flows using the 'device' type and a proxy URL is not otherwise specified.
      */
-    'PROXY_SERVER',
+    PROXY_SERVER: v4_1.z.string().optional(),
     /**
      * Default user name for the browser proxy configuration. Only applies when running
      * flows using the 'device' type and a proxy username is not otherwise specified.
      */
-    'PROXY_USERNAME',
+    PROXY_USERNAME: v4_1.z.string().optional(),
     /**
      * Default password for the browser proxy configuration. Only applies when running
      * flows using the 'device' type and a proxy password is not otherwise specified.
      */
-    'PROXY_PASSWORD',
-];
-/**
- * Creates a frozen record that maps each literal in the env var list back to itself.
- * Consumers rely on this to keep compile-time and runtime views of env var names aligned.
- */
-const createEnvVarNames = (names) => {
-    const result = {};
-    for (const name of names) {
-        const key = name;
-        result[key] = key;
-    }
-    return Object.freeze(result);
-};
-/**
- * Creates an object with lazy getters that read from `process.env` using the provided key mapping.
- * Keeps `ENV` in sync with `ENV_VAR_NAMES` without repeating every accessor.
- */
-const createEnvAccessor = (names) => {
-    const accessor = {};
-    for (const key of Object.keys(names)) {
-        Object.defineProperty(accessor, key, {
-            enumerable: true,
-            get: () => process.env[names[key]],
-        });
-    }
-    return Object.freeze(accessor);
-};
-exports.ENV_NAMES = createEnvVarNames(ENV_VAR_LIST);
-exports.ENV = createEnvAccessor(exports.ENV_NAMES);
+    PROXY_PASSWORD: v4_1.z.string().optional(),
+    /**
+     * Linux-specific configuration directory root following the XDG Base
+     * Directory specification. Used to derive platform default storage paths.
+     * This is ignored if BASE_WORKING_DIR is explicitly set.
+     */
+    XDG_CONFIG_HOME: v4_1.z.string().optional(),
+});
 //# sourceMappingURL=envVars.js.map

package/dist/envVars.js.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.js","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAM,YAAY,GAAG;IACnB;;OAEG;IACH,kBAAkB;IAClB;;;OAGG;IACH,mBAAmB;IACnB;;OAEG;IACH,qBAAqB;IACrB;;OAEG;IACH,wBAAwB;IACxB;;;;;OAKG;IACH,+BAA+B;IAC/B;;;;OAIG;IACH,mBAAmB;IACnB;;;OAGG;IACH,sBAAsB;IACtB;;;;OAIG;IACH,8BAA8B;IAC9B;;;OAGG;IACH,iCAAiC;IACjC;;;;OAIG;IACH,gBAAgB;IAChB;;;OAGG;IACH,uBAAuB;IACvB;;OAEG;IACH,qCAAqC;IACrC;;;OAGG;IACH,eAAe;IACf;;;OAGG;IACH,eAAe;IACf;;;OAGG;IACH,wBAAwB;IACxB;;OAEG;IACH,YAAY;IACZ;;OAEG;IACH,mBAAmB;IACnB;;OAEG;IACH,uBAAuB;IACvB;;;OAGG;IACH,6BAA6B;IAC7B;;;;;;OAMG;IACH,yBAAyB;IACzB;;;OAGG;IACH,yBAAyB;IACzB;;;OAGG;IACH,cAAc;IACd;;;OAGG;IACH,gBAAgB;IAChB;;;OAGG;IACH,gBAAgB;CACR,CAAC;AAEX;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CACxB,KAAY,EAC2B,EAAE;IACzC,MAAM,MAAM,GAAG,EAAiC,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAqB,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC,CAAC;AAOF;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CACxB,KAAQ,EACgB,EAAE;IAC1B,MAAM,QAAQ,GAAG,EAA4B,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAmB,EAAE,CAAC;QACvD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE;YACnC,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC;AAGW,QAAA,SAAS,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;AAC5C,QAAA,GAAG,GAAG,iBAAiB,CAAC,iBAAS,CAAC,CAAC"}
+{"version":3,"file":"envVars.js","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":";;;AAAA,2CAAiC;AACjC,+BAA2B;AAC3B,sFAAyF;AAEzF;;;;GAIG;AACU,QAAA,GAAG,GAAG,gBAAG,CAAC,UAAU,CAAC;IAChC;;;;OAIG;IACH,OAAO,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B;;OAEG;IACH,gBAAgB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC;;;OAGG;IACH,iBAAiB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC;;OAEG;IACH,mBAAmB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C;;OAEG;IACH,sBAAsB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C;;;;;OAKG;IACH,6BAA6B,EAAE,+DAAiC,CAAC,QAAQ,EAAE;IAC3E;;;;OAIG;IACH,iBAAiB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC;;;OAGG;IACH,oBAAoB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C;;;;OAIG;IACH,4BAA4B,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnD;;;OAGG;IACH,+BAA+B,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtD;;;;OAIG;IACH,cAAc,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC;;;OAGG;IACH,qBAAqB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C;;OAEG;IACH,mCAAmC,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1D;;;OAGG;IACH,aAAa,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC;;;OAGG;IACH,aAAa,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC;;;OAGG;IACH,sBAAsB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C;;OAEG;IACH,UAAU,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC;;OAEG;IACH,iBAAiB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC;;OAEG;IACH,qBAAqB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C;;;OAGG;IACH,2BAA2B,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClD;;;;;;OAMG;IACH,uBAAuB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9C;;;OAGG;IACH,uBAAuB,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9C;;;OAGG;IACH,YAAY,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC;;;OAGG;IACH,cAAc,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC;;;OAGG;IACH,cAAc,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC;;;;OAIG;IACH,eAAe,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}

package/dist/esm/assets/generated/version

@@ -1 +1 @@
-1401
+1409

package/dist/esm/envVars.d.ts

@@ -1,64 +1,147 @@
+import { Env } from 'env-struct';
+import { z } from 'zod/v4';
 /**
  * This is the set of environment variable (for the process) names that Donobu may use.
  * This should not be confused with the user-defined API-based environment variables
  * that may be used in a flow.
  */
-declare const ENV_VAR_LIST: readonly ["BASE_WORKING_DIR", "BASE64_GPT_CONFIG", "BROWSERBASE_API_KEY", "BROWSERBASE_PROJECT_ID", "DONOBU_DEPLOYMENT_ENVIRONMENT", "ANTHROPIC_API_KEY", "ANTHROPIC_MODEL_NAME", "GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_GENERATIVE_AI_MODEL_NAME", "OPENAI_API_KEY", "OPENAI_API_MODEL_NAME", "DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME", "AWS_S3_BUCKET", "AWS_S3_REGION", "AWS_BEDROCK_MODEL_NAME", "AWS_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "GOOGLE_CLOUD_STORAGE_BUCKET", "SUPABASE_JWT_SECRET_KEY", "SELF_HEAL_TESTS_ENABLED", "PROXY_SERVER", "PROXY_USERNAME", "PROXY_PASSWORD"];
-type ReadonlyEnvAccessor<T extends Record<string, string>> = {
-    readonly [K in keyof T]: string | undefined;
-};
-export type EnvName = (typeof ENV_VAR_LIST)[number];
-export declare const ENV_NAMES: Readonly<{
-    BASE_WORKING_DIR: "BASE_WORKING_DIR";
-    BASE64_GPT_CONFIG: "BASE64_GPT_CONFIG";
-    BROWSERBASE_API_KEY: "BROWSERBASE_API_KEY";
-    BROWSERBASE_PROJECT_ID: "BROWSERBASE_PROJECT_ID";
-    DONOBU_DEPLOYMENT_ENVIRONMENT: "DONOBU_DEPLOYMENT_ENVIRONMENT";
-    ANTHROPIC_API_KEY: "ANTHROPIC_API_KEY";
-    ANTHROPIC_MODEL_NAME: "ANTHROPIC_MODEL_NAME";
-    GOOGLE_GENERATIVE_AI_API_KEY: "GOOGLE_GENERATIVE_AI_API_KEY";
-    GOOGLE_GENERATIVE_AI_MODEL_NAME: "GOOGLE_GENERATIVE_AI_MODEL_NAME";
-    OPENAI_API_KEY: "OPENAI_API_KEY";
-    OPENAI_API_MODEL_NAME: "OPENAI_API_MODEL_NAME";
-    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: "DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME";
-    AWS_S3_BUCKET: "AWS_S3_BUCKET";
-    AWS_S3_REGION: "AWS_S3_REGION";
-    AWS_BEDROCK_MODEL_NAME: "AWS_BEDROCK_MODEL_NAME";
-    AWS_REGION: "AWS_REGION";
-    AWS_ACCESS_KEY_ID: "AWS_ACCESS_KEY_ID";
-    AWS_SECRET_ACCESS_KEY: "AWS_SECRET_ACCESS_KEY";
-    GOOGLE_CLOUD_STORAGE_BUCKET: "GOOGLE_CLOUD_STORAGE_BUCKET";
-    SUPABASE_JWT_SECRET_KEY: "SUPABASE_JWT_SECRET_KEY";
-    SELF_HEAL_TESTS_ENABLED: "SELF_HEAL_TESTS_ENABLED";
-    PROXY_SERVER: "PROXY_SERVER";
-    PROXY_USERNAME: "PROXY_USERNAME";
-    PROXY_PASSWORD: "PROXY_PASSWORD";
+export declare const env: Env<{
+    /**
+     * Windows-specific roaming application data directory. This is typically set
+     * by the OS and used to derive platform default storage paths. This is
+     * ignored if BASE_WORKING_DIR is explicitly set.
+     */
+    APPDATA: z.ZodOptional<z.ZodString>;
+    /**
+     * Overrides the effective working/persistence directory.
+     */
+    BASE_WORKING_DIR: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, use this base-64 JSON GPT configuration for running flows.
+     * This takes priority over all other GPT configuration options.
+     */
+    BASE64_GPT_CONFIG: z.ZodOptional<z.ZodString>;
+    /**
+     * The API key to use for the BrowserBase API.
+     */
+    BROWSERBASE_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * The project ID to use for the BrowserBase API.
+     */
+    BROWSERBASE_PROJECT_ID: z.ZodOptional<z.ZodString>;
+    /**
+     * The deployment environment for this application.
+     *
+     * If this is set to "DONOBU_HOSTED_MULTI_TENANT" then the
+     * SUPABASE_JWT_SECRET_KEY environment variable must also be set.
+     */
+    DONOBU_DEPLOYMENT_ENVIRONMENT: z.ZodOptional<z.ZodEnum<{
+        LOCAL: "LOCAL";
+        DONOBU_HOSTED_MULTI_TENANT: "DONOBU_HOSTED_MULTI_TENANT";
+        DONOBU_HOSTED_SINGLE_TENANT: "DONOBU_HOSTED_SINGLE_TENANT";
+    }>>;
+    /**
+     * Automatically create GPT configurations for Anthropic using this API key.
+     * For convenience, the created configuration names will reflect the
+     * underlying models they map to (ex: "claude-3-7-sonnet-latest", etc).
+     */
+    ANTHROPIC_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, ANTHROPIC_API_KEY must also be specified.
+     */
+    ANTHROPIC_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Automatically create GPT configurations for Google Gemini using this API key.
+     * For convenience, the created configuration names will reflect the
+     * underlying models they map to (ex: "gemini-2.0-flash", etc).
+     */
+    GOOGLE_GENERATIVE_AI_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, GOOGLE_GENERATIVE_AI_API_KEY must also be specified.
+     */
+    GOOGLE_GENERATIVE_AI_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Automatically create GPT configurations for OpenAI using this API key.
+     * For convenience, the created configuration names will reflect the
+     * underlying models they map to (ex: "gpt-4o", etc).
+     */
+    OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, OPENAI_API_KEY must also be specified.
+     */
+    OPENAI_API_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Automatically set the 'flow-runner' agent to use this GPT configuration by name.
+     */
+    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Directs Donobu flows to be persisted using this AWS S3 bucket. Takes
+     * priority over GOOGLE_CLOUD_STORAGE_BUCKET being specified.
+     */
+    AWS_S3_BUCKET: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS S3 region the corresponding AWS_S3_BUCKET lives in. Fails over to
+     * the AWS_REGION environment variable if not specified.
+     */
+    AWS_S3_REGION: z.ZodOptional<z.ZodString>;
+    /**
+     * If specified, this will shade the default flow runner agent when running
+     * flows. If specified, AWS credentials must also be present.
+     */
+    AWS_BEDROCK_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS region to use for operations using the AWS SDK.
+     */
+    AWS_REGION: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS access key ID to use for operations using the AWS SDK.
+     */
+    AWS_ACCESS_KEY_ID: z.ZodOptional<z.ZodString>;
+    /**
+     * The AWS access key to use for operations using the AWS SDK.
+     */
+    AWS_SECRET_ACCESS_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * Directs Donobu flows to be persisted using this Google Cloud Storage
+     * bucket.
+     */
+    GOOGLE_CLOUD_STORAGE_BUCKET: z.ZodOptional<z.ZodString>;
+    /**
+     * Directs Donobu flows to be persisted using Supabase using this key.
+     *
+     * This environment variable MUST be specified if the
+     * DONOBU_DEPLOYMENT_ENVIRONMENT environment variable is set to
+     * "DONOBU_HOSTED_MULTI_TENANT".
+     */
+    SUPABASE_JWT_SECRET_KEY: z.ZodOptional<z.ZodString>;
+    /**
+     * If set to 'true', then Donobu will attempt to self-heal tests. This option
+     * is only used when using Donobu as a library to run Playwright-based tests.
+     */
+    SELF_HEAL_TESTS_ENABLED: z.ZodOptional<z.ZodString>;
+    /**
+     * Default URL for the browser proxy configuration. Only applies when running
+     * flows using the 'device' type and a proxy URL is not otherwise specified.
+     */
+    PROXY_SERVER: z.ZodOptional<z.ZodString>;
+    /**
+     * Default user name for the browser proxy configuration. Only applies when running
+     * flows using the 'device' type and a proxy username is not otherwise specified.
+     */
+    PROXY_USERNAME: z.ZodOptional<z.ZodString>;
+    /**
+     * Default password for the browser proxy configuration. Only applies when running
+     * flows using the 'device' type and a proxy password is not otherwise specified.
+     */
+    PROXY_PASSWORD: z.ZodOptional<z.ZodString>;
+    /**
+     * Linux-specific configuration directory root following the XDG Base
+     * Directory specification. Used to derive platform default storage paths.
+     * This is ignored if BASE_WORKING_DIR is explicitly set.
+     */
+    XDG_CONFIG_HOME: z.ZodOptional<z.ZodString>;
 }>;
-export declare const ENV: ReadonlyEnvAccessor<Readonly<{
-    BASE_WORKING_DIR: "BASE_WORKING_DIR";
-    BASE64_GPT_CONFIG: "BASE64_GPT_CONFIG";
-    BROWSERBASE_API_KEY: "BROWSERBASE_API_KEY";
-    BROWSERBASE_PROJECT_ID: "BROWSERBASE_PROJECT_ID";
-    DONOBU_DEPLOYMENT_ENVIRONMENT: "DONOBU_DEPLOYMENT_ENVIRONMENT";
-    ANTHROPIC_API_KEY: "ANTHROPIC_API_KEY";
-    ANTHROPIC_MODEL_NAME: "ANTHROPIC_MODEL_NAME";
-    GOOGLE_GENERATIVE_AI_API_KEY: "GOOGLE_GENERATIVE_AI_API_KEY";
-    GOOGLE_GENERATIVE_AI_MODEL_NAME: "GOOGLE_GENERATIVE_AI_MODEL_NAME";
-    OPENAI_API_KEY: "OPENAI_API_KEY";
-    OPENAI_API_MODEL_NAME: "OPENAI_API_MODEL_NAME";
-    DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME: "DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME";
-    AWS_S3_BUCKET: "AWS_S3_BUCKET";
-    AWS_S3_REGION: "AWS_S3_REGION";
-    AWS_BEDROCK_MODEL_NAME: "AWS_BEDROCK_MODEL_NAME";
-    AWS_REGION: "AWS_REGION";
-    AWS_ACCESS_KEY_ID: "AWS_ACCESS_KEY_ID";
-    AWS_SECRET_ACCESS_KEY: "AWS_SECRET_ACCESS_KEY";
-    GOOGLE_CLOUD_STORAGE_BUCKET: "GOOGLE_CLOUD_STORAGE_BUCKET";
-    SUPABASE_JWT_SECRET_KEY: "SUPABASE_JWT_SECRET_KEY";
-    SELF_HEAL_TESTS_ENABLED: "SELF_HEAL_TESTS_ENABLED";
-    PROXY_SERVER: "PROXY_SERVER";
-    PROXY_USERNAME: "PROXY_USERNAME";
-    PROXY_PASSWORD: "PROXY_PASSWORD";
-}>>;
-export {};
 //# sourceMappingURL=envVars.d.ts.map

package/dist/esm/envVars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../../src/envVars.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,YAAY,ykBA0HR,CAAC;AAoBX,KAAK,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;IAC3D,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS;CAC5C,CAAC;AAqBF,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACpD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAAkC,CAAC;AACzD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;GAA+B,CAAC"}
+{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../../src/envVars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B;;;;GAIG;AACH,eAAO,MAAM,GAAG;IACd;;;;OAIG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;;;;OAKG;;;;;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;;OAGG;;IAEH;;;;;;OAMG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;EAEH,CAAC"}