@agentstats/sdk 0.4.0 → 0.5.0

package/dist/browser.iife.js

@@ -1 +1 @@
-var AgentStatsSDK=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});let t=`agentstats:locationchange`,n=Symbol.for(`agentstats.patched`),r=`pdf.xlsx.docx.txt.rtf.csv.exe.key.pps.ppt.pptx.7z.pkg.rar.gz.zip.avi.mov.mp4.mpeg.wmv.midi.mp3.wav.wma.dmg.iso.msi`.split(`.`);function i(e){try{return document.cookie.match(RegExp(`(?:^|; )${e}=([\\w-]{8,64})`))?.[1]}catch{return}}function a(){if(typeof document>`u`||typeof navigator>`u`)return null;if(document.querySelector?.(`#claude-agent-stop-container`))return{name:`claude-in-chrome`,via:`dom`};let e=String(navigator.userAgent??``);return/\bClaude\/\d/.test(e)?{name:`claude-browser`,via:`user-agent`}:i(`_al_v`)?{name:`verified-visit`,via:`visit`}:navigator.webdriver===!0||/HeadlessChrome/.test(e)?{name:`automation`,via:`webdriver`}:null}function o(){if(!(typeof history>`u`))for(let e of[`pushState`,`replaceState`]){let r=history[e];if(typeof r!=`function`||r[n])continue;let i=function(...e){let n=r.apply(this,e);return window.dispatchEvent(new Event(t)),n};Object.defineProperty(i,n,{value:!0}),history[e]=i}}function s(e){let n={pageview(){},track(){},stop(){}};if(typeof window>`u`||typeof document>`u`)return n;let i=(...t)=>e.debug&&console.debug(`[agentstats]`,...t),s=/^localhost$|^127(\.\d+){3}$|^\[::1?\]$|\.local$|^$/.test(location.hostname)||location.protocol===`file:`,c=!1;try{c=localStorage.getItem(`agentstats_ignore`)===`true`}catch{}let l=(t,n)=>{if(c)return i(`ignored: agentstats_ignore is set`);if(s&&!e.allowLocalhost)return i(`ignored on localhost:`,t);let r=JSON.stringify({k:e.key,n:t,u:location.href,r:document.referrer||null,w:window.innerWidth,p:n,a:a()?.name,h:e.hashRouting?1:void 0});i(`send`,t,n??``);try{if(navigator.sendBeacon?.(e.endpoint,r))return}catch{}fetch(e.endpoint,{method:`POST`,body:r,keepalive:!0,headers:{"Content-Type":`text/plain`}}).catch(()=>{})},u=new AbortController,d={signal:u.signal},f=``,p=()=>{if(u.signal.aborted)return;let t=location.pathname+(e.hashRouting?location.hash:``);t!==f&&(f=t,l(`pageview`))};(()=>{if(document.visibilityState!==`prerender`)return p();document.addEventListener(`visibilitychange`,function e(){document.visibilityState!==`prerender`&&(document.removeEventListener(`visibilitychange`,e),p())},d)})(),o();let m=()=>setTimeout(p,0);if(window.addEventListener(t,m,d),window.addEventListener(`popstate`,m,d),e.hashRouting&&window.addEventListener(`hashchange`,m,d),e.outboundLinks||e.fileDownloads){let t=Array.isArray(e.fileDownloads)?e.fileDownloads:e.fileDownloads?r:[],n=n=>{if(n.type===`auxclick`&&n.button!==1)return;let r=n.target?.closest?.(`a[href]`);if(!r)return;let i;try{i=new URL(r.href,location.href)}catch{return}let a=i.pathname.split(`.`).pop()?.toLowerCase()??``;t.includes(a)?l(`File Download`,{url:i.href.split(`?`)[0]}):e.outboundLinks&&/^https?:$/.test(i.protocol)&&i.host!==location.host&&l(`Outbound Link: Click`,{url:i.href.split(`?`)[0]})};document.addEventListener(`click`,n,{capture:!0,signal:u.signal}),document.addEventListener(`auxclick`,n,{capture:!0,signal:u.signal})}return{pageview:p,track:(e,t)=>l(String(e),t),stop:()=>u.abort()}}let c=`0.4.0`;function l(){let e=globalThis.crypto;return e?.randomUUID?e.randomUUID():`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`.replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e===`x`?t:t&3|8).toString(16)})}function u(){return Date.now()}function d(){return typeof performance<`u`&&performance.now?performance.now():Date.now()}function f(e){return!!e&&typeof e==`object`&&e.name===`AbortError`}function p(e,t,n=0){if(n>6)return`[depth]`;if(Array.isArray(e))return e.slice(0,100).map(e=>p(e,t,n+1));if(e&&typeof e==`object`){let r={};for(let[i,a]of Object.entries(e)){let e=i.toLowerCase();r[i]=t.some(t=>e.includes(t))?`[redacted]`:p(a,t,n+1)}return r}return typeof e==`string`&&e.length>1e3?e.slice(0,1e3)+`…`:e}function m(e,t){let n;try{n=typeof e==`string`?e:JSON.stringify(e)}catch{n=String(e)}return n===void 0&&(n=``),n.length>t?n.slice(0,t)+`…`:n}function h(e){try{return JSON.stringify(e)?.length??0}catch{return 0}}function g(e){let t={name:String(e.name??``)};return e.title&&(t.title=String(e.title)),e.description&&(t.description=String(e.description)),e.inputSchema!==void 0&&(t.inputSchema=e.inputSchema),e.annotations&&(t.annotations={...e.annotations}),e.origin&&(t.origin=String(e.origin)),t}function _(){if(typeof document<`u`){let e=document.currentScript;if(e?.src)try{return new URL(`/api/ingest`,e.src).toString()}catch{}}return`https://agentstats.io/api/ingest`}let v=/(^|\.)(chatgpt\.com|chat\.openai\.com|perplexity\.ai|claude\.ai|gemini\.google\.com|bard\.google\.com|copilot\.microsoft\.com|copilot\.cloud\.microsoft|copilot\.com|meta\.ai|deepseek\.com|grok\.com|chat\.mistral\.ai|you\.com|phind\.com|poe\.com|duck\.ai|chat\.qwen\.ai|kimi\.com|kimi\.ai|doubao\.com)$/i,y=/[?&]utm_source=(chatgpt(\.com)?|openai|perplexity(\.ai)?|claude(\.ai)?|gemini|copilot(\.com)?|meta\.?ai|deepseek|grok|mistral|le-?chat)(&|$)/i,b=Symbol.for(`agentstats.patched`),x=Symbol.for(`agentstats.wrapped`);var S=class{constructor(e){if(this.queue=[],this.timer=null,this.snapshotTimer=null,this.pollTimer=null,this.sessionId=``,this.lastActivity=0,this.lastSnapshotHash=``,this.inflight=Promise.resolve(),this.web=null,this.agentPage=``,this.controlStarted=0,!e||!e.key)throw Error("[agentstats] `key` is required");if(this.options={endpoint:_(),captureArgs:!0,captureResults:!1,captureErrors:!0,redactKeys:[],sessionTimeoutMs:18e5,flushIntervalMs:2e3,maxBatchSize:25,autoInstrument:!0,trackAgentBrowsers:!0,trackPageviews:!0,debug:!1,disabled:!1,...Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0))},this._fetch=e.fetch??(typeof fetch<`u`?fetch.bind(globalThis):(()=>Promise.reject(Error(`no fetch`)))),this.sessionId=this.loadSession(),!this.options.disabled&&(this.options.autoInstrument&&this.instrument(),this.bindLifecycle(),this.reportReferral(),this.options.trackAgentBrowsers&&this.watchAgentBrowsers(),this.options.trackPageviews)){let e=this.options;this.web=s({key:e.key,endpoint:`${e.endpoint.replace(/\/+$/,``)}/web`,hashRouting:e.hashRouting,outboundLinks:e.outboundLinks,fileDownloads:e.fileDownloads,allowLocalhost:e.allowLocalhost,debug:e.debug})}this.log(`initialised`,{endpoint:this.options.endpoint,session:this.sessionId})}wrap(e){if(!e||typeof e.execute!=`function`||e[x])return e;let t=e.execute,n=String(e.name),r=this,i=async function(e,i){let a=d(),o=i?.signal;try{let s=await t.call(this,e,i);return r.recordCall(n,`success`,d()-a,e,s,void 0,o),s}catch(t){let i=o?.aborted||f(t);throw r.recordCall(n,i?`cancelled`:`error`,d()-a,e,void 0,t,o),t}};Object.defineProperty(i,x,{value:!0});let a=Object.assign({},e,{execute:i});return Object.defineProperty(a,x,{value:!0}),a}track(e,t){let n=t?p(t,this.redactKeys()):void 0;this.enqueue({type:`custom`,id:l(),ts:u(),name:e,props:n,url:this.url()}),this.web?.track(e,n)}pageview(){this.web?.pageview()}async snapshot(){let e=this.modelContext();if(!e?.getTools)return[];let t=[];try{t=(await e.getTools()??[]).map(e=>g(e))}catch(e){return this.log(`getTools failed`,e),[]}let n=m(t.map(e=>[e.name,e.description,e.inputSchema,e.annotations]),1e7);return n!==this.lastSnapshotHash&&(this.lastSnapshotHash=n,this.enqueue({type:`tools_snapshot`,id:l(),ts:u(),tools:t,url:this.url()})),t}flush(e=!1){if(this.timer&&=(clearTimeout(this.timer),null),!this.queue.length)return this.inflight;let t=this.queue.splice(0,this.queue.length),n={key:this.options.key,sdk:`js/${c}`,session_id:this.sessionId,sent_at:u(),metadata:this.options.metadata,visit:typeof document<`u`?i(`_al_v`):void 0,client:this.clientHints(),events:t},r=JSON.stringify(n);if(this.log(`flush`,t.length,`events`),e&&typeof navigator<`u`&&navigator.sendBeacon)try{if(navigator.sendBeacon(this.options.endpoint,new Blob([r],{type:`text/plain`})))return Promise.resolve()}catch{}let a=this._fetch(this.options.endpoint,{method:`POST`,body:r,keepalive:!0,headers:{"Content-Type":`text/plain`}}).then(async e=>{e.ok||this.log(`ingest responded`,e.status)}).catch(e=>{this.log(`ingest failed`,e)});return this.inflight=a,a}destroy(){this.timer&&clearTimeout(this.timer),this.snapshotTimer&&clearTimeout(this.snapshotTimer),this.pollTimer&&clearInterval(this.pollTimer),this.timer=this.snapshotTimer=this.pollTimer=null,this.web?.stop(),this.web=null}get session(){return this.sessionId}log(...e){this.options.debug&&console.debug(`[agentstats]`,...e)}url(){return typeof location<`u`?location.href:void 0}redactKeys(){return(this.options.redactKeys??[]).map(e=>e.toLowerCase()).filter(Boolean)}modelContext(){let e=globalThis;return e.document?.modelContext??e.navigator?.modelContext}captureArgs(e,t){let n=this.options.captureArgs;if(n===!1)return;let r=typeof n==`function`?this.callOption(`captureArgs`,()=>n(e,t)):p(t,this.redactKeys());return r!==void 0&&h(r)>8192&&(r={_truncated:!0,preview:m(r,1e3)}),r}captureResult(e,t){let n=this.options.captureResults;if(!n||t===void 0)return;let r=typeof n==`function`?this.callOption(`captureResults`,()=>n(e,t)):t;return r===void 0?void 0:m(r,2048)}captureError(e,t){let n=this.options.captureErrors;if(n===!1)return;let r=t,i=typeof r?.message==`string`?r.message:m(t,1e3);if(typeof n!=`function`)return m(i,1e3);let a=typeof r?.code==`string`||typeof r?.code==`number`?r.code:null,o=this.callOption(`captureErrors`,()=>n({tool:e,message:i,name:typeof r?.name==`string`?r.name:null,code:a,error:t}));return typeof o==`string`&&o?m(o,1e3):void 0}callOption(e,t){try{return t()}catch(t){this.log(`${e} threw`,t);return}}recordCall(e,t,n,r,i,a,o){let s={type:`tool_call`,id:l(),ts:u(),tool:e,status:t,duration_ms:Math.round(n*100)/100,url:this.url()},c=this.captureArgs(e,r);c!==void 0&&(s.args=c);let d=this.captureResult(e,i);if(d!==void 0&&(s.result=d),a!==void 0){let t=this.captureError(e,a);t!==void 0&&(s.error=t);let n=a?.name;n&&(s.error_name=String(n).slice(0,100))}this.enqueue(s)}enqueue(e){this.options.disabled||(this.touchSession(),this.queue.push(e),this.log(`event`,e.type,e.tool??e.name??``),this.queue.length>=this.options.maxBatchSize?this.flush():this.timer||=setTimeout(()=>void this.flush(),this.options.flushIntervalMs))}scheduleSnapshot(e=250){this.snapshotTimer&&clearTimeout(this.snapshotTimer),this.snapshotTimer=setTimeout(()=>{this.snapshotTimer=null,this.snapshot()},e)}instrument(){let e=()=>{let e=this.modelContext();return e?(this.patch(e),!0):!1};if(e())return;let t=0;this.pollTimer=setInterval(()=>{t++,(e()||t>40)&&(this.pollTimer&&clearInterval(this.pollTimer),this.pollTimer=null)},250)}patch(e){if(e[b]){this.log(`modelContext already patched`),this.scheduleSnapshot(0);return}Object.defineProperty(e,b,{value:!0});let t=this;if(typeof e.registerTool==`function`){let n=e.registerTool;e.registerTool=function(e,r){let i=t.wrap(e);return t.enqueue({type:`tool_registered`,id:l(),ts:u(),tool:String(e?.name),descriptor:g(e),url:t.url()}),t.scheduleSnapshot(),n.call(this,i,r)}}if(typeof e.provideContext==`function`){let n=e.provideContext;e.provideContext=function(e){let r=(e?.tools??[]).map(e=>(t.enqueue({type:`tool_registered`,id:l(),ts:u(),tool:String(e?.name),descriptor:g(e),url:t.url()}),t.wrap(e)));return t.scheduleSnapshot(),n.call(this,{...e,tools:r})}}if(typeof e.unregisterTool==`function`){let n=e.unregisterTool;e.unregisterTool=function(e){return t.enqueue({type:`tool_unregistered`,id:l(),ts:u(),tool:String(e),url:t.url()}),t.scheduleSnapshot(),n.call(this,e)}}if(typeof e.clearContext==`function`){let n=e.clearContext;e.clearContext=function(){return t.scheduleSnapshot(),n.call(this)}}if(typeof e.addEventListener==`function`)try{e.addEventListener(`toolchange`,()=>t.scheduleSnapshot())}catch{}this.log(`modelContext patched`),this.scheduleSnapshot(0)}bindLifecycle(){if(typeof window>`u`||typeof window.addEventListener!=`function`)return;let e=()=>void this.flush(!0);window.addEventListener(`pagehide`,e),document.addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&e()})}clientHints(){if(typeof navigator>`u`)return;let e=String(navigator.userAgent??``).slice(0,1e3),t=navigator.webdriver===!0;return e||t?{ua:e||void 0,webdriver:t||void 0}:void 0}detectAgentBrowser(){return a()}watchAgentBrowsers(){if(typeof document>`u`||typeof window>`u`)return;let e=()=>{let e=this.detectAgentBrowser(),t=this.url();e&&t!==this.agentPage&&(this.agentPage=t??``,this.enqueue({type:`agent_pageview`,id:l(),ts:u(),name:e.name,props:{via:e.via},url:t}))},n=()=>{e(),!(typeof MutationObserver>`u`||!document.body)&&new MutationObserver(()=>{let t=!!document.querySelector(`#claude-agent-stop-container`);if(t&&!this.controlStarted)this.controlStarted=d(),this.enqueue({type:`agent_control`,id:l(),ts:u(),name:`claude-in-chrome`,props:{via:`dom`,phase:`start`},url:this.url()}),e();else if(!t&&this.controlStarted){let e=Math.round(d()-this.controlStarted);this.controlStarted=0,this.enqueue({type:`agent_control`,id:l(),ts:u(),name:`claude-in-chrome`,props:{via:`dom`,phase:`stop`,duration_ms:e},url:this.url()})}}).observe(document.body,{childList:!0})};document.readyState===`loading`?document.addEventListener(`DOMContentLoaded`,n,{once:!0}):n();let r=()=>setTimeout(e,0);window.addEventListener(`popstate`,r),window.addEventListener(t,r),o()}reportReferral(){if(typeof document>`u`||typeof location>`u`)return;let e=``;try{e=document.referrer?new URL(document.referrer).hostname.replace(/^www\./,``):``}catch{}if(!(e&&v.test(e))&&!y.test(location.search))return;let t=`__agentstats_ref_${this.sessionId}`;try{if(sessionStorage.getItem(t))return;sessionStorage.setItem(t,`1`)}catch{}this.enqueue({type:`referral`,id:l(),ts:u(),url:this.url()??location.href,referrer:e?`https://${e}/`:null})}loadSession(){try{let e=sessionStorage.getItem(`__agentstats_session`);if(e){let t=JSON.parse(e);if(t?.id&&u()-t.last<this.options.sessionTimeoutMs)return this.lastActivity=t.last,t.id}}catch{}return l()}touchSession(){let e=u();this.lastActivity&&e-this.lastActivity>this.options.sessionTimeoutMs&&(this.sessionId=l(),this.lastSnapshotHash=``,this.log(`new session`,this.sessionId)),this.lastActivity=e;try{sessionStorage.setItem(`__agentstats_session`,JSON.stringify({id:this.sessionId,last:e}))}catch{}}};let C=null;function w(e){return C&&C.destroy(),C=new S(e),C}function T(){return C}function E(e,t){C?.track(e,t)}function D(e){return C?C.wrap(e):e}function O(){return C?.flush()??Promise.resolve()}function k(){return C?.snapshot()??Promise.resolve([])}function A(){C?.pageview()}let j={init:w,track:E,pageview:A,wrap:D,flush:O,snapshot:k,getClient:T,version:c};window.AgentStats=j;let M=document.currentScript,N=M?.dataset.key,P=e=>e!==void 0&&e!==`false`,F=M?.dataset.fileDownloads;return N&&j.init({key:N,endpoint:M?.dataset.endpoint,debug:M?.dataset.debug===`true`,captureArgs:M?.dataset.captureArgs!==`false`,captureErrors:M?.dataset.captureErrors!==`false`,captureResults:M?.dataset.captureResults===`true`,redactKeys:M?.dataset.redactKeys?.split(`,`).map(e=>e.trim()).filter(Boolean),trackPageviews:M?.dataset.pageviews!==`false`,hashRouting:P(M?.dataset.hashRouting),outboundLinks:P(M?.dataset.outboundLinks),fileDownloads:F&&![``,`true`,`false`].includes(F)?F.split(`,`).map(e=>e.trim()):P(F),allowLocalhost:P(M?.dataset.allowLocalhost)}),e.AgentStats=j,e})({});
+var AgentStatsSDK=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});let t=[10,40,100,250],n=[1,2,6,21],r=(e,t)=>{let n=0;for(;n<t.length&&e>=t[n];)n++;return n},i=e=>!!e&&(e.isContentEditable||e.tagName===`TEXTAREA`||e.tagName===`INPUT`&&/^(text|search|email|url|tel|password|number|)$/.test(e.type)),a=e=>!!e&&(e.isContentEditable||/^(INPUT|TEXTAREA|SELECT)$/.test(e.tagName)),o=e=>{try{return e.matches(`:autofill`)}catch{return!1}};function s(){let e={take:()=>null,stop(){}};if(typeof document>`u`||typeof performance>`u`)return e;let s=()=>performance.now(),c=()=>document.visibilityState===`hidden`||!document.hasFocus(),l=[],u=0,d=0,f=-1e9,p=-1e9,m=-1e9,h=-1e9,g=new Map,_=()=>{l=Array.from({length:29},()=>0),l[0]=1,u=s(),d=0};_();let v=e=>{l[2]||(l[2]=Math.max(1,Math.round(e-u)))},y=new AbortController,b=(e,t)=>document.addEventListener(e,t,{capture:!0,passive:!0,signal:y.signal});b(`pointermove`,e=>{e.isTrusted&&(l[3]++,d++)}),b(`pointerdown`,e=>{e.isTrusted&&(m=s(),v(m))}),b(`click`,e=>{if(!e.isTrusted)return void l[26]++;v(s()),c()&&l[27]++,e.detail===0?l[10]++:e.pointerType===`touch`||e.pointerType===`pen`?l[9]++:e.detail===1&&l[4+r(d,n)]++,d=0}),b(`keydown`,e=>{if(!e.isTrusted)return void l[26]++;let n=s();v(n),m=p=n,c()&&l[27]++,!(e.repeat||e.target?.type===`password`)&&(n-f<2e3&&l[16+r(n-f,t)]++,f=n,g.set(e.code||e.key,n))}),b(`keyup`,e=>{let n=g.get(e.code||e.key);e.isTrusted&&n!==void 0&&(g.delete(e.code||e.key),l[11+r(s()-n,t)]++)});for(let e of[`paste`,`drop`,`compositionend`])b(e,()=>{p=s()});for(let e of[`wheel`,`touchstart`])b(e,()=>{m=s()});return b(`change`,e=>{!e.isTrusted&&a(e.target)&&l[28]++}),b(`input`,e=>{if(!e.isTrusted)return void(a(e.target)&&l[28]++);if(!i(e.target)||o(e.target))return;let t=s();v(t),c()&&l[27]++;let n=t-p;l[n<100?21:n<1e3?22:23]++}),b(`scroll`,()=>{let e=s();e-h>150&&(l[24]++,e-m>500&&l[25]++),h=e}),{take(){let e=l.slice(3).some(Boolean)?l:null;return e&&(e[1]=Math.min(2**31,Math.round(s()-u))),_(),e},stop:()=>y.abort()}}let c=`agentstats:locationchange`,l=Symbol.for(`agentstats.patched`),u=`pdf.xlsx.docx.txt.rtf.csv.exe.key.pps.ppt.pptx.7z.pkg.rar.gz.zip.avi.mov.mp4.mpeg.wmv.midi.mp3.wav.wma.dmg.iso.msi`.split(`.`);function d(e){try{return document.cookie.match(RegExp(`(?:^|; )${e}=([\\w-]{8,64})`))?.[1]}catch{return}}function f(){if(typeof document>`u`||typeof navigator>`u`)return null;if(document.querySelector?.(`#claude-agent-stop-container`))return{name:`claude-in-chrome`,via:`dom`};let e=String(navigator.userAgent??``);return/\bClaude\/\d/.test(e)?{name:`claude-browser`,via:`user-agent`}:d(`_al_v`)?{name:`verified-visit`,via:`visit`}:navigator.webdriver===!0||/HeadlessChrome/.test(e)?{name:`automation`,via:`webdriver`}:null}function p(){if(!(typeof history>`u`))for(let e of[`pushState`,`replaceState`]){let t=history[e];if(typeof t!=`function`||t[l])continue;let n=function(...e){let n=t.apply(this,e);return window.dispatchEvent(new Event(c)),n};Object.defineProperty(n,l,{value:!0}),history[e]=n}}function m(e){let t={pageview(){},track(){},stop(){}};if(typeof window>`u`||typeof document>`u`)return t;let n=(...t)=>e.debug&&console.debug(`[agentstats]`,...t),r=/^localhost$|^127(\.\d+){3}$|^\[::1?\]$|\.local$|^$/.test(location.hostname)||location.protocol===`file:`,i=!1;try{i=localStorage.getItem(`agentstats_ignore`)===`true`}catch{}let a=(t,a)=>{if(i)return n(`ignored: agentstats_ignore is set`);if(r&&!e.allowLocalhost)return n(`ignored on localhost:`,t);let o=JSON.stringify({k:e.key,...a,a:f()?.name});n(`send`,t);try{if(navigator.sendBeacon?.(e.endpoint,o))return}catch{}fetch(e.endpoint,{method:`POST`,body:o,keepalive:!0,headers:{"Content-Type":`text/plain`}}).catch(()=>{})},o=(t,n)=>a(t,{n:t,u:location.href,r:document.referrer||null,w:window.innerWidth,p:n,h:e.hashRouting?1:void 0}),l=e.agentSignals===!1?null:s(),d=location.href,m=()=>{let e=l?.take();e&&a(`signals`,{t:`s`,u:d,s:e})},h=new AbortController,g={signal:h.signal},_=``,v=()=>{if(h.signal.aborted)return;let t=location.pathname+(e.hashRouting?location.hash:``);t!==_&&(_&&m(),_=t,d=location.href,o(`pageview`))};(()=>{if(document.visibilityState!==`prerender`)return v();document.addEventListener(`visibilitychange`,function e(){document.visibilityState!==`prerender`&&(document.removeEventListener(`visibilitychange`,e),v())},g)})(),p();let y=()=>setTimeout(v,0);if(window.addEventListener(c,y,g),window.addEventListener(`popstate`,y,g),e.hashRouting&&window.addEventListener(`hashchange`,y,g),e.outboundLinks||e.fileDownloads){let t=Array.isArray(e.fileDownloads)?e.fileDownloads:e.fileDownloads?u:[],n=n=>{if(n.type===`auxclick`&&n.button!==1)return;let r=n.target?.closest?.(`a[href]`);if(!r)return;let i;try{i=new URL(r.href,location.href)}catch{return}let a=i.pathname.split(`.`).pop()?.toLowerCase()??``;t.includes(a)?o(`File Download`,{url:i.href.split(`?`)[0]}):e.outboundLinks&&/^https?:$/.test(i.protocol)&&i.host!==location.host&&o(`Outbound Link: Click`,{url:i.href.split(`?`)[0]})};document.addEventListener(`click`,n,{capture:!0,signal:h.signal}),document.addEventListener(`auxclick`,n,{capture:!0,signal:h.signal})}return l&&(window.addEventListener(`pagehide`,m,g),document.addEventListener(`visibilitychange`,()=>document.visibilityState===`hidden`&&m(),g)),{pageview:v,track:(e,t)=>o(String(e),t),stop:()=>{h.signal.aborted||(m(),l?.stop(),h.abort())}}}let h=`0.5.0`;function g(){let e=globalThis.crypto;return e?.randomUUID?e.randomUUID():`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`.replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e===`x`?t:t&3|8).toString(16)})}function _(){return Date.now()}function v(){return typeof performance<`u`&&performance.now?performance.now():Date.now()}function y(e){return!!e&&typeof e==`object`&&e.name===`AbortError`}function b(e,t,n=0){if(n>6)return`[depth]`;if(Array.isArray(e))return e.slice(0,100).map(e=>b(e,t,n+1));if(e&&typeof e==`object`){let r={};for(let[i,a]of Object.entries(e)){let e=i.toLowerCase();r[i]=t.some(t=>e.includes(t))?`[redacted]`:b(a,t,n+1)}return r}return typeof e==`string`&&e.length>1e3?e.slice(0,1e3)+`…`:e}function x(e,t){let n;try{n=typeof e==`string`?e:JSON.stringify(e)}catch{n=String(e)}return n===void 0&&(n=``),n.length>t?n.slice(0,t)+`…`:n}function S(e){try{return JSON.stringify(e)?.length??0}catch{return 0}}function C(e){let t={name:String(e.name??``)};return e.title&&(t.title=String(e.title)),e.description&&(t.description=String(e.description)),e.inputSchema!==void 0&&(t.inputSchema=e.inputSchema),e.annotations&&(t.annotations={...e.annotations}),e.origin&&(t.origin=String(e.origin)),t}function w(){if(typeof document<`u`){let e=document.currentScript;if(e?.src)try{return new URL(`/api/ingest`,e.src).toString()}catch{}}return`https://agentstats.io/api/ingest`}let T=/(^|\.)(chatgpt\.com|chat\.openai\.com|perplexity\.ai|claude\.ai|gemini\.google\.com|bard\.google\.com|copilot\.microsoft\.com|copilot\.cloud\.microsoft|copilot\.com|meta\.ai|deepseek\.com|grok\.com|chat\.mistral\.ai|you\.com|phind\.com|poe\.com|duck\.ai|chat\.qwen\.ai|kimi\.com|kimi\.ai|doubao\.com)$/i,E=/[?&]utm_source=(chatgpt(\.com)?|openai|perplexity(\.ai)?|claude(\.ai)?|gemini|copilot(\.com)?|meta\.?ai|deepseek|grok|mistral|le-?chat)(&|$)/i,D=Symbol.for(`agentstats.patched`),O=Symbol.for(`agentstats.wrapped`);var k=class{constructor(e){if(this.queue=[],this.timer=null,this.snapshotTimer=null,this.pollTimer=null,this.sessionId=``,this.lastActivity=0,this.lastSnapshotHash=``,this.inflight=Promise.resolve(),this.web=null,this.agentPage=``,this.controlStarted=0,!e||!e.key)throw Error("[agentstats] `key` is required");if(this.options={endpoint:w(),captureArgs:!0,captureResults:!1,captureErrors:!0,redactKeys:[],sessionTimeoutMs:18e5,flushIntervalMs:2e3,maxBatchSize:25,autoInstrument:!0,trackAgentBrowsers:!0,trackPageviews:!0,debug:!1,disabled:!1,...Object.fromEntries(Object.entries(e).filter(([,e])=>e!==void 0))},this._fetch=e.fetch??(typeof fetch<`u`?fetch.bind(globalThis):(()=>Promise.reject(Error(`no fetch`)))),this.sessionId=this.loadSession(),!this.options.disabled&&(this.options.autoInstrument&&this.instrument(),this.bindLifecycle(),this.reportReferral(),this.options.trackAgentBrowsers&&this.watchAgentBrowsers(),this.options.trackPageviews)){let e=this.options;this.web=m({key:e.key,endpoint:`${e.endpoint.replace(/\/+$/,``)}/web`,hashRouting:e.hashRouting,outboundLinks:e.outboundLinks,fileDownloads:e.fileDownloads,allowLocalhost:e.allowLocalhost,agentSignals:e.agentSignals,debug:e.debug})}this.log(`initialised`,{endpoint:this.options.endpoint,session:this.sessionId})}wrap(e){if(!e||typeof e.execute!=`function`||e[O])return e;let t=e.execute,n=String(e.name),r=this,i=async function(e,i){let a=v(),o=i?.signal;try{let s=await t.call(this,e,i);return r.recordCall(n,`success`,v()-a,e,s,void 0,o),s}catch(t){let i=o?.aborted||y(t);throw r.recordCall(n,i?`cancelled`:`error`,v()-a,e,void 0,t,o),t}};Object.defineProperty(i,O,{value:!0});let a=Object.assign({},e,{execute:i});return Object.defineProperty(a,O,{value:!0}),a}track(e,t){let n=t?b(t,this.redactKeys()):void 0;this.enqueue({type:`custom`,id:g(),ts:_(),name:e,props:n,url:this.url()}),this.web?.track(e,n)}pageview(){this.web?.pageview()}async snapshot(){let e=this.modelContext();if(!e?.getTools)return[];let t=[];try{t=(await e.getTools()??[]).map(e=>C(e))}catch(e){return this.log(`getTools failed`,e),[]}let n=x(t.map(e=>[e.name,e.description,e.inputSchema,e.annotations]),1e7);return n!==this.lastSnapshotHash&&(this.lastSnapshotHash=n,this.enqueue({type:`tools_snapshot`,id:g(),ts:_(),tools:t,url:this.url()})),t}flush(e=!1){if(this.timer&&=(clearTimeout(this.timer),null),!this.queue.length)return this.inflight;let t=this.queue.splice(0,this.queue.length),n={key:this.options.key,sdk:`js/${h}`,session_id:this.sessionId,sent_at:_(),metadata:this.options.metadata,visit:typeof document<`u`?d(`_al_v`):void 0,client:this.clientHints(),events:t},r=JSON.stringify(n);if(this.log(`flush`,t.length,`events`),e&&typeof navigator<`u`&&navigator.sendBeacon)try{if(navigator.sendBeacon(this.options.endpoint,new Blob([r],{type:`text/plain`})))return Promise.resolve()}catch{}let i=this._fetch(this.options.endpoint,{method:`POST`,body:r,keepalive:!0,headers:{"Content-Type":`text/plain`}}).then(async e=>{e.ok||this.log(`ingest responded`,e.status)}).catch(e=>{this.log(`ingest failed`,e)});return this.inflight=i,i}destroy(){this.timer&&clearTimeout(this.timer),this.snapshotTimer&&clearTimeout(this.snapshotTimer),this.pollTimer&&clearInterval(this.pollTimer),this.timer=this.snapshotTimer=this.pollTimer=null,this.web?.stop(),this.web=null}get session(){return this.sessionId}log(...e){this.options.debug&&console.debug(`[agentstats]`,...e)}url(){return typeof location<`u`?location.href:void 0}redactKeys(){return(this.options.redactKeys??[]).map(e=>e.toLowerCase()).filter(Boolean)}modelContext(){let e=globalThis;return e.document?.modelContext??e.navigator?.modelContext}captureArgs(e,t){let n=this.options.captureArgs;if(n===!1)return;let r=typeof n==`function`?this.callOption(`captureArgs`,()=>n(e,t)):b(t,this.redactKeys());return r!==void 0&&S(r)>8192&&(r={_truncated:!0,preview:x(r,1e3)}),r}captureResult(e,t){let n=this.options.captureResults;if(!n||t===void 0)return;let r=typeof n==`function`?this.callOption(`captureResults`,()=>n(e,t)):t;return r===void 0?void 0:x(r,2048)}captureError(e,t){let n=this.options.captureErrors;if(n===!1)return;let r=t,i=typeof r?.message==`string`?r.message:x(t,1e3);if(typeof n!=`function`)return x(i,1e3);let a=typeof r?.code==`string`||typeof r?.code==`number`?r.code:null,o=this.callOption(`captureErrors`,()=>n({tool:e,message:i,name:typeof r?.name==`string`?r.name:null,code:a,error:t}));return typeof o==`string`&&o?x(o,1e3):void 0}callOption(e,t){try{return t()}catch(t){this.log(`${e} threw`,t);return}}recordCall(e,t,n,r,i,a,o){let s={type:`tool_call`,id:g(),ts:_(),tool:e,status:t,duration_ms:Math.round(n*100)/100,url:this.url()},c=this.captureArgs(e,r);c!==void 0&&(s.args=c);let l=this.captureResult(e,i);if(l!==void 0&&(s.result=l),a!==void 0){let t=this.captureError(e,a);t!==void 0&&(s.error=t);let n=a?.name;n&&(s.error_name=String(n).slice(0,100))}this.enqueue(s)}enqueue(e){this.options.disabled||(this.touchSession(),this.queue.push(e),this.log(`event`,e.type,e.tool??e.name??``),this.queue.length>=this.options.maxBatchSize?this.flush():this.timer||=setTimeout(()=>void this.flush(),this.options.flushIntervalMs))}scheduleSnapshot(e=250){this.snapshotTimer&&clearTimeout(this.snapshotTimer),this.snapshotTimer=setTimeout(()=>{this.snapshotTimer=null,this.snapshot()},e)}instrument(){let e=()=>{let e=this.modelContext();return e?(this.patch(e),!0):!1};if(e())return;let t=0;this.pollTimer=setInterval(()=>{t++,(e()||t>40)&&(this.pollTimer&&clearInterval(this.pollTimer),this.pollTimer=null)},250)}patch(e){if(e[D]){this.log(`modelContext already patched`),this.scheduleSnapshot(0);return}Object.defineProperty(e,D,{value:!0});let t=this;if(typeof e.registerTool==`function`){let n=e.registerTool;e.registerTool=function(e,r){let i=t.wrap(e);return t.enqueue({type:`tool_registered`,id:g(),ts:_(),tool:String(e?.name),descriptor:C(e),url:t.url()}),t.scheduleSnapshot(),n.call(this,i,r)}}if(typeof e.provideContext==`function`){let n=e.provideContext;e.provideContext=function(e){let r=(e?.tools??[]).map(e=>(t.enqueue({type:`tool_registered`,id:g(),ts:_(),tool:String(e?.name),descriptor:C(e),url:t.url()}),t.wrap(e)));return t.scheduleSnapshot(),n.call(this,{...e,tools:r})}}if(typeof e.unregisterTool==`function`){let n=e.unregisterTool;e.unregisterTool=function(e){return t.enqueue({type:`tool_unregistered`,id:g(),ts:_(),tool:String(e),url:t.url()}),t.scheduleSnapshot(),n.call(this,e)}}if(typeof e.clearContext==`function`){let n=e.clearContext;e.clearContext=function(){return t.scheduleSnapshot(),n.call(this)}}if(typeof e.addEventListener==`function`)try{e.addEventListener(`toolchange`,()=>t.scheduleSnapshot())}catch{}this.log(`modelContext patched`),this.scheduleSnapshot(0)}bindLifecycle(){if(typeof window>`u`||typeof window.addEventListener!=`function`)return;let e=()=>void this.flush(!0);window.addEventListener(`pagehide`,e),document.addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&e()})}clientHints(){if(typeof navigator>`u`)return;let e=String(navigator.userAgent??``).slice(0,1e3),t=navigator.webdriver===!0;return e||t?{ua:e||void 0,webdriver:t||void 0}:void 0}detectAgentBrowser(){return f()}watchAgentBrowsers(){if(typeof document>`u`||typeof window>`u`)return;let e=()=>{let e=this.detectAgentBrowser(),t=this.url();e&&t!==this.agentPage&&(this.agentPage=t??``,this.enqueue({type:`agent_pageview`,id:g(),ts:_(),name:e.name,props:{via:e.via},url:t}))},t=()=>{e(),!(typeof MutationObserver>`u`||!document.body)&&new MutationObserver(()=>{let t=!!document.querySelector(`#claude-agent-stop-container`);if(t&&!this.controlStarted)this.controlStarted=v(),this.enqueue({type:`agent_control`,id:g(),ts:_(),name:`claude-in-chrome`,props:{via:`dom`,phase:`start`},url:this.url()}),e();else if(!t&&this.controlStarted){let e=Math.round(v()-this.controlStarted);this.controlStarted=0,this.enqueue({type:`agent_control`,id:g(),ts:_(),name:`claude-in-chrome`,props:{via:`dom`,phase:`stop`,duration_ms:e},url:this.url()})}}).observe(document.body,{childList:!0})};document.readyState===`loading`?document.addEventListener(`DOMContentLoaded`,t,{once:!0}):t();let n=()=>setTimeout(e,0);window.addEventListener(`popstate`,n),window.addEventListener(c,n),p()}reportReferral(){if(typeof document>`u`||typeof location>`u`)return;let e=``;try{e=document.referrer?new URL(document.referrer).hostname.replace(/^www\./,``):``}catch{}if(!(e&&T.test(e))&&!E.test(location.search))return;let t=`__agentstats_ref_${this.sessionId}`;try{if(sessionStorage.getItem(t))return;sessionStorage.setItem(t,`1`)}catch{}this.enqueue({type:`referral`,id:g(),ts:_(),url:this.url()??location.href,referrer:e?`https://${e}/`:null})}loadSession(){try{let e=sessionStorage.getItem(`__agentstats_session`);if(e){let t=JSON.parse(e);if(t?.id&&_()-t.last<this.options.sessionTimeoutMs)return this.lastActivity=t.last,t.id}}catch{}return g()}touchSession(){let e=_();this.lastActivity&&e-this.lastActivity>this.options.sessionTimeoutMs&&(this.sessionId=g(),this.lastSnapshotHash=``,this.log(`new session`,this.sessionId)),this.lastActivity=e;try{sessionStorage.setItem(`__agentstats_session`,JSON.stringify({id:this.sessionId,last:e}))}catch{}}};let A=null;function j(e){return A&&A.destroy(),A=new k(e),A}function M(){return A}function N(e,t){A?.track(e,t)}function P(e){return A?A.wrap(e):e}function F(){return A?.flush()??Promise.resolve()}function I(){return A?.snapshot()??Promise.resolve([])}function L(){A?.pageview()}let R={init:j,track:N,pageview:L,wrap:P,flush:F,snapshot:I,getClient:M,version:h};window.AgentStats=R;let z=document.currentScript,B=z?.dataset.key,V=e=>e!==void 0&&e!==`false`,H=z?.dataset.fileDownloads;return B&&R.init({key:B,endpoint:z?.dataset.endpoint,debug:z?.dataset.debug===`true`,captureArgs:z?.dataset.captureArgs!==`false`,captureErrors:z?.dataset.captureErrors!==`false`,captureResults:z?.dataset.captureResults===`true`,redactKeys:z?.dataset.redactKeys?.split(`,`).map(e=>e.trim()).filter(Boolean),trackPageviews:z?.dataset.pageviews!==`false`,hashRouting:V(z?.dataset.hashRouting),outboundLinks:V(z?.dataset.outboundLinks),fileDownloads:H&&![``,`true`,`false`].includes(H)?H.split(`,`).map(e=>e.trim()):V(H),allowLocalhost:V(z?.dataset.allowLocalhost),agentSignals:z?.dataset.agentSignals!==`false`}),e.AgentStats=R,e})({});

