donobu 5.57.1 → 5.60.0

package/dist/esm/lib/ai/cache/assertCache.d.ts

@@ -53,15 +53,28 @@ export declare function buildAssertExecutor(steps: PlaywrightAssertionStep[]): A
  * on the same domain always resolves to the same cached entry.
  */
 export type AssertCacheKey = {
+    /**
+     * Target device discriminator; defaults to `'web'`. Plugin targets supply
+     * their own opaque value — core treats any non-`'web'` value as an opaque
+     * string.
+     */
+    deviceType?: string;
     pageUrl: string;
     assertion: string;
 };
+/**
+ * A structured assertion step. Web entries store
+ * {@link PlaywrightAssertionStep}s, which core compiles into Playwright
+ * `expect` calls. Non-web (plugin-target) entries store their own step
+ * shapes — opaque to core; the owning plugin interprets them on replay.
+ */
+export type AssertStep = PlaywrightAssertionStep | Record<string, unknown>;
 /**
  * Serialised cache entry stored on disk. Contains structured assertion
  * steps rather than raw code strings.
  */
 export type AssertCacheEntry = AssertCacheKey & {
-    steps: PlaywrightAssertionStep[];
+    steps: AssertStep[];
 };
 /**
  * Entry hydrated with an executable runner.

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

@@ -9,8 +9,12 @@ import type { AssertCacheEntry, AssertCacheEntryWithRunner, AssertCacheKey, Loca
  * For mobile entries, `pageUrl` is the sentinel `"mobile://app"`.
  */
 export type PageAiCacheKey = {
-    /** Discriminator for web vs mobile cache entries. Defaults to `'web'` for backwards compat. */
-    deviceType?: 'web' | 'android' | 'ios';
+    /**
+     * Target device discriminator; defaults to `'web'`. Plugin targets supply
+     * their own opaque value (e.g. mobile `'android'`/`'ios'`, API `'api'`) — core
+     * treats any non-`'web'` value as an opaque string.
+     */
+    deviceType?: string;
     pageUrl: string;
     instruction: string | null;
     schema: Record<string, unknown> | null;
@@ -39,9 +43,13 @@ export type PageAiCacheContents = {
     locators?: LocateCacheEntry[];
 };
 export type PageAiCacheExecutionContext = {
+    /** Legacy cutout for the built-in web target. */
     page?: DonobuExtendedPage;
-    /** Plugin-provided device (e.g. mobile). Typed as `unknown` — callers cast as needed. */
-    device?: unknown;
+    /**
+     * Plugin targets supply their own handle under a target-specific key,
+     * opaque to core; the plugin's cache replay casts to its concrete shape.
+     */
+    [targetHandle: string]: unknown;
 };
 export type PageAiCacheExecutor = (context: PageAiCacheExecutionContext) => Promise<unknown>;
 /**

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

@@ -108,15 +108,30 @@ const cloneEntryWithRunner = (entry) => ({
 // ---------------------------------------------------------------------------
 // Assert cache helpers
 // ---------------------------------------------------------------------------
-const assertCacheKeysMatch = (left, right) => left.pageUrl === right.pageUrl && left.assertion === right.assertion;
+const assertCacheKeysMatch = (left, right) => (left.deviceType ?? 'web') === (right.deviceType ?? 'web') &&
+    left.pageUrl === right.pageUrl &&
+    left.assertion === right.assertion;
 const materializeAssertEntry = (entry) => ({
     ...entry,
-    run: (0, assertCache_1.buildAssertExecutor)(entry.steps),
+    // Only web steps compile into Playwright `expect` calls. Non-web entries
+    // are interpreted by their owning plugin, which reads `steps` directly.
+    run: (entry.deviceType ?? 'web') === 'web'
+        ? (0, assertCache_1.buildAssertExecutor)(entry.steps)
+        : async () => {
+            throw new Error(`No assert executor for deviceType '${entry.deviceType}'; the owning plugin interprets cached steps directly.`);
+        },
 });
-const cloneAssertEntry = (entry) => ({
+// Drops the live runner to produce a JSON-safe shape for storage/serialization.
+const stripAssertRunner = (entry) => ({
+    ...(entry.deviceType && entry.deviceType !== 'web'
+        ? { deviceType: entry.deviceType }
+        : {}),
     pageUrl: entry.pageUrl,
     assertion: entry.assertion,
     steps: entry.steps,
+});
+const cloneAssertEntry = (entry) => ({
+    ...stripAssertRunner(entry),
     run: entry.run,
 });
 // ---------------------------------------------------------------------------
@@ -152,7 +167,17 @@ const serializeEntry = (entry) => {
 const renderCacheModule = (entries, assertions, locators) => {
     const serializedEntries = entries.map(serializeEntry).join(', ');
     const assertionsPart = assertions && assertions.length > 0
-        ? `, assertions: [${assertions.map((a) => JSON.stringify({ pageUrl: a.pageUrl, assertion: a.assertion, steps: a.steps })).join(', ')}]`
+        ? `, assertions: [${assertions
+            .map((a) => JSON.stringify({
+            // Only emit deviceType for non-web entries (backwards compat).
+            ...(a.deviceType && a.deviceType !== 'web'
+                ? { deviceType: a.deviceType }
+                : {}),
+            pageUrl: a.pageUrl,
+            assertion: a.assertion,
+            steps: a.steps,
+        }))
+            .join(', ')}]`
         : '';
     const locatorsPart = locators && locators.length > 0
         ? `, locators: [${locators.map((l) => JSON.stringify({ pageUrl: l.pageUrl, description: l.description, result: l.result })).join(', ')}]`
@@ -227,11 +252,7 @@ class FilePageAiCache {
             state,
             result: {
                 caches: state.caches.map((entry) => stripRunner(entry)),
-                assertions: state.assertions.map((a) => ({
-                    pageUrl: a.pageUrl,
-                    assertion: a.assertion,
-                    steps: a.steps,
-                })),
+                assertions: state.assertions.map((a) => stripAssertRunner(a)),
                 locators: state.locators.map((l) => ({
                     pageUrl: l.pageUrl,
                     description: l.description,
@@ -370,11 +391,11 @@ class FilePageAiCache {
                     throw new Error(`Invalid cache entry: run must be a function for ${entry.pageUrl ?? 'unknown page'}.`);
                 }
                 const normalized = {
-                    ...(entry.deviceType === 'android'
-                        ? { deviceType: 'android' }
-                        : entry.deviceType === 'ios'
-                            ? { deviceType: 'ios' }
-                            : {}),
+                    // Preserve any non-web device type verbatim — values are opaque to
+                    // core (web is the built-in; plugin targets supply their own).
+                    ...(entry.deviceType && entry.deviceType !== 'web'
+                        ? { deviceType: String(entry.deviceType) }
+                        : {}),
                     pageUrl: String(entry.pageUrl ?? ''),
                     instruction: entry.instruction === null || entry.instruction === undefined
                         ? null
@@ -406,6 +427,9 @@ class FilePageAiCache {
                     ? entry.steps
                     : [];
                 return materializeAssertEntry({
+                    ...(entry.deviceType && entry.deviceType !== 'web'
+                        ? { deviceType: String(entry.deviceType) }
+                        : {}),
                     pageUrl: String(entry.pageUrl ?? ''),
                     assertion: String(entry.assertion ?? ''),
                     steps,
@@ -431,11 +455,7 @@ class FilePageAiCache {
     }
     async writeCacheFile(state) {
         const serializedCaches = state.caches.map((entry) => stripRunner(entry));
-        const serializedAssertions = state.assertions.map((e) => ({
-            pageUrl: e.pageUrl,
-            assertion: e.assertion,
-            steps: e.steps,
-        }));
+        const serializedAssertions = state.assertions.map((e) => stripAssertRunner(e));
         const serializedLocators = state.locators.map((e) => ({
             pageUrl: e.pageUrl,
             description: e.description,
@@ -517,11 +537,7 @@ class InMemoryPageAiCache {
     async snapshot() {
         return {
             caches: this.cache.map((entry) => stripRunner(entry)),
-            assertions: this.assertions.map((a) => ({
-                pageUrl: a.pageUrl,
-                assertion: a.assertion,
-                steps: a.steps,
-            })),
+            assertions: this.assertions.map((a) => stripAssertRunner(a)),
             locators: this.locators.map((l) => ({
                 pageUrl: l.pageUrl,
                 description: l.description,

package/dist/esm/lib/ai/cache/cacheEntryBuilder.d.ts

@@ -2,9 +2,9 @@ import type { FlowMetadata } from '../../../models/FlowMetadata';
 import type { ProposedToolCall } from '../../../models/ProposedToolCall';
 import type { PageAiCacheEntry } from './cache';
 /**
- * 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.
+ * Builds web (Playwright) cache entries. Shared by the web runtime (`PageAi`)
+ * and the web code generator so both emit matching `page.run(...)` replay
+ * source. Non-web targets build their own cache entries in their own plugins.
  */
 export declare class PageAiCacheEntryBuilder {
     /**

package/dist/esm/lib/ai/cache/cacheEntryBuilder.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PageAiCacheEntryBuilder = void 0;
 const CodeGenerator_1 = require("../../../codegen/CodeGenerator");
 /**
- * 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.
+ * Builds web (Playwright) cache entries. Shared by the web runtime (`PageAi`)
+ * and the web code generator so both emit matching `page.run(...)` replay
+ * source. Non-web targets build their own cache entries in their own plugins.
  */
 class PageAiCacheEntryBuilder {
     /**
@@ -20,9 +20,7 @@ class PageAiCacheEntryBuilder {
             maxToolCalls: metadata.maxToolCalls,
             envVars: metadata.envVars,
             runSource: `async ({ page }) => {${toolCallCache
-                .map((toolCall) => {
-                return (0, CodeGenerator_1.convertProposedToolCallToPlaywrightCode)(toolCall);
-            })
+                .map((toolCall) => (0, CodeGenerator_1.convertProposedToolCallToPlaywrightCode)(toolCall))
                 .join('\n\n')}}`,
         };
     }

package/dist/esm/lib/page/extendPage.js

@@ -266,6 +266,8 @@ Valid options:
                     const cached = await cache.getAssert({ pageUrl, assertion });
                     if (cached) {
                         aiInvocationCacheHit = true;
+                        // The key above carries no deviceType, so it only matches web
+                        // entries — whose steps are Playwright-shaped by construction.
                         aiInvocationAssertSteps = cached.steps;
                         Logger_1.appLogger.debug(`Assert cache HIT for: "${assertion}" - running cached Playwright assertion`);
                         const envData = await resolveEnvData();

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

@@ -1109,6 +1109,12 @@ function getSanitizedTestName(testInfo) {
 }
 /** Builds a TestMetadata from the fields available on a FlowMetadata. */
 function flowMetadataToTestMetadata(testId, flowMeta) {
+    const targetConfig = {};
+    if (flowMeta.target &&
+        flowMeta.target !== 'web' &&
+        flowMeta.target in flowMeta) {
+        targetConfig[flowMeta.target] = flowMeta[flowMeta.target];
+    }
     return {
         id: testId,
         name: flowMeta.name,
@@ -1125,6 +1131,7 @@ function flowMetadataToTestMetadata(testId, flowMeta) {
         suiteId: null,
         nextRunMode: 'DETERMINISTIC',
         provenance: (0, buildProvenance_1.buildProvenance)('CODE'),
+        ...targetConfig,
     };
 }
 //# sourceMappingURL=testExtension.js.map

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

@@ -267,6 +267,20 @@ to someone who is tasked with completing it as a goal.
     }
 }
 async function buildToolList(donobuFlowMetadata, toolRegistry) {
+    if (donobuFlowMetadata.target !== 'web') {
+        const targetDefaultTools = toolRegistry
+            .defaultTools()
+            .filter((tool) => tool.supportedTargets.length === 0 ||
+            tool.supportedTargets.includes(donobuFlowMetadata.target))
+            .map((tool) => tool.name);
+        const defaultTools = new Set([
+            ...(donobuFlowMetadata.allowedTools
+                ? donobuFlowMetadata.allowedTools
+                : []),
+            ...targetDefaultTools,
+        ]);
+        return [...defaultTools];
+    }
     const baseTools = [
         AnalyzePageTextTool_1.AnalyzePageTextTool.NAME,
         AssertTool_1.AssertTool.NAME,

package/dist/esm/main.d.ts

@@ -6,6 +6,7 @@ export { GptClient } from './clients/GptClient';
 export { type GptClientPlugin, GptClientPluginRegistry, } from './clients/GptClientPlugin';
 export { OpenAiGptClient } from './clients/OpenAiGptClient';
 export { VercelAiGptClient } from './clients/VercelAiGptClient';
+export * from './codegen/TargetCodeGenerator';
 export { env } from './envVars';
 export * from './exceptions/DonobuException';
 export * from './exceptions/FlowIdCollisionException';
@@ -14,6 +15,7 @@ export * from './exceptions/GptApiKeysNotSetupException';
 export * from './exceptions/GptPlatformAuthenticationFailedException';
 export * from './exceptions/InvalidParamValueException';
 export * from './exceptions/ToolCallFailedException';
+export * from './lib/ai/cache/assertCache';
 export * from './lib/ai/cache/cache';
 export * from './lib/ai/cache/cacheLocator';
 export type * from './lib/page/DonobuExtendedPage';
@@ -29,7 +31,7 @@ export { type DonobuStack, setupDonobuStack } from './managers/DonobuStack';
 export { InteractionVisualizer } from './managers/InteractionVisualizer';
 export { type LoadedPlugins, type PluginDependencies, PluginLoader, } from './managers/PluginLoader';
 export type * from './managers/TargetInspector';
-export { ToolManager } from './managers/ToolManager';
+export { buildToolInterpolationDataSource, ToolManager, } from './managers/ToolManager';
 export { createDefaultToolRegistry, type ToolRegistry, } from './managers/ToolRegistry';
 export * from './managers/WebTargetInspector';
 export type * from './models/AiQuery';
@@ -55,6 +57,7 @@ export type * from './models/ToolCall';
 export type * from './models/ToolCallContext';
 export * from './models/ToolCallResult';
 export * from './models/ToolSchema';
+export type * from './models/ToolTemplateDataSource';
 export type { VideoSegment } from './models/VideoSegment';
 export type { EnvPersistence } from './persistence/env/EnvPersistence';
 export { type FileUploadAggregateStatus, type FileUploadPlatformStatus, getFileUploadAggregateStatus, shutdownFileUploadWorkers, } from './persistence/files/fileUploadWorkerRegistry';
@@ -65,17 +68,20 @@ export type { TestsPersistence } from './persistence/tests/TestsPersistence';
 export type * from './targets/TargetProvider';
 export type { TargetRuntime } from './targets/TargetRuntime';
 export { type TargetRuntimeParams, type TargetRuntimePlugin, TargetRuntimePluginRegistry, } from './targets/TargetRuntimePlugin';
+export * from './tools/InputFakerTool';
 export * from './tools/ReplayableInteraction';
 export * from './tools/Tool';
 export * from './utils/buildProvenance';
 export * from './utils/createTool';
 export * from './utils/FlowLogBuffer';
+export * from './utils/JsonPath';
 export * from './utils/JsonSchemaUtils';
 export * from './utils/JsonUtils';
 export * from './utils/Logger';
 export * from './utils/MiscUtils';
 export * from './utils/PlaywrightUtils';
 export * from './utils/TargetUtils';
+export * from './utils/TemplateInterpolator';
 /**
  * Starts a Donobu API server at the given port. The server assumes that the
  * Playwright browsers have been installed.

package/dist/esm/main.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TargetRuntimePluginRegistry = exports.PersistencePluginRegistry = exports.shutdownFileUploadWorkers = exports.getFileUploadAggregateStatus = exports.createDefaultToolRegistry = exports.ToolManager = exports.PluginLoader = exports.InteractionVisualizer = exports.setupDonobuStack = exports.prepareToolCallsForRerun = exports.DonobuFlowsManager = exports.distillAllowedEnvVariableNames = exports.DonobuFlow = exports.AdminApiController = exports.env = exports.VercelAiGptClient = exports.OpenAiGptClient = exports.GptClientPluginRegistry = exports.GptClient = exports.GoogleGenerativeAiGptClient = exports.fixAssertFields = exports.DonobuGptClient = exports.AnthropicGptClient = void 0;
+exports.TargetRuntimePluginRegistry = exports.PersistencePluginRegistry = exports.shutdownFileUploadWorkers = exports.getFileUploadAggregateStatus = exports.createDefaultToolRegistry = exports.ToolManager = exports.buildToolInterpolationDataSource = exports.PluginLoader = exports.InteractionVisualizer = exports.setupDonobuStack = exports.prepareToolCallsForRerun = exports.DonobuFlowsManager = exports.distillAllowedEnvVariableNames = exports.DonobuFlow = exports.AdminApiController = exports.env = exports.VercelAiGptClient = exports.OpenAiGptClient = exports.GptClientPluginRegistry = exports.GptClient = exports.GoogleGenerativeAiGptClient = exports.fixAssertFields = exports.DonobuGptClient = exports.AnthropicGptClient = void 0;
 exports.startDonobuServer = startDonobuServer;
 const commander_1 = require("commander");
 const v4_1 = require("zod/v4");
@@ -39,6 +39,7 @@ var OpenAiGptClient_1 = require("./clients/OpenAiGptClient");
 Object.defineProperty(exports, "OpenAiGptClient", { enumerable: true, get: function () { return OpenAiGptClient_1.OpenAiGptClient; } });
 var VercelAiGptClient_1 = require("./clients/VercelAiGptClient");
 Object.defineProperty(exports, "VercelAiGptClient", { enumerable: true, get: function () { return VercelAiGptClient_1.VercelAiGptClient; } });
+__exportStar(require("./codegen/TargetCodeGenerator"), exports);
 var envVars_2 = require("./envVars");
 Object.defineProperty(exports, "env", { enumerable: true, get: function () { return envVars_2.env; } });
 __exportStar(require("./exceptions/DonobuException"), exports);
@@ -48,6 +49,7 @@ __exportStar(require("./exceptions/GptApiKeysNotSetupException"), exports);
 __exportStar(require("./exceptions/GptPlatformAuthenticationFailedException"), exports);
 __exportStar(require("./exceptions/InvalidParamValueException"), exports);
 __exportStar(require("./exceptions/ToolCallFailedException"), exports);
+__exportStar(require("./lib/ai/cache/assertCache"), exports);
 __exportStar(require("./lib/ai/cache/cache"), exports);
 __exportStar(require("./lib/ai/cache/cacheLocator"), exports);
 __exportStar(require("./lib/page/extendPage"), exports);
@@ -70,6 +72,7 @@ Object.defineProperty(exports, "InteractionVisualizer", { enumerable: true, get:
 var PluginLoader_1 = require("./managers/PluginLoader");
 Object.defineProperty(exports, "PluginLoader", { enumerable: true, get: function () { return PluginLoader_1.PluginLoader; } });
 var ToolManager_1 = require("./managers/ToolManager");
+Object.defineProperty(exports, "buildToolInterpolationDataSource", { enumerable: true, get: function () { return ToolManager_1.buildToolInterpolationDataSource; } });
 Object.defineProperty(exports, "ToolManager", { enumerable: true, get: function () { return ToolManager_1.ToolManager; } });
 var ToolRegistry_1 = require("./managers/ToolRegistry");
 Object.defineProperty(exports, "createDefaultToolRegistry", { enumerable: true, get: function () { return ToolRegistry_1.createDefaultToolRegistry; } });
@@ -95,17 +98,20 @@ var PersistencePlugin_1 = require("./persistence/PersistencePlugin");
 Object.defineProperty(exports, "PersistencePluginRegistry", { enumerable: true, get: function () { return PersistencePlugin_1.PersistencePluginRegistry; } });
 var TargetRuntimePlugin_1 = require("./targets/TargetRuntimePlugin");
 Object.defineProperty(exports, "TargetRuntimePluginRegistry", { enumerable: true, get: function () { return TargetRuntimePlugin_1.TargetRuntimePluginRegistry; } });
+__exportStar(require("./tools/InputFakerTool"), exports);
 __exportStar(require("./tools/ReplayableInteraction"), exports);
 __exportStar(require("./tools/Tool"), exports);
 __exportStar(require("./utils/buildProvenance"), exports);
 __exportStar(require("./utils/createTool"), exports);
 __exportStar(require("./utils/FlowLogBuffer"), exports);
+__exportStar(require("./utils/JsonPath"), exports);
 __exportStar(require("./utils/JsonSchemaUtils"), exports);
 __exportStar(require("./utils/JsonUtils"), exports);
 __exportStar(require("./utils/Logger"), exports);
 __exportStar(require("./utils/MiscUtils"), exports);
 __exportStar(require("./utils/PlaywrightUtils"), exports);
 __exportStar(require("./utils/TargetUtils"), exports);
+__exportStar(require("./utils/TemplateInterpolator"), exports);
 const DEFAULT_PORT = 31000;
 /**
  * Starts a Donobu API server at the given port. The server assumes that the

package/dist/esm/managers/DonobuFlowsManager.js

@@ -42,6 +42,7 @@ const fs = __importStar(require("fs/promises"));
 const os_1 = require("os");
 const path = __importStar(require("path"));
 const CodeGenerator_1 = require("../codegen/CodeGenerator");
+const TargetCodeGenerator_1 = require("../codegen/TargetCodeGenerator");
 const ActiveFlowNotFoundException_1 = require("../exceptions/ActiveFlowNotFoundException");
 const BrowserStateNotFoundException_1 = require("../exceptions/BrowserStateNotFoundException");
 const CannotDeleteRunningFlowException_1 = require("../exceptions/CannotDeleteRunningFlowException");
@@ -471,10 +472,22 @@ class DonobuFlowsManager {
         const originalToolCalls = (await this.getToolCalls(flowId)).filter((tc) => tc.outcome?.isSuccessful);
         const proposedToolCalls = await prepareToolCallsForRerun(originalToolCalls, effectiveOptions, this.toolRegistry);
         const scriptVariant = effectiveOptions.playwrightScriptVariant === 'classic' ? 'classic' : 'ai';
-        if (scriptVariant === 'classic') {
-            return (0, CodeGenerator_1.getFlowAsPlaywrightScript)(flowMetadata, proposedToolCalls, effectiveOptions, this.toolRegistry);
-        }
-        return (0, CodeGenerator_1.getFlowAsAiPlaywrightScript)(flowMetadata, proposedToolCalls, effectiveOptions, this.toolRegistry);
+        // Dispatch to the target's code generator (web is built in; plugin targets
+        // register their own). A target with no generator (e.g. mobile, which owns
+        // its codegen entirely in-plugin) has no spec output via this endpoint.
+        const generator = (0, TargetCodeGenerator_1.getCodeGenerator)(flowMetadata.target);
+        if (!generator) {
+            throw new Error(`Code generation is not supported for target "${flowMetadata.target}".`);
+        }
+        const ctx = {
+            flowMetadata,
+            toolCalls: proposedToolCalls,
+            options: effectiveOptions,
+            toolRegistry: this.toolRegistry,
+        };
+        return scriptVariant === 'classic'
+            ? generator.generateClassicScript(ctx)
+            : generator.generateAiScript(ctx);
     }
     /**
      * Generates a complete Playwright project structure for multiple flows with dependency management.

package/dist/esm/managers/DonobuStack.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupDonobuStack = setupDonobuStack;
 const GptClientFactory_1 = require("../clients/GptClientFactory");
 const GptClientPlugin_1 = require("../clients/GptClientPlugin");
+const TargetCodeGenerator_1 = require("../codegen/TargetCodeGenerator");
 const envVars_1 = require("../envVars");
 const AgentsPersistenceSqlite_1 = require("../persistence/agents/AgentsPersistenceSqlite");
 const DonobuSqliteDb_1 = require("../persistence/DonobuSqliteDb");
@@ -78,6 +79,14 @@ async function loadDefaultPlugins() {
     const pluginLoader = await PluginLoader_1.PluginLoader.create();
     const plugins = await pluginLoader.loadAllPlugins();
     plugins.targetRuntimePlugins.unshift(WebTargetRuntime_1.webTargetRuntimePlugin);
+    // Register each target's code generator (if any) so the code generator can
+    // emit spec files for plugin targets without knowing about them. The web
+    // generator is registered by the code generator module itself.
+    for (const plugin of plugins.targetRuntimePlugins) {
+        if (plugin.codeGenerator) {
+            (0, TargetCodeGenerator_1.registerCodeGenerator)(plugin.codeGenerator);
+        }
+    }
     return plugins;
 }
 //# sourceMappingURL=DonobuStack.js.map

package/dist/esm/managers/TestsManager.js

@@ -23,6 +23,10 @@ class TestsManager {
                 targetWebsite: params.web.targetWebsite,
             }
             : undefined;
+        const targetConfig = {};
+        if (params.target && params.target !== 'web' && params.target in params) {
+            targetConfig[params.target] = params[params.target];
+        }
         const testMetadata = {
             id: testId,
             metadataVersion: MetadataVersion_1.CURRENT_METADATA_VERSION,
@@ -41,6 +45,7 @@ class TestsManager {
             videoDisabled: params.videoDisabled,
             tags: [],
             provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
+            ...targetConfig,
         };
         // If the test is part of a suite, write it to the same persistence layer
         // as the suite — otherwise the suite_id foreign key fails (in SQLite)

package/dist/esm/managers/ToolManager.js

@@ -173,12 +173,14 @@ exports.ToolManager = ToolManager;
 function buildToolInterpolationDataSource(envData, previousToolCalls) {
     const dataSource = {
         env: envData,
+        vars: {},
         calls: [],
     };
     const interpolatedPastToolCalls = [];
     for (const toolCall of previousToolCalls) {
         const tempDataSource = {
             env: envData,
+            vars: dataSource.vars,
             calls: [...interpolatedPastToolCalls],
         };
         const processedParameters = (0, TemplateInterpolator_1.interpolateObject)(toolCall.parameters, tempDataSource);
@@ -188,6 +190,15 @@ function buildToolInterpolationDataSource(envData, previousToolCalls) {
             result: toolCall.outcome.forLlm,
         });
         dataSource.calls = [...interpolatedPastToolCalls];
+        const variables = toolCall.outcome?.metadata?.variables;
+        if (variables &&
+            typeof variables === 'object' &&
+            !Array.isArray(variables)) {
+            dataSource.vars = {
+                ...dataSource.vars,
+                ...variables,
+            };
+        }
     }
     return dataSource;
 }

package/dist/esm/models/CreateDonobuFlow.js

@@ -40,7 +40,7 @@ not need this, omit it and let the SDK mint an ID.`),
     })
         .optional()
         .describe('Web target configuration. Required when target is "web".'),
-    // Plugin-provided target configurations (e.g. mobile) flow through via
+    // Plugin-provided target configurations (e.g. mobile, api) flow through via
     // .passthrough() and are validated by the corresponding TargetRuntimePlugin.
     // -- Target-invariant fields --
     name: v4_1.z

package/dist/esm/models/RunConfig.js

@@ -25,7 +25,7 @@ exports.RunConfigSchema = v4_1.z.looseObject({
         .string()
         .describe('The target type (e.g. "web", "mobile"). The value names the key containing the target-specific configuration.'),
     web: WebTargetConfigSchema.optional().describe('Web target configuration. Present when target is "web".'),
-    // Plugin-provided target configurations (e.g. mobile) flow through via
+    // Plugin-provided target configurations (e.g. mobile, api) flow through via
     // the loose object behavior and are validated by the corresponding
     // TargetRuntimePlugin.
     envVars: v4_1.z

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

@@ -19,6 +19,11 @@ export type ToolTemplateDataSource = {
      * The environment variables available to the current Donobu flow.
      */
     env: Record<string, string>;
+    /**
+     * Values published by prior tool calls (via `outcome.metadata.variables`)
+     * for reuse in later tool params.
+     */
+    vars: Record<string, unknown>;
     /**
      * The historical tool calls for the current Donobu flow.
      */

package/dist/esm/targets/TargetRuntimePlugin.d.ts

@@ -1,5 +1,6 @@
 import type { EnvPick } from 'env-struct';
 import type { BrowserContext } from 'playwright';
+import type { TargetCodeGenerator } from '../codegen/TargetCodeGenerator';
 import type { env } from '../envVars';
 import type { InteractionVisualizer } from '../managers/InteractionVisualizer';
 import type { BrowserStateReference } from '../models/BrowserStateFlowReference';
@@ -77,6 +78,18 @@ export interface TargetRuntimePlugin {
      * the flow completes or errors.
      */
     createRuntime(params: TargetRuntimeParams): Promise<TargetRuntime>;
+    /**
+     * Optional code generator for this target, registered with the code
+     * generator registry at startup. Owns this target's full spec/cache output
+     * and is what the unified "flow as code" path dispatches to.
+     *
+     * Omit when a target doesn't plug into core's codegen — either it produces no
+     * replay artifacts, or it owns codegen entirely in-plugin via its own path
+     * (e.g. mobile today builds `device.run(...)` cache entries through its own
+     * builder and never routes through core). Flows of a target with no
+     * registered generator have no output via the unified endpoint.
+     */
+    readonly codeGenerator?: TargetCodeGenerator;
 }
 /**
  * An immutable registry of target runtime plugins, keyed by target type.

package/dist/lib/ai/cache/assertCache.d.ts

@@ -53,15 +53,28 @@ export declare function buildAssertExecutor(steps: PlaywrightAssertionStep[]): A
  * on the same domain always resolves to the same cached entry.
  */
 export type AssertCacheKey = {
+    /**
+     * Target device discriminator; defaults to `'web'`. Plugin targets supply
+     * their own opaque value — core treats any non-`'web'` value as an opaque
+     * string.
+     */
+    deviceType?: string;
     pageUrl: string;
     assertion: string;
 };
+/**
+ * A structured assertion step. Web entries store
+ * {@link PlaywrightAssertionStep}s, which core compiles into Playwright
+ * `expect` calls. Non-web (plugin-target) entries store their own step
+ * shapes — opaque to core; the owning plugin interprets them on replay.
+ */
+export type AssertStep = PlaywrightAssertionStep | Record<string, unknown>;
 /**
  * Serialised cache entry stored on disk. Contains structured assertion
  * steps rather than raw code strings.
  */
 export type AssertCacheEntry = AssertCacheKey & {
-    steps: PlaywrightAssertionStep[];
+    steps: AssertStep[];
 };
 /**
  * Entry hydrated with an executable runner.

package/dist/lib/ai/cache/cache.d.ts

@@ -9,8 +9,12 @@ import type { AssertCacheEntry, AssertCacheEntryWithRunner, AssertCacheKey, Loca
  * For mobile entries, `pageUrl` is the sentinel `"mobile://app"`.
  */
 export type PageAiCacheKey = {
-    /** Discriminator for web vs mobile cache entries. Defaults to `'web'` for backwards compat. */
-    deviceType?: 'web' | 'android' | 'ios';
+    /**
+     * Target device discriminator; defaults to `'web'`. Plugin targets supply
+     * their own opaque value (e.g. mobile `'android'`/`'ios'`, API `'api'`) — core
+     * treats any non-`'web'` value as an opaque string.
+     */
+    deviceType?: string;
     pageUrl: string;
     instruction: string | null;
     schema: Record<string, unknown> | null;
@@ -39,9 +43,13 @@ export type PageAiCacheContents = {
     locators?: LocateCacheEntry[];
 };
 export type PageAiCacheExecutionContext = {
+    /** Legacy cutout for the built-in web target. */
     page?: DonobuExtendedPage;
-    /** Plugin-provided device (e.g. mobile). Typed as `unknown` — callers cast as needed. */
-    device?: unknown;
+    /**
+     * Plugin targets supply their own handle under a target-specific key,
+     * opaque to core; the plugin's cache replay casts to its concrete shape.
+     */
+    [targetHandle: string]: unknown;
 };
 export type PageAiCacheExecutor = (context: PageAiCacheExecutionContext) => Promise<unknown>;
 /**