@llui/mcp 0.0.22 → 0.0.24

package/dist/tools/source.js

@@ -0,0 +1,152 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { findWorkspaceRoot } from '../index.js';
+export function registerSourceTools(registry) {
+    registry.register({
+        name: 'llui_find_msg_producers',
+        description: 'Find all send({type: "msgType"}) call sites in the project source. Returns file path, line, column, and surrounding context for each hit.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                msgType: { type: 'string', description: 'The Msg variant type string to search for' },
+                rootDir: {
+                    type: 'string',
+                    description: 'Root directory to search (defaults to workspace root)',
+                },
+            },
+            required: ['msgType'],
+        },
+    }, 'source', async (args, _ctx) => {
+        const msgType = args.msgType;
+        const rootDir = args.rootDir ?? findWorkspaceRoot();
+        const pattern = `send\\(\\{[^}]*type:\\s*['"]${msgType}['"]`;
+        const hits = grepHits(pattern, rootDir, ['*.ts', '*.tsx']);
+        return { msgType, hits };
+    });
+    registry.register({
+        name: 'llui_find_msg_handlers',
+        description: 'Find all update() function branches that handle a specific Msg variant. Returns file, line, column, and context for each case arm.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                msgType: { type: 'string', description: 'The Msg variant type string to search for' },
+                rootDir: {
+                    type: 'string',
+                    description: 'Root directory to search (defaults to workspace root)',
+                },
+            },
+            required: ['msgType'],
+        },
+    }, 'source', async (args, _ctx) => {
+        const msgType = args.msgType;
+        const rootDir = args.rootDir ?? findWorkspaceRoot();
+        const pattern = `case\\s+['"]${msgType}['"]\\s*:`;
+        const hits = grepHits(pattern, rootDir, ['*.ts', '*.tsx']);
+        return { msgType, hits };
+    });
+    registry.register({
+        name: 'llui_run_test',
+        description: 'Run a vitest test file (and optionally a specific test name). Returns pass/fail status and captured output.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                file: { type: 'string', description: 'Absolute path to the test file' },
+                testName: { type: 'string', description: 'Test name pattern to filter (-t flag)' },
+            },
+        },
+    }, 'source', async (args, _ctx) => {
+        const workspaceRoot = findWorkspaceRoot();
+        let cmd = `pnpm exec vitest run`;
+        if (args.file)
+            cmd += ` "${args.file}"`;
+        if (args.testName)
+            cmd += ` -t "${args.testName}"`;
+        try {
+            const output = execSync(cmd, {
+                cwd: workspaceRoot,
+                encoding: 'utf8',
+                timeout: 60_000,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            return { passed: true, output: output.slice(-4000) };
+        }
+        catch (err) {
+            const e = err;
+            const output = ((e.stdout ?? '') + (e.stderr ?? '')).slice(-4000);
+            return { passed: false, output: output || e.message || 'Test failed' };
+        }
+    });
+    registry.register({
+        name: 'llui_lint_project',
+        description: 'Run @llui/eslint-plugin rules across all TypeScript files in a directory. Returns a 0–20 idiomatic score, violation count, and per-file violations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                rootDir: {
+                    type: 'string',
+                    description: 'Directory to lint (defaults to workspace root)',
+                },
+            },
+        },
+    }, 'source', async (args, _ctx) => {
+        const rootDir = args.rootDir ?? findWorkspaceRoot();
+        const workspaceRoot = findWorkspaceRoot();
+        const target = resolve(rootDir, '**/*.{ts,tsx}');
+        const cmd = `pnpm exec eslint --format json "${target}"`;
+        try {
+            const output = execSync(cmd, {
+                cwd: workspaceRoot,
+                encoding: 'utf8',
+                timeout: 60_000,
+            });
+            return parseEslintOutput(output);
+        }
+        catch (err) {
+            const e = err;
+            if (e.stdout) {
+                try {
+                    return parseEslintOutput(e.stdout);
+                }
+                catch {
+                    // fall through
+                }
+            }
+            return { score: 0, violations: [], fileCount: 0, error: 'ESLint failed' };
+        }
+    });
+}
+function grepHits(pattern, rootDir, globs) {
+    if (!existsSync(rootDir))
+        return [];
+    const globArgs = globs.map((g) => `--include="${g}"`).join(' ');
+    try {
+        const out = execSync(`grep -rn --color=never -E ${globArgs} "${pattern}" "${rootDir}"`, {
+            encoding: 'utf8',
+            timeout: 15_000,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        return out
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            const m = /^(.+?):(\d+):(.+)$/.exec(line);
+            if (!m)
+                return null;
+            return { file: m[1], line: Number(m[2]), column: 1, context: m[3].trim() };
+        })
+            .filter((x) => x !== null)
+            .slice(0, 100);
+    }
+    catch {
+        return [];
+    }
+}
+function parseEslintOutput(output) {
+    const results = JSON.parse(output);
+    const violations = results.flatMap((r) => r.messages);
+    const fileCount = results.length;
+    const score = Math.max(0, 20 - violations.length);
+    return { score, violations, fileCount };
+}
+//# sourceMappingURL=source.js.map

