chrome-relay 0.5.12 → 0.5.14

package/dist/cli.js

@@ -37,26 +37,60 @@ function requireString(obj, key, tool) {
   }
   return v;
 }
-function optString(obj, key) {
+function rejectWrongType(obj, key, expected, tool) {
+  throw new RelayError({
+    code: "invalid_arguments",
+    message: `${tool ?? "<unknown tool>"}: \`${key}\` must be ${expected} (got ${typeof obj[key]}).`,
+    tool,
+    phase: "parse_arguments",
+    details: { field: key, expected, received: obj[key] },
+    retryable: false
+  });
+}
+function optString(obj, key, tool) {
   const v = obj[key];
-  return typeof v === "string" && v ? v : void 0;
+  if (v === void 0 || v === null)
+    return void 0;
+  if (typeof v !== "string")
+    rejectWrongType(obj, key, "a string", tool);
+  return v || void 0;
 }
-function optNumber(obj, key) {
+function optNumber(obj, key, tool) {
   const v = obj[key];
-  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+  if (v === void 0 || v === null)
+    return void 0;
+  if (typeof v !== "number" || !Number.isFinite(v))
+    rejectWrongType(obj, key, "a finite number", tool);
+  return v;
 }
-function optBool(obj, key) {
+function optBool(obj, key, tool) {
   const v = obj[key];
-  return typeof v === "boolean" ? v : void 0;
+  if (v === void 0 || v === null)
+    return void 0;
+  if (typeof v !== "boolean")
+    rejectWrongType(obj, key, "a boolean", tool);
+  return v;
 }
-function parseTargetArgs(obj) {
+function parseTargetArgs(obj, tool) {
   const out = {};
-  if (typeof obj.tabId === "number")
+  if (obj.tabId !== void 0 && obj.tabId !== null) {
+    if (typeof obj.tabId !== "number" || !Number.isFinite(obj.tabId)) {
+      rejectWrongType(obj, "tabId", "a finite number", tool);
+    }
     out.tabId = obj.tabId;
-  if (typeof obj.workspaceName === "string" && obj.workspaceName)
-    out.workspaceName = obj.workspaceName;
-  if (typeof obj.groupName === "string" && obj.groupName)
-    out.groupName = obj.groupName;
+  }
+  if (obj.workspaceName !== void 0 && obj.workspaceName !== null) {
+    if (typeof obj.workspaceName !== "string")
+      rejectWrongType(obj, "workspaceName", "a string", tool);
+    if (obj.workspaceName)
+      out.workspaceName = obj.workspaceName;
+  }
+  if (obj.groupName !== void 0 && obj.groupName !== null) {
+    if (typeof obj.groupName !== "string")
+      rejectWrongType(obj, "groupName", "a string", tool);
+    if (obj.groupName)
+      out.groupName = obj.groupName;
+  }
   return out;
 }
 var init_shared = __esm({
@@ -69,26 +103,38 @@ var init_shared = __esm({
 // ../protocol/dist/args/navigate.js
 function parseChromeNavigateArgs(input) {
   const obj = asObject(input, TOOL_NAMES.NAVIGATE);
-  const out = {
-    url: requireString(obj, "url", TOOL_NAMES.NAVIGATE),
-    ...parseTargetArgs(obj)
-  };
+  const out = { url: requireString(obj, "url", TOOL_NAMES.NAVIGATE) };
   if (typeof obj.tabId === "string" && obj.tabId) {
     const n = Number(obj.tabId);
-    if (Number.isFinite(n))
-      out.tabId = n;
+    if (!Number.isFinite(n)) {
+      throw new RelayError({
+        code: "invalid_arguments",
+        message: `chrome_navigate: invalid tabId ${JSON.stringify(obj.tabId)}. Expected a number.`,
+        tool: TOOL_NAMES.NAVIGATE,
+        phase: "parse_arguments",
+        details: { field: "tabId", received: obj.tabId },
+        retryable: false
+      });
+    }
+    out.tabId = n;
   } else {
-    const n = optNumber(obj, "tabId");
+    const n = optNumber(obj, "tabId", TOOL_NAMES.NAVIGATE);
     if (n !== void 0)
       out.tabId = n;
   }
-  const newTab = optBool(obj, "newTab");
+  const { tabId: _, ...rest } = obj;
+  const target = parseTargetArgs(rest, TOOL_NAMES.NAVIGATE);
+  if (target.workspaceName)
+    out.workspaceName = target.workspaceName;
+  if (target.groupName)
+    out.groupName = target.groupName;
+  const newTab = optBool(obj, "newTab", TOOL_NAMES.NAVIGATE);
   if (newTab !== void 0)
     out.newTab = newTab;
-  const active = optBool(obj, "active");
+  const active = optBool(obj, "active", TOOL_NAMES.NAVIGATE);
   if (active !== void 0)
     out.active = active;
-  const allowPartial = optBool(obj, "allowPartial");
+  const allowPartial = optBool(obj, "allowPartial", TOOL_NAMES.NAVIGATE);
   if (allowPartial !== void 0)
     out.allowPartial = allowPartial;
   void optString;
@@ -105,13 +151,13 @@ var init_navigate = __esm({
 // ../protocol/dist/args/hover.js
 function parseChromeHoverArgs(input) {
   const obj = asObject(input, TOOL_NAMES.HOVER);
-  const target = parseTargetArgs(obj);
-  const x = optNumber(obj, "x");
-  const y = optNumber(obj, "y");
+  const target = parseTargetArgs(obj, TOOL_NAMES.HOVER);
+  const x = optNumber(obj, "x", TOOL_NAMES.HOVER);
+  const y = optNumber(obj, "y", TOOL_NAMES.HOVER);
   if (x !== void 0 && y !== void 0) {
     return { ...target, kind: "coords", x, y };
   }
-  const selector = optString(obj, "selector");
+  const selector = optString(obj, "selector", TOOL_NAMES.HOVER);
   if (selector) {
     return { ...target, kind: "selector", selector };
   }
@@ -226,6 +272,475 @@ var init_network = __esm({
   }
 });
 
+// ../protocol/dist/args/simple.js
+function parseGetWindowsAndTabsArgs(_input) {
+  return {};
+}
+function parseChromeSelfReloadArgs(_input) {
+  return {};
+}
+function parseChromeReadPageArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.READ_PAGE);
+  const out = { ...parseTargetArgs(obj) };
+  const io = optBool(obj, "interactiveOnly");
+  if (io !== void 0)
+    out.interactiveOnly = io;
+  return out;
+}
+function parseChromeClickArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.CLICK);
+  return {
+    selector: requireString(obj, "selector", TOOL_NAMES.CLICK),
+    ...parseTargetArgs(obj)
+  };
+}
+function parseChromeFillArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.FILL);
+  if (typeof obj.value !== "string") {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.FILL}: \`value\` is required and must be a string (empty string allowed).`,
+      tool: TOOL_NAMES.FILL,
+      phase: "parse_arguments",
+      details: { field: "value", received: obj.value },
+      retryable: false
+    });
+  }
+  return {
+    selector: requireString(obj, "selector", TOOL_NAMES.FILL),
+    value: obj.value,
+    ...parseTargetArgs(obj)
+  };
+}
+function parseChromeKeyboardArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.KEYBOARD);
+  return {
+    keys: requireString(obj, "keys", TOOL_NAMES.KEYBOARD),
+    ...parseTargetArgs(obj)
+  };
+}
+function parseChromeTypeArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.TYPE);
+  const out = {
+    text: requireString(obj, "text", TOOL_NAMES.TYPE),
+    ...parseTargetArgs(obj)
+  };
+  const selector = optString(obj, "selector");
+  if (selector)
+    out.selector = selector;
+  return out;
+}
+function parseChromeEvaluateArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.EVALUATE);
+  const out = {
+    code: requireString(obj, "code", TOOL_NAMES.EVALUATE),
+    ...parseTargetArgs(obj)
+  };
+  const t = optNumber(obj, "timeoutMs");
+  if (t !== void 0)
+    out.timeoutMs = t;
+  return out;
+}
+function parseChromeSwitchTabArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.SWITCH_TAB);
+  const tabId = Number(obj.tabId);
+  if (!Number.isFinite(tabId)) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.SWITCH_TAB} requires a numeric tabId.`,
+      tool: TOOL_NAMES.SWITCH_TAB,
+      phase: "parse_arguments",
+      details: { received: obj.tabId },
+      retryable: false
+    });
+  }
+  return { tabId };
+}
+function parseChromeCloseTabsArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.CLOSE_TABS);
+  if (!Array.isArray(obj.tabIds)) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.CLOSE_TABS} requires a numeric tabIds array.`,
+      tool: TOOL_NAMES.CLOSE_TABS,
+      phase: "parse_arguments",
+      details: { field: "tabIds", received: obj.tabIds },
+      retryable: false
+    });
+  }
+  const tabIds = obj.tabIds.map((v) => Number(v));
+  if (tabIds.length === 0 || tabIds.some((n) => !Number.isFinite(n))) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.CLOSE_TABS} requires a non-empty array of numeric tab IDs.`,
+      tool: TOOL_NAMES.CLOSE_TABS,
+      phase: "parse_arguments",
+      details: { received: obj.tabIds },
+      retryable: false
+    });
+  }
+  return { tabIds };
+}
+function parseChromeAxArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.AX);
+  const out = { ...parseTargetArgs(obj) };
+  const io = optBool(obj, "interactiveOnly");
+  if (io !== void 0)
+    out.interactiveOnly = io;
+  const root = optString(obj, "rootRole");
+  if (root)
+    out.rootRole = root;
+  const is = optBool(obj, "includeSubframes");
+  if (is !== void 0)
+    out.includeSubframes = is;
+  return out;
+}
+function parseChromeClickAxArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.CLICK_AX);
+  const node = Number(obj.node ?? obj.id);
+  if (!Number.isFinite(node) || node <= 0) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.CLICK_AX} requires \`node\` (a positive backendDOMNodeId from chrome_ax).`,
+      tool: TOOL_NAMES.CLICK_AX,
+      phase: "parse_arguments",
+      details: { received: obj.node ?? obj.id },
+      retryable: false
+    });
+  }
+  return { node, ...parseTargetArgs(obj) };
+}
+function parseChromeScreenshotArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.SCREENSHOT);
+  const out = { ...parseTargetArgs(obj) };
+  const fp = optBool(obj, "fullPage");
+  if (fp !== void 0)
+    out.fullPage = fp;
+  const bbox = optString(obj, "bbox");
+  if (bbox)
+    out.bbox = bbox;
+  const sel = optString(obj, "selector");
+  if (sel)
+    out.selector = sel;
+  const pad = optNumber(obj, "padding");
+  if (pad !== void 0)
+    out.padding = pad;
+  const me = optNumber(obj, "maxEdge");
+  if (me !== void 0 && me > 0)
+    out.maxEdge = me;
+  return out;
+}
+var init_simple = __esm({
+  "../protocol/dist/args/simple.js"() {
+    "use strict";
+    init_dist();
+    init_shared();
+  }
+});
+
+// ../protocol/dist/args/multi.js
+function invalidAction(tool, received, expected) {
+  throw new RelayError({
+    code: "invalid_arguments",
+    message: `${tool}: unknown action ${JSON.stringify(received)}. Expected ${expected.join(" | ")}.`,
+    tool,
+    phase: "parse_action",
+    details: { received, validChoices: expected },
+    retryable: false
+  });
+}
+function parseChromeViewportArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.VIEWPORT);
+  const action = typeof obj.action === "string" ? obj.action : "set";
+  if (!VALID_VIEWPORT_ACTIONS.includes(action)) {
+    invalidAction(TOOL_NAMES.VIEWPORT, action, VALID_VIEWPORT_ACTIONS);
+  }
+  const target = parseTargetArgs(obj);
+  if (action === "list")
+    return { action: "list" };
+  if (action === "clear")
+    return { ...target, action: "clear" };
+  if (action === "preset") {
+    return { ...target, action: "preset", name: requireString(obj, "name", TOOL_NAMES.VIEWPORT) };
+  }
+  const width = Number(obj.width);
+  const height = Number(obj.height);
+  if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.VIEWPORT} set requires positive numeric width and height.`,
+      tool: TOOL_NAMES.VIEWPORT,
+      phase: "parse_dimensions",
+      details: { received: { width: obj.width, height: obj.height } },
+      retryable: false
+    });
+  }
+  const out = {
+    ...target,
+    action: "set",
+    width,
+    height
+  };
+  const dpr = optNumber(obj, "dpr");
+  if (dpr !== void 0)
+    out.dpr = dpr;
+  const mobile = optBool(obj, "mobile");
+  if (mobile !== void 0)
+    out.mobile = mobile;
+  const hasTouch = optBool(obj, "hasTouch");
+  if (hasTouch !== void 0)
+    out.hasTouch = hasTouch;
+  const userAgent = optString(obj, "userAgent");
+  if (userAgent)
+    out.userAgent = userAgent;
+  return out;
+}
+function parseLevels(input) {
+  if (input === void 0 || input === null)
+    return void 0;
+  const valid = new Set(VALID_CONSOLE_LEVELS);
+  const verify = (s) => {
+    if (typeof s !== "string" || !valid.has(s)) {
+      throw new RelayError({
+        code: "invalid_arguments",
+        message: `${TOOL_NAMES.CONSOLE}: invalid level ${JSON.stringify(s)}. Expected one of: ${VALID_CONSOLE_LEVELS.join(", ")}.`,
+        tool: TOOL_NAMES.CONSOLE,
+        phase: "parse_levels",
+        details: { received: s, validChoices: VALID_CONSOLE_LEVELS },
+        retryable: false
+      });
+    }
+    return s;
+  };
+  if (typeof input === "string")
+    return input.split(",").map((s) => verify(s.trim()));
+  if (Array.isArray(input))
+    return input.map(verify);
+  throw new RelayError({
+    code: "invalid_arguments",
+    message: `${TOOL_NAMES.CONSOLE}: invalid levels argument ${JSON.stringify(input)}. Expected a comma-separated string or an array of strings.`,
+    tool: TOOL_NAMES.CONSOLE,
+    phase: "parse_levels",
+    details: { received: input },
+    retryable: false
+  });
+}
+function parseChromeConsoleArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.CONSOLE);
+  const target = parseTargetArgs(obj);
+  const action = typeof obj.action === "string" ? obj.action : "read";
+  if (!VALID_CONSOLE_ACTIONS.includes(action)) {
+    invalidAction(TOOL_NAMES.CONSOLE, action, VALID_CONSOLE_ACTIONS);
+  }
+  if (action === "clear")
+    return { ...target, action: "clear" };
+  const out = { ...target, action: "read" };
+  const levels = parseLevels(obj.levels);
+  if (levels)
+    out.levels = levels;
+  const since = optNumber(obj, "since");
+  if (since !== void 0)
+    out.since = since;
+  const limit = optNumber(obj, "limit");
+  if (limit !== void 0)
+    out.limit = limit;
+  return out;
+}
+function parseChromeWorkspaceArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.WORKSPACE);
+  const action = typeof obj.action === "string" ? obj.action : "list";
+  if (!VALID_WORKSPACE_ACTIONS.includes(action)) {
+    invalidAction(TOOL_NAMES.WORKSPACE, action, VALID_WORKSPACE_ACTIONS);
+  }
+  if (action === "list")
+    return { action: "list" };
+  if (action === "close")
+    return { action: "close", name: requireString(obj, "name", TOOL_NAMES.WORKSPACE) };
+  const out = {
+    action: "create",
+    name: requireString(obj, "name", TOOL_NAMES.WORKSPACE)
+  };
+  const url = optString(obj, "url");
+  if (url)
+    out.url = url;
+  const label = optString(obj, "label");
+  if (label)
+    out.label = label;
+  return out;
+}
+function parseTabIds(raw) {
+  const reject = (bad) => {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.GROUP}: invalid tabId ${JSON.stringify(bad)}. Expected a number or a comma-separated list of numbers.`,
+      tool: TOOL_NAMES.GROUP,
+      phase: "parse_tab_ids",
+      details: { received: bad },
+      retryable: false
+    });
+  };
+  const coerce = (v) => {
+    const n = Number(typeof v === "string" ? v.trim() : v);
+    if (!Number.isFinite(n))
+      reject(v);
+    return n;
+  };
+  if (Array.isArray(raw))
+    return raw.map(coerce);
+  if (typeof raw === "string")
+    return raw.split(",").map(coerce);
+  if (typeof raw === "number")
+    return [raw];
+  return [];
+}
+function parseColor(raw) {
+  if (raw === void 0 || raw === null)
+    return void 0;
+  if (typeof raw !== "string") {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.GROUP}: invalid color ${JSON.stringify(raw)}. Expected one of: ${VALID_GROUP_COLORS.join(", ")}.`,
+      tool: TOOL_NAMES.GROUP,
+      phase: "parse_color",
+      details: { received: raw, validChoices: VALID_GROUP_COLORS },
+      retryable: false
+    });
+  }
+  const c = raw.toLowerCase();
+  if (!VALID_GROUP_COLORS.includes(c)) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.GROUP}: invalid color "${raw}". Expected one of: ${VALID_GROUP_COLORS.join(", ")}.`,
+      tool: TOOL_NAMES.GROUP,
+      phase: "parse_color",
+      details: { received: raw, validChoices: VALID_GROUP_COLORS },
+      retryable: false
+    });
+  }
+  return c;
+}
+function parseChromeGroupArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.GROUP);
+  const action = typeof obj.action === "string" ? obj.action : "list";
+  if (!VALID_GROUP_ACTIONS.includes(action)) {
+    invalidAction(TOOL_NAMES.GROUP, action, VALID_GROUP_ACTIONS);
+  }
+  if (action === "list")
+    return { action: "list" };
+  if (action === "close")
+    return { action: "close", name: requireString(obj, "name", TOOL_NAMES.GROUP) };
+  if (action === "remove") {
+    const tabIds2 = parseTabIds(obj.tabIds);
+    if (tabIds2.length === 0) {
+      throw new RelayError({
+        code: "invalid_arguments",
+        message: `${TOOL_NAMES.GROUP} remove requires tabIds.`,
+        tool: TOOL_NAMES.GROUP,
+        phase: "parse_arguments",
+        details: { field: "tabIds" },
+        retryable: false
+      });
+    }
+    return { action: "remove", tabIds: tabIds2 };
+  }
+  if (action === "add") {
+    const tabIds2 = parseTabIds(obj.tabIds);
+    if (tabIds2.length === 0) {
+      throw new RelayError({
+        code: "invalid_arguments",
+        message: `${TOOL_NAMES.GROUP} add requires tabIds.`,
+        tool: TOOL_NAMES.GROUP,
+        phase: "parse_arguments",
+        details: { field: "tabIds" },
+        retryable: false
+      });
+    }
+    return { action: "add", name: requireString(obj, "name", TOOL_NAMES.GROUP), tabIds: tabIds2 };
+  }
+  const tabIds = parseTabIds(obj.tabIds);
+  if (tabIds.length === 0) {
+    throw new RelayError({
+      code: "invalid_arguments",
+      message: `${TOOL_NAMES.GROUP} create requires at least one tabId.`,
+      tool: TOOL_NAMES.GROUP,
+      phase: "parse_arguments",
+      details: { field: "tabIds" },
+      retryable: false
+    });
+  }
+  const out = {
+    action: "create",
+    name: requireString(obj, "name", TOOL_NAMES.GROUP),
+    tabIds
+  };
+  const color = parseColor(obj.color);
+  if (color)
+    out.color = color;
+  const collapsed = optBool(obj, "collapsed");
+  if (collapsed !== void 0)
+    out.collapsed = collapsed;
+  const windowId = optNumber(obj, "windowId");
+  if (windowId !== void 0)
+    out.windowId = windowId;
+  return out;
+}
+function parseChromeScreencastArgs(input) {
+  const obj = asObject(input, TOOL_NAMES.SCREENCAST);
+  const target = parseTargetArgs(obj);
+  const action = typeof obj.action === "string" ? obj.action : "start";
+  if (!VALID_SCREENCAST_ACTIONS.includes(action)) {
+    invalidAction(TOOL_NAMES.SCREENCAST, action, VALID_SCREENCAST_ACTIONS);
+  }
+  if (action === "stop")
+    return { ...target, action: "stop" };
+  const out = {
+    ...target,
+    action: "start"
+  };
+  if (obj.format !== void 0 && obj.format !== null) {
+    if (obj.format !== "jpeg" && obj.format !== "png") {
+      throw new RelayError({
+        code: "invalid_arguments",
+        message: `${TOOL_NAMES.SCREENCAST}: invalid format ${JSON.stringify(obj.format)}. Expected "jpeg" or "png".`,
+        tool: TOOL_NAMES.SCREENCAST,
+        phase: "parse_format",
+        details: { received: obj.format, validChoices: VALID_SCREENCAST_FORMATS },
+        retryable: false
+      });
+    }
+    out.format = obj.format;
+  }
+  const q = optNumber(obj, "quality");
+  if (q !== void 0)
+    out.quality = q;
+  const mw = optNumber(obj, "maxWidth");
+  if (mw !== void 0)
+    out.maxWidth = mw;
+  const mh = optNumber(obj, "maxHeight");
+  if (mh !== void 0)
+    out.maxHeight = mh;
+  const en = optNumber(obj, "everyNthFrame");
+  if (en !== void 0)
+    out.everyNthFrame = en;
+  return out;
+}
+var VALID_VIEWPORT_ACTIONS, VALID_CONSOLE_ACTIONS, VALID_CONSOLE_LEVELS, VALID_WORKSPACE_ACTIONS, VALID_GROUP_ACTIONS, VALID_GROUP_COLORS, VALID_SCREENCAST_ACTIONS, VALID_SCREENCAST_FORMATS;
+var init_multi = __esm({
+  "../protocol/dist/args/multi.js"() {
+    "use strict";
+    init_dist();
+    init_shared();
+    VALID_VIEWPORT_ACTIONS = ["set", "preset", "clear", "list"];
+    VALID_CONSOLE_ACTIONS = ["read", "clear"];
+    VALID_CONSOLE_LEVELS = ["log", "info", "warn", "error", "debug", "exception"];
+    VALID_WORKSPACE_ACTIONS = ["create", "list", "close"];
+    VALID_GROUP_ACTIONS = ["create", "list", "close", "add", "remove"];
+    VALID_GROUP_COLORS = ["grey", "blue", "red", "yellow", "green", "pink", "purple", "cyan", "orange"];
+    VALID_SCREENCAST_ACTIONS = ["start", "stop"];
+    VALID_SCREENCAST_FORMATS = ["jpeg", "png"];
+  }
+});
+
 // ../protocol/dist/args/index.js
 var init_args = __esm({
   "../protocol/dist/args/index.js"() {
@@ -234,6 +749,8 @@ var init_args = __esm({
     init_navigate();
     init_hover();
     init_network();
+    init_simple();
+    init_multi();
   }
 });
 
@@ -253,9 +770,27 @@ __export(dist_exports, {
   optBool: () => optBool,
   optNumber: () => optNumber,
   optString: () => optString,
+  parseChromeAxArgs: () => parseChromeAxArgs,
+  parseChromeClickArgs: () => parseChromeClickArgs,
+  parseChromeClickAxArgs: () => parseChromeClickAxArgs,
+  parseChromeCloseTabsArgs: () => parseChromeCloseTabsArgs,
+  parseChromeConsoleArgs: () => parseChromeConsoleArgs,
+  parseChromeEvaluateArgs: () => parseChromeEvaluateArgs,
+  parseChromeFillArgs: () => parseChromeFillArgs,
+  parseChromeGroupArgs: () => parseChromeGroupArgs,
   parseChromeHoverArgs: () => parseChromeHoverArgs,
+  parseChromeKeyboardArgs: () => parseChromeKeyboardArgs,
   parseChromeNavigateArgs: () => parseChromeNavigateArgs,
   parseChromeNetworkArgs: () => parseChromeNetworkArgs,
+  parseChromeReadPageArgs: () => parseChromeReadPageArgs,
+  parseChromeScreencastArgs: () => parseChromeScreencastArgs,
+  parseChromeScreenshotArgs: () => parseChromeScreenshotArgs,
+  parseChromeSelfReloadArgs: () => parseChromeSelfReloadArgs,
+  parseChromeSwitchTabArgs: () => parseChromeSwitchTabArgs,
+  parseChromeTypeArgs: () => parseChromeTypeArgs,
+  parseChromeViewportArgs: () => parseChromeViewportArgs,
+  parseChromeWorkspaceArgs: () => parseChromeWorkspaceArgs,
+  parseGetWindowsAndTabsArgs: () => parseGetWindowsAndTabsArgs,
   parseTargetArgs: () => parseTargetArgs,
   requireString: () => requireString,
   toBridgeError: () => toBridgeError
@@ -368,7 +903,7 @@ var init_dist = __esm({
 import { Command } from "commander";
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.12" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.14" : "0.0.0-dev";
 
 // src/commands/shared.ts
 init_dist();
@@ -416,6 +951,11 @@ async function callTool(name, args) {
 }
 
 // src/commands/shared.ts
+function makeWithBase(baseArgs) {
+  return function withBase(opts, extras) {
+    return { ...baseArgs(opts), ...extras ?? {} };
+  };
+}
 function tabOpt(cmd) {
   return cmd.option("-t, --tab <id>", "target tab ID", (v) => Number(v)).option("--workspace <name>", "target the active tab in a named workspace window (see `chrome-relay workspace`)").option("--group <name>", "target the active tab in a named tab-group (see `chrome-relay group`)");
 }
@@ -602,6 +1142,22 @@ async function runDoctor() {
 
 // src/release-notes.ts
 var RELEASE_NOTES = {
+  "0.5.14": [
+    "Optional parser fields are now strict \u2014 passing a present-but-wrong-type value (e.g. `{newTab: 'yes'}` instead of `true`) throws RelayError(invalid_arguments) instead of silently being dropped. undefined/null still means 'caller omitted the field' and the handler uses its default.",
+    "parseTargetArgs is strict too: `{tabId: '5'}` rejects (numeric tabId required). Navigate is the one exception \u2014 it coerces string tabId for back-compat since it's used as a 'reference window' rather than a strict target.",
+    "CLI tab-group --tabs arg now forwarded as the raw comma-separated string. The protocol parser (parseChromeGroupArgs) does the strict per-element parsing so `--tabs 1,foo,3` errors instead of silently becoming [1,3].",
+    "Deleted the dead duplicate parser module at apps/extension/src/browser/parsers.ts and its test file. The protocol parsers replace them; behavior identical.",
+    "HAR creator.version now reads from chrome.runtime.getManifest() instead of the hardcoded stale '0.2.x'. Drift-proof.",
+    "New CLI helper `withBase(opts, extras)` collapses the `const args = {}; Object.assign(args, baseArgs(opts)); args.foo = bar` pattern into one expression. All four command modules migrated \u2014 `Object.assign(args, baseArgs(opts))` is gone from the codebase.",
+    "Tests: +2 strict-optional cases. Total 407 (was 433 \u2014 28 dropped were duplicates of protocol parsers)."
+  ],
+  "0.5.13": [
+    "Protocol arg-parser coverage complete (code-quality-hardening Risk 1 \u2014 finished). Every one of the 22 tools now has an executable parser in @chrome-relay/protocol that returns a typed args object with `code:'invalid_arguments'` errors on malformed input.",
+    "New parsers in this release: parseChrome{ReadPage,Click,Fill,Keyboard,Type,Evaluate,SwitchTab,CloseTabs,Ax,ClickAx,Screenshot,Viewport,Console,Workspace,Group,Screencast}Args, plus parseGetWindowsAndTabsArgs and parseChromeSelfReloadArgs.",
+    "All extension handlers now consume their parser at the top of the handler body \u2014 silent shape drift between CLI and extension is structurally impossible.",
+    "Multi-action tools (viewport, console, network, workspace, group, screencast) return discriminated unions so the handler branches with TypeScript narrowing instead of `typeof args.action === 'string'` boilerplate.",
+    "36 new tests in packages/protocol/test/args-all.test.ts. Total now 433 (was 397)."
+  ],
   "0.5.12": [
     "Protocol-owned tool arg parsers (code-quality-hardening Risk 1). New @chrome-relay/protocol exports: `parseChromeNavigateArgs`, `parseChromeHoverArgs`, `parseChromeNetworkArgs`. Each is the single source of truth for what its tool accepts \u2014 CLI and extension consume the same parser so silent shape drift can't happen.",
     "Pattern established with 3 representative tools (navigate, hover, network \u2014 the doc-followup explicitly named these). Remaining 19 tools are mechanical follow-up (~20 lines + tests each). Each parser throws `RelayError(invalid_arguments)` with field/received/validChoices in details.",
@@ -794,7 +1350,7 @@ function registerInstallUpdate(program) {
 
 // src/commands/navigation.ts
 function registerNavigation(ctx) {
-  const { program, baseArgs, run } = ctx;
+  const { program, withBase, run } = ctx;
   program.command("tabs [verb]").description("List open Chrome windows and tabs. (verb 'list' is accepted as alias)").action(async (verb) => {
     if (verb && verb !== "list") {
       process.stderr.write(`unknown tabs verb: ${verb}. Use 'tabs' or 'tabs list'.
@@ -823,11 +1379,10 @@ Use "chrome-relay switch ${url}" to activate that tab, or "chrome-relay navigate
       );
       process.exit(1);
     }
-    const args = { url };
-    Object.assign(args, baseArgs(opts));
-    if (opts.new) args.newTab = true;
-    if (opts.inactive) args.active = false;
-    await run("chrome_navigate", args);
+    const extras = { url };
+    if (opts.new) extras.newTab = true;
+    if (opts.inactive) extras.active = false;
+    await run("chrome_navigate", withBase(opts, extras));
   });
   program.command("switch <tabId>").description("Activate a tab by ID.").action(async (tabId) => {
     await run("chrome_switch_tab", { tabId: Number(tabId) });
@@ -843,20 +1398,16 @@ Use "chrome-relay switch ${url}" to activate that tab, or "chrome-relay navigate
 
 // src/commands/input.ts
 function registerInput(ctx) {
-  const { program, baseArgs, run } = ctx;
+  const { program, withBase, run } = ctx;
   tabOpt(
     program.command("click <selector>").description("Click an element by CSS selector.")
   ).action(async (selector, opts) => {
-    const args = { selector };
-    Object.assign(args, baseArgs(opts));
-    await run("chrome_click_element", args);
+    await run("chrome_click_element", withBase(opts, { selector }));
   });
   tabOpt(
     program.command("fill <selector> <value>").description("Fill an input or textarea.")
   ).action(async (selector, value, opts) => {
-    const args = { selector, value };
-    Object.assign(args, baseArgs(opts));
-    await run("chrome_fill_or_select", args);
+    await run("chrome_fill_or_select", withBase(opts, { selector, value }));
   });
   tabOpt(
     program.command("keys <keys>").description("Press a single key or chord via trusted CDP input (e.g. Enter, Cmd+K).").addHelpText(
@@ -873,9 +1424,7 @@ For typing text into a field, use \`chrome-relay type\` instead.
 `
     )
   ).action(async (keys, opts) => {
-    const args = { keys };
-    Object.assign(args, baseArgs(opts));
-    await run("chrome_keyboard", args);
+    await run("chrome_keyboard", withBase(opts, { keys }));
   });
   tabOpt(
     program.command("type <text>").description("Insert text via trusted CDP input. Works in contenteditable / Draft.js / Lexical.").option("-s, --selector <selector>", "focus this element first").addHelpText(
@@ -894,10 +1443,9 @@ When to pick which:
 `
     )
   ).action(async (text, opts) => {
-    const args = { text };
-    Object.assign(args, baseArgs(opts));
-    if (opts.selector) args.selector = opts.selector;
-    await run("chrome_type", args);
+    const extras = { text };
+    if (opts.selector) extras.selector = opts.selector;
+    await run("chrome_type", withBase(opts, extras));
   });
   tabOpt(
     program.command("js <code>").description("Evaluate JavaScript in the page MAIN world. Use `return` for the value.").option("--timeout-ms <ms>", "execution timeout in milliseconds (default 15000)", (v) => Number(v)).addHelpText(
@@ -916,10 +1464,9 @@ Notes:
 `
     )
   ).action(async (code, opts) => {
-    const args = { code };
-    Object.assign(args, baseArgs(opts));
-    if (typeof opts.timeoutMs === "number") args.timeoutMs = opts.timeoutMs;
-    await run("chrome_evaluate", args);
+    const extras = { code };
+    if (typeof opts.timeoutMs === "number") extras.timeoutMs = opts.timeoutMs;
+    await run("chrome_evaluate", withBase(opts, extras));
   });
   tabOpt(
     program.command("hover [selector]").description("Move the pointer over an element or coordinates. Fires :hover styles.").option("--x <px>", "explicit x coordinate (CSS pixels)", (v) => Number(v)).option("--y <px>", "explicit y coordinate (CSS pixels)", (v) => Number(v)).addHelpText(
@@ -935,21 +1482,20 @@ tooltip appearance, etc.) that a bare click would skip past too quickly.
 `
     )
   ).action(async (selector, opts) => {
-    const args = {};
-    Object.assign(args, baseArgs(opts));
-    if (selector) args.selector = selector;
+    const extras = {};
+    if (selector) extras.selector = selector;
     if (typeof opts.x === "number" && typeof opts.y === "number") {
-      args.x = opts.x;
-      args.y = opts.y;
+      extras.x = opts.x;
+      extras.y = opts.y;
     }
-    await run("chrome_hover", args);
+    await run("chrome_hover", withBase(opts, extras));
   });
 }
 
 // src/commands/capture.ts
 import { writeFileSync } from "fs";
 function registerCapture(ctx) {
-  const { program, baseArgs, run } = ctx;
+  const { program, withBase, run } = ctx;
   tabOpt(
     program.command("screenshot").description("Capture a screenshot of any tab without activating it.").option("--full", "capture beyond the viewport (full page)").option("--bbox <rect>", "capture a region: 'x,y,width,height' (pixels)").option("--selector <css>", "capture the bounding box of a CSS selector").option("--padding <px>", "pixels of padding around --selector region", (v) => Number(v)).option("--max-edge <px>", "downscale so longer edge \u2264 this many pixels (no default; opt-in)", (v) => Number(v)).option("-o, --out <path>", "save image to path (base64 PNG decoded)").addHelpText(
       "after",
@@ -968,13 +1514,13 @@ full-tab screenshot when an agent only needs to see one component.
 `
     )
   ).action(async (opts) => {
-    const args = {};
-    Object.assign(args, baseArgs(opts));
-    if (opts.full) args.fullPage = true;
-    if (opts.bbox) args.bbox = opts.bbox;
-    if (opts.selector) args.selector = opts.selector;
-    if (typeof opts.padding === "number") args.padding = opts.padding;
-    if (typeof opts.maxEdge === "number") args.maxEdge = opts.maxEdge;
+    const extras = {};
+    if (opts.full) extras.fullPage = true;
+    if (opts.bbox) extras.bbox = opts.bbox;
+    if (opts.selector) extras.selector = opts.selector;
+    if (typeof opts.padding === "number") extras.padding = opts.padding;
+    if (typeof opts.maxEdge === "number") extras.maxEdge = opts.maxEdge;
+    const args = withBase(opts, extras);
     try {
       const result = await callTool("chrome_screenshot", args);
       if (opts.out && result && typeof result === "object") {
@@ -998,10 +1544,9 @@ full-tab screenshot when an agent only needs to see one component.
   tabOpt(
     program.command("read").description("Extract page structure and interactive elements.").option("-i, --interactive", "return only interactive elements")
   ).action(async (opts) => {
-    const args = {};
-    Object.assign(args, baseArgs(opts));
-    if (opts.interactive) args.interactiveOnly = true;
-    await run("chrome_read_page", args);
+    const extras = {};
+    if (opts.interactive) extras.interactiveOnly = true;
+    await run("chrome_read_page", withBase(opts, extras));
   });
   tabOpt(
     program.command("ax").description("Extract the accessibility tree \u2014 ~30\xD7 smaller than `read` and more semantic.").option("-i, --interactive-only", "filter to actionable roles (button, link, textbox, ...)").option("--root <role>", "start from the first node matching this role (e.g. 'main')").option("--include-subframes", "walk subframes too (default: top frame only)").addHelpText(
@@ -1019,11 +1564,11 @@ Notes:
 `
     )
   ).action(async (opts) => {
-    const args = baseArgs(opts);
-    if (opts.interactiveOnly) args.interactiveOnly = true;
-    if (opts.root) args.rootRole = opts.root;
-    if (opts.includeSubframes) args.includeSubframes = true;
-    await run("chrome_ax", args);
+    const extras = {};
+    if (opts.interactiveOnly) extras.interactiveOnly = true;
+    if (opts.root) extras.rootRole = opts.root;
+    if (opts.includeSubframes) extras.includeSubframes = true;
+    await run("chrome_ax", withBase(opts, extras));
   });
   tabOpt(
     program.command("click-ax").description("Click an element by its backendDOMNodeId from a previous `ax` call.").requiredOption("--node <id>", "backendDOMNodeId from `chrome-relay ax`", (v) => Number(v)).addHelpText(
@@ -1039,9 +1584,7 @@ Notes:
 `
     )
   ).action(async (opts) => {
-    const args = baseArgs(opts);
-    args.node = opts.node;
-    await run("chrome_click_ax", args);
+    await run("chrome_click_ax", withBase(opts, { node: opts.node }));
   });
   const screencast = program.command("screencast").description("Record a tab via CDP (paint-driven). Requires an active tab.").addHelpText(
     "after",
@@ -1066,20 +1609,18 @@ Notes:
   tabOpt(
     screencast.command("start").description("Begin screencast capture on a tab.").option("--format <fmt>", "jpeg | png (default jpeg)").option("--quality <n>", "jpeg quality 0-100 (default 80)", (v) => Number(v)).option("--max-width <px>", "downscale; aspect preserved", (v) => Number(v)).option("--max-height <px>", "downscale; aspect preserved", (v) => Number(v)).option("--every-nth <n>", "throttle: keep 1 in N frames (default 1)", (v) => Number(v))
   ).action(async (opts) => {
-    const args = { action: "start" };
-    Object.assign(args, baseArgs(opts));
-    if (opts.format) args.format = opts.format;
-    if (typeof opts.quality === "number") args.quality = opts.quality;
-    if (typeof opts.maxWidth === "number") args.maxWidth = opts.maxWidth;
-    if (typeof opts.maxHeight === "number") args.maxHeight = opts.maxHeight;
-    if (typeof opts.everyNth === "number") args.everyNthFrame = opts.everyNth;
-    await run("chrome_screencast", args);
+    const extras = { action: "start" };
+    if (opts.format) extras.format = opts.format;
+    if (typeof opts.quality === "number") extras.quality = opts.quality;
+    if (typeof opts.maxWidth === "number") extras.maxWidth = opts.maxWidth;
+    if (typeof opts.maxHeight === "number") extras.maxHeight = opts.maxHeight;
+    if (typeof opts.everyNth === "number") extras.everyNthFrame = opts.everyNth;
+    await run("chrome_screencast", withBase(opts, extras));
   });
   tabOpt(
     screencast.command("stop").description("Stop the screencast and emit frames (or write to disk).").option("-o, --out <dir>", "write frames as JPEGs into this directory (created if missing)").option("--gif", "after writing frames, ffmpeg them into <dir>.gif (requires ffmpeg on PATH)").option("--mp4", "after writing frames, ffmpeg them into <dir>.mp4 (requires ffmpeg on PATH)").option("--fps <n>", "assumed framerate when invoking ffmpeg (default 15)", (v) => Number(v)).option("--no-dedupe", "keep raw frames; default collapses consecutive identical frames via SHA-256").option("--allow-missing-ffmpeg", "with --gif/--mp4: skip ffmpeg step (and emit a warning) if ffmpeg isn't on PATH, instead of failing with external_dependency_missing")
   ).action(async (opts) => {
-    const args = { action: "stop" };
-    Object.assign(args, baseArgs(opts));
+    const args = withBase(opts, { action: "stop" });
     try {
       const result = await callTool("chrome_screencast", args);
       if (!opts.out) {
@@ -1214,7 +1755,7 @@ function netFilterArgs(opts) {
   return a;
 }
 function registerSessions(ctx) {
-  const { program, baseArgs, run } = ctx;
+  const { program, withBase, run } = ctx;
   const viewport = program.command("viewport").description("Emulate device viewport, DPR, mobile flag, touch, and user agent.").addHelpText(
     "after",
     `
@@ -1235,27 +1776,22 @@ Notes:
   tabOpt(
     viewport.command("set").description("Apply explicit viewport dimensions.").requiredOption("--width <px>", "viewport width in CSS pixels", (v) => Number(v)).requiredOption("--height <px>", "viewport height in CSS pixels", (v) => Number(v)).option("--dpr <ratio>", "device pixel ratio (1, 2, 3...)", (v) => Number(v)).option("--mobile", "set the mobile flag (affects meta viewport interpretation)").option("--touch", "enable touch event emulation").option("--user-agent <ua>", "override the User-Agent header")
   ).action(async (opts) => {
-    const args = { action: "set", width: opts.width, height: opts.height };
-    Object.assign(args, baseArgs(opts));
-    if (opts.dpr !== void 0) args.dpr = opts.dpr;
-    if (opts.mobile) args.mobile = true;
-    if (opts.touch) args.hasTouch = true;
-    if (opts.userAgent) args.userAgent = opts.userAgent;
-    await run("chrome_viewport", args);
+    const extras = { action: "set", width: opts.width, height: opts.height };
+    if (opts.dpr !== void 0) extras.dpr = opts.dpr;
+    if (opts.mobile) extras.mobile = true;
+    if (opts.touch) extras.hasTouch = true;
+    if (opts.userAgent) extras.userAgent = opts.userAgent;
+    await run("chrome_viewport", withBase(opts, extras));
   });
   tabOpt(
     viewport.command("preset <name>").description("Apply a named device preset (iphone-14, pixel-7, desktop-1440, etc).")
   ).action(async (name, opts) => {
-    const args = { action: "preset", name };
-    Object.assign(args, baseArgs(opts));
-    await run("chrome_viewport", args);
+    await run("chrome_viewport", withBase(opts, { action: "preset", name }));
   });
   tabOpt(
     viewport.command("clear").description("Drop the viewport override and return the tab to its native size.")
   ).action(async (opts) => {
-    const args = { action: "clear" };
-    Object.assign(args, baseArgs(opts));
-    await run("chrome_viewport", args);
+    await run("chrome_viewport", withBase(opts, { action: "clear" }));
   });
   viewport.command("list").description("List available presets.").action(async () => {
     await run("chrome_viewport", { action: "list" });
@@ -1316,8 +1852,7 @@ Notes:
 `
   );
   group.command("create <name>").description("Group existing tabs into a new tab-group bound to <name>.").requiredOption("--tabs <ids>", "comma-separated tab IDs to group, e.g. 123,456,789").option("--color <color>", "grey | blue | red | yellow | green | pink | purple | cyan | orange").option("--collapsed", "create the group in its collapsed state").action(async (name, opts) => {
-    const args = { action: "create", name };
-    args.tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
+    const args = { action: "create", name, tabIds: String(opts.tabs) };
     if (opts.color) args.color = opts.color;
     if (opts.collapsed) args.collapsed = true;
     await run("chrome_group", args);
@@ -1329,12 +1864,10 @@ Notes:
     await run("chrome_group", { action: "close", name });
   });
   group.command("add <name>").description("Add existing tabs to an existing tab-group.").requiredOption("--tabs <ids>", "comma-separated tab IDs to add").action(async (name, opts) => {
-    const tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
-    await run("chrome_group", { action: "add", name, tabIds });
+    await run("chrome_group", { action: "add", name, tabIds: String(opts.tabs) });
   });
   group.command("remove").description("Ungroup specific tabs (they remain open, just outside any tab-group).").requiredOption("--tabs <ids>", "comma-separated tab IDs to ungroup").action(async (opts) => {
-    const tabIds = String(opts.tabs).split(",").map((s) => Number(s.trim())).filter(Number.isFinite);
-    await run("chrome_group", { action: "remove", tabIds });
+    await run("chrome_group", { action: "remove", tabIds: String(opts.tabs) });
   });
   const network = tabOpt(netFilterOpts(
     program.command("network").description("Capture HTTP request/response metadata. Ring buffer, last 200 per tab.")
@@ -1364,41 +1897,38 @@ Notes:
   WebSocket frames and SSE streams are out of scope.
 `
   ).action(async (opts) => {
-    const args = { ...baseArgs(opts), ...netFilterArgs(opts) };
-    await run("chrome_network", args);
+    await run("chrome_network", withBase(opts, netFilterArgs(opts)));
   });
   tabOpt(netFilterOpts(
     network.command("read").description("(alias) list captured network entries.")
   )).action(async (opts) => {
-    const args = { ...baseArgs(opts), ...netFilterArgs(opts) };
-    await run("chrome_network", args);
+    await run("chrome_network", withBase(opts, netFilterArgs(opts)));
   });
   tabOpt(
     network.command("body <requestId>").description("Fetch the response body for one request (lazy; may fail if GC'd).").option("--head <bytes>", "truncate to first N bytes", (v) => Number(v)).option("--full", "return the full body \u2014 default truncates to 8 KB")
   ).action(async (requestId, opts) => {
-    const args = { ...baseArgs(opts), action: "body", requestId };
-    if (opts.full) args.full = true;
-    if (typeof opts.head === "number") args.head = opts.head;
-    await run("chrome_network", args);
+    const extras = { action: "body", requestId };
+    if (opts.full) extras.full = true;
+    if (typeof opts.head === "number") extras.head = opts.head;
+    await run("chrome_network", withBase(opts, extras));
   });
   tabOpt(netFilterOpts(
     network.command("har").description("Emit HAR-compatible JSON for the captured entries.").option("--with-bodies", "fetch response bodies before emitting; strict by default \u2014 fails if any body cannot be fetched").option("--best-effort-bodies", "with --with-bodies: keep the HAR even when some bodies are missing/errored (legacy behavior); per-entry _chrome_relay.bodyState/bodyError records what failed")
   )).action(async (opts) => {
-    const args = { ...baseArgs(opts), ...netFilterArgs(opts), action: "har" };
-    if (opts.withBodies) args.withBodies = true;
-    if (opts.bestEffortBodies) args.bestEffortBodies = true;
+    const extras = { ...netFilterArgs(opts), action: "har" };
+    if (opts.withBodies) extras.withBodies = true;
+    if (opts.bestEffortBodies) extras.bestEffortBodies = true;
     if (!opts.withBodies) {
       process.stderr.write(
         "[chrome-relay] HAR exported WITHOUT response bodies. Pass --with-bodies to include them (strict by default; add --best-effort-bodies to allow per-entry misses).\n"
       );
     }
-    await run("chrome_network", args);
+    await run("chrome_network", withBase(opts, extras));
   });
   tabOpt(
     network.command("clear").description("Wipe the network buffer for this tab.")
   ).action(async (opts) => {
-    const args = { ...baseArgs(opts), action: "clear" };
-    await run("chrome_network", args);
+    await run("chrome_network", withBase(opts, { action: "clear" }));
   });
   tabOpt(
     program.command("console").description("Read console.log/warn/error + page exceptions (ring buffer, last 200).").option("--level <levels>", "comma-separated: log,info,warn,error,debug,exception").option("--since <id>", "only return entries with id > since (live-tail-ish)", (v) => Number(v)).option("--limit <n>", "cap response length", (v) => Number(v)).option("--clear", "wipe the buffer (no read)").addHelpText(
@@ -1418,12 +1948,12 @@ Notes:
 `
     )
   ).action(async (opts) => {
-    const args = baseArgs(opts);
-    if (opts.clear) args.action = "clear";
-    if (opts.level) args.levels = opts.level;
-    if (typeof opts.since === "number") args.since = opts.since;
-    if (typeof opts.limit === "number") args.limit = opts.limit;
-    await run("chrome_console", args);
+    const extras = {};
+    if (opts.clear) extras.action = "clear";
+    if (opts.level) extras.levels = opts.level;
+    if (typeof opts.since === "number") extras.since = opts.since;
+    if (typeof opts.limit === "number") extras.limit = opts.limit;
+    await run("chrome_console", withBase(opts, extras));
   });
 }
 
@@ -1450,9 +1980,11 @@ Notes:
   Tools attach via CDP and run on backgrounded tabs without stealing focus.
 `
   );
+  const baseArgs = makeBaseArgs(program);
   const ctx = {
     program,
-    baseArgs: makeBaseArgs(program),
+    baseArgs,
+    withBase: makeWithBase(baseArgs),
     run: runTool
   };
   registerInstallUpdate(program);

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.12" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.14" : "0.0.0-dev";
 export {
   CHROME_RELAY_VERSION
 };

package/dist/native-host.js

@@ -48,7 +48,7 @@ function toBridgeError(unknownErr, fallbackTool) {
 }
 
 // src/index.ts
-var CHROME_RELAY_VERSION = true ? "0.5.12" : "0.0.0-dev";
+var CHROME_RELAY_VERSION = true ? "0.5.14" : "0.0.0-dev";
 
 // src/release-notes.ts
 function compareSemver(a, b) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-relay",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",