donobu 2.46.1 → 2.46.4

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

@@ -19,12 +19,6 @@ const donobuTestStack_1 = require("../utils/donobuTestStack");
 const GptConfig_1 = require("../../models/GptConfig");
 const InvalidParamValueException_1 = require("../../exceptions/InvalidParamValueException");
 const GptApiKeysNotSetupException_1 = require("../../exceptions/GptApiKeysNotSetupException");
-const DEFAULT_GPT_MODEL_FOR_PLATFORM = {
-    ANTHROPIC: envVars_1.ENV.ANTHROPIC_MODEL_NAME || 'claude-3-5-sonnet-latest',
-    ANTHROPIC_AWS_BEDROCK: envVars_1.ENV.AWS_BEDROCK_MODEL_NAME || undefined,
-    GOOGLE_GEMINI: envVars_1.ENV.GOOGLE_GENERATIVE_AI_MODEL_NAME || 'gemini-2.5-flash',
-    OPENAI: envVars_1.ENV.OPENAI_API_MODEL_NAME || 'gpt-4o',
-};
 let defaultGptClient = undefined;
 async function getOrCreateDefaultGptClient() {
     if (!defaultGptClient) {
@@ -59,20 +53,26 @@ async function getOrCreateDefaultGptClient() {
  * If the modelName is not specified, it will be defaulted according to the
  * DEFAULT_GPT_MODEL_FOR_PLATFORM mapping.
  */
-async function createGptClient(modelName) {
-    const hasBase64Config = !!envVars_1.ENV.BASE64_GPT_CONFIG;
+async function createGptClient(modelName, environ = envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_REGION', 'AWS_SECRET_ACCESS_KEY', 'AWS_S3_BUCKET', 'AWS_S3_REGION', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DEFAULT_FLOW_RUNNER_GPT_CONFIG_NAME', '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 defaults = {
+        ANTHROPIC: environ.data.ANTHROPIC_MODEL_NAME || 'claude-3-5-sonnet-latest',
+        ANTHROPIC_AWS_BEDROCK: environ.data.AWS_BEDROCK_MODEL_NAME || undefined,
+        GOOGLE_GEMINI: environ.data.GOOGLE_GENERATIVE_AI_MODEL_NAME || 'gemini-2.5-flash',
+        OPENAI: environ.data.OPENAI_API_MODEL_NAME || 'gpt-4o',
+    };
+    const hasBase64Config = !!environ.data.BASE64_GPT_CONFIG;
     // Check which API keys are available
-    const hasAwsCredentials = !!DEFAULT_GPT_MODEL_FOR_PLATFORM.ANTHROPIC_AWS_BEDROCK &&
-        !!envVars_1.ENV.AWS_ACCESS_KEY_ID &&
-        !!envVars_1.ENV.AWS_SECRET_ACCESS_KEY;
-    const hasAnthropicKey = !!envVars_1.ENV.ANTHROPIC_API_KEY;
-    const hasGoogleKey = !!envVars_1.ENV.GOOGLE_GENERATIVE_AI_API_KEY;
-    const hasOpenAiKey = !!envVars_1.ENV.OPENAI_API_KEY;
+    const hasAwsCredentials = !!defaults.ANTHROPIC_AWS_BEDROCK &&
+        !!environ.data.AWS_ACCESS_KEY_ID &&
+        !!environ.data.AWS_SECRET_ACCESS_KEY;
+    const hasAnthropicKey = !!environ.data.ANTHROPIC_API_KEY;
+    const hasGoogleKey = !!environ.data.GOOGLE_GENERATIVE_AI_API_KEY;
+    const hasOpenAiKey = !!environ.data.OPENAI_API_KEY;
     // Priority order: Base64 Config, Anthropic AWS Bedrock, Anthropic, Google, OpenAI
     if (hasBase64Config) {
         let json;
         try {
-            const base64decoded = Buffer.from(envVars_1.ENV.BASE64_GPT_CONFIG, 'base64').toString('utf-8');
+            const base64decoded = Buffer.from(environ.data.BASE64_GPT_CONFIG, 'base64').toString('utf-8');
             json = JSON.parse(base64decoded);
         }
         catch {
@@ -81,26 +81,26 @@ async function createGptClient(modelName) {
         return new GptClientFactory_1.GptClientFactoryImpl().createClient(GptConfig_1.GptConfigSchema.parse(json));
     }
     else if (hasAwsCredentials) {
-        const model = modelName || DEFAULT_GPT_MODEL_FOR_PLATFORM.ANTHROPIC_AWS_BEDROCK;
-        const region = envVars_1.ENV.AWS_REGION;
-        const accessKeyId = envVars_1.ENV.AWS_ACCESS_KEY_ID;
-        const secretAccessKey = envVars_1.ENV.AWS_SECRET_ACCESS_KEY;
+        const model = modelName || defaults.ANTHROPIC_AWS_BEDROCK;
+        const region = environ.data.AWS_REGION;
+        const accessKeyId = environ.data.AWS_ACCESS_KEY_ID;
+        const secretAccessKey = environ.data.AWS_SECRET_ACCESS_KEY;
         return anthropicAwsBedrockClient(model, region, accessKeyId, secretAccessKey);
     }
     else if (hasAnthropicKey) {
-        const model = modelName || DEFAULT_GPT_MODEL_FOR_PLATFORM.ANTHROPIC;
+        const model = modelName || defaults.ANTHROPIC;
         return anthropicClient(model);
     }
     else if (hasGoogleKey) {
-        const model = modelName || DEFAULT_GPT_MODEL_FOR_PLATFORM.GOOGLE_GEMINI;
+        const model = modelName || defaults.GOOGLE_GEMINI;
         return googleGeminiClient(model);
     }
     else if (hasOpenAiKey) {
-        const model = modelName || DEFAULT_GPT_MODEL_FOR_PLATFORM.OPENAI;
+        const model = modelName || defaults.OPENAI;
         return openAiClient(model);
     }
     else {
-        const donobu = await (0, donobuTestStack_1.getOrCreateDonobuStack)();
+        const donobu = await (0, donobuTestStack_1.getOrCreateDonobuStack)(environ);
         const defaultClient = (await donobu.flowsManager.createGptClient(null))
             .gptClient;
         if (defaultClient) {
@@ -112,8 +112,8 @@ async function createGptClient(modelName) {
         }
     }
 }
-async function anthropicClient(modelName, apiKey) {
-    const divinedApiKey = apiKey || envVars_1.ENV.ANTHROPIC_API_KEY;
+async function anthropicClient(modelName, apiKey, environ = envVars_1.env.pick('ANTHROPIC_API_KEY')) {
+    const divinedApiKey = apiKey || environ.data.ANTHROPIC_API_KEY;
     if (!divinedApiKey) {
         throw new Error('An API key is required to use the Anthropic API. Please provide one as an argument or set it using the ANTHROPIC_API_KEY environment variable.');
     }
@@ -129,11 +129,12 @@ function anthropicClientFixture(modelName, apiKey) {
         await use(client);
     };
 }
-async function anthropicAwsBedrockClient(modelName, region, accessKeyId, secretAccessKey) {
-    const divinedAccessKeyId = accessKeyId || envVars_1.ENV.AWS_ACCESS_KEY_ID;
-    const divinedSecretAccessKey = secretAccessKey || envVars_1.ENV.AWS_SECRET_ACCESS_KEY;
+async function anthropicAwsBedrockClient(modelName, region, accessKeyId, secretAccessKey, environ = envVars_1.env.pick('AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY')) {
+    const divinedAccessKeyId = accessKeyId || environ.data.AWS_ACCESS_KEY_ID;
+    const divinedSecretAccessKey = secretAccessKey || environ.data.AWS_SECRET_ACCESS_KEY;
     if (!divinedAccessKeyId || !divinedSecretAccessKey) {
-        throw new Error('AWS access key ID and secret access key are required to use the Anthropic AWS Bedrock API. Please provide them as arguments or set them using the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.');
+        throw new Error(`AWS access key ID and secret access key are required to use the Anthropic AWS Bedrock API.
+Please provide them as arguments or set them using the ${environ.keys.AWS_ACCESS_KEY_ID} and ${environ.keys.AWS_SECRET_ACCESS_KEY} environment variables.`);
     }
     return new GptClientFactory_1.GptClientFactoryImpl().createClient({
         type: 'ANTHROPIC_AWS_BEDROCK',
@@ -149,10 +150,11 @@ function anthropicAwsBedrockClientFixture(modelName, region, accessKeyId, secret
         await use(client);
     };
 }
-async function googleGeminiClient(modelName, apiKey) {
-    const divinedApiKey = apiKey || envVars_1.ENV.GOOGLE_GENERATIVE_AI_API_KEY;
+async function googleGeminiClient(modelName, apiKey, environ = envVars_1.env.pick('GOOGLE_GENERATIVE_AI_API_KEY')) {
+    const divinedApiKey = apiKey || environ.data.GOOGLE_GENERATIVE_AI_API_KEY;
     if (!divinedApiKey) {
-        throw new Error('An API key is required to use the Google Gemini API. Please provide one as an argument or set it using the GOOGLE_GENERATIVE_AI_API_KEY environment variable.');
+        throw new Error(`An API key is required to use the Google Gemini API.
+Please provide one as an argument or set it using the ${environ.keys.GOOGLE_GENERATIVE_AI_API_KEY} environment variable.`);
     }
     return new GptClientFactory_1.GptClientFactoryImpl().createClient({
         type: 'GOOGLE_GEMINI',
@@ -166,10 +168,11 @@ function googleGeminiClientFixture(modelName, apiKey) {
         await use(client);
     };
 }
-async function openAiClient(modelName, apiKey) {
-    const divinedApiKey = apiKey || envVars_1.ENV.OPENAI_API_KEY;
+async function openAiClient(modelName, apiKey, environ = envVars_1.env.pick('OPENAI_API_KEY')) {
+    const divinedApiKey = apiKey || environ.data.OPENAI_API_KEY;
     if (!divinedApiKey) {
-        throw new Error('An API key is required to use the OpenAI API. Please provide one as an argument or set it using the OPENAI_API_KEY environment variable.');
+        throw new Error(`An API key is required to use the OpenAI API.
+Please provide one as an argument or set it using the ${environ.keys.OPENAI_API_KEY} environment variable.`);
     }
     return new GptClientFactory_1.GptClientFactoryImpl().createClient({
         type: 'OPENAI',

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

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

package/dist/esm/lib/originalGotoRegistry.d.ts

@@ -0,0 +1,5 @@
+import type { Page } from '@playwright/test';
+export declare function registerOriginalGoto(page: Page, originalGoto: Page['goto']): void;
+export declare function hasOriginalGoto(page: Page): boolean;
+export declare function getOriginalGoto(page: Page): Page['goto'];
+//# sourceMappingURL=originalGotoRegistry.d.ts.map

package/dist/esm/lib/originalGotoRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"originalGotoRegistry.d.ts","sourceRoot":"","sources":["../../../src/lib/originalGotoRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAc7C,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,GACzB,IAAI,CAEN;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEnD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAQxD"}

package/dist/esm/lib/originalGotoRegistry.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerOriginalGoto = registerOriginalGoto;
+exports.hasOriginalGoto = hasOriginalGoto;
+exports.getOriginalGoto = getOriginalGoto;
+/**
+ * Playwright creates a unique `goto` implementation for every page instance.
+ * Once Donobu decorates a page we override that method, so the original
+ * reference has to be stored somewhere page-specific. We can no longer stash
+ * it on `_dnb` because all decorated pages share the same `_dnb` object.
+ *
+ * This registry keeps the native implementation in a WeakMap keyed by page.
+ * Using a WeakMap ensures entries vanish automatically when a page is closed,
+ * preventing leaks while still letting us delegate back to the correct tab.
+ */
+const originalGotoRegistry = new WeakMap();
+function registerOriginalGoto(page, originalGoto) {
+    originalGotoRegistry.set(page, originalGoto);
+}
+function hasOriginalGoto(page) {
+    return originalGotoRegistry.has(page);
+}
+function getOriginalGoto(page) {
+    const originalGoto = originalGotoRegistry.get(page);
+    if (!originalGoto) {
+        throw new Error('Original goto not registered for the provided page.');
+    }
+    return originalGoto;
+}
+//# sourceMappingURL=originalGotoRegistry.js.map

package/dist/esm/lib/originalGotoRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"originalGotoRegistry.js","sourceRoot":"","sources":["../../../src/lib/originalGotoRegistry.ts"],"names":[],"mappings":";;AAcA,oDAKC;AAED,0CAEC;AAED,0CAQC;AA/BD;;;;;;;;;GASG;AACH,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAAsB,CAAC;AAE/D,SAAgB,oBAAoB,CAClC,IAAU,EACV,YAA0B;IAE1B,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,eAAe,CAAC,IAAU;IACxC,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,eAAe,CAAC,IAAU;IACxC,MAAM,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEpD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/esm/lib/pageAi/cache.d.ts

@@ -0,0 +1,84 @@
+import { ProposedToolCall } from '../../models/ProposedToolCall';
+/**
+ * Cache key used to identify a unique `page.ai` invocation. Keep this structure
+ * aligned with the code generator so replayed runs remain deterministic.
+ */
+export type PageAiCacheKey = {
+    pageUrl: string;
+    instruction: string | null;
+    schema: Record<string, unknown> | null;
+    allowedTools: string[];
+    maxToolCalls: number | null;
+};
+/**
+ * Full payload persisted in the cache. Contains both the identifying key and
+ * the tool calls required to replay an autonomous flow deterministically.
+ */
+export type PageAiCacheEntry = PageAiCacheKey & {
+    toolCallCache: ProposedToolCall[];
+};
+/**
+ * JSON structure stored on disk. We keep it deliberately simple so tooling
+ * (CodeGenerator, tests) can emit files without depending on application code.
+ */
+export type PageAiCacheContents = {
+    caches: PageAiCacheEntry[];
+};
+/**
+ * Minimal interface for cache clients. Implementations can be file-backed,
+ * in-memory (useful for tests), or even remote services.
+ */
+export interface PageAiCache {
+    get(key: PageAiCacheKey): Promise<ProposedToolCall[] | null>;
+    put(entry: PageAiCacheEntry): Promise<void>;
+    delete(key: PageAiCacheKey): Promise<boolean>;
+    snapshot(): Promise<PageAiCacheContents>;
+}
+/**
+ * File-backed implementation used by the Playwright fixture. Protects reads and
+ * writes with an OS-level lock so concurrent processes do not corrupt the file.
+ */
+export declare class FilePageAiCache implements PageAiCache {
+    private readonly cacheFilepath;
+    constructor(cacheFilepath: string);
+    get(key: PageAiCacheKey): Promise<ProposedToolCall[] | null>;
+    put(entry: PageAiCacheEntry): Promise<void>;
+    delete(key: PageAiCacheKey): Promise<boolean>;
+    /**
+     * Returns an in-memory snapshot of the cache content in the same shape used
+     * on disk. This is handy for code generation scenarios where we want to emit
+     * a `donobu.json` file without touching the real cache.
+     */
+    snapshot(): Promise<PageAiCacheContents>;
+    /**
+     * Lazily creates an empty cache file. Using the `'wx'` flag keeps the method
+     * idempotent even when multiple processes start simultaneously.
+     */
+    private ensureCacheFileExists;
+    /**
+     * Determines whether two cache descriptors refer to the same invocation.
+     * `JSON.stringify` comparisons are sufficient here because the structures are
+     * small and deterministic.
+     */
+    private matchesKey;
+    /**
+     * Performs a structural equality check for key fields that are collections.
+     */
+    private areEqual;
+    /**
+     * Reads and normalises the cache file, self-healing the structure when the
+     * JSON is missing expected fields.
+     */
+    private readCacheFile;
+    /**
+     * Writes the provided cache array back to disk using the canonical JSON
+     * structure.
+     */
+    private writeCacheFile;
+    /**
+     * Helper that serialises access to the cache file. The callback operates on
+     * the current in-memory cache and can optionally return a new array to persist.
+     */
+    private withCacheLock;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/esm/lib/pageAi/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/lib/pageAi/cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG;IAC9C,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7D,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC1C;AAOD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAW5D,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3C,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB1D;;;;OAIG;IACU,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqBrD;;;OAGG;YACW,qBAAqB;IAiBnC;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;YACW,aAAa;IA8B3B;;;OAGG;YACW,cAAc;IAQ5B;;;OAGG;YACW,aAAa;CA0B5B"}

package/dist/esm/lib/pageAi/cache.js

@@ -0,0 +1,207 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilePageAiCache = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const LockFile = __importStar(require("proper-lockfile"));
+/**
+ * File-backed implementation used by the Playwright fixture. Protects reads and
+ * writes with an OS-level lock so concurrent processes do not corrupt the file.
+ */
+class FilePageAiCache {
+    constructor(cacheFilepath) {
+        this.cacheFilepath = cacheFilepath;
+    }
+    async get(key) {
+        return this.withCacheLock(async (cache) => {
+            const matchingEntry = cache.find((entry) => this.matchesKey(entry, key));
+            return {
+                cache,
+                result: matchingEntry?.toolCallCache ?? null,
+            };
+        });
+    }
+    async put(entry) {
+        await this.withCacheLock(async (cache) => {
+            const existingIndex = cache.findIndex((candidate) => this.matchesKey(candidate, entry));
+            const modifiedCache = existingIndex === -1 ? [...cache, entry] : [...cache];
+            if (existingIndex !== -1) {
+                modifiedCache[existingIndex] = entry;
+            }
+            return {
+                cache: modifiedCache,
+                result: undefined,
+            };
+        });
+    }
+    async delete(key) {
+        return this.withCacheLock(async (cache) => {
+            const targetIndex = cache.findIndex((entry) => this.matchesKey(entry, key));
+            if (targetIndex === -1) {
+                return {
+                    cache,
+                    result: false,
+                };
+            }
+            const modifiedCache = [
+                ...cache.slice(0, targetIndex),
+                ...cache.slice(targetIndex + 1),
+            ];
+            return {
+                cache: modifiedCache,
+                result: true,
+            };
+        });
+    }
+    /**
+     * Returns an in-memory snapshot of the cache content in the same shape used
+     * on disk. This is handy for code generation scenarios where we want to emit
+     * a `donobu.json` file without touching the real cache.
+     */
+    async snapshot() {
+        return this.withCacheLock(async (cache) => {
+            const clonedEntries = cache.map((entry) => ({
+                ...entry,
+                allowedTools: [...entry.allowedTools],
+                toolCallCache: JSON.parse(JSON.stringify(entry.toolCallCache)),
+                schema: entry.schema === null
+                    ? null
+                    : JSON.parse(JSON.stringify(entry.schema)),
+            }));
+            return {
+                cache,
+                result: {
+                    caches: clonedEntries,
+                },
+            };
+        });
+    }
+    /**
+     * Lazily creates an empty cache file. Using the `'wx'` flag keeps the method
+     * idempotent even when multiple processes start simultaneously.
+     */
+    async ensureCacheFileExists() {
+        try {
+            await promises_1.default.writeFile(this.cacheFilepath, JSON.stringify({ caches: [] }, null, 2), {
+                encoding: 'utf-8',
+                flag: 'wx',
+            });
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST') {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Determines whether two cache descriptors refer to the same invocation.
+     * `JSON.stringify` comparisons are sufficient here because the structures are
+     * small and deterministic.
+     */
+    matchesKey(entry, key) {
+        return (entry.pageUrl === key.pageUrl &&
+            entry.instruction === key.instruction &&
+            this.areEqual(entry.schema, key.schema) &&
+            this.areEqual(entry.allowedTools, key.allowedTools) &&
+            entry.maxToolCalls === key.maxToolCalls);
+    }
+    /**
+     * Performs a structural equality check for key fields that are collections.
+     */
+    areEqual(left, right) {
+        return JSON.stringify(left) === JSON.stringify(right);
+    }
+    /**
+     * Reads and normalises the cache file, self-healing the structure when the
+     * JSON is missing expected fields.
+     */
+    async readCacheFile() {
+        try {
+            const raw = await promises_1.default.readFile(this.cacheFilepath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed !== 'object' || parsed === null) {
+                throw new Error('Invalid cache file format: expected an object with a caches array.');
+            }
+            if (!Array.isArray(parsed.caches)) {
+                parsed.caches = [];
+                await promises_1.default.writeFile(this.cacheFilepath, JSON.stringify(parsed, null, 2), 'utf-8');
+            }
+            return parsed.caches;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Writes the provided cache array back to disk using the canonical JSON
+     * structure.
+     */
+    async writeCacheFile(cache) {
+        await promises_1.default.writeFile(this.cacheFilepath, JSON.stringify({ caches: cache }, null, 2), 'utf-8');
+    }
+    /**
+     * Helper that serialises access to the cache file. The callback operates on
+     * the current in-memory cache and can optionally return a new array to persist.
+     */
+    async withCacheLock(operation) {
+        await this.ensureCacheFileExists();
+        const release = await LockFile.lock(this.cacheFilepath, {
+            retries: {
+                retries: 5,
+                minTimeout: 100,
+                maxTimeout: 1000,
+            },
+        });
+        try {
+            const currentCache = await this.readCacheFile();
+            const { cache, result } = await operation(currentCache);
+            if (cache !== currentCache) {
+                await this.writeCacheFile(cache);
+            }
+            return result;
+        }
+        finally {
+            await release();
+        }
+    }
+}
+exports.FilePageAiCache = FilePageAiCache;
+//# sourceMappingURL=cache.js.map

package/dist/esm/lib/pageAi/cache.js.map

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

package/dist/esm/lib/pageAi/cacheEntryBuilder.d.ts

@@ -0,0 +1,17 @@
+import { FlowMetadata } from '../../models/FlowMetadata';
+import { ProposedToolCall } from '../../models/ProposedToolCall';
+import { PageAiCacheEntry } from './cache';
+type CacheMetadata = Pick<FlowMetadata, 'overallObjective' | 'resultJsonSchema' | 'allowedTools' | 'maxToolCalls'>;
+/**
+ * Utility for translating flow metadata into cache entries. By centralising the
+ * logic here, both the runtime (`PageAi`) and the code generator can build
+ * matching cache files without duplicating knowledge about the schema.
+ */
+export declare class PageAiCacheEntryBuilder {
+    /**
+     * Produces a cache entry that mirrors the format persisted by the runtime.
+     */
+    static fromMetadata(pageUrl: string, metadata: CacheMetadata, toolCallCache: ProposedToolCall[]): PageAiCacheEntry;
+}
+export {};
+//# sourceMappingURL=cacheEntryBuilder.d.ts.map

package/dist/esm/lib/pageAi/cacheEntryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheEntryBuilder.d.ts","sourceRoot":"","sources":["../../../../src/lib/pageAi/cacheEntryBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,KAAK,aAAa,GAAG,IAAI,CACvB,YAAY,EACZ,kBAAkB,GAAG,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAC1E,CAAC;AAEF;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC;;OAEG;WACW,YAAY,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,gBAAgB,EAAE,GAChC,gBAAgB;CAUpB"}

package/dist/esm/lib/pageAi/cacheEntryBuilder.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageAiCacheEntryBuilder = void 0;
+/**
+ * Utility for translating flow metadata into cache entries. By centralising the
+ * logic here, both the runtime (`PageAi`) and the code generator can build
+ * matching cache files without duplicating knowledge about the schema.
+ */
+class PageAiCacheEntryBuilder {
+    /**
+     * Produces a cache entry that mirrors the format persisted by the runtime.
+     */
+    static fromMetadata(pageUrl, metadata, toolCallCache) {
+        return {
+            pageUrl,
+            instruction: metadata.overallObjective,
+            schema: metadata.resultJsonSchema,
+            allowedTools: metadata.allowedTools,
+            maxToolCalls: metadata.maxToolCalls,
+            toolCallCache,
+        };
+    }
+}
+exports.PageAiCacheEntryBuilder = PageAiCacheEntryBuilder;
+//# sourceMappingURL=cacheEntryBuilder.js.map

package/dist/esm/lib/pageAi/cacheEntryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheEntryBuilder.js","sourceRoot":"","sources":["../../../../src/lib/pageAi/cacheEntryBuilder.ts"],"names":[],"mappings":";;;AASA;;;;GAIG;AACH,MAAa,uBAAuB;IAClC;;OAEG;IACI,MAAM,CAAC,YAAY,CACxB,OAAe,EACf,QAAuB,EACvB,aAAiC;QAEjC,OAAO;YACL,OAAO;YACP,WAAW,EAAE,QAAQ,CAAC,gBAAgB;YACtC,MAAM,EAAE,QAAQ,CAAC,gBAAgB;YACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa;SACd,CAAC;IACJ,CAAC;CACF;AAlBD,0DAkBC"}

package/dist/esm/lib/testExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testExtension.d.ts","sourceRoot":"","sources":["../../../src/lib/testExtension.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAqDjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAUpE,cAAc,iBAAiB,CAAC;AAoBhC,eAAO,MAAM,IAAI;mBACA,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;gBACrD,SAAS;UACf,kBAAkB;wGAkcxB,CAAC"}
+{"version":3,"file":"testExtension.d.ts","sourceRoot":"","sources":["../../../src/lib/testExtension.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAmDjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAgBpE,cAAc,iBAAiB,CAAC;AAoBhC,eAAO,MAAM,IAAI;mBACA,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;gBACrD,SAAS;UACf,kBAAkB;wGAwHxB,CAAC"}