donobu 5.39.1 → 5.41.0

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', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', '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', 'DONOBU_PERSISTENCE_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

@@ -74,6 +74,7 @@ export declare const env: Env<{
     AWS_SECRET_ACCESS_KEY: z.ZodOptional<z.ZodString>;
     EXPERIMENTAL_FEATURES_ENABLED: z.ZodDefault<z.ZodBoolean>;
     DONOBU_API_KEY: z.ZodOptional<z.ZodString>;
+    DONOBU_PERSISTENCE_API_KEY: z.ZodOptional<z.ZodString>;
     GOOGLE_CLOUD_STORAGE_BUCKET: z.ZodOptional<z.ZodString>;
     SCREENSHOT_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
     SELF_HEAL_TESTS_ENABLED: z.ZodOptional<z.ZodString>;
@@ -127,6 +128,7 @@ export declare const env: Env<{
     AWS_ACCESS_KEY_ID?: string | undefined;
     AWS_SECRET_ACCESS_KEY?: string | undefined;
     DONOBU_API_KEY?: string | undefined;
+    DONOBU_PERSISTENCE_API_KEY?: string | undefined;
     GOOGLE_CLOUD_STORAGE_BUCKET?: string | undefined;
     SELF_HEAL_TESTS_ENABLED?: string | undefined;
     PROXY_SERVER?: string | undefined;

package/dist/envVars.js

@@ -188,6 +188,18 @@ flows. If specified, AWS credentials must also be present.`),
         .optional()
         .describe(`The API key for the Donobu API. Used to create GPT configurations backed
 by the Donobu API, and to persist flows via the Donobu API when set.`),
+    DONOBU_PERSISTENCE_API_KEY: v4_1.z
+        .string()
+        .optional()
+        .describe(`Persistence-only fallback for the Donobu API key. When set, the DONOBU
+persistence layer will instantiate using this key if DONOBU_API_KEY is
+absent — but unlike DONOBU_API_KEY, this value is NOT consulted by
+DonobuFlowsManager.createGptClient's env-var fallback chain.
+
+Intended for hosts (e.g. the Donobu Studio desktop app) that drive AI
+inference through an explicit gpt-config / flow-runner agent and want
+to enable Donobu Cloud persistence without their persistence credential
+silently overriding the user's flow-runner pick.`),
     GOOGLE_CLOUD_STORAGE_BUCKET: v4_1.z.string().optional()
         .describe(`Directs Donobu flows to be persisted using this Google Cloud Storage
 bucket.`),

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', 'OLLAMA_API_URL', 'OLLAMA_MODEL_NAME', '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', 'DONOBU_PERSISTENCE_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

@@ -74,6 +74,7 @@ export declare const env: Env<{
     AWS_SECRET_ACCESS_KEY: z.ZodOptional<z.ZodString>;
     EXPERIMENTAL_FEATURES_ENABLED: z.ZodDefault<z.ZodBoolean>;
     DONOBU_API_KEY: z.ZodOptional<z.ZodString>;
+    DONOBU_PERSISTENCE_API_KEY: z.ZodOptional<z.ZodString>;
     GOOGLE_CLOUD_STORAGE_BUCKET: z.ZodOptional<z.ZodString>;
     SCREENSHOT_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
     SELF_HEAL_TESTS_ENABLED: z.ZodOptional<z.ZodString>;
@@ -127,6 +128,7 @@ export declare const env: Env<{
     AWS_ACCESS_KEY_ID?: string | undefined;
     AWS_SECRET_ACCESS_KEY?: string | undefined;
     DONOBU_API_KEY?: string | undefined;
+    DONOBU_PERSISTENCE_API_KEY?: string | undefined;
     GOOGLE_CLOUD_STORAGE_BUCKET?: string | undefined;
     SELF_HEAL_TESTS_ENABLED?: string | undefined;
     PROXY_SERVER?: string | undefined;

package/dist/esm/envVars.js

@@ -188,6 +188,18 @@ flows. If specified, AWS credentials must also be present.`),
         .optional()
         .describe(`The API key for the Donobu API. Used to create GPT configurations backed
 by the Donobu API, and to persist flows via the Donobu API when set.`),
+    DONOBU_PERSISTENCE_API_KEY: v4_1.z
+        .string()
+        .optional()
+        .describe(`Persistence-only fallback for the Donobu API key. When set, the DONOBU
+persistence layer will instantiate using this key if DONOBU_API_KEY is
+absent — but unlike DONOBU_API_KEY, this value is NOT consulted by
+DonobuFlowsManager.createGptClient's env-var fallback chain.
+
+Intended for hosts (e.g. the Donobu Studio desktop app) that drive AI
+inference through an explicit gpt-config / flow-runner agent and want
+to enable Donobu Cloud persistence without their persistence credential
+silently overriding the user's flow-runner pick.`),
     GOOGLE_CLOUD_STORAGE_BUCKET: v4_1.z.string().optional()
         .describe(`Directs Donobu flows to be persisted using this Google Cloud Storage
 bucket.`),

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', 'OLLAMA_API_URL', 'OLLAMA_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', 'DONOBU_PERSISTENCE_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/main.d.ts

@@ -105,6 +105,7 @@ export declare function startDonobuServer({ port, controlPanelHost, environ, }?:
         AWS_ACCESS_KEY_ID: z.ZodOptional<z.ZodString>;
         AWS_SECRET_ACCESS_KEY: z.ZodOptional<z.ZodString>;
         DONOBU_API_KEY: z.ZodOptional<z.ZodString>;
+        DONOBU_PERSISTENCE_API_KEY: z.ZodOptional<z.ZodString>;
     }, {
         BASE64_GPT_CONFIG?: string | undefined;
         BROWSERBASE_API_KEY?: string | undefined;
@@ -124,6 +125,7 @@ export declare function startDonobuServer({ port, controlPanelHost, environ, }?:
         AWS_ACCESS_KEY_ID?: string | undefined;
         AWS_SECRET_ACCESS_KEY?: string | undefined;
         DONOBU_API_KEY?: string | undefined;
+        DONOBU_PERSISTENCE_API_KEY?: string | undefined;
     }> | undefined;
 }): Promise<void>;
 //# sourceMappingURL=main.d.ts.map

package/dist/esm/main.js

@@ -113,7 +113,7 @@ const DEFAULT_PORT = 31000;
  * Starts a Donobu API server at the given port. The server assumes that the
  * Playwright browsers have been installed.
  */
-async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, 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_DEPLOYMENT_ENVIRONMENT', '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'), } = {}) {
+async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, 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_DEPLOYMENT_ENVIRONMENT', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'DONOBU_PERSISTENCE_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'), } = {}) {
     try {
         const adminController = await AdminApiController_1.AdminApiController.create(environ.data.DONOBU_DEPLOYMENT_ENVIRONMENT ?? 'LOCAL', controlPanelHost, environ);
         await adminController.start(port);

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' | 'OLLAMA_API_URL' | 'OLLAMA_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' | 'DONOBU_PERSISTENCE_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();
     /**
      * Binds the API/web-asset server to `port` and resolves once the socket is

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

@@ -60,6 +60,7 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     AWS_ACCESS_KEY_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     AWS_SECRET_ACCESS_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     DONOBU_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    DONOBU_PERSISTENCE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
 }, {
     BASE64_GPT_CONFIG?: string | undefined;
     BROWSERBASE_API_KEY?: string | undefined;
@@ -78,5 +79,6 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     AWS_ACCESS_KEY_ID?: string | undefined;
     AWS_SECRET_ACCESS_KEY?: string | undefined;
     DONOBU_API_KEY?: string | undefined;
+    DONOBU_PERSISTENCE_API_KEY?: string | undefined;
 }>): Promise<DonobuStack>;
 //# sourceMappingURL=DonobuStack.d.ts.map

package/dist/esm/managers/DonobuStack.js

@@ -33,7 +33,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', 'OLLAMA_API_URL', 'OLLAMA_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', 'DONOBU_PERSISTENCE_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/managers/TestsManager.js

@@ -174,8 +174,11 @@ class TestsManager {
             try {
                 await persistence.deleteTest(testId);
             }
-            catch {
-                // Ignore errors from layers that don't have this test.
+            catch (e) {
+                // Ignore TestNotFoundException errors from layers that don't have this test.
+                if (!(e instanceof TestNotFoundException_1.TestNotFoundException)) {
+                    throw e;
+                }
             }
         }
         // Cascade-delete flows belonging to this test. Paginate through all flows

package/dist/esm/persistence/DonobuApiClient.js

@@ -24,7 +24,7 @@ class DonobuApiClient {
     async jsonRequest(path, method, body) {
         return this.request(path, {
             method,
-            headers: { 'Content-Type': 'application/json' },
+            headers: body !== undefined ? { 'Content-Type': 'application/json' } : {},
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
     }

package/dist/esm/persistence/flows/FlowsPersistenceRegistry.d.ts

@@ -46,7 +46,7 @@ export declare class FlowsPersistenceRegistryImpl implements FlowsPersistenceReg
      * Creates an instance by reading environment variables and eagerly constructing
      * all applicable persistence layers.
      */
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<FlowsPersistenceRegistryImpl>;
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'DONOBU_PERSISTENCE_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<FlowsPersistenceRegistryImpl>;
     /**
      * Returns the primary persistence layer.
      */

package/dist/esm/persistence/flows/FlowsPersistenceRegistry.js

@@ -26,7 +26,13 @@ class FlowsPersistenceRegistryImpl {
      */
     static async fromEnvironment(environ, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
-        const donobuApiKey = environ.data.DONOBU_API_KEY;
+        // Persistence credential resolution: prefer the primary DONOBU_API_KEY
+        // (which also drives the inference fallback chain in
+        // DonobuFlowsManager.createGptClient), then fall back to the
+        // persistence-only DONOBU_PERSISTENCE_API_KEY for hosts that route
+        // inference through an explicit gpt-config and don't want their
+        // persistence credential to short-circuit the agent lookup.
+        const donobuApiKey = environ.data.DONOBU_API_KEY ?? environ.data.DONOBU_PERSISTENCE_API_KEY;
         const layers = [];
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
             switch (key) {

package/dist/esm/persistence/suites/SuitesPersistenceRegistry.d.ts

@@ -26,7 +26,7 @@ export interface SuitesPersistenceRegistry {
 export declare class SuitesPersistenceRegistryImpl implements SuitesPersistenceRegistry {
     private readonly layers;
     constructor(layers: SuitesPersistenceLayer[]);
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<SuitesPersistenceRegistryImpl>;
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'DONOBU_PERSISTENCE_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<SuitesPersistenceRegistryImpl>;
     get(): Promise<SuitesPersistence>;
     getAll(): Promise<SuitesPersistence[]>;
     getEntries(): Promise<SuitesPersistenceLayer[]>;

package/dist/esm/persistence/suites/SuitesPersistenceRegistry.js

@@ -15,7 +15,13 @@ class SuitesPersistenceRegistryImpl {
     }
     static async fromEnvironment(environ, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
-        const donobuApiKey = environ.data.DONOBU_API_KEY;
+        // Persistence credential resolution: prefer the primary DONOBU_API_KEY
+        // (which also drives the inference fallback chain in
+        // DonobuFlowsManager.createGptClient), then fall back to the
+        // persistence-only DONOBU_PERSISTENCE_API_KEY for hosts that route
+        // inference through an explicit gpt-config and don't want their
+        // persistence credential to short-circuit the agent lookup.
+        const donobuApiKey = environ.data.DONOBU_API_KEY ?? environ.data.DONOBU_PERSISTENCE_API_KEY;
         const layers = [];
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
             switch (key) {

package/dist/esm/persistence/tests/TestsPersistenceDonobuApi.js

@@ -103,6 +103,9 @@ class TestsPersistenceDonobuApi extends DonobuApiClient_1.DonobuApiClient {
         // DB FK constraint.
         const response = await this.jsonRequest(`/v1/tests/${encodeURIComponent(testId)}`, 'DELETE');
         if (!response.ok) {
+            if (response.status === 404) {
+                throw TestNotFoundException_1.TestNotFoundException.forId(testId);
+            }
             throw new Error(`Failed to delete test: ${response.status} ${response.statusText}`);
         }
     }

package/dist/esm/persistence/tests/TestsPersistenceRegistry.d.ts

@@ -27,7 +27,7 @@ export interface TestsPersistenceRegistry {
 export declare class TestsPersistenceRegistryImpl implements TestsPersistenceRegistry {
     private readonly layers;
     constructor(layers: TestsPersistenceLayer[]);
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, 
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'DONOBU_PERSISTENCE_API_KEY' | 'PERSISTENCE_PRIORITY'>, 
     /**
      * Flows registry — used by the volatile tests layer to compute
      * flow-derived sort keys (flow_count, latest_flow_created_at).

package/dist/esm/persistence/tests/TestsPersistenceRegistry.js

@@ -22,7 +22,13 @@ class TestsPersistenceRegistryImpl {
      */
     flowsRegistry, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
-        const donobuApiKey = environ.data.DONOBU_API_KEY;
+        // Persistence credential resolution: prefer the primary DONOBU_API_KEY
+        // (which also drives the inference fallback chain in
+        // DonobuFlowsManager.createGptClient), then fall back to the
+        // persistence-only DONOBU_PERSISTENCE_API_KEY for hosts that route
+        // inference through an explicit gpt-config and don't want their
+        // persistence credential to short-circuit the agent lookup.
+        const donobuApiKey = environ.data.DONOBU_API_KEY ?? environ.data.DONOBU_PERSISTENCE_API_KEY;
         const layers = [];
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
             switch (key) {

package/dist/esm/persistence/tests/TestsPersistenceSqlite.js

@@ -151,7 +151,10 @@ class TestsPersistenceSqlite {
     async deleteTest(testId) {
         // Flows are cascade-deleted by the DB FK constraint.
         const stmt = this.db.prepare('DELETE FROM test_metadata WHERE id = ?');
-        stmt.run(testId);
+        const { changes } = stmt.run(testId);
+        if (changes === 0) {
+            throw TestNotFoundException_1.TestNotFoundException.forId(testId);
+        }
     }
 }
 exports.TestsPersistenceSqlite = TestsPersistenceSqlite;

package/dist/esm/persistence/tests/TestsPersistenceVolatile.js

@@ -124,7 +124,10 @@ class TestsPersistenceVolatile {
         };
     }
     async deleteTest(testId) {
-        this.tests.delete(testId);
+        const didExist = this.tests.delete(testId);
+        if (!didExist) {
+            throw TestNotFoundException_1.TestNotFoundException.forId(testId);
+        }
     }
 }
 exports.TestsPersistenceVolatile = TestsPersistenceVolatile;

package/dist/esm/reporter/render.js

@@ -64,14 +64,14 @@ function ansiToHtml(str) {
  * Read a few lines of source around `targetLine` (1-based) and return an HTML
  * snippet block, or null if the file is unreadable.
  */
-function readSourceSnippet(file, targetLine) {
+function readSourceSnippet(file, targetLine, wrapperClass = 'native-step-snippet') {
     try {
         const source = (0, fs_1.readFileSync)(file, 'utf8');
         const lines = source.split('\n');
         const context = 2;
         const start = Math.max(0, targetLine - 1 - context);
         const end = Math.min(lines.length - 1, targetLine - 1 + context);
-        let html = '<div class="native-step-snippet">';
+        let html = `<div class="${wrapperClass}">`;
         for (let i = start; i <= end; i++) {
             const lineNum = i + 1;
             const isTarget = lineNum === targetLine;
@@ -1515,6 +1515,26 @@ function renderHtml(report, triage, outputDir) {
         const lastResult = test.results.at(-1);
         const displayFileName = test.file.split('/').pop() ?? test.file;
         let detailsHtml = '';
+        // 0. Skip reason — surface the description and call site from
+        //    test.skip()/test.fixme() so a skipped test explains itself.
+        if (test.status === 'skipped') {
+            const skipAnnotation = test.annotations.find((a) => a.type === 'skip' || a.type === 'fixme');
+            const label = skipAnnotation?.type === 'fixme' ? 'Fixme reason' : 'Skip reason';
+            const description = skipAnnotation?.description?.trim();
+            const body = description
+                ? esc(description)
+                : 'No description was provided when this test was skipped. The reason may be implicit in the surrounding test code or condition.';
+            let locationHtml = '';
+            let snippetHtml = '';
+            const loc = skipAnnotation?.location;
+            if (loc?.file) {
+                const fileBase = (0, path_1.basename)(loc.file);
+                locationHtml = `<div class="skip-location">at <span class="skip-location-ref">${esc(fileBase)}:${loc.line}</span></div>`;
+                snippetHtml =
+                    readSourceSnippet(loc.file, loc.line, 'source-snippet') ?? '';
+            }
+            detailsHtml += `<div class="detail-section"><div class="detail-label">${label}</div><div class="detail-objective">${body}</div>${locationHtml}${snippetHtml}</div>`;
+        }
         // 1. AI analysis — why it failed (the headline)
         if (test.plan) {
             detailsHtml += renderFailureSummary(test.plan);
@@ -1824,6 +1844,11 @@ details.native-step>summary::-webkit-details-marker{display:none}
 details.native-step[open]>summary .native-step-chevron{transform:rotate(90deg)}
 .native-step-error{font-size:11px;font-family:var(--mono);padding:4px 0 2px 44px;margin:0;white-space:pre-wrap;word-break:break-word;color:var(--text-muted)}
 .native-step-snippet{font-size:11px;font-family:var(--mono);margin:4px 0 2px 44px;overflow:hidden}
+.skip-location{font-size:11px;color:var(--text-muted);margin-top:8px;font-family:var(--mono)}
+.skip-location-ref{color:var(--text)}
+.source-snippet{font-size:11px;font-family:var(--mono);margin:6px 0 0 0;overflow:hidden;border:1px solid var(--border-subtle);border-radius:var(--radius);padding:6px 0;background:var(--bg)}
+.source-snippet .snippet-line--target{background:rgba(255,127,58,.10)}
+.source-snippet .snippet-line--target .snippet-linenum{color:var(--orange,#FF7F3A)}
 .native-step-children{display:flex;flex-direction:column;margin:4px 0 0 10px;border-left:1px solid var(--border-subtle);padding-left:8px}
 .native-step-children>.filmstrip-step{padding-left:8px}
 

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', 'OLLAMA_API_URL', 'OLLAMA_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', 'DONOBU_PERSISTENCE_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/main.d.ts

@@ -105,6 +105,7 @@ export declare function startDonobuServer({ port, controlPanelHost, environ, }?:
         AWS_ACCESS_KEY_ID: z.ZodOptional<z.ZodString>;
         AWS_SECRET_ACCESS_KEY: z.ZodOptional<z.ZodString>;
         DONOBU_API_KEY: z.ZodOptional<z.ZodString>;
+        DONOBU_PERSISTENCE_API_KEY: z.ZodOptional<z.ZodString>;
     }, {
         BASE64_GPT_CONFIG?: string | undefined;
         BROWSERBASE_API_KEY?: string | undefined;
@@ -124,6 +125,7 @@ export declare function startDonobuServer({ port, controlPanelHost, environ, }?:
         AWS_ACCESS_KEY_ID?: string | undefined;
         AWS_SECRET_ACCESS_KEY?: string | undefined;
         DONOBU_API_KEY?: string | undefined;
+        DONOBU_PERSISTENCE_API_KEY?: string | undefined;
     }> | undefined;
 }): Promise<void>;
 //# sourceMappingURL=main.d.ts.map

package/dist/main.js

@@ -113,7 +113,7 @@ const DEFAULT_PORT = 31000;
  * Starts a Donobu API server at the given port. The server assumes that the
  * Playwright browsers have been installed.
  */
-async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, 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_DEPLOYMENT_ENVIRONMENT', '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'), } = {}) {
+async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, 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_DEPLOYMENT_ENVIRONMENT', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'DONOBU_PERSISTENCE_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'), } = {}) {
     try {
         const adminController = await AdminApiController_1.AdminApiController.create(environ.data.DONOBU_DEPLOYMENT_ENVIRONMENT ?? 'LOCAL', controlPanelHost, environ);
         await adminController.start(port);

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' | 'OLLAMA_API_URL' | 'OLLAMA_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' | 'DONOBU_PERSISTENCE_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();
     /**
      * Binds the API/web-asset server to `port` and resolves once the socket is

package/dist/managers/DonobuStack.d.ts

@@ -60,6 +60,7 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     AWS_ACCESS_KEY_ID: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     AWS_SECRET_ACCESS_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
     DONOBU_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+    DONOBU_PERSISTENCE_API_KEY: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
 }, {
     BASE64_GPT_CONFIG?: string | undefined;
     BROWSERBASE_API_KEY?: string | undefined;
@@ -78,5 +79,6 @@ export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDepl
     AWS_ACCESS_KEY_ID?: string | undefined;
     AWS_SECRET_ACCESS_KEY?: string | undefined;
     DONOBU_API_KEY?: string | undefined;
+    DONOBU_PERSISTENCE_API_KEY?: string | undefined;
 }>): Promise<DonobuStack>;
 //# sourceMappingURL=DonobuStack.d.ts.map

package/dist/managers/DonobuStack.js

@@ -33,7 +33,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', 'OLLAMA_API_URL', 'OLLAMA_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', 'DONOBU_PERSISTENCE_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/managers/TestsManager.js

@@ -174,8 +174,11 @@ class TestsManager {
             try {
                 await persistence.deleteTest(testId);
             }
-            catch {
-                // Ignore errors from layers that don't have this test.
+            catch (e) {
+                // Ignore TestNotFoundException errors from layers that don't have this test.
+                if (!(e instanceof TestNotFoundException_1.TestNotFoundException)) {
+                    throw e;
+                }
             }
         }
         // Cascade-delete flows belonging to this test. Paginate through all flows

package/dist/persistence/DonobuApiClient.js

@@ -24,7 +24,7 @@ class DonobuApiClient {
     async jsonRequest(path, method, body) {
         return this.request(path, {
             method,
-            headers: { 'Content-Type': 'application/json' },
+            headers: body !== undefined ? { 'Content-Type': 'application/json' } : {},
             body: body !== undefined ? JSON.stringify(body) : undefined,
         });
     }

package/dist/persistence/flows/FlowsPersistenceRegistry.d.ts

@@ -46,7 +46,7 @@ export declare class FlowsPersistenceRegistryImpl implements FlowsPersistenceReg
      * Creates an instance by reading environment variables and eagerly constructing
      * all applicable persistence layers.
      */
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<FlowsPersistenceRegistryImpl>;
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'DONOBU_PERSISTENCE_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<FlowsPersistenceRegistryImpl>;
     /**
      * Returns the primary persistence layer.
      */

package/dist/persistence/flows/FlowsPersistenceRegistry.js

@@ -26,7 +26,13 @@ class FlowsPersistenceRegistryImpl {
      */
     static async fromEnvironment(environ, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
-        const donobuApiKey = environ.data.DONOBU_API_KEY;
+        // Persistence credential resolution: prefer the primary DONOBU_API_KEY
+        // (which also drives the inference fallback chain in
+        // DonobuFlowsManager.createGptClient), then fall back to the
+        // persistence-only DONOBU_PERSISTENCE_API_KEY for hosts that route
+        // inference through an explicit gpt-config and don't want their
+        // persistence credential to short-circuit the agent lookup.
+        const donobuApiKey = environ.data.DONOBU_API_KEY ?? environ.data.DONOBU_PERSISTENCE_API_KEY;
         const layers = [];
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
             switch (key) {

package/dist/persistence/suites/SuitesPersistenceRegistry.d.ts

@@ -26,7 +26,7 @@ export interface SuitesPersistenceRegistry {
 export declare class SuitesPersistenceRegistryImpl implements SuitesPersistenceRegistry {
     private readonly layers;
     constructor(layers: SuitesPersistenceLayer[]);
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<SuitesPersistenceRegistryImpl>;
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'DONOBU_PERSISTENCE_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<SuitesPersistenceRegistryImpl>;
     get(): Promise<SuitesPersistence>;
     getAll(): Promise<SuitesPersistence[]>;
     getEntries(): Promise<SuitesPersistenceLayer[]>;

package/dist/persistence/suites/SuitesPersistenceRegistry.js

@@ -15,7 +15,13 @@ class SuitesPersistenceRegistryImpl {
     }
     static async fromEnvironment(environ, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
-        const donobuApiKey = environ.data.DONOBU_API_KEY;
+        // Persistence credential resolution: prefer the primary DONOBU_API_KEY
+        // (which also drives the inference fallback chain in
+        // DonobuFlowsManager.createGptClient), then fall back to the
+        // persistence-only DONOBU_PERSISTENCE_API_KEY for hosts that route
+        // inference through an explicit gpt-config and don't want their
+        // persistence credential to short-circuit the agent lookup.
+        const donobuApiKey = environ.data.DONOBU_API_KEY ?? environ.data.DONOBU_PERSISTENCE_API_KEY;
         const layers = [];
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
             switch (key) {

package/dist/persistence/tests/TestsPersistenceDonobuApi.js

@@ -103,6 +103,9 @@ class TestsPersistenceDonobuApi extends DonobuApiClient_1.DonobuApiClient {
         // DB FK constraint.
         const response = await this.jsonRequest(`/v1/tests/${encodeURIComponent(testId)}`, 'DELETE');
         if (!response.ok) {
+            if (response.status === 404) {
+                throw TestNotFoundException_1.TestNotFoundException.forId(testId);
+            }
             throw new Error(`Failed to delete test: ${response.status} ${response.statusText}`);
         }
     }

package/dist/persistence/tests/TestsPersistenceRegistry.d.ts

@@ -27,7 +27,7 @@ export interface TestsPersistenceRegistry {
 export declare class TestsPersistenceRegistryImpl implements TestsPersistenceRegistry {
     private readonly layers;
     constructor(layers: TestsPersistenceLayer[]);
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, 
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'DONOBU_PERSISTENCE_API_KEY' | 'PERSISTENCE_PRIORITY'>, 
     /**
      * Flows registry — used by the volatile tests layer to compute
      * flow-derived sort keys (flow_count, latest_flow_created_at).

package/dist/persistence/tests/TestsPersistenceRegistry.js

@@ -22,7 +22,13 @@ class TestsPersistenceRegistryImpl {
      */
     flowsRegistry, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
-        const donobuApiKey = environ.data.DONOBU_API_KEY;
+        // Persistence credential resolution: prefer the primary DONOBU_API_KEY
+        // (which also drives the inference fallback chain in
+        // DonobuFlowsManager.createGptClient), then fall back to the
+        // persistence-only DONOBU_PERSISTENCE_API_KEY for hosts that route
+        // inference through an explicit gpt-config and don't want their
+        // persistence credential to short-circuit the agent lookup.
+        const donobuApiKey = environ.data.DONOBU_API_KEY ?? environ.data.DONOBU_PERSISTENCE_API_KEY;
         const layers = [];
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
             switch (key) {

package/dist/persistence/tests/TestsPersistenceSqlite.js

@@ -151,7 +151,10 @@ class TestsPersistenceSqlite {
     async deleteTest(testId) {
         // Flows are cascade-deleted by the DB FK constraint.
         const stmt = this.db.prepare('DELETE FROM test_metadata WHERE id = ?');
-        stmt.run(testId);
+        const { changes } = stmt.run(testId);
+        if (changes === 0) {
+            throw TestNotFoundException_1.TestNotFoundException.forId(testId);
+        }
     }
 }
 exports.TestsPersistenceSqlite = TestsPersistenceSqlite;

package/dist/persistence/tests/TestsPersistenceVolatile.js

@@ -124,7 +124,10 @@ class TestsPersistenceVolatile {
         };
     }
     async deleteTest(testId) {
-        this.tests.delete(testId);
+        const didExist = this.tests.delete(testId);
+        if (!didExist) {
+            throw TestNotFoundException_1.TestNotFoundException.forId(testId);
+        }
     }
 }
 exports.TestsPersistenceVolatile = TestsPersistenceVolatile;

package/dist/reporter/render.js

@@ -64,14 +64,14 @@ function ansiToHtml(str) {
  * Read a few lines of source around `targetLine` (1-based) and return an HTML
  * snippet block, or null if the file is unreadable.
  */
-function readSourceSnippet(file, targetLine) {
+function readSourceSnippet(file, targetLine, wrapperClass = 'native-step-snippet') {
     try {
         const source = (0, fs_1.readFileSync)(file, 'utf8');
         const lines = source.split('\n');
         const context = 2;
         const start = Math.max(0, targetLine - 1 - context);
         const end = Math.min(lines.length - 1, targetLine - 1 + context);
-        let html = '<div class="native-step-snippet">';
+        let html = `<div class="${wrapperClass}">`;
         for (let i = start; i <= end; i++) {
             const lineNum = i + 1;
             const isTarget = lineNum === targetLine;
@@ -1515,6 +1515,26 @@ function renderHtml(report, triage, outputDir) {
         const lastResult = test.results.at(-1);
         const displayFileName = test.file.split('/').pop() ?? test.file;
         let detailsHtml = '';
+        // 0. Skip reason — surface the description and call site from
+        //    test.skip()/test.fixme() so a skipped test explains itself.
+        if (test.status === 'skipped') {
+            const skipAnnotation = test.annotations.find((a) => a.type === 'skip' || a.type === 'fixme');
+            const label = skipAnnotation?.type === 'fixme' ? 'Fixme reason' : 'Skip reason';
+            const description = skipAnnotation?.description?.trim();
+            const body = description
+                ? esc(description)
+                : 'No description was provided when this test was skipped. The reason may be implicit in the surrounding test code or condition.';
+            let locationHtml = '';
+            let snippetHtml = '';
+            const loc = skipAnnotation?.location;
+            if (loc?.file) {
+                const fileBase = (0, path_1.basename)(loc.file);
+                locationHtml = `<div class="skip-location">at <span class="skip-location-ref">${esc(fileBase)}:${loc.line}</span></div>`;
+                snippetHtml =
+                    readSourceSnippet(loc.file, loc.line, 'source-snippet') ?? '';
+            }
+            detailsHtml += `<div class="detail-section"><div class="detail-label">${label}</div><div class="detail-objective">${body}</div>${locationHtml}${snippetHtml}</div>`;
+        }
         // 1. AI analysis — why it failed (the headline)
         if (test.plan) {
             detailsHtml += renderFailureSummary(test.plan);
@@ -1824,6 +1844,11 @@ details.native-step>summary::-webkit-details-marker{display:none}
 details.native-step[open]>summary .native-step-chevron{transform:rotate(90deg)}
 .native-step-error{font-size:11px;font-family:var(--mono);padding:4px 0 2px 44px;margin:0;white-space:pre-wrap;word-break:break-word;color:var(--text-muted)}
 .native-step-snippet{font-size:11px;font-family:var(--mono);margin:4px 0 2px 44px;overflow:hidden}
+.skip-location{font-size:11px;color:var(--text-muted);margin-top:8px;font-family:var(--mono)}
+.skip-location-ref{color:var(--text)}
+.source-snippet{font-size:11px;font-family:var(--mono);margin:6px 0 0 0;overflow:hidden;border:1px solid var(--border-subtle);border-radius:var(--radius);padding:6px 0;background:var(--bg)}
+.source-snippet .snippet-line--target{background:rgba(255,127,58,.10)}
+.source-snippet .snippet-line--target .snippet-linenum{color:var(--orange,#FF7F3A)}
 .native-step-children{display:flex;flex-direction:column;margin:4px 0 0 10px;border-left:1px solid var(--border-subtle);padding-left:8px}
 .native-step-children>.filmstrip-step{padding-left:8px}
 

package/package.json

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