donobu 2.46.0 → 2.46.3

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;AAoDjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAepE,cAAc,iBAAiB,CAAC;AAoBhC,eAAO,MAAM,IAAI;mBACA,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;gBACrD,SAAS;UACf,kBAAkB;wGAwHxB,CAAC"}