package/dist/index.cjs

@@ -2,7 +2,151 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
+const SIZE = 29;
+const TIMES = [
+	10,
+	40,
+	100,
+	250
+];
+const MOVES = [
+	1,
+	2,
+	6,
+	21
+];
+const bucket = (x, bounds) => {
+	let i = 0;
+	while (i < bounds.length && x >= bounds[i]) i++;
+	return i;
+};
+const textEntry = (t) => !!t && (t.isContentEditable || t.tagName === "TEXTAREA" || t.tagName === "INPUT" && /^(text|search|email|url|tel|password|number|)$/.test(t.type));
+const formField = (t) => !!t && (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName));
+const autofilled = (t) => {
+	try {
+		return t.matches(":autofill");
+	} catch {
+		return false;
+	}
+};
+function watchSignals() {
+	const noop = {
+		take: () => null,
+		stop() {}
+	};
+	if (typeof document === "undefined" || typeof performance === "undefined") return noop;
+	const now = () => performance.now();
+	const away = () => document.visibilityState === "hidden" || !document.hasFocus();
+	let v = [];
+	let start = 0;
+	let moves = 0;
+	let lastKey = -1e9;
+	let editCause = -1e9;
+	let intent = -1e9;
+	let lastScroll = -1e9;
+	const holds = /* @__PURE__ */ new Map();
+	const reset = () => {
+		v = Array.from({ length: SIZE }, () => 0);
+		v[0] = 1;
+		start = now();
+		moves = 0;
+	};
+	reset();
+	const acted = (t) => {
+		if (!v[2]) v[2] = Math.max(1, Math.round(t - start));
+	};
+	const ctl = new AbortController();
+	const on = (type, f) => document.addEventListener(type, f, {
+		capture: true,
+		passive: true,
+		signal: ctl.signal
+	});
+	on("pointermove", (e) => {
+		if (!e.isTrusted) return;
+		v[3]++;
+		moves++;
+	});
+	on("pointerdown", (e) => {
+		if (!e.isTrusted) return;
+		intent = now();
+		acted(intent);
+	});
+	on("click", (e) => {
+		if (!e.isTrusted) return void v[26]++;
+		acted(now());
+		if (away()) v[27]++;
+		if (e.detail === 0) v[10]++;
+		else if (e.pointerType === "touch" || e.pointerType === "pen") v[9]++;
+		else if (e.detail === 1) v[4 + bucket(moves, MOVES)]++;
+		moves = 0;
+	});
+	on("keydown", (e) => {
+		if (!e.isTrusted) return void v[26]++;
+		const t = now();
+		acted(t);
+		intent = editCause = t;
+		if (away()) v[27]++;
+		if (e.repeat || e.target?.type === "password") return;
+		if (t - lastKey < 2e3) v[16 + bucket(t - lastKey, TIMES)]++;
+		lastKey = t;
+		holds.set(e.code || e.key, t);
+	});
+	on("keyup", (e) => {
+		const down = holds.get(e.code || e.key);
+		if (!e.isTrusted || down === void 0) return;
+		holds.delete(e.code || e.key);
+		v[11 + bucket(now() - down, TIMES)]++;
+	});
+	for (const type of [
+		"paste",
+		"drop",
+		"compositionend"
+	]) on(type, () => {
+		editCause = now();
+	});
+	for (const type of ["wheel", "touchstart"]) on(type, () => {
+		intent = now();
+	});
+	on("change", (e) => {
+		if (!e.isTrusted && formField(e.target)) v[28]++;
+	});
+	on("input", (e) => {
+		if (!e.isTrusted) return void (formField(e.target) && v[28]++);
+		if (!textEntry(e.target) || autofilled(e.target)) return;
+		const t = now();
+		acted(t);
+		if (away()) v[27]++;
+		const since = t - editCause;
+		v[since < 100 ? 21 : since < 1e3 ? 22 : 23]++;
+	});
+	on("scroll", () => {
+		const t = now();
+		if (t - lastScroll > 150) {
+			v[24]++;
+			if (t - intent > 500) v[25]++;
+		}
+		lastScroll = t;
+	});
+	return {
+		take() {
+			const out = v.slice(3).some(Boolean) ? v : null;
+			if (out) out[1] = Math.min(2 ** 31, Math.round(now() - start));
+			reset();
+			return out;
+		},
+		stop: () => ctl.abort()
+	};
+}
+//#endregion
 //#region src/web.ts
