donobu 5.18.3 → 5.20.0

package/dist/clients/GptClientFactory.js

@@ -7,6 +7,7 @@ const AnthropicGptClient_1 = require("./AnthropicGptClient");
 const DonobuGptClient_1 = require("./DonobuGptClient");
 const GoogleGenerativeAiGptClient_1 = require("./GoogleGenerativeAiGptClient");
 const GptClientPlugin_1 = require("./GptClientPlugin");
+const OllamaGptClient_1 = require("./OllamaGptClient");
 const OpenAiGptClient_1 = require("./OpenAiGptClient");
 /**
  * Default implementation of GptClientFactory that creates GPT clients
@@ -51,6 +52,8 @@ class GptClientFactoryImpl {
                 return new DonobuGptClient_1.DonobuGptClient(config);
             case 'GOOGLE_GEMINI':
                 return new GoogleGenerativeAiGptClient_1.GoogleGenerativeAiGptClient(config);
+            case 'OLLAMA':
+                return new OllamaGptClient_1.OllamaGptClient(config);
             case 'OPENAI':
                 return new OpenAiGptClient_1.OpenAiGptClient(config);
             default:

package/dist/clients/OllamaGptClient.d.ts

@@ -0,0 +1,29 @@
+import type { ZodType } from 'zod/v4';
+import type { OllamaConfig } from '../models/GptConfig';
+import type { AssistantMessage, GptMessage, ProposedToolCallsMessage, StructuredOutputMessage } from '../models/GptMessage';
+import type { ToolOption } from './GptClient';
+import { GptClient } from './GptClient';
+/**
+ * A GPT client for Ollama, a local LLM runner that exposes an OpenAI-compatible API.
+ * Delegates to {@link OpenAiGptClient} for request handling, with Ollama-specific
+ * overrides for ping and structured output.
+ */
+export declare class OllamaGptClient extends GptClient {
+    private static readonly DEFAULT_API_URL;
+    private readonly delegate;
+    private readonly apiUrl;
+    constructor(ollamaConfig: OllamaConfig);
+    ping(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getMessage(messages: GptMessage[], options?: {
+        signal?: AbortSignal;
+    }): Promise<AssistantMessage>;
+    getStructuredOutput<T>(messages: GptMessage[], zodSchema: ZodType<T>, options?: {
+        signal?: AbortSignal;
+    }): Promise<StructuredOutputMessage<T>>;
+    getToolCalls(messages: GptMessage[], tools: ToolOption[], options?: {
+        signal?: AbortSignal;
+    }): Promise<ProposedToolCallsMessage>;
+}
+//# sourceMappingURL=OllamaGptClient.d.ts.map

package/dist/clients/OllamaGptClient.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaGptClient = void 0;
+const GptModelNotFoundException_1 = require("../exceptions/GptModelNotFoundException");
+const GptPlatformNotReachableException_1 = require("../exceptions/GptPlatformNotReachableException");
+const Logger_1 = require("../utils/Logger");
+const GptClient_1 = require("./GptClient");
+const OpenAiGptClient_1 = require("./OpenAiGptClient");
+/**
+ * A GPT client for Ollama, a local LLM runner that exposes an OpenAI-compatible API.
+ * Delegates to {@link OpenAiGptClient} for request handling, with Ollama-specific
+ * overrides for ping and structured output.
+ */
+class OllamaGptClient extends GptClient_1.GptClient {
+    constructor(ollamaConfig) {
+        super(ollamaConfig);
+        this.apiUrl = ollamaConfig.apiUrl ?? OllamaGptClient.DEFAULT_API_URL;
+        this.delegate = new OpenAiGptClient_1.OpenAiGptClient({
+            type: 'OPENAI',
+            modelName: ollamaConfig.modelName,
+            apiKey: 'ollama',
+        }, this.apiUrl);
+    }
+    async ping(options) {
+        const signal = options?.signal ?? AbortSignal.timeout(10_000);
+        let resp;
+        try {
+            resp = await fetch(`${this.apiUrl}/api/tags`, { signal });
+        }
+        catch (error) {
+            if (error instanceof TypeError) {
+                Logger_1.appLogger.error('Failed to reach Ollama due to exception', error);
+                throw new GptPlatformNotReachableException_1.GptPlatformNotReachableException(this.config.type);
+            }
+            throw error;
+        }
+        if (!resp.ok) {
+            throw new GptPlatformNotReachableException_1.GptPlatformNotReachableException(this.config.type);
+        }
+        const data = (await resp.json());
+        const models = data.models ?? [];
+        const modelName = this.config.modelName;
+        const found = models.some((m) => {
+            const name = m.name ?? '';
+            return name === modelName || name === `${modelName}:latest`;
+        });
+        if (!found) {
+            throw new GptModelNotFoundException_1.GptModelNotFoundException(this.config.type, modelName);
+        }
+    }
+    async getMessage(messages, options) {
+        return this.delegate.getMessage(messages, options);
+    }
+    async getStructuredOutput(messages, zodSchema, options) {
+        const resp = await this.getToolCalls(messages, [
+            {
+                name: 'output',
+                description: 'The schema of the expected response structure.',
+                inputSchema: zodSchema,
+            },
+        ], options);
+        const toolCall = resp.proposedToolCalls.at(0);
+        return {
+            completionTokensUsed: resp.completionTokensUsed,
+            promptTokensUsed: resp.promptTokensUsed,
+            type: 'structured_output',
+            output: (0, GptClient_1.parseOrLogAndThrow)(toolCall?.parameters, zodSchema),
+        };
+    }
+    async getToolCalls(messages, tools, options) {
+        return this.delegate.getToolCalls(messages, tools, options);
+    }
+}
+exports.OllamaGptClient = OllamaGptClient;
+OllamaGptClient.DEFAULT_API_URL = 'http://localhost:11434';
+//# sourceMappingURL=OllamaGptClient.js.map

package/dist/codegen/runGenerateSiteTests.js

@@ -769,7 +769,7 @@ async function runGenerateSiteTests(opts, onProgress, shouldCancel) {
     }
     const storageState = await loadStorageState(storageStatePath);
     assertNotCancelled('loading storage state');
-    const donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(snapshotEnv()), 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_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'GOOGLE_CLOUD_STORAGE_BUCKET', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
+    const donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(snapshotEnv()), 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_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'GOOGLE_CLOUD_STORAGE_BUCKET', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
     await ensureGptAvailability(donobuStack, gptConfigName);
     assertNotCancelled('ensuring GPT availability');
     const allowedTools = buildAllowedTools(toolAllowlist, toolDenylist);

package/dist/envVars.d.ts

@@ -41,6 +41,8 @@ export declare const env: Env<{
     }>>;
     GOOGLE_GENERATIVE_AI_API_KEY: z.ZodOptional<z.ZodString>;
     GOOGLE_GENERATIVE_AI_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    OLLAMA_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    OLLAMA_API_URL: z.ZodOptional<z.ZodString>;
     OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
     OPENAI_API_MODEL_NAME: z.ZodOptional<z.ZodString>;
     PERSISTENCE_PRIORITY: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -79,6 +81,8 @@ export declare const env: Env<{
     DONOBU_PAGE_AI_CLEAR_CACHE?: "0" | "1" | "true" | "false" | undefined;
     GOOGLE_GENERATIVE_AI_API_KEY?: string | undefined;
     GOOGLE_GENERATIVE_AI_MODEL_NAME?: string | undefined;
+    OLLAMA_MODEL_NAME?: string | undefined;
+    OLLAMA_API_URL?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     OPENAI_API_MODEL_NAME?: string | undefined;
     AWS_S3_BUCKET?: string | undefined;

package/dist/envVars.js

@@ -73,6 +73,13 @@ underlying models they map to (ex: "gemini-2.0-flash", etc).`),
     GOOGLE_GENERATIVE_AI_MODEL_NAME: v4_1.z.string().optional()
         .describe(`If specified, this will shade the default flow runner agent when running
 flows. If specified, GOOGLE_GENERATIVE_AI_API_KEY must also be specified.`),
+    OLLAMA_MODEL_NAME: v4_1.z.string().optional()
+        .describe(`If specified, automatically create a GPT configuration for Ollama using
+this model name (e.g. "llama3.2", "qwen2.5"). Ollama must be running
+locally or at the URL specified by OLLAMA_API_URL.`),
+    OLLAMA_API_URL: v4_1.z.string().optional()
+        .describe(`The base URL for the Ollama API. Defaults to http://localhost:11434 if
+not specified. Only used when OLLAMA_MODEL_NAME is also set.`),
     OPENAI_API_KEY: v4_1.z.string().optional()
         .describe(`Automatically create GPT configurations for OpenAI using this API key.
 For convenience, the created configuration names will reflect the

package/dist/esm/clients/GptClientFactory.js

@@ -7,6 +7,7 @@ const AnthropicGptClient_1 = require("./AnthropicGptClient");
 const DonobuGptClient_1 = require("./DonobuGptClient");
 const GoogleGenerativeAiGptClient_1 = require("./GoogleGenerativeAiGptClient");
 const GptClientPlugin_1 = require("./GptClientPlugin");
+const OllamaGptClient_1 = require("./OllamaGptClient");
 const OpenAiGptClient_1 = require("./OpenAiGptClient");
 /**
  * Default implementation of GptClientFactory that creates GPT clients
@@ -51,6 +52,8 @@ class GptClientFactoryImpl {
                 return new DonobuGptClient_1.DonobuGptClient(config);
             case 'GOOGLE_GEMINI':
                 return new GoogleGenerativeAiGptClient_1.GoogleGenerativeAiGptClient(config);
+            case 'OLLAMA':
+                return new OllamaGptClient_1.OllamaGptClient(config);
             case 'OPENAI':
                 return new OpenAiGptClient_1.OpenAiGptClient(config);
             default:

package/dist/esm/clients/OllamaGptClient.d.ts

@@ -0,0 +1,29 @@
+import type { ZodType } from 'zod/v4';
+import type { OllamaConfig } from '../models/GptConfig';
+import type { AssistantMessage, GptMessage, ProposedToolCallsMessage, StructuredOutputMessage } from '../models/GptMessage';
+import type { ToolOption } from './GptClient';
+import { GptClient } from './GptClient';
+/**
+ * A GPT client for Ollama, a local LLM runner that exposes an OpenAI-compatible API.
+ * Delegates to {@link OpenAiGptClient} for request handling, with Ollama-specific
+ * overrides for ping and structured output.
+ */
+export declare class OllamaGptClient extends GptClient {
+    private static readonly DEFAULT_API_URL;
+    private readonly delegate;
+    private readonly apiUrl;
+    constructor(ollamaConfig: OllamaConfig);
+    ping(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getMessage(messages: GptMessage[], options?: {
+        signal?: AbortSignal;
+    }): Promise<AssistantMessage>;
+    getStructuredOutput<T>(messages: GptMessage[], zodSchema: ZodType<T>, options?: {
+        signal?: AbortSignal;
+    }): Promise<StructuredOutputMessage<T>>;
+    getToolCalls(messages: GptMessage[], tools: ToolOption[], options?: {
+        signal?: AbortSignal;
+    }): Promise<ProposedToolCallsMessage>;
+}
+//# sourceMappingURL=OllamaGptClient.d.ts.map

package/dist/esm/clients/OllamaGptClient.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaGptClient = void 0;
+const GptModelNotFoundException_1 = require("../exceptions/GptModelNotFoundException");
+const GptPlatformNotReachableException_1 = require("../exceptions/GptPlatformNotReachableException");
+const Logger_1 = require("../utils/Logger");
+const GptClient_1 = require("./GptClient");
+const OpenAiGptClient_1 = require("./OpenAiGptClient");
+/**
+ * A GPT client for Ollama, a local LLM runner that exposes an OpenAI-compatible API.
+ * Delegates to {@link OpenAiGptClient} for request handling, with Ollama-specific
+ * overrides for ping and structured output.
+ */
+class OllamaGptClient extends GptClient_1.GptClient {
+    constructor(ollamaConfig) {
+        super(ollamaConfig);
+        this.apiUrl = ollamaConfig.apiUrl ?? OllamaGptClient.DEFAULT_API_URL;
+        this.delegate = new OpenAiGptClient_1.OpenAiGptClient({
+            type: 'OPENAI',
+            modelName: ollamaConfig.modelName,
+            apiKey: 'ollama',
+        }, this.apiUrl);
+    }
+    async ping(options) {
+        const signal = options?.signal ?? AbortSignal.timeout(10_000);
+        let resp;
+        try {
+            resp = await fetch(`${this.apiUrl}/api/tags`, { signal });
+        }
+        catch (error) {
+            if (error instanceof TypeError) {
+                Logger_1.appLogger.error('Failed to reach Ollama due to exception', error);
+                throw new GptPlatformNotReachableException_1.GptPlatformNotReachableException(this.config.type);
+            }
+            throw error;
+        }
+        if (!resp.ok) {
+            throw new GptPlatformNotReachableException_1.GptPlatformNotReachableException(this.config.type);
+        }
+        const data = (await resp.json());
+        const models = data.models ?? [];
+        const modelName = this.config.modelName;
+        const found = models.some((m) => {
+            const name = m.name ?? '';
+            return name === modelName || name === `${modelName}:latest`;
+        });
+        if (!found) {
+            throw new GptModelNotFoundException_1.GptModelNotFoundException(this.config.type, modelName);
+        }
+    }
+    async getMessage(messages, options) {
+        return this.delegate.getMessage(messages, options);
+    }
+    async getStructuredOutput(messages, zodSchema, options) {
+        const resp = await this.getToolCalls(messages, [
+            {
+                name: 'output',
+                description: 'The schema of the expected response structure.',
+                inputSchema: zodSchema,
+            },
+        ], options);
+        const toolCall = resp.proposedToolCalls.at(0);
+        return {
+            completionTokensUsed: resp.completionTokensUsed,
+            promptTokensUsed: resp.promptTokensUsed,
+            type: 'structured_output',
+            output: (0, GptClient_1.parseOrLogAndThrow)(toolCall?.parameters, zodSchema),
+        };
+    }
+    async getToolCalls(messages, tools, options) {
+        return this.delegate.getToolCalls(messages, tools, options);
+    }
+}
+exports.OllamaGptClient = OllamaGptClient;
+OllamaGptClient.DEFAULT_API_URL = 'http://localhost:11434';
+//# sourceMappingURL=OllamaGptClient.js.map

package/dist/esm/codegen/runGenerateSiteTests.js

@@ -769,7 +769,7 @@ async function runGenerateSiteTests(opts, onProgress, shouldCancel) {
     }
     const storageState = await loadStorageState(storageStatePath);
     assertNotCancelled('loading storage state');
-    const donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(snapshotEnv()), 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_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'GOOGLE_CLOUD_STORAGE_BUCKET', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
+    const donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(snapshotEnv()), 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_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'GOOGLE_CLOUD_STORAGE_BUCKET', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
     await ensureGptAvailability(donobuStack, gptConfigName);
     assertNotCancelled('ensuring GPT availability');
     const allowedTools = buildAllowedTools(toolAllowlist, toolDenylist);

package/dist/esm/envVars.d.ts

@@ -41,6 +41,8 @@ export declare const env: Env<{
     }>>;
     GOOGLE_GENERATIVE_AI_API_KEY: z.ZodOptional<z.ZodString>;
     GOOGLE_GENERATIVE_AI_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    OLLAMA_MODEL_NAME: z.ZodOptional<z.ZodString>;
+    OLLAMA_API_URL: z.ZodOptional<z.ZodString>;
     OPENAI_API_KEY: z.ZodOptional<z.ZodString>;
     OPENAI_API_MODEL_NAME: z.ZodOptional<z.ZodString>;
     PERSISTENCE_PRIORITY: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -79,6 +81,8 @@ export declare const env: Env<{
     DONOBU_PAGE_AI_CLEAR_CACHE?: "0" | "1" | "true" | "false" | undefined;
     GOOGLE_GENERATIVE_AI_API_KEY?: string | undefined;
     GOOGLE_GENERATIVE_AI_MODEL_NAME?: string | undefined;
+    OLLAMA_MODEL_NAME?: string | undefined;
+    OLLAMA_API_URL?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     OPENAI_API_MODEL_NAME?: string | undefined;
     AWS_S3_BUCKET?: string | undefined;

package/dist/esm/envVars.js

@@ -73,6 +73,13 @@ underlying models they map to (ex: "gemini-2.0-flash", etc).`),
     GOOGLE_GENERATIVE_AI_MODEL_NAME: v4_1.z.string().optional()
         .describe(`If specified, this will shade the default flow runner agent when running
 flows. If specified, GOOGLE_GENERATIVE_AI_API_KEY must also be specified.`),
+    OLLAMA_MODEL_NAME: v4_1.z.string().optional()
+        .describe(`If specified, automatically create a GPT configuration for Ollama using
+this model name (e.g. "llama3.2", "qwen2.5"). Ollama must be running
+locally or at the URL specified by OLLAMA_API_URL.`),
+    OLLAMA_API_URL: v4_1.z.string().optional()
+        .describe(`The base URL for the Ollama API. Defaults to http://localhost:11434 if
+not specified. Only used when OLLAMA_MODEL_NAME is also set.`),
     OPENAI_API_KEY: v4_1.z.string().optional()
         .describe(`Automatically create GPT configurations for OpenAI using this API key.
 For convenience, the created configuration names will reflect the

package/dist/esm/lib/test/fixtures/gptClients.d.ts

@@ -8,6 +8,7 @@ export declare function donobuGptClientFixture(apiKey?: string | undefined): Tes
 export declare function anthropicClientFixture(modelName: string, apiKey?: string | undefined): TestFixture<GptClient, any>;
 export declare function anthropicAwsBedrockClientFixture(modelName: string, region?: string | undefined, accessKeyId?: string | undefined, secretAccessKey?: string | undefined): TestFixture<GptClient, any>;
 export declare function googleGeminiClientFixture(modelName: string, apiKey?: string | undefined): TestFixture<GptClient, any>;
+export declare function ollamaClientFixture(modelName: string, apiUrl?: string): TestFixture<GptClient, any>;
 export declare function openAiClientFixture(modelName: string, apiKey?: string | undefined): TestFixture<GptClient, any>;
 export declare function vercelAiClientFixture(model: Exclude<LanguageModel, string>): TestFixture<GptClient, any>;
 export declare function gptClientFixture(): TestFixture<GptClient, any>;

package/dist/esm/lib/test/fixtures/gptClients.js

@@ -6,6 +6,7 @@ exports.donobuGptClientFixture = donobuGptClientFixture;
 exports.anthropicClientFixture = anthropicClientFixture;
 exports.anthropicAwsBedrockClientFixture = anthropicAwsBedrockClientFixture;
 exports.googleGeminiClientFixture = googleGeminiClientFixture;
+exports.ollamaClientFixture = ollamaClientFixture;
 exports.openAiClientFixture = openAiClientFixture;
 exports.vercelAiClientFixture = vercelAiClientFixture;
 exports.gptClientFixture = gptClientFixture;
@@ -87,6 +88,16 @@ Please provide one as an argument or set it using the ${envVars_1.env.keys.GOOGL
         await use(client);
     };
 }
+function ollamaClientFixture(modelName, apiUrl) {
+    return async ({}, use) => {
+        const client = await createClient({
+            type: 'OLLAMA',
+            modelName,
+            ...(apiUrl ? { apiUrl } : {}),
+        });
+        await use(client);
+    };
+}
 function openAiClientFixture(modelName, apiKey = envVars_1.env.data.OPENAI_API_KEY) {
     if (!apiKey) {
         throw new Error(`An API key is required to use the OpenAI API.

package/dist/esm/lib/test/testExtension.js

@@ -82,6 +82,7 @@ exports.test = test_1.test.extend({
     ],
     // Override the default page fixture
     page: async ({ page, gptClient, headless, flowLoggingContext }, use, testInfo) => {
+        Logger_1.appLogger.info(`Test started: "${testInfo.title}"`);
         const overallObjective = testInfo.annotations.find((v) => v.type === 'objective')?.description ??
             null;
         const visualCueDurationMs = v4_1.z
@@ -338,6 +339,7 @@ async function finalizeTest(page, testInfo, logBuffer) {
             Logger_1.appLogger.error('tbd: failed to flush replacements', error);
         }
     }
+    Logger_1.appLogger.info(`Test ended: "${testInfo.title}" — status: ${testInfo.status}`);
 }
 /**
  * A "v1" test is one that was generated by the Donobu app and

package/dist/esm/lib/test/utils/donobuTestStack.js

@@ -20,7 +20,7 @@ function getEnvSnapshot() {
 }
 async function getOrCreateDonobuStack() {
     if (!donobuStack) {
-        donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(getEnvSnapshot()), envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
+        donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(getEnvSnapshot()), envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
         return donobuStack;
     }
     else {

package/dist/esm/managers/AdminApiController.d.ts

@@ -59,7 +59,7 @@ export declare class AdminApiController {
      * - no checking for flow ownership is performed, as all flows are considered owned by the
      *   local environment.
      */
-    static create(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME' | 'PERSISTENCE_PRIORITY'>): Promise<AdminApiController>;
+    static create(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME' | 'PERSISTENCE_PRIORITY'>): Promise<AdminApiController>;
     private constructor();
     /**
      * Serves the API and web assets; this blocks until stop() is called.

package/dist/esm/managers/DonobuFlowsManager.d.ts

@@ -48,7 +48,7 @@ export declare class DonobuFlowsManager {
     static readonly FLOW_NAME_MAX_LENGTH = 255;
     private readonly flowRuntime;
     private readonly flowCatalog;
-    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | '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' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry);
+    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | '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' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry);
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.
@@ -132,7 +132,8 @@ export declare class DonobuFlowsManager {
      * Resolves a GPT client using the provided GPT configuration name, falling back
      * to environment-provided configs (BASE64_GPT_CONFIG, DONOBU_API_KEY,
      * AWS_BEDROCK_MODEL_NAME, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY,
-     * OPENAI_API_KEY) and finally the config bound to the 'flow-runner' agent.
+     * OPENAI_API_KEY, OLLAMA_MODEL_NAME) and finally the config bound to the
+     * 'flow-runner' agent.
      * Returns a null client if no configuration source is available.
      *
      * Public for testing only.

package/dist/esm/managers/DonobuFlowsManager.js

@@ -479,7 +479,8 @@ class DonobuFlowsManager {
      * Resolves a GPT client using the provided GPT configuration name, falling back
      * to environment-provided configs (BASE64_GPT_CONFIG, DONOBU_API_KEY,
      * AWS_BEDROCK_MODEL_NAME, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY,
-     * OPENAI_API_KEY) and finally the config bound to the 'flow-runner' agent.
+     * OPENAI_API_KEY, OLLAMA_MODEL_NAME) and finally the config bound to the
+     * 'flow-runner' agent.
      * Returns a null client if no configuration source is available.
      *
      * Public for testing only.
@@ -551,6 +552,15 @@ class DonobuFlowsManager {
                 apiKey: this.environ.data.OPENAI_API_KEY,
             };
         }
+        else if (this.environ.data.OLLAMA_MODEL_NAME) {
+            gptConfigFromEnv = {
+                type: 'OLLAMA',
+                modelName: this.environ.data.OLLAMA_MODEL_NAME,
+                ...(this.environ.data.OLLAMA_API_URL
+                    ? { apiUrl: this.environ.data.OLLAMA_API_URL }
+                    : {}),
+            };
+        }
         if (gptConfigFromEnv) {
             const gptClient = await this.gptClientFactory.createClient(gptConfigFromEnv);
             return {

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

@@ -43,6 +43,8 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     ANTHROPIC_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     GOOGLE_GENERATIVE_AI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    OLLAMA_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    OLLAMA_API_URL: 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>;
     PERSISTENCE_PRIORITY: import("zod/v4").ZodDefault<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
@@ -59,6 +61,8 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     ANTHROPIC_MODEL_NAME?: string | undefined;
     GOOGLE_GENERATIVE_AI_API_KEY?: string | undefined;
     GOOGLE_GENERATIVE_AI_MODEL_NAME?: string | undefined;
+    OLLAMA_MODEL_NAME?: string | undefined;
+    OLLAMA_API_URL?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     OPENAI_API_MODEL_NAME?: string | undefined;
     PERSISTENCE_PRIORITY: string[];

package/dist/esm/managers/DonobuStack.js

@@ -29,7 +29,7 @@ const ToolRegistry_1 = require("./ToolRegistry");
  *       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_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY')) {
+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_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY')) {
     const loadedPlugins = await loadDefaultPlugins();
     const resolvedToolRegistry = await (0, ToolRegistry_1.createDefaultToolRegistry)(loadedPlugins.tools);
     const persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry(loadedPlugins.persistencePlugins);

package/dist/esm/models/GptConfig.d.ts

@@ -16,6 +16,12 @@ export declare const GoogleGenerativeAiConfigSchema: z.ZodObject<{
     modelName: z.ZodString;
 }, z.core.$strip>;
 export type GoogleGenerativeAiConfig = z.infer<typeof GoogleGenerativeAiConfigSchema>;
+export declare const OllamaConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"OLLAMA">;
+    modelName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type OllamaConfig = z.infer<typeof OllamaConfigSchema>;
 export declare const OpenAiConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"OPENAI">;
     apiKey: z.ZodString;
@@ -45,6 +51,10 @@ export declare const GptConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"GOOGLE_GEMINI">;
     apiKey: z.ZodString;
     modelName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"OLLAMA">;
+    modelName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"OPENAI">;
     apiKey: z.ZodString;
@@ -71,6 +81,10 @@ export declare const GptConfigInputSchema: z.ZodUnion<readonly [z.ZodDiscriminat
     type: z.ZodLiteral<"GOOGLE_GEMINI">;
     apiKey: z.ZodString;
     modelName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"OLLAMA">;
+    modelName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"OPENAI">;
     apiKey: z.ZodString;

package/dist/esm/models/GptConfig.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GptConfigInputSchema = exports.GptConfigSchema = exports.VercelAiConfigSchema = exports.OpenAiConfigSchema = exports.GoogleGenerativeAiConfigSchema = exports.DonobuGptClientConfigSchema = exports.AnthropicConfigSchema = void 0;
+exports.GptConfigInputSchema = exports.GptConfigSchema = exports.VercelAiConfigSchema = exports.OpenAiConfigSchema = exports.OllamaConfigSchema = exports.GoogleGenerativeAiConfigSchema = exports.DonobuGptClientConfigSchema = exports.AnthropicConfigSchema = void 0;
 const v4_1 = require("zod/v4");
 exports.AnthropicConfigSchema = v4_1.z.object({
     type: v4_1.z.literal('ANTHROPIC'),
@@ -16,6 +16,11 @@ exports.GoogleGenerativeAiConfigSchema = v4_1.z.object({
     apiKey: v4_1.z.string(),
     modelName: v4_1.z.string(),
 });
+exports.OllamaConfigSchema = v4_1.z.object({
+    type: v4_1.z.literal('OLLAMA'),
+    modelName: v4_1.z.string(),
+    apiUrl: v4_1.z.string().optional(),
+});
 exports.OpenAiConfigSchema = v4_1.z.object({
     type: v4_1.z.literal('OPENAI'),
     apiKey: v4_1.z.string(),
@@ -36,6 +41,7 @@ exports.GptConfigSchema = v4_1.z.discriminatedUnion('type', [
     exports.AnthropicConfigSchema,
     exports.DonobuGptClientConfigSchema,
     exports.GoogleGenerativeAiConfigSchema,
+    exports.OllamaConfigSchema,
     exports.OpenAiConfigSchema,
     exports.VercelAiConfigSchema,
 ]);

package/dist/lib/test/fixtures/gptClients.d.ts

@@ -8,6 +8,7 @@ export declare function donobuGptClientFixture(apiKey?: string | undefined): Tes
 export declare function anthropicClientFixture(modelName: string, apiKey?: string | undefined): TestFixture<GptClient, any>;
 export declare function anthropicAwsBedrockClientFixture(modelName: string, region?: string | undefined, accessKeyId?: string | undefined, secretAccessKey?: string | undefined): TestFixture<GptClient, any>;
 export declare function googleGeminiClientFixture(modelName: string, apiKey?: string | undefined): TestFixture<GptClient, any>;
+export declare function ollamaClientFixture(modelName: string, apiUrl?: string): TestFixture<GptClient, any>;
 export declare function openAiClientFixture(modelName: string, apiKey?: string | undefined): TestFixture<GptClient, any>;
 export declare function vercelAiClientFixture(model: Exclude<LanguageModel, string>): TestFixture<GptClient, any>;
 export declare function gptClientFixture(): TestFixture<GptClient, any>;

package/dist/lib/test/fixtures/gptClients.js

@@ -6,6 +6,7 @@ exports.donobuGptClientFixture = donobuGptClientFixture;
 exports.anthropicClientFixture = anthropicClientFixture;
 exports.anthropicAwsBedrockClientFixture = anthropicAwsBedrockClientFixture;
 exports.googleGeminiClientFixture = googleGeminiClientFixture;
+exports.ollamaClientFixture = ollamaClientFixture;
 exports.openAiClientFixture = openAiClientFixture;
 exports.vercelAiClientFixture = vercelAiClientFixture;
 exports.gptClientFixture = gptClientFixture;
@@ -87,6 +88,16 @@ Please provide one as an argument or set it using the ${envVars_1.env.keys.GOOGL
         await use(client);
     };
 }
+function ollamaClientFixture(modelName, apiUrl) {
+    return async ({}, use) => {
+        const client = await createClient({
+            type: 'OLLAMA',
+            modelName,
+            ...(apiUrl ? { apiUrl } : {}),
+        });
+        await use(client);
+    };
+}
 function openAiClientFixture(modelName, apiKey = envVars_1.env.data.OPENAI_API_KEY) {
     if (!apiKey) {
         throw new Error(`An API key is required to use the OpenAI API.

package/dist/lib/test/testExtension.js

@@ -82,6 +82,7 @@ exports.test = test_1.test.extend({
     ],
     // Override the default page fixture
     page: async ({ page, gptClient, headless, flowLoggingContext }, use, testInfo) => {
+        Logger_1.appLogger.info(`Test started: "${testInfo.title}"`);
         const overallObjective = testInfo.annotations.find((v) => v.type === 'objective')?.description ??
             null;
         const visualCueDurationMs = v4_1.z
@@ -338,6 +339,7 @@ async function finalizeTest(page, testInfo, logBuffer) {
             Logger_1.appLogger.error('tbd: failed to flush replacements', error);
         }
     }
+    Logger_1.appLogger.info(`Test ended: "${testInfo.title}" — status: ${testInfo.status}`);
 }
 /**
  * A "v1" test is one that was generated by the Donobu app and

package/dist/lib/test/utils/donobuTestStack.js

@@ -20,7 +20,7 @@ function getEnvSnapshot() {
 }
 async function getOrCreateDonobuStack() {
     if (!donobuStack) {
-        donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(getEnvSnapshot()), envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
+        donobuStack = await (0, DonobuStack_1.setupDonobuStack)('LOCAL', ControlPanel_1.NoOpControlPanelFactory, new EnvPersistenceVolatile_1.EnvPersistenceVolatile(getEnvSnapshot()), envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY'));
         return donobuStack;
     }
     else {

package/dist/managers/AdminApiController.d.ts

@@ -59,7 +59,7 @@ export declare class AdminApiController {
      * - no checking for flow ownership is performed, as all flows are considered owned by the
      *   local environment.
      */
-    static create(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME' | 'PERSISTENCE_PRIORITY'>): Promise<AdminApiController>;
+    static create(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME' | 'PERSISTENCE_PRIORITY'>): Promise<AdminApiController>;
     private constructor();
     /**
      * Serves the API and web assets; this blocks until stop() is called.

package/dist/managers/DonobuFlowsManager.d.ts

@@ -48,7 +48,7 @@ export declare class DonobuFlowsManager {
     static readonly FLOW_NAME_MAX_LENGTH = 255;
     private readonly flowRuntime;
     private readonly flowCatalog;
-    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | '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' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry);
+    constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | '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' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry);
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.
@@ -132,7 +132,8 @@ export declare class DonobuFlowsManager {
      * Resolves a GPT client using the provided GPT configuration name, falling back
      * to environment-provided configs (BASE64_GPT_CONFIG, DONOBU_API_KEY,
      * AWS_BEDROCK_MODEL_NAME, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY,
-     * OPENAI_API_KEY) and finally the config bound to the 'flow-runner' agent.
+     * OPENAI_API_KEY, OLLAMA_MODEL_NAME) and finally the config bound to the
+     * 'flow-runner' agent.
      * Returns a null client if no configuration source is available.
      *
      * Public for testing only.

package/dist/managers/DonobuFlowsManager.js

@@ -479,7 +479,8 @@ class DonobuFlowsManager {
      * Resolves a GPT client using the provided GPT configuration name, falling back
      * to environment-provided configs (BASE64_GPT_CONFIG, DONOBU_API_KEY,
      * AWS_BEDROCK_MODEL_NAME, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY,
-     * OPENAI_API_KEY) and finally the config bound to the 'flow-runner' agent.
+     * OPENAI_API_KEY, OLLAMA_MODEL_NAME) and finally the config bound to the
+     * 'flow-runner' agent.
      * Returns a null client if no configuration source is available.
      *
      * Public for testing only.
@@ -551,6 +552,15 @@ class DonobuFlowsManager {
                 apiKey: this.environ.data.OPENAI_API_KEY,
             };
         }
+        else if (this.environ.data.OLLAMA_MODEL_NAME) {
+            gptConfigFromEnv = {
+                type: 'OLLAMA',
+                modelName: this.environ.data.OLLAMA_MODEL_NAME,
+                ...(this.environ.data.OLLAMA_API_URL
+                    ? { apiUrl: this.environ.data.OLLAMA_API_URL }
+                    : {}),
+            };
+        }
         if (gptConfigFromEnv) {
             const gptClient = await this.gptClientFactory.createClient(gptConfigFromEnv);
             return {

package/dist/managers/DonobuStack.d.ts

@@ -43,6 +43,8 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     ANTHROPIC_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     GOOGLE_GENERATIVE_AI_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     GOOGLE_GENERATIVE_AI_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    OLLAMA_MODEL_NAME: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    OLLAMA_API_URL: 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>;
     PERSISTENCE_PRIORITY: import("zod/v4").ZodDefault<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
@@ -59,6 +61,8 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     ANTHROPIC_MODEL_NAME?: string | undefined;
     GOOGLE_GENERATIVE_AI_API_KEY?: string | undefined;
     GOOGLE_GENERATIVE_AI_MODEL_NAME?: string | undefined;
+    OLLAMA_MODEL_NAME?: string | undefined;
+    OLLAMA_API_URL?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     OPENAI_API_MODEL_NAME?: string | undefined;
     PERSISTENCE_PRIORITY: string[];

package/dist/managers/DonobuStack.js

@@ -29,7 +29,7 @@ const ToolRegistry_1 = require("./ToolRegistry");
  *       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_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY')) {
+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_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY')) {
     const loadedPlugins = await loadDefaultPlugins();
     const resolvedToolRegistry = await (0, ToolRegistry_1.createDefaultToolRegistry)(loadedPlugins.tools);
     const persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry(loadedPlugins.persistencePlugins);

package/dist/models/GptConfig.d.ts

@@ -16,6 +16,12 @@ export declare const GoogleGenerativeAiConfigSchema: z.ZodObject<{
     modelName: z.ZodString;
 }, z.core.$strip>;
 export type GoogleGenerativeAiConfig = z.infer<typeof GoogleGenerativeAiConfigSchema>;
+export declare const OllamaConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"OLLAMA">;
+    modelName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type OllamaConfig = z.infer<typeof OllamaConfigSchema>;
 export declare const OpenAiConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"OPENAI">;
     apiKey: z.ZodString;
@@ -45,6 +51,10 @@ export declare const GptConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"GOOGLE_GEMINI">;
     apiKey: z.ZodString;
     modelName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"OLLAMA">;
+    modelName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"OPENAI">;
     apiKey: z.ZodString;
@@ -71,6 +81,10 @@ export declare const GptConfigInputSchema: z.ZodUnion<readonly [z.ZodDiscriminat
     type: z.ZodLiteral<"GOOGLE_GEMINI">;
     apiKey: z.ZodString;
     modelName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"OLLAMA">;
+    modelName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"OPENAI">;
     apiKey: z.ZodString;

package/dist/models/GptConfig.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GptConfigInputSchema = exports.GptConfigSchema = exports.VercelAiConfigSchema = exports.OpenAiConfigSchema = exports.GoogleGenerativeAiConfigSchema = exports.DonobuGptClientConfigSchema = exports.AnthropicConfigSchema = void 0;
+exports.GptConfigInputSchema = exports.GptConfigSchema = exports.VercelAiConfigSchema = exports.OpenAiConfigSchema = exports.OllamaConfigSchema = exports.GoogleGenerativeAiConfigSchema = exports.DonobuGptClientConfigSchema = exports.AnthropicConfigSchema = void 0;
 const v4_1 = require("zod/v4");
 exports.AnthropicConfigSchema = v4_1.z.object({
     type: v4_1.z.literal('ANTHROPIC'),
@@ -16,6 +16,11 @@ exports.GoogleGenerativeAiConfigSchema = v4_1.z.object({
     apiKey: v4_1.z.string(),
     modelName: v4_1.z.string(),
 });
+exports.OllamaConfigSchema = v4_1.z.object({
+    type: v4_1.z.literal('OLLAMA'),
+    modelName: v4_1.z.string(),
+    apiUrl: v4_1.z.string().optional(),
+});
 exports.OpenAiConfigSchema = v4_1.z.object({
     type: v4_1.z.literal('OPENAI'),
     apiKey: v4_1.z.string(),
@@ -36,6 +41,7 @@ exports.GptConfigSchema = v4_1.z.discriminatedUnion('type', [
     exports.AnthropicConfigSchema,
     exports.DonobuGptClientConfigSchema,
     exports.GoogleGenerativeAiConfigSchema,
+    exports.OllamaConfigSchema,
     exports.OpenAiConfigSchema,
     exports.VercelAiConfigSchema,
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "donobu",
-  "version": "5.18.3",
+  "version": "5.20.0",
   "description": "Create browser automations with an LLM agent and replay them as Playwright scripts.",
   "main": "dist/main.js",
   "module": "dist/esm/main.js",