donobu 5.21.5 → 5.21.7

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/esm/tools/InputTextTool.d.ts

@@ -31,6 +31,11 @@ export declare class InputTextTool extends ReplayableInteraction<typeof InputTex
         target: ElementHandle<HTMLElement | SVGElement>;
         label?: ElementHandle<HTMLElement | SVGElement>;
     }): Promise<string>;
+    /**
+     * Returns true when the segment is a single character that Playwright's
+     * keyboard.press() can handle: printable ASCII (space through tilde).
+     */
+    private static isKeyboardPressable;
     private clearField;
 }
 //# sourceMappingURL=InputTextTool.d.ts.map

package/dist/esm/tools/InputTextTool.js

@@ -43,10 +43,24 @@ class InputTextTool extends ReplayableInteraction_1.ReplayableInteraction {
         await element.focus();
         const page = (0, TargetUtils_1.webPage)(context);
         await context.interactionVisualizer.pointAt(page, element);
-        for (const char of parameters.text) {
-            await page.keyboard.press(char, {
-                delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
-            });
+        // Segment into grapheme clusters so that composite characters (e.g. ZWJ
+        // emoji sequences like 👨‍👩‍👧, flags, skin-tone variants) are kept intact.
+        const segmenter = new Intl.Segmenter(undefined, {
+            granularity: 'grapheme',
+        });
+        for (const { segment } of segmenter.segment(parameters.text)) {
+            if (InputTextTool.isKeyboardPressable(segment)) {
+                // Single typeable character — use press() for realistic keydown/keyup.
+                await page.keyboard.press(segment, {
+                    delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(segment),
+                });
+            }
+            else {
+                // Multi-code-point cluster or character Playwright can't press (e.g.
+                // em-dash, smart quotes, emojis). Insert directly, mimicking a
+                // virtual keyboard or input method.
+                await page.keyboard.insertText(segment);
+            }
         }
         // Submit if requested
         if (parameters.finalizeWithSubmit) {
@@ -57,6 +71,13 @@ class InputTextTool extends ReplayableInteraction_1.ReplayableInteraction {
         }
         return `Inputted text '${parameters.text}' into: `;
     }
+    /**
+     * Returns true when the segment is a single character that Playwright's
+     * keyboard.press() can handle: printable ASCII (space through tilde).
+     */
+    static isKeyboardPressable(segment) {
+        return segment.length === 1 && segment >= ' ' && segment <= '~';
+    }
     async clearField(element) {
         try {
             const value = await element.inputValue();

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/dist/tools/InputTextTool.d.ts

@@ -31,6 +31,11 @@ export declare class InputTextTool extends ReplayableInteraction<typeof InputTex
         target: ElementHandle<HTMLElement | SVGElement>;
         label?: ElementHandle<HTMLElement | SVGElement>;
     }): Promise<string>;
+    /**
+     * Returns true when the segment is a single character that Playwright's
+     * keyboard.press() can handle: printable ASCII (space through tilde).
+     */
+    private static isKeyboardPressable;
     private clearField;
 }
 //# sourceMappingURL=InputTextTool.d.ts.map

package/dist/tools/InputTextTool.js

@@ -43,10 +43,24 @@ class InputTextTool extends ReplayableInteraction_1.ReplayableInteraction {
         await element.focus();
         const page = (0, TargetUtils_1.webPage)(context);
         await context.interactionVisualizer.pointAt(page, element);
-        for (const char of parameters.text) {
-            await page.keyboard.press(char, {
-                delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(char),
-            });
+        // Segment into grapheme clusters so that composite characters (e.g. ZWJ
+        // emoji sequences like 👨‍👩‍👧, flags, skin-tone variants) are kept intact.
+        const segmenter = new Intl.Segmenter(undefined, {
+            granularity: 'grapheme',
+        });
+        for (const { segment } of segmenter.segment(parameters.text)) {
+            if (InputTextTool.isKeyboardPressable(segment)) {
+                // Single typeable character — use press() for realistic keydown/keyup.
+                await page.keyboard.press(segment, {
+                    delay: MiscUtils_1.MiscUtils.generateHumanLikeKeyPressDurationInMs(segment),
+                });
+            }
+            else {
+                // Multi-code-point cluster or character Playwright can't press (e.g.
+                // em-dash, smart quotes, emojis). Insert directly, mimicking a
+                // virtual keyboard or input method.
+                await page.keyboard.insertText(segment);
+            }
         }
         // Submit if requested
         if (parameters.finalizeWithSubmit) {
@@ -57,6 +71,13 @@ class InputTextTool extends ReplayableInteraction_1.ReplayableInteraction {
         }
         return `Inputted text '${parameters.text}' into: `;
     }
+    /**
+     * Returns true when the segment is a single character that Playwright's
+     * keyboard.press() can handle: printable ASCII (space through tilde).
+     */
+    static isKeyboardPressable(segment) {
+        return segment.length === 1 && segment >= ' ' && segment <= '~';
+    }
     async clearField(element) {
         try {
             const value = await element.inputValue();

package/package.json

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