+/**
+* Visitors: privacy-friendly web analytics for people. One small request per pageview or custom
+* event, no cookies, nothing stored in the browser. The server counts unique visitors from a
+* daily-salted hash of the IP and user agent, the way Plausible does, and keeps neither.
+*
+* Used by the full SDK (on by default, `trackPageviews: false` turns it off) and on its own by
+* the lite script (`/sdk/lite.js`) for sites without WebMCP tools.
+*/
 const VISIT_COOKIE = "_al_v";
 /** What Claude in Chrome puts on the page while it's in control (its stop button). */
 const AGENT_CONTROL_MARKER = "#claude-agent-stop-container";
@@ -96,20 +240,15 @@ function webAnalytics(o) {
 	try {
 		ignored = localStorage.getItem("agentstats_ignore") === "true";
 	} catch {}
-	const send = (name, props) => {
+	const post = (what, data) => {
 		if (ignored) return log("ignored: agentstats_ignore is set");
-		if (local && !o.allowLocalhost) return log("ignored on localhost:", name);
+		if (local && !o.allowLocalhost) return log("ignored on localhost:", what);
 		const body = JSON.stringify({
 			k: o.key,
-			n: name,
-			u: location.href,
-			r: document.referrer || null,
-			w: window.innerWidth,
-			p: props,
-			a: agentInBrowser()?.name,
-			h: o.hashRouting ? 1 : void 0
+			...data,
+			a: agentInBrowser()?.name
 		});
-		log("send", name, props ?? "");
+		log("send", what);
 		try {
 			if (navigator.sendBeacon?.(o.endpoint, body)) return;
 		} catch {}
@@ -120,6 +259,24 @@ function webAnalytics(o) {
 			headers: { "Content-Type": "text/plain" }
 		}).catch(() => {});
 	};
+	const send = (name, props) => post(name, {
+		n: name,
+		u: location.href,
+		r: document.referrer || null,
+		w: window.innerWidth,
+		p: props,
+		h: o.hashRouting ? 1 : void 0
+	});
+	const signals = o.agentSignals === false ? null : watchSignals();
+	let signalsUrl = location.href;
+	const sendSignals = () => {
+		const s = signals?.take();
+		if (s) post("signals", {
+			t: "s",
+			u: signalsUrl,
+			s
+		});
+	};
 	const ctl = new AbortController();
 	const on = { signal: ctl.signal };
 	let last = "";
@@ -127,7 +284,9 @@ function webAnalytics(o) {
 		if (ctl.signal.aborted) return;
 		const page = location.pathname + (o.hashRouting ? location.hash : "");
 		if (page === last) return;
+		if (last) sendSignals();
 		last = page;
+		signalsUrl = location.href;
 		send("pageview");
 	};
 	const start = () => {
@@ -169,10 +328,19 @@ function webAnalytics(o) {
 			signal: ctl.signal
 		});
 	}
