@g3nomaly/mods 0.1.1 → 0.1.3

package/dist/relay/protocol.js

@@ -0,0 +1,70 @@
+// packages/mods/src/relay/protocol.ts
+import { z } from "zod";
+/** The surface the viewer draws as, and the client id it attaches under. */
+export const VIEWER_SURFACE = "vscode";
+export const VIEWER_CLIENT_ID = "g3n-viewer";
+/** Prefix of the request ids the relay gives the control requests it sends for a viewer. */
+export const RELAY_REQUEST_PREFIX = "g3nv:";
+/** The engine's UI requests a viewer may send; the relay refuses every other subtype. */
+export const ViewerRequestSchema = z.discriminatedUnion("subtype", [
+    z.object({
+        subtype: z.literal("ui_render"),
+        component: z.string().min(1),
+        instance_id: z.string().min(1),
+        props: z.record(z.string(), z.unknown()),
+        viewport: z.object({ columns: z.number().int().positive(), rows: z.number().int().positive() }).optional(),
+    }),
+    z.object({
+        subtype: z.literal("ui_press"),
+        plugin: z.string(),
+        handle: z.number().int(),
+        key: z.string().optional(),
+        href: z.string().max(2048).optional(),
+    }),
+    z.object({
+        subtype: z.literal("ui_input"),
+        plugin: z.string(),
+        handle: z.number().int(),
+        kind: z.enum(["change", "submit"]),
+        value: z.string().max(16384),
+        key: z.string().optional(),
+        component: z.string().optional(),
+        instance_id: z.string().optional(),
+    }),
+    z.object({
+        subtype: z.literal("ui_select"),
+        plugin: z.string(),
+        handle: z.number().int(),
+        value: z.string().max(16384),
+        key: z.string().optional(),
+        component: z.string().optional(),
+        instance_id: z.string().optional(),
+    }),
+    z.object({ subtype: z.literal("ui_panes") }),
+    z.object({ subtype: z.literal("ui_close"), id: z.string().min(1) }),
+]);
+/** One line a viewer sends the relay: a UI request it numbers itself. */
+export const ViewerMessageSchema = z.object({
+    id: z.string().min(1).max(64),
+    request: ViewerRequestSchema,
+});
+/** Subtypes of the engine's `system` messages the relay copies to every viewer. */
+export const RELAYED_PUSHES = new Set(["ui_panes", "ui_invalidate"]);
+/**
+ * The control request a viewer request becomes on Claude's stdin: the
+ * viewer's surface and client id are filled in where the engine takes them.
+ */
+export function toControlRequest(request) {
+    switch (request.subtype) {
+        case "ui_render":
+            return { ...request, surface: VIEWER_SURFACE, client_id: VIEWER_CLIENT_ID };
+        case "ui_press":
+        case "ui_input":
+        case "ui_select":
+            return { ...request, surface: VIEWER_SURFACE };
+        case "ui_panes":
+        case "ui_close":
+            return { ...request, client_id: VIEWER_CLIENT_ID };
+    }
+}
+//# sourceMappingURL=protocol.js.map

package/dist/relay/protocol.js.map

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

package/dist/relay/relay.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Runs Claude Code as a child and stands on its stdio pipe: everything the
+ * extension writes reaches Claude and everything Claude writes reaches the
+ * extension, line for line and unchanged. Beside that it serves viewers on a
+ * local socket, attaches to the session as the `vscode` surface while one is
+ * connected, sends their UI requests as control requests of its own, and
+ * keeps the answers and the pane pushes they need away from the extension.
+ * A launch that is no stream-json session (`--version`, a subcommand) runs
+ * straight through, with no socket.
+ *
+ * @param claudePath - Absolute path of the Claude Code executable the extension wanted to launch
+ * @param args - Claude Code's arguments, passed on as given
+ * @returns Claude's exit code, once it has ended and the socket is closed
+ */
+export declare function runRelay(claudePath: string, args: readonly string[]): Promise<number>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/relay/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/relay/relay.ts"],"names":[],"mappings":"AAsDA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4I3F"}

