nolo-cli 0.104.0-alpha.2 → 0.104.0

package/chunk-LWLNLZC5.js

@@ -0,0 +1,265 @@
+// packages/ai/tools/chromeConnectorTools.ts
+var CHROME_CONNECTOR_TOOL_NAMES = [
+  "browser_list_tabs",
+  "browser_open_tab",
+  "browser_close_tab",
+  "browser_read_page",
+  "browser_click_element",
+  "browser_type",
+  "browser_press",
+  "browser_scroll",
+  "browser_screenshot",
+  "browser_read_console",
+  "browser_read_network"
+];
+var CHROME_CONNECTOR_LEGACY_TOOL_ALIASES = {
+  chrome_list_tabs: "browser_list_tabs",
+  chrome_open_tab: "browser_open_tab",
+  chrome_close_tab: "browser_close_tab",
+  chrome_read_page: "browser_read_page",
+  chrome_click: "browser_click_element",
+  chrome_type: "browser_type",
+  chrome_press: "browser_press",
+  chrome_scroll: "browser_scroll",
+  chrome_screenshot: "browser_screenshot",
+  chrome_read_console: "browser_read_console",
+  chrome_read_network: "browser_read_network"
+};
+var CHROME_CONNECTOR_LEGACY_TOOL_NAMES = Object.keys(
+  CHROME_CONNECTOR_LEGACY_TOOL_ALIASES
+);
+var CHROME_CONNECTOR_ACCEPTED_TOOL_NAMES = [
+  ...CHROME_CONNECTOR_TOOL_NAMES,
+  ...CHROME_CONNECTOR_LEGACY_TOOL_NAMES
+];
+function resolveChromeConnectorToolName(name) {
+  if (CHROME_CONNECTOR_TOOL_NAMES.includes(name)) {
+    return name;
+  }
+  return CHROME_CONNECTOR_LEGACY_TOOL_ALIASES[name];
+}
+function canonicalizeChromeConnectorToolNames(toolNames) {
+  const out = [];
+  for (const name of toolNames ?? []) {
+    const resolved = typeof name === "string" ? resolveChromeConnectorToolName(name) : void 0;
+    if (resolved && !out.includes(resolved)) out.push(resolved);
+  }
+  return out;
+}
+var CONNECTOR_TARGET_PROPERTY = {
+  type: "string",
+  enum: ["chrome", "firefox"],
+  description: `Which browser's connector serves this call: "chrome" or "firefox". Omit for the default endpoint.`
+};
+var CHROME_CONNECTOR_READ_TOOL_NAMES = [
+  "browser_list_tabs",
+  "browser_read_page",
+  "browser_screenshot",
+  "browser_read_console",
+  "browser_read_network"
+];
+var getChromeConnectorToolBehavior = (name) => CHROME_CONNECTOR_READ_TOOL_NAMES.includes(resolveChromeConnectorToolName(name)) ? "data" : "action";
+var getChromeConnectorToolDefaultConsent = (name) => CHROME_CONNECTOR_READ_TOOL_NAMES.includes(resolveChromeConnectorToolName(name)) ? "auto" : "ask";
+function baseSchema(name, description, properties, required = []) {
+  return {
+    name,
+    description,
+    parameters: {
+      type: "object",
+      properties: { ...properties, target: CONNECTOR_TARGET_PROPERTY },
+      required
+    }
+  };
+}
+var tabId = {
+  type: "string",
+  description: "Browser tab id returned by browser_list_tabs or browser_open_tab."
+};
+var elementRef = {
+  type: "string",
+  description: "Revision-scoped ref like 1a2b3c4d-e2, copied verbatim from browser_read_page; preferred over selector when available."
+};
+var selector = {
+  type: "string",
+  description: "CSS selector for the visible page element to operate on; fallback when no elementRef is available."
+};
+var chromeListTabsFunctionSchema = baseSchema(
+  "browser_list_tabs",
+  "List controllable browser tabs from the user's browser profile through the Nolo Browser Connector.",
+  {}
+);
+var chromeOpenTabFunctionSchema = baseSchema(
+  "browser_open_tab",
+  "Open a URL in the user's browser (Chrome or Firefox) through the Nolo Browser Connector.",
+  {
+    url: {
+      type: "string",
+      description: "HTTP or HTTPS URL to open in the browser."
+    },
+    active: {
+      type: "boolean",
+      description: "Whether to focus the new browser tab. Defaults to true."
+    }
+  },
+  ["url"]
+);
+var chromeCloseTabFunctionSchema = baseSchema(
+  "browser_close_tab",
+  "Close a browser tab through the Nolo Browser Connector. Prefer closing the tabs your own run opened with browser_open_tab, and ask the user before closing a tab they are using. Pinned tabs are refused (TAB_PINNED); unknown tab ids fail (TAB_NOT_FOUND).",
+  {
+    tabId
+  },
+  ["tabId"]
+);
+var chromeReadPageFunctionSchema = baseSchema(
+  "browser_read_page",
+  "Read a compact view of a browser tab: visible text (hard cap 6000 chars) plus short-lived elementRefs (hard cap 35) and a pageRevision. Reuse those refs for browser_click_element and browser_type instead of guessing selectors; use region to focus a big page. When the element list exceeds one page, continue by passing the returned nextOffset as offset. Does not read cookies or profile databases.",
+  {
+    tabId,
+    region: {
+      type: "string",
+      description: "Optional CSS selector limiting the read to part of the page."
+    },
+    maxChars: {
+      type: "number",
+      description: "Optional text character budget; the connector clamps it to a hard maximum."
+    },
+    detail: {
+      type: "string",
+      enum: ["compact", "full"],
+      description: "compact (default) returns budgeted text; full raises the budget and adds capped HTML."
+    },
+    offset: {
+      type: "integer",
+      minimum: 0,
+      description: "Optional element offset for paging. When an element list exceeds one page, continue by passing the returned nextOffset as offset."
+    },
+    viewportOnly: {
+      type: "boolean",
+      description: "Optional. When true, only elements intersecting the current viewport are listed."
+    }
+  },
+  ["tabId"]
+);
+var chromeClickFunctionSchema = baseSchema(
+  "browser_click_element",
+  "Click a visible element in a browser tab by elementRef from browser_read_page, or by CSS selector. Controls whose name indicates an irreversible external action (payment, send, delete, publish, permission change) are refused with SENSITIVE_ACTION_REQUIRES_CONFIRMATION: this desktop runtime has no approval channel, so name the control and ask the user to activate it themselves.",
+  {
+    tabId,
+    elementRef,
+    selector
+  },
+  ["tabId"]
+);
+var chromeTypeFunctionSchema = baseSchema(
+  "browser_type",
+  "Type text into a browser page element identified by elementRef from browser_read_page or by CSS selector. Typing into a control whose name indicates an irreversible external action is refused with SENSITIVE_ACTION_REQUIRES_CONFIRMATION, same as clicking it.",
+  {
+    tabId,
+    elementRef,
+    selector,
+    text: {
+      type: "string",
+      description: "Text to type into the selected element."
+    },
+    clearFirst: {
+      type: "boolean",
+      description: "Whether to clear the field before typing. Defaults to true."
+    }
+  },
+  ["tabId", "text"]
+);
+var chromePressFunctionSchema = baseSchema(
+  "browser_press",
+  "Send a keyboard key or shortcut to a browser tab. Enter-like keys are refused with SENSITIVE_ACTION_REQUIRES_CONFIRMATION when the focused control is an irreversible action.",
+  {
+    tabId,
+    key: {
+      type: "string",
+      description: "Key or shortcut, for example Enter, Escape, ArrowDown, or Meta+L."
+    }
+  },
+  ["tabId", "key"]
+);
+var chromeScrollFunctionSchema = baseSchema(
+  "browser_scroll",
+  "Scroll a browser tab by pixel deltas.",
+  {
+    tabId,
+    deltaX: {
+      type: "number",
+      description: "Horizontal scroll delta in pixels."
+    },
+    deltaY: {
+      type: "number",
+      description: "Vertical scroll delta in pixels."
+    }
+  },
+  ["tabId"]
+);
+var chromeScreenshotFunctionSchema = baseSchema(
+  "browser_screenshot",
+  "Capture a screenshot from a browser tab through the Nolo Browser Connector.",
+  {
+    tabId,
+    fullPage: {
+      type: "boolean",
+      description: "Whether to capture the full page. Defaults to false."
+    }
+  },
+  ["tabId"]
+);
+var chromeReadConsoleFunctionSchema = baseSchema(
+  "browser_read_console",
+  "Read recent console messages from a browser tab using debugger-backed connector state.",
+  {
+    tabId,
+    limit: {
+      type: "number",
+      description: "Maximum number of recent console messages to return."
+    }
+  },
+  ["tabId"]
+);
+var chromeReadNetworkFunctionSchema = baseSchema(
+  "browser_read_network",
+  "Read a deduplicated recent network summary from a browser tab using debugger-backed connector state. Static assets are filtered unless includeAssets is set.",
+  {
+    tabId,
+    limit: {
+      type: "number",
+      description: "Maximum number of recent network entries to return."
+    },
+    includeAssets: {
+      type: "boolean",
+      description: "Include images, CSS, fonts and other static assets. Defaults to false."
+    }
+  },
+  ["tabId"]
+);
+var chromeConnectorToolSchemas = [
+  chromeListTabsFunctionSchema,
+  chromeOpenTabFunctionSchema,
+  chromeCloseTabFunctionSchema,
+  chromeReadPageFunctionSchema,
+  chromeClickFunctionSchema,
+  chromeTypeFunctionSchema,
+  chromePressFunctionSchema,
+  chromeScrollFunctionSchema,
+  chromeScreenshotFunctionSchema,
+  chromeReadConsoleFunctionSchema,
+  chromeReadNetworkFunctionSchema
+];
+async function chromeConnectorUnavailableFunc() {
+  throw new Error("Browser connector tools are only executable in the Nolo desktop local runtime.");
+}
+
+export {
+  CHROME_CONNECTOR_LEGACY_TOOL_ALIASES,
+  CHROME_CONNECTOR_ACCEPTED_TOOL_NAMES,
+  canonicalizeChromeConnectorToolNames,
+  getChromeConnectorToolBehavior,
+  getChromeConnectorToolDefaultConsent,
+  chromeConnectorToolSchemas,
+  chromeConnectorUnavailableFunc
+};