browsentic 0.4.15 → 0.6.0

package/dist/cli.js

@@ -2131,7 +2131,7 @@ var require_extension = __commonJS({
       let inQuotes = false;
       let extensionName;
       let paramName;
-      let start = -1;
+      let start2 = -1;
       let code = -1;
       let end = -1;
       let i = 0;
@@ -2139,45 +2139,45 @@ var require_extension = __commonJS({
         code = header.charCodeAt(i);
         if (extensionName === void 0) {
           if (end === -1 && tokenChars[code] === 1) {
-            if (start === -1) start = i;
+            if (start2 === -1) start2 = i;
           } else if (i !== 0 && (code === 32 || code === 9)) {
-            if (end === -1 && start !== -1) end = i;
+            if (end === -1 && start2 !== -1) end = i;
           } else if (code === 59 || code === 44) {
-            if (start === -1) {
+            if (start2 === -1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
             if (end === -1) end = i;
-            const name = header.slice(start, end);
+            const name = header.slice(start2, end);
             if (code === 44) {
               push(offers, name, params);
               params = /* @__PURE__ */ Object.create(null);
             } else {
               extensionName = name;
             }
-            start = end = -1;
+            start2 = end = -1;
           } else {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
         } else if (paramName === void 0) {
           if (end === -1 && tokenChars[code] === 1) {
-            if (start === -1) start = i;
+            if (start2 === -1) start2 = i;
           } else if (code === 32 || code === 9) {
-            if (end === -1 && start !== -1) end = i;
+            if (end === -1 && start2 !== -1) end = i;
           } else if (code === 59 || code === 44) {
-            if (start === -1) {
+            if (start2 === -1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
             if (end === -1) end = i;
-            push(params, header.slice(start, end), true);
+            push(params, header.slice(start2, end), true);
             if (code === 44) {
               push(offers, extensionName, params);
               params = /* @__PURE__ */ Object.create(null);
               extensionName = void 0;
             }
-            start = end = -1;
-          } else if (code === 61 && start !== -1 && end === -1) {
-            paramName = header.slice(start, i);
-            start = end = -1;
+            start2 = end = -1;
+          } else if (code === 61 && start2 !== -1 && end === -1) {
+            paramName = header.slice(start2, i);
+            start2 = end = -1;
           } else {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
@@ -2186,13 +2186,13 @@ var require_extension = __commonJS({
             if (tokenChars[code] !== 1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
-            if (start === -1) start = i;
+            if (start2 === -1) start2 = i;
             else if (!mustUnescape) mustUnescape = true;
             isEscaping = false;
           } else if (inQuotes) {
             if (tokenChars[code] === 1) {
-              if (start === -1) start = i;
-            } else if (code === 34 && start !== -1) {
+              if (start2 === -1) start2 = i;
+            } else if (code === 34 && start2 !== -1) {
               inQuotes = false;
               end = i;
             } else if (code === 92) {
@@ -2203,15 +2203,15 @@ var require_extension = __commonJS({
           } else if (code === 34 && header.charCodeAt(i - 1) === 61) {
             inQuotes = true;
           } else if (end === -1 && tokenChars[code] === 1) {
-            if (start === -1) start = i;
-          } else if (start !== -1 && (code === 32 || code === 9)) {
+            if (start2 === -1) start2 = i;
+          } else if (start2 !== -1 && (code === 32 || code === 9)) {
             if (end === -1) end = i;
           } else if (code === 59 || code === 44) {
-            if (start === -1) {
+            if (start2 === -1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
             if (end === -1) end = i;
-            let value = header.slice(start, end);
+            let value = header.slice(start2, end);
             if (mustUnescape) {
               value = value.replace(/\\/g, "");
               mustUnescape = false;
@@ -2223,17 +2223,17 @@ var require_extension = __commonJS({
               extensionName = void 0;
             }
             paramName = void 0;
-            start = end = -1;
+            start2 = end = -1;
           } else {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
         }
       }
-      if (start === -1 || inQuotes || code === 32 || code === 9) {
+      if (start2 === -1 || inQuotes || code === 32 || code === 9) {
         throw new SyntaxError("Unexpected end of input");
       }
       if (end === -1) end = i;
-      const token = header.slice(start, end);
+      const token = header.slice(start2, end);
       if (extensionName === void 0) {
         push(offers, token, params);
       } else {
@@ -3268,34 +3268,34 @@ var require_subprotocol = __commonJS({
     var { tokenChars } = require_validation();
     function parse3(header) {
       const protocols = /* @__PURE__ */ new Set();
-      let start = -1;
+      let start2 = -1;
       let end = -1;
       let i = 0;
       for (i; i < header.length; i++) {
         const code = header.charCodeAt(i);
         if (end === -1 && tokenChars[code] === 1) {
-          if (start === -1) start = i;
+          if (start2 === -1) start2 = i;
         } else if (i !== 0 && (code === 32 || code === 9)) {
-          if (end === -1 && start !== -1) end = i;
+          if (end === -1 && start2 !== -1) end = i;
         } else if (code === 44) {
-          if (start === -1) {
+          if (start2 === -1) {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
           if (end === -1) end = i;
-          const protocol2 = header.slice(start, end);
+          const protocol2 = header.slice(start2, end);
           if (protocols.has(protocol2)) {
             throw new SyntaxError(`The "${protocol2}" subprotocol is duplicated`);
           }
           protocols.add(protocol2);
-          start = end = -1;
+          start2 = end = -1;
         } else {
           throw new SyntaxError(`Unexpected character at index ${i}`);
         }
       }
-      if (start === -1 || end !== -1) {
+      if (start2 === -1 || end !== -1) {
         throw new SyntaxError("Unexpected end of input");
       }
-      const protocol = header.slice(start, i);
+      const protocol = header.slice(start2, i);
       if (protocols.has(protocol)) {
         throw new SyntaxError(`The "${protocol}" subprotocol is duplicated`);
       }
@@ -11285,9 +11285,9 @@ function nullish(input2) {
   return input2 === null || input2 === void 0;
 }
 function cleanRegex(source) {
-  const start = source.startsWith("^") ? 1 : 0;
+  const start2 = source.startsWith("^") ? 1 : 0;
   const end = source.endsWith("$") ? source.length - 1 : source.length;
-  return source.slice(start, end);
+  return source.slice(start2, end);
 }
 function floatSafeRemainder(val, step) {
   const ratio = val / step;
@@ -14773,9 +14773,9 @@ var $ZodTemplateLiteral = /* @__PURE__ */ $constructor("$ZodTemplateLiteral", (i
       const source = part._zod.pattern instanceof RegExp ? part._zod.pattern.source : part._zod.pattern;
       if (!source)
         throw new Error(`Invalid template literal part: ${part._zod.traits}`);
-      const start = source.startsWith("^") ? 1 : 0;
+      const start2 = source.startsWith("^") ? 1 : 0;
       const end = source.endsWith("$") ? source.length - 1 : source.length;
-      regexParts.push(source.slice(start, end));
+      regexParts.push(source.slice(start2, end));
     } else if (part === null || primitiveTypes.has(typeof part)) {
       regexParts.push(escapeRegex(`${part}`));
     } else {
@@ -27722,14 +27722,14 @@ async function travel(from, to, steps, buttons, onStep) {
     else firePointer(elementAt(at), "pointermove", "mousemove", at, buttons);
   }
 }
-async function approachFrom(start, grip, over) {
-  await travel(start, grip, APPROACH_STEPS, 0);
+async function approachFrom(start2, grip, over) {
+  await travel(start2, grip, APPROACH_STEPS, 0);
   hoverSequence(over ?? document.body, grip);
 }
 async function pointerDrag(source, plan) {
-  const { approach: start, grip, drop, steps, holdMs, settleMs } = plan;
+  const { approach: start2, grip, drop, steps, holdMs, settleMs } = plan;
   const held = source ?? elementAt(grip);
-  await approachFrom(start, grip, held);
+  await approachFrom(start2, grip, held);
   firePointer(held, "pointerdown", "mousedown", grip, 1);
   await settle(holdMs);
   await travel(grip, drop, steps, 1);
@@ -27739,9 +27739,9 @@ async function pointerDrag(source, plan) {
   return { landedOn: landing ? cssPath(landing) : void 0 };
 }
 async function nativeDrag(source, plan) {
-  const { approach: start, grip, drop, steps, holdMs, settleMs } = plan;
+  const { approach: start2, grip, drop, steps, holdMs, settleMs } = plan;
   const dataTransfer = new DataTransfer();
-  await approachFrom(start, grip, source);
+  await approachFrom(start2, grip, source);
   firePointer(source, "pointerdown", "mousedown", grip, 1);
   await settle(holdMs);
   const started = fireDrag(source, "dragstart", grip, dataTransfer);
@@ -27836,14 +27836,14 @@ function digestOf(text3) {
   }
   return (hash3 >>> 0).toString(16).padStart(8, "0");
 }
-function groupEnd(text3, start, budget) {
-  if (text3.length - start <= budget) return text3.length;
-  const window2 = text3.slice(start, start + budget);
+function groupEnd(text3, start2, budget) {
+  if (text3.length - start2 <= budget) return text3.length;
+  const window2 = text3.slice(start2, start2 + budget);
   for (const { pattern, floor } of BOUNDARIES) {
     const cut = lastBoundary(window2, pattern, Math.floor(budget * floor));
-    if (cut > 0) return start + cut;
+    if (cut > 0) return start2 + cut;
   }
-  return start + budget;
+  return start2 + budget;
 }
 function writeCursor(offset, delivered) {
   return `${offset}.${digestOf(delivered)}`;
@@ -28284,6 +28284,54 @@ var focusInput = defineAction({
   }
 });
 
+// ../lib/actions/page/switch-frame.ts
+var switchFrame = defineAction({
+  name: "page.switchFrame",
+  description: 'Step into an <iframe> so that every later page action \u2014 reading, clicking, typing, waiting, site tools, injected code \u2014 runs inside it as if it were the page, or step back out. page.getPageInfo lists the frames the current document embeds under "frames"; pass one as "frame" to enter it, and call again from inside to go deeper. Call it with no arguments to return to the top document, or with to: "parent" to step out one level. The focus is per tab, clears when the tab navigates, and page.getPageInfo reports it under "frame" whenever it is not the top. A frame that forbids scripts (a sandbox without allow-scripts) or a browser-internal frame cannot be entered; page.screenshot and page.trustedClick by coordinates still reach those. page.screenshot and page.navigate always act on the whole tab.',
+  input: external_exports.object({
+    frame: targetSchema.optional().describe(
+      'The <iframe> or <frame> element to enter, matched inside the frame currently in focus \u2014 use a selector from the "frames" list of page.getPageInfo. Omit it to leave instead.'
+    ),
+    to: external_exports.enum(["top", "parent"]).default("top").describe('Where to go when no "frame" is given: "top" returns to the main document, "parent" steps out one level.')
+  }),
+  execute({ frame }) {
+    if (!frame) {
+      throw new ActionError("Leaving a frame is resolved by the Browsentic extension, not in the page", "UNSUPPORTED");
+    }
+    const el = resolveTarget(frame);
+    if (!isFrameElement(el)) {
+      throw new ActionError(
+        `${cssPath(el)} is a <${el.tagName.toLowerCase()}>, not an <iframe> \u2014 pick one of the frames page.getPageInfo lists`,
+        "INVALID_TARGET"
+      );
+    }
+    return {
+      frameId: frameIdOf(el),
+      src: el.src || void 0,
+      name: el.name || void 0,
+      sandbox: sandboxOf(el),
+      ...describeElement(el)
+    };
+  }
+});
+function isFrameElement(el) {
+  return el instanceof HTMLIFrameElement || el instanceof HTMLFrameElement;
+}
+function sandboxOf(el) {
+  return el instanceof HTMLIFrameElement && el.hasAttribute("sandbox") ? el.sandbox.value || "all restrictions" : void 0;
+}
+function frameIdOf(target) {
+  const scope = globalThis;
+  const id = (scope.browser?.runtime?.getFrameId ?? scope.chrome?.runtime?.getFrameId)?.(target);
+  if (typeof id !== "number" || id < 0) {
+    throw new ActionError(
+      "This browser cannot identify frames from the page \u2014 entering a frame needs Chrome 116 or Firefox 96 or newer",
+      "UNSUPPORTED"
+    );
+  }
+  return id;
+}
+
 // ../lib/actions/page/get-page-info.ts
 var IMPLICIT_ROLES = {
   header: "banner",
@@ -28308,7 +28356,7 @@ var LANDMARK_ROLES = /* @__PURE__ */ new Set([
 ]);
 var getPageInfo = defineAction({
   name: "page.getPageInfo",
-  description: "Snapshot the current page: document metadata, viewport and scroll state, a semantic layout tree with a text diagram, the heading outline, and an inventory of interactive elements \u2014 each carrying its ARIA role, its live state (disabled, checked, expanded, filled, aria-current) and the landmark region it sits in. When the site registers WebMCP tools, the result also carries a siteTools list \u2014 prefer page.callSiteTool over clicking wherever a listed tool covers the step.",
+  description: 'Snapshot the current page: document metadata, viewport and scroll state, a semantic layout tree with a text diagram, the heading outline, and an inventory of interactive elements \u2014 each carrying its ARIA role, its live state (disabled, checked, expanded, filled, aria-current) and the landmark region it sits in. When the site registers WebMCP tools, the result also carries a siteTools list \u2014 prefer page.callSiteTool over clicking wherever a listed tool covers the step. Visible iframes come back under "frames"; nothing inside one is in this snapshot until page.switchFrame enters it, and "frame" then says which one is in focus.',
   input: external_exports.object({
     maxPerKind: external_exports.number().int().positive().default(30).describe("Cap on links, buttons, fields, and forms listed per kind")
   }),
@@ -28337,10 +28385,23 @@ var getPageInfo = defineAction({
         level: Number(heading.tagName[1]),
         text: accessibleText(heading).slice(0, 120)
       })),
-      interactive: inventory(found, owners, maxPerKind)
+      interactive: inventory(found, owners, maxPerKind),
+      frames: embeddedFrames()
     };
   }
 });
+var MAX_FRAMES = 20;
+function embeddedFrames() {
+  const frames = [...document.querySelectorAll("iframe,frame")].filter(isFrameElement).filter(isExposed).slice(0, MAX_FRAMES).map((frame) => ({
+    selector: cssPath(frame),
+    src: frame.src || void 0,
+    name: frame.name || void 0,
+    title: frame.title || void 0,
+    sandbox: sandboxOf(frame),
+    bounds: documentBounds(frame)
+  }));
+  return frames.length ? frames : void 0;
+}
 function regionRole(el) {
   const explicit = el.getAttribute("role");
   if (explicit) return LANDMARK_ROLES.has(explicit) ? explicit : void 0;
@@ -28906,12 +28967,12 @@ var pressKey = defineAction({
       el.dispatchEvent(new KeyboardEvent("keypress", init));
     }
     if (printable && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)) {
-      const start = el.selectionStart ?? el.value.length;
+      const start2 = el.selectionStart ?? el.value.length;
       const end = el.selectionEnd ?? el.value.length;
-      const next = el.value.slice(0, start) + key + el.value.slice(end);
+      const next = el.value.slice(0, start2) + key + el.value.slice(end);
       const proto = el instanceof HTMLInputElement ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype;
       Object.getOwnPropertyDescriptor(proto, "value")?.set?.call(el, next);
-      const caret = start + key.length;
+      const caret = start2 + key.length;
       try {
         el.setSelectionRange(caret, caret);
       } catch {
@@ -29789,7 +29850,7 @@ var typeText = defineAction({
     }
     if (clear) clearContent(el);
     focusForTyping(el);
-    const start = performance.now();
+    const start2 = performance.now();
     const characters = [...text3];
     for (const [index, char] of characters.entries()) {
       const wait = index ? Math.round(delays[index - 1] * (1 + (Math.random() * 2 - 1) * jitter)) : 0;
@@ -29811,7 +29872,7 @@ var typeText = defineAction({
       element: describeElement(el),
       typed: characters.length,
       charDelayMs: base,
-      elapsedMs: Math.round(performance.now() - start),
+      elapsedMs: Math.round(performance.now() - start2),
       appended: !clear,
       submitted
     };
@@ -29845,10 +29906,10 @@ function focusForTyping(el) {
 }
 function insertCharacter(el, char) {
   if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
-    const start = el.selectionStart ?? el.value.length;
+    const start2 = el.selectionStart ?? el.value.length;
     const end = el.selectionEnd ?? el.value.length;
-    setNativeValue(el, el.value.slice(0, start) + char + el.value.slice(end));
-    const caret = start + char.length;
+    setNativeValue(el, el.value.slice(0, start2) + char + el.value.slice(end));
+    const caret = start2 + char.length;
     try {
       el.setSelectionRange(caret, caret);
     } catch {
@@ -29894,7 +29955,7 @@ var waitForElement = defineAction({
       hidden: !el || !isVisible(el),
       detached: !el
     })[state];
-    const start = performance.now();
+    const start2 = performance.now();
     let element = find();
     if (satisfied(element)) {
       return { state, elapsedMs: 0, element: element ? describeElement(element) : void 0 };
@@ -29927,7 +29988,7 @@ var waitForElement = defineAction({
     });
     return {
       state,
-      elapsedMs: Math.round(performance.now() - start),
+      elapsedMs: Math.round(performance.now() - start2),
       element: element ? describeElement(element) : void 0
     };
   }
@@ -29979,6 +30040,7 @@ var actions = new Map(
     navigate,
     openTab,
     switchTab,
+    switchFrame,
     closeTab,
     screenshot,
     listFiles,
@@ -30229,6 +30291,21 @@ function settingsFor(stored, kind) {
   };
 }
 var text = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+function writeAgentModel(kind, model) {
+  const stored = readStored();
+  const agents = { ...stored.agents ?? {} };
+  const scoped = { ...agents[kind] ?? {} };
+  const value = text(model);
+  if (value) scoped.model = value;
+  else delete scoped.model;
+  if (Object.keys(scoped).length) agents[kind] = scoped;
+  else delete agents[kind];
+  const next = { ...stored };
+  if (Object.keys(agents).length) next.agents = agents;
+  else delete next.agents;
+  if (kind === "claude") delete next.model;
+  write(next);
+}
 function write(config2) {
   mkdirSync3(stateDir, { recursive: true, mode: 448 });
   writeFileSync2(configPath, `${JSON.stringify(config2, null, 2)}
@@ -31836,9 +31913,11 @@ import { homedir as homedir7 } from "os";
 import { dirname as dirname6, join as join15, resolve, sep as sep2 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 var packageRoot = resolve(dirname6(fileURLToPath5(import.meta.url)), "..");
+var APP_MARKER = ".browsentic-app.json";
 var inNpxCache = (path) => path.split(sep2).includes("_npx");
 function installKind() {
   if (inNpxCache(packageRoot)) return "npx";
+  if (existsSync5(join15(packageRoot, APP_MARKER))) return "app";
   if (existsSync5(join15(packageRoot, "tsup.config.ts"))) return "repo";
   return "global";
 }
@@ -32047,6 +32126,13 @@ async function upgradeCli(current, forward) {
     console.error(`
   ! browsentic ${latest} is published; this is ${current}, from a source checkout.`);
     console.error(`    Update it with "git pull && yarn setup".
+`);
+    return null;
+  }
+  if (kind === "app") {
+    console.error(`
+  ! browsentic ${latest} is published; this is ${current}, installed by Browsentic.app.`);
+    console.error(`    Update it from the app, which replaces the command and the extension together.
 `);
     return null;
   }
@@ -34184,8 +34270,8 @@ function purgeNpxCache(entries) {
 // package.json
 var package_default = {
   name: "browsentic",
-  version: "0.4.15",
-  description: "Hand your real, logged-in browser to the AI agent you already run. Installs the browser extension, runs the local daemon, and speaks MCP.",
+  version: "0.6.0",
+  description: "A browser extension with an AI side panel that hands your real, logged-in browser to the AI agent you already run. Installs the extension, runs the local daemon, and optionally speaks MCP.",
   type: "module",
   license: "MIT",
   packageManager: "yarn@4.17.1",
@@ -34197,8 +34283,12 @@ var package_default = {
   },
   bugs: "https://github.com/imshaikot/browsentic/issues",
   keywords: [
-    "browser-automation",
+    "browser-extension",
     "chrome-extension",
+    "ai-browser-extension",
+    "side-panel",
+    "browser-agent",
+    "browser-automation",
     "ai-agent",
     "agentic-browsing",
     "mcp",
@@ -34251,6 +34341,7 @@ var USAGE = `browsentic ${package_default.version} \u2014 hand your real browser
   browsentic agent            show which agent runs the side panel, and which are installed
   browsentic agent <name>     switch to claude, codex or antigravity
   browsentic agent fix <name> let Browsentic fix what that agent still needs
+  browsentic agent model <name> [model]   pin that agent's model, or omit it for the CLI's default
 
   browsentic skills           list the skills the agent can route to, and where they came from
   browsentic approvals        list the \u201Calways on this site\u201D approvals you have granted
@@ -34259,9 +34350,12 @@ var USAGE = `browsentic ${package_default.version} \u2014 hand your real browser
   browsentic downloads clear  delete all of them
   browsentic tools            print the bundled tool manifest (no browser needed)
   browsentic logs             print the daemon log
+  browsentic start            bring the background daemon up, if it is not already
   browsentic stop             stop the background daemon
   browsentic restart          stop the daemon and bring up a fresh one
   browsentic token            print the control token (for MCP clients, not the browser)
+
+  agent, skills, approvals and downloads take --json, which is what the macOS app reads.
   browsentic --version        print the version
 
 Getting started:  browsentic setup
@@ -34273,6 +34367,8 @@ For MCP clients
 var invokedAs = basename3(process.argv[1] ?? "").replace(/\.(?:js|cjs|mjs|exe|cmd|ps1)$/i, "");
 var servesBare = invokedAs === "browsentic-mcp" || !!process.env.BROWSENTIC_AGENT_RUN;
 var [command] = process.argv.slice(2);
+var wantsJson = process.argv.includes("--json");
+var positional = process.argv.slice(3).filter((arg) => !arg.startsWith("--"));
 switch (command) {
   case void 0:
     if (servesBare) await serve();
@@ -34300,7 +34396,7 @@ switch (command) {
     await revoke(process.argv[3]);
     break;
   case "agent":
-    await chooseAgent(process.argv[3], process.argv[4]);
+    await chooseAgent(positional[0], positional[1], positional[2]);
     break;
   case "tools":
     printTools();
@@ -34308,6 +34404,9 @@ switch (command) {
   case "status":
     await showStatus();
     break;
+  case "start":
+    await start();
+    break;
   case "stop":
     await stop();
     break;
@@ -34318,10 +34417,10 @@ switch (command) {
     printSkills();
     break;
   case "approvals":
-    manageApprovals(process.argv[3], process.argv[4]);
+    manageApprovals(positional[0], positional[1]);
     break;
   case "downloads":
-    manageDownloads(process.argv[3]);
+    manageDownloads(positional[0]);
     break;
   case "logs":
     showLogs();
@@ -34370,6 +34469,16 @@ function printTools() {
 }
 function printSkills() {
   const skills = loadSkills();
+  if (wantsJson) {
+    const config3 = readAgentConfig();
+    const listed = skills.map(({ body: _body, ...skill }) => ({
+      ...skill,
+      path: skill.provenance === "generated" ? join18(uploadedSkillsDir(), skill.name) : void 0
+    }));
+    const own2 = agentSkills(config3).map(({ name, description }) => ({ name, description }));
+    console.log(JSON.stringify({ skills: listed, dirs: skillDirNames(), agent: config3.agent, agentSkills: own2 }, null, 2));
+    return;
+  }
   if (!skills.length) {
     console.log(`No skills found. Looked in:
   ${skillDirNames().join("\n  ")}`);
@@ -34440,6 +34549,10 @@ async function stop() {
   if (!stopped.length && !stubborn.length) console.log("No daemon is answering; nothing to stop.");
   if (stubborn.length) process.exitCode = 1;
 }
+async function start() {
+  const lock = await ensureDaemon();
+  console.log(`Daemon running on 127.0.0.1:${lock.port} (pid ${lock.pid}, v${lock.daemonVersion}).`);
+}
 async function restart() {
   const { stubborn } = await stopDaemons();
   if (stubborn.length) {
@@ -34610,6 +34723,7 @@ async function uninstall(argv) {
   console.log("    live in extension storage rather than on disk.");
   if (kind === "global") console.log("\n    the command itself:  npm rm -g browsentic");
   if (kind === "repo") console.log("\n    the global link:     yarn daemon:unlink");
+  if (kind === "app") console.log("\n    the app itself:      drag Browsentic.app from Applications to the Trash");
   console.log("\n    the entry in your MCP client, e.g.  claude mcp remove browsentic");
   if (flag("dry-run")) {
     console.log("\n  --dry-run: nothing was removed.\n");
@@ -34665,7 +34779,15 @@ async function showSessions() {
     console.log(`    extension v${session.extensionVersion}, paired ${session.pairedAt}, last seen ${session.lastSeenAt}`);
   }
 }
-async function chooseAgent(first, second) {
+async function chooseAgent(first, second, third) {
+  if (first === "model") {
+    if (!isAgentKind(second)) {
+      console.error(`Name the agent whose model to set. Pick one of: ${AGENT_KINDS.join(", ")}`);
+      process.exit(1);
+    }
+    writeAgentModel(second, third ?? null);
+    first = second = void 0;
+  }
   const grant = first === "fix" || first === "setup";
   const named = grant ? second : first;
   if (named !== void 0 && !isAgentKind(named)) {
@@ -34676,6 +34798,10 @@ async function chooseAgent(first, second) {
   const bridge = await connect();
   const state = await bridge.agent(kind && (grant ? { grant: kind } : { set: kind }));
   await bridge.close();
+  if (wantsJson) {
+    console.log(JSON.stringify({ ...state, catalog: AGENT_LIST }, null, 2));
+    return;
+  }
   for (const runner of state.runners) {
     const agent = AGENTS[runner.kind];
     const mark = runner.kind === state.active ? "\u25CF" : "\u25CB";
@@ -34713,6 +34839,10 @@ function manageDownloads(sub) {
     return;
   }
   const downloads = storedDownloads();
+  if (wantsJson) {
+    console.log(JSON.stringify({ dir: downloadDir(), downloads }, null, 2));
+    return;
+  }
   if (!downloads.length) {
     console.log(`Nothing captured. Files land in ${downloadDir()} when an agent uses page.captureDownload.`);
     return;
@@ -34738,6 +34868,10 @@ function manageApprovals(sub, host) {
     return;
   }
   const grants = listGrants();
+  if (wantsJson) {
+    console.log(JSON.stringify({ grants }, null, 2));
+    return;
+  }
   if (!grants.length) {
     console.log("No standing approvals. Every gated action still asks.");
     return;