nolo-cli 0.72.0-alpha.1 → 0.72.0

package/chromeOpsCommands-M7DPCX2T.js

@@ -0,0 +1,258 @@
+import {
+  createChromeConnectorClient
+} from "./chunk-QCZX4FTW.js";
+import {
+  toErrorMessage
+} from "./chunk-HNMXYYJR.js";
+import {
+  readOption
+} from "./chunk-A7GB5UGH.js";
+import "./chunk-OLZBQWZU.js";
+import "./chunk-KUG52IAP.js";
+import "./chunk-LCBAMY2M.js";
+import "./chunk-4SN6J65J.js";
+import "./chunk-CF7PE763.js";
+import "./chunk-G3SUCT4W.js";
+import "./chunk-4VNS5WPM.js";
+
+// packages/cli/chromeOpsCommands.ts
+import { writeFile } from "node:fs/promises";
+function wantsHelp(args) {
+  return args.includes("--help") || args.includes("-h");
+}
+function readTrimmedOption(args, flag) {
+  return (readOption(args, flag) ?? "").trim();
+}
+function readIntOption(args, flag, usage) {
+  const raw = readOption(args, flag);
+  if (raw === void 0) return void 0;
+  const value = Number.parseInt(raw, 10);
+  if (!Number.isFinite(value)) {
+    throw new Error(`Invalid ${flag} <N>. Usage: ${usage}`);
+  }
+  return value;
+}
+function requireTabId(args, usage) {
+  const tabId = readTrimmedOption(args, "--tab");
+  if (!tabId) {
+    throw new Error(`Missing required --tab <id>. Usage: ${usage}`);
+  }
+  return tabId;
+}
+function requireTarget(args, usage) {
+  const elementRef = readTrimmedOption(args, "--ref");
+  const selector = readTrimmedOption(args, "--selector");
+  if (!elementRef && !selector) {
+    throw new Error(
+      `Provide --ref <elementRef> (from read-page) or --selector <css>. Usage: ${usage}`
+    );
+  }
+  return {
+    ...elementRef ? { elementRef } : {},
+    ...selector ? { selector } : {}
+  };
+}
+var CHROME_OPS_SUBCOMMANDS = {
+  "list-tabs": {
+    action: "list_tabs",
+    usage: "nolo chrome list-tabs",
+    payload: () => ({})
+  },
+  "open-tab": {
+    action: "open_tab",
+    usage: "nolo chrome open-tab --url <url> [--active]",
+    payload: (args, usage) => {
+      const url = readTrimmedOption(args, "--url");
+      if (!url) {
+        throw new Error(`Missing required --url <url>. Usage: ${usage}`);
+      }
+      return { url, active: args.includes("--active") };
+    }
+  },
+  "close-tab": {
+    action: "close_tab",
+    usage: "nolo chrome close-tab --tab <id>",
+    payload: (args, usage) => ({ tabId: requireTabId(args, usage) })
+  },
+  "read-page": {
+    action: "read_page",
+    usage: "nolo chrome read-page --tab <id> [--selector <css>] [--detail compact|full] [--max-elements N]",
+    payload: (args, usage) => {
+      const payload = { tabId: requireTabId(args, usage) };
+      const selector = readTrimmedOption(args, "--selector");
+      if (selector) payload.selector = selector;
+      const detail = readTrimmedOption(args, "--detail");
+      if (detail) payload.detail = detail;
+      const maxElements = readIntOption(args, "--max-elements", usage);
+      if (maxElements !== void 0) payload.maxElements = maxElements;
+      return payload;
+    }
+  },
+  click: {
+    action: "click",
+    usage: "nolo chrome click --tab <id> (--ref <elementRef> | --selector <css>)",
+    payload: (args, usage) => ({
+      tabId: requireTabId(args, usage),
+      ...requireTarget(args, usage)
+    })
+  },
+  type: {
+    action: "type",
+    usage: "nolo chrome type --tab <id> (--ref <elementRef> | --selector <css>) --text <text> [--append]",
+    payload: (args, usage) => {
+      const text = readOption(args, "--text");
+      if (text === void 0 || text.startsWith("--")) {
+        throw new Error(`Missing required --text <text>. Usage: ${usage}`);
+      }
+      return {
+        tabId: requireTabId(args, usage),
+        ...requireTarget(args, usage),
+        text,
+        ...args.includes("--append") ? { clearFirst: false } : {}
+      };
+    }
+  },
+  press: {
+    action: "press",
+    usage: "nolo chrome press --tab <id> --key <key>",
+    payload: (args, usage) => {
+      const key = readTrimmedOption(args, "--key");
+      if (!key) {
+        throw new Error(`Missing required --key <key>. Usage: ${usage}`);
+      }
+      return { tabId: requireTabId(args, usage), key };
+    }
+  },
+  scroll: {
+    action: "scroll",
+    usage: "nolo chrome scroll --tab <id> [--delta-x N] [--delta-y N]",
+    payload: (args, usage) => {
+      const payload = { tabId: requireTabId(args, usage) };
+      const deltaX = readIntOption(args, "--delta-x", usage);
+      const deltaY = readIntOption(args, "--delta-y", usage);
+      if (deltaX !== void 0) payload.deltaX = deltaX;
+      if (deltaY !== void 0) payload.deltaY = deltaY;
+      return payload;
+    }
+  },
+  screenshot: {
+    action: "screenshot",
+    usage: "nolo chrome screenshot --tab <id> [--out <path>] [--full-page]",
+    payload: (args, usage) => ({
+      tabId: requireTabId(args, usage),
+      ...args.includes("--full-page") ? { fullPage: true } : {}
+    })
+  },
+  "read-console": {
+    action: "read_console",
+    usage: "nolo chrome read-console --tab <id> [--limit N]",
+    payload: (args, usage) => {
+      const payload = { tabId: requireTabId(args, usage) };
+      const limit = readIntOption(args, "--limit", usage);
+      if (limit !== void 0) payload.limit = limit;
+      return payload;
+    }
+  },
+  "read-network": {
+    action: "read_network",
+    usage: "nolo chrome read-network --tab <id> [--limit N] [--include-assets]",
+    payload: (args, usage) => {
+      const payload = { tabId: requireTabId(args, usage) };
+      const limit = readIntOption(args, "--limit", usage);
+      if (limit !== void 0) payload.limit = limit;
+      if (args.includes("--include-assets")) payload.includeAssets = true;
+      return payload;
+    }
+  }
+};
+function renderChromeOpsHelp() {
+  const lines = [
+    "Operate the user's Chrome through the Nolo Chrome connector (the desktop bridge;",
+    "the same RPC the chrome_* agent tools use).",
+    "",
+    "Usage:",
+    "  nolo chrome <subcommand> [flags]",
+    "",
+    "Subcommands:",
+    ...Object.values(CHROME_OPS_SUBCOMMANDS).map(
+      (spec) => `  ${spec.usage.replace(/^nolo chrome /, "")}`
+    ),
+    "",
+    "Notes:",
+    "  --ref takes an elementRef copied from `nolo chrome read-page` (revision-scoped,",
+    "    preferred over --selector); --selector takes a CSS selector.",
+    "  Actions the connector classifies as irreversible (Submit / Delete / Pay ...)",
+    "    are refused with CONFIRMATION_REQUIRED \u2014 ask the user to perform them.",
+    "  Every subcommand prints the connector's raw JSON result; failures exit 1.",
+    "  Endpoint: NOLO_CHROME_CONNECTOR_RPC_URL or http://127.0.0.1:38947/rpc."
+  ];
+  return lines.join("\n");
+}
+var CHROME_OPS_HELP_TEXT = renderChromeOpsHelp();
+async function runChromeOpsCommand(subcommand, args, deps = {}) {
+  const io = {
+    stdout: (text) => console.log(text),
+    stderr: (text) => console.error(text),
+    ...deps.io
+  };
+  const spec = CHROME_OPS_SUBCOMMANDS[subcommand];
+  if (!spec) {
+    io.stderr(`Unknown chrome subcommand: ${subcommand}
+
+${CHROME_OPS_HELP_TEXT}`);
+    return 1;
+  }
+  if (wantsHelp(args)) {
+    io.stdout(CHROME_OPS_HELP_TEXT);
+    return 0;
+  }
+  let payload;
+  try {
+    payload = spec.payload(args, spec.usage);
+  } catch (error) {
+    io.stderr(toErrorMessage(error));
+    return 1;
+  }
+  let result;
+  try {
+    const client = deps.client ?? createChromeConnectorClient();
+    result = await client.request(spec.action, payload);
+  } catch (error) {
+    const code = typeof error?.code === "string" ? error.code : "CHROME_COMMAND_FAILED";
+    io.stderr(JSON.stringify({ ok: false, error: { code, message: toErrorMessage(error) } }, null, 2));
+    return 1;
+  }
+  if (subcommand === "screenshot") {
+    const out = readTrimmedOption(args, "--out");
+    const dataUrl = result?.dataUrl;
+    if (out && typeof dataUrl === "string") {
+      const base64 = dataUrl.includes(",") ? dataUrl.slice(dataUrl.indexOf(",") + 1) : dataUrl;
+      const bytes = Buffer.from(base64, "base64");
+      try {
+        await writeFile(out, bytes);
+      } catch (error) {
+        io.stderr(
+          JSON.stringify(
+            {
+              ok: false,
+              error: { code: "SCREENSHOT_WRITE_FAILED", message: toErrorMessage(error) }
+            },
+            null,
+            2
+          )
+        );
+        return 1;
+      }
+      io.stdout(JSON.stringify({ ok: true, result: { savedTo: out, bytes: bytes.byteLength } }, null, 2));
+      return 0;
+    }
+  }
+  io.stdout(JSON.stringify({ ok: true, result }, null, 2));
+  return 0;
+}
+export {
+  CHROME_OPS_HELP_TEXT,
+  CHROME_OPS_SUBCOMMANDS,
+  renderChromeOpsHelp,
+  runChromeOpsCommand
+};

