@jshookmcp/jshook 0.3.0 → 0.3.1

package/dist/handlers-Dv_runVv.mjs

@@ -0,0 +1,2 @@
+import{n as e,r as t}from"./response-C7rKQst4.mjs";var n=class{graph;constructor(e){this.graph=e}pickStringArg(e,t){for(let n of t){let t=e[n];if(typeof t==`string`&&t.length>0)return t}}serializeNodes(e){return e.map(e=>({id:e.id,type:e.type,label:e.label,metadata:e.metadata}))}handleQueryDispatch(e){switch(e.by){case`function`:return this.handleQueryFunction({...e,name:this.pickStringArg(e,[`name`,`value`,`query`])});case`script`:return this.handleQueryScript({...e,scriptId:this.pickStringArg(e,[`scriptId`,`value`,`query`])});default:return this.handleQueryUrl({...e,url:this.pickStringArg(e,[`url`,`value`,`query`])})}}handleExportDispatch(e){return e.format===`markdown`?this.handleExportMarkdown():this.handleExportJson()}handleQueryUrl(t){let n=t.url,r=this.graph.queryByUrl(n);return e({query:{type:`url`,value:n},resultCount:r.length,nodes:this.serializeNodes(r)})}handleQueryFunction(t){let n=t.name,r=this.graph.queryByFunction(n);return e({query:{type:`function`,value:n},resultCount:r.length,nodes:this.serializeNodes(r)})}handleQueryScript(t){let n=t.scriptId,r=this.graph.queryByScriptId(n);return e({query:{type:`scriptId`,value:n},resultCount:r.length,nodes:this.serializeNodes(r)})}handleExportJson(){return e(this.graph.exportJson())}handleExportMarkdown(){let e=this.graph.exportMarkdown(),n=this.graph.exportJson();if(!n||!Array.isArray(n.nodes))return t(e);let r=n.nodes.filter(e=>n.edges.filter(t=>t.target===e.id).length===0),i=n.nodes.filter(e=>n.edges.filter(t=>t.source===e.id).length===0),a=n.edges.filter(e=>e.metadata&&typeof e.metadata.confidence==`number`&&e.metadata.confidence<.3),o=[];return o.push(``),o.push(`## Evidence Gaps`),o.push(``),o.push(`- **Dangling nodes (no inbound edges):** ${r.length}`),r.length>0&&o.push(`  ${r.slice(0,10).map(e=>`\`${e.type}:${e.label}\``).join(`, `)}`),o.push(`- **Dangling nodes (no outbound edges):** ${i.length}`),i.length>0&&o.push(`  ${i.slice(0,10).map(e=>`\`${e.type}:${e.label}\``).join(`, `)}`),o.push(`- **Low-confidence edges (<0.3):** ${a.length}`),r.length===0&&i.length===0&&a.length===0&&o.push(`- **Status:** No gaps detected — evidence chain is fully connected.`),o.push(``),t(e+o.join(`
+`))}handleChain(t){let n=t.nodeId,r=t.direction??`forward`,i=this.graph.getEvidenceChain(n,r);return e({startNode:n,direction:r,chainLength:i.length,nodes:this.serializeNodes(i)})}};export{n as EvidenceHandlers};

package/dist/handlers-S9Ws0IGy.mjs

@@ -0,0 +1,2 @@
+import{c as e,l as t,o as n,s as r}from"./constants-Cp6hBrrx.mjs";import{n as i}from"./response-C7rKQst4.mjs";import{t as a}from"./ToolError-DWU_z7gp.mjs";import{r as o,s}from"./parse-args-Cuk7-xUt.mjs";import{access as c}from"node:fs/promises";import{execFile as l}from"node:child_process";import{promisify as u}from"node:util";import{createServer as d}from"node:net";const f=u(l),p=n,m={encoding:`utf8`,maxBuffer:16*1024*1024,windowsHide:!0};function h(e){return typeof e==`object`&&!!e}function g(e){return typeof e==`string`?e:null}function _(e){return e instanceof Error?e.message:String(e)}function v(e){if(!h(e))return``;let t=g(e.stdout);return[g(e.stderr),t].filter(e=>typeof e==`string`&&e.length>0).join(`
+`)}function y(e){return h(e)?g(e.code):null}function b(e,t){if(!e)return null;let n=e[t];return typeof n==`string`&&n.length>0?n:null}function x(e){let t=b(e.match(/Current WebView package.*\(([^()]+)\)/i),1)??b(e.match(/versionName=([^\s]+)/i),1);return t?t.trim():null}var S=class{connectedTarget=null;async ensureLocalFileExists(e){try{await c(e)}catch(t){throw new a(`NOT_FOUND`,`Local file not found: ${e}`,{toolName:`adb-bridge`,details:{filePath:e,reason:_(t)}})}}normalizeError(e,t){if(t instanceof a)return t;if(y(t)===`ENOENT`)return new a(`PREREQUISITE`,"ADB binary not found in PATH. Install Android Platform Tools and ensure `adb` is available.",{toolName:`adb-bridge`});let n=v(t).trim(),r=n.length>0?n:_(t),i=r.toLowerCase();return i.includes(`device not found`)||i.includes(`no devices/emulators found`)||i.includes(`device offline`)||i.includes(`device unauthorized`)?new a(`NOT_FOUND`,r,{toolName:`adb-bridge`,details:{command:[`adb`,...e].join(` `)}}):i.includes(`failed to connect`)||i.includes(`unable to connect`)?new a(`CONNECTION`,r,{toolName:`adb-bridge`,details:{command:[`adb`,...e].join(` `)}}):new a(`RUNTIME`,r,{toolName:`adb-bridge`,details:{command:[`adb`,...e].join(` `)}})}async runAdb(e,t=p){try{let{stdout:n}=await f(process.env.ADB_PATH??`adb`,e,{...m,timeout:t});return n}catch(t){throw this.normalizeError(e,t)}}async connect(e,t){if(typeof e==`string`&&e.trim().length>0){let n=`${e.trim()}:${t??5555}`,r=await this.runAdb([`connect`,n]);if(/(failed|unable)/i.test(r))throw new a(`CONNECTION`,r.trim(),{toolName:`adb-bridge`,details:{target:n}});this.connectedTarget=n;return}await this.runAdb([`start-server`]),this.connectedTarget=null}async disconnect(){if(this.connectedTarget){await this.runAdb([`disconnect`,this.connectedTarget]),this.connectedTarget=null;return}await this.runAdb([`disconnect`])}async listDevices(){let e=await this.runAdb([`devices`,`-l`]),t=[];for(let n of e.split(/\r?\n/)){let e=n.trim();if(e.length===0||e.startsWith(`List of devices attached`)||e.startsWith(`*`))continue;let r=e.split(/\s+/),i=r[0],a=r[1];if(typeof i!=`string`||typeof a!=`string`||a!==`device`)continue;let o=``,s=``,c=``;for(let e of r.slice(2)){let[t,n]=e.split(`:`,2);typeof t!=`string`||typeof n!=`string`||(t===`product`?o=n:t===`model`?s=n:(t===`transport_id`||t===`transport`||t===`usb`)&&(c=n))}t.push({id:i,type:i.startsWith(`emulator-`)?`emulator`:`device`,product:o,model:s,transport:c})}return t}async shell(e,t){return(await this.runAdb([`-s`,e,`shell`,t],r)).replace(/\r?\n$/,``)}async reverse(e,t,n){await this.runAdb([`-s`,e,`reverse`,t,n])}async install(e,t){await this.ensureLocalFileExists(t),await this.runAdb([`-s`,e,`install`,`-r`,t],18e4)}async pull(e,t,n){await this.runAdb([`-s`,e,`pull`,t,n],18e4)}async push(e,t,n){await this.ensureLocalFileExists(t),await this.runAdb([`-s`,e,`push`,t,n],18e4)}async forward(e,t,n){await this.runAdb([`-s`,e,`forward`,t,n])}async getWebViewVersion(e){for(let t of[`cmd webviewupdate getCurrentWebViewPackage`,`dumpsys webviewupdate`,`dumpsys package com.google.android.webview`,`dumpsys package com.android.webview`,`dumpsys package com.android.chrome`])try{let n=x(await this.shell(e,t));if(n)return n}catch{continue}return null}};function C(e){return typeof e==`object`&&!!e}function w(e){return typeof e==`string`?e:null}function T(e,t){if(!e)return null;let n=e[t];return typeof n==`string`&&n.length>0?n:null}function E(e){return C(e)?typeof e.id==`string`&&typeof e.title==`string`&&typeof e.url==`string`:!1}function D(e){return e.startsWith(`@`)?e.slice(1):e}var O=class{adbClient;forwardedPorts=new Map;constructor(e=new S){this.adbClient=e}getPortKey(e,t){return`${e}:${t}`}async getFreePort(){return new Promise((e,t)=>{let n=d();n.once(`error`,t),n.listen(0,`127.0.0.1`,()=>{let r=n.address();if(!r||typeof r==`string`){n.close(),t(new a(`RUNTIME`,`Failed to allocate a local TCP port for WebView debugging.`));return}let{port:i}=r;n.close(n=>{if(n){t(n);return}e(i)})})})}async discoverSockets(e){let t=await this.adbClient.shell(e,`cat /proc/net/unix`),n=new Set;for(let e of t.split(/\r?\n/)){let t=T(e.match(/(@[^\s]*devtools_remote[^\s]*)$/),1);if(!t)continue;let r=D(t);r!==`chrome_devtools_remote`&&n.add(r)}return[...n]}async ensureForward(e,t){let n=this.getPortKey(e,t),r=this.forwardedPorts.get(n);if(typeof r==`number`)return r;let i=await this.getFreePort();return await this.adbClient.forward(e,`tcp:${i}`,`localabstract:${t}`),this.forwardedPorts.set(n,i),i}async fetchTargets(t){let n=await fetch(`http://127.0.0.1:${t}/json/list`,{signal:AbortSignal.timeout(e)});if(!n.ok)throw new a(`CONNECTION`,`Failed to fetch WebView target list on forwarded port ${t}.`,{toolName:`adb_webview`,details:{status:n.status}});let r=await n.json();if(!Array.isArray(r))throw new a(`RUNTIME`,`Unexpected WebView target payload. Expected an array response.`,{toolName:`adb_webview`});return r.filter(E)}async resolveProcessId(e,t){let n=T(t.match(/(?:webview_)?devtools_remote_(\d+)/),1);if(n){let e=Number.parseInt(n,10);if(!Number.isNaN(e))return e}let r=T(t.match(/^(.*)_devtools_remote$/),1);if(!r)return 0;try{let t=(await this.adbClient.shell(e,`pidof -s ${r}`)).split(/\s+/)[0];if(typeof t!=`string`)return 0;let n=Number.parseInt(t,10);return Number.isNaN(n)?0:n}catch{return 0}}async getPrimaryTarget(e,t){let n=await this.ensureForward(e,t),r=await this.fetchTargets(n),i=r.find(e=>e.type===`page`)??r[0];if(!i)throw new a(`NOT_FOUND`,`No debuggable targets found for WebView ${t}.`,{toolName:`adb_webview`,details:{deviceId:e,webviewId:t}});return i}async evaluateViaCdp(e,n){let r=globalThis.WebSocket;if(!r)throw new a(`PREREQUISITE`,`WebSocket API is not available in this Node runtime. Use Node.js 22+ to debug Android WebViews.`,{toolName:`adb_webview`});return new Promise((i,o)=>{let s=new r(e),c=setTimeout(()=>{s.close(),o(new a(`TIMEOUT`,`Timed out while evaluating script inside the Android WebView.`,{toolName:`adb_webview`}))},t),l=e=>{clearTimeout(c),e(),s.close()};s.addEventListener(`open`,()=>{s.send(JSON.stringify({id:1,method:`Runtime.evaluate`,params:{expression:n,returnByValue:!0,awaitPromise:!0}}))}),s.addEventListener(`message`,e=>{let t;try{t=JSON.parse(String(e.data))}catch(e){l(()=>{o(new a(`RUNTIME`,`Failed to parse WebView CDP response: ${String(e)}`,{toolName:`adb_webview`}))});return}if(!C(t)||t.id!==1)return;if(C(t.error)){let e=w(t.error.message)??`Unknown CDP error`;l(()=>{o(new a(`RUNTIME`,e,{toolName:`adb_webview`}))});return}if(!C(t.result)){l(()=>{i(null)});return}if(C(t.result.exceptionDetails)){let e=w(t.result.exceptionDetails.text)??w(t.result.exceptionDetails.description)??`Script execution failed inside the Android WebView.`;l(()=>{o(new a(`RUNTIME`,e,{toolName:`adb_webview`}))});return}if(!C(t.result.result)){l(()=>{i(null)});return}let n=t.result.result;if(`value`in n){l(()=>{i(n.value)});return}let r=w(n.description);l(()=>{i(r)})}),s.addEventListener(`error`,()=>{l(()=>{o(new a(`CONNECTION`,`WebView DevTools socket reported an error while executing script.`,{toolName:`adb_webview`}))})})})}async listWebViews(e){let t=await this.discoverSockets(e),n=[];for(let r of t)try{let t=await this.getPrimaryTarget(e,r);n.push({id:r,url:t.url,title:t.title,processId:await this.resolveProcessId(e,r)})}catch{n.push({id:r,url:``,title:``,processId:await this.resolveProcessId(e,r)})}return n}async attachWebView(e,t){if(!(await this.discoverSockets(e)).includes(t))throw new a(`NOT_FOUND`,`WebView ${t} was not found on device ${e}.`,{toolName:`adb_webview`});await this.getPrimaryTarget(e,t)}async executeScript(e,t,n){await this.attachWebView(e,t);let r=await this.getPrimaryTarget(e,t);if(typeof r.webSocketDebuggerUrl!=`string`||r.webSocketDebuggerUrl.length===0)throw new a(`CONNECTION`,`WebView ${t} does not expose a WebSocket debugger endpoint.`,{toolName:`adb_webview`});return this.evaluateViaCdp(r.webSocketDebuggerUrl,n)}};function k(e){return e instanceof Error?e.message:String(e)}var A=class{adbClient;webviewDbg;constructor(e,t){this.adbClient=e,this.webviewDbg=t}getADBClient(){return this.adbClient||=new S,this.adbClient}getWebViewDebugger(){return this.webviewDbg||=new O(this.getADBClient()),this.webviewDbg}async run(e,t){try{return i(await t())}catch(t){throw t instanceof a?t:new a(`RUNTIME`,k(t),{toolName:e})}}async handleAnalyzeApk(e){return this.run(`adb_apk_analyze`,async()=>{let t=s(e,`serial`),n=s(e,`packageName`),r=await this.getADBClient().shell(t,`dumpsys package ${n}`),i={packageName:n},a=r.match(/versionName=([^\s]+)/);a&&(i.versionName=a[1]);let o=r.match(/versionCode=(\d+)/);o&&(i.versionCode=o[1]);let c=r.match(/minSdk=(\d+)/);c&&(i.minSdk=c[1]);let l=r.match(/targetSdk=(\d+)/);l&&(i.targetSdk=l[1]);let u=[],d=[],f=[],p=[],m=``;for(let e of r.split(/\r?\n/)){if(e.includes(`requested permissions:`)||e.includes(`install permissions:`)){m=`permissions`;continue}if(e.includes(`Activity Resolver Table`)||e.includes(`activities:`)){m=`activities`;continue}if(e.includes(`Service Resolver Table`)||e.includes(`services:`)){m=`services`;continue}if(e.includes(`Receiver Resolver Table`)||e.includes(`receivers:`)){m=`receivers`;continue}let t=e.trim();if(t.startsWith(`android.permission.`)||t.startsWith(`com.`)){let e=t.split(` `)[0];e&&(m===`permissions`?u.push(e):m||u.push(e))}if(m===`activities`&&t.includes(n)){let e=t.match(/(\S+)/);e&&d.push(e[1])}if(m===`services`&&t.includes(n)){let e=t.match(/(\S+)/);e&&f.push(e[1])}if(m===`receivers`&&t.includes(n)){let e=t.match(/(\S+)/);e&&p.push(e[1])}}return i.permissions=[...new Set(u)],i.activities=[...new Set(d)],i.services=[...new Set(f)],i.receivers=[...new Set(p)],{success:!0,serial:t,...i}})}async handleWebViewList(e){return this.run(`adb_webview_list`,async()=>{let t=s(e,`serial`),n=o(e,`hostPort`)??9222;return{success:!0,serial:t,webViewVersion:await this.getADBClient().getWebViewVersion(t),hostPort:n,webviews:(await this.getWebViewDebugger().listWebViews(t)).map(e=>({id:e.id,url:e.url,title:e.title,processId:e.processId}))}})}async handleWebViewAttach(e){return this.run(`adb_webview_attach`,async()=>{let t=s(e,`serial`),n=s(e,`targetId`),r=o(e,`hostPort`)??9222;return await this.getWebViewDebugger().attachWebView(t,n),{success:!0,serial:t,targetId:n,hostPort:r,attached:!0,snapshot:await this.getWebViewDebugger().executeScript(t,n,`(() => ({ title: document.title, url: location.href, readyState: document.readyState }))()`)}})}};export{A as ADBBridgeHandlers};