+	if (signals) {
+		window.addEventListener("pagehide", sendSignals, on);
+		document.addEventListener("visibilitychange", () => document.visibilityState === "hidden" && sendSignals(), on);
+	}
 	return {
 		pageview,
 		track: (name, props) => send(String(name), props),
-		stop: () => ctl.abort()
+		stop: () => {
+			if (ctl.signal.aborted) return;
+			sendSignals();
+			signals?.stop();
+			ctl.abort();
+		}
 	};
 }
 //#endregion
@@ -188,7 +356,7 @@ function webAnalytics(o) {
 * It also records pageviews (Visitors, see ./web.ts): no cookies, no personal data. Turn that
 * off with `trackPageviews: false`.
 */
-const SDK_VERSION = "0.4.0";
+const SDK_VERSION = "0.5.0";
 const MAX_ARG_BYTES = 8192;
 const MAX_RESULT_CHARS = 2048;
 function uuid() {
@@ -307,6 +475,7 @@ var AgentStatsClient = class {
 					outboundLinks: o.outboundLinks,
 					fileDownloads: o.fileDownloads,
 					allowLocalhost: o.allowLocalhost,
+					agentSignals: o.agentSignals,
 					debug: o.debug
 				});
 			}

package/dist/index.d.cts

@@ -10,7 +10,7 @@
 type EventProps = Record<string, string | number | boolean>;
 //#endregion
 //#region src/index.d.ts