package/{chunk-7GCIXOQA.js → chunk-226XC5JW.js}

@@ -1,6 +1,6 @@
 import {
   clearCliLocalRuntimePreparedAgentCache
-} from "./chunk-SV63E2UZ.js";
+} from "./chunk-4SUTS5DI.js";
 import {
   getReadableCliDb
 } from "./chunk-RXX4GDIH.js";
@@ -12,7 +12,7 @@ import {
   resolveAgentRecordFromHybridStore,
   sanitizeAgentRecordForCliOutput,
   writeAgentRecord
-} from "./chunk-AUKZOZFG.js";
+} from "./chunk-QA6YKM3H.js";
 import {
   resolveCliAgentKeyInput
 } from "./chunk-SPAQ4PVV.js";

package/{chunk-SV63E2UZ.js → chunk-4SUTS5DI.js}

@@ -5,6 +5,11 @@ import {
   refreshOpenAiCodexToken,
   xaiRefresh
 } from "./chunk-GBPZKFYK.js";
+import {
+  createChromeConnectorClient,
+  createVerifiedChromeConnectorClient,
+  executeChromeConnectorTool
+} from "./chunk-QCZX4FTW.js";
 import {
   defaultLoopbackRequest
 } from "./chunk-EADNWBAZ.js";
@@ -55,11 +60,12 @@ import {
 import {
   inlineImageUrlsForCustomProvider,
   prepareTools
-} from "./chunk-AOKRQAUQ.js";
+} from "./chunk-ALGK6TIE.js";
 import {
   getServerProviderSecret
 } from "./chunk-HS7MLR74.js";
 import {
+  CHROME_CONNECTOR_TOOL_NAMES,
   CONTROL_AGENT_RUN_ACTIONS,
   buildControlAgentRunFunctionSchema,
   buildStartAgentRunFunctionSchema,
@@ -72,7 +78,7 @@ import {
   rememberMemoryFunctionSchema,
   resolveAgentRequiredPackIds,
   setTodoListFunc
-} from "./chunk-R5NCDOHB.js";
+} from "./chunk-MEVSATIF.js";
 import {
   fetchWithTransientRetry,
   isTransientFetchError
@@ -95,13 +101,13 @@ import {
   prepareTokenUsageData,
   resolveBuiltinPlatformAgentConfig,
   runKeyed
-} from "./chunk-3LBE76GR.js";
+} from "./chunk-D74EWXL4.js";
 import {
   BUILTIN_TITLE_LLM_CONFIG
 } from "./chunk-EVBFYPDC.js";
 import {
   fetchServerSyncedCredential
-} from "./chunk-RVCBKVIR.js";
+} from "./chunk-QUH3XHL5.js";
 import {
   require_date_fns
 } from "./chunk-M76ECQRD.js";
