@john523100/vela-mcp 0.6.0

package/dist/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"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"}

package/dist/targets.d.ts

@@ -0,0 +1,24 @@
+export interface CdpTarget {
+    id: string;
+    type: string;
+    url: string;
+    title: string;
+    webSocketDebuggerUrl: string;
+    parentId?: string;
+}
+export interface NamedTarget extends CdpTarget {
+    name: string;
+}
+/** Pick the renderer page target, skipping devtools pages and non-page targets. */
+export declare function pickPageTarget(targets: CdpTarget[]): CdpTarget | undefined;
+/**
+ * Assign stable logical names to CDP targets.
+ * - `<webview>` guests (type "webview") -> "webview#N"
+ * - the primary window renderer -> "renderer" (the page that parents a webview, else the first page)
+ * - other pages (incl. BrowserView/WebContentsView) -> "page#N"
+ * Devtools pages and targets without a websocket URL are dropped.
+ *
+ * Note: a WebContentsView/BrowserView is indistinguishable from a window renderer via /json
+ * alone, so it surfaces as "page#N". Authoritative role labelling arrives in P2 via the dev probe.
+ */
+export declare function nameTargets(targets: CdpTarget[]): NamedTarget[];

package/dist/targets.js

@@ -0,0 +1,29 @@
+/** Pick the renderer page target, skipping devtools pages and non-page targets. */
+export function pickPageTarget(targets) {
+    return targets.find((t) => t.type === "page" && !t.url.startsWith("devtools://"));
+}
+/**
+ * Assign stable logical names to CDP targets.
+ * - `<webview>` guests (type "webview") -> "webview#N"
+ * - the primary window renderer -> "renderer" (the page that parents a webview, else the first page)
+ * - other pages (incl. BrowserView/WebContentsView) -> "page#N"
+ * Devtools pages and targets without a websocket URL are dropped.
+ *
+ * Note: a WebContentsView/BrowserView is indistinguishable from a window renderer via /json
+ * alone, so it surfaces as "page#N". Authoritative role labelling arrives in P2 via the dev probe.
+ */
+export function nameTargets(targets) {
+    const usable = targets.filter((t) => t.webSocketDebuggerUrl && !t.url.startsWith("devtools://"));
+    const webviews = usable.filter((t) => t.type === "webview");
+    const pages = usable.filter((t) => t.type === "page");
+    const webviewParentIds = new Set(webviews.map((w) => w.parentId).filter((id) => Boolean(id)));
+    const rendererId = pages.find((p) => webviewParentIds.has(p.id))?.id ?? pages[0]?.id;
+    const named = [];
+    let pageIdx = 0;
+    for (const p of pages) {
+        named.push({ ...p, name: p.id === rendererId ? "renderer" : `page#${pageIdx++}` });
+    }
+    webviews.forEach((w, i) => named.push({ ...w, name: `webview#${i}` }));
+    return named;
+}
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAaA,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,OAAoB;IACjD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAClE,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAEtD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC9B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAC1E,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAErF,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/capture.d.ts

@@ -0,0 +1,21 @@
+import { SessionRegistry } from "../session.js";
+import { CaptureRegistry, type CaptureSnapshot } from "../capture.js";
+export declare function captureStartTool(registry: SessionRegistry, capReg: CaptureRegistry, args: {
+    sessionId: string;
+    target?: string;
+    console?: boolean;
+    network?: boolean;
+}): Promise<{
+    capturing: true;
+    target: string;
+}>;
+export declare function captureReadTool(capReg: CaptureRegistry, args: {
+    sessionId: string;
+    target?: string;
+}): Promise<CaptureSnapshot>;
+export declare function captureStopTool(capReg: CaptureRegistry, args: {
+    sessionId: string;
+    target?: string;
+}): Promise<{
+    stopped: true;
+}>;

package/dist/tools/capture.js