package/dist/tools/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/tools/source.ts"],"names":[],"mappings":"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","sourcesContent":["import { execSync } from 'node:child_process'\nimport { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport type { ToolRegistry } from '../tool-registry.js'\nimport { findWorkspaceRoot } from '../index.js'\n\nexport function registerSourceTools(registry: ToolRegistry): void {\n  registry.register(\n    {\n      name: 'llui_find_msg_producers',\n      description:\n        'Find all send({type: \"msgType\"}) call sites in the project source. Returns file path, line, column, and surrounding context for each hit.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          msgType: { type: 'string', description: 'The Msg variant type string to search for' },\n          rootDir: {\n            type: 'string',\n            description: 'Root directory to search (defaults to workspace root)',\n          },\n        },\n        required: ['msgType'],\n      },\n    },\n    'source',\n    async (args, _ctx) => {\n      const msgType = args.msgType as string\n      const rootDir = (args.rootDir as string | undefined) ?? findWorkspaceRoot()\n      const pattern = `send\\\\(\\\\{[^}]*type:\\\\s*['\"]${msgType}['\"]`\n      const hits = grepHits(pattern, rootDir, ['*.ts', '*.tsx'])\n      return { msgType, hits }\n    },\n  )\n\n  registry.register(\n    {\n      name: 'llui_find_msg_handlers',\n      description:\n        'Find all update() function branches that handle a specific Msg variant. Returns file, line, column, and context for each case arm.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          msgType: { type: 'string', description: 'The Msg variant type string to search for' },\n          rootDir: {\n            type: 'string',\n            description: 'Root directory to search (defaults to workspace root)',\n          },\n        },\n        required: ['msgType'],\n      },\n    },\n    'source',\n    async (args, _ctx) => {\n      const msgType = args.msgType as string\n      const rootDir = (args.rootDir as string | undefined) ?? findWorkspaceRoot()\n      const pattern = `case\\\\s+['\"]${msgType}['\"]\\\\s*:`\n      const hits = grepHits(pattern, rootDir, ['*.ts', '*.tsx'])\n      return { msgType, hits }\n    },\n  )\n\n  registry.register(\n    {\n      name: 'llui_run_test',\n      description:\n        'Run a vitest test file (and optionally a specific test name). Returns pass/fail status and captured output.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          file: { type: 'string', description: 'Absolute path to the test file' },\n          testName: { type: 'string', description: 'Test name pattern to filter (-t flag)' },\n        },\n      },\n    },\n    'source',\n    async (args, _ctx) => {\n      const workspaceRoot = findWorkspaceRoot()\n      let cmd = `pnpm exec vitest run`\n      if (args.file) cmd += ` \"${args.file as string}\"`\n      if (args.testName) cmd += ` -t \"${args.testName as string}\"`\n      try {\n        const output = execSync(cmd, {\n          cwd: workspaceRoot,\n          encoding: 'utf8',\n          timeout: 60_000,\n          stdio: ['ignore', 'pipe', 'pipe'],\n        })\n        return { passed: true, output: output.slice(-4000) }\n      } catch (err: unknown) {\n        const e = err as { stdout?: string; stderr?: string; message?: string }\n        const output = ((e.stdout ?? '') + (e.stderr ?? '')).slice(-4000)\n        return { passed: false, output: output || e.message || 'Test failed' }\n      }\n    },\n  )\n\n  registry.register(\n    {\n      name: 'llui_lint_project',\n      description:\n        'Run @llui/eslint-plugin rules across all TypeScript files in a directory. Returns a 0–20 idiomatic score, violation count, and per-file violations.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          rootDir: {\n            type: 'string',\n            description: 'Directory to lint (defaults to workspace root)',\n          },\n        },\n      },\n    },\n    'source',\n    async (args, _ctx) => {\n      const rootDir = (args.rootDir as string | undefined) ?? findWorkspaceRoot()\n      const workspaceRoot = findWorkspaceRoot()\n      const target = resolve(rootDir, '**/*.{ts,tsx}')\n      const cmd = `pnpm exec eslint --format json \"${target}\"`\n      try {\n        const output = execSync(cmd, {\n          cwd: workspaceRoot,\n          encoding: 'utf8',\n          timeout: 60_000,\n        })\n        return parseEslintOutput(output)\n      } catch (err: unknown) {\n        const e = err as { stdout?: string }\n        if (e.stdout) {\n          try {\n            return parseEslintOutput(e.stdout)\n          } catch {\n            // fall through\n          }\n        }\n        return { score: 0, violations: [], fileCount: 0, error: 'ESLint failed' }\n      }\n    },\n  )\n}\n\ninterface GrepHit {\n  file: string\n  line: number\n  column: number\n  context: string\n}\n\nfunction grepHits(pattern: string, rootDir: string, globs: string[]): GrepHit[] {\n  if (!existsSync(rootDir)) return []\n  const globArgs = globs.map((g) => `--include=\"${g}\"`).join(' ')\n  try {\n    const out = execSync(`grep -rn --color=never -E ${globArgs} \"${pattern}\" \"${rootDir}\"`, {\n      encoding: 'utf8',\n      timeout: 15_000,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    })\n    return out\n      .split('\\n')\n      .filter(Boolean)\n      .map((line) => {\n        const m = /^(.+?):(\\d+):(.+)$/.exec(line)\n        if (!m) return null\n        return { file: m[1]!, line: Number(m[2]), column: 1, context: m[3]!.trim() }\n      })\n      .filter((x): x is GrepHit => x !== null)\n      .slice(0, 100)\n  } catch {\n    return []\n  }\n}\n\nfunction parseEslintOutput(output: string): {\n  score: number\n  violations: unknown[]\n  fileCount: number\n} {\n  const results = JSON.parse(output) as Array<{ filePath: string; messages: unknown[] }>\n  const violations = results.flatMap((r) => r.messages)\n  const fileCount = results.length\n  const score = Math.max(0, 20 - violations.length)\n  return { score, violations, fileCount }\n}\n"]}

package/dist/tools/ssr.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistry } from '../tool-registry.js';
+export declare function registerSsrTools(registry: ToolRegistry): void;
+//# sourceMappingURL=ssr.d.ts.map

package/dist/tools/ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../src/tools/ssr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA6E7D"}

package/dist/tools/ssr.js

@@ -0,0 +1,58 @@
+export function registerSsrTools(registry) {
+    registry.register({
+        name: 'llui_hydration_report',
+        description: 'Compare the server-rendered HTML (from @llui/vike) against the current client DOM and return divergences. Each divergence includes the DOM path, kind (attribute/text/structural), and the server vs client values. Returns an empty array when hydration is clean.',
+        inputSchema: { type: 'object', properties: {} },
+    }, 'debug-api', async (_args, ctx) => {
+        const divergences = await ctx.relay.call('getHydrationReport', []);
+        return { divergences };
+    });
+    registry.register({
+        name: 'llui_ssr_render',
+        description: 'Server-render the active component using its current state and return the resulting HTML string. Requires @llui/vike to be installed. Useful for verifying that the server output matches what you expect before hydration.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                state: {
+                    type: 'object',
+                    description: 'State override (defaults to current component state)',
+                },
+            },
+        },
+    }, 'debug-api', async (args, ctx) => {
+        const currentState = args.state ?? (await ctx.relay.call('getState', []));
+        const componentInfo = (await ctx.relay.call('getComponentInfo', []));
+        if (!componentInfo?.file) {
+            return {
+                ok: false,
+                error: 'component_file_unknown',
+                hint: 'Component file path not available — ensure @llui/vite-plugin emits __componentMeta in dev mode.',
+            };
+        }
+        try {
+            // Use Function-based dynamic import to avoid Vite static analysis
+            // at transform time. @llui/vike is an optional peer dep — we must
+            // not let the bundler try to resolve it unconditionally.
+            const dynamicImport = new Function('specifier', 'return import(specifier)');
+            const vikeModule = (await dynamicImport('@llui/vike'));
+            const pageModule = (await dynamicImport(componentInfo.file));
+            const pageContext = {
+                Page: pageModule.default,
+                pageProps: { initialState: currentState },
+                urlOriginal: '/',
+                headersOriginal: {},
+            };
+            const result = await vikeModule.onRenderHtml(pageContext);
+            return { ok: true, html: String(result.documentHtml) };
+        }
+        catch (err) {
+            const e = err;
+            return {
+                ok: false,
+                error: 'ssr_render_failed',
+                hint: e.message ?? 'Unknown error',
+            };
+        }
+    });
+}
+//# sourceMappingURL=ssr.js.map

