dhalsim 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zbigniew Sobiecki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+<img src="dhalsim-icon.png" width="120" align="right" alt="dhalsim" />
+
+# dhalsim
+
+[![npm version](https://img.shields.io/npm/v/dhalsim.svg)](https://www.npmjs.com/package/dhalsim)
+[![CI](https://github.com/zbigniewsobiecki/dhalsim/actions/workflows/ci.yml/badge.svg)](https://github.com/zbigniewsobiecki/dhalsim/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Browser automation gadgets for [llmist](https://llmist.dev) agents using [Camoufox](https://camoufox.com) anti-detect browser.
+
+## Using with llmist CLI
+
+Use dhalsim gadgets directly from the command line for quick tasks and testing.
+
+### Quick Start
+
+```bash
+# Use the BrowseWeb subagent
+bunx @llmist/cli agent "go to apple.com and find iPhone 16 Pro price" -g dhalsim:subagent
+
+# Use all gadgets (for custom agent workflows)
+bunx @llmist/cli agent "navigate to example.com" -g dhalsim
+
+# Use readonly preset
+bunx @llmist/cli agent "take a screenshot of google.com" -g dhalsim:readonly
+
+# Use latest dev from GitHub (with BrowseWeb subagent)
+bunx @llmist/cli agent "search google for llmist" -g git+https://github.com/zbigniewsobiecki/dhalsim.git#dev:subagent
+```
+
+### Configuration
+
+Configure BrowseWeb subagent in `~/.llmist/cli.toml`:
+
+```toml
+[subagents.BrowseWeb]
+model = "sonnet"           # LLM model for the subagent (default: sonnet)
+maxIterations = 20         # Max agent loop iterations (default: 15)
+headless = true            # Run browser in headless mode (default: true)
+```
+
+#### Per-profile configuration
+
+```toml
+[develop.subagents.BrowseWeb]
+headless = false           # Show browser during development
+
+[research.subagents.BrowseWeb]
+maxIterations = 30         # More iterations for deep research
+```
+
+#### Using "inherit" for model
+
+```toml
+[subagents.BrowseWeb]
+model = "inherit"          # Use parent agent's model
+```
+
+### Custom Commands in cli.toml
+
+```toml
+[my-research-command]
+gadgets = [
+  "dhalsim:subagent",                                                  # from npm
+  "git+https://github.com/zbigniewsobiecki/dhalsim.git#dev:subagent",  # from git
+]
+```
+
+---
+
+## Using in Projects
+
+Install dhalsim as a dependency and use gadgets programmatically.
+
+### Installation
+
+```bash
+npm install dhalsim
+# or
+bun add dhalsim
+```
+
+### Using Dhalsim Subagent
+
+```typescript
+import { LLMist } from 'llmist';
+import { Dhalsim } from 'dhalsim';
+
+const result = await LLMist.createAgent()
+  .withModel('sonnet')
+  .withGadgets(new Dhalsim())
+  .askAndCollect('Go to google.com and search for "playwright"');
+```
+
+### Using Individual Gadgets
+
+```typescript
+import { LLMist } from 'llmist';
+import { createGadgetsByPreset } from 'dhalsim';
+
+const gadgets = createGadgetsByPreset('all');
+
+const agent = LLMist.createAgent()
+  .withGadgets(...gadgets)
+  .ask('Navigate to example.com and take a screenshot');
+
+for await (const event of agent.run()) {
+  // handle events
+}
+```
+
+---
+
+## Presets
+
+- `all` (default) - All gadgets
+- `readonly` - Navigate, Screenshot, GetFullPageContent, ListPages
+- `minimal` - Navigate, Screenshot, GetFullPageContent
+- `subagent` - BrowseWeb subagent only
+
+## Available Gadgets
+
+| Category | Gadgets |
+|----------|---------|
+| Page | NewPage, ClosePage, ListPages |
+| Navigation | Navigate, GoBack, GoForward, Reload |
+| Content | GetFullPageContent, Screenshot |
+| Interaction | Click, Type, Fill, FillForm, PressKey, Select, Check, Hover, Scroll, DismissOverlays |
+| Script | ExecuteScript |
+| Wait | WaitForElement, Wait |
+| User Input | RequestUserAssistance |
+
+## Subagents
+
+### BrowseWeb
+
+Autonomous browser agent that can navigate, interact, and extract information from websites. Runs its own agent loop internally, making it suitable for complex multi-step web tasks.

package/dist/config/cmp-selectors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Language-agnostic CMP accept button selectors (from CHI 2025 research paper).
+ * These work regardless of language because they target CMP-specific class/id patterns.
+ */
+export declare const CMP_ACCEPT_SELECTORS: readonly ["#cmpwelcomebtnyes", ".cmpboxbtnyes", "[class*=\"cmpbox\"] .cmpboxbtnyes", "[class*=\"cmpbox\"] button:first-of-type", "#CybotCookiebotDialogBodyLevelButtonLevelOptinAllowAll", "#CybotCookiebotDialogBodyButtonAccept", "[data-testid=\"uc-accept-all-button\"]", ".uc-accept-all-btn", "button[class*=\"usercentrics\"][class*=\"accept\"]", "#onetrust-accept-btn-handler", ".onetrust-accept-btn-handler", "button[class*=\"onetrust\"][class*=\"accept\"]", "[data-cky-tag=\"accept-button\"]", ".cky-btn-accept", "button[class*=\"cky\"][class*=\"accept\"]", ".osano-cm-accept-all", ".cc-accept", ".cc-btn.cc-allow", "[class*=\"coi-\"] button[class*=\"accept\"]", ".coi-banner__accept", "#didomi-notice-agree-button", "[class*=\"didomi\"] button[class*=\"agree\"]", ".iubenda-cs-accept-btn", "[class*=\"iubenda\"] button[class*=\"accept\"]", "#tarteaucitronAllAllowed", ".tarteaucitronAllow", ".cmplz-accept", "button[class*=\"cmplz\"][class*=\"accept\"]", ".qc-cmp2-summary-buttons button:first-child", "[class*=\"qc-cmp\"] button[class*=\"accept\"]", "#cookiescript_accept", ".cookiescript_accept", ".cc_btn.cc_btn_accept_all", "[class*=\"termsfeed\"] button[class*=\"accept\"]", ".moove-gdpr-infobar-allow-all", "[class*=\"moove-gdpr\"] button[class*=\"allow\"]", "[class*=\"borlabs\"] button[class*=\"accept\"]", ".BorlabsCookie .accept", ".ccc-accept-button", "[class*=\"consent\"][class*=\"accept\"]", "[id*=\"consent\"][id*=\"accept\"]", "[class*=\"cookie\"][class*=\"accept\"]", "[id*=\"cookie\"][id*=\"accept\"]", "[class*=\"gdpr\"][class*=\"accept\"]", "[id*=\"gdpr\"][id*=\"accept\"]", "[class*=\"privacy\"][class*=\"accept\"]", "[data-testid*=\"accept\"]", "[data-action*=\"accept\"]", "[class*=\"modal\"] button[class*=\"close\"]", "[class*=\"overlay\"] button[class*=\"close\"]", "[aria-label=\"Close\"]", "button[aria-label=\"Dismiss\"]"];
+/**
+ * Overlay selectors for last resort DOM hiding.
+ */
+export declare const OVERLAY_SELECTORS: readonly ["[id*=\"cookie\"]", "[class*=\"cookie\"]", "[id*=\"consent\"]", "[class*=\"consent\"]", "[id*=\"cmp\"]", "[class*=\"cmp\"]", "[class*=\"gdpr\"]", "[class*=\"privacy\"]", "[class*=\"overlay\"]", "[class*=\"modal\"]", "[class*=\"popup\"]", "[class*=\"banner\"]"];

package/dist/factory.d.ts

@@ -0,0 +1,110 @@
+import type { AbstractGadget } from "llmist";
+import type { IBrowserSessionManager } from "./session/types";
+import { GetFullPageContent, Screenshot } from "./gadgets/content";
+import { Click } from "./gadgets/click";
+import { Type, Fill, FillForm, FillPinCode } from "./gadgets/form";
+import { PressKey } from "./gadgets/keyboard";
+import { Select, Check } from "./gadgets/selection";
+import { Hover, Scroll } from "./gadgets/scroll";
+import { DismissOverlays } from "./gadgets/overlays";
+import { GoBack, GoForward, Navigate, Reload } from "./gadgets/navigation";
+import { ClosePage, ListPages, NewPage } from "./gadgets/page";
+import { ExecuteScript } from "./gadgets/script";
+import { RequestUserAssistance } from "./gadgets/user-input";
+import { Wait, WaitForElement } from "./gadgets/wait";
+/**
+ * Configuration for creating dhalsim gadgets.
+ */
+export interface DhalsimConfig {
+    /**
+     * Browser session manager to use. If not provided, uses the default singleton.
+     */
+    sessionManager?: IBrowserSessionManager;
+}
+/**
+ * All dhalsim gadgets as a record keyed by name.
+ */
+export interface DhalsimGadgets {
+    GetFullPageContent: GetFullPageContent;
+    Screenshot: Screenshot;
+    Check: Check;
+    Click: Click;
+    DismissOverlays: DismissOverlays;
+    Fill: Fill;
+    FillForm: FillForm;
+    FillPinCode: FillPinCode;
+    Hover: Hover;
+    PressKey: PressKey;
+    Scroll: Scroll;
+    Select: Select;
+    Type: Type;
+    GoBack: GoBack;
+    GoForward: GoForward;
+    Navigate: Navigate;
+    Reload: Reload;
+    ClosePage: ClosePage;
+    ListPages: ListPages;
+    NewPage: NewPage;
+    ExecuteScript: ExecuteScript;
+    RequestUserAssistance: RequestUserAssistance;
+    Wait: Wait;
+    WaitForElement: WaitForElement;
+}
+/**
+ * Create all dhalsim gadgets with dependency injection.
+ *
+ * @param config - Optional configuration (sessionManager)
+ * @returns Record of all gadgets keyed by name
+ *
+ * @example
+ * ```typescript
+ * // Use default session manager (CLI usage)
+ * const gadgets = createDhalsimGadgets();
+ *
+ * // Use custom session manager (library usage)
+ * const gadgets = createDhalsimGadgets({
+ *   sessionManager: myCustomSessionManager,
+ * });
+ *
+ * // Access individual gadgets
+ * registry.register('Navigate', gadgets.Navigate);
+ * ```
+ */
+export declare function createDhalsimGadgets(config?: DhalsimConfig): DhalsimGadgets;
+/**
+ * Preset names for common gadget combinations.
+ */
+export type DhalsimPreset = "all" | "subagent" | "readonly" | "minimal";
+/**
+ * Get gadgets by preset name.
+ *
+ * @param preset - Preset name
+ * @param config - Optional configuration
+ * @returns Array of gadgets for the preset
+ *
+ * @example
+ * ```typescript
+ * // Get all gadgets as array
+ * const allGadgets = createGadgetsByPreset('all');
+ *
+ * // Get read-only gadgets (Navigate, Screenshot, GetFullPageContent, ListPages)
+ * const readonlyGadgets = createGadgetsByPreset('readonly');
+ *
+ * // Get minimal gadgets (Navigate, Screenshot, GetFullPageContent)
+ * const minimalGadgets = createGadgetsByPreset('minimal');
+ * ```
+ */
+export declare function createGadgetsByPreset(preset: DhalsimPreset, config?: DhalsimConfig): AbstractGadget[];
+/**
+ * Get gadgets by name(s).
+ *
+ * @param names - Array of gadget names to include
+ * @param config - Optional configuration
+ * @returns Array of matching gadgets
+ *
+ * @example
+ * ```typescript
+ * const gadgets = createGadgetsByName(['Navigate', 'Click', 'Screenshot']);
+ * ```
+ */
+export declare function createGadgetsByName(names: string[], config?: DhalsimConfig): AbstractGadget[];

package/dist/gadgets/click.d.ts

@@ -0,0 +1,57 @@
+import { z } from "llmist";
+import type { IBrowserSessionManager } from "../session";
+declare const Click_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        selector: z.ZodString;
+        button: z.ZodDefault<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            middle: "middle";
+        }>>;
+        clickCount: z.ZodDefault<z.ZodNumber>;
+        force: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        selector: string;
+        button: "left" | "right" | "middle";
+        clickCount: number;
+        force: boolean;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        selector: string;
+        button: "left" | "right" | "middle";
+        clickCount: number;
+        force: boolean;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        selector: string;
+        button: "left" | "right" | "middle";
+        clickCount: number;
+        force: boolean;
+    };
+};
+export declare class Click extends Click_base {
+    private manager;
+    private lastClickedSelector;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string>;
+}
+export {};

package/dist/gadgets/content.d.ts

@@ -0,0 +1,89 @@
+import { z, type GadgetExecuteResultWithMedia } from "llmist";
+import type { IBrowserSessionManager } from "../session";
+declare const GetFullPageContent_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        selector: z.ZodOptional<z.ZodString>;
+        selectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        structure: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        selector?: string | undefined;
+        selectors?: string[] | undefined;
+        structure?: boolean | undefined;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        selector?: string | undefined;
+        selectors?: string[] | undefined;
+        structure?: boolean | undefined;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        selector?: string | undefined;
+        selectors?: string[] | undefined;
+        structure?: boolean | undefined;
+    };
+};
+export declare class GetFullPageContent extends GetFullPageContent_base {
+    private manager;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string>;
+}
+declare const Screenshot_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodBoolean>;
+        selector: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        fullPage: boolean;
+        selector?: string | undefined;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        fullPage: boolean;
+        selector?: string | undefined;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        fullPage: boolean;
+        selector?: string | undefined;
+    };
+};
+export declare class Screenshot extends Screenshot_base {
+    private manager;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string | GadgetExecuteResultWithMedia>;
+}
+export {};