@@ -0,0 +1,30 @@
+import { CaptureSession } from "../capture.js";
+import { CdpClient } from "../cdp.js";
+function key(sessionId, target) {
+    return `${sessionId}:${target}`;
+}
+async function resolveWs(registry, sessionId, target) {
+    const session = registry.get(sessionId);
+    const named = await new CdpClient(session.port).listNamed();
+    const t = named.find((n) => n.name === target);
+    if (!t)
+        throw new Error(`Unknown target "${target}". Available: ${named.map((n) => n.name).join(", ")}`);
+    return t.webSocketDebuggerUrl;
+}
+export async function captureStartTool(registry, capReg, args) {
+    const target = args.target ?? "renderer";
+    const ws = await resolveWs(registry, args.sessionId, target);
+    const session = await CaptureSession.start(ws, { console: args.console, network: args.network });
+    capReg.set(key(args.sessionId, target), session);
+    return { capturing: true, target };
+}
+export async function captureReadTool(capReg, args) {
+    const target = args.target ?? "renderer";
+    return capReg.get(key(args.sessionId, target)).snapshot();
+}
+export async function captureStopTool(capReg, args) {
+    const target = args.target ?? "renderer";
+    await capReg.remove(key(args.sessionId, target));
+    return { stopped: true };
+}
+//# sourceMappingURL=capture.js.map

package/dist/tools/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/tools/capture.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,cAAc,EAAwB,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,SAAS,GAAG,CAAC,SAAiB,EAAE,MAAc;IAC5C,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,QAAyB,EAAE,SAAiB,EAAE,MAAc;IACnF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5D,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,iBAAiB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzG,OAAO,CAAC,CAAC,oBAAoB,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAyB,EACzB,MAAuB,EACvB,IAAkF;IAElF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACzC,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAuB,EACvB,IAA4C;IAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAuB,EACvB,IAA4C;IAE5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACzC,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/tools/debug.d.ts

@@ -0,0 +1,50 @@
+import { SessionRegistry } from "../session.js";
+import { DebugRegistry, type PausedInfo } from "../debug.js";
+export declare function debugAttachTool(registry: SessionRegistry, debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+}): Promise<{
+    attached: true;
+    target: string;
+}>;
+export declare function debugSetBreakpointTool(debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+    urlRegex: string;
+    line: number;
+}): Promise<{
+    breakpointId: string;
+    locations: number;
+}>;
+export declare function debugWaitPausedTool(debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+    timeoutMs?: number;
+}): Promise<PausedInfo>;
+export declare function debugEvalFrameTool(debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+    frameIndex?: number;
+    expression: string;
+}): Promise<{
+    value: unknown;
+}>;
+export declare function debugStepTool(debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+    kind?: "over" | "into" | "out";
+}): Promise<{
+    stepped: "over" | "into" | "out";
+}>;
+export declare function debugResumeTool(debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+}): Promise<{
+    resumed: true;
+}>;
+export declare function debugDetachTool(debugReg: DebugRegistry, args: {
+    sessionId: string;
+    target: string;
+}): Promise<{
+    detached: true;
+}>;

package/dist/tools/debug.js

@@ -0,0 +1,65 @@
+import { DebugSession } from "../debug.js";
+import { CdpClient } from "../cdp.js";
+function key(sessionId, target) {
+    return `${sessionId}:${target}`;
+}
+/** Resolve the websocket debugger URL for a logical target ("main" → node inspector). */
+async function resolveWsUrl(registry, sessionId, target) {
+    const session = registry.get(sessionId);
+    if (target === "main") {
+        if (!session.inspectPort)
+            throw new Error("No main-process inspector port for this session");
+        // The Node inspector may need a beat to start serving /json after launch; poll briefly.
+        let lastErr;
+        for (let attempt = 0; attempt < 20; attempt++) {
+            try {
+                const list = (await (await fetch(`http://127.0.0.1:${session.inspectPort}/json`)).json());
+                const ws = list[0]?.webSocketDebuggerUrl;
+                if (ws)
+                    return ws;
+            }
+            catch (e) {
+                lastErr = e;
+            }
+            await new Promise((r) => setTimeout(r, 100));
+        }
+        throw new Error(`Main-process inspector not reachable yet${lastErr ? `: ${lastErr.message}` : ""}`);
+    }
+    const named = await new CdpClient(session.port).listNamed();
+    const t = named.find((n) => n.name === target);
+    if (!t)
+        throw new Error(`Unknown target "${target}". Available: ${named.map((n) => n.name).join(", ")}, main`);
+    return t.webSocketDebuggerUrl;
+}
+export async function debugAttachTool(registry, debugReg, args) {
+    const ws = await resolveWsUrl(registry, args.sessionId, args.target);
+    const ds = await DebugSession.attachToWs(ws);
+    debugReg.set(key(args.sessionId, args.target), ds);
+    return { attached: true, target: args.target };
+}
+export async function debugSetBreakpointTool(debugReg, args) {
+    return debugReg.get(key(args.sessionId, args.target)).setBreakpoint(args.urlRegex, args.line);
+}
+export async function debugWaitPausedTool(debugReg, args) {
+    return debugReg.get(key(args.sessionId, args.target)).waitPaused(args.timeoutMs ?? 10_000);
+}
+export async function debugEvalFrameTool(debugReg, args) {
+    const value = await debugReg
+        .get(key(args.sessionId, args.target))
+        .evalOnFrame(args.frameIndex ?? 0, args.expression);
+    return { value };
+}
+export async function debugStepTool(debugReg, args) {
+    const kind = args.kind ?? "over";
+    await debugReg.get(key(args.sessionId, args.target)).step(kind);
+    return { stepped: kind };
+}
+export async function debugResumeTool(debugReg, args) {
+    await debugReg.get(key(args.sessionId, args.target)).resume();
+    return { resumed: true };
+}
+export async function debugDetachTool(debugReg, args) {
+    await debugReg.remove(key(args.sessionId, args.target));
+    return { detached: true };
+}
+//# sourceMappingURL=debug.js.map

package/dist/tools/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/tools/debug.ts"],"names":[],"mappings":"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"}

package/dist/tools/eval.d.ts

@@ -0,0 +1,9 @@
+import { SessionRegistry } from "../session.js";
+export declare function evalTool(registry: SessionRegistry, args: {
+    sessionId: string;
+    expression: string;
+    awaitPromise?: boolean;
+    target?: string;
+}): Promise<{
+    value: unknown;
+}>;

package/dist/tools/eval.js

@@ -0,0 +1,7 @@
+import { CdpClient } from "../cdp.js";
+export async function evalTool(registry, args) {
+    const session = registry.get(args.sessionId);
+    const cdp = new CdpClient(session.port);
+    return cdp.evaluate(args.expression, args.awaitPromise ?? true, args.target ?? "renderer");
+}
+//# sourceMappingURL=eval.js.map

package/dist/tools/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/tools/eval.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAyB,EACzB,IAAwF;IAExF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC;AAC7F,CAAC"}

package/dist/tools/ipc.d.ts

@@ -0,0 +1,14 @@
+import { SessionRegistry } from "../session.js";
+import { type IpcChannelInfo } from "../probe.js";
+export declare function ipcListTool(registry: SessionRegistry, args: {
+    sessionId: string;
+}): Promise<{
+    channels: IpcChannelInfo[];
+}>;
+export declare function ipcInvokeTool(registry: SessionRegistry, args: {
+    sessionId: string;
+    channel: string;
+    args?: unknown[];
+}): Promise<{
+    result: unknown;
+}>;

package/dist/tools/ipc.js

@@ -0,0 +1,19 @@
+import { ProbeClient } from "../probe.js";
+const NO_PROBE = "This session has no Vela probe. Add `vela-agent` (devDependency) and call " +
+    "`require('vela-agent').attach()` at the top of the app's main process (dev). " +
+    "CDP tools (vela_eval/vela_screenshot/vela_targets) work without it.";
+function probeFor(registry, sessionId) {
+    const session = registry.get(sessionId);
+    if (!session.probe)
+        throw new Error(NO_PROBE);
+    return new ProbeClient(session.probe.port, session.probe.token);
+}
+export async function ipcListTool(registry, args) {
+    const channels = await probeFor(registry, args.sessionId).ipcList();
+    return { channels };
+}
+export async function ipcInvokeTool(registry, args) {
+    const result = await probeFor(registry, args.sessionId).ipcInvoke(args.channel, args.args ?? []);
+    return { result };
+}
+//# sourceMappingURL=ipc.js.map

package/dist/tools/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../src/tools/ipc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAC;AAE/D,MAAM,QAAQ,GACZ,4EAA4E;IAC5E,+EAA+E;IAC/E,qEAAqE,CAAC;AAExE,SAAS,QAAQ,CAAC,QAAyB,EAAE,SAAiB;IAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAyB,EACzB,IAA2B;IAE3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACpE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAyB,EACzB,IAA8D;IAE9D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACjG,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/tools/launch.d.ts

@@ -0,0 +1,16 @@
+import { SessionRegistry } from "../session.js";
+export interface LaunchResult {
+    sessionId: string;
+    port: number;
+    targets: Array<{
+        id: string;
+        type: string;
+        url: string;
+        title: string;
+    }>;
+}
+export declare function launchTool(registry: SessionRegistry, args: {
+    projectPath?: string;
+    mode?: "launch" | "attach";
+    port?: number;
+}): Promise<LaunchResult>;

package/dist/tools/launch.js

@@ -0,0 +1,20 @@
+import { CdpClient } from "../cdp.js";
+import { ElectronAdapter, AttachAdapter } from "../adapter.js";
+export async function launchTool(registry, args) {
+    const adapter = args.mode === "attach" ? new AttachAdapter() : new ElectronAdapter();
+    const handle = await adapter.launch({ projectPath: args.projectPath, port: args.port });
+    const sessionId = registry.register({
+        projectPath: args.projectPath ?? `attach:${handle.cdpPort}`,
+        port: handle.cdpPort,
+        inspectPort: handle.inspectPort,
+        probe: handle.probe,
+        dispose: handle.dispose
+    });
+    const targets = await new CdpClient(handle.cdpPort).listTargets();
+    return {
+        sessionId,
+        port: handle.cdpPort,
+        targets: targets.map((t) => ({ id: t.id, type: t.type, url: t.url, title: t.title }))
+    };
+}
+//# sourceMappingURL=launch.js.map

package/dist/tools/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/tools/launch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAC;AAQnF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAyB,EACzB,IAAyE;IAEzE,MAAM,OAAO,GAAkB,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC;IACpG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU,MAAM,CAAC,OAAO,EAAE;QAC3D,IAAI,EAAE,MAAM,CAAC,OAAO;QACpB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO;QACL,SAAS;QACT,IAAI,EAAE,MAAM,CAAC,OAAO;QACpB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;KACtF,CAAC;AACJ,CAAC"}

package/dist/tools/main.d.ts

@@ -0,0 +1,7 @@
+import { SessionRegistry } from "../session.js";
+export declare function mainEvalTool(registry: SessionRegistry, args: {
+    sessionId: string;
+    code: string;
+}): Promise<{
+    value: unknown;
+}>;

package/dist/tools/main.js

@@ -0,0 +1,12 @@
+import { ProbeClient } from "../probe.js";
+const NO_PROBE = "This session has no Vela probe. Add `vela-agent` (devDependency) and call " +
+    "`require('vela-agent').attach()` at the top of the app's main process (dev). " +
+    "CDP tools (vela_eval/vela_screenshot/vela_targets) work without it.";
+export async function mainEvalTool(registry, args) {
+    const session = registry.get(args.sessionId);
+    if (!session.probe)
+        throw new Error(NO_PROBE);
+    const value = await new ProbeClient(session.probe.port, session.probe.token).mainEval(args.code);
+    return { value };
+}
+//# sourceMappingURL=main.js.map

package/dist/tools/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/tools/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,QAAQ,GACZ,4EAA4E;IAC5E,+EAA+E;IAC/E,qEAAqE,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAyB,EACzB,IAAyC;IAEzC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjG,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/tools/screenshot.d.ts

@@ -0,0 +1,7 @@
+import { SessionRegistry } from "../session.js";
+export declare function screenshotTool(registry: SessionRegistry, args: {
+    sessionId: string;
+    target?: string;
+}): Promise<{
+    path: string;
+}>;

package/dist/tools/screenshot.js

@@ -0,0 +1,16 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { CdpClient } from "../cdp.js";
+export async function screenshotTool(registry, args) {
+    const session = registry.get(args.sessionId);
+    const cdp = new CdpClient(session.port);
+    const base64 = await cdp.screenshotBase64(args.target ?? "renderer");
+    const dir = path.join(os.tmpdir(), "vela", args.sessionId);
+    await fs.mkdir(dir, { recursive: true });
+    const file = path.join(dir, `screenshot-${randomUUID()}.png`);
+    await fs.writeFile(file, Buffer.from(base64, "base64"));
+    return { path: file };
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/tools/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAyB,EACzB,IAA4C;IAE5C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/tools/spec.d.ts

@@ -0,0 +1,18 @@
+import { type SpecStep, type SpecReport } from "../spec.js";
+export declare function specSaveTool(args: {
+    name: string;
+    projectPath: string;
+    steps: SpecStep[];
+    specsDir?: string;
+}): Promise<{
+    saved: string;
+}>;
+export declare function specRunTool(args: {
+    name: string;
+    specsDir?: string;
+}): Promise<SpecReport>;
+export declare function specListTool(args: {
+    specsDir?: string;
+}): Promise<{
+    specs: string[];
+}>;

package/dist/tools/spec.js

@@ -0,0 +1,14 @@
+import { saveSpec, loadSpec, listSpecs, runSpec } from "../spec.js";
+export async function specSaveTool(args) {
+    const spec = { name: args.name, projectPath: args.projectPath, steps: args.steps };
+    const file = await saveSpec(spec, args.specsDir);
+    return { saved: file };
+}
+export async function specRunTool(args) {
+    const spec = await loadSpec(args.name, args.specsDir);
+    return runSpec(spec);
+}
+export async function specListTool(args) {
+    return { specs: await listSpecs(args.specsDir) };
+}
+//# sourceMappingURL=spec.js.map

package/dist/tools/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/tools/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAA6C,MAAM,YAAY,CAAC;AAE/G,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAKlC;IACC,MAAM,IAAI,GAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACzF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAyC;IACzE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAA2B;IAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/tools/targets.d.ts

@@ -0,0 +1,13 @@
+import { SessionRegistry } from "../session.js";
+export interface TargetInfo {
+    name: string;
+    type: string;
+    url: string;
+    title: string;
+    parentId?: string;
+}
+export declare function targetsTool(registry: SessionRegistry, args: {
+    sessionId: string;
+}): Promise<{
+    targets: TargetInfo[];
+}>;

package/dist/tools/targets.js

@@ -0,0 +1,15 @@
+import { CdpClient } from "../cdp.js";
+export async function targetsTool(registry, args) {
+    const session = registry.get(args.sessionId);
+    const named = await new CdpClient(session.port).listNamed();
+    return {
+        targets: named.map((t) => ({
+            name: t.name,
+            type: t.type,
+            url: t.url,
+            title: t.title,
+            parentId: t.parentId
+        }))
+    };
+}
+//# sourceMappingURL=targets.js.map

package/dist/tools/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/tools/targets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAUtC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAyB,EACzB,IAA2B;IAE3B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5D,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@john523100/vela-mcp",
+  "version": "0.6.0",
+  "description": "AI-driven dynamic test framework for Electron apps — drive renderer, webview, BrowserView, IPC, main process, breakpoints, console/network capture, and re-runnable specs over MCP.",
+  "license": "MIT",
+  "author": "Vela authors <colleenkantner@gmail.com>",
+  "keywords": [
+    "electron",
+    "testing",
+    "mcp",
+    "cdp",
+    "devtools",
+    "ai",
+    "claude",
+    "automation",
+    "debugging"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/michael-ltm/vela.git"
+  },
+  "homepage": "https://github.com/michael-ltm/vela#readme",
+  "bugs": {
+    "url": "https://github.com/michael-ltm/vela/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": { "vela-mcp": "dist/index.js" },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chrome-remote-interface": "^0.33.2",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/chrome-remote-interface": "^0.31.10"
+  }
+}