@@ -153,7 +159,7 @@ import {
   resolveOpenAiCompatibleProviderConfig,
   shouldUseGeminiNativeToolRoute,
   summarizeToolArguments
-} from "./chunk-CJ23A7U4.js";
+} from "./chunk-CUQ6PG2C.js";
 import {
   PlatformStreamInterruptedError,
   buildPlatformChatCompletionRequest,
@@ -165,7 +171,7 @@ import {
   readSseDataValues,
   resolvePlatformChatProviderConfig,
   shouldUsePlatformChatProvider
-} from "./chunk-HXAINXPQ.js";
+} from "./chunk-QC5LGHYP.js";
 import {
   resolveAgentRuntimeConfigFromRecord,
   resolveHistoricalToolContentCap
@@ -1672,6 +1678,17 @@ var LOCAL_SERVER_MEMORY_TOOL_NAME_SET = new Set(
 );
 
 // packages/cli/client/localRuntimeTools.ts
+var CLI_CHROME_CONNECTOR_TOOL_NAME_SET = new Set(
+  CHROME_CONNECTOR_TOOL_NAMES
+);
+function filterCliChromeConnectorToolNames(toolNames) {
+  return (toolNames ?? []).filter(
+    (name) => CLI_CHROME_CONNECTOR_TOOL_NAME_SET.has(name)
+  );
+}
+function buildCliChromeConnectorOpenAiTools(args) {
+  return prepareTools(filterCliChromeConnectorToolNames(args.toolNames));
+}
 function buildOpenAiTools(args) {
   const toolset = buildLocalWorkspaceToolsetForEnv(args);
   const workspaceToolNames = toolset.toolNames;
@@ -1719,6 +1736,7 @@ function buildOpenAiTools(args) {
       toolNames: args.effectiveToolNames ?? workspaceToolNames,
       exposeShellTools: toolset.exposeShellTools
     }),
+    ...buildCliChromeConnectorOpenAiTools({ toolNames: args.toolNames }),
     ...buildServerPlatformOpenAiTools({ toolNames: args.toolNames }),
     ...buildNoloWorkspaceOpenAiTools({ toolNames: args.toolNames }),
     ...buildOrchestrationOpenAiTools({
@@ -2524,6 +2542,46 @@ async function detectCurrentMachineId(env) {
 }
 
 // packages/cli/client/cliProviderHelpers.ts
+var CYCLE_SCAN_NODE_BUDGET = 2e4;
+function keysForJson(value) {
+  if (Array.isArray(value)) {
+    const keys = [];
+    for (let i = 0; i < value.length; i++) keys.push(String(i));
+    return keys;
+  }
+  return Object.keys(value);
+}
+function hasJsonCycle(root) {
+  if (typeof root !== "object" || root === null) return false;
+  if (typeof root.toJSON === "function") return false;
+  const onPath = /* @__PURE__ */ new Set([root]);
+  const stack = [
+    { holder: root, keys: keysForJson(root), index: 0 }
+  ];
+  let visited = 1;
+  while (stack.length > 0) {
+    const frame = stack[stack.length - 1];
+    if (frame.index >= frame.keys.length) {
+      onPath.delete(frame.holder);
+      stack.pop();
+      continue;
+    }
+    const key = frame.keys[frame.index++];
+    let child;
+    try {
+      child = frame.holder[key];
+    } catch {
+      continue;
+    }
+    if (typeof child !== "object" || child === null) continue;
+    if (typeof child.toJSON === "function") continue;
+    if (onPath.has(child)) return true;
+    if (++visited > CYCLE_SCAN_NODE_BUDGET) return false;
+    onPath.add(child);
+    stack.push({ holder: child, keys: keysForJson(child), index: 0 });
+  }
+  return false;
+}
 function buildDelegatedTaskContent(task, input) {
   if (input === void 0 || input === null) {
     return task;
@@ -2540,6 +2598,9 @@ ${input}`;
   }
   let jsonStr;
   try {
+    if (hasJsonCycle(input)) {
+      throw new TypeError("Converting circular structure to JSON");
+    }
     const serialized = JSON.stringify(input, null, 2);
     if (serialized === void 0) {
       return task;
@@ -2564,6 +2625,9 @@ function calculateDelegatedPayloadMetrics(task, input, delegatedContent) {
       serializedInputForTokens = input;
     } else {
       try {
+        if (hasJsonCycle(input)) {
+          throw new TypeError("Converting circular structure to JSON");
+        }
         const serialized = JSON.stringify(input, null, 2);
         if (serialized !== void 0) {
           inputChars = serialized.length;
@@ -11271,6 +11335,19 @@ function createCliControlAgentRunExecutor(deps = {}) {
   };
 }
 
+// packages/cli/client/cliChromeConnectorToolExecutors.ts
+function buildCliChromeConnectorToolExecutors(args) {
+  const client = createVerifiedChromeConnectorClient({
+    client: args?.client ?? createChromeConnectorClient()
+  });
+  return Object.fromEntries(
+    CHROME_CONNECTOR_TOOL_NAMES.map((toolName) => [
+      toolName,
+      (call) => executeChromeConnectorTool({ client, call })
+    ])
+  );
+}
+
 // packages/cli/client/cliLocalToolExecutors.ts
 var MAX_PASTED_TEXT_LINES_PER_READ = 200;
 var PASTED_TEXT_EXPLICIT_OVERSHOOT_LINES = 20;
@@ -11557,6 +11634,12 @@ function buildLocalToolExecutors(args) {
       };
     },
     ...args.pastedTextStore ? { readPastedText: createReadPastedTextExecutor(args.pastedTextStore) } : {},
+    // Nolo Browser Connector: the CLI drives the user's real Chrome through the same verified
+    // client + executor as the desktop runtime (before this, every chrome_* call answered
+    // "only executable in the Nolo desktop local runtime").
+    ...buildCliChromeConnectorToolExecutors(
+      args.chromeConnectorClient ? { client: args.chromeConnectorClient } : {}
+    ),
     ...args.localToolExecutors ?? {}
   };
 }
@@ -12389,6 +12472,7 @@ function createCliLocalRuntimeAdapter(deps) {
     workspaceRoot,
     env: deps.env,
     fetchImpl,
+    ...deps.chromeConnectorClient ? { chromeConnectorClient: deps.chromeConnectorClient } : {},
     localToolExecutors: deps.localToolExecutors,
     readXPost: deps.readXPost,
     readXhsProfile: deps.readXhsProfile,
@@ -12465,6 +12549,7 @@ function createCliLocalRuntimeAdapter(deps) {
         workspaceRoot,
         env: deps.env,
         fetchImpl,
+        ...deps.chromeConnectorClient ? { chromeConnectorClient: deps.chromeConnectorClient } : {},
         localToolExecutors: deps.localToolExecutors,
         readXPost: deps.readXPost,
         readXhsProfile: deps.readXhsProfile,

package/{chunk-B62OSA77.js → chunk-AFIKMMGC.js}

@@ -1,7 +1,7 @@
 import {
   readDbRecord,
   writeAgentRecord
-} from "./chunk-AUKZOZFG.js";
+} from "./chunk-QA6YKM3H.js";
 import {
   buildSkillSummaryMarker
 } from "./chunk-VF4K2QE6.js";

package/{chunk-Q4OT2DC7.js → chunk-AFIWC5NH.js}

@@ -2,7 +2,7 @@ import {
   deleteDbRecord,
   queryUserRecords,
   readDbRecord
-} from "./chunk-AUKZOZFG.js";
+} from "./chunk-QA6YKM3H.js";
 import {
   mergeAndDedupUserData
 } from "./chunk-KQHGZWSV.js";