@vpxa/aikit 0.1.385 → 0.1.387

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpxa/aikit",
-  "version": "0.1.385",
+  "version": "0.1.387",
   "type": "module",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "license": "MIT",

package/packages/blocks-core/dist/index.mjs

@@ -3134,6 +3134,28 @@ html[data-theme='dark'] .aikit-theme-toggle-icon--moon {
     box-shadow: 0 -4px 24px rgba(0, 0, 0, 0.2);
   }
 }
+
+/* ── Large desktop: more generous header padding ── */
+@media (min-width: 1200px) {
+  .aikit-header {
+    --aikit-header-padding-x: var(--dt-space-8);
+  }
+
+  .aikit-footer {
+    --aikit-footer-padding: var(--dt-space-8) var(--dt-space-8) var(--dt-space-10);
+  }
+}
+
+@media (min-width: 1600px) {
+  .aikit-header {
+    --aikit-header-padding-x: var(--dt-space-10);
+    --aikit-header-min-height: 4rem;
+  }
+
+  .aikit-footer {
+    --aikit-footer-padding: var(--dt-space-10) var(--dt-space-10) var(--dt-space-12);
+  }
+}
 `;function jn(e){let t={COMMENT:[],DELETION:[],GLOBAL_COMMENT:[]};for(let n of e)t[n.type in t?n.type:`COMMENT`].push(n);return t}function Mn(e){let t=i(e.id),r=[];return e.author&&r.push(`<span class="bk-annotation-author">${n(e.author)}</span>`),e.createdAt&&r.push(`<time class="bk-annotation-time">${n(e.createdAt)}</time>`),`<li class="bk-annotation-item" data-block-id="${t}" data-annotation-type="${e.type}">
 <p class="bk-annotation-body">${n(e.body)}</p>
 ${r.length>0?`<div class="bk-annotation-meta">${r.join(``)}</div>`:``}
@@ -3175,11 +3197,38 @@ body {
   font-family: var(--dt-font-sans);
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
-  /* Smooth theme transitions */
+  /* Smooth theme transitions + layout reflow */
   transition: background var(--dt-transition-normal),
               color var(--dt-transition-normal);
 }
 
