@gjsify/devtools-mcp 0.11.0 → 0.13.0

package/README.md

@@ -34,6 +34,7 @@ A `DevtoolsToolProfile` maps the generic + app-specific DBus methods to MCP tool
 - **generic** — `get_status`, `screenshot`, `list_actions`, `activate_action`, `resize_window`, `present_window`, and the introspection tools.
 - **storybook** — `list_stories`, `get_current_story`, `open_story`, `set_story_arg` (+ generics; screenshot via the generic `screenshot`).
 - **browser** — the [`@gjsify/devtools-browser`](../devtools-browser) web-debugging tools: `navigate`, `page_screenshot`, `eval_js`, `inspect_element`, `dom_tree`, `get_network`, … (+ generics).
+- **cdp** — the [`@gjsify/devtools-cdp`](../devtools-cdp) WebKit-remote-inspector tools: `cdp_send` (any `Domain.command`), `cdp_connect` / `cdp_discover_targets` / `cdp_drain_events`, plus ~13 curated typed tools (`cdp_runtime_evaluate`, `cdp_dom_get_document`, `cdp_css_get_computed_style_for_node`, …) generated from the protocol spec (+ generics).
 
 ## Library API
 

package/lib/esm/index.js

@@ -1 +1 @@
-import{DbusDevtoolsClient as e}from"./dbus-client.js";import{fail as t,image as n,ok as r}from"./tool-result.js";import{dbusError as i}from"./error-map.js";import{registerGenericTools as a}from"./generic-tools.js";import{GjsStdioTransport as o}from"./stdio-transport.js";import{runDevtoolsMcp as s}from"./run-server.js";import{registerStorybookTools as c,storybookProfile as l}from"./profiles/storybook.js";import{browserProfile as u,registerBrowserTools as d}from"./profiles/browser.js";export*from"@gjsify/devtools-protocol";export{e as DbusDevtoolsClient,o as GjsStdioTransport,u as browserProfile,i as dbusError,t as fail,n as image,r as ok,d as registerBrowserTools,a as registerGenericTools,c as registerStorybookTools,s as runDevtoolsMcp,l as storybookProfile};
+import{DbusDevtoolsClient as e}from"./dbus-client.js";import{fail as t,image as n,ok as r}from"./tool-result.js";import{dbusError as i}from"./error-map.js";import{registerGenericTools as a}from"./generic-tools.js";import{GjsStdioTransport as o}from"./stdio-transport.js";import{runDevtoolsMcp as s}from"./run-server.js";import{registerStorybookTools as c,storybookProfile as l}from"./profiles/storybook.js";import{browserProfile as u,registerBrowserTools as d}from"./profiles/browser.js";import{cdpProfile as f,registerCdpTools as p}from"./profiles/cdp.js";import{NsCdpClient as m}from"./transports/ns-cdp-client.js";import{nativescriptProfile as h,registerNsGenericTools as g,runNativescriptMcp as _}from"./profiles/nativescript.js";export*from"@gjsify/devtools-protocol";export{e as DbusDevtoolsClient,o as GjsStdioTransport,m as NsCdpClient,u as browserProfile,f as cdpProfile,i as dbusError,t as fail,n as image,h as nativescriptProfile,r as ok,d as registerBrowserTools,p as registerCdpTools,a as registerGenericTools,g as registerNsGenericTools,c as registerStorybookTools,s as runDevtoolsMcp,_ as runNativescriptMcp,l as storybookProfile};

package/lib/esm/profiles/browser.js