package/dist/gadgets/content.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/gadgets/form.d.ts

@@ -0,0 +1,199 @@
+import { z } from "llmist";
+import type { IBrowserSessionManager } from "../session";
+declare const Type_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        selector: z.ZodString;
+        text: z.ZodString;
+        delay: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        selector: string;
+        text: string;
+        delay: number;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        selector: string;
+        text: string;
+        delay: number;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        selector: string;
+        text: string;
+        delay: number;
+    };
+};
+export declare class Type extends Type_base {
+    private manager;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string>;
+}
+declare const Fill_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        selector: string;
+        value: string;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        selector: string;
+        value: string;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        selector: string;
+        value: string;
+    };
+};
+export declare class Fill extends Fill_base {
+    private manager;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string>;
+}
+declare const FillForm_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        submit: z.ZodOptional<z.ZodString>;
+        waitForNavigation: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        fields: {
+            selector: string;
+            value: string;
+        }[];
+        waitForNavigation: boolean;
+        submit?: string | undefined;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        fields: {
+            selector: string;
+            value: string;
+        }[];
+        waitForNavigation: boolean;
+        submit?: string | undefined;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        fields: {
+            selector: string;
+            value: string;
+        }[];
+        waitForNavigation: boolean;
+        submit?: string | undefined;
+    };
+};
+export declare class FillForm extends FillForm_base {
+    private manager;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string>;
+}
+declare const FillPinCode_base: new () => {
+    description: string;
+    parameterSchema: z.ZodObject<{
+        pageId: z.ZodString;
+        code: z.ZodString;
+        selectorPattern: z.ZodOptional<z.ZodString>;
+        startIndex: z.ZodDefault<z.ZodNumber>;
+        submit: z.ZodOptional<z.ZodString>;
+        waitForNavigation: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    name: string | undefined;
+    timeoutMs: number | undefined;
+    examples: import("llmist").GadgetExample<{
+        pageId: string;
+        code: string;
+        startIndex: number;
+        waitForNavigation: boolean;
+        selectorPattern?: string | undefined;
+        submit?: string | undefined;
+    }>[] | undefined;
+    readonly params: {
+        pageId: string;
+        code: string;
+        startIndex: number;
+        waitForNavigation: boolean;
+        selectorPattern?: string | undefined;
+        submit?: string | undefined;
+    };
+    execute(params: Record<string, unknown>, ctx?: import("llmist").ExecutionContext): import("llmist").GadgetExecuteReturn | Promise<import("llmist").GadgetExecuteReturn>;
+    throwIfAborted(ctx?: import("llmist").ExecutionContext): void;
+    onAbort(ctx: import("llmist").ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
+    createLinkedAbortController(ctx?: import("llmist").ExecutionContext): AbortController;
+    readonly instruction: string;
+    getInstruction(optionsOrArgPrefix?: string | {
+        argPrefix?: string;
+        startPrefix?: string;
+        endPrefix?: string;
+    }): string;
+} & {
+    params: {
+        pageId: string;
+        code: string;
+        startIndex: number;
+        waitForNavigation: boolean;
+        selectorPattern?: string | undefined;
+        submit?: string | undefined;
+    };
+};
+export declare class FillPinCode extends FillPinCode_base {
+    private manager;
+    constructor(manager: IBrowserSessionManager);
+    execute(params: this["params"]): Promise<string>;
+}
+export {};

package/dist/gadgets/index.d.ts

@@ -0,0 +1,12 @@
+export { GetFullPageContent, Screenshot } from "./content";
+export { Click } from "./click";
+export { Type, Fill, FillForm, FillPinCode } from "./form";
+export { PressKey } from "./keyboard";
+export { Select, Check } from "./selection";
+export { Hover, Scroll } from "./scroll";
+export { DismissOverlays, dismissOverlaysOnPage } from "./overlays";
+export { GoBack, GoForward, Navigate, Reload } from "./navigation";
+export { ClosePage, ListPages, NewPage } from "./page";
+export { ExecuteScript } from "./script";
+export { Wait, WaitForElement } from "./wait";
+export { RequestUserAssistance } from "./user-input";

package/dist/gadgets/interaction.test.d.ts

@@ -0,0 +1 @@
+export {};