@harborclient/sdk 1.3.7 → 1.3.9

package/dist/components/VariableInput/index.js

@@ -18,7 +18,7 @@ const TOOLTIP_HIDE_DELAY_MS = 400;
  * Token highlight color (`text-[#32D2E2]`) and the tooltip `app-no-drag` class rely on
  * host styling in HarborClient `styles.css`.
  */
-export function VariableInput({ value, onChange, variables, placeholder, onKeyDown, className = '', wrapperClassName, onEditVariable, id, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, source, ...props }) {
+export function VariableInput({ value, onChange, variables, placeholder, onKeyDown, className = '', wrapperClassName, onEditVariable, id, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, source, beforeSuggestionsOpen, onSuggestionsOpenChange, ...props }) {
     const safeValue = value ?? '';
     const wrapperRef = useRef(null);
     const inputRef = useRef(null);
@@ -40,7 +40,9 @@ export function VariableInput({ value, onChange, variables, placeholder, onKeyDo
         source,
         value: safeValue,
         onSelect: onChange,
-        anchorRef: inputRef
+        anchorRef: inputRef,
+        beforeOpen: beforeSuggestionsOpen,
+        onOpenChange: onSuggestionsOpenChange
     });
     /**
      * Splits the input value into plain text and {{variable}} token spans for highlighting.

package/dist/components/index.d.ts

@@ -110,6 +110,6 @@ export { cleanVariables, resolveTabListKeyAction } from './utils.js';
 export type { TabListKeyOptions } from './utils.js';
 export { useDialogFocus, getFocusableElements } from './useDialogFocus.js';
 export { segment, segmentGroup, tabItem } from './classes.js';
-export { SidebarItem, SidebarListbox, SidebarList, SidebarTree, SidebarTreeGroup, handleSidebarOptionKeyDown, type SidebarItemListboxOption, type SidebarItemTreeItem, SortableSidebarItem, stopSortableDragPointerDown, SidebarMarkerDot, SidebarBadge, sourceRow, METHOD_CLASSES, methodBadgeClass, documentIconClass, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS, SidebarMethodBadge, SidebarStatusDot, SidebarStatusMarker, SidebarRequestItem, SidebarDocumentItem, SidebarFolderItem, SidebarRunItem, SidebarHistoryItem, SidebarEnvironmentItem, SidebarWorkspaceItem, SidebarCommitItem, type SidebarItemSortableConfig, type SidebarBadgeVariant, type SidebarCommitPushStatus } from './SidebarItem/index.js';
+export { SidebarItem, SidebarListbox, SidebarList, SidebarTree, SidebarTreeGroup, handleSidebarOptionKeyDown, type SidebarItemListboxOption, type SidebarItemTreeItem, SortableSidebarItem, stopSortableDragPointerDown, SidebarMarkerDot, SidebarBadge, sourceRow, METHOD_CLASSES, methodBadgeClass, documentIconClass, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS, SidebarMethodBadge, SidebarStatusDot, SidebarStatusMarker, SidebarRequestItem, SidebarDocumentItem, SidebarFolderItem, SidebarRunItem, SidebarHistoryItem, SidebarEnvironmentItem, SidebarWorkspaceItem, SidebarWebsiteItem, SidebarCommitItem, type SidebarItemSortableConfig, type SidebarBadgeVariant, type SidebarCommitPushStatus } from './SidebarItem/index.js';
 export type { FormDataPart, FormDataPartType, HttpMethod, KeyValue, Variable } from '../types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}

package/dist/components/index.js

@@ -80,4 +80,4 @@ export { VisibilityMenu } from './VisibilityMenu/index.js';
 export { cleanVariables, resolveTabListKeyAction } from './utils.js';
 export { useDialogFocus, getFocusableElements } from './useDialogFocus.js';
 export { segment, segmentGroup, tabItem } from './classes.js';
-export { SidebarItem, SidebarListbox, SidebarList, SidebarTree, SidebarTreeGroup, handleSidebarOptionKeyDown, SortableSidebarItem, stopSortableDragPointerDown, SidebarMarkerDot, SidebarBadge, sourceRow, METHOD_CLASSES, methodBadgeClass, documentIconClass, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS, SidebarMethodBadge, SidebarStatusDot, SidebarStatusMarker, SidebarRequestItem, SidebarDocumentItem, SidebarFolderItem, SidebarRunItem, SidebarHistoryItem, SidebarEnvironmentItem, SidebarWorkspaceItem, SidebarCommitItem } from './SidebarItem/index.js';
+export { SidebarItem, SidebarListbox, SidebarList, SidebarTree, SidebarTreeGroup, handleSidebarOptionKeyDown, SortableSidebarItem, stopSortableDragPointerDown, SidebarMarkerDot, SidebarBadge, sourceRow, METHOD_CLASSES, methodBadgeClass, documentIconClass, statusDotVariant, statusDotClass, SIDEBAR_ITEM_BUTTON_CLASS, SIDEBAR_CHEVRON_BUTTON_CLASS, SIDEBAR_CHEVRON_ICON_CLASS, SIDEBAR_CHEVRON_SLOT_CLASS, SIDEBAR_CHEVRON_LABEL_OFFSET_CLASS, SidebarMethodBadge, SidebarStatusDot, SidebarStatusMarker, SidebarRequestItem, SidebarDocumentItem, SidebarFolderItem, SidebarRunItem, SidebarHistoryItem, SidebarEnvironmentItem, SidebarWorkspaceItem, SidebarWebsiteItem, SidebarCommitItem } from './SidebarItem/index.js';

package/dist/components/rowActionsMenuHelpers.d.ts

@@ -14,6 +14,10 @@ export declare function isMenuItemEnabled(item: MenuItem): boolean;
 export declare function findAdjacentEnabledIndex(items: MenuItem[], fromIndex: number, direction: -1 | 1): number | null;
 /**
  * Returns the first or last enabled flat item index.
+ *
+ * @param items - Flat menu items to search.
+ * @param fromEnd - When true, returns the last enabled index; otherwise the first.
+ * @returns Enabled index, or `null` when every item is disabled / the list is empty.
  */
 export declare function findEdgeEnabledIndex(items: MenuItem[], fromEnd: boolean): number | null;
 /**

package/dist/components/rowActionsMenuHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rowActionsMenuHelpers.d.ts","sourceRoot":"","sources":["../../src/components/rowActionsMenuHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAatF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,GAChB,MAAM,GAAG,IAAI,CAWf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAWvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI,GACzC,QAAQ,EAAE,EAAE,CAsBd"}
+{"version":3,"file":"rowActionsMenuHelpers.d.ts","sourceRoot":"","sources":["../../src/components/rowActionsMenuHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAatF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,QAAQ,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,GAChB,MAAM,GAAG,IAAI,CAWf;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAYvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI,GACzC,QAAQ,EAAE,EAAE,CAsBd"}

package/dist/components/rowActionsMenuHelpers.js

@@ -33,6 +33,10 @@ export function findAdjacentEnabledIndex(items, fromIndex, direction) {
 }
 /**
  * Returns the first or last enabled flat item index.
+ *
+ * @param items - Flat menu items to search.
+ * @param fromEnd - When true, returns the last enabled index; otherwise the first.
+ * @returns Enabled index, or `null` when every item is disabled / the list is empty.
  */
 export function findEdgeEnabledIndex(items, fromEnd) {
     if (fromEnd) {
@@ -43,7 +47,8 @@ export function findEdgeEnabledIndex(items, fromEnd) {
         }
         return null;
     }
-    return items.findIndex((item) => isMenuItemEnabled(item));
+    const index = items.findIndex((item) => isMenuItemEnabled(item));
+    return index >= 0 ? index : null;
 }
 /**
  * Builds an optional reorder group for move-up/move-down row actions.

package/dist/runtime/createBridgedPluginContext.js

@@ -7,6 +7,7 @@ import {
 import { bridgeInvoke, bridgeOn } from './hcBridge.js';
 import { createPluginDatabaseApi } from './pluginDatabaseApi.js';
 import { setHostReact } from './reactHost.js';
+import { openWebpage } from './webpageHandle.js';
 
 /** @type {Map<string, Set<(...args: unknown[]) => void | Promise<void>>>} */
 const commandHandlers = new Map();
@@ -352,6 +353,52 @@ export function createBridgedPluginContext({ pluginId, mode, contributionId, rea
    */
   const assertAi = () => assertPermission('ai');
 
+  /**
+   * Asserts browser permission for embedded webpage control.
+   */
+  const assertBrowser = () => assertPermission('browser');
+
+  /**
+   * Invokes a webpage session op on the host renderer via the plugin bridge.
+   *
+   * @param {Record<string, unknown>} req - ScriptWebpageRequest-shaped payload.
+   * @returns {Promise<unknown>} Host session result.
+   */
+  const callWebpage = async (req) => {
+    const op = String(req.op ?? '');
+    switch (op) {
+      case 'open':
+        return bridgeInvoke('webpage.open', { url: req.url, reuse: req.reuse });
+      case 'focus':
+        return bridgeInvoke('webpage.focus', { tabId: req.tabId });
+      case 'close':
+        return bridgeInvoke('webpage.close', { tabId: req.tabId });
+      case 'query':
+        return bridgeInvoke('webpage.query', {
+          tabId: req.tabId,
+          selector: req.selector,
+          all: req.all,
+          maxElements: req.maxElements
+        });
+      case 'evaluate':
+        return bridgeInvoke('webpage.evaluate', {
+          tabId: req.tabId,
+          expression: req.expression
+        });
+      case 'injectScript':
+        return bridgeInvoke('webpage.injectScript', { tabId: req.tabId, source: req.source });
+      case 'injectStylesheet':
+        return bridgeInvoke('webpage.injectStylesheet', { tabId: req.tabId, css: req.css });
+      case 'screenshot':
+        return bridgeInvoke('webpage.screenshot', {
+          tabId: req.tabId,
+          fullPage: req.fullPage === true
+        });
+      default:
+        throw new Error(`Unsupported webpage bridge op: ${op}`);
+    }
+  };
+
   /**
    * Asserts that a contribution id is declared in manifest.contributes.
    *
@@ -482,6 +529,18 @@ export function createBridgedPluginContext({ pluginId, mode, contributionId, rea
         assertPermission('filesystem:write');
         await bridgeInvoke('fs.writeFile', { path, content });
       },
+      writeBytes: async (path, bytes) => {
+        assertPermission('filesystem:write');
+        const u8 =
+          bytes instanceof Uint8Array
+            ? bytes
+            : new Uint8Array(/** @type {ArrayLike<number>} */ (bytes));
+        let binary = '';
+        for (let i = 0; i < u8.length; i += 1) {
+          binary += String.fromCharCode(u8[i] ?? 0);
+        }
+        return bridgeInvoke('fs.writeBytes', { path, base64: btoa(binary) });
+      },
       watchFile: (path, listener) => {
         assertPermission('filesystem:read');
         const unsubscribe = bridgeOn(`fs.watch:${path}`, () => {
@@ -1243,6 +1302,34 @@ export function createBridgedPluginContext({ pluginId, mode, contributionId, rea
           selection: input?.selection
         });
       }
+    },
+    /**
+     * Opens or reuses an embedded browser tab and returns a control handle.
+     *
+     * Requires the `browser` permission. Same semantics as request-script `hc.webpage`.
+     *
+     * @param {string} [url] - Optional URL; omit to bind the active browser tab.
+     * @param {{ reuse?: boolean }} [options] - Optional `{ reuse }` (default true).
+     * @returns {Promise<import('../types').PluginWebpageHandle>} Webpage handle.
+     */
+    webpage: async (url, options) => {
+      assertBrowser();
+      /**
+       * Writes screenshot PNG bytes via the plugin filesystem bridge.
+       *
+       * @param {string} path - Relative or absolute allowlisted path.
+       * @param {string} pngBase64 - Base64-encoded PNG payload.
+       * @returns {Promise<string>} Absolute written path.
+       */
+      const writeScreenshotBytes = async (path, pngBase64) => {
+        assertPermission('filesystem:write');
+        const result = await bridgeInvoke('fs.writeBytes', { path, base64: pngBase64 });
+        if (typeof result !== 'string' || !result.trim()) {
+          throw new Error('hc.webpage().screenshot failed to resolve write path');
+        }
+        return result;
+      };
+      return openWebpage(callWebpage, url, options, writeScreenshotBytes);
     }
   };
 }

package/dist/runtime/reactHost.d.ts

@@ -0,0 +1,32 @@
+import type * as React from 'react';
+import type * as ReactDOM from 'react-dom';
+
+/**
+ * Installs the HarborClient renderer React instance for plugin JSX and hooks.
+ *
+ * @param react - React namespace from the host.
+ */
+export function setHostReact(react: typeof React): void;
+
+/**
+ * Returns the installed host React instance.
+ *
+ * @returns Host React namespace.
+ * @throws When {@link setHostReact} has not been called yet.
+ */
+export function requireHostReact(): typeof React;
+
+/**
+ * Installs the HarborClient renderer React DOM instance for plugin portals.
+ *
+ * @param reactDom - React DOM namespace from the host shim.
+ */
+export function setHostReactDom(reactDom: typeof ReactDOM): void;
+
+/**
+ * Returns the installed host React DOM instance.
+ *
+ * @returns Host React DOM namespace.
+ * @throws When {@link setHostReactDom} has not been called yet.
+ */
+export function requireHostReactDom(): typeof ReactDOM;

package/dist/runtime/webpageHandle.d.ts

@@ -0,0 +1,50 @@
+import type { PluginWebpageHandle } from '../types';
+
+/**
+ * Throws when a webpage bridge result is an `{ error }` object.
+ *
+ * @param result - Raw bridge result.
+ * @returns The result when it is not an error.
+ * @throws When the bridge returned `{ error: string }`.
+ */
+export function unwrapWebpageBridgeResult(result: unknown): unknown;
+
+/**
+ * Normalizes the optional second argument to `hc.webpage(url, options)`.
+ *
+ * @param options - User-provided options.
+ * @returns Normalized open options.
+ */
+export function normalizeWebpageOpenOptions(options?: unknown): { reuse?: boolean };
+
+/**
+ * Builds a webpage handle whose methods call the host webpage bridge.
+ *
+ * @param tab - Opened tab metadata from the bridge.
+ * @param callWebpage - Bridge transport.
+ * @returns Plain-object handle for the plugin world.
+ */
+export function createWebpageHandle(
+  tab: {
+    tabId: string;
+    url: string;
+    title: string;
+    canGoBack?: boolean;
+    canGoForward?: boolean;
+  },
+  callWebpage: (req: Record<string, unknown>) => Promise<unknown>
+): PluginWebpageHandle;
+
+/**
+ * Opens or reuses an embedded browser tab and returns a control handle.
+ *
+ * @param callWebpage - Bridge transport that accepts ScriptWebpageRequest-shaped payloads.
+ * @param url - Optional URL; omit to bind the active browser tab.
+ * @param openOptions - Optional `{ reuse }` (default true).
+ * @returns Webpage handle.
+ */
+export function openWebpage(
+  callWebpage: (req: Record<string, unknown>) => Promise<unknown>,
+  url?: unknown,
+  openOptions?: unknown
+): Promise<PluginWebpageHandle>;

package/dist/runtime/webpageHandle.js

@@ -0,0 +1,273 @@
+/**
+ * Throws when a webpage bridge result is an `{ error }` object.
+ *
+ * @param {unknown} result - Raw bridge result.
+ * @returns {unknown} The result when it is not an error.
+ * @throws {Error} When the bridge returned `{ error: string }`.
+ */
+export function unwrapWebpageBridgeResult(result) {
+  if (
+    result != null &&
+    typeof result === 'object' &&
+    !Array.isArray(result) &&
+    Object.keys(result).length === 1 &&
+    'error' in result &&
+    typeof (/** @type {{ error: unknown }} */ (result).error) === 'string'
+  ) {
+    throw new Error(/** @type {{ error: string }} */ (result).error);
+  }
+  return result;
+}
+
+/**
+ * Normalizes the optional second argument to `hc.webpage(url, options)`.
+ *
+ * @param {unknown} [options] - User-provided options.
+ * @returns {{ reuse?: boolean }} Normalized open options.
+ */
+export function normalizeWebpageOpenOptions(options) {
+  if (options == null) {
+    return {};
+  }
+  if (typeof options !== 'object' || Array.isArray(options)) {
+    throw new Error('hc.webpage options must be an object');
+  }
+  const raw = /** @type {Record<string, unknown>} */ (options);
+  if (!('reuse' in raw) || raw.reuse === undefined) {
+    return {};
+  }
+  if (typeof raw.reuse !== 'boolean') {
+    throw new Error('hc.webpage options.reuse must be a boolean');
+  }
+  return { reuse: raw.reuse };
+}
+
+/**
+ * Normalizes optional `hc.webpage().screenshot` options.
+ *
+ * @param {unknown} [options] - User-provided options (`fullPage` optional).
+ * @returns {{ fullPage: boolean }} Normalized options (default `fullPage: false`).
+ * @throws {Error} When options is present but not a plain object, or `fullPage` is not a boolean.
+ */
+export function normalizeWebpageScreenshotOptions(options) {
+  if (options == null) {
+    return { fullPage: false };
+  }
+  if (typeof options !== 'object' || Array.isArray(options)) {
+    throw new Error('hc.webpage().screenshot options must be an object');
+  }
+  const raw = /** @type {Record<string, unknown>} */ (options);
+  if (!('fullPage' in raw) || raw.fullPage === undefined) {
+    return { fullPage: false };
+  }
+  if (typeof raw.fullPage !== 'boolean') {
+    throw new Error('hc.webpage().screenshot options.fullPage must be a boolean');
+  }
+  return { fullPage: raw.fullPage };
+}
+
+/**
+ * Builds a webpage handle whose methods call the host webpage bridge.
+ *
+ * @param {{
+ *   tabId: string;
+ *   url: string;
+ *   title: string;
+ *   canGoBack?: boolean;
+ *   canGoForward?: boolean;
+ * }} tab - Opened tab metadata from the bridge.
+ * @param {(req: Record<string, unknown>) => Promise<unknown>} callWebpage - Bridge transport.
+ * @param {(path: string, pngBase64: string) => Promise<string>} [writeScreenshotBytes] - Optional
+ *   writer that saves PNG base64 under an allowlisted path and returns the absolute path.
+ * @returns {import('../types').PluginWebpageHandle} Plain-object handle for the plugin world.
+ */
+export function createWebpageHandle(tab, callWebpage, writeScreenshotBytes) {
+  const tabId = tab.tabId;
+  return {
+    tabId,
+    url: tab.url,
+    title: tab.title,
+    canGoBack: tab.canGoBack === true,
+    canGoForward: tab.canGoForward === true,
+    /**
+     * Focuses this browser tab in the HarborClient tab bar.
+     *
+     * @returns {Promise<void>} Resolves when the tab is focused.
+     */
+    focus: async () => {
+      unwrapWebpageBridgeResult(await callWebpage({ op: 'focus', tabId }));
+    },
+    /**
+     * Closes this browser tab, honoring page leave prompts.
+     *
+     * @returns {Promise<boolean>} True when closed; false when the user chose to stay.
+     */
+    close: async () => {
+      const result = /** @type {{ closed: boolean }} */ (
+        unwrapWebpageBridgeResult(await callWebpage({ op: 'close', tabId }))
+      );
+      return result.closed === true;
+    },
+    /**
+     * Captures the visible viewport (or full page) as PNG and writes it via the filesystem bridge.
+     *
+     * @param {unknown} path - Relative (plugin root) or absolute allowlisted path.
+     * @param {unknown} [screenshotOptions] - Optional `{ fullPage }` (default false).
+     * @returns {Promise<{ path: string }>} Absolute path of the written file.
+     */
+    screenshot: async (path, screenshotOptions) => {
+      const { fullPage } = normalizeWebpageScreenshotOptions(screenshotOptions);
+      const pathText = String(path ?? '').trim();
+      if (!pathText) {
+        throw new Error('hc.webpage().screenshot requires a path');
+      }
+      if (!writeScreenshotBytes) {
+        throw new Error('hc.webpage().screenshot requires hc.fs.writeBytes');
+      }
+      const capture = /** @type {{ pngBase64?: string }} */ (
+        unwrapWebpageBridgeResult(await callWebpage({ op: 'screenshot', tabId, fullPage }))
+      );
+      if (!capture || typeof capture.pngBase64 !== 'string' || !capture.pngBase64) {
+        throw new Error('hc.webpage().screenshot did not return image data');
+      }
+      const absolutePath = await writeScreenshotBytes(pathText, capture.pngBase64);
+      return { path: absolutePath };
+    },
+    dom: {
+      /**
+       * Queries the live page DOM with a CSS selector.
+       *
+       * @param {string} selector - CSS selector.
+       * @param {{ all?: boolean; maxElements?: number }} [queryOptions] - Optional query flags.
+       * @returns {Promise<{ selector: string; matchCount: number; elements: unknown[] }>}
+       */
+      query: async (selector, queryOptions) => {
+        const selectorText = String(selector ?? '').trim();
+        if (!selectorText) {
+          throw new Error('hc.webpage().dom.query requires a selector');
+        }
+        let all;
+        let maxElements;
+        if (queryOptions != null) {
+          if (typeof queryOptions !== 'object' || Array.isArray(queryOptions)) {
+            throw new Error('hc.webpage().dom.query options must be an object');
+          }
+          const raw = /** @type {Record<string, unknown>} */ (queryOptions);
+          if ('all' in raw && raw.all !== undefined) {
+            if (typeof raw.all !== 'boolean') {
+              throw new Error('hc.webpage().dom.query options.all must be a boolean');
+            }
+            all = raw.all;
+          }
+          if ('maxElements' in raw && raw.maxElements !== undefined) {
+            if (typeof raw.maxElements !== 'number' || !Number.isFinite(raw.maxElements)) {
+              throw new Error('hc.webpage().dom.query options.maxElements must be a finite number');
+            }
+            maxElements = raw.maxElements;
+          }
+        }
+        return /** @type {{ selector: string; matchCount: number; elements: unknown[] }} */ (
+          unwrapWebpageBridgeResult(
+            await callWebpage({ op: 'query', tabId, selector: selectorText, all, maxElements })
+          )
+        );
+      },
+      /**
+       * Evaluates JavaScript in the page main world and returns the result.
+       *
+       * @param {string} expression - JavaScript source that returns a JSON-serializable value.
+       * @returns {Promise<unknown>} Evaluation result.
+       */
+      evaluate: async (expression) => {
+        const expressionText = String(expression ?? '').trim();
+        if (!expressionText) {
+          throw new Error('hc.webpage().dom.evaluate requires an expression');
+        }
+        const result = /** @type {{ value: unknown }} */ (
+          unwrapWebpageBridgeResult(
+            await callWebpage({ op: 'evaluate', tabId, expression: expressionText })
+          )
+        );
+        return result.value;
+      },
+      /**
+       * Injects and runs JavaScript source in the page main world.
+       *
+       * @param {string} source - JavaScript source to inject.
+       * @returns {Promise<unknown>} Evaluation result from the injected script.
+       */
+      injectScript: async (source) => {
+        const sourceText = String(source ?? '');
+        if (!sourceText.trim()) {
+          throw new Error('hc.webpage().dom.injectScript requires source');
+        }
+        const result = /** @type {{ value: unknown }} */ (
+          unwrapWebpageBridgeResult(
+            await callWebpage({ op: 'injectScript', tabId, source: sourceText })
+          )
+        );
+        return result.value;
+      },
+      /**
+       * Injects a CSS stylesheet into the page.
+       *
+       * @param {string} css - Stylesheet source.
+       * @returns {Promise<string>} Electron insertion key.
+       */
+      injectStylesheet: async (css) => {
+        const cssText = String(css ?? '');
+        if (!cssText.trim()) {
+          throw new Error('hc.webpage().dom.injectStylesheet requires css');
+        }
+        const result = /** @type {{ key: string }} */ (
+          unwrapWebpageBridgeResult(
+            await callWebpage({ op: 'injectStylesheet', tabId, css: cssText })
+          )
+        );
+        return result.key;
+      }
+    }
+  };
+}
+
+/**
+ * Opens or reuses an embedded browser tab and returns a control handle.
+ *
+ * @param {(req: Record<string, unknown>) => Promise<unknown>} callWebpage - Bridge transport
+ *   that accepts ScriptWebpageRequest-shaped payloads (`op` plus fields).
+ * @param {unknown} [url] - Optional URL; omit to bind the active browser tab.
+ * @param {unknown} [openOptions] - Optional `{ reuse }` (default true).
+ * @param {(path: string, pngBase64: string) => Promise<string>} [writeScreenshotBytes] - Optional
+ *   writer used by `page.screenshot`.
+ * @returns {Promise<import('../types').PluginWebpageHandle>} Webpage handle.
+ */
+export async function openWebpage(callWebpage, url, openOptions, writeScreenshotBytes) {
+  const normalizedOptions = normalizeWebpageOpenOptions(openOptions);
+  let openUrl;
+  if (url !== undefined && url !== null) {
+    const trimmed = String(url).trim();
+    if (!trimmed) {
+      throw new Error('hc.webpage requires a non-empty url when provided');
+    }
+    openUrl = trimmed;
+  }
+  const opened = /** @type {{
+    tabId: string;
+    url: string;
+    title: string;
+    canGoBack?: boolean;
+    canGoForward?: boolean;
+  }} */ (
+    unwrapWebpageBridgeResult(
+      await callWebpage({
+        op: 'open',
+        url: openUrl,
+        reuse: normalizedOptions.reuse
+      })
+    )
+  );
+  if (!opened || typeof opened.tabId !== 'string') {
+    throw new Error('hc.webpage open did not return a tab');
+  }
+  return createWebpageHandle(opened, callWebpage, writeScreenshotBytes);
+}