package/dist/tools/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","sourceRoot":"","sources":["../../src/tools/ssr.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,QAAQ,CAAC,QAAQ,CACf;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,qQAAqQ;QACvQ,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD,EACD,WAAW,EACX,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,KAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;QACnE,OAAO,EAAE,WAAW,EAAE,CAAA;IACxB,CAAC,CACF,CAAA;IAED,QAAQ,CAAC,QAAQ,CACf;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,6NAA6N;QAC/N,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;aACF;SACF;KACF,EACD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,KAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAA;QAC1E,MAAM,aAAa,GAAG,CAAC,MAAM,GAAG,CAAC,KAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAG5D,CAAA;QAER,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;YACzB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,wBAAwB;gBAC/B,IAAI,EAAE,iGAAiG;aACxG,CAAA;QACH,CAAC;QAED,IAAI,CAAC;YACH,kEAAkE;YAClE,kEAAkE;YAClE,yDAAyD;YACzD,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAErD,CAAA;YACrB,MAAM,UAAU,GAAG,CAAC,MAAM,aAAa,CAAC,YAAY,CAAC,CAEpD,CAAA;YACD,MAAM,UAAU,GAAG,CAAC,MAAM,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAE1D,CAAA;YACD,MAAM,WAAW,GAAG;gBAClB,IAAI,EAAE,UAAU,CAAC,OAAO;gBACxB,SAAS,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE;gBACzC,WAAW,EAAE,GAAG;gBAChB,eAAe,EAAE,EAAE;aACpB,CAAA;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;YACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;QACxD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,GAA2B,CAAA;YACrC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,mBAAmB;gBAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,IAAI,eAAe;aACnC,CAAA;QACH,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC","sourcesContent":["import type { ToolRegistry } from '../tool-registry.js'\n\nexport function registerSsrTools(registry: ToolRegistry): void {\n  registry.register(\n    {\n      name: 'llui_hydration_report',\n      description:\n        'Compare the server-rendered HTML (from @llui/vike) against the current client DOM and return divergences. Each divergence includes the DOM path, kind (attribute/text/structural), and the server vs client values. Returns an empty array when hydration is clean.',\n      inputSchema: { type: 'object', properties: {} },\n    },\n    'debug-api',\n    async (_args, ctx) => {\n      const divergences = await ctx.relay!.call('getHydrationReport', [])\n      return { divergences }\n    },\n  )\n\n  registry.register(\n    {\n      name: 'llui_ssr_render',\n      description:\n        'Server-render the active component using its current state and return the resulting HTML string. Requires @llui/vike to be installed. Useful for verifying that the server output matches what you expect before hydration.',\n      inputSchema: {\n        type: 'object',\n        properties: {\n          state: {\n            type: 'object',\n            description: 'State override (defaults to current component state)',\n          },\n        },\n      },\n    },\n    'debug-api',\n    async (args, ctx) => {\n      const currentState = args.state ?? (await ctx.relay!.call('getState', []))\n      const componentInfo = (await ctx.relay!.call('getComponentInfo', [])) as {\n        name: string\n        file: string | null\n      } | null\n\n      if (!componentInfo?.file) {\n        return {\n          ok: false,\n          error: 'component_file_unknown',\n          hint: 'Component file path not available — ensure @llui/vite-plugin emits __componentMeta in dev mode.',\n        }\n      }\n\n      try {\n        // Use Function-based dynamic import to avoid Vite static analysis\n        // at transform time. @llui/vike is an optional peer dep — we must\n        // not let the bundler try to resolve it unconditionally.\n        const dynamicImport = new Function('specifier', 'return import(specifier)') as (\n          s: string,\n        ) => Promise<unknown>\n        const vikeModule = (await dynamicImport('@llui/vike')) as {\n          onRenderHtml: (ctx: unknown) => Promise<{ documentHtml: unknown }>\n        }\n        const pageModule = (await dynamicImport(componentInfo.file)) as {\n          default: unknown\n        }\n        const pageContext = {\n          Page: pageModule.default,\n          pageProps: { initialState: currentState },\n          urlOriginal: '/',\n          headersOriginal: {},\n        }\n        const result = await vikeModule.onRenderHtml(pageContext)\n        return { ok: true, html: String(result.documentHtml) }\n      } catch (err: unknown) {\n        const e = err as { message?: string }\n        return {\n          ok: false,\n          error: 'ssr_render_failed',\n          hint: e.message ?? 'Unknown error',\n        }\n      }\n    },\n  )\n}\n"]}

package/dist/transports/cdp.d.ts

@@ -0,0 +1,51 @@
+import type { CdpTransport, ConsoleEntry, NetworkEntry, ErrorEntry } from '../tool-registry.js';
+interface CdpSession {
+    mode: 'user-chrome' | 'playwright-owned';
+    browser: import('playwright').Browser | null;
+    page: import('playwright').Page;
+    consoleBuffer: ConsoleEntry[];
+    networkBuffer: NetworkEntry[];
+    errorBuffer: ErrorEntry[];
+}
+export declare class CdpSessionManager implements CdpTransport {
+    private session;
+    private devUrl;
+    private headed;
+    constructor(opts?: {
+        devUrl?: string | null;
+        headed?: boolean;
+    });
+    setDevUrl(url: string): void;
+    setHeaded(v: boolean): void;
+    isAvailable(): boolean;
+    call(domain: string, method: string, params?: Record<string, unknown>): Promise<unknown>;
+    screenshot(opts: {
+        selector?: string;
+        fullPage?: boolean;
+        format?: 'png' | 'jpeg';
+    }): Promise<{
+        data: string;
+        format: string;
+        mimeType: string;
+    }>;
+    accessibilitySnapshot(opts: {
+        selector?: string;
+        interestingOnly?: boolean;
+    }): Promise<unknown>;
+    getConsoleBuffer(limit?: number, level?: string): ConsoleEntry[];
+    getNetworkBuffer(limit?: number, filter?: {
+        urlPattern?: string;
+        status?: number;
+    }): NetworkEntry[];
+    getErrorBuffer(limit?: number): ErrorEntry[];
+    closeBrowser(): Promise<{
+        closed: boolean;
+        reason?: string;
+    }>;
+    private resolveDevUrl;
+    private attachListeners;
+    private buildSession;
+    ensureSession(): Promise<CdpSession>;
+}
+export {};
+//# sourceMappingURL=cdp.d.ts.map

package/dist/transports/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../src/transports/cdp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAgB/F,UAAU,UAAU;IAClB,IAAI,EAAE,aAAa,GAAG,kBAAkB,CAAA;IACxC,OAAO,EAAE,OAAO,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5C,IAAI,EAAE,OAAO,YAAY,EAAE,IAAI,CAAA;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,aAAa,EAAE,YAAY,EAAE,CAAA;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAOD,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;IAKnE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAK3B,WAAW,IAAI,OAAO;IAIhB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAaxF,UAAU,CAAC,IAAI,EAAE;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;KACxB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAazD,qBAAqB,CAAC,IAAI,EAAE;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAOhE,gBAAgB,CACd,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,YAAY,EAAE;IAajB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAMtC,YAAY,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAUnE,OAAO,CAAC,aAAa;YASP,eAAe;YA0Ef,YAAY;IAiBpB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;CAiE3C"}

package/dist/transports/cdp.js

@@ -0,0 +1,237 @@
+class CdpError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'CdpError';
+    }
+}
+function pushBounded(arr, item, max) {
+    arr.push(item);
+    if (arr.length > max)
+        arr.shift();
+}
+export class CdpSessionManager {
+    session = null;
+    devUrl;
+    headed;
+    constructor(opts = {}) {
+        this.devUrl = opts.devUrl ?? null;
+        this.headed = opts.headed ?? false;
+    }
+    setDevUrl(url) {
+        this.devUrl = url;
+        this.session = null;
+    }
+    setHeaded(v) {
+        this.headed = v;
+        this.session = null;
+    }
+    isAvailable() {
+        return this.session !== null;
+    }
+    async call(domain, method, params) {
+        const s = await this.ensureSession();
+        const cdpSession = await s.page.context().newCDPSession(s.page);
+        try {
+            return await cdpSession.send(`${domain}.${method}`, params);
+        }
+        finally {
+            await cdpSession.detach().catch(() => { });
+        }
+    }
+    async screenshot(opts) {
+        const s = await this.ensureSession();
+        const fmt = opts.format ?? 'png';
+        let buf;
+        if (opts.selector) {
+            const el = s.page.locator(opts.selector);
+            buf = await el.screenshot({ type: fmt });
+        }
+        else {
+            buf = await s.page.screenshot({ type: fmt, fullPage: opts.fullPage ?? false });
+        }
+        return { data: buf.toString('base64'), format: fmt, mimeType: `image/${fmt}` };
+    }
+    async accessibilitySnapshot(opts) {
+        const s = await this.ensureSession();
+        if (opts.selector) {
+            return s.page.locator(opts.selector).ariaSnapshot();
+        }
+        return s.page.ariaSnapshot();
+    }
+    getConsoleBuffer(limit, level) {
+        if (!this.session)
+            return [];
+        let items = this.session.consoleBuffer;
+        if (level)
+            items = items.filter((e) => e.level === level);
+        return limit != null ? items.slice(-limit) : items;
+    }
+    getNetworkBuffer(limit, filter) {
+        if (!this.session)
+            return [];
+        let items = this.session.networkBuffer;
+        if (filter?.urlPattern) {
+            const re = new RegExp(filter.urlPattern);
+            items = items.filter((e) => re.test(e.url));
+        }
+        if (filter?.status != null) {
+            items = items.filter((e) => e.status === filter.status);
+        }
+        return limit != null ? items.slice(-limit) : items;
+    }
+    getErrorBuffer(limit) {
+        if (!this.session)
+            return [];
+        const items = this.session.errorBuffer;
+        return limit != null ? items.slice(-limit) : items;
+    }
+    async closeBrowser() {
+        if (!this.session)
+            return { closed: false, reason: 'no_session' };
+        if (this.session.mode === 'user-chrome') {
+            return { closed: false, reason: 'user_owns_browser' };
+        }
+        await this.session.browser.close().catch(() => { });
+        this.session = null;
+        return { closed: true };
+    }
+    resolveDevUrl() {
+        if (!this.devUrl)
+            return null;
+        try {
+            return new URL(this.devUrl);
+        }
+        catch {
+            return null;
+        }
+    }
+    async attachListeners(page, session) {
+        page.on('console', (msg) => {
+            pushBounded(session.consoleBuffer, {
+                level: msg.type(),
+                text: msg.text(),
+                timestamp: Date.now(),
+            }, 500);
+        });
+        page.on('pageerror', (err) => {
+            pushBounded(session.errorBuffer, {
+                text: err.message,
+                stack: err.stack ?? '',
+                timestamp: Date.now(),
+            }, 200);
+        });
+        page.on('request', (req) => {
+            const entry = {
+                requestId: req.url() + Date.now(),
+                url: req.url(),
+                method: req.method(),
+                status: null,
+                startTime: Date.now(),
+                endTime: null,
+                durationMs: null,
+                failed: false,
+            };
+            pushBounded(session.networkBuffer, entry, 500);
+        });
+        page.on('response', (res) => {
+            const buf = session.networkBuffer;
+            let last;
+            for (let i = buf.length - 1; i >= 0; i--) {
+                const e = buf[i];
+                if (e !== undefined && e.url === res.url() && e.status === null) {
+                    last = e;
+                    break;
+                }
+            }
+            if (last) {
+                last.status = res.status();
+                last.endTime = Date.now();
+                last.durationMs = last.endTime - last.startTime;
+            }
+        });
+        page.on('requestfailed', (req) => {
+            const buf = session.networkBuffer;
+            let last;
+            for (let i = buf.length - 1; i >= 0; i--) {
+                const e = buf[i];
+                if (e !== undefined && e.url === req.url() && e.status === null) {
+                    last = e;
+                    break;
+                }
+            }
+            if (last) {
+                last.failed = true;
+                last.failureReason = req.failure()?.errorText;
+                last.endTime = Date.now();
+                last.durationMs = last.endTime - last.startTime;
+            }
+        });
+    }
+    async buildSession(page, browser, mode) {
+        const s = {
+            mode,
+            browser,
+            page,
+            consoleBuffer: [],
+            networkBuffer: [],
+            errorBuffer: [],
+        };
+        await this.attachListeners(page, s);
+        return s;
+    }
+    async ensureSession() {
+        if (this.session)
+            return this.session;
+        const url = this.resolveDevUrl();
+        if (!url)
+            throw new CdpError('dev_url_unknown', 'No dev URL. Pass --url <devUrl> or set via Vite plugin.');
+        try {
+            const ctrl = new AbortController();
+            const t = setTimeout(() => ctrl.abort(), 200);
+            const resp = await fetch('http://127.0.0.1:9222/json/version', {
+                signal: ctrl.signal,
+            }).finally(() => clearTimeout(t));
+            if (resp.ok) {
+                const listResp = await fetch('http://127.0.0.1:9222/json/list');
+                const targets = (await listResp.json());
+                const target = targets.find((t) => t.url?.includes(url.host));
+                if (target) {
+                    const pw = await import('playwright');
+                    const browser = await pw.chromium.connectOverCDP('http://127.0.0.1:9222');
+                    const pages = browser.contexts().flatMap((c) => c.pages());
+                    const page = pages.find((p) => p.url().includes(url.host)) ?? pages[0];
+                    if (page) {
+                        this.session = await this.buildSession(page, browser, 'user-chrome');
+                        return this.session;
+                    }
+                    await browser.close();
+                }
+            }
+        }
+        catch {
+            // fall through to Playwright fallback
+        }
+        let pw;
+        try {
+            pw = await import('playwright');
+        }
+        catch {
+            throw new CdpError('cdp_unavailable', 'Playwright not installed. Run: npm install playwright && npx playwright install chromium');
+        }
+        const browser = await pw.chromium.launch({ headless: !this.headed });
+        const page = await browser.newPage();
+        await page.goto(url.href);
+        try {
+            await page.waitForFunction(() => typeof globalThis.__lluiDebug !== 'undefined', { timeout: 10_000 });
+        }
+        catch {
+            await browser.close();
+            throw new CdpError('attach_timeout', `App not ready at ${url.href} within 10s`);
+        }
+        this.session = await this.buildSession(page, browser, 'playwright-owned');
+        return this.session;
+    }
+}
+//# sourceMappingURL=cdp.js.map

package/dist/transports/cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../src/transports/cdp.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CdpTransport, ConsoleEntry, NetworkEntry, ErrorEntry } from '../tool-registry.js'\n\nclass CdpError extends Error {\n  constructor(\n    public readonly code:\n      | 'cdp_unavailable'\n      | 'dev_url_unknown'\n      | 'attach_timeout'\n      | 'browser_crashed',\n    message: string,\n  ) {\n    super(message)\n    this.name = 'CdpError'\n  }\n}\n\ninterface CdpSession {\n  mode: 'user-chrome' | 'playwright-owned'\n  browser: import('playwright').Browser | null\n  page: import('playwright').Page\n  consoleBuffer: ConsoleEntry[]\n  networkBuffer: NetworkEntry[]\n  errorBuffer: ErrorEntry[]\n}\n\nfunction pushBounded<T>(arr: T[], item: T, max: number): void {\n  arr.push(item)\n  if (arr.length > max) arr.shift()\n}\n\nexport class CdpSessionManager implements CdpTransport {\n  private session: CdpSession | null = null\n  private devUrl: string | null\n  private headed: boolean\n\n  constructor(opts: { devUrl?: string | null; headed?: boolean } = {}) {\n    this.devUrl = opts.devUrl ?? null\n    this.headed = opts.headed ?? false\n  }\n\n  setDevUrl(url: string): void {\n    this.devUrl = url\n    this.session = null\n  }\n\n  setHeaded(v: boolean): void {\n    this.headed = v\n    this.session = null\n  }\n\n  isAvailable(): boolean {\n    return this.session !== null\n  }\n\n  async call(domain: string, method: string, params?: Record<string, unknown>): Promise<unknown> {\n    const s = await this.ensureSession()\n    const cdpSession = await s.page.context().newCDPSession(s.page)\n    try {\n      return await cdpSession.send(\n        `${domain}.${method}` as Parameters<typeof cdpSession.send>[0],\n        params,\n      )\n    } finally {\n      await cdpSession.detach().catch(() => {})\n    }\n  }\n\n  async screenshot(opts: {\n    selector?: string\n    fullPage?: boolean\n    format?: 'png' | 'jpeg'\n  }): Promise<{ data: string; format: string; mimeType: string }> {\n    const s = await this.ensureSession()\n    const fmt = opts.format ?? 'png'\n    let buf: Buffer\n    if (opts.selector) {\n      const el = s.page.locator(opts.selector)\n      buf = await el.screenshot({ type: fmt })\n    } else {\n      buf = await s.page.screenshot({ type: fmt, fullPage: opts.fullPage ?? false })\n    }\n    return { data: buf.toString('base64'), format: fmt, mimeType: `image/${fmt}` }\n  }\n\n  async accessibilitySnapshot(opts: {\n    selector?: string\n    interestingOnly?: boolean\n  }): Promise<unknown> {\n    const s = await this.ensureSession()\n    if (opts.selector) {\n      return s.page.locator(opts.selector).ariaSnapshot()\n    }\n    return s.page.ariaSnapshot()\n  }\n\n  getConsoleBuffer(limit?: number, level?: string): ConsoleEntry[] {\n    if (!this.session) return []\n    let items = this.session.consoleBuffer\n    if (level) items = items.filter((e) => e.level === level)\n    return limit != null ? items.slice(-limit) : items\n  }\n\n  getNetworkBuffer(\n    limit?: number,\n    filter?: { urlPattern?: string; status?: number },\n  ): NetworkEntry[] {\n    if (!this.session) return []\n    let items = this.session.networkBuffer\n    if (filter?.urlPattern) {\n      const re = new RegExp(filter.urlPattern)\n      items = items.filter((e) => re.test(e.url))\n    }\n    if (filter?.status != null) {\n      items = items.filter((e) => e.status === filter.status)\n    }\n    return limit != null ? items.slice(-limit) : items\n  }\n\n  getErrorBuffer(limit?: number): ErrorEntry[] {\n    if (!this.session) return []\n    const items = this.session.errorBuffer\n    return limit != null ? items.slice(-limit) : items\n  }\n\n  async closeBrowser(): Promise<{ closed: boolean; reason?: string }> {\n    if (!this.session) return { closed: false, reason: 'no_session' }\n    if (this.session.mode === 'user-chrome') {\n      return { closed: false, reason: 'user_owns_browser' }\n    }\n    await this.session.browser!.close().catch(() => {})\n    this.session = null\n    return { closed: true }\n  }\n\n  private resolveDevUrl(): URL | null {\n    if (!this.devUrl) return null\n    try {\n      return new URL(this.devUrl)\n    } catch {\n      return null\n    }\n  }\n\n  private async attachListeners(\n    page: import('playwright').Page,\n    session: CdpSession,\n  ): Promise<void> {\n    page.on('console', (msg) => {\n      pushBounded(\n        session.consoleBuffer,\n        {\n          level: msg.type() as ConsoleEntry['level'],\n          text: msg.text(),\n          timestamp: Date.now(),\n        },\n        500,\n      )\n    })\n    page.on('pageerror', (err) => {\n      pushBounded(\n        session.errorBuffer,\n        {\n          text: err.message,\n          stack: err.stack ?? '',\n          timestamp: Date.now(),\n        },\n        200,\n      )\n    })\n    page.on('request', (req) => {\n      const entry: NetworkEntry = {\n        requestId: req.url() + Date.now(),\n        url: req.url(),\n        method: req.method(),\n        status: null,\n        startTime: Date.now(),\n        endTime: null,\n        durationMs: null,\n        failed: false,\n      }\n      pushBounded(session.networkBuffer, entry, 500)\n    })\n    page.on('response', (res) => {\n      const buf = session.networkBuffer\n      let last: NetworkEntry | undefined\n      for (let i = buf.length - 1; i >= 0; i--) {\n        const e = buf[i]\n        if (e !== undefined && e.url === res.url() && e.status === null) {\n          last = e\n          break\n        }\n      }\n      if (last) {\n        last.status = res.status()\n        last.endTime = Date.now()\n        last.durationMs = last.endTime - last.startTime\n      }\n    })\n    page.on('requestfailed', (req) => {\n      const buf = session.networkBuffer\n      let last: NetworkEntry | undefined\n      for (let i = buf.length - 1; i >= 0; i--) {\n        const e = buf[i]\n        if (e !== undefined && e.url === req.url() && e.status === null) {\n          last = e\n          break\n        }\n      }\n      if (last) {\n        last.failed = true\n        last.failureReason = req.failure()?.errorText\n        last.endTime = Date.now()\n        last.durationMs = last.endTime - last.startTime\n      }\n    })\n  }\n\n  private async buildSession(\n    page: import('playwright').Page,\n    browser: import('playwright').Browser | null,\n    mode: CdpSession['mode'],\n  ): Promise<CdpSession> {\n    const s: CdpSession = {\n      mode,\n      browser,\n      page,\n      consoleBuffer: [],\n      networkBuffer: [],\n      errorBuffer: [],\n    }\n    await this.attachListeners(page, s)\n    return s\n  }\n\n  async ensureSession(): Promise<CdpSession> {\n    if (this.session) return this.session\n\n    const url = this.resolveDevUrl()\n    if (!url)\n      throw new CdpError(\n        'dev_url_unknown',\n        'No dev URL. Pass --url <devUrl> or set via Vite plugin.',\n      )\n\n    try {\n      const ctrl = new AbortController()\n      const t = setTimeout(() => ctrl.abort(), 200)\n      const resp = await fetch('http://127.0.0.1:9222/json/version', {\n        signal: ctrl.signal,\n      }).finally(() => clearTimeout(t))\n      if (resp.ok) {\n        const listResp = await fetch('http://127.0.0.1:9222/json/list')\n        const targets = (await listResp.json()) as Array<{\n          url?: string\n          webSocketDebuggerUrl?: string\n        }>\n        const target = targets.find((t) => t.url?.includes(url.host))\n        if (target) {\n          const pw = await import('playwright')\n          const browser = await pw.chromium.connectOverCDP('http://127.0.0.1:9222')\n          const pages = browser.contexts().flatMap((c) => c.pages())\n          const page = pages.find((p) => p.url().includes(url.host)) ?? pages[0]\n          if (page) {\n            this.session = await this.buildSession(page, browser, 'user-chrome')\n            return this.session\n          }\n          await browser.close()\n        }\n      }\n    } catch {\n      // fall through to Playwright fallback\n    }\n\n    let pw: typeof import('playwright')\n    try {\n      pw = await import('playwright')\n    } catch {\n      throw new CdpError(\n        'cdp_unavailable',\n        'Playwright not installed. Run: npm install playwright && npx playwright install chromium',\n      )\n    }\n\n    const browser = await pw.chromium.launch({ headless: !this.headed })\n    const page = await browser.newPage()\n    await page.goto(url.href)\n    try {\n      await page.waitForFunction(\n        () => typeof (globalThis as Record<string, unknown>).__lluiDebug !== 'undefined',\n        { timeout: 10_000 },\n      )\n    } catch {\n      await browser.close()\n      throw new CdpError('attach_timeout', `App not ready at ${url.href} within 10s`)\n    }\n\n    this.session = await this.buildSession(page, browser, 'playwright-owned')\n    return this.session\n  }\n}\n"]}

package/dist/transports/index.d.ts

@@ -1,3 +1,4 @@
 export { WebSocketRelayTransport, RelayUnavailableError } from './relay.js';
 export type { RelayTransportOptions, BridgeDiagnostic } from './relay.js';
+export { CdpSessionManager } from './cdp.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/transports/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC3E,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC3E,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA"}

package/dist/transports/index.js

@@ -1,2 +1,3 @@
 export { WebSocketRelayTransport, RelayUnavailableError } from './relay.js';
+export { CdpSessionManager } from './cdp.js';
 //# sourceMappingURL=index.js.map

package/dist/transports/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA","sourcesContent":["export { WebSocketRelayTransport, RelayUnavailableError } from './relay.js'\nexport type { RelayTransportOptions, BridgeDiagnostic } from './relay.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAE3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA","sourcesContent":["export { WebSocketRelayTransport, RelayUnavailableError } from './relay.js'\nexport type { RelayTransportOptions, BridgeDiagnostic } from './relay.js'\nexport { CdpSessionManager } from './cdp.js'\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/mcp",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "type": "module",
   "sideEffects": false,
   "bin": {
@@ -18,12 +18,21 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ws": "^8.18.0",
-    "@llui/dom": "0.0.28",
-    "@llui/lint-idiomatic": "0.0.12"
+    "@llui/dom": "0.0.30",
+    "@llui/eslint-plugin": "0.0.14"
+  },
+  "peerDependencies": {
+    "playwright": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@types/ws": "^8.5.13"
+    "@types/ws": "^8.5.13",
+    "playwright": "*"
   },
   "description": "LLui MCP server — LLM debug tools via Model Context Protocol",
   "keywords": [