package/dist/relay/relay.js

@@ -0,0 +1,213 @@
+// packages/mods/src/relay/relay.ts
+import fs from "node:fs";
+import net from "node:net";
+import { LineSplitter } from "./lines";
+import { RELAYED_PUSHES, RELAY_REQUEST_PREFIX, VIEWER_CLIENT_ID, VIEWER_SURFACE, ViewerMessageSchema, toControlRequest, } from "./protocol";
+import { removeSession, socketPath, writeSessionInfo } from "./sessions";
+/** Writes one relay message to a viewer as a JSON line; a closed socket is skipped. */
+function send(socket, message) {
+    if (!socket.destroyed)
+        socket.write(JSON.stringify(message) + "\n");
+}
+/** Parses a line as a JSON object, or `undefined` when it is not one. */
+function parseObject(line) {
+    try {
+        const value = JSON.parse(line);
+        return typeof value === "object" && value !== null ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The text of the first prompt in a `user` line from the extension, or `undefined` for any other line. */
+function promptText(line) {
+    if (!line.includes('"type":"user"'))
+        return undefined;
+    const message = parseObject(line)?.message;
+    const content = message?.content;
+    const text = typeof content === "string"
+        ? content
+        : Array.isArray(content)
+            ? content.map((block) => (typeof block === "object" && block !== null && block.type === "text" ? String(block.text ?? "") : "")).join(" ")
+            : "";
+    const title = text.replace(/\s+/g, " ").trim();
+    return title === "" ? undefined : title.slice(0, 80);
+}
+/** Runs Claude Code with the relay's own stdio, for the one-off commands the extension runs that are no session. */
+async function passThrough(claudePath, args) {
+    const child = Bun.spawn([claudePath, ...args], { stdin: "inherit", stdout: "inherit", stderr: "inherit", env: process.env });
+    for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"])
+        process.on(signal, () => child.kill(signal));
+    return child.exited;
+}
+/**
+ * Runs Claude Code as a child and stands on its stdio pipe: everything the
+ * extension writes reaches Claude and everything Claude writes reaches the
+ * extension, line for line and unchanged. Beside that it serves viewers on a
+ * local socket, attaches to the session as the `vscode` surface while one is
+ * connected, sends their UI requests as control requests of its own, and
+ * keeps the answers and the pane pushes they need away from the extension.
+ * A launch that is no stream-json session (`--version`, a subcommand) runs
+ * straight through, with no socket.
+ *
+ * @param claudePath - Absolute path of the Claude Code executable the extension wanted to launch
+ * @param args - Claude Code's arguments, passed on as given
+ * @returns Claude's exit code, once it has ended and the socket is closed
+ */
+export async function runRelay(claudePath, args) {
+    if (!args.includes("stream-json"))
+        return passThrough(claudePath, args);
+    const child = Bun.spawn([claudePath, ...args], { stdin: "pipe", stdout: "pipe", stderr: "inherit", env: process.env });
+    const info = { pid: process.pid, socket: socketPath(process.pid), cwd: process.cwd(), startedAt: Date.now() };
+    const viewers = new Set();
+    const pending = new Map();
+    const queued = [];
+    let isReady = false;
+    let nextConnection = 0;
+    const writeToClaude = (line) => {
+        child.stdin.write(line + "\n");
+        child.stdin.flush();
+    };
+    /** Sends a control request of the relay's own, holding it until Claude has answered its first message. */
+    const inject = (requestId, request) => {
+        const line = JSON.stringify({ type: "control_request", request_id: requestId, request });
+        if (isReady)
+            writeToClaude(line);
+        else
+            queued.push(line);
+    };
+    const markReady = () => {
+        if (isReady)
+            return;
+        isReady = true;
+        for (const line of queued.splice(0))
+            writeToClaude(line);
+    };
+    const publish = () => {
+        try {
+            writeSessionInfo(info);
+        }
+        catch {
+            // A viewer cannot find this session without the file; the session itself runs on.
+        }
+        for (const viewer of viewers)
+            send(viewer, { type: "session", session: info });
+    };
+    fs.rmSync(info.socket, { force: true });
+    const server = net.createServer((socket) => {
+        const connection = ++nextConnection;
+        const lines = new LineSplitter();
+        viewers.add(socket);
+        if (viewers.size === 1)
+            inject(`${RELAY_REQUEST_PREFIX}attach`, { subtype: "ui_attach", surface: VIEWER_SURFACE, client_id: VIEWER_CLIENT_ID });
+        send(socket, { type: "session", session: info });
+        socket.on("data", (chunk) => {
+            for (const line of lines.push(chunk)) {
+                if (line.trim() === "")
+                    continue;
+                const parsed = ViewerMessageSchema.safeParse(parseObject(line));
+                if (!parsed.success) {
+                    const id = typeof parseObject(line)?.id === "string" ? String(parseObject(line)?.id) : "";
+                    send(socket, { type: "response", id, error: `not a viewer request: ${parsed.error.issues[0]?.message ?? "invalid"}` });
+                    continue;
+                }
+                const requestId = `${RELAY_REQUEST_PREFIX}${connection}:${parsed.data.id}`;
+                pending.set(requestId, { socket, id: parsed.data.id });
+                inject(requestId, toControlRequest(parsed.data.request));
+            }
+        });
+        const drop = () => {
+            if (!viewers.delete(socket))
+                return;
+            for (const [requestId, request] of pending)
+                if (request.socket === socket)
+                    pending.delete(requestId);
+            if (viewers.size === 0)
+                inject(`${RELAY_REQUEST_PREFIX}detach`, { subtype: "ui_detach", client_id: VIEWER_CLIENT_ID });
+        };
+        socket.on("close", drop);
+        socket.on("error", drop);
+    });
+    server.on("error", () => {
+        // Without the socket no viewer can attach; the session itself runs on.
+    });
+    server.listen(info.socket, () => {
+        fs.chmodSync(info.socket, 0o600);
+        publish();
+    });
+    /** Routes a line from Claude: the relay's own answers go to their viewer, everything else to the extension. */
+    const fromClaude = (line) => {
+        if (line.includes('"control_response"')) {
+            markReady();
+            if (line.includes(RELAY_REQUEST_PREFIX)) {
+                const response = parseObject(line)?.response;
+                const requestId = typeof response?.request_id === "string" ? response.request_id : "";
+                if (requestId.startsWith(RELAY_REQUEST_PREFIX)) {
+                    const request = pending.get(requestId);
+                    pending.delete(requestId);
+                    if (request !== undefined) {
+                        send(request.socket, response?.subtype === "error"
+                            ? { type: "response", id: request.id, error: String(response.error ?? "the engine refused the request") }
+                            : { type: "response", id: request.id, response: response?.response });
+                    }
+                    return;
+                }
+            }
+        }
+        else if (line.includes('"subtype":"init"') || line.includes('"subtype":"ui_')) {
+            const message = parseObject(line);
+            if (message?.type === "system" && message.subtype === "init") {
+                markReady();
+                if (typeof message.session_id === "string")
+                    info.sessionId = message.session_id;
+                if (typeof message.cwd === "string")
+                    info.cwd = message.cwd;
+                publish();
+            }
+            else if (message?.type === "system" && RELAYED_PUSHES.has(String(message.subtype))) {
+                for (const viewer of viewers)
+                    send(viewer, { type: "push", push: message });
+            }
+        }
+        process.stdout.write(line + "\n");
+    };
+    const forwardStdin = (async () => {
+        const lines = new LineSplitter();
+        for await (const chunk of process.stdin) {
+            for (const line of lines.push(chunk)) {
+                writeToClaude(line);
+                if (info.title === undefined) {
+                    const title = promptText(line);
+                    if (title !== undefined) {
+                        info.title = title;
+                        publish();
+                    }
+                }
+            }
+        }
+        const rest = lines.flush();
+        if (rest !== undefined)
+            child.stdin.write(rest);
+        await child.stdin.end();
+    })().catch(() => undefined);
+    const forwardStdout = (async () => {
+        const lines = new LineSplitter();
+        for await (const chunk of child.stdout)
+            for (const line of lines.push(chunk))
+                fromClaude(line);
+        const rest = lines.flush();
+        if (rest !== undefined)
+            process.stdout.write(rest);
+    })();
+    for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"])
+        process.on(signal, () => child.kill(signal));
+    const exitCode = await child.exited;
+    await forwardStdout;
+    void forwardStdin;
+    for (const viewer of viewers)
+        viewer.destroy();
+    server.close();
+    removeSession(info.pid);
+    return exitCode;
+}
+//# sourceMappingURL=relay.js.map

package/dist/relay/relay.js.map

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

package/dist/relay/sessions.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/** What a relay says about the session it runs, written beside its socket as `<pid>.json`. */
+export declare const SessionInfoSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    socket: z.ZodString;
+    cwd: z.ZodString;
+    startedAt: z.ZodNumber;
+    sessionId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionInfo = z.infer<typeof SessionInfoSchema>;
+/**
+ * Folder the relays of this user put their sockets and session files in:
+ * `$XDG_RUNTIME_DIR/g3n-mods`, else `<tmp>/g3n-mods-<uid>`.
+ */
+export declare function sessionsDir(): string;
+/** Socket path of the relay with this process id. */
+export declare function socketPath(pid: number): string;
+/** Writes or replaces a relay's session file. */
+export declare function writeSessionInfo(info: SessionInfo): void;
+/** Removes a relay's session file and socket; missing files are ignored. */
+export declare function removeSession(pid: number): void;
+/**
+ * The sessions whose relay still runs, newest first. Files of relays that
+ * ended without cleaning up are removed on the way.
+ */
+export declare function listSessions(): SessionInfo[];
+//# sourceMappingURL=sessions.d.ts.map

package/dist/relay/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/relay/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB;;;;;;;iBAa5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAMD,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAKxD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C;AAWD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAgB5C"}

package/dist/relay/sessions.js

@@ -0,0 +1,86 @@
+// packages/mods/src/relay/sessions.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { z } from "zod";
+/** What a relay says about the session it runs, written beside its socket as `<pid>.json`. */
+export const SessionInfoSchema = z.object({
+    /** Process id of the relay */
+    pid: z.number().int(),
+    /** Absolute path of the relay's socket */
+    socket: z.string().min(1),
+    /** Absolute working directory of the session */
+    cwd: z.string(),
+    /** Milliseconds since the epoch */
+    startedAt: z.number(),
+    /** Claude Code's session id, once the session has reported it */
+    sessionId: z.string().optional(),
+    /** The first prompt of the session, cut to 80 characters */
+    title: z.string().optional(),
+});
+/**
+ * Folder the relays of this user put their sockets and session files in:
+ * `$XDG_RUNTIME_DIR/g3n-mods`, else `<tmp>/g3n-mods-<uid>`.
+ */
+export function sessionsDir() {
+    const runtime = process.env.XDG_RUNTIME_DIR;
+    if (runtime !== undefined && runtime !== "")
+        return path.join(runtime, "g3n-mods");
+    const uid = typeof process.getuid === "function" ? process.getuid() : os.userInfo().username;
+    return path.join(os.tmpdir(), `g3n-mods-${uid}`);
+}
+/** Socket path of the relay with this process id. */
+export function socketPath(pid) {
+    return path.join(sessionsDir(), `${pid}.sock`);
+}
+function infoPath(pid) {
+    return path.join(sessionsDir(), `${pid}.json`);
+}
+/** Writes or replaces a relay's session file. */
+export function writeSessionInfo(info) {
+    fs.mkdirSync(sessionsDir(), { recursive: true, mode: 0o700 });
+    const file = infoPath(info.pid);
+    fs.writeFileSync(`${file}.tmp`, JSON.stringify(info));
+    fs.renameSync(`${file}.tmp`, file);
+}
+/** Removes a relay's session file and socket; missing files are ignored. */
+export function removeSession(pid) {
+    for (const file of [infoPath(pid), socketPath(pid)])
+        fs.rmSync(file, { force: true });
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+/**
+ * The sessions whose relay still runs, newest first. Files of relays that
+ * ended without cleaning up are removed on the way.
+ */
+export function listSessions() {
+    const dir = sessionsDir();
+    if (!fs.existsSync(dir))
+        return [];
+    const sessions = [];
+    for (const name of fs.readdirSync(dir)) {
+        if (!name.endsWith(".json"))
+            continue;
+        let info;
+        try {
+            info = SessionInfoSchema.parse(JSON.parse(fs.readFileSync(path.join(dir, name), "utf8")));
+        }
+        catch {
+            continue;
+        }
+        if (isAlive(info.pid) && fs.existsSync(info.socket))
+            sessions.push(info);
+        else
+            removeSession(info.pid);
+    }
+    return sessions.sort((a, b) => b.startedAt - a.startedAt);
+}
+//# sourceMappingURL=sessions.js.map

package/dist/relay/sessions.js.map

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

package/dist/viewer/index.d.ts

@@ -2,4 +2,10 @@ export { MIN_ENGINE_VERSION, compareVersions, findClaudeExtension } from "./exte
 export type { ClaudeExtension } from "./extension";
 export { ViewerLocationSchema, configureViewer } from "./settings";
 export type { ViewerLocation, ViewerSettingsResult } from "./settings";
+export { installRelay, relayBinaryPath } from "./relay";
+export type { RelayInstallResult } from "./relay";
+export { machineSettingsPath, setProcessWrapper } from "./machine";
+export type { WrapperResult } from "./machine";
+export { VIEWER_EXTENSION_ID, installViewer, viewerPackagePath } from "./viewerExtension";
+export type { ViewerInstallResult } from "./viewerExtension";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/viewer/index.js

@@ -1,4 +1,7 @@
 // packages/mods/src/viewer/index.ts
 export { MIN_ENGINE_VERSION, compareVersions, findClaudeExtension } from "./extension";
 export { ViewerLocationSchema, configureViewer } from "./settings";
+export { installRelay, relayBinaryPath } from "./relay";
+export { machineSettingsPath, setProcessWrapper } from "./machine";
+export { VIEWER_EXTENSION_ID, installViewer, viewerPackagePath } from "./viewerExtension";
 //# sourceMappingURL=index.js.map

package/dist/viewer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/viewer/machine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The settings file VS Code reads machine-scoped settings from on this
+ * machine: the server's `Machine/settings.json` under a remote (WSL, SSH),
+ * else the desktop's user settings.
+ */
+export declare function machineSettingsPath(home?: string): string;
+/** What `setProcessWrapper` did. */
+export type WrapperResult = {
+    kind: "written";
+    file: string;
+} | {
+    kind: "unchanged";
+    file: string;
+}
+/** Another wrapper is set; it was left in place */
+ | {
+    kind: "taken";
+    file: string;
+    current: string;
+}
+/** The file is not plain JSON (comments, trailing commas); nothing was written */
+ | {
+    kind: "unreadable";
+    file: string;
+};
+/**
+ * Sets `claudeCode.claudeProcessWrapper` to the relay, so the Claude Code
+ * extension launches every session through it. A different wrapper already
+ * set is kept unless `force` is passed; the file's other settings are kept.
+ *
+ * @param relay - Absolute path of the relay executable
+ */
+export declare function setProcessWrapper(relay: string, options?: {
+    force?: boolean;
+    home?: string;
+}): WrapperResult;
+//# sourceMappingURL=machine.d.ts.map

package/dist/viewer/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../src/viewer/machine.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAKvE;AAED,oCAAoC;AACpC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrC,mDAAmD;GACjD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAClD,kFAAkF;GAChF;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,CAuBhH"}

package/dist/viewer/machine.js

@@ -0,0 +1,55 @@
+// packages/mods/src/viewer/machine.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { z } from "zod";
+const WRAPPER_KEY = "claudeCode.claudeProcessWrapper";
+const SettingsSchema = z.record(z.string(), z.unknown());
+/**
+ * The settings file VS Code reads machine-scoped settings from on this
+ * machine: the server's `Machine/settings.json` under a remote (WSL, SSH),
+ * else the desktop's user settings.
+ */
+export function machineSettingsPath(home = os.homedir()) {
+    if (fs.existsSync(path.join(home, ".vscode-server")))
+        return path.join(home, ".vscode-server", "data", "Machine", "settings.json");
+    if (process.platform === "darwin")
+        return path.join(home, "Library", "Application Support", "Code", "User", "settings.json");
+    if (process.platform === "win32")
+        return path.join(process.env.APPDATA ?? path.join(home, "AppData", "Roaming"), "Code", "User", "settings.json");
+    return path.join(home, ".config", "Code", "User", "settings.json");
+}
+/**
+ * Sets `claudeCode.claudeProcessWrapper` to the relay, so the Claude Code
+ * extension launches every session through it. A different wrapper already
+ * set is kept unless `force` is passed; the file's other settings are kept.
+ *
+ * @param relay - Absolute path of the relay executable
+ */
+export function setProcessWrapper(relay, options = {}) {
+    const file = machineSettingsPath(options.home);
+    let current = {};
+    if (fs.existsSync(file)) {
+        const text = fs.readFileSync(file, "utf8");
+        let parsed;
+        try {
+            parsed = text.trim() === "" ? {} : JSON.parse(text);
+        }
+        catch {
+            return { kind: "unreadable", file };
+        }
+        const settings = SettingsSchema.safeParse(parsed);
+        if (!settings.success)
+            return { kind: "unreadable", file };
+        current = settings.data;
+    }
+    const existing = current[WRAPPER_KEY];
+    if (existing === relay)
+        return { kind: "unchanged", file };
+    if (typeof existing === "string" && existing !== "" && options.force !== true)
+        return { kind: "taken", file, current: existing };
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify({ ...current, [WRAPPER_KEY]: relay }, null, 2) + "\n");
+    return { kind: "written", file };
+}
+//# sourceMappingURL=machine.js.map

package/dist/viewer/machine.js.map

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

package/dist/viewer/relay.d.ts

@@ -0,0 +1,23 @@
+/** Where `init` builds the relay: one executable per machine, since VS Code sets the wrapper per machine. */
+export declare function relayBinaryPath(home?: string): string;
+/** What `installRelay` did. */
+export type RelayInstallResult = {
+    kind: "built";
+    binary: string;
+} | {
+    kind: "current";
+    binary: string;
+} | {
+    kind: "failed";
+    binary: string;
+    reason: string;
+};
+/**
+ * Builds the relay into a standalone executable with `bun build --compile`,
+ * unless the one already there was built from the same sources. A stamp
+ * file beside it holds the hash of those sources.
+ *
+ * @param home - Home directory the executable goes under; the current user's by default
+ */
+export declare function installRelay(home?: string): Promise<RelayInstallResult>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/viewer/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/viewer/relay.ts"],"names":[],"mappings":"AAOA,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAEnE;AAED,+BAA+B;AAC/B,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAevD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE,MAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmB3F"}