donobu 5.21.6 → 5.21.8

package/dist/clients/DonobuGptClient.d.ts

@@ -8,8 +8,9 @@ import { GptClient } from './GptClient';
  */
 export declare class DonobuGptClient extends GptClient {
     private readonly delegate;
+    private readonly apiUrl;
     constructor(donobuGptClientConfig: DonobuGptClientConfig, apiUrl?: string);
-    ping(_options?: {
+    ping(options?: {
         signal?: AbortSignal;
     }): Promise<void>;
     getMessage(messages: GptMessage[], options?: {

package/dist/clients/DonobuGptClient.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DonobuGptClient = void 0;
 const v4_1 = require("zod/v4");
 const envVars_1 = require("../envVars");
+const GptPlatformAuthenticationFailedException_1 = require("../exceptions/GptPlatformAuthenticationFailedException");
 const GoogleGenerativeAiGptClient_1 = require("./GoogleGenerativeAiGptClient");
 const GptClient_1 = require("./GptClient");
 const OpenAiGptClient_1 = require("./OpenAiGptClient");
@@ -12,14 +13,26 @@ const OpenAiGptClient_1 = require("./OpenAiGptClient");
 class DonobuGptClient extends GptClient_1.GptClient {
     constructor(donobuGptClientConfig, apiUrl = envVars_1.env.data.DONOBU_API_BASE_URL) {
         super(donobuGptClientConfig);
+        this.apiUrl = apiUrl;
         this.delegate = new OpenAiGptClient_1.OpenAiGptClient({
             type: 'OPENAI',
             modelName: '',
             apiKey: donobuGptClientConfig.apiKey,
         }, apiUrl);
     }
-    async ping(_options) {
-        return;
+    async ping(options) {
+        const donobuConfig = this.config;
+        const resp = await fetch(`${this.apiUrl}/v1/flows?limit=1`, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${donobuConfig.apiKey}` },
+            signal: options?.signal,
+        });
+        if (resp.status === 401) {
+            throw new GptPlatformAuthenticationFailedException_1.GptPlatformAuthenticationFailedException(this.config.type);
+        }
+        else if (!resp.ok) {
+            throw new Error(`Donobu API ping failed with status ${resp.status}: ${await resp.text()}`);
+        }
     }
     async getMessage(messages, options) {
         return this.delegate.getMessage(messages, options);

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

@@ -8,8 +8,9 @@ import { GptClient } from './GptClient';
  */
 export declare class DonobuGptClient extends GptClient {
     private readonly delegate;
+    private readonly apiUrl;
     constructor(donobuGptClientConfig: DonobuGptClientConfig, apiUrl?: string);
-    ping(_options?: {
+    ping(options?: {
         signal?: AbortSignal;
     }): Promise<void>;
     getMessage(messages: GptMessage[], options?: {

package/dist/esm/clients/DonobuGptClient.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DonobuGptClient = void 0;
 const v4_1 = require("zod/v4");
 const envVars_1 = require("../envVars");
+const GptPlatformAuthenticationFailedException_1 = require("../exceptions/GptPlatformAuthenticationFailedException");
 const GoogleGenerativeAiGptClient_1 = require("./GoogleGenerativeAiGptClient");
 const GptClient_1 = require("./GptClient");
 const OpenAiGptClient_1 = require("./OpenAiGptClient");
@@ -12,14 +13,26 @@ const OpenAiGptClient_1 = require("./OpenAiGptClient");
 class DonobuGptClient extends GptClient_1.GptClient {
     constructor(donobuGptClientConfig, apiUrl = envVars_1.env.data.DONOBU_API_BASE_URL) {
         super(donobuGptClientConfig);
+        this.apiUrl = apiUrl;
         this.delegate = new OpenAiGptClient_1.OpenAiGptClient({
             type: 'OPENAI',
             modelName: '',
             apiKey: donobuGptClientConfig.apiKey,
         }, apiUrl);
     }
-    async ping(_options) {
-        return;
+    async ping(options) {
+        const donobuConfig = this.config;
+        const resp = await fetch(`${this.apiUrl}/v1/flows?limit=1`, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${donobuConfig.apiKey}` },
+            signal: options?.signal,
+        });
+        if (resp.status === 401) {
+            throw new GptPlatformAuthenticationFailedException_1.GptPlatformAuthenticationFailedException(this.config.type);
+        }
+        else if (!resp.ok) {
+            throw new Error(`Donobu API ping failed with status ${resp.status}: ${await resp.text()}`);
+        }
     }
     async getMessage(messages, options) {
         return this.delegate.getMessage(messages, options);

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

@@ -27,7 +27,6 @@ export declare const PlaywrightAssertionStepSchema: z.ZodObject<{
         toHaveURL: "toHaveURL";
     }>;
     attributeValue: z.ZodNullable<z.ZodString>;
-    useFirst: z.ZodBoolean;
 }, z.core.$strip>;
 export type PlaywrightAssertionStep = z.infer<typeof PlaywrightAssertionStepSchema>;
 export type AssertCacheExecutor = (context: {

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

@@ -81,10 +81,6 @@ Common roles: 'heading', 'button', 'link', 'tab', 'tabpanel', 'dialog', 'navigat
 - toHaveAttribute: set to the expected attribute value (e.g. "true" when value="aria-selected")
 - toContainText: set to the text substring to match within the element
 - All other assertions: set to null`),
-    /** Whether to narrow to the first match via .first() when the locator might match multiple elements. */
-    useFirst: v4_1.z
-        .boolean()
-        .describe('Set to true to call .first() on the locator when the selector might match multiple elements.'),
 });
 /**
  * Builds an executor function from structured assertion steps.

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

@@ -50,17 +50,6 @@ export declare class DonobuFlowsManager {
     private readonly flowRuntime;
     private readonly flowCatalog;
     constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry);
-    /**
-     * Create a flow with the given parameters and invoke its `DonobuFlow#run`
-     * method, adding it to list of active flows.
-     *
-     * @param gptClient If present, will use this as the associated GPT client for
-     *          this flow instead of instantiating a new one. If so, the
-     *          gptConfigNameOverride field will be ignored.
-     * @param browserContextOverride If present, will use this as the browser
-     *          context instead of instantiating a new one. If so, most browser
-     *          related parameters are will be ignored.
-     */
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.

package/dist/esm/managers/DonobuFlowsManager.js

@@ -87,17 +87,6 @@ class DonobuFlowsManager {
         this.flowRuntime = new FlowRuntime_1.FlowRuntime();
         this.flowCatalog = new FlowCatalog_1.FlowCatalog(this.flowsPersistenceRegistry, this.flowRuntime, this.deploymentEnvironment);
     }
-    /**
-     * Create a flow with the given parameters and invoke its `DonobuFlow#run`
-     * method, adding it to list of active flows.
-     *
-     * @param gptClient If present, will use this as the associated GPT client for
-     *          this flow instead of instantiating a new one. If so, the
-     *          gptConfigNameOverride field will be ignored.
-     * @param browserContextOverride If present, will use this as the browser
-     *          context instead of instantiating a new one. If so, most browser
-     *          related parameters are will be ignored.
-     */
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.

package/dist/esm/tools/AssertTool.js

@@ -69,26 +69,30 @@ checking vibes, tone, relying on screenshots, etc) to express as a combination o
 
 Examples of how assertions map to steps:
 - "Organization Settings heading is visible" →
-    [{ locator: "role", role: "heading", value: "Organization Settings", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "heading", value: "Organization Settings", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null }]
 - "Create Template button is visible" →
-    [{ locator: "role", role: "button", value: "Create Template", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "button", value: "Create Template", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null }]
 - "pagination shows Page 2 of N" →
-    [{ locator: "text", role: null, value: "Page 2 of \\\\d+", valueIsRegex: true, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "text", role: null, value: "Page 2 of \\\\d+", valueIsRegex: true, assertion: "toBeVisible", attributeValue: null }]
 - "Programs and Templates tabs are visible" →
-    [{ locator: "role", role: "tab", value: "Programs", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false },
-     { locator: "role", role: "tab", value: "Templates", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "tab", value: "Programs", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null },
+     { locator: "role", role: "tab", value: "Templates", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null }]
 - "template X is NOT listed" →
-    [{ locator: "text", role: null, value: "X", valueIsRegex: false, assertion: "toBeHidden", attributeValue: null, useFirst: false }]
+    [{ locator: "text", role: null, value: "X", valueIsRegex: false, assertion: "toBeHidden", attributeValue: null }]
 - "Next Page is disabled" →
-    [{ locator: "role", role: "button", value: "Next Page", valueIsRegex: false, assertion: "toBeDisabled", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "button", value: "Next Page", valueIsRegex: false, assertion: "toBeDisabled", attributeValue: null }]
 - "The JSON Configuration radio button is selected" →
-    [{ locator: "role", role: "radio", value: "JSON Configuration", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "radio", value: "JSON Configuration", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null }]
 - "The 'Use installed app' toggle is on" →
-    [{ locator: "label", role: null, value: "Use installed app", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null, useFirst: false }]
+    [{ locator: "label", role: null, value: "Use installed app", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null }]
 - "The Device Name field contains 'My Device Name'" →
-    [{ locator: "label", role: null, value: "Device Name", valueIsRegex: false, assertion: "toHaveValue", attributeValue: "My Device Name", useFirst: false }]
+    [{ locator: "label", role: null, value: "Device Name", valueIsRegex: false, assertion: "toHaveValue", attributeValue: "My Device Name" }]
 - "The Assert Page tool is selected" →
-    [{ locator: "role", role: "tab", value: "Assert Page", valueIsRegex: false, assertion: "toHaveAttribute", attributeValue: "true", useFirst: false }]`),
+    [{ locator: "role", role: "tab", value: "Assert Page", valueIsRegex: false, assertion: "toHaveAttribute", attributeValue: "true" }]
+- "The current URL path is the settings page" →
+    [{ locator: "text", role: null, value: ".+/settings/general/?$", valueIsRegex: true, assertion: "toHaveURL", attributeValue: null }]
+- "The current URL path is for a user" →
+    [{ locator: "text", role: null, value: ".+/users/[\\d]+/?$", valueIsRegex: true, assertion: "toHaveURL", attributeValue: null }]`),
 });
 class AssertTool extends Tool_1.Tool {
     constructor() {

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

@@ -27,7 +27,6 @@ export declare const PlaywrightAssertionStepSchema: z.ZodObject<{
         toHaveURL: "toHaveURL";
     }>;
     attributeValue: z.ZodNullable<z.ZodString>;
-    useFirst: z.ZodBoolean;
 }, z.core.$strip>;
 export type PlaywrightAssertionStep = z.infer<typeof PlaywrightAssertionStepSchema>;
 export type AssertCacheExecutor = (context: {

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

@@ -81,10 +81,6 @@ Common roles: 'heading', 'button', 'link', 'tab', 'tabpanel', 'dialog', 'navigat
 - toHaveAttribute: set to the expected attribute value (e.g. "true" when value="aria-selected")
 - toContainText: set to the text substring to match within the element
 - All other assertions: set to null`),
-    /** Whether to narrow to the first match via .first() when the locator might match multiple elements. */
-    useFirst: v4_1.z
-        .boolean()
-        .describe('Set to true to call .first() on the locator when the selector might match multiple elements.'),
 });
 /**
  * Builds an executor function from structured assertion steps.

package/dist/managers/DonobuFlowsManager.d.ts

@@ -50,17 +50,6 @@ export declare class DonobuFlowsManager {
     private readonly flowRuntime;
     private readonly flowCatalog;
     constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry);
-    /**
-     * Create a flow with the given parameters and invoke its `DonobuFlow#run`
-     * method, adding it to list of active flows.
-     *
-     * @param gptClient If present, will use this as the associated GPT client for
-     *          this flow instead of instantiating a new one. If so, the
-     *          gptConfigNameOverride field will be ignored.
-     * @param browserContextOverride If present, will use this as the browser
-     *          context instead of instantiating a new one. If so, most browser
-     *          related parameters are will be ignored.
-     */
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.

package/dist/managers/DonobuFlowsManager.js

@@ -87,17 +87,6 @@ class DonobuFlowsManager {
         this.flowRuntime = new FlowRuntime_1.FlowRuntime();
         this.flowCatalog = new FlowCatalog_1.FlowCatalog(this.flowsPersistenceRegistry, this.flowRuntime, this.deploymentEnvironment);
     }
-    /**
-     * Create a flow with the given parameters and invoke its `DonobuFlow#run`
-     * method, adding it to list of active flows.
-     *
-     * @param gptClient If present, will use this as the associated GPT client for
-     *          this flow instead of instantiating a new one. If so, the
-     *          gptConfigNameOverride field will be ignored.
-     * @param browserContextOverride If present, will use this as the browser
-     *          context instead of instantiating a new one. If so, most browser
-     *          related parameters are will be ignored.
-     */
     /**
      * Create a flow with the given parameters and invoke its `DonobuFlow#run`
      * method, adding it to list of active flows.

package/dist/tools/AssertTool.js

@@ -69,26 +69,30 @@ checking vibes, tone, relying on screenshots, etc) to express as a combination o
 
 Examples of how assertions map to steps:
 - "Organization Settings heading is visible" →
-    [{ locator: "role", role: "heading", value: "Organization Settings", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "heading", value: "Organization Settings", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null }]
 - "Create Template button is visible" →
-    [{ locator: "role", role: "button", value: "Create Template", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "button", value: "Create Template", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null }]
 - "pagination shows Page 2 of N" →
-    [{ locator: "text", role: null, value: "Page 2 of \\\\d+", valueIsRegex: true, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "text", role: null, value: "Page 2 of \\\\d+", valueIsRegex: true, assertion: "toBeVisible", attributeValue: null }]
 - "Programs and Templates tabs are visible" →
-    [{ locator: "role", role: "tab", value: "Programs", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false },
-     { locator: "role", role: "tab", value: "Templates", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "tab", value: "Programs", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null },
+     { locator: "role", role: "tab", value: "Templates", valueIsRegex: false, assertion: "toBeVisible", attributeValue: null }]
 - "template X is NOT listed" →
-    [{ locator: "text", role: null, value: "X", valueIsRegex: false, assertion: "toBeHidden", attributeValue: null, useFirst: false }]
+    [{ locator: "text", role: null, value: "X", valueIsRegex: false, assertion: "toBeHidden", attributeValue: null }]
 - "Next Page is disabled" →
-    [{ locator: "role", role: "button", value: "Next Page", valueIsRegex: false, assertion: "toBeDisabled", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "button", value: "Next Page", valueIsRegex: false, assertion: "toBeDisabled", attributeValue: null }]
 - "The JSON Configuration radio button is selected" →
-    [{ locator: "role", role: "radio", value: "JSON Configuration", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null, useFirst: false }]
+    [{ locator: "role", role: "radio", value: "JSON Configuration", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null }]
 - "The 'Use installed app' toggle is on" →
-    [{ locator: "label", role: null, value: "Use installed app", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null, useFirst: false }]
+    [{ locator: "label", role: null, value: "Use installed app", valueIsRegex: false, assertion: "toBeChecked", attributeValue: null }]
 - "The Device Name field contains 'My Device Name'" →
-    [{ locator: "label", role: null, value: "Device Name", valueIsRegex: false, assertion: "toHaveValue", attributeValue: "My Device Name", useFirst: false }]
+    [{ locator: "label", role: null, value: "Device Name", valueIsRegex: false, assertion: "toHaveValue", attributeValue: "My Device Name" }]
 - "The Assert Page tool is selected" →
-    [{ locator: "role", role: "tab", value: "Assert Page", valueIsRegex: false, assertion: "toHaveAttribute", attributeValue: "true", useFirst: false }]`),
+    [{ locator: "role", role: "tab", value: "Assert Page", valueIsRegex: false, assertion: "toHaveAttribute", attributeValue: "true" }]
+- "The current URL path is the settings page" →
+    [{ locator: "text", role: null, value: ".+/settings/general/?$", valueIsRegex: true, assertion: "toHaveURL", attributeValue: null }]
+- "The current URL path is for a user" →
+    [{ locator: "text", role: null, value: ".+/users/[\\d]+/?$", valueIsRegex: true, assertion: "toHaveURL", attributeValue: null }]`),
 });
 class AssertTool extends Tool_1.Tool {
     constructor() {

package/package.json

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