-export declare const SDK_VERSION = "0.4.0";
+export declare const SDK_VERSION = "0.5.0";
 export type ToolStatus = 'success' | 'error' | 'cancelled';
 export interface ToolAnnotations {
   readOnlyHint?: boolean;
@@ -103,6 +103,8 @@ export interface AgentStatsOptions {
   fileDownloads?: boolean | string[];
   /** Record pageviews on localhost too. Default `false`. */
   allowLocalhost?: boolean;
+  /** With Visitors, send page interaction counts and timings (no content, positions or elements). Default `true`. */
+  agentSignals?: boolean;
   /** Log to console. */
   debug?: boolean;
   /** Do nothing (useful in dev/test). */

package/dist/index.d.ts

@@ -10,7 +10,7 @@
 type EventProps = Record<string, string | number | boolean>;
 //#endregion
 //#region src/index.d.ts
-export declare const SDK_VERSION = "0.4.0";
+export declare const SDK_VERSION = "0.5.0";
 export type ToolStatus = 'success' | 'error' | 'cancelled';
 export interface ToolAnnotations {
   readOnlyHint?: boolean;
@@ -103,6 +103,8 @@ export interface AgentStatsOptions {
   fileDownloads?: boolean | string[];
   /** Record pageviews on localhost too. Default `false`. */
   allowLocalhost?: boolean;
+  /** With Visitors, send page interaction counts and timings (no content, positions or elements). Default `true`. */
+  agentSignals?: boolean;
   /** Log to console. */
   debug?: boolean;
   /** Do nothing (useful in dev/test). */

package/dist/index.js

@@ -1,4 +1,148 @@
+const SIZE = 29;
+const TIMES = [
+	10,
+	40,
+	100,
+	250
+];
+const MOVES = [
+	1,
+	2,
+	6,
+	21
+];
+const bucket = (x, bounds) => {
+	let i = 0;
+	while (i < bounds.length && x >= bounds[i]) i++;
+	return i;
+};
+const textEntry = (t) => !!t && (t.isContentEditable || t.tagName === "TEXTAREA" || t.tagName === "INPUT" && /^(text|search|email|url|tel|password|number|)$/.test(t.type));
+const formField = (t) => !!t && (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName));
+const autofilled = (t) => {
+	try {
+		return t.matches(":autofill");
+	} catch {
+		return false;
+	}
+};
+function watchSignals() {
+	const noop = {
+		take: () => null,
+		stop() {}
+	};
+	if (typeof document === "undefined" || typeof performance === "undefined") return noop;
+	const now = () => performance.now();
+	const away = () => document.visibilityState === "hidden" || !document.hasFocus();
+	let v = [];
+	let start = 0;
+	let moves = 0;
+	let lastKey = -1e9;
+	let editCause = -1e9;
+	let intent = -1e9;
+	let lastScroll = -1e9;
+	const holds = /* @__PURE__ */ new Map();
+	const reset = () => {
+		v = Array.from({ length: SIZE }, () => 0);
+		v[0] = 1;
+		start = now();
+		moves = 0;
+	};
+	reset();
+	const acted = (t) => {
+		if (!v[2]) v[2] = Math.max(1, Math.round(t - start));
+	};
+	const ctl = new AbortController();
+	const on = (type, f) => document.addEventListener(type, f, {
+		capture: true,
+		passive: true,
+		signal: ctl.signal
+	});
+	on("pointermove", (e) => {
+		if (!e.isTrusted) return;
+		v[3]++;
+		moves++;
+	});
+	on("pointerdown", (e) => {
+		if (!e.isTrusted) return;
+		intent = now();
+		acted(intent);
+	});
+	on("click", (e) => {
+		if (!e.isTrusted) return void v[26]++;
+		acted(now());
+		if (away()) v[27]++;
+		if (e.detail === 0) v[10]++;
+		else if (e.pointerType === "touch" || e.pointerType === "pen") v[9]++;
+		else if (e.detail === 1) v[4 + bucket(moves, MOVES)]++;
+		moves = 0;
+	});
+	on("keydown", (e) => {
+		if (!e.isTrusted) return void v[26]++;
+		const t = now();
+		acted(t);
+		intent = editCause = t;
+		if (away()) v[27]++;
+		if (e.repeat || e.target?.type === "password") return;
+		if (t - lastKey < 2e3) v[16 + bucket(t - lastKey, TIMES)]++;
+		lastKey = t;
+		holds.set(e.code || e.key, t);
+	});
+	on("keyup", (e) => {
+		const down = holds.get(e.code || e.key);
+		if (!e.isTrusted || down === void 0) return;
+		holds.delete(e.code || e.key);
+		v[11 + bucket(now() - down, TIMES)]++;
+	});
+	for (const type of [
+		"paste",
+		"drop",
+		"compositionend"
+	]) on(type, () => {
+		editCause = now();
+	});
+	for (const type of ["wheel", "touchstart"]) on(type, () => {
+		intent = now();
+	});
+	on("change", (e) => {
+		if (!e.isTrusted && formField(e.target)) v[28]++;
+	});
+	on("input", (e) => {
+		if (!e.isTrusted) return void (formField(e.target) && v[28]++);
+		if (!textEntry(e.target) || autofilled(e.target)) return;
+		const t = now();
+		acted(t);
+		if (away()) v[27]++;
+		const since = t - editCause;
+		v[since < 100 ? 21 : since < 1e3 ? 22 : 23]++;
+	});
+	on("scroll", () => {
+		const t = now();
+		if (t - lastScroll > 150) {
+			v[24]++;
+			if (t - intent > 500) v[25]++;
+		}
+		lastScroll = t;
+	});
+	return {
+		take() {
+			const out = v.slice(3).some(Boolean) ? v : null;
+			if (out) out[1] = Math.min(2 ** 31, Math.round(now() - start));
+			reset();
+			return out;
+		},
+		stop: () => ctl.abort()
+	};
+}
+//#endregion
 //#region src/web.ts
+/**
+* Visitors: privacy-friendly web analytics for people. One small request per pageview or custom
+* event, no cookies, nothing stored in the browser. The server counts unique visitors from a
+* daily-salted hash of the IP and user agent, the way Plausible does, and keeps neither.
+*
+* Used by the full SDK (on by default, `trackPageviews: false` turns it off) and on its own by
+* the lite script (`/sdk/lite.js`) for sites without WebMCP tools.
+*/
 const VISIT_COOKIE = "_al_v";
 /** What Claude in Chrome puts on the page while it's in control (its stop button). */
 const AGENT_CONTROL_MARKER = "#claude-agent-stop-container";
@@ -92,20 +236,15 @@ function webAnalytics(o) {
 	try {
 		ignored = localStorage.getItem("agentstats_ignore") === "true";
 	} catch {}
-	const send = (name, props) => {
+	const post = (what, data) => {
 		if (ignored) return log("ignored: agentstats_ignore is set");
-		if (local && !o.allowLocalhost) return log("ignored on localhost:", name);
+		if (local && !o.allowLocalhost) return log("ignored on localhost:", what);
 		const body = JSON.stringify({
 			k: o.key,
-			n: name,
-			u: location.href,
-			r: document.referrer || null,
-			w: window.innerWidth,
-			p: props,
-			a: agentInBrowser()?.name,
-			h: o.hashRouting ? 1 : void 0
+			...data,
+			a: agentInBrowser()?.name
 		});
-		log("send", name, props ?? "");
+		log("send", what);
 		try {
 			if (navigator.sendBeacon?.(o.endpoint, body)) return;
 		} catch {}
@@ -116,6 +255,24 @@ function webAnalytics(o) {
 			headers: { "Content-Type": "text/plain" }
 		}).catch(() => {});
 	};
+	const send = (name, props) => post(name, {
+		n: name,
+		u: location.href,
+		r: document.referrer || null,
+		w: window.innerWidth,
+		p: props,
+		h: o.hashRouting ? 1 : void 0
+	});
+	const signals = o.agentSignals === false ? null : watchSignals();
+	let signalsUrl = location.href;
+	const sendSignals = () => {
+		const s = signals?.take();
+		if (s) post("signals", {
+			t: "s",
+			u: signalsUrl,
+			s
+		});
+	};
 	const ctl = new AbortController();
 	const on = { signal: ctl.signal };
 	let last = "";
@@ -123,7 +280,9 @@ function webAnalytics(o) {
 		if (ctl.signal.aborted) return;
 		const page = location.pathname + (o.hashRouting ? location.hash : "");
 		if (page === last) return;
+		if (last) sendSignals();
 		last = page;
+		signalsUrl = location.href;
 		send("pageview");
 	};
 	const start = () => {
@@ -165,10 +324,19 @@ function webAnalytics(o) {
 			signal: ctl.signal
 		});
 	}
+	if (signals) {
+		window.addEventListener("pagehide", sendSignals, on);
+		document.addEventListener("visibilitychange", () => document.visibilityState === "hidden" && sendSignals(), on);
+	}
 	return {
 		pageview,
 		track: (name, props) => send(String(name), props),
-		stop: () => ctl.abort()
+		stop: () => {
+			if (ctl.signal.aborted) return;
+			sendSignals();
+			signals?.stop();
+			ctl.abort();
+		}
 	};
 }
 //#endregion
@@ -184,7 +352,7 @@ function webAnalytics(o) {
 * It also records pageviews (Visitors, see ./web.ts): no cookies, no personal data. Turn that
 * off with `trackPageviews: false`.
 */
-const SDK_VERSION = "0.4.0";
+const SDK_VERSION = "0.5.0";
 const MAX_ARG_BYTES = 8192;
 const MAX_RESULT_CHARS = 2048;
 function uuid() {
@@ -303,6 +471,7 @@ var AgentStatsClient = class {
 					outboundLinks: o.outboundLinks,
 					fileDownloads: o.fileDownloads,
 					allowLocalhost: o.allowLocalhost,
+					agentSignals: o.agentSignals,
 					debug: o.debug
 				});
 			}

package/dist/lite.iife.js

@@ -1 +1 @@
-(function(){let e=`agentstats:locationchange`,t=Symbol.for(`agentstats.patched`),n=`pdf.xlsx.docx.txt.rtf.csv.exe.key.pps.ppt.pptx.7z.pkg.rar.gz.zip.avi.mov.mp4.mpeg.wmv.midi.mp3.wav.wma.dmg.iso.msi`.split(`.`);function r(e){try{return document.cookie.match(RegExp(`(?:^|; )${e}=([\\w-]{8,64})`))?.[1]}catch{return}}function i(){if(typeof document>`u`||typeof navigator>`u`)return null;if(document.querySelector?.(`#claude-agent-stop-container`))return{name:`claude-in-chrome`,via:`dom`};let e=String(navigator.userAgent??``);return/\bClaude\/\d/.test(e)?{name:`claude-browser`,via:`user-agent`}:r(`_al_v`)?{name:`verified-visit`,via:`visit`}:navigator.webdriver===!0||/HeadlessChrome/.test(e)?{name:`automation`,via:`webdriver`}:null}function a(){if(!(typeof history>`u`))for(let n of[`pushState`,`replaceState`]){let r=history[n];if(typeof r!=`function`||r[t])continue;let i=function(...t){let n=r.apply(this,t);return window.dispatchEvent(new Event(e)),n};Object.defineProperty(i,t,{value:!0}),history[n]=i}}function o(t){let r={pageview(){},track(){},stop(){}};if(typeof window>`u`||typeof document>`u`)return r;let o=(...e)=>t.debug&&console.debug(`[agentstats]`,...e),s=/^localhost$|^127(\.\d+){3}$|^\[::1?\]$|\.local$|^$/.test(location.hostname)||location.protocol===`file:`,c=!1;try{c=localStorage.getItem(`agentstats_ignore`)===`true`}catch{}let l=(e,n)=>{if(c)return o(`ignored: agentstats_ignore is set`);if(s&&!t.allowLocalhost)return o(`ignored on localhost:`,e);let r=JSON.stringify({k:t.key,n:e,u:location.href,r:document.referrer||null,w:window.innerWidth,p:n,a:i()?.name,h:t.hashRouting?1:void 0});o(`send`,e,n??``);try{if(navigator.sendBeacon?.(t.endpoint,r))return}catch{}fetch(t.endpoint,{method:`POST`,body:r,keepalive:!0,headers:{"Content-Type":`text/plain`}}).catch(()=>{})},u=new AbortController,d={signal:u.signal},f=``,p=()=>{if(u.signal.aborted)return;let e=location.pathname+(t.hashRouting?location.hash:``);e!==f&&(f=e,l(`pageview`))};(()=>{if(document.visibilityState!==`prerender`)return p();document.addEventListener(`visibilitychange`,function e(){document.visibilityState!==`prerender`&&(document.removeEventListener(`visibilitychange`,e),p())},d)})(),a();let m=()=>setTimeout(p,0);if(window.addEventListener(e,m,d),window.addEventListener(`popstate`,m,d),t.hashRouting&&window.addEventListener(`hashchange`,m,d),t.outboundLinks||t.fileDownloads){let e=Array.isArray(t.fileDownloads)?t.fileDownloads:t.fileDownloads?n:[],r=n=>{if(n.type===`auxclick`&&n.button!==1)return;let r=n.target?.closest?.(`a[href]`);if(!r)return;let i;try{i=new URL(r.href,location.href)}catch{return}let a=i.pathname.split(`.`).pop()?.toLowerCase()??``;e.includes(a)?l(`File Download`,{url:i.href.split(`?`)[0]}):t.outboundLinks&&/^https?:$/.test(i.protocol)&&i.host!==location.host&&l(`Outbound Link: Click`,{url:i.href.split(`?`)[0]})};document.addEventListener(`click`,r,{capture:!0,signal:u.signal}),document.addEventListener(`auxclick`,r,{capture:!0,signal:u.signal})}return{pageview:p,track:(e,t)=>l(String(e),t),stop:()=>u.abort()}}let s=document.currentScript,c=s?.dataset??{},l=e=>e!==void 0&&e!==`false`,u={pageview(){},track(){},stop(){}};if(c.key){let e=c.fileDownloads;u=o({key:c.key,endpoint:c.endpoint?`${c.endpoint.replace(/\/+$/,``)}/web`:new URL(`/api/ingest/web`,s.src).toString(),hashRouting:l(c.hashRouting),outboundLinks:l(c.outboundLinks),fileDownloads:e&&![``,`true`,`false`].includes(e)?e.split(`,`).map(e=>e.trim()):l(e),allowLocalhost:l(c.allowLocalhost),debug:l(c.debug)})}let d=window;d.AgentStats??={track:(e,t)=>u.track(e,t),pageview:()=>u.pageview()}})();
+(function(){let e=[10,40,100,250],t=[1,2,6,21],n=(e,t)=>{let n=0;for(;n<t.length&&e>=t[n];)n++;return n},r=e=>!!e&&(e.isContentEditable||e.tagName===`TEXTAREA`||e.tagName===`INPUT`&&/^(text|search|email|url|tel|password|number|)$/.test(e.type)),i=e=>!!e&&(e.isContentEditable||/^(INPUT|TEXTAREA|SELECT)$/.test(e.tagName)),a=e=>{try{return e.matches(`:autofill`)}catch{return!1}};function o(){let o={take:()=>null,stop(){}};if(typeof document>`u`||typeof performance>`u`)return o;let s=()=>performance.now(),c=()=>document.visibilityState===`hidden`||!document.hasFocus(),l=[],u=0,d=0,f=-1e9,p=-1e9,m=-1e9,h=-1e9,g=new Map,_=()=>{l=Array.from({length:29},()=>0),l[0]=1,u=s(),d=0};_();let v=e=>{l[2]||(l[2]=Math.max(1,Math.round(e-u)))},y=new AbortController,b=(e,t)=>document.addEventListener(e,t,{capture:!0,passive:!0,signal:y.signal});b(`pointermove`,e=>{e.isTrusted&&(l[3]++,d++)}),b(`pointerdown`,e=>{e.isTrusted&&(m=s(),v(m))}),b(`click`,e=>{if(!e.isTrusted)return void l[26]++;v(s()),c()&&l[27]++,e.detail===0?l[10]++:e.pointerType===`touch`||e.pointerType===`pen`?l[9]++:e.detail===1&&l[4+n(d,t)]++,d=0}),b(`keydown`,t=>{if(!t.isTrusted)return void l[26]++;let r=s();v(r),m=p=r,c()&&l[27]++,!(t.repeat||t.target?.type===`password`)&&(r-f<2e3&&l[16+n(r-f,e)]++,f=r,g.set(t.code||t.key,r))}),b(`keyup`,t=>{let r=g.get(t.code||t.key);t.isTrusted&&r!==void 0&&(g.delete(t.code||t.key),l[11+n(s()-r,e)]++)});for(let e of[`paste`,`drop`,`compositionend`])b(e,()=>{p=s()});for(let e of[`wheel`,`touchstart`])b(e,()=>{m=s()});return b(`change`,e=>{!e.isTrusted&&i(e.target)&&l[28]++}),b(`input`,e=>{if(!e.isTrusted)return void(i(e.target)&&l[28]++);if(!r(e.target)||a(e.target))return;let t=s();v(t),c()&&l[27]++;let n=t-p;l[n<100?21:n<1e3?22:23]++}),b(`scroll`,()=>{let e=s();e-h>150&&(l[24]++,e-m>500&&l[25]++),h=e}),{take(){let e=l.slice(3).some(Boolean)?l:null;return e&&(e[1]=Math.min(2**31,Math.round(s()-u))),_(),e},stop:()=>y.abort()}}let s=`agentstats:locationchange`,c=Symbol.for(`agentstats.patched`),l=`pdf.xlsx.docx.txt.rtf.csv.exe.key.pps.ppt.pptx.7z.pkg.rar.gz.zip.avi.mov.mp4.mpeg.wmv.midi.mp3.wav.wma.dmg.iso.msi`.split(`.`);function u(e){try{return document.cookie.match(RegExp(`(?:^|; )${e}=([\\w-]{8,64})`))?.[1]}catch{return}}function d(){if(typeof document>`u`||typeof navigator>`u`)return null;if(document.querySelector?.(`#claude-agent-stop-container`))return{name:`claude-in-chrome`,via:`dom`};let e=String(navigator.userAgent??``);return/\bClaude\/\d/.test(e)?{name:`claude-browser`,via:`user-agent`}:u(`_al_v`)?{name:`verified-visit`,via:`visit`}:navigator.webdriver===!0||/HeadlessChrome/.test(e)?{name:`automation`,via:`webdriver`}:null}function f(){if(!(typeof history>`u`))for(let e of[`pushState`,`replaceState`]){let t=history[e];if(typeof t!=`function`||t[c])continue;let n=function(...e){let n=t.apply(this,e);return window.dispatchEvent(new Event(s)),n};Object.defineProperty(n,c,{value:!0}),history[e]=n}}function p(e){let t={pageview(){},track(){},stop(){}};if(typeof window>`u`||typeof document>`u`)return t;let n=(...t)=>e.debug&&console.debug(`[agentstats]`,...t),r=/^localhost$|^127(\.\d+){3}$|^\[::1?\]$|\.local$|^$/.test(location.hostname)||location.protocol===`file:`,i=!1;try{i=localStorage.getItem(`agentstats_ignore`)===`true`}catch{}let a=(t,a)=>{if(i)return n(`ignored: agentstats_ignore is set`);if(r&&!e.allowLocalhost)return n(`ignored on localhost:`,t);let o=JSON.stringify({k:e.key,...a,a:d()?.name});n(`send`,t);try{if(navigator.sendBeacon?.(e.endpoint,o))return}catch{}fetch(e.endpoint,{method:`POST`,body:o,keepalive:!0,headers:{"Content-Type":`text/plain`}}).catch(()=>{})},c=(t,n)=>a(t,{n:t,u:location.href,r:document.referrer||null,w:window.innerWidth,p:n,h:e.hashRouting?1:void 0}),u=e.agentSignals===!1?null:o(),p=location.href,m=()=>{let e=u?.take();e&&a(`signals`,{t:`s`,u:p,s:e})},h=new AbortController,g={signal:h.signal},_=``,v=()=>{if(h.signal.aborted)return;let t=location.pathname+(e.hashRouting?location.hash:``);t!==_&&(_&&m(),_=t,p=location.href,c(`pageview`))};(()=>{if(document.visibilityState!==`prerender`)return v();document.addEventListener(`visibilitychange`,function e(){document.visibilityState!==`prerender`&&(document.removeEventListener(`visibilitychange`,e),v())},g)})(),f();let y=()=>setTimeout(v,0);if(window.addEventListener(s,y,g),window.addEventListener(`popstate`,y,g),e.hashRouting&&window.addEventListener(`hashchange`,y,g),e.outboundLinks||e.fileDownloads){let t=Array.isArray(e.fileDownloads)?e.fileDownloads:e.fileDownloads?l:[],n=n=>{if(n.type===`auxclick`&&n.button!==1)return;let r=n.target?.closest?.(`a[href]`);if(!r)return;let i;try{i=new URL(r.href,location.href)}catch{return}let a=i.pathname.split(`.`).pop()?.toLowerCase()??``;t.includes(a)?c(`File Download`,{url:i.href.split(`?`)[0]}):e.outboundLinks&&/^https?:$/.test(i.protocol)&&i.host!==location.host&&c(`Outbound Link: Click`,{url:i.href.split(`?`)[0]})};document.addEventListener(`click`,n,{capture:!0,signal:h.signal}),document.addEventListener(`auxclick`,n,{capture:!0,signal:h.signal})}return u&&(window.addEventListener(`pagehide`,m,g),document.addEventListener(`visibilitychange`,()=>document.visibilityState===`hidden`&&m(),g)),{pageview:v,track:(e,t)=>c(String(e),t),stop:()=>{h.signal.aborted||(m(),u?.stop(),h.abort())}}}let m=document.currentScript,h=m?.dataset??{},g=e=>e!==void 0&&e!==`false`,_={pageview(){},track(){},stop(){}};if(h.key){let e=h.fileDownloads;_=p({key:h.key,endpoint:h.endpoint?`${h.endpoint.replace(/\/+$/,``)}/web`:new URL(`/api/ingest/web`,m.src).toString(),hashRouting:g(h.hashRouting),outboundLinks:g(h.outboundLinks),fileDownloads:e&&![``,`true`,`false`].includes(e)?e.split(`,`).map(e=>e.trim()):g(e),allowLocalhost:g(h.allowLocalhost),agentSignals:h.agentSignals!==`false`,debug:g(h.debug)})}let v=window;v.AgentStats??={track:(e,t)=>_.track(e,t),pageview:()=>_.pageview()}})();

package/dist/server.cjs

@@ -993,7 +993,7 @@ function detectFromHeaders(header, url) {
 *
 *   const lens = createAgentStats({ apiKey: process.env.AGENTSTATS_API_KEY }) // API-only server
 */
-const SERVER_SDK_VERSION = "0.3.0";
+const SERVER_SDK_VERSION = "0.3.1";
 /**
 * Words that may mean a bot the table below doesn't know yet. Deliberately broad: the server
 * makes the final call, and its table can be newer than this SDK's.
@@ -1411,6 +1411,7 @@ var AgentStatsServer = class {
 		if (this.apiOn && this.isApiPath(path)) return this.decideApi(m, url, path, header, ip, detection);
 		if (!this.hitsOn) return ignore;
 		const ua = header("user-agent") ?? null;
+		if (!ip && !ua?.trim()) return ignore;
 		const signed = detection.signed;
 		if (signed || detection.isBot || ua && BOT_HINT.test(ua)) {
 			const record = {

package/dist/server.d.cts

@@ -228,7 +228,7 @@ type DetectInput = Request | Headers | {
 export declare function detectBot(input: DetectInput): BotDetection;
 //#endregion
 //#region src/server.d.ts
-export declare const SERVER_SDK_VERSION = "0.3.0";
+export declare const SERVER_SDK_VERSION = "0.3.1";
 export interface ServerOptions {
   /**
    * Secret server key from Site settings (`al_srv_…`). Never expose it to browsers.

package/dist/server.d.ts

@@ -228,7 +228,7 @@ type DetectInput = Request | Headers | {
 export declare function detectBot(input: DetectInput): BotDetection;
 //#endregion
 //#region src/server.d.ts
-export declare const SERVER_SDK_VERSION = "0.3.0";
+export declare const SERVER_SDK_VERSION = "0.3.1";
 export interface ServerOptions {
   /**
    * Secret server key from Site settings (`al_srv_…`). Never expose it to browsers.

package/dist/server.js

@@ -989,7 +989,7 @@ function detectFromHeaders(header, url) {
 *
 *   const lens = createAgentStats({ apiKey: process.env.AGENTSTATS_API_KEY }) // API-only server
 */
-const SERVER_SDK_VERSION = "0.3.0";
+const SERVER_SDK_VERSION = "0.3.1";
 /**
 * Words that may mean a bot the table below doesn't know yet. Deliberately broad: the server
 * makes the final call, and its table can be newer than this SDK's.
@@ -1407,6 +1407,7 @@ var AgentStatsServer = class {
 		if (this.apiOn && this.isApiPath(path)) return this.decideApi(m, url, path, header, ip, detection);
 		if (!this.hitsOn) return ignore;
 		const ua = header("user-agent") ?? null;
+		if (!ip && !ua?.trim()) return ignore;
 		const signed = detection.signed;
 		if (signed || detection.isBot || ua && BOT_HINT.test(ua)) {
 			const record = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentstats/sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Analytics for WebMCP tool calls and AI bot traffic, plus server-side AI bot detection. Framework-agnostic, zero dependencies.",
   "homepage": "https://agentstats.io",
   "bugs": {