+/* ── Responsive media — scale with container ── */
+/* NOTE: iframe excluded — no intrinsic aspect ratio; height: auto collapses it */
+img, video, svg, canvas {
+  max-width: 100%;
+  height: auto;
+}
+
+/* ── Large desktop: slightly larger base font for readability ── */
+@media (min-width: 1600px) {
+  html {
+    font-size: 17px;
+  }
+}
+
+@media (min-width: 2000px) {
+  html {
+    font-size: 18px;
+  }
+}
+
+/* ── Very large: cap font growth ── */
+@media (min-width: 2800px) {
+  html {
+    font-size: 19px;
+  }
+}
+
 /* ── Reduced motion ── */
 @media (prefers-reduced-motion: reduce) {
   html { scroll-behavior: auto; }
@@ -3249,6 +3298,40 @@ body {
   background: var(--dt-border-muted);
 }
 
+/* ── Print-friendly: clean, no sticky/glow/scrollbar chrome ── */
+@media print {
+  .aikit-header,
+  .aikit-footer,
+  .aikit-glow-primary,
+  .aikit-glow-secondary,
+  .aikit-copy-status {
+    display: none !important;
+  }
+  body {
+    background: #fff !important;
+    color: #000 !important;
+    min-height: auto !important;
+    height: auto !important;
+  }
+  main {
+    max-width: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+  }
+  }
+}
+
+/* @page is a top-level at-rule per CSS spec — separate from @media print */
+@page {
+  margin: 2cm;
+}
+
+/* ── Gentle fade-in on page load ── */
+@keyframes aikit-fade-in {
+  from { opacity: 0; transform: translateY(4px); }
+  to   { opacity: 1; transform: translateY(0); }
+}
+
 /* ── Content visibility for below-fold cards ── */
 /* NOTE: Only apply to blocks with predictable heights. Content with
    variable height (mermaid, code, timelines) gets layout shift if
@@ -3269,12 +3352,15 @@ main {
   display: flex;
   flex-direction: column;
   gap: var(--aikit-main-gap, 1.5rem);
+  animation: aikit-fade-in 0.3s ease-out;
 }
 
 main > * {
   flex-shrink: 0;
 }
 
+/* ── Responsive: nested breakpoints (mobile-first) ── */
+
 @media (max-width: 640px) {
   main {
     padding: var(--aikit-main-padding-mobile, 1rem 1rem);
@@ -3282,6 +3368,13 @@ main > * {
   }
 }
 
+@media (max-width: 480px) {
+  main {
+    padding: var(--aikit-main-padding-mobile-sm, 0.75rem 0.75rem);
+    gap: var(--aikit-main-gap-mobile-sm, 0.75rem);
+  }
+}
+
 @media (max-width: 360px) {
   main {
     padding: var(--aikit-main-padding-mobile-xs, 0.5rem 0.5rem);
@@ -3297,18 +3390,28 @@ main > * {
   }
 }
 
-@media (max-width: 480px) {
+/* ── 768px–1199px: tablet — moderate widening ── */
+@media (min-width: 768px) {
   main {
-    padding: var(--aikit-main-padding-mobile-sm, 0.75rem 0.75rem);
-    gap: var(--aikit-main-gap-mobile-sm, 0.75rem);
+    max-width: var(--aikit-max-width-tablet, 90%);
   }
 }
 
+/* ── 1200px–1599px: desktop — standard content width ── */
 @media (min-width: 1200px) {
   main {
     max-width: var(--aikit-max-width-wide, 1040px);
   }
 }
+
+/* ── 1600px+: large desktop — wider layout ── */
+@media (min-width: 1600px) {
+  main {
+    max-width: var(--aikit-max-width-xlarge, 1200px);
+    padding: var(--aikit-main-padding-xlarge, 2.5rem 2rem);
+    gap: var(--aikit-main-gap-xlarge, 2rem);
+  }
+}
 `,An,...(Array.isArray(t)?t:typeof t==`string`?[t]:[]).filter(e=>e.trim().length>0)].join(`
 `);return[`  <style>${e}</style>`,`  <style>${n}</style>`].join(`
 `)}function Ci(e){let t=Object.entries(L).map(([e,t])=>`  ${e}: ${t};`).join(`

package/packages/browser/dist/index.js

@@ -1,5 +1,5 @@
-import{exec as e,execFile as t,execFileSync as n,execSync as r}from"node:child_process";import{existsSync as i,mkdirSync as a,readFileSync as o,unlinkSync as s,writeFileSync as c}from"node:fs";import{homedir as l,platform as u,tmpdir as d}from"node:os";import{join as f}from"node:path";import{z as p}from"zod";const m=`0.26.0`,h=`.agent-browser-version`;function ee(e){return typeof e==`string`?e.trim():e instanceof Buffer?e.toString(`utf8`).trim():``}function g(){return f(l(),`.aikit`,`browsers`)}function _(e){return e.browsersPath??process.env.AIKIT_BROWSER_PATH??process.env.AIKIT_BROWSER_BROWSERS_PATH??g()}function v(){try{let e=r(`${u()===`win32`?`where`:`which`} agent-browser`,{encoding:`utf8`,stdio:`pipe`,timeout:3e3}).trim().split(/\r?\n/)[0];if(!e)return null;if(u()===`win32`){if(i(`${e}.cmd`))return`${e}.cmd`;if(i(`${e}.bat`))return`${e}.bat`;if(i(`${e}.exe`))return`${e}.exe`}return i(e)?e:null}catch{return null}}function y(e){return f(e,`agent-browser`,te())}function te(){switch(u()){case`win32`:return`agent-browser.exe`;default:return`agent-browser`}}function b(e,t){try{c(f(e,h),t,`utf8`)}catch{}}function ne(e){try{return o(f(e,h),`utf8`).trim()}catch{return null}}function re(e){let t=ne(e);return t?ie(t,m)>=0:!1}function ie(e,t){let n=e.split(`.`).map(Number),r=t.split(`.`).map(Number);for(let e=0;e<Math.max(n.length,r.length);e++){let t=n[e]||0,i=r[e]||0;if(t!==i)return t-i}return 0}function ae(e){return!!(i(f(e,`chrome`))||i(f(l(),`.cache`,`agent-browser`,`chrome`)))}async function oe(t,n){let o=v();if(o)return n?.(`Using globally installed agent-browser`),o;let s=_(t);i(s)||a(s,{recursive:!0});let c=y(s);if(i(c)&&re(s))return n?.(`Using cached agent-browser at ${c}`),c;n?.(`Downloading agent-browser (first use)...`),await new Promise((t,n)=>{let r=new AbortController,i=setTimeout(()=>r.abort(),12e4),a=e(`npx -y agent-browser@latest install --install-dir "${s}"`,{timeout:12e4,encoding:`utf8`,env:{...process.env,AGENT_BROWSER_CACHE_DIR:s},signal:r.signal},(e,r,a)=>{if(clearTimeout(i),e){let t=ee(a)||e.message||`Unknown agent-browser install failure`;n(Error(`Failed to install agent-browser: ${t}`));return}t()});a.stdin&&a.stdin.destroy()});let l=c;try{let e=r(`npx -y -p agent-browser which agent-browser 2>/dev/null || true`,{encoding:`utf8`,timeout:1e4,stdio:`pipe`}).trim();e&&i(e)&&(l=e,b(s,m))}catch{try{let e=r(`npx -y agent-browser --version`,{encoding:`utf8`,timeout:1e4,stdio:`pipe`}).trim();e&&b(s,e)}catch{}}return n?.(`agent-browser ready`),l}async function se(e){try{return n(e,[`--version`],{encoding:`utf8`,stdio:`pipe`,timeout:5e3}).trim()}catch{return null}}function ce(e){if(v())return!0;let t=_(e);return ae(t)||i(y(t))}const le=[`ui`,`headless`];function ue(e){return le.includes(e)?e:`headless`}function de(e){let t=[];return e===`headless`&&t.push(`--headless`),t}function fe(e){return{headless:e===`headless`,args:de(e)}}var x=class{tabs=new Map;labelToId=new Map;register(e,t,n,r){return this.tabs.set(e,{tabId:e,url:t,title:n??t,label:r,createdAt:new Date}),r&&this.labelToId.set(r,e),e}resolve(e){return this.tabs.has(e)?e:this.labelToId.get(e)||e}getTab(e){let t=this.tabs.get(e);if(!t)throw Error(`Tab not found: ${e}`);return t}updateTabInfo(e,t,n){let r=this.tabs.get(e);r&&this.tabs.set(e,{...r,url:t,title:n})}setSnapshot(e,t){let n=this.tabs.get(e);n&&this.tabs.set(e,{...n,snapshot:t})}getSnapshot(e){return this.tabs.get(e)?.snapshot}async removeTab(e){let t=this.tabs.get(e);t&&(t.label&&this.labelToId.delete(t.label),this.tabs.delete(e))}listTabs(){return[...this.tabs.values()]}listPages(){return this.listTabs().map(e=>({pageId:e.tabId,url:e.url,title:e.title,label:e.label,createdAt:e.createdAt}))}async closeAll(){this.tabs.clear(),this.labelToId.clear()}clear(){this.tabs.clear(),this.labelToId.clear()}get size(){return this.tabs.size}},pe=class{tabs=new x;registerPage(e,t,n,r){return this.tabs.register(e,t,n,r)}getPage(e){throw Error(`Direct Playwright Page access no longer supported with agent-browser. Use engine.exec() or engine.tabExec() for browser operations.`)}getPageInfo(e){let t=this.tabs.getTab(e);return{pageId:t.tabId,url:t.url,title:t.title,label:t.label,createdAt:t.createdAt}}resolvePageId(e){return this.tabs.resolve(e)}setSnapshot(e,t){this.tabs.setSnapshot(e,t)}getSnapshot(e){return this.tabs.getSnapshot(e)}updatePageInfo(e,t,n){this.tabs.updateTabInfo(e,t,n)}async removePage(e){await this.tabs.removeTab(e)}listPages(){return this.tabs.listPages()}async closeAll(){await this.tabs.closeAll()}get size(){return this.tabs.size}};const S={defaultMode:`ui`,browsersPath:null,userDataDirRoot:null,idleShutdownMinutes:10,allowInternalSchemes:!1,allowLoopback:!1,evalTimeoutMs:3e4,evalMaxResultBytes:262144,redactPasswordFieldsInScreenshots:!0,engine:`chrome`};var C=class{binaryPath=null;_currentMode=null;_isLaunched=!1;idleTimer=null;tabs=new x;config;constructor(e={}){this.config={...S,...e}}get currentMode(){return this._currentMode}async launch(e,t){let n=ue(e??this.config.defaultMode);if(!(this._isLaunched&&this._currentMode===n)){this._isLaunched&&this._currentMode!==n&&await this.close(),this._currentMode=n,this.binaryPath=await oe(this.config,t);try{let e=await this.exec(`--version`);t?.(`agent-browser ${e.stdout.trim()}`)}catch(e){throw Error(`agent-browser binary failed: ${e instanceof Error?e.message:String(e)}`)}this._isLaunched=!0,this.resetIdleTimer()}}async exec(e,...t){if(!this.binaryPath)throw Error(`agent-browser not launched. Call launch() first, or use getEngine() singleton.`);let n=this.binaryPath;u()===`win32`&&!n.endsWith(`.cmd`)&&!n.endsWith(`.bat`)&&!n.endsWith(`.exe`)&&i(`${n}.cmd`)&&(n=`${n}.cmd`);let r=[e,...t];if(u()===`win32`&&(n.endsWith(`.cmd`)||n.endsWith(`.bat`))){let e=`"${n}" ${r.map(e=>/[^\w/:@.\-_{}()/\\]/.test(e)?`"${e.replace(/"/g,`""`)}"`:e).join(` `)}`;return await this.execViaShell(e)}return await this.execViaExecFile(n,r)}execViaExecFile(e,n){return new Promise((r,i)=>{t(e,n,{timeout:this.config.evalTimeoutMs},(t,a,o)=>{if(t){let s=t;if(s.code===`ENOENT`){i(Error(`agent-browser binary not found at ${this.binaryPath}`));return}if(s.killed||s.signal){i(Error(`agent-browser command timed out after ${this.config.evalTimeoutMs}ms: ${e} ${n.join(` `)}`));return}r({stdout:a??``,stderr:o??``,exitCode:typeof s.code==`number`?s.code:1});return}r({stdout:a??``,stderr:o??``,exitCode:0})}).stdin?.end()})}execViaShell(t){return new Promise((n,r)=>{e(t,{timeout:this.config.evalTimeoutMs},(e,i,a)=>{if(e){let o=e;if(o.code===`ENOENT`){r(Error(`agent-browser binary not found at ${this.binaryPath}`));return}if(o.killed||o.signal){r(Error(`agent-browser command timed out after ${this.config.evalTimeoutMs}ms: ${t}`));return}n({stdout:i??``,stderr:a??``,exitCode:typeof o.code==`number`?o.code:1});return}n({stdout:i??``,stderr:a??``,exitCode:0})})})}async tabExec(e,t,...n){return this.exec(`tab`,e,t,...n)}async open(e,t,n){await this.launch(t);let r=this._currentMode===`ui`?[`open`,e,`--headed`]:[`open`,e],i=await this.exec(...r);if(i.exitCode!==0)throw Error(`agent-browser failed to open URL (exit ${i.exitCode}): ${i.stderr||i.stdout||`Unknown error`}`);return this.tabs.register(`t0`,e,i.stdout.trim(),n),this.resetIdleTimer(),`t0`}async screenshot(e,t){let n=t?.format??`png`,r=n===`jpeg`?`image/jpeg`:`image/png`,i=n===`jpeg`?`jpg`:`png`,a=f(t?.screenshotDir??d(),`aikit-screenshot-${Date.now()}.${i}`),c=[a];t?.fullPage&&c.push(`--full`),t?.screenshotDir&&c.push(`--screenshot-dir`,t.screenshotDir),t?.format===`jpeg`&&c.push(`--screenshot-format`,`jpeg`),t?.quality&&c.push(`--screenshot-quality`,String(t.quality)),t?.annotate&&c.push(`--annotate`),await this.exec(`screenshot`,...c);let l=o(a),u=l.toString(`base64`);try{s(a)}catch{}return this.resetIdleTimer(),{base64:u,mimeType:r,bytes:l.length}}async readSnapshot(e,t=!1){let n=t?[`-c`,`--json`]:[`-i`,`--json`],r=await this.tabExec(e,`snapshot`,...n);return this.resetIdleTimer(),r.stdout}async navigate(e,t){let n=await this.tabExec(e,`goto`,t);return this.resetIdleTimer(),n}async close(){if(this.stopIdleTimer(),this._isLaunched){try{await this.exec(`close`).catch(()=>{})}catch{}this.tabs.clear(),this._isLaunched=!1,this._currentMode=null}}isLaunched(){return this._isLaunched}getConfig(){return this.config}getBinaryPath(){return this.binaryPath}resolvePageId(e){return this.tabs.resolve(e)}resetIdleTimer(){this.stopIdleTimer();let e=setTimeout(()=>{this.close()},this.config.idleShutdownMinutes*6e4);e.unref?.(),this.idleTimer=e}stopIdleTimer(){this.idleTimer&&=(clearTimeout(this.idleTimer),null)}};let w=null;function T(e){return w||=new C(e),w}async function me(){w&&=(await w.close(),null)}function E(e,t){try{let n=new URL(e),r=n.hostname.toLowerCase(),i=n.protocol.toLowerCase();return[`file:`,`chrome:`,`chrome-extension:`,`data:`,`javascript:`].includes(i)?t?.allowInternalSchemes?{allowed:!0}:{allowed:!1,reason:`Scheme '${i}' is blocked for security`}:[`169.254.169.254`,`metadata.google.internal`,`metadata.instance`].includes(r)?{allowed:!1,reason:`Cloud metadata endpoint '${r}' is blocked`}:n.hostname===`localhost`||r===`127.0.0.1`||r===`::1`||r.startsWith(`10.`)||r.startsWith(`172.`)||r.startsWith(`192.168.`)?t?.allowLoopback?{allowed:!0}:{allowed:!1,reason:`Internal host '${r}' requires allowLoopback=true`}:{allowed:!0}}catch{return{allowed:!1,reason:`Invalid URL`}}}function D(e,t){return Buffer.byteLength(e,`utf8`)<=t?{valid:!0,result:e,truncated:!1}:{valid:!0,result:`${Buffer.from(e).subarray(0,t).toString(`utf8`)}\n... [truncated]`,truncated:!0,reason:`Result exceeded ${t} bytes, truncated to ${t} bytes`}}const he=[`ui`,`headless`];function ge(e){return typeof e==`object`&&e?e:null}function O(e){return typeof e==`string`&&e.length>0?e:void 0}function k(e){return typeof e==`boolean`?e:void 0}function A(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function j(e){return typeof e==`string`&&he.includes(e)?e:void 0}function M(e){let t=process.env[e];if(!t)return;let n=Number(t);return Number.isFinite(n)?n:void 0}function _e(e){let t=ge(e.browser)??{};return{...S,defaultMode:j(process.env.AIKIT_BROWSER_DEFAULT_MODE)??j(t.defaultMode)??S.defaultMode,browsersPath:O(process.env.AIKIT_BROWSER_PATH)??O(process.env.AIKIT_BROWSER_BROWSERS_PATH)??O(t.browsersPath)??S.browsersPath,userDataDirRoot:O(t.userDataDirRoot)??S.userDataDirRoot,idleShutdownMinutes:M(`AIKIT_BROWSER_IDLE_MINUTES`)??A(t.idleShutdownMinutes)??S.idleShutdownMinutes,allowInternalSchemes:k(t.allowInternalSchemes)??S.allowInternalSchemes,allowLoopback:k(t.allowLoopback)??S.allowLoopback,evalTimeoutMs:M(`AIKIT_BROWSER_EVAL_TIMEOUT_MS`)??A(t.evalTimeoutMs)??S.evalTimeoutMs,evalMaxResultBytes:A(t.evalMaxResultBytes)??S.evalMaxResultBytes,redactPasswordFieldsInScreenshots:k(t.redactPasswordFieldsInScreenshots)??S.redactPasswordFieldsInScreenshots,engine:O(t.engine)??S.engine,proxy:O(t.proxy),viewport:O(t.viewport)}}function N(e,t){return{content:[{type:`text`,text:e}],structuredContent:t}}function P(e,t){let n=e.selector??e.ref??(e.element?`text=${e.element}`:void 0);if(!n)throw Error(`${t} requires selector, ref, or element`);return n}function F(e){try{let t=JSON.parse(e);if(t&&typeof t==`object`){let e=I(t);if(e.length>0)return e.join(`
-`)}return JSON.stringify(t,null,2)}catch{return e}}function I(e,t=0,n=[]){let r=`  `.repeat(t),i=typeof e.role==`string`?e.role.toUpperCase():``,a=typeof e.ref==`string`?e.ref:``,o=typeof e.name==`string`?e.name:``,s=typeof e.value==`string`?`="${e.value}"`:``,c=Array.isArray(e.children)?e.children:[];if(i&&a){let e=ve(i),t=o||s||``;n.push(`${r}[${e}] [${a}] ${t}`.trimEnd())}else if(o||i){let e=i.toLowerCase();n.push(`${r}${e}: ${o}`.trimEnd())}for(let e of c)typeof e==`object`&&e&&I(e,t+1,n);return n}function ve(e){return{BUTTON:`BUTTON`,LINK:`LINK`,TEXT_FIELD:`TEXTFIELD`,TEXTBOX:`TEXTFIELD`,COMBOBOX:`SELECT`,CHECKBOX:`CHECKBOX`,RADIO:`RADIO`,SWITCH:`SWITCH`,SLIDER:`SLIDER`,TAB:`TAB`,MENU_ITEM:`MENUITEM`,LISTBOX:`LIST`,GRID:`GRID`,TABLE:`TABLE`,HEADING:`HEADING`,IMAGE:`IMAGE`,IMG:`IMAGE`,PROGRESSBAR:`PROGRESS`,DIALOG:`DIALOG`,TOOLTIP:`TOOLTIP`,ALERT:`ALERT`,MENU:`MENU`,NAVIGATION:`NAV`,SEARCH:`SEARCH`,MAIN:`MAIN`,COMPLEMENTARY:`COMPLEMENT`,CONTENTINFO:`INFO`,REGION:`REGION`}[e]??e.slice(0,8)}function ye(e){return async({pageId:t,kind:n,ref:r,selector:i,element:a,text:o,key:s,value:c,fromRef:l,fromSelector:u,toRef:d,toSelector:f})=>{let p=T(e),m=p.resolvePageId(t);switch(n){case`click`:{let e=P({ref:r,selector:i,element:a},`browser_act(click)`);await p.tabExec(m,`click`,e);break}case`type`:{let e=P({ref:r,selector:i,element:a},`browser_act(type)`);await p.tabExec(m,`fill`,e,o??``);break}case`press`:{let e=P({ref:r,selector:i,element:a},`browser_act(press)`);if(!s)throw Error(`browser_act(press) requires key`);await p.tabExec(m,`press`,e,s);break}case`hover`:{let e=P({ref:r,selector:i,element:a},`browser_act(hover)`);await p.tabExec(m,`hover`,e);break}case`drag`:{let e=P({ref:l??r,selector:u??i,element:a},`browser_act(drag) source`),t=P({ref:d,selector:f??c,element:a},`browser_act(drag) target`);await p.tabExec(m,`drag`,e,t);break}case`select`:{let e=P({ref:r,selector:i,element:a},`browser_act(select)`);if(c===void 0)throw Error(`browser_act(select) requires value`);await p.tabExec(m,`select`,e,c);break}case`scroll`:{if(i||r||a){let e=P({ref:r,selector:i,element:a},`browser_act(scroll)`);await p.tabExec(m,`scrollintoview`,e);break}let e=c??`down 500`;await p.tabExec(m,`scroll`,e);break}case`upload`:{let e=P({ref:r,selector:i,element:a},`browser_act(upload)`);if(!c)throw Error(`value (file path) required for upload`);await p.tabExec(m,`upload`,e,c);break}}return p.resetIdleTimer(),N(`ok`,{ok:!0})}}function be(e){return async({pageId:t,subAction:n,level:r,bufferSize:i,expression:a})=>{let o=T(e),s=o.resolvePageId(t);switch(n){case`enable`:{let e=[`--enable`];return i&&e.push(`--buffer-size`,String(i)),r&&e.push(`--level`,r),await o.tabExec(s,`console`,...e),o.resetIdleTimer(),N(`Console capture enabled`,{enabled:!0})}case`get`:{let t=[`--json`];r&&t.push(`--level`,r);let n=await o.tabExec(s,`console`,...t);o.resetIdleTimer();let i=[];try{i=JSON.parse(n.stdout)}catch{i=[{raw:n.stdout}]}let c,l;if(a)try{c=(await o.tabExec(s,`evaluate`,`--timeout=${e.evalTimeoutMs}`,`--`,a)).stdout}catch(e){l=e instanceof Error?e.message:String(e)}return N(c===void 0?`Console has ${i.length} entries`:`Console has ${i.length} entries\nEvaluation: ${c}`,{entries:i,count:i.length,expression:a,evalResult:c,evalError:l})}case`clear`:return await o.tabExec(s,`console`,`clear`),o.resetIdleTimer(),N(`Console cleared`,{cleared:!0});default:return N(`Unknown console sub-action`,{error:`Unknown console sub-action`})}}}function xe(e){return async({pageId:t,accept:n,promptText:r})=>{let i=T(e),a=i.resolvePageId(t);if(n){let e=r?[`accept`,`--text`,r]:[`accept`];await i.tabExec(a,`dialog`,...e)}else await i.tabExec(a,`dialog`,`dismiss`);return i.resetIdleTimer(),N(`Dialog ${n?`accepted`:`dismissed`}`,{accepted:n})}}function Se(e){return async({pageId:t})=>{let n=T(e),r=n.resolvePageId(t),i=await n.tabExec(r,`diff`,`snapshot`);return n.resetIdleTimer(),N(i.stdout,{pageId:r,diff:i.stdout})}}function Ce(e){return async({pageId:t,code:n,timeoutMs:r})=>{let i=T(e),a=i.resolvePageId(t),o=r??e.evalTimeoutMs,s=await i.tabExec(a,`evaluate`,`--timeout=${o}`,`--`,n);i.resetIdleTimer();let c=D(s.stdout,e.evalMaxResultBytes);return N(c.result,{pageId:a,result:c.result,truncated:c.truncated})}}function we(e){return async({pageId:t,url:n,method:r,headers:i,body:a,timeoutMs:o,includeHeaders:s})=>{let c=T(e),l=c.resolvePageId(t),u=o??e.evalTimeoutMs,d=Te(n,r??`GET`,s??!0,i,a),f=await c.tabExec(l,`evaluate`,`--timeout=${u}`,`--`,d);return c.resetIdleTimer(),N(f.stdout,{pageId:l,response:f.stdout})}}function Te(e,t,n,r,i){let a={method:t,headers:r??{}};i&&[`POST`,`PUT`,`PATCH`].includes(t.toUpperCase())&&(a.body=i);let o=JSON.stringify(a);return n?`fetch(${JSON.stringify(e)}, ${o}).then(async r => {
+import{exec as e,execFile as t,execFileSync as n,execSync as r}from"node:child_process";import{copyFileSync as i,existsSync as a,mkdirSync as o,readFileSync as s,readdirSync as c,unlinkSync as l,writeFileSync as u}from"node:fs";import{homedir as d,platform as f,tmpdir as p}from"node:os";import{join as m}from"node:path";import{z as h}from"zod";const g=`0.26.0`,_=`.agent-browser-version`;function ee(e){return typeof e==`string`?e.trim():e instanceof Buffer?e.toString(`utf8`).trim():``}function v(){return m(d(),`.aikit`,`browsers`)}function y(e){return e.browsersPath??process.env.AIKIT_BROWSER_PATH??process.env.AIKIT_BROWSER_BROWSERS_PATH??v()}function b(){try{let e=r(`${f()===`win32`?`where`:`which`} agent-browser`,{encoding:`utf8`,stdio:`pipe`,timeout:3e3}).trim().split(/\r?\n/)[0];if(!e)return null;if(f()===`win32`){if(a(`${e}.cmd`))return`${e}.cmd`;if(a(`${e}.bat`))return`${e}.bat`;if(a(`${e}.exe`))return`${e}.exe`}return a(e)?e:null}catch{return null}}function x(e){return m(e,`agent-browser`,te())}function te(){switch(f()){case`win32`:return`agent-browser.exe`;default:return`agent-browser`}}function ne(e,t){try{u(m(e,_),t,`utf8`)}catch{}}function re(e){try{return s(m(e,_),`utf8`).trim()}catch{return null}}function ie(e){let t=re(e);return t?ae(t,g)>=0:!1}function ae(e,t){let n=e.split(`.`).map(Number),r=t.split(`.`).map(Number);for(let e=0;e<Math.max(n.length,r.length);e++){let t=n[e]||0,i=r[e]||0;if(t!==i)return t-i}return 0}function oe(e){return!!(a(m(e,`chrome`))||a(m(d(),`.cache`,`agent-browser`,`chrome`)))}async function se(t,n){let s=b();if(s)return n?.(`Using globally installed agent-browser`),s;let l=y(t);a(l)||o(l,{recursive:!0});let u=x(l);if(a(u)&&ie(l))return n?.(`Using cached agent-browser at ${u}`),u;n?.(`Downloading agent-browser (first use)...`),await new Promise((t,n)=>{let r=new AbortController,i=setTimeout(()=>r.abort(),12e4),a=e(`npx -y agent-browser@latest install --install-dir "${l}"`,{timeout:12e4,encoding:`utf8`,env:{...process.env,AGENT_BROWSER_CACHE_DIR:l},signal:r.signal},(e,r,a)=>{if(clearTimeout(i),e){let t=ee(a)||e.message||`Unknown agent-browser install failure`;n(Error(`Failed to install agent-browser: ${t}`));return}t()});a.stdin&&a.stdin.destroy()});let d=u;try{let e=r(f()===`win32`?`npx -y -p agent-browser node -e "process.stdout.write(__dirname)"`:`npx -y -p agent-browser which agent-browser 2>/dev/null || true`,{encoding:`utf8`,timeout:15e3,stdio:`pipe`}).trim(),t=f()===`win32`?`agent-browser-win32-x64.exe`:f()===`darwin`?process.arch===`arm64`?`agent-browser-darwin-arm64`:`agent-browser-darwin-x64`:`agent-browser-linux-${process.arch===`arm64`?`arm64`:`x64`}`,s=[];e&&!e.includes(`MODULE_NOT_FOUND`)&&(s.push(e),s.push(m(e,`..`)));try{let e=m(r(`npm config get cache`,{encoding:`utf8`,timeout:5e3,stdio:`pipe`}).trim(),`_npx`);if(a(e)){let n=c(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory())continue;let n=m(e,r.name,`node_modules`,`agent-browser`);if(a(m(n,`bin`,t))){s.push(n);break}}}}catch{}for(let e of s){let r=m(e,`bin`,t);if(a(r)){let t=m(l,`agent-browser`);a(t)||o(t,{recursive:!0});let s=x(l);i(r,s);let c=m(e,`bin`,`agent-browser.js`);a(c)&&i(c,m(t,`agent-browser.js`)),ne(l,g),d=s,n?.(`Cached agent-browser at ${s}`);break}}}catch{}return n?.(`agent-browser ready`),d}async function ce(e){try{return n(e,[`--version`],{encoding:`utf8`,stdio:`pipe`,timeout:5e3}).trim()}catch{return null}}function le(e){if(b())return!0;let t=y(e);return oe(t)||a(x(t))}const ue=[`ui`,`headless`];function de(e){return ue.includes(e)?e:`headless`}function fe(e){let t=[];return e===`headless`&&t.push(`--headless`),t}function pe(e){return{headless:e===`headless`,args:fe(e)}}var S=class{tabs=new Map;labelToId=new Map;register(e,t,n,r){return this.tabs.set(e,{tabId:e,url:t,title:n??t,label:r,createdAt:new Date}),r&&this.labelToId.set(r,e),e}resolve(e){return this.tabs.has(e)?e:this.labelToId.get(e)||e}getTab(e){let t=this.tabs.get(e);if(!t)throw Error(`Tab not found: ${e}`);return t}updateTabInfo(e,t,n){let r=this.tabs.get(e);r&&this.tabs.set(e,{...r,url:t,title:n})}setSnapshot(e,t){let n=this.tabs.get(e);n&&this.tabs.set(e,{...n,snapshot:t})}getSnapshot(e){return this.tabs.get(e)?.snapshot}async removeTab(e){let t=this.tabs.get(e);t&&(t.label&&this.labelToId.delete(t.label),this.tabs.delete(e))}listTabs(){return[...this.tabs.values()]}listPages(){return this.listTabs().map(e=>({pageId:e.tabId,url:e.url,title:e.title,label:e.label,createdAt:e.createdAt}))}async closeAll(){this.tabs.clear(),this.labelToId.clear()}clear(){this.tabs.clear(),this.labelToId.clear()}get size(){return this.tabs.size}},me=class{tabs=new S;registerPage(e,t,n,r){return this.tabs.register(e,t,n,r)}getPage(e){throw Error(`Direct Playwright Page access no longer supported with agent-browser. Use engine.exec() or engine.tabExec() for browser operations.`)}getPageInfo(e){let t=this.tabs.getTab(e);return{pageId:t.tabId,url:t.url,title:t.title,label:t.label,createdAt:t.createdAt}}resolvePageId(e){return this.tabs.resolve(e)}setSnapshot(e,t){this.tabs.setSnapshot(e,t)}getSnapshot(e){return this.tabs.getSnapshot(e)}updatePageInfo(e,t,n){this.tabs.updateTabInfo(e,t,n)}async removePage(e){await this.tabs.removeTab(e)}listPages(){return this.tabs.listPages()}async closeAll(){await this.tabs.closeAll()}get size(){return this.tabs.size}};const C={defaultMode:`ui`,browsersPath:null,userDataDirRoot:null,idleShutdownMinutes:10,allowInternalSchemes:!1,allowLoopback:!1,evalTimeoutMs:3e4,evalMaxResultBytes:262144,redactPasswordFieldsInScreenshots:!0,engine:`chrome`};var w=class{binaryPath=null;_currentMode=null;_isLaunched=!1;idleTimer=null;tabs=new S;config;constructor(e={}){this.config={...C,...e}}get currentMode(){return this._currentMode}async launch(e,t){let n=de(e??this.config.defaultMode);if(!(this._isLaunched&&this._currentMode===n)){this._isLaunched&&this._currentMode!==n&&await this.close(),this._currentMode=n,this.binaryPath=await se(this.config,t);try{let e=await this.exec(`--version`);t?.(`agent-browser ${e.stdout.trim()}`)}catch(e){throw Error(`agent-browser binary failed: ${e instanceof Error?e.message:String(e)}`)}this._isLaunched=!0,this.resetIdleTimer()}}async exec(e,...t){if(!this.binaryPath)throw Error(`agent-browser not launched. Call launch() first, or use getEngine() singleton.`);let n=this.binaryPath;f()===`win32`&&!n.endsWith(`.cmd`)&&!n.endsWith(`.bat`)&&!n.endsWith(`.exe`)&&a(`${n}.cmd`)&&(n=`${n}.cmd`);let r=[e,...t];if(f()===`win32`&&(n.endsWith(`.cmd`)||n.endsWith(`.bat`))){let e=`"${n}" ${r.map(e=>/[^\w/:@.\-_{}()/\\]/.test(e)?`"${e.replace(/"/g,`""`)}"`:e).join(` `)}`;return await this.execViaShell(e)}return await this.execViaExecFile(n,r)}execViaExecFile(e,n){return new Promise((r,i)=>{t(e,n,{timeout:this.config.evalTimeoutMs},(t,a,o)=>{if(t){let s=t;if(s.code===`ENOENT`){i(Error(`agent-browser binary not found at ${this.binaryPath}`));return}if(s.killed||s.signal){i(Error(`agent-browser command timed out after ${this.config.evalTimeoutMs}ms: ${e} ${n.join(` `)}`));return}r({stdout:a??``,stderr:o??``,exitCode:typeof s.code==`number`?s.code:1});return}r({stdout:a??``,stderr:o??``,exitCode:0})}).stdin?.end()})}execViaShell(t){return new Promise((n,r)=>{e(t,{timeout:this.config.evalTimeoutMs},(e,i,a)=>{if(e){let o=e;if(o.code===`ENOENT`){r(Error(`agent-browser binary not found at ${this.binaryPath}`));return}if(o.killed||o.signal){r(Error(`agent-browser command timed out after ${this.config.evalTimeoutMs}ms: ${t}`));return}n({stdout:i??``,stderr:a??``,exitCode:typeof o.code==`number`?o.code:1});return}n({stdout:i??``,stderr:a??``,exitCode:0})})})}async tabExec(e,t,...n){return this.exec(`tab`,e,t,...n)}async open(e,t,n){await this.launch(t);let r=this._currentMode===`ui`?[`open`,e,`--headed`]:[`open`,e],i=await this.exec(...r);if(i.exitCode!==0)throw Error(`agent-browser failed to open URL (exit ${i.exitCode}): ${i.stderr||i.stdout||`Unknown error`}`);return this.tabs.register(`t0`,e,i.stdout.trim(),n),this.resetIdleTimer(),`t0`}async screenshot(e,t){let n=t?.format??`png`,r=n===`jpeg`?`image/jpeg`:`image/png`,i=n===`jpeg`?`jpg`:`png`,a=m(t?.screenshotDir??p(),`aikit-screenshot-${Date.now()}.${i}`),o=[a];t?.fullPage&&o.push(`--full`),t?.screenshotDir&&o.push(`--screenshot-dir`,t.screenshotDir),t?.format===`jpeg`&&o.push(`--screenshot-format`,`jpeg`),t?.quality&&o.push(`--screenshot-quality`,String(t.quality)),t?.annotate&&o.push(`--annotate`),await this.exec(`screenshot`,...o);let c=s(a),u=c.toString(`base64`);try{l(a)}catch{}return this.resetIdleTimer(),{base64:u,mimeType:r,bytes:c.length}}async readSnapshot(e,t=!1){let n=t?[`-c`,`--json`]:[`-i`,`--json`],r=await this.tabExec(e,`snapshot`,...n);return this.resetIdleTimer(),r.stdout}async navigate(e,t){let n=await this.tabExec(e,`goto`,t);return this.resetIdleTimer(),n}async close(){if(this.stopIdleTimer(),this._isLaunched){try{await this.exec(`close`).catch(()=>{})}catch{}this.tabs.clear(),this._isLaunched=!1,this._currentMode=null}}isLaunched(){return this._isLaunched}getConfig(){return this.config}getBinaryPath(){return this.binaryPath}resolvePageId(e){return this.tabs.resolve(e)}resetIdleTimer(){this.stopIdleTimer();let e=setTimeout(()=>{this.close()},this.config.idleShutdownMinutes*6e4);e.unref?.(),this.idleTimer=e}stopIdleTimer(){this.idleTimer&&=(clearTimeout(this.idleTimer),null)}};let T=null;function E(e){return T||=new w(e),T}async function he(){T&&=(await T.close(),null)}function D(e,t){try{let n=new URL(e),r=n.hostname.toLowerCase(),i=n.protocol.toLowerCase();return[`file:`,`chrome:`,`chrome-extension:`,`data:`,`javascript:`].includes(i)?t?.allowInternalSchemes?{allowed:!0}:{allowed:!1,reason:`Scheme '${i}' is blocked for security`}:[`169.254.169.254`,`metadata.google.internal`,`metadata.instance`].includes(r)?{allowed:!1,reason:`Cloud metadata endpoint '${r}' is blocked`}:n.hostname===`localhost`||r===`127.0.0.1`||r===`::1`||r.startsWith(`10.`)||r.startsWith(`172.`)||r.startsWith(`192.168.`)?t?.allowLoopback?{allowed:!0}:{allowed:!1,reason:`Internal host '${r}' requires allowLoopback=true`}:{allowed:!0}}catch{return{allowed:!1,reason:`Invalid URL`}}}function O(e,t){return Buffer.byteLength(e,`utf8`)<=t?{valid:!0,result:e,truncated:!1}:{valid:!0,result:`${Buffer.from(e).subarray(0,t).toString(`utf8`)}\n... [truncated]`,truncated:!0,reason:`Result exceeded ${t} bytes, truncated to ${t} bytes`}}const ge=[`ui`,`headless`];function _e(e){return typeof e==`object`&&e?e:null}function k(e){return typeof e==`string`&&e.length>0?e:void 0}function A(e){return typeof e==`boolean`?e:void 0}function j(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function M(e){return typeof e==`string`&&ge.includes(e)?e:void 0}function N(e){let t=process.env[e];if(!t)return;let n=Number(t);return Number.isFinite(n)?n:void 0}function ve(e){let t=_e(e.browser)??{};return{...C,defaultMode:M(process.env.AIKIT_BROWSER_DEFAULT_MODE)??M(t.defaultMode)??C.defaultMode,browsersPath:k(process.env.AIKIT_BROWSER_PATH)??k(process.env.AIKIT_BROWSER_BROWSERS_PATH)??k(t.browsersPath)??C.browsersPath,userDataDirRoot:k(t.userDataDirRoot)??C.userDataDirRoot,idleShutdownMinutes:N(`AIKIT_BROWSER_IDLE_MINUTES`)??j(t.idleShutdownMinutes)??C.idleShutdownMinutes,allowInternalSchemes:A(t.allowInternalSchemes)??C.allowInternalSchemes,allowLoopback:A(t.allowLoopback)??C.allowLoopback,evalTimeoutMs:N(`AIKIT_BROWSER_EVAL_TIMEOUT_MS`)??j(t.evalTimeoutMs)??C.evalTimeoutMs,evalMaxResultBytes:j(t.evalMaxResultBytes)??C.evalMaxResultBytes,redactPasswordFieldsInScreenshots:A(t.redactPasswordFieldsInScreenshots)??C.redactPasswordFieldsInScreenshots,engine:k(t.engine)??C.engine,proxy:k(t.proxy),viewport:k(t.viewport)}}function P(e,t){return{content:[{type:`text`,text:e}],structuredContent:t}}function F(e,t){let n=e.selector??e.ref??(e.element?`text=${e.element}`:void 0);if(!n)throw Error(`${t} requires selector, ref, or element`);return n}function I(e){try{let t=JSON.parse(e);if(t&&typeof t==`object`){let e=L(t);if(e.length>0)return e.join(`
+`)}return JSON.stringify(t,null,2)}catch{return e}}function L(e,t=0,n=[]){let r=`  `.repeat(t),i=typeof e.role==`string`?e.role.toUpperCase():``,a=typeof e.ref==`string`?e.ref:``,o=typeof e.name==`string`?e.name:``,s=typeof e.value==`string`?`="${e.value}"`:``,c=Array.isArray(e.children)?e.children:[];if(i&&a){let e=ye(i),t=o||s||``;n.push(`${r}[${e}] [${a}] ${t}`.trimEnd())}else if(o||i){let e=i.toLowerCase();n.push(`${r}${e}: ${o}`.trimEnd())}for(let e of c)typeof e==`object`&&e&&L(e,t+1,n);return n}function ye(e){return{BUTTON:`BUTTON`,LINK:`LINK`,TEXT_FIELD:`TEXTFIELD`,TEXTBOX:`TEXTFIELD`,COMBOBOX:`SELECT`,CHECKBOX:`CHECKBOX`,RADIO:`RADIO`,SWITCH:`SWITCH`,SLIDER:`SLIDER`,TAB:`TAB`,MENU_ITEM:`MENUITEM`,LISTBOX:`LIST`,GRID:`GRID`,TABLE:`TABLE`,HEADING:`HEADING`,IMAGE:`IMAGE`,IMG:`IMAGE`,PROGRESSBAR:`PROGRESS`,DIALOG:`DIALOG`,TOOLTIP:`TOOLTIP`,ALERT:`ALERT`,MENU:`MENU`,NAVIGATION:`NAV`,SEARCH:`SEARCH`,MAIN:`MAIN`,COMPLEMENTARY:`COMPLEMENT`,CONTENTINFO:`INFO`,REGION:`REGION`}[e]??e.slice(0,8)}function be(e){return async({pageId:t,kind:n,ref:r,selector:i,element:a,text:o,key:s,value:c,fromRef:l,fromSelector:u,toRef:d,toSelector:f})=>{let p=E(e),m=p.resolvePageId(t);switch(n){case`click`:{let e=F({ref:r,selector:i,element:a},`browser_act(click)`);await p.tabExec(m,`click`,e);break}case`type`:{let e=F({ref:r,selector:i,element:a},`browser_act(type)`);await p.tabExec(m,`fill`,e,o??``);break}case`press`:{let e=F({ref:r,selector:i,element:a},`browser_act(press)`);if(!s)throw Error(`browser_act(press) requires key`);await p.tabExec(m,`press`,e,s);break}case`hover`:{let e=F({ref:r,selector:i,element:a},`browser_act(hover)`);await p.tabExec(m,`hover`,e);break}case`drag`:{let e=F({ref:l??r,selector:u??i,element:a},`browser_act(drag) source`),t=F({ref:d,selector:f??c,element:a},`browser_act(drag) target`);await p.tabExec(m,`drag`,e,t);break}case`select`:{let e=F({ref:r,selector:i,element:a},`browser_act(select)`);if(c===void 0)throw Error(`browser_act(select) requires value`);await p.tabExec(m,`select`,e,c);break}case`scroll`:{if(i||r||a){let e=F({ref:r,selector:i,element:a},`browser_act(scroll)`);await p.tabExec(m,`scrollintoview`,e);break}let e=c??`down 500`;await p.tabExec(m,`scroll`,e);break}case`upload`:{let e=F({ref:r,selector:i,element:a},`browser_act(upload)`);if(!c)throw Error(`value (file path) required for upload`);await p.tabExec(m,`upload`,e,c);break}}return p.resetIdleTimer(),P(`ok`,{ok:!0})}}function xe(e){return async({pageId:t,subAction:n,level:r,bufferSize:i,expression:a})=>{let o=E(e),s=o.resolvePageId(t);switch(n){case`enable`:{let e=[`--enable`];return i&&e.push(`--buffer-size`,String(i)),r&&e.push(`--level`,r),await o.tabExec(s,`console`,...e),o.resetIdleTimer(),P(`Console capture enabled`,{enabled:!0})}case`get`:{let t=[`--json`];r&&t.push(`--level`,r);let n=await o.tabExec(s,`console`,...t);o.resetIdleTimer();let i=[];try{i=JSON.parse(n.stdout)}catch{i=[{raw:n.stdout}]}let c,l;if(a)try{c=(await o.tabExec(s,`evaluate`,`--timeout=${e.evalTimeoutMs}`,`--`,a)).stdout}catch(e){l=e instanceof Error?e.message:String(e)}return P(c===void 0?`Console has ${i.length} entries`:`Console has ${i.length} entries\nEvaluation: ${c}`,{entries:i,count:i.length,expression:a,evalResult:c,evalError:l})}case`clear`:return await o.tabExec(s,`console`,`clear`),o.resetIdleTimer(),P(`Console cleared`,{cleared:!0});default:return P(`Unknown console sub-action`,{error:`Unknown console sub-action`})}}}function Se(e){return async({pageId:t,accept:n,promptText:r})=>{let i=E(e),a=i.resolvePageId(t);if(n){let e=r?[`accept`,`--text`,r]:[`accept`];await i.tabExec(a,`dialog`,...e)}else await i.tabExec(a,`dialog`,`dismiss`);return i.resetIdleTimer(),P(`Dialog ${n?`accepted`:`dismissed`}`,{accepted:n})}}function Ce(e){return async({pageId:t})=>{let n=E(e),r=n.resolvePageId(t),i=await n.tabExec(r,`diff`,`snapshot`);return n.resetIdleTimer(),P(i.stdout,{pageId:r,diff:i.stdout})}}function we(e){return async({pageId:t,code:n,timeoutMs:r})=>{let i=E(e),a=i.resolvePageId(t),o=r??e.evalTimeoutMs,s=await i.tabExec(a,`evaluate`,`--timeout=${o}`,`--`,n);i.resetIdleTimer();let c=O(s.stdout,e.evalMaxResultBytes);return P(c.result,{pageId:a,result:c.result,truncated:c.truncated})}}function Te(e){return async({pageId:t,url:n,method:r,headers:i,body:a,timeoutMs:o,includeHeaders:s})=>{let c=E(e),l=c.resolvePageId(t),u=o??e.evalTimeoutMs,d=Ee(n,r??`GET`,s??!0,i,a),f=await c.tabExec(l,`evaluate`,`--timeout=${u}`,`--`,d);return c.resetIdleTimer(),P(f.stdout,{pageId:l,response:f.stdout})}}function Ee(e,t,n,r,i){let a={method:t,headers:r??{}};i&&[`POST`,`PUT`,`PATCH`].includes(t.toUpperCase())&&(a.body=i);let o=JSON.stringify(a);return n?`fetch(${JSON.stringify(e)}, ${o}).then(async r => {
       const text = await r.text();
       const headers = {};
       r.headers.forEach((v, k) => { headers[k] = v; });
@@ -7,5 +7,5 @@ import{exec as e,execFile as t,execFileSync as n,execSync as r}from"node:child_p
     })`:`fetch(${JSON.stringify(e)}, ${o}).then(async r => {
       const text = await r.text();
       return JSON.stringify({ status: r.status, statusText: r.statusText, body: text.slice(0, 100000) });
-    })`}function Ee(e){return async({pageId:t,url:n,type:r,selector:i,timeoutMs:a,includeSnapshot:o})=>{let s=T(e),c=s.resolvePageId(t);if(n){let t=E(n,e);if(!t.allowed)return N(`Navigation blocked: ${t.reason}`,{blocked:!0,pageId:c,reason:t.reason});await s.tabExec(c,`goto`,n)}else if(!r)return N(`Navigation requires url or type`,{error:`Navigation requires url or type`,pageId:c});else if(r===`back`)await s.tabExec(c,`back`);else if(r===`forward`)await s.tabExec(c,`forward`);else if(r===`reload`)await s.tabExec(c,`reload`);else if(r===`waitFor`){if(!i)throw Error(`browser_navigate(waitFor) requires selector`);let e=a?[i,String(a)]:[i];await s.tabExec(c,`wait`,...e)}let l=await s.tabExec(c,`get`,`text`).catch(()=>({stdout:n??``})),u=await s.tabExec(c,`get`,`attr`,`title`).catch(()=>({stdout:``})),d=l.stdout.trim()||n||``,f=u.stdout.trim()||d;s.tabs.updateTabInfo(c,d,f),s.resetIdleTimer();let p;if(o!==!1)try{p=F(await s.readSnapshot(c))}catch{}return N(p?`${f||d}\n${d}\n\n${p}`:`${f||d}\n${d}`,{pageId:c,url:d,title:f,snapshot:p})}}function De(e){return async({pageId:t,subAction:n,filter:r,includeBody:i,bufferSize:a})=>{let o=T(e),s=o.resolvePageId(t);switch(n){case`enable`:{let e=[`--enable`];return r?.resourceTypes&&e.push(`--filter`,r.resourceTypes.join(`,`)),i&&e.push(`--include-body`),a&&e.push(`--buffer-size`,String(a)),await o.tabExec(s,`network`,...e),o.resetIdleTimer(),N(`Network capture enabled`,{enabled:!0,filter:r})}case`get`:{let e=await o.tabExec(s,`network`,`requests`,`--json`);o.resetIdleTimer();let t=[];try{t=JSON.parse(e.stdout)}catch{t=[{raw:e.stdout}]}return N(`Captured ${t.length} network requests`,{entries:t,count:t.length})}case`clear`:return await o.tabExec(s,`network`,`clear`),o.resetIdleTimer(),N(`Network capture cleared`,{cleared:!0});case`export-har`:{let e=await o.tabExec(s,`network`,`har`);return o.resetIdleTimer(),N(e.stdout,{har:e.stdout})}default:return N(`Unknown network sub-action`,{error:`Unknown network sub-action`})}}}function Oe(e){return async({url:t,mode:n,label:r,waitUntil:i,includeSnapshot:a,forceNew:o,autoDialog:s})=>{let c=E(t,e);if(!c.allowed)return N(`Navigation blocked: ${c.reason}`,{blocked:!0,reason:c.reason});let l=T(e);await l.launch(n);let u=await l.exec(`open`,t);l.tabs.register(`t0`,t,r??u.stdout.trim(),r),l.resetIdleTimer();let d=[];i===`networkidle`&&d.push(`--wait-until`,`networkidle`),i===`domcontentloaded`&&d.push(`--wait-until`,`domcontentloaded`),d.length>0&&await l.tabExec(`t0`,`wait`,...d).catch(()=>{});let f;if(a!==!1)try{f=F(await l.readSnapshot(`t0`))}catch{}return N(f?`Opened ${t}\n\n${f}`:`Opened ${t}\nTab: t0`,{pageId:`t0`,url:t,tabId:`t0`,label:r,snapshot:f})}}function ke(e){return async({pageId:t,mode:n,selector:r})=>{let i=T(e),a=i.resolvePageId(t);switch(n??`snapshot`){case`snapshot`:{let e=[`-i`,`--json`];r&&e.push(`-s`,r);let t=await i.tabExec(a,`snapshot`,...e);return i.tabs.setSnapshot(a,t.stdout),i.resetIdleTimer(),N(t.stdout,{pageId:a,mode:`snapshot`,content:t.stdout})}case`dom`:{let e=await i.tabExec(a,`get`,`html`);return i.resetIdleTimer(),N(e.stdout,{pageId:a,mode:`dom`,content:e.stdout})}case`markdown`:{let e=await i.tabExec(a,`snapshot`,`-c`);return i.resetIdleTimer(),N(e.stdout,{pageId:a,mode:`markdown`,content:e.stdout})}case`text`:{let e=await i.tabExec(a,`get`,`text`);return i.resetIdleTimer(),N(e.stdout,{pageId:a,mode:`text`,content:e.stdout})}default:return N(`Unknown read mode`,{error:`Unknown read mode`,pageId:a})}}}function Ae(e){return async({pageId:t,ref:n,selector:r,fullPage:i,annotate:a,clip:o,format:s,quality:c})=>{let l=T(e),u=l.resolvePageId(t),d=r??n;if(d){let e=await l.tabExec(u,`screenshot`,`--element`,d);return l.resetIdleTimer(),N(`Screenshot captured for element ${d}`,{element:d,pageId:u,screenshot:e.stdout})}let f=await l.screenshot(u,{fullPage:i,format:s,quality:c,annotate:a});return l.resetIdleTimer(),N(`Screenshot captured (${f.bytes} bytes)`,{pageId:u,base64:f.base64,mimeType:f.mimeType,bytes:f.bytes})}}function je(e){return async({sessionAction:t,pageId:n,confirm:r,cookies:i,name:a,storageType:o,storageKey:s,storageValue:c})=>{let l=T(e),u=n?l.resolvePageId(n):void 0;switch(t){case`list`:{let e=l.tabs.listPages().map(e=>({pageId:e.pageId,url:e.url,title:e.title,label:e.label,createdAt:e.createdAt.toISOString()}));return N(`Open tabs: ${e.length}\n${e.map(e=>`  ${e.pageId}: ${e.title||e.url}`).join(`
-`)}`,{pages:e})}case`close`:return u?(await l.tabExec(u,`close`).catch(()=>{}),await l.tabs.removeTab(u),l.resetIdleTimer(),N(`Closed tab ${u}`,{closed:u})):N(`close requires pageId`,{error:`pageId required`});case`cookies`:{if(!r)return N(`Cookie export requires explicit confirmation. Set confirm: true to proceed.`,{confirmRequired:!0});let e=await l.tabExec(u??`t0`,`cookies`),t=[];try{t=JSON.parse(e.stdout)}catch{t=[{raw:e.stdout}]}return N(`Exported ${t.length} cookies`,{cookies:t,count:t.length})}case`set-cookie`:{if(!i||i.length===0)return N(`set-cookie requires cookies array`,{error:`cookies array required`});let e=i.map(e=>`${e.name}=${e.value}${e.domain?`; domain=${e.domain}`:``}${e.path?`; path=${e.path}`:``}`).join(` `);return await l.tabExec(u??`t0`,`cookies`,`set`,e),l.resetIdleTimer(),N(`Set ${i.length} cookies`,{count:i.length})}case`delete-cookie`:return a?(await l.tabExec(u??`t0`,`cookies`,`clear`,a),l.resetIdleTimer(),N(`Deleted cookie ${a}`,{deleted:a})):N(`delete-cookie requires name`,{error:`name required`});case`clear-cookies`:return await l.tabExec(u??`t0`,`cookies`,`clear`),l.resetIdleTimer(),N(`Cookies cleared`,{cleared:!0});case`get-storage`:{if(!o||!s)return N(`get-storage requires storageType and storageKey`,{error:`storageType and storageKey required`});let e=await l.tabExec(u??`t0`,`storage`,o===`localStorage`?`local`:`session`,`get`,s);return l.resetIdleTimer(),N(e.stdout,{value:e.stdout})}case`set-storage`:return!o||!s||c===void 0?N(`set-storage requires storageType, storageKey, and storageValue`,{error:`storageType, storageKey, storageValue required`}):(await l.tabExec(u??`t0`,`storage`,o===`localStorage`?`local`:`session`,`set`,s,c),l.resetIdleTimer(),N(`Storage key ${s} set`,{key:s}));case`clear-storage`:return o?(await l.tabExec(u??`t0`,`storage`,o===`localStorage`?`local`:`session`,`clear`),l.resetIdleTimer(),N(`Storage cleared`,{cleared:!0})):N(`clear-storage requires storageType`,{error:`storageType required`});default:return N(`Unknown session action`,{error:`Unknown session action`})}}}const L=[`open`,`batch`,`read`,`act`,`navigate`,`network`,`console`,`fetch`,`eval`,`diff`,`screenshot`,`dialog`,`session`],R=[`ui`,`headless`],z=[`load`,`domcontentloaded`,`networkidle`],B=[`click`,`type`,`press`,`hover`,`drag`,`select`,`scroll`,`upload`],V=[`back`,`forward`,`reload`,`waitFor`],H=[`enable`,`get`,`clear`,`export-har`],U=[`enable`,`get`,`clear`],W=[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`,`OPTIONS`],G=[`list`,`close`,`cookies`,`set-cookie`,`delete-cookie`,`clear-cookies`,`get-storage`,`set-storage`,`clear-storage`],Me={action:p.enum(L).describe(`Browser action to perform`),pageId:p.string().optional().describe(`Tracked browser page identifier`),label:p.string().optional().describe(`Human-readable label for the page (used as alternative to pageId)`),url:p.string().url().optional().describe(`URL to open or navigate to`),mode:p.enum(R).optional().describe(`Browser launch mode (open only)`),forceNew:p.boolean().optional().describe(`Reserved for future tab reuse`),autoDialog:p.boolean().optional().describe(`Auto-accept alert/beforeunload dialogs (default: true). Set false to handle all dialogs manually.`),includeSnapshot:p.boolean().optional().describe(`Include ARIA snapshot in response (default: true for open/navigate). Set false to skip snapshot for speed.`),waitUntil:p.enum(z).optional().describe(`Navigation readiness event`),kind:p.enum(B).optional().describe(`Interaction kind (act only)`),ref:p.string().optional().describe(`Target ref alias`),selector:p.string().optional().describe(`CSS selector for targeting`),element:p.string().optional().describe(`Human-readable element label. Prefer selector for precision.`),text:p.string().optional().describe(`Text to type`),key:p.string().optional().describe(`Key to press`),value:p.string().optional().describe(`Option value or drag target`),fromRef:p.string().optional().describe(`Drag source ref`),fromSelector:p.string().optional().describe(`Drag source selector`),toRef:p.string().optional().describe(`Drag target ref`),toSelector:p.string().optional().describe(`Drag target selector`),type:p.enum(V).optional().describe(`Navigation type`),subAction:p.enum(H).optional().describe(`Network sub-action: enable, get, clear, or export-har`),code:p.string().optional().describe(`JavaScript expression or IIFE evaluated in page context.`),timeoutMs:p.number().min(1).max(6e4).optional().describe(`Timeout in milliseconds`),filter:p.object({resourceTypes:p.array(p.string()).optional(),urlPattern:p.string().optional(),excludeUrls:p.array(p.string()).optional()}).optional().describe(`Network capture filter for resource types and URL patterns`),showSensitive:p.boolean().optional().describe(`Include sensitive headers instead of redacting them`),includeBody:p.boolean().optional().describe(`Include truncated request bodies in captured entries`),bufferSize:p.number().int().min(1).max(1e4).optional().describe(`Buffer capacity (1-10000, default varies by action)`),consoleSubAction:p.enum(U).optional().describe(`Console sub-action: enable, get, or clear`),expression:p.string().optional().describe(`JavaScript expression to evaluate in page context (console get only). Like browser_console expression in Hermes.`),level:p.string().optional().describe(`Filter console entries by level (log/info/warn/error/debug)`),fetchUrl:p.string().optional().describe(`URL for fetch action (http/https only). Uses page cookies/session.`),fetchMethod:p.enum(W).optional().describe(`HTTP method for fetch action (default: GET)`),fetchHeaders:p.record(p.string(),p.string()).optional().describe(`Custom headers for fetch action`),fetchBody:p.string().optional().describe(`Request body for fetch action (POST/PUT/PATCH)`),includeResponseHeaders:p.boolean().optional().describe(`Include response headers in fetch output (default: true)`),fullPage:p.boolean().optional().describe(`Capture full page`),annotate:p.boolean().optional().describe(`Overlay numbered [N] labels on interactive elements matching snapshot ref IDs (screenshot only).`),redactPasswords:p.boolean().optional().describe(`Mask password fields`),readMode:p.enum([`snapshot`,`dom`,`markdown`,`text`]).optional().describe(`Extraction mode for read action: snapshot (ARIA tree), dom (HTML), markdown (clean MD), text (plain text)`),clip:p.object({x:p.number(),y:p.number(),width:p.number(),height:p.number()}).optional().describe(`Capture a specific page region { x, y, width, height }`),format:p.enum([`png`,`jpeg`]).optional().describe(`Screenshot image format (default: png)`),quality:p.number().min(0).max(100).optional().describe(`JPEG quality 0-100 (only for jpeg format)`),cookies:p.array(p.object({name:p.string(),value:p.string(),url:p.string().optional(),domain:p.string().optional(),path:p.string().optional(),expires:p.number().optional(),httpOnly:p.boolean().optional(),secure:p.boolean().optional(),sameSite:p.enum([`Lax`,`None`,`Strict`]).optional()})).optional().describe(`Cookies to set (for session set-cookie action)`),name:p.string().optional().describe(`Cookie name for delete-cookie action`),storageType:p.enum([`localStorage`,`sessionStorage`]).optional().describe(`Storage type for get/set/clear-storage actions`),storageKey:p.string().optional().describe(`Storage key to get or set`),storageValue:p.string().optional().describe(`Value to set in storage`),accept:p.boolean().optional().describe(`Accept or dismiss dialog`),promptText:p.string().optional().describe(`Text for prompt dialog`),sessionAction:p.enum(G).optional().describe(`Session sub-action (session only)`),confirm:p.boolean().optional().describe(`Explicit confirmation for cookie export`),steps:p.array(p.record(p.string(),p.unknown())).optional().describe(`Array of action steps for batch execution. Each step is an object with action + action-specific params.`)};function Ne(e,t){return typeof e==`string`&&t.includes(e)}function K(e,t,n){let r=e[t];if(typeof r!=`string`)throw Error(`${n} requires ${t}`);return r}function Pe(e,t,n){let r=e[t];if(typeof r!=`boolean`)throw Error(`${n} requires ${t}`);return r}function q(e,t){let n=e[t];return typeof n==`string`?n:void 0}function J(e,t){let n=e[t];return typeof n==`boolean`?n:void 0}function Y(e,t){let n=e[t];return typeof n==`number`?n:void 0}function X(e,t){let n=e[t];return typeof n==`object`&&n?n:void 0}function Fe(e,t){let n=e.steps;if(!Array.isArray(n)||n.length===0)throw Error(`${t} requires non-empty steps`);return n.map((e,n)=>{if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`${t} step ${n+1} must be an object`);return e})}function Z(e,t,n,r){let i=e[t];if(!Ne(i,n))throw Error(`${r} requires ${t}`);return i}function Q(e,t,n,r){let i=e[t];if(i!==void 0){if(!Ne(i,n))throw Error(`${r} received invalid ${t}`);return i}}function Ie(e,t){let n=q(e,`pageId`);if(n)return T(t).resolvePageId(n)}function $(e,t,n){let r=q(e,`pageId`);if(!r)throw Error(`${n} requires pageId`);return T(t).resolvePageId(r)}async function Le(e,t,n){let r=Z(e,`action`,L,`browser`);switch(r){case`open`:return t.openHandler({url:K(e,`url`,`browser(open)`),mode:Q(e,`mode`,R,`browser(open)`),forceNew:J(e,`forceNew`),label:q(e,`label`),autoDialog:J(e,`autoDialog`),waitUntil:Q(e,`waitUntil`,z,`browser(open)`),includeSnapshot:J(e,`includeSnapshot`)});case`batch`:{let r=Fe(e,`browser(batch)`),i=[],a=0;for(let e=0;e<r.length;e+=1){let o=r[e],s=q(o,`action`)??`unknown`;try{let r=await Le(o,t,n);a+=1,i.push({index:e,action:s,ok:!0,result:r})}catch(t){i.push({index:e,action:s,ok:!1,error:t instanceof Error?t.message:String(t)})}}return N(`Batch completed: ${a}/${r.length} steps succeeded`,{total:r.length,succeeded:a,steps:i})}case`read`:return t.readHandler({pageId:$(e,n,`browser(read)`),mode:Q(e,`readMode`,[`snapshot`,`dom`,`markdown`,`text`],`browser(read)`),selector:q(e,`selector`)});case`act`:return t.actHandler({pageId:$(e,n,`browser(act)`),kind:Z(e,`kind`,B,`browser(act)`),ref:q(e,`ref`),selector:q(e,`selector`),element:q(e,`element`),text:q(e,`text`),key:q(e,`key`),value:q(e,`value`),fromRef:q(e,`fromRef`),fromSelector:q(e,`fromSelector`),toRef:q(e,`toRef`),toSelector:q(e,`toSelector`)});case`navigate`:return t.navigateHandler({pageId:$(e,n,`browser(navigate)`),url:q(e,`url`),type:Q(e,`type`,V,`browser(navigate)`),selector:q(e,`selector`),timeoutMs:Y(e,`timeoutMs`),includeSnapshot:J(e,`includeSnapshot`)});case`network`:return t.networkHandler({pageId:$(e,n,`browser(network)`),subAction:Z(e,`subAction`,H,`browser(network)`),filter:X(e,`filter`),showSensitive:J(e,`showSensitive`),includeBody:J(e,`includeBody`),bufferSize:Y(e,`bufferSize`)});case`console`:return t.consoleHandler({pageId:$(e,n,`browser(console)`),subAction:Z(e,`consoleSubAction`,U,`browser(console)`),level:q(e,`level`),bufferSize:Y(e,`bufferSize`),expression:q(e,`expression`)});case`fetch`:return t.fetchHandler({pageId:$(e,n,`browser(fetch)`),url:K(e,`fetchUrl`,`browser(fetch)`),method:Q(e,`fetchMethod`,W,`browser(fetch)`),headers:X(e,`fetchHeaders`),body:q(e,`fetchBody`),timeoutMs:Y(e,`timeoutMs`),includeHeaders:J(e,`includeResponseHeaders`)});case`eval`:return t.evalHandler({pageId:$(e,n,`browser(eval)`),code:K(e,`code`,`browser(eval)`),timeoutMs:Y(e,`timeoutMs`)});case`diff`:return t.diffHandler({pageId:$(e,n,`browser(diff)`)});case`screenshot`:{let r=X(e,`clip`);return t.screenshotHandler({pageId:$(e,n,`browser(screenshot)`),ref:q(e,`ref`),selector:q(e,`selector`),fullPage:J(e,`fullPage`),annotate:J(e,`annotate`),redactPasswords:J(e,`redactPasswords`),clip:r,format:Q(e,`format`,[`png`,`jpeg`],`browser(screenshot)`),quality:Y(e,`quality`)})}case`dialog`:return t.dialogHandler({pageId:$(e,n,`browser(dialog)`),accept:Pe(e,`accept`,`browser(dialog)`),promptText:q(e,`promptText`)});case`session`:return t.sessionHandler({sessionAction:Z(e,`sessionAction`,G,`browser(session)`),pageId:q(e,`pageId`)&&Ie(e,n),confirm:J(e,`confirm`),cookies:X(e,`cookies`),name:q(e,`name`),storageType:Q(e,`storageType`,[`localStorage`,`sessionStorage`],`browser(session)`),storageKey:q(e,`storageKey`),storageValue:q(e,`storageValue`)});default:return N(`Unknown action: ${r}`,{error:`Unknown action: ${r}`})}}function Re(e,t){let n=_e(t),r={openHandler:Oe(n),readHandler:ke(n),actHandler:ye(n),navigateHandler:Ee(n),networkHandler:De(n),consoleHandler:be(n),fetchHandler:we(n),evalHandler:Ce(n),diffHandler:Se(n),screenshotHandler:Ae(n),dialogHandler:xe(n),sessionHandler:je(n)};e.tool(`browser`,`Unified browser automation tool using agent-browser (Chrome DevTools Protocol). Provides open, read, act, navigate, screenshot, eval, dialog, network, console, fetch, diff, session actions. New: includeSnapshot (open/navigate auto-returns ARIA tree), annotate (numbered labels on screenshots), expression (evaluate JS in console action).`,Me,async e=>{try{let t=await Le(e,r,n);return{content:t.content,structuredContent:t.structuredContent}}catch(e){return{content:[{type:`text`,text:`Browser error: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{C as BrowserEngine,S as DEFAULT_BROWSER_CONFIG,pe as SessionRegistry,x as TabRegistry,ue as autoSelectMode,me as closeEngine,oe as ensureAgentBrowserInstalled,se as getAgentBrowserVersion,de as getDaemonArgs,g as getDefaultBrowsersPath,T as getEngine,fe as getLaunchArgs,ce as isBrowserReady,E as isUrlAllowed,Re as registerBrowserTools,_ as resolveBrowsersPath,D as validateEvalResult};
+    })`}function De(e){return async({pageId:t,url:n,type:r,selector:i,timeoutMs:a,includeSnapshot:o})=>{let s=E(e),c=s.resolvePageId(t);if(n){let t=D(n,e);if(!t.allowed)return P(`Navigation blocked: ${t.reason}`,{blocked:!0,pageId:c,reason:t.reason});await s.tabExec(c,`goto`,n)}else if(!r)return P(`Navigation requires url or type`,{error:`Navigation requires url or type`,pageId:c});else if(r===`back`)await s.tabExec(c,`back`);else if(r===`forward`)await s.tabExec(c,`forward`);else if(r===`reload`)await s.tabExec(c,`reload`);else if(r===`waitFor`){if(!i)throw Error(`browser_navigate(waitFor) requires selector`);let e=a?[i,String(a)]:[i];await s.tabExec(c,`wait`,...e)}let l=await s.tabExec(c,`get`,`text`).catch(()=>({stdout:n??``})),u=await s.tabExec(c,`get`,`attr`,`title`).catch(()=>({stdout:``})),d=l.stdout.trim()||n||``,f=u.stdout.trim()||d;s.tabs.updateTabInfo(c,d,f),s.resetIdleTimer();let p;if(o!==!1)try{p=I(await s.readSnapshot(c))}catch{}return P(p?`${f||d}\n${d}\n\n${p}`:`${f||d}\n${d}`,{pageId:c,url:d,title:f,snapshot:p})}}function Oe(e){return async({pageId:t,subAction:n,filter:r,includeBody:i,bufferSize:a})=>{let o=E(e),s=o.resolvePageId(t);switch(n){case`enable`:{let e=[`--enable`];return r?.resourceTypes&&e.push(`--filter`,r.resourceTypes.join(`,`)),i&&e.push(`--include-body`),a&&e.push(`--buffer-size`,String(a)),await o.tabExec(s,`network`,...e),o.resetIdleTimer(),P(`Network capture enabled`,{enabled:!0,filter:r})}case`get`:{let e=await o.tabExec(s,`network`,`requests`,`--json`);o.resetIdleTimer();let t=[];try{t=JSON.parse(e.stdout)}catch{t=[{raw:e.stdout}]}return P(`Captured ${t.length} network requests`,{entries:t,count:t.length})}case`clear`:return await o.tabExec(s,`network`,`clear`),o.resetIdleTimer(),P(`Network capture cleared`,{cleared:!0});case`export-har`:{let e=await o.tabExec(s,`network`,`har`);return o.resetIdleTimer(),P(e.stdout,{har:e.stdout})}default:return P(`Unknown network sub-action`,{error:`Unknown network sub-action`})}}}function ke(e){return async({url:t,mode:n,label:r,waitUntil:i,includeSnapshot:a,forceNew:o,autoDialog:s})=>{let c=D(t,e);if(!c.allowed)return P(`Navigation blocked: ${c.reason}`,{blocked:!0,reason:c.reason});let l=E(e);await l.launch(n);let u=await l.exec(`open`,t);l.tabs.register(`t0`,t,r??u.stdout.trim(),r),l.resetIdleTimer();let d=[];i===`networkidle`&&d.push(`--wait-until`,`networkidle`),i===`domcontentloaded`&&d.push(`--wait-until`,`domcontentloaded`),d.length>0&&await l.tabExec(`t0`,`wait`,...d).catch(()=>{});let f;if(a!==!1)try{f=I(await l.readSnapshot(`t0`))}catch{}return P(f?`Opened ${t}\n\n${f}`:`Opened ${t}\nTab: t0`,{pageId:`t0`,url:t,tabId:`t0`,label:r,snapshot:f})}}function Ae(e){return async({pageId:t,mode:n,selector:r})=>{let i=E(e),a=i.resolvePageId(t);switch(n??`snapshot`){case`snapshot`:{let e=[`-i`,`--json`];r&&e.push(`-s`,r);let t=await i.tabExec(a,`snapshot`,...e);return i.tabs.setSnapshot(a,t.stdout),i.resetIdleTimer(),P(t.stdout,{pageId:a,mode:`snapshot`,content:t.stdout})}case`dom`:{let e=await i.tabExec(a,`get`,`html`);return i.resetIdleTimer(),P(e.stdout,{pageId:a,mode:`dom`,content:e.stdout})}case`markdown`:{let e=await i.tabExec(a,`snapshot`,`-c`);return i.resetIdleTimer(),P(e.stdout,{pageId:a,mode:`markdown`,content:e.stdout})}case`text`:{let e=await i.tabExec(a,`get`,`text`);return i.resetIdleTimer(),P(e.stdout,{pageId:a,mode:`text`,content:e.stdout})}default:return P(`Unknown read mode`,{error:`Unknown read mode`,pageId:a})}}}function je(e){return async({pageId:t,ref:n,selector:r,fullPage:i,annotate:a,clip:o,format:s,quality:c})=>{let l=E(e),u=l.resolvePageId(t),d=r??n;if(d){let e=await l.tabExec(u,`screenshot`,`--element`,d);return l.resetIdleTimer(),P(`Screenshot captured for element ${d}`,{element:d,pageId:u,screenshot:e.stdout})}let f=await l.screenshot(u,{fullPage:i,format:s,quality:c,annotate:a});return l.resetIdleTimer(),P(`Screenshot captured (${f.bytes} bytes)`,{pageId:u,base64:f.base64,mimeType:f.mimeType,bytes:f.bytes})}}function Me(e){return async({sessionAction:t,pageId:n,confirm:r,cookies:i,name:a,storageType:o,storageKey:s,storageValue:c})=>{let l=E(e),u=n?l.resolvePageId(n):void 0;switch(t){case`list`:{let e=l.tabs.listPages().map(e=>({pageId:e.pageId,url:e.url,title:e.title,label:e.label,createdAt:e.createdAt.toISOString()}));return P(`Open tabs: ${e.length}\n${e.map(e=>`  ${e.pageId}: ${e.title||e.url}`).join(`
+`)}`,{pages:e})}case`close`:return u?(await l.tabExec(u,`close`).catch(()=>{}),await l.tabs.removeTab(u),l.resetIdleTimer(),P(`Closed tab ${u}`,{closed:u})):P(`close requires pageId`,{error:`pageId required`});case`cookies`:{if(!r)return P(`Cookie export requires explicit confirmation. Set confirm: true to proceed.`,{confirmRequired:!0});let e=await l.tabExec(u??`t0`,`cookies`),t=[];try{t=JSON.parse(e.stdout)}catch{t=[{raw:e.stdout}]}return P(`Exported ${t.length} cookies`,{cookies:t,count:t.length})}case`set-cookie`:{if(!i||i.length===0)return P(`set-cookie requires cookies array`,{error:`cookies array required`});let e=i.map(e=>`${e.name}=${e.value}${e.domain?`; domain=${e.domain}`:``}${e.path?`; path=${e.path}`:``}`).join(` `);return await l.tabExec(u??`t0`,`cookies`,`set`,e),l.resetIdleTimer(),P(`Set ${i.length} cookies`,{count:i.length})}case`delete-cookie`:return a?(await l.tabExec(u??`t0`,`cookies`,`clear`,a),l.resetIdleTimer(),P(`Deleted cookie ${a}`,{deleted:a})):P(`delete-cookie requires name`,{error:`name required`});case`clear-cookies`:return await l.tabExec(u??`t0`,`cookies`,`clear`),l.resetIdleTimer(),P(`Cookies cleared`,{cleared:!0});case`get-storage`:{if(!o||!s)return P(`get-storage requires storageType and storageKey`,{error:`storageType and storageKey required`});let e=await l.tabExec(u??`t0`,`storage`,o===`localStorage`?`local`:`session`,`get`,s);return l.resetIdleTimer(),P(e.stdout,{value:e.stdout})}case`set-storage`:return!o||!s||c===void 0?P(`set-storage requires storageType, storageKey, and storageValue`,{error:`storageType, storageKey, storageValue required`}):(await l.tabExec(u??`t0`,`storage`,o===`localStorage`?`local`:`session`,`set`,s,c),l.resetIdleTimer(),P(`Storage key ${s} set`,{key:s}));case`clear-storage`:return o?(await l.tabExec(u??`t0`,`storage`,o===`localStorage`?`local`:`session`,`clear`),l.resetIdleTimer(),P(`Storage cleared`,{cleared:!0})):P(`clear-storage requires storageType`,{error:`storageType required`});default:return P(`Unknown session action`,{error:`Unknown session action`})}}}const R=[`open`,`batch`,`read`,`act`,`navigate`,`network`,`console`,`fetch`,`eval`,`diff`,`screenshot`,`dialog`,`session`],z=[`ui`,`headless`],B=[`load`,`domcontentloaded`,`networkidle`],V=[`click`,`type`,`press`,`hover`,`drag`,`select`,`scroll`,`upload`],H=[`back`,`forward`,`reload`,`waitFor`],U=[`enable`,`get`,`clear`,`export-har`],W=[`enable`,`get`,`clear`],Ne=[`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`,`OPTIONS`],Pe=[`list`,`close`,`cookies`,`set-cookie`,`delete-cookie`,`clear-cookies`,`get-storage`,`set-storage`,`clear-storage`],Fe={action:h.enum(R).describe(`Browser action to perform`),pageId:h.string().optional().describe(`Tracked browser page identifier`),label:h.string().optional().describe(`Human-readable label for the page (used as alternative to pageId)`),url:h.string().url().optional().describe(`URL to open or navigate to`),mode:h.enum(z).optional().describe(`Browser launch mode (open only)`),forceNew:h.boolean().optional().describe(`Reserved for future tab reuse`),autoDialog:h.boolean().optional().describe(`Auto-accept alert/beforeunload dialogs (default: true). Set false to handle all dialogs manually.`),includeSnapshot:h.boolean().optional().describe(`Include ARIA snapshot in response (default: true for open/navigate). Set false to skip snapshot for speed.`),waitUntil:h.enum(B).optional().describe(`Navigation readiness event`),kind:h.enum(V).optional().describe(`Interaction kind (act only)`),ref:h.string().optional().describe(`Target ref alias`),selector:h.string().optional().describe(`CSS selector for targeting`),element:h.string().optional().describe(`Human-readable element label. Prefer selector for precision.`),text:h.string().optional().describe(`Text to type`),key:h.string().optional().describe(`Key to press`),value:h.string().optional().describe(`Option value or drag target`),fromRef:h.string().optional().describe(`Drag source ref`),fromSelector:h.string().optional().describe(`Drag source selector`),toRef:h.string().optional().describe(`Drag target ref`),toSelector:h.string().optional().describe(`Drag target selector`),type:h.enum(H).optional().describe(`Navigation type`),subAction:h.enum(U).optional().describe(`Network sub-action: enable, get, clear, or export-har`),code:h.string().optional().describe(`JavaScript expression or IIFE evaluated in page context.`),timeoutMs:h.number().min(1).max(6e4).optional().describe(`Timeout in milliseconds`),filter:h.object({resourceTypes:h.array(h.string()).optional(),urlPattern:h.string().optional(),excludeUrls:h.array(h.string()).optional()}).optional().describe(`Network capture filter for resource types and URL patterns`),showSensitive:h.boolean().optional().describe(`Include sensitive headers instead of redacting them`),includeBody:h.boolean().optional().describe(`Include truncated request bodies in captured entries`),bufferSize:h.number().int().min(1).max(1e4).optional().describe(`Buffer capacity (1-10000, default varies by action)`),consoleSubAction:h.enum(W).optional().describe(`Console sub-action: enable, get, or clear`),expression:h.string().optional().describe(`JavaScript expression to evaluate in page context (console get only). Like browser_console expression in Hermes.`),level:h.string().optional().describe(`Filter console entries by level (log/info/warn/error/debug)`),fetchUrl:h.string().optional().describe(`URL for fetch action (http/https only). Uses page cookies/session.`),fetchMethod:h.enum(Ne).optional().describe(`HTTP method for fetch action (default: GET)`),fetchHeaders:h.record(h.string(),h.string()).optional().describe(`Custom headers for fetch action`),fetchBody:h.string().optional().describe(`Request body for fetch action (POST/PUT/PATCH)`),includeResponseHeaders:h.boolean().optional().describe(`Include response headers in fetch output (default: true)`),fullPage:h.boolean().optional().describe(`Capture full page`),annotate:h.boolean().optional().describe(`Overlay numbered [N] labels on interactive elements matching snapshot ref IDs (screenshot only).`),redactPasswords:h.boolean().optional().describe(`Mask password fields`),readMode:h.enum([`snapshot`,`dom`,`markdown`,`text`]).optional().describe(`Extraction mode for read action: snapshot (ARIA tree), dom (HTML), markdown (clean MD), text (plain text)`),clip:h.object({x:h.number(),y:h.number(),width:h.number(),height:h.number()}).optional().describe(`Capture a specific page region { x, y, width, height }`),format:h.enum([`png`,`jpeg`]).optional().describe(`Screenshot image format (default: png)`),quality:h.number().min(0).max(100).optional().describe(`JPEG quality 0-100 (only for jpeg format)`),cookies:h.array(h.object({name:h.string(),value:h.string(),url:h.string().optional(),domain:h.string().optional(),path:h.string().optional(),expires:h.number().optional(),httpOnly:h.boolean().optional(),secure:h.boolean().optional(),sameSite:h.enum([`Lax`,`None`,`Strict`]).optional()})).optional().describe(`Cookies to set (for session set-cookie action)`),name:h.string().optional().describe(`Cookie name for delete-cookie action`),storageType:h.enum([`localStorage`,`sessionStorage`]).optional().describe(`Storage type for get/set/clear-storage actions`),storageKey:h.string().optional().describe(`Storage key to get or set`),storageValue:h.string().optional().describe(`Value to set in storage`),accept:h.boolean().optional().describe(`Accept or dismiss dialog`),promptText:h.string().optional().describe(`Text for prompt dialog`),sessionAction:h.enum(Pe).optional().describe(`Session sub-action (session only)`),confirm:h.boolean().optional().describe(`Explicit confirmation for cookie export`),steps:h.array(h.record(h.string(),h.unknown())).optional().describe(`Array of action steps for batch execution. Each step is an object with action + action-specific params.`)};function G(e,t){return typeof e==`string`&&t.includes(e)}function K(e,t,n){let r=e[t];if(typeof r!=`string`)throw Error(`${n} requires ${t}`);return r}function Ie(e,t,n){let r=e[t];if(typeof r!=`boolean`)throw Error(`${n} requires ${t}`);return r}function q(e,t){let n=e[t];return typeof n==`string`?n:void 0}function J(e,t){let n=e[t];return typeof n==`boolean`?n:void 0}function Y(e,t){let n=e[t];return typeof n==`number`?n:void 0}function X(e,t){let n=e[t];return typeof n==`object`&&n?n:void 0}function Le(e,t){let n=e.steps;if(!Array.isArray(n)||n.length===0)throw Error(`${t} requires non-empty steps`);return n.map((e,n)=>{if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`${t} step ${n+1} must be an object`);return e})}function Z(e,t,n,r){let i=e[t];if(!G(i,n))throw Error(`${r} requires ${t}`);return i}function Q(e,t,n,r){let i=e[t];if(i!==void 0){if(!G(i,n))throw Error(`${r} received invalid ${t}`);return i}}function Re(e,t){let n=q(e,`pageId`);if(n)return E(t).resolvePageId(n)}function $(e,t,n){let r=q(e,`pageId`);if(!r)throw Error(`${n} requires pageId`);return E(t).resolvePageId(r)}async function ze(e,t,n){let r=Z(e,`action`,R,`browser`);switch(r){case`open`:return t.openHandler({url:K(e,`url`,`browser(open)`),mode:Q(e,`mode`,z,`browser(open)`),forceNew:J(e,`forceNew`),label:q(e,`label`),autoDialog:J(e,`autoDialog`),waitUntil:Q(e,`waitUntil`,B,`browser(open)`),includeSnapshot:J(e,`includeSnapshot`)});case`batch`:{let r=Le(e,`browser(batch)`),i=[],a=0;for(let e=0;e<r.length;e+=1){let o=r[e],s=q(o,`action`)??`unknown`;try{let r=await ze(o,t,n);a+=1,i.push({index:e,action:s,ok:!0,result:r})}catch(t){i.push({index:e,action:s,ok:!1,error:t instanceof Error?t.message:String(t)})}}return P(`Batch completed: ${a}/${r.length} steps succeeded`,{total:r.length,succeeded:a,steps:i})}case`read`:return t.readHandler({pageId:$(e,n,`browser(read)`),mode:Q(e,`readMode`,[`snapshot`,`dom`,`markdown`,`text`],`browser(read)`),selector:q(e,`selector`)});case`act`:return t.actHandler({pageId:$(e,n,`browser(act)`),kind:Z(e,`kind`,V,`browser(act)`),ref:q(e,`ref`),selector:q(e,`selector`),element:q(e,`element`),text:q(e,`text`),key:q(e,`key`),value:q(e,`value`),fromRef:q(e,`fromRef`),fromSelector:q(e,`fromSelector`),toRef:q(e,`toRef`),toSelector:q(e,`toSelector`)});case`navigate`:return t.navigateHandler({pageId:$(e,n,`browser(navigate)`),url:q(e,`url`),type:Q(e,`type`,H,`browser(navigate)`),selector:q(e,`selector`),timeoutMs:Y(e,`timeoutMs`),includeSnapshot:J(e,`includeSnapshot`)});case`network`:return t.networkHandler({pageId:$(e,n,`browser(network)`),subAction:Z(e,`subAction`,U,`browser(network)`),filter:X(e,`filter`),showSensitive:J(e,`showSensitive`),includeBody:J(e,`includeBody`),bufferSize:Y(e,`bufferSize`)});case`console`:return t.consoleHandler({pageId:$(e,n,`browser(console)`),subAction:Z(e,`consoleSubAction`,W,`browser(console)`),level:q(e,`level`),bufferSize:Y(e,`bufferSize`),expression:q(e,`expression`)});case`fetch`:return t.fetchHandler({pageId:$(e,n,`browser(fetch)`),url:K(e,`fetchUrl`,`browser(fetch)`),method:Q(e,`fetchMethod`,Ne,`browser(fetch)`),headers:X(e,`fetchHeaders`),body:q(e,`fetchBody`),timeoutMs:Y(e,`timeoutMs`),includeHeaders:J(e,`includeResponseHeaders`)});case`eval`:return t.evalHandler({pageId:$(e,n,`browser(eval)`),code:K(e,`code`,`browser(eval)`),timeoutMs:Y(e,`timeoutMs`)});case`diff`:return t.diffHandler({pageId:$(e,n,`browser(diff)`)});case`screenshot`:{let r=X(e,`clip`);return t.screenshotHandler({pageId:$(e,n,`browser(screenshot)`),ref:q(e,`ref`),selector:q(e,`selector`),fullPage:J(e,`fullPage`),annotate:J(e,`annotate`),redactPasswords:J(e,`redactPasswords`),clip:r,format:Q(e,`format`,[`png`,`jpeg`],`browser(screenshot)`),quality:Y(e,`quality`)})}case`dialog`:return t.dialogHandler({pageId:$(e,n,`browser(dialog)`),accept:Ie(e,`accept`,`browser(dialog)`),promptText:q(e,`promptText`)});case`session`:return t.sessionHandler({sessionAction:Z(e,`sessionAction`,Pe,`browser(session)`),pageId:q(e,`pageId`)&&Re(e,n),confirm:J(e,`confirm`),cookies:X(e,`cookies`),name:q(e,`name`),storageType:Q(e,`storageType`,[`localStorage`,`sessionStorage`],`browser(session)`),storageKey:q(e,`storageKey`),storageValue:q(e,`storageValue`)});default:return P(`Unknown action: ${r}`,{error:`Unknown action: ${r}`})}}function Be(e,t){let n=ve(t),r={openHandler:ke(n),readHandler:Ae(n),actHandler:be(n),navigateHandler:De(n),networkHandler:Oe(n),consoleHandler:xe(n),fetchHandler:Te(n),evalHandler:we(n),diffHandler:Ce(n),screenshotHandler:je(n),dialogHandler:Se(n),sessionHandler:Me(n)};e.tool(`browser`,`Unified browser automation tool using agent-browser (Chrome DevTools Protocol). Provides open, read, act, navigate, screenshot, eval, dialog, network, console, fetch, diff, session actions. New: includeSnapshot (open/navigate auto-returns ARIA tree), annotate (numbered labels on screenshots), expression (evaluate JS in console action).`,Fe,async e=>{try{let t=await ze(e,r,n);return{content:t.content,structuredContent:t.structuredContent}}catch(e){return{content:[{type:`text`,text:`Browser error: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{w as BrowserEngine,C as DEFAULT_BROWSER_CONFIG,me as SessionRegistry,S as TabRegistry,de as autoSelectMode,he as closeEngine,se as ensureAgentBrowserInstalled,ce as getAgentBrowserVersion,fe as getDaemonArgs,v as getDefaultBrowsersPath,E as getEngine,pe as getLaunchArgs,le as isBrowserReady,D as isUrlAllowed,Be as registerBrowserTools,y as resolveBrowsersPath,O as validateEvalResult};

package/packages/claude-desktop/dist/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "aikit",
   "display_name": "AI Kit",
-  "version": "0.1.385",
+  "version": "0.1.387",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "author": {
     "name": "AnVPX",