@@ -1 +1 @@
-import"../_virtual/_rolldown/runtime.js";import{image as e}from"../tool-result.js";import t from"@girs/glib-2.0";import{z as n}from"zod";const strv=e=>t.Variant.new_string(e),intv=e=>t.Variant.new_int32(e),r={instance:n.string().optional().describe(`Browser instance label; omit for the default app`)};function registerBrowserTools(i){let{server:a,client:o,ok:s,dbusError:c}=i;a.registerTool(`navigate`,{description:"Navigate to a URL (a `page:*` built-in page or `https://…`). Updates the history stack + URL bar.",inputSchema:n.object({url:n.string(),...r})},async({url:e,instance:n})=>{try{return await o.control(n,`BrowserNavigate`,t.Variant.new_tuple([strv(e)]),null),s(`Navigated to ${e}`)}catch(e){return c(e,n)}});for(let[e,t,i]of[[`back`,`BrowserBack`,`Go back one entry in browser history.`],[`forward`,`BrowserForward`,`Go forward one entry in browser history.`],[`reload`,`BrowserReload`,`Reload the current page.`]])a.registerTool(e,{description:i,inputSchema:n.object({...r})},async({instance:e})=>{try{return await o.control(e,t,null,null),s(i)}catch(t){return c(t,e)}});a.registerTool(`get_page_info`,{description:`Current page state: uri, appUrl, title, canGoBack, canGoForward, lastLoadError.`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetPageInfo`))}catch(t){return c(t,e)}}),a.registerTool(`page_screenshot`,{description:"PNG of the rendered WEB CONTENT via the WebKit compositor (use this, not the generic `screenshot`, for the page — WebKit composites out-of-process so the GSK shot is blank). region=full (whole scrollable document) | visible (viewport).",inputSchema:n.object({region:n.enum([`full`,`visible`]).optional().default(`full`),...r})},async({region:n,instance:r})=>{try{let a=(await o.control(r,`BrowserScreenshot`,t.Variant.new_tuple([strv(n)]),`(ay)`)).get_child_value(0).deepUnpack();return!a||a.length===0?i.fail(`page_screenshot returned no data — is a page loaded and the window realized?`):e(t.base64_encode(a))}catch(e){return c(e,r)}}),a.registerTool(`set_viewport`,{description:`Set the WebView content-region size in pixels (responsive testing); returns the applied size.`,inputSchema:n.object({width:n.number().int(),height:n.number().int(),...r})},async({width:e,height:n,instance:r})=>{try{let[i,a]=(await o.control(r,`BrowserSetViewport`,t.Variant.new_tuple([intv(e),intv(n)]),`(ii)`)).recursiveUnpack();return s(`Viewport set to ${i}x${a}`)}catch(e){return c(e,r)}}),a.registerTool(`eval_js`,{description:"Evaluate a JavaScript EXPRESSION in the page and return its value (JSON round-trip). Wrap multi-statement code in an IIFE, e.g. `(() => { const a = 1; return a + 1; })()`. Page errors surface as an error.",inputSchema:n.object({script:n.string(),...r})},async({script:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserEvalJs`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`get_links`,{description:"Every `<a href>` on the page as {href, text, title}.",inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetLinks`))}catch(t){return c(t,e)}}),a.registerTool(`follow_link`,{description:"Click the first element matching a CSS selector (or an `<a>` by exact visible text), then wait for the resulting navigation. Returns {clicked, navigated, uri}.",inputSchema:n.object({selectorOrText:n.string(),...r})},async({selectorOrText:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserFollowLink`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`query_dom`,{description:`Metadata for elements matching a CSS selector ({tagName, id, className, text, href?, visible}).`,inputSchema:n.object({selector:n.string(),...r})},async({selector:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserQueryDom`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`wait_for_load`,{description:`Wait for the next page load to finish (ms; default 30000). Returns whether it loaded in time.`,inputSchema:n.object({timeout:n.number().int().optional().default(3e4),...r})},async({timeout:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserWaitForLoad`,t.Variant.new_tuple([intv(e)]),`(b)`)).recursiveUnpack();return s(r?`Page loaded.`:`Timed out waiting for the next load.`)}catch(e){return c(e,n)}}),a.registerTool(`get_console`,{description:`Buffered console.* output captured from the page ({level, args}).`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetConsole`))}catch(t){return c(t,e)}}),a.registerTool(`inspect_element`,{description:`Inspect the first element matching a CSS selector — tag/id/class + attributes + bounding rect + box model (margin/border/padding/content) + a curated set of computed styles. The Elements + Computed + Box Model panels in one call.`,inputSchema:n.object({selector:n.string(),...r})},async({selector:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserInspectElement`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`dom_tree`,{description:`The DOM/Elements tree from a selector (default: document root) down to max_depth, capped per node.`,inputSchema:n.object({selector:n.string().optional().default(``),maxDepth:n.number().int().optional().default(3),...r})},async({selector:e,maxDepth:n,instance:r})=>{try{let[i]=(await o.control(r,`BrowserDomTree`,t.Variant.new_tuple([strv(e),intv(n)]),`(s)`)).recursiveUnpack();return s(i)}catch(e){return c(e,r)}}),a.registerTool(`get_network`,{description:`Page network activity via the Resource Timing API — the navigation entry + each resource.`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetNetwork`))}catch(t){return c(t,e)}}),a.registerTool(`get_accessibility`,{description:`Approximate accessibility tree from a selector (default: body) — role + accessible name + aria-* per node, down to max_depth.`,inputSchema:n.object({selector:n.string().optional().default(``),maxDepth:n.number().int().optional().default(4),...r})},async({selector:e,maxDepth:n,instance:r})=>{try{let[i]=(await o.control(r,`BrowserGetAccessibility`,t.Variant.new_tuple([strv(e),intv(n)]),`(s)`)).recursiveUnpack();return s(i)}catch(e){return c(e,r)}});for(let[e,t,i]of[[`open_inspector`,`BrowserOpenInspector`,`Open the WebKit Web Inspector panel on the browser window.`],[`close_inspector`,`BrowserCloseInspector`,`Close the WebKit Web Inspector panel.`]])a.registerTool(e,{description:i,inputSchema:n.object({...r})},async({instance:e})=>{try{return await o.control(e,t,null,null),s(i)}catch(t){return c(t,e)}})}function browserProfile(e){return{name:`gjsify-browser-devtools`,version:`0.10.0`,busNameBase:e,registerTools:registerBrowserTools}}export{browserProfile,registerBrowserTools};
+import"../_virtual/_rolldown/runtime.js";import{image as e}from"../tool-result.js";import t from"@girs/glib-2.0";import{z as n}from"zod";const strv=e=>t.Variant.new_string(e),intv=e=>t.Variant.new_int32(e),r={instance:n.string().optional().describe(`Browser instance label; omit for the default app`)};function registerBrowserTools(i){let{server:a,client:o,ok:s,dbusError:c}=i;a.registerTool(`navigate`,{description:"Navigate to a URL (a `page:*` built-in page or `https://…`). Updates the history stack + URL bar.",inputSchema:n.object({url:n.string(),...r})},async({url:e,instance:n})=>{try{return await o.control(n,`BrowserNavigate`,t.Variant.new_tuple([strv(e)]),null),s(`Navigated to ${e}`)}catch(e){return c(e,n)}});for(let[e,t,i]of[[`back`,`BrowserBack`,`Go back one entry in browser history.`],[`forward`,`BrowserForward`,`Go forward one entry in browser history.`],[`reload`,`BrowserReload`,`Reload the current page.`]])a.registerTool(e,{description:i,inputSchema:n.object({...r})},async({instance:e})=>{try{return await o.control(e,t,null,null),s(i)}catch(t){return c(t,e)}});a.registerTool(`get_page_info`,{description:`Current page state: uri, appUrl, title, canGoBack, canGoForward, lastLoadError.`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetPageInfo`))}catch(t){return c(t,e)}}),a.registerTool(`page_screenshot`,{description:"PNG of the rendered WEB CONTENT via the WebKit compositor (use this, not the generic `screenshot`, for the page — WebKit composites out-of-process so the GSK shot is blank). region=full (whole scrollable document) | visible (viewport).",inputSchema:n.object({region:n.enum([`full`,`visible`]).optional().default(`full`),...r})},async({region:n,instance:r})=>{try{let a=(await o.control(r,`BrowserScreenshot`,t.Variant.new_tuple([strv(n)]),`(ay)`)).get_child_value(0).deepUnpack();return!a||a.length===0?i.fail(`page_screenshot returned no data — is a page loaded and the window realized?`):e(t.base64_encode(a))}catch(e){return c(e,r)}}),a.registerTool(`set_viewport`,{description:`Set the WebView content-region size in pixels (responsive testing); returns the applied size.`,inputSchema:n.object({width:n.number().int(),height:n.number().int(),...r})},async({width:e,height:n,instance:r})=>{try{let[i,a]=(await o.control(r,`BrowserSetViewport`,t.Variant.new_tuple([intv(e),intv(n)]),`(ii)`)).recursiveUnpack();return s(`Viewport set to ${i}x${a}`)}catch(e){return c(e,r)}}),a.registerTool(`eval_js`,{description:"Evaluate a JavaScript EXPRESSION in the page and return its value (JSON round-trip). Wrap multi-statement code in an IIFE, e.g. `(() => { const a = 1; return a + 1; })()`. Page errors surface as an error.",inputSchema:n.object({script:n.string(),...r})},async({script:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserEvalJs`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}});let storybookEval=async(e,n)=>{let r=`(function(){var s=window.__storybook;if(!s)return ${JSON.stringify(`(not a storybook page: window.__storybook is undefined)`)};return ${n};})()`,[i]=(await o.control(e,`BrowserEvalJs`,t.Variant.new_tuple([strv(r)]),`(s)`)).recursiveUnpack();return i};a.registerTool(`list_stories`,{description:`Storybook: list the stories on a @gjsify/adwaita-storybook page (title, story, category, controls).`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await storybookEval(e,`JSON.stringify(s.listStories())`))}catch(t){return c(t,e)}}),a.registerTool(`open_story`,{description:`Storybook: open a story by its "Category/Name" title; returns the now-current story.`,inputSchema:n.object({title:n.string(),...r})},async({title:e,instance:t})=>{try{return s(await storybookEval(t,`JSON.stringify({opened:s.openStory(${JSON.stringify(e)}),current:s.getCurrentStory()})`))}catch(e){return c(e,t)}}),a.registerTool(`get_current_story`,{description:`Storybook: the active story as {title, story, args}.`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await storybookEval(e,`JSON.stringify(s.getCurrentStory())`))}catch(t){return c(t,e)}}),a.registerTool(`set_story_arg`,{description:`Storybook: set one control arg on the active story (drives the live preview); value is string|number|boolean.`,inputSchema:n.object({name:n.string(),value:n.union([n.string(),n.number(),n.boolean()]),...r})},async({name:e,value:t,instance:n})=>{try{return s(await storybookEval(n,`JSON.stringify(s.setArg(${JSON.stringify(e)}, ${JSON.stringify(t)}))`))}catch(e){return c(e,n)}}),a.registerTool(`get_links`,{description:"Every `<a href>` on the page as {href, text, title}.",inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetLinks`))}catch(t){return c(t,e)}}),a.registerTool(`follow_link`,{description:"Click the first element matching a CSS selector (or an `<a>` by exact visible text), then wait for the resulting navigation. Returns {clicked, navigated, uri}.",inputSchema:n.object({selectorOrText:n.string(),...r})},async({selectorOrText:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserFollowLink`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`query_dom`,{description:`Metadata for elements matching a CSS selector ({tagName, id, className, text, href?, visible}).`,inputSchema:n.object({selector:n.string(),...r})},async({selector:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserQueryDom`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`wait_for_load`,{description:`Wait for the next page load to finish (ms; default 30000). Returns whether it loaded in time.`,inputSchema:n.object({timeout:n.number().int().optional().default(3e4),...r})},async({timeout:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserWaitForLoad`,t.Variant.new_tuple([intv(e)]),`(b)`)).recursiveUnpack();return s(r?`Page loaded.`:`Timed out waiting for the next load.`)}catch(e){return c(e,n)}}),a.registerTool(`get_console`,{description:`Buffered console.* output captured from the page ({level, args}).`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetConsole`))}catch(t){return c(t,e)}}),a.registerTool(`inspect_element`,{description:`Inspect the first element matching a CSS selector — tag/id/class + attributes + bounding rect + box model (margin/border/padding/content) + a curated set of computed styles. The Elements + Computed + Box Model panels in one call.`,inputSchema:n.object({selector:n.string(),...r})},async({selector:e,instance:n})=>{try{let[r]=(await o.control(n,`BrowserInspectElement`,t.Variant.new_tuple([strv(e)]),`(s)`)).recursiveUnpack();return s(r)}catch(e){return c(e,n)}}),a.registerTool(`dom_tree`,{description:`The DOM/Elements tree from a selector (default: document root) down to max_depth, capped per node.`,inputSchema:n.object({selector:n.string().optional().default(``),maxDepth:n.number().int().optional().default(3),...r})},async({selector:e,maxDepth:n,instance:r})=>{try{let[i]=(await o.control(r,`BrowserDomTree`,t.Variant.new_tuple([strv(e),intv(n)]),`(s)`)).recursiveUnpack();return s(i)}catch(e){return c(e,r)}}),a.registerTool(`get_network`,{description:`Page network activity via the Resource Timing API — the navigation entry + each resource.`,inputSchema:n.object({...r})},async({instance:e})=>{try{return s(await o.jsonCall(e,`BrowserGetNetwork`))}catch(t){return c(t,e)}}),a.registerTool(`get_accessibility`,{description:`Approximate accessibility tree from a selector (default: body) — role + accessible name + aria-* per node, down to max_depth.`,inputSchema:n.object({selector:n.string().optional().default(``),maxDepth:n.number().int().optional().default(4),...r})},async({selector:e,maxDepth:n,instance:r})=>{try{let[i]=(await o.control(r,`BrowserGetAccessibility`,t.Variant.new_tuple([strv(e),intv(n)]),`(s)`)).recursiveUnpack();return s(i)}catch(e){return c(e,r)}});for(let[e,t,i]of[[`open_inspector`,`BrowserOpenInspector`,`Open the WebKit Web Inspector panel on the browser window.`],[`close_inspector`,`BrowserCloseInspector`,`Close the WebKit Web Inspector panel.`]])a.registerTool(e,{description:i,inputSchema:n.object({...r})},async({instance:e})=>{try{return await o.control(e,t,null,null),s(i)}catch(t){return c(t,e)}})}function browserProfile(e){return{name:`gjsify-browser-devtools`,version:`0.10.0`,busNameBase:e,registerTools:registerBrowserTools}}export{browserProfile,registerBrowserTools};

package/lib/esm/profiles/cdp.js

@@ -0,0 +1 @@
+import"../_virtual/_rolldown/runtime.js";import e from"@girs/glib-2.0";import{z as t}from"zod";import{PROTOCOL_SPEC as n,generateCdpTools as r}from"@gjsify/devtools-cdp";const strv=t=>e.Variant.new_string(t),i={instance:t.string().optional().describe(`App instance label; omit for the default app`)},a=new Set([`Runtime.evaluate`,`Runtime.callFunctionOn`,`Runtime.getProperties`,`Runtime.getPreview`,`DOM.getDocument`,`DOM.querySelector`,`DOM.querySelectorAll`,`DOM.getOuterHTML`,`DOM.setAttributeValue`,`CSS.getComputedStyleForNode`,`CSS.getMatchedStylesForNode`,`Debugger.setBreakpoint`,`Debugger.setPauseOnExceptions`]);function zodForParam(e,n){if(n&&n.length>0)return t.enum(n);switch(e){case`string`:return t.string();case`number`:return t.number();case`boolean`:return t.boolean();case`array`:return t.array(t.unknown());case`object`:return t.record(t.string(),t.unknown());default:return t.unknown()}}async function cdpSend(t,n,r,i){let[a]=(await t.client.control(n,`CdpSend`,e.Variant.new_tuple([strv(r),strv(JSON.stringify(i))]),`(s)`)).recursiveUnpack();return a}function registerCdpTools(o){let{server:s,client:c,ok:l,dbusError:u}=o;s.registerTool(`cdp_send`,{description:'Send any WebKit Remote Inspector command `Domain.command` (e.g. "Page.reload", "Network.enable") with optional params, and return its result JSON. The universal fallback for commands without a curated tool. Requires a prior cdp_connect.',inputSchema:t.object({method:t.string().describe(`Protocol method, e.g. "Runtime.evaluate".`),params:t.record(t.string(),t.unknown()).optional(),...i})},async({method:e,params:t,instance:n})=>{try{return l(await cdpSend(o,n,e,t??{}))}catch(e){return u(e,n)}}),s.registerTool(`cdp_discover_targets`,{description:`List the inspectable targets (web-page / service-worker / …) on the inspector server.`,inputSchema:t.object({...i})},async({instance:e})=>{try{return l(await c.jsonCall(e,`CdpDiscoverTargets`))}catch(t){return u(t,e)}}),s.registerTool(`cdp_connect`,{description:`Connect to an inspector target (defaults to the first web-page) and auto-enable the Inspector / Runtime / DOM / Console domains. Call before cdp_send / the curated tools.`,inputSchema:t.object({target:t.record(t.string(),t.unknown()).optional().describe(`Optional target selector, e.g. {targetId} or {wsUrl}; omit for the first web-page.`),...i})},async({target:t,instance:n})=>{try{let[r]=(await c.control(n,`CdpConnect`,e.Variant.new_tuple([strv(t?JSON.stringify(t):``)]),`(b)`)).recursiveUnpack();return r?l(`Connected to inspector target.`):o.fail(`No inspectable target found.`)}catch(e){return u(e,n)}}),s.registerTool(`cdp_drain_events`,{description:`Return + clear the buffered protocol events (console messages, DOM mutations, …).`,inputSchema:t.object({...i})},async({instance:e})=>{try{return l(await c.jsonCall(e,`CdpDrainEvents`))}catch(t){return u(t,e)}});let d=r(n,{include:(e,t)=>a.has(`${e}.${t}`)});for(let e of d){let n={};for(let t of e.parameters){let e=zodForParam(t.jsType,t.enum),r=t.description?e.describe(t.description):e;n[t.name]=t.optional?r.optional():r}s.registerTool(e.name,{description:e.description??e.method,inputSchema:t.object({...n,...i})},async t=>{let n=t.instance;try{let r={};for(let n of e.parameters)t[n.name]!==void 0&&(r[n.name]=t[n.name]);return l(await cdpSend(o,n,e.method,r))}catch(e){return u(e,n)}})}}function cdpProfile(e){return{name:`gjsify-cdp-devtools`,version:`0.11.0`,busNameBase:e,registerTools:registerCdpTools}}export{cdpProfile,registerCdpTools};

package/lib/esm/profiles/nativescript.js

@@ -0,0 +1 @@
+import"../_virtual/_rolldown/runtime.js";import{fail as e,image as t,ok as n}from"../tool-result.js";import{GjsStdioTransport as r}from"../stdio-transport.js";import{NsCdpClient as i}from"../transports/ns-cdp-client.js";import a from"@girs/gio-2.0";import o from"@girs/glib-2.0";import{z as s}from"zod";import{McpServer as c}from"@modelcontextprotocol/sdk/server/mcp.js";async function call(e,t,n={}){let r={method:t,params:n},i=await e.request(r);if(!i.ok)throw Error(`${i.error.code}: ${i.error.message}`);return i.result}function okJson(e){return n(JSON.stringify(e,null,2))}function registerNsGenericTools(e){let{server:n,client:r}=e;n.registerTool(`get_status`,{description:`JSON snapshot of the running NativeScript app: app id, platform, instance, root view, pause state.`,inputSchema:s.object({})},async()=>{try{return okJson(await call(r,`GetStatus`))}catch(t){return e.fail(messageOf(t))}}),n.registerTool(`list_toplevels`,{description:"List the app's toplevel(s) — NativeScript has a single root view (`toplevel:0`).",inputSchema:s.object({})},async()=>{try{return okJson(await call(r,`ListToplevels`))}catch(t){return e.fail(messageOf(t))}}),n.registerTool(`dump_tree`,{description:'Dump the native view tree as JSON from `root` (a view path like "toplevel:0/child:2", or omit for the root view), bounded by `depth`. Each node: path, type (NativeScript component), name, cssClasses, visible, optional text.',inputSchema:s.object({root:s.string().optional(),depth:s.number().optional()})},async({root:t,depth:n})=>{try{return okJson(await call(r,`DumpTree`,{root:t??``,depth:n??8}))}catch(t){return e.fail(messageOf(t))}}),n.registerTool(`get_property`,{description:`Read a view's property by view path + property name (JSON-safe value).`,inputSchema:s.object({path:s.string(),prop:s.string()})},async({path:t,prop:n})=>{try{return okJson(await call(r,`GetProperty`,{path:t,prop:n}))}catch(t){return e.fail(messageOf(t))}}),n.registerTool(`screenshot`,{description:`Capture a PNG screenshot of the root native view, rendered in-process by the app (no adb, no screen-record permission). Needs the app foregrounded + laid out.`,inputSchema:s.object({})},async()=>{try{let n=await call(r,`Screenshot`);return!n||!n.data?e.fail(`Screenshot returned no data — the root view is not laid out yet (bring the app to the foreground and retry), or device_screenshot as a fallback.`):t(n.data)}catch(t){return e.fail(messageOf(t))}}),registerDeviceScreenshot(e)}function registerDeviceScreenshot(e){e.server.registerTool(`device_screenshot`,{description:"PNG of the WHOLE Android device/emulator screen via `adb exec-out screencap -p` (host-side; works without the in-app devtools agent). Pass `serial` to target a specific device.",inputSchema:s.object({serial:s.string().optional()})},async({serial:n})=>{try{let r=await adbScreencap(n);return r?t(r):e.fail("adb screencap returned no data — is a device connected (`adb devices`)?")}catch(t){return e.fail(`adb screencap failed: ${messageOf(t)}`)}})}function adbScreencap(e){let t=[`adb`,...e?[`-s`,e]:[],`exec-out`,`screencap`,`-p`],n=a.Subprocess.new(t,a.SubprocessFlags.STDOUT_PIPE|a.SubprocessFlags.STDERR_SILENCE);return new Promise((e,t)=>{n.communicate_async(null,null,(r,i)=>{try{let[,t]=n.communicate_finish(i),r=t?.get_data();if(!r||r.length===0)return e(null);e(o.base64_encode(r))}catch(e){t(e)}})})}function messageOf(e){return e instanceof Error?e.message:String(e)}function nativescriptProfile(e){return{name:`gjsify-nativescript-devtools`,version:`0.11.0`,connect:e}}async function runNativescriptMcp(t){let a=new i(t.connect),s=new c({name:t.name,version:t.version}),l={server:s,client:a,ok:n,fail:e};registerNsGenericTools(l),t.registerTools?.(l);let u=o.MainLoop.new(null,!1),d=new r(()=>u.quit());a.connect().then(()=>console.error(`[gjsify-devtools-mcp] ${t.name} connected to the NativeScript inspector`),e=>console.error(`[gjsify-devtools-mcp] NS inspector not reachable yet (tools will retry): ${messageOf(e)}`)),s.connect(d).then(()=>console.error(`[gjsify-devtools-mcp] ${t.name} on stdio (NativeScript CDP)`),e=>{console.error(`[gjsify-devtools-mcp] failed to connect:`,e),u.quit()}),u.run()}export{nativescriptProfile,registerNsGenericTools,runNativescriptMcp};

package/lib/esm/transports/ns-cdp-client.js

@@ -0,0 +1 @@
+import"../_virtual/_rolldown/runtime.js";import e from"@girs/gio-2.0";import t from"@girs/glib-2.0";import n from"@girs/soup-3.0";e._promisify(n.Session.prototype,`send_and_read_async`,`send_and_read_finish`),e._promisify(n.Session.prototype,`websocket_connect_async`,`websocket_connect_finish`);var NsCdpClient=class{constructor(e={}){this._session=new n.Session,this._connection=null,this._nextId=1,this._pending=new Map,this._decoder=new TextDecoder,this._encoder=new TextEncoder,this._host=e.host??`127.0.0.1`,this._port=e.port??9222,this._explicitUrl=e.url}async connect(){if(this._connection)return;let e=this._explicitUrl??await this._discoverDebuggerUrl(),r=t.Uri.parse(e,t.UriFlags.NONE),i=new n.Message({method:`GET`,uri:r}),a=await this._session.websocket_connect_async(i,null,null,t.PRIORITY_DEFAULT,null);a.max_incoming_payload_size=100*1024*1024,a.connect(`message`,(e,t,r)=>{t===n.WebsocketDataType.TEXT&&this._onMessage(this._decoder.decode(r.toArray()))}),a.connect(`closed`,()=>this._onClosed()),this._connection=a,await this._call(`Runtime.enable`,{})}async request(e){let t=JSON.stringify(e),n=`globalThis.__adwDevtools.dispatch(${JSON.stringify(t)})`,r=await this._call(`Runtime.evaluate`,{expression:n,awaitPromise:!0,returnByValue:!0});if(r.exceptionDetails)throw Error(`CDP Runtime.evaluate threw: ${r.exceptionDetails.text??`unknown error`}`);let i=r.result?.value;if(typeof i!=`string`)throw Error(`NativeScript devtools agent returned no response — is installDevtools() called with GJSIFY_DEVTOOLS=1?`);return JSON.parse(i)}async close(){this._connection&&=(this._connection.close(n.WebsocketCloseCode.NORMAL,null),null);for(let e of this._pending.values())e.reject(Error(`CDP connection closed`));this._pending.clear()}async _discoverDebuggerUrl(){let e=`http://${this._host}:${this._port}/json`,r=new n.Message({method:`GET`,uri:t.Uri.parse(e,t.UriFlags.NONE)}),i;try{i=await this._session.send_and_read_async(r,t.PRIORITY_DEFAULT,null)}catch(t){throw Error(`Cannot reach the NativeScript inspector at ${e} — run \`ns debug android\` (or forward the port with \`adb forward tcp:${this._port} …\`). (${t instanceof Error?t.message:String(t)})`)}let a=r.get_status();if(a!==n.Status.OK)throw Error(`Inspector discovery failed: ${e} returned HTTP ${a}`);let o=this._decoder.decode(i.toArray()),s;try{s=JSON.parse(o)}catch{throw Error(`Inspector discovery returned non-JSON from ${e}`)}let c=s.find(e=>typeof e.webSocketDebuggerUrl==`string`)?.webSocketDebuggerUrl;if(!c)throw Error(`No webSocketDebuggerUrl in the inspector target list at ${e}`);return c}_call(e,r){if(!this._connection)return Promise.reject(Error(`CDP connection not open`));let i=this._nextId++,a=JSON.stringify({id:i,method:e,params:r});return new Promise((e,r)=>{this._pending.set(i,{resolve:e,reject:r}),this._connection?.send_message(n.WebsocketDataType.TEXT,new t.Bytes(this._encoder.encode(a)))})}_onMessage(e){let t;try{t=JSON.parse(e)}catch{return}if(typeof t.id!=`number`)return;let n=this._pending.get(t.id);n&&(this._pending.delete(t.id),t.error?n.reject(Error(`CDP error ${t.error.code??``}: ${t.error.message??`unknown`}`.trim())):n.resolve(t.result))}_onClosed(){this._connection=null;for(let e of this._pending.values())e.reject(Error(`CDP connection closed by the device`));this._pending.clear()}};export{NsCdpClient};

package/lib/types/index.d.ts

@@ -8,4 +8,9 @@ export { GjsStdioTransport } from './stdio-transport.js';
 export type { DevtoolsToolProfile, GenericToolName, McpToolContext } from './profile.js';
 export { registerStorybookTools, storybookProfile } from './profiles/storybook.js';
 export { registerBrowserTools, browserProfile } from './profiles/browser.js';
+export { registerCdpTools, cdpProfile } from './profiles/cdp.js';
+export { NsCdpClient } from './transports/ns-cdp-client.js';
+export type { NsCdpConnectOptions } from './transports/ns-cdp-client.js';
+export { nativescriptProfile, registerNsGenericTools, runNativescriptMcp, } from './profiles/nativescript.js';
+export type { NativescriptToolProfile, NsMcpToolContext } from './profiles/nativescript.js';
 export * from '@gjsify/devtools-protocol';

package/lib/types/profiles/cdp.d.ts

@@ -0,0 +1,4 @@
+import type { DevtoolsToolProfile, McpToolContext } from '../profile.js';
+export declare function registerCdpTools(ctx: McpToolContext): void;
+/** Tool profile for a @gjsify/devtools-cdp-enabled app. */
+export declare function cdpProfile(busNameBase: string): DevtoolsToolProfile;

package/lib/types/profiles/cdp.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/lib/types/profiles/nativescript-types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `Screenshot` result the NativeScript agent returns. The PNG is
+ * base64-encoded (a `Uint8Array` cannot survive the CDP `returnByValue` JSON
+ * round-trip), so the host decodes `data` into an MCP image result.
+ *
+ * MUST match `ScreenshotResult` in `@gjsify/devtools-nativescript/handlers`.
+ */
+export interface ScreenshotResult {
+    format: 'png-base64';
+    /** base64-encoded PNG, or `null` when the root view is not laid out yet. */
+    data: string | null;
+}

package/lib/types/profiles/nativescript.d.ts

@@ -0,0 +1,37 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolResult } from '../tool-result.js';
+import { NsCdpClient, type NsCdpConnectOptions } from '../transports/ns-cdp-client.js';
+/** Profile descriptor for a NativeScript devtools target. */
+export interface NativescriptToolProfile {
+    /** MCP server name. */
+    readonly name: string;
+    /** MCP server version. */
+    readonly version: string;
+    /** CDP connection (explicit ws url, or inspector host:port to discover). */
+    readonly connect?: NsCdpConnectOptions;
+    /** Register app-specific tools on top of the generic ones. */
+    readonly registerTools?: (ctx: NsMcpToolContext) => void;
+}
+/** Context handed to NS tool registrations. */
+export interface NsMcpToolContext {
+    readonly server: McpServer;
+    readonly client: NsCdpClient;
+    readonly ok: (text: string) => ToolResult;
+    readonly fail: (text: string) => ToolResult;
+}
+/**
+ * Register the generic NS tools (the toolkit-neutral subset of the GTK generic
+ * tools that maps onto a NativeScript view tree): get_status, list_toplevels,
+ * dump_tree, get_property, screenshot.
+ */
+export declare function registerNsGenericTools(ctx: NsMcpToolContext): void;
+/** A ready-made profile for a NativeScript app: generic NS tools (+ optional extras). */
+export declare function nativescriptProfile(connect?: NsCdpConnectOptions): NativescriptToolProfile;
+/**
+ * Run an MCP↔NativeScript-devtools bridge: build the server, register the
+ * generic (+ app-specific) tools, connect the CDP transport to the device, and
+ * pump the GLib main loop until the client closes stdin. Parallel to
+ * `runDevtoolsMcp` (the DBus path) but over the V8 inspector transport. Logs
+ * only to stderr so the JSON-RPC stdout stream stays clean.
+ */
+export declare function runNativescriptMcp(profile: NativescriptToolProfile): Promise<void>;

package/lib/types/transports/ns-cdp-client.d.ts

@@ -0,0 +1,44 @@
+import type { DevtoolsRequest, DevtoolsResponse } from '@gjsify/devtools-protocol';
+/** Connection target — an explicit ws url, or an inspector host:port to discover from. */
+export interface NsCdpConnectOptions {
+    /** Explicit `ws://…` CDP debugger url; skips HTTP discovery when set. */
+    url?: string;
+    /** Inspector host for `/json` discovery. Default `127.0.0.1`. */
+    host?: string;
+    /** Inspector port for `/json` discovery. Default `9222` (NS V8 `--debug-brk`/`ns debug`). */
+    port?: number;
+}
+/**
+ * Host-side transport that dials a running NativeScript app's in-app devtools
+ * agent (`globalThis.__adwDevtools`) over the V8 inspector CDP socket. The MCP
+ * bridge talks the SAME `@gjsify/devtools-protocol` contract over it as it does
+ * over DBus for GTK apps, so the generic tools are identical across runtimes.
+ */
+export declare class NsCdpClient {
+    private readonly _session;
+    private _connection;
+    private _nextId;
+    private readonly _pending;
+    private readonly _host;
+    private readonly _port;
+    private readonly _explicitUrl;
+    private readonly _decoder;
+    private readonly _encoder;
+    constructor(options?: NsCdpConnectOptions);
+    /** Open the CDP WebSocket (discovering the debugger url first if needed). */
+    connect(): Promise<void>;
+    /**
+     * Send a {@link DevtoolsRequest} to the in-app agent and resolve with its
+     * {@link DevtoolsResponse}. The agent's `dispatch` is invoked over CDP
+     * `Runtime.evaluate` and its JSON-string return is parsed back.
+     */
+    request(req: DevtoolsRequest): Promise<DevtoolsResponse>;
+    /** Close the CDP socket and reject any in-flight requests. */
+    close(): Promise<void>;
+    /** GET `http://host:port/json` and return the first target's debugger url. */
+    private _discoverDebuggerUrl;
+    /** Issue a raw CDP method call and resolve with its `result` object. */
+    private _call;
+    private _onMessage;
+    private _onClosed;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/devtools-mcp",
-    "version": "0.11.0",
+    "version": "0.13.0",
     "description": "MCP↔devtools bridge for GJS apps — exposes a running app's org.gjsify.Devtools control plane (DBus) to an AI agent as MCP tools",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -38,13 +38,15 @@
         "@girs/giounix-2.0": "2.0.0-4.0.4",
         "@girs/gjs": "4.0.4",
         "@girs/glib-2.0": "2.88.0-4.0.4",
-        "@gjsify/devtools-protocol": "^0.11.0",
+        "@girs/soup-3.0": "3.6.6-4.0.4",
+        "@gjsify/devtools-cdp": "^0.13.0",
+        "@gjsify/devtools-protocol": "^0.13.0",
         "@modelcontextprotocol/sdk": "^1.29.0",
         "zod": "^4.4.3"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.11.0",
-        "@gjsify/unit": "^0.11.0",
+        "@gjsify/cli": "^0.13.0",
+        "@gjsify/unit": "^0.13.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },