@creeperhost/modlens-mcp 1.6.19 → 1.6.21

package/dist/runtime/companion.js

@@ -0,0 +1,135 @@
+import { createServer } from "node:http";
+import { randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
+import { readFile, writeFile, rename, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { RuntimeHub } from "./hub.js";
+import { executeRuntime, runtimeRequest } from "./requests.js";
+export const companionDescriptor = z.object({
+    protocol: z.literal(1),
+    pid: z.number().int().positive(),
+    endpoint: z
+        .string()
+        .url()
+        .refine((value) => {
+        const url = new URL(value);
+        return (url.protocol === "http:" &&
+            url.hostname === "127.0.0.1" &&
+            !!url.port &&
+            url.pathname === "/runtime" &&
+            !url.username &&
+            !url.password &&
+            !url.search &&
+            !url.hash);
+    }, "Companion must use loopback HTTP"),
+    token: z.string().regex(/^[a-f0-9]{64}$/),
+});
+export const descriptorPath = (root) => join(root, "companion.json");
+/** Local CLI transport, not another MCP connection or an Internet control API. */
+export async function startCompanion(root, agentJar) {
+    const hub = new RuntimeHub(root, agentJar);
+    // Uses the same ownership lock as local stdio: never steal an active bridge.
+    await hub.startLocalCompanion();
+    const token = randomBytes(32).toString("hex");
+    let closing;
+    const close = () => (closing ??= (async () => {
+        server.closeAllConnections();
+        await new Promise((resolve) => server.close(() => resolve()));
+        try {
+            const saved = JSON.parse(await readFile(descriptorPath(root), "utf8"));
+            if (saved.token === token)
+                await unlink(descriptorPath(root));
+        }
+        catch (e) {
+            if (e.code !== "ENOENT")
+                console.error("[runtime] Descriptor cleanup:", String(e));
+        }
+        await hub.close();
+    })());
+    const server = createServer(async (req, res) => {
+        res.setHeader("Cache-Control", "no-store");
+        res.setHeader("Content-Type", "application/json");
+        const supplied = Buffer.from(req.headers.authorization ?? ""), expected = Buffer.from(`Bearer ${token}`);
+        if (req.headers.origin ||
+            req.method !== "POST" ||
+            req.url !== "/runtime" ||
+            supplied.length !== expected.length ||
+            !timingSafeEqual(supplied, expected)) {
+            res.writeHead(403).end(JSON.stringify({ error: "Forbidden" }));
+            return;
+        }
+        try {
+            let size = 0;
+            const chunks = [];
+            for await (const chunk of req) {
+                size += chunk.length;
+                if (size > 64 * 1024) {
+                    res.writeHead(413).end(JSON.stringify({ error: "Request too large" }));
+                    req.destroy();
+                    return;
+                }
+                chunks.push(chunk);
+            }
+            const request = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+            if (request?.action === "ping") {
+                res.end(JSON.stringify({ protocol: 1, pid: process.pid }));
+                return;
+            }
+            if (request?.action === "stop_helper") {
+                res.end(JSON.stringify({
+                    state: "stopped",
+                    note: "The companion stopped. Running game processes are left running; held inputs expire after loss of connection.",
+                }), () => {
+                    void close().catch(console.error);
+                });
+                return;
+            }
+            const result = await executeRuntime(hub, runtimeRequest.parse(request));
+            // CLI callers use their local image viewer, never a screen-sized base64 blob in text.
+            if (result && typeof result === "object" && "mimeType" in result && "data" in result) {
+                const { data, ...artifact } = result;
+                res.end(JSON.stringify({
+                    ...artifact,
+                    view: "Open the local path with your image viewing tool.",
+                }));
+            }
+            else
+                res.end(JSON.stringify(result));
+        }
+        catch (e) {
+            if (!res.headersSent)
+                res.writeHead(400).end(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }));
+        }
+    });
+    server.requestTimeout = 5000;
+    server.headersTimeout = 5000;
+    try {
+        await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(0, "127.0.0.1", () => {
+                server.off("error", reject);
+                resolve();
+            });
+        });
+        const descriptor = {
+            protocol: 1,
+            pid: process.pid,
+            endpoint: `http://127.0.0.1:${server.address().port}/runtime`,
+            token,
+        };
+        const temporary = join(root, `companion-${randomUUID()}.tmp`);
+        try {
+            await writeFile(temporary, JSON.stringify(descriptor), { mode: 0o600, flag: "wx" });
+            await rename(temporary, descriptorPath(root));
+        }
+        finally {
+            await unlink(temporary).catch(() => { });
+        }
+        return { hub, descriptor, close };
+    }
+    catch (e) {
+        await close();
+        throw e;
+    }
+}
+//# sourceMappingURL=companion.js.map

package/dist/runtime/companion.js.map

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

package/dist/runtime/guidance.d.ts

@@ -0,0 +1,73 @@
+import type { RuntimeRequest } from "./requests.js";
+export declare function localExecutionPlan(request: RuntimeRequest): {
+    execution: string;
+    executed: boolean;
+    helperVersion: string;
+    message: string;
+    steps: string[];
+    invocation: {
+        executable: string;
+        arguments: string[];
+    };
+    sourceCheckout: {
+        note: string;
+        executable: string;
+        arguments: string[];
+    };
+    request: {
+        action: "status" | "events" | "artifact" | "command" | "help" | "setup" | "sessions" | "launch";
+        mcVersion?: "26.3" | undefined;
+        projectId?: string | undefined;
+        mode?: "interactive" | "observe" | "hidden" | undefined;
+        command?: {
+            type: "mode";
+            mode: "interactive" | "observe" | "hidden";
+        } | {
+            type: "key";
+            key: string;
+            down: boolean;
+            holdMs: number;
+        } | {
+            type: "mouse_button";
+            button: number;
+            down: boolean;
+            holdMs: number;
+        } | {
+            type: "mouse_move";
+            x: number;
+            y: number;
+            relative: boolean;
+        } | {
+            type: "scroll";
+            x: number;
+            y: number;
+        } | {
+            type: "text";
+            text: string;
+        } | {
+            type: "release_all";
+        } | {
+            type: "screenshot";
+        } | {
+            type: "threads";
+        } | {
+            type: "recording";
+        } | {
+            type: "allocations";
+            limit: number;
+            windowSeconds: number;
+            packagePrefix?: string | undefined;
+        } | undefined;
+        sessionId?: string | undefined;
+        minecraftHooks?: boolean | undefined;
+        projectDir?: string | undefined;
+        gradleTask?: string | undefined;
+        javaHome?: string | undefined;
+        afterCursor?: number | undefined;
+        waitMs?: number | undefined;
+        artifactName?: string | undefined;
+    };
+    lifecycle: string;
+    limits: string;
+};
+//# sourceMappingURL=guidance.d.ts.map

package/dist/runtime/guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../src/runtime/guidance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMpD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCzD"}

package/dist/runtime/guidance.js

@@ -0,0 +1,40 @@
+import { readFileSync } from "node:fs";
+const version = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8")).version;
+export function localExecutionPlan(request) {
+    return {
+        execution: "local_helper_required",
+        executed: false,
+        helperVersion: version,
+        message: "Run this workflow using your LOCAL terminal/file tools on the computer running Minecraft. This remote MCP response has not configured, launched, or controlled a JVM.",
+        steps: [
+            "Write request below as UTF-8 JSON to a temporary local file, e.g. runtime-request.json. Use paths on the user's PC, not paths on the remote MCP server.",
+            "Invoke the helper with the executable and separate arguments below; substitute the request file's path. Follow the local host's normal execution permissions. Do not paste JSON or project paths into an unquoted shell command.",
+            "Read the helper's JSON result. Setup creates ModLens Client in IntelliJ; launch starts the chosen Gradle task. Reuse this helper for sessions/status/events/command/artifact requests.",
+            "For a screenshot, request command screenshot, then artifact using the returned name, then view the returned local image path with your image tool. Use events with afterCursor and waitMs up to 30000 while monitoring.",
+        ],
+        invocation: {
+            executable: "npx",
+            arguments: [
+                "-y",
+                `@creeperhost/modlens-mcp@${version}`,
+                "--runtime",
+                "--request-file",
+                "<local-request-file>",
+            ],
+        },
+        sourceCheckout: {
+            note: "For an unpublished build, use a local checkout of this version after npm run build and npm run build:agent (JDK 25). Release packages include the agent.",
+            executable: "node",
+            arguments: [
+                "<local-modlens-checkout>/dist/launcher.js",
+                "--runtime",
+                "--request-file",
+                "<local-request-file>",
+            ],
+        },
+        request,
+        lifecycle: "The helper starts one persistent, authenticated loopback companion automatically; it collects events between CLI calls. Stop it with the same package command followed by --runtime stop. No second MCP connection or public tunnel is needed.",
+        limits: "Codex must have local execution access to the Minecraft PC. This does not wake an idle AI task, and does not connect a cloud-only shell to the user's computer. Do not upload local bridge tokens. Only share diagnostic content needed for the user's task.",
+    };
+}
+//# sourceMappingURL=guidance.js.map

package/dist/runtime/guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.js","sourceRoot":"","sources":["../../src/runtime/guidance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,OAAO,GACT,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAClF,CAAC,OAAO,CAAC;AAEV,MAAM,UAAU,kBAAkB,CAAC,OAAuB;IACtD,OAAO;QACH,SAAS,EAAE,uBAAuB;QAClC,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,OAAO;QACtB,OAAO,EACH,uKAAuK;QAC3K,KAAK,EAAE;YACH,yJAAyJ;YACzJ,kOAAkO;YAClO,wLAAwL;YACxL,yNAAyN;SAC5N;QACD,UAAU,EAAE;YACR,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE;gBACP,IAAI;gBACJ,4BAA4B,OAAO,EAAE;gBACrC,WAAW;gBACX,gBAAgB;gBAChB,sBAAsB;aACzB;SACJ;QACD,cAAc,EAAE;YACZ,IAAI,EAAE,0JAA0J;YAChK,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE;gBACP,2CAA2C;gBAC3C,WAAW;gBACX,gBAAgB;gBAChB,sBAAsB;aACzB;SACJ;QACD,OAAO;QACP,SAAS,EACL,gPAAgP;QACpP,MAAM,EAAE,8PAA8P;KACzQ,CAAC;AACN,CAAC"}

package/dist/runtime/hub.d.ts

@@ -0,0 +1,150 @@
+import { type RuntimeCommand, type RuntimeMode } from "./protocol.js";
+type Event = {
+    cursor: number;
+    sessionId: string;
+    time: number;
+    type: string;
+    data: Record<string, unknown>;
+};
+export declare const RUNTIME_HELP: {
+    target: string;
+    clientJvmOptions: string;
+    optional: boolean;
+    workflow: string[];
+    input: string;
+    monitoring: string;
+    heapAnalysis: string;
+    execution: string;
+    limits: string;
+};
+/** Local-only, opt-in bridge. Remote MCP clients never gain host process/filesystem control. */
+export declare class RuntimeHub {
+    readonly root: string;
+    readonly agentJar: string;
+    private projects;
+    private sessions;
+    private journal;
+    private cursor;
+    private server?;
+    private endpoint;
+    private init?;
+    private waiters;
+    private children;
+    private persistence;
+    private monitor?;
+    private dirty;
+    private ownsLock;
+    private listening?;
+    constructor(root: string, agentJar?: string);
+    private assertLocal;
+    initialize(): Promise<void>;
+    /** Explicit CLI opt-in: keep a bridge ready even before the first project setup. */
+    startLocalCompanion(): Promise<void>;
+    private load;
+    private listen;
+    private openListener;
+    private safeDirectory;
+    private managedWrite;
+    private connection;
+    setup(directory: string, mode?: RuntimeMode, task?: string, hooks?: boolean): Promise<{
+        state: string;
+        projectId: string;
+        mcVersion: string;
+        mode: "interactive" | "observe" | "hidden";
+        runConfiguration: string;
+        vmOption: string;
+        vmOptions: string[];
+        manualLaunch: string;
+        next: string;
+        files: string[];
+        note: string;
+    }>;
+    private accept;
+    private add;
+    private saveEvents;
+    status(sessionId?: string): Promise<{
+        sessionId: string;
+        projectId: string;
+        status: string;
+        lastSeen: number;
+        pid: number;
+        javaVersion: string;
+        capabilities: Record<string, unknown>;
+        state: Record<string, unknown>;
+        metrics: Record<string, unknown>;
+    } | {
+        enabled: boolean;
+        agentPackaged: boolean;
+        projects: {
+            id: string;
+            directory: string;
+            mode: RuntimeMode;
+            task: string;
+            hooks: boolean;
+        }[];
+        help: {
+            target: string;
+            clientJvmOptions: string;
+            optional: boolean;
+            workflow: string[];
+            input: string;
+            monitoring: string;
+            heapAnalysis: string;
+            execution: string;
+            limits: string;
+        };
+    }>;
+    list(): Promise<{
+        sessionId: string;
+        projectId: string;
+        status: string;
+        lastSeen: number;
+        pid: number;
+        javaVersion: string;
+        capabilities: Record<string, unknown>;
+        state: Record<string, unknown>;
+        metrics: Record<string, unknown>;
+    }[]>;
+    private view;
+    private session;
+    events(after?: number, waitMs?: number, sessionId?: string): Promise<{
+        events: Event[];
+        nextCursor: number;
+        truncated: boolean;
+    }>;
+    command(sessionId: string, command: RuntimeCommand): Promise<unknown>;
+    launch(projectId: string, javaHome?: string): Promise<{
+        state: string;
+        pid: number | undefined;
+        projectId: string;
+        next: string;
+    }>;
+    artifact(sessionId: string, name: string): Promise<{
+        path: string;
+        note: string;
+        mimeType?: undefined;
+        data?: undefined;
+        text?: undefined;
+    } | {
+        path: string;
+        mimeType: string;
+        data: string;
+        note?: undefined;
+        text?: undefined;
+    } | {
+        path: string;
+        text: string;
+        note?: undefined;
+        mimeType?: undefined;
+        data?: undefined;
+    } | {
+        path: string;
+        note?: undefined;
+        mimeType?: undefined;
+        data?: undefined;
+        text?: undefined;
+    }>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=hub.d.ts.map

package/dist/runtime/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../src/runtime/hub.ts"],"names":[],"mappings":"AAMA,OAAO,EAIH,KAAK,cAAc,EACnB,KAAK,WAAW,EACnB,MAAM,eAAe,CAAC;AAYvB,KAAK,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAmB9G,eAAO,MAAM,YAAY;;;;;;;;;;CAoBxB,CAAC;AAEF,gGAAgG;AAChG,qBAAa,UAAU;IAgBf,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ;IAhBrB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,IAAI,CAAC,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAC,CAAgB;gBAErB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAuD;IAG5E,OAAO,CAAC,WAAW;IAMb,UAAU;IAOhB,oFAAoF;IAC9E,mBAAmB;YAIX,IAAI;YAqBJ,MAAM;YAON,YAAY;YAqGZ,aAAa;YAeb,YAAY;YAUZ,UAAU;IAclB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,WAA2B,EAAE,IAAI,SAAc,EAAE,KAAK,UAAO;;;;;;;;;;;;;IA2FlG,OAAO,CAAC,MAAM;IAmCd,OAAO,CAAC,GAAG;YAQG,UAAU;IAKlB,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;;;gBA1Y3B,MAAM;uBACC,MAAM;kBAEX,WAAW;kBACX,MAAM;mBACL,OAAO;;;;;;;;;;;;;;IAqZR,IAAI;;;;;;;;;;;IAIV,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;IAKT,MAAM,CAAC,KAAK,SAAI,EAAE,MAAM,SAAI,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAwBhD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IAoBlD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;;;;;;IAuD3C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;IAkBxC,KAAK;CAiCd"}