@g3nomaly/mods 0.1.0 → 0.1.2

package/dist/relay/lines.js

@@ -0,0 +1,35 @@
+// packages/mods/src/relay/lines.ts
+/**
+ * Cuts a byte stream into whole lines. Holds the unfinished tail of each
+ * chunk until its newline arrives, so a writer can put its own lines between
+ * the stream's lines without splitting one.
+ *
+ * Created once per stream by `runRelay`, which feeds it every chunk the
+ * extension or Claude writes and acts on each line it returns.
+ *
+ * @example
+ * const lines = new LineSplitter();
+ * for (const line of lines.push(chunk)) forward(line);
+ */
+export class LineSplitter {
+    tail = "";
+    decoder = new TextDecoder();
+    /**
+     * Adds a chunk and returns the lines it completed, each without its newline.
+     *
+     * @returns the completed lines; empty while the chunk ends mid-line
+     */
+    push(chunk) {
+        const text = typeof chunk === "string" ? chunk : this.decoder.decode(chunk, { stream: true });
+        const parts = (this.tail + text).split("\n");
+        this.tail = parts.pop() ?? "";
+        return parts;
+    }
+    /** Returns what is left when the stream ends, or `undefined` when it ended on a newline. */
+    flush() {
+        const rest = this.tail + this.decoder.decode();
+        this.tail = "";
+        return rest === "" ? undefined : rest;
+    }
+}
+//# sourceMappingURL=lines.js.map

package/dist/relay/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../src/relay/lines.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IACf,IAAI,GAAG,EAAE,CAAC;IACD,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAE7C;;;;OAIG;IACH,IAAI,CAAC,KAA0B;QAC7B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4FAA4F;IAC5F,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;CACF"}

package/dist/relay/protocol.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import type { SessionInfo } from "./sessions";
+/** The surface the viewer draws as, and the client id it attaches under. */
+export declare const VIEWER_SURFACE = "vscode";
+export declare const VIEWER_CLIENT_ID = "g3n-viewer";
+/** Prefix of the request ids the relay gives the control requests it sends for a viewer. */
+export declare const RELAY_REQUEST_PREFIX = "g3nv:";
+/** The engine's UI requests a viewer may send; the relay refuses every other subtype. */
+export declare const ViewerRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    subtype: z.ZodLiteral<"ui_render">;
+    component: z.ZodString;
+    instance_id: z.ZodString;
+    props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        columns: z.ZodNumber;
+        rows: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    subtype: z.ZodLiteral<"ui_press">;
+    plugin: z.ZodString;
+    handle: z.ZodNumber;
+    key: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    subtype: z.ZodLiteral<"ui_input">;
+    plugin: z.ZodString;
+    handle: z.ZodNumber;
+    kind: z.ZodEnum<{
+        change: "change";
+        submit: "submit";
+    }>;
+    value: z.ZodString;
+    key: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+    instance_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    subtype: z.ZodLiteral<"ui_select">;
+    plugin: z.ZodString;
+    handle: z.ZodNumber;
+    value: z.ZodString;
+    key: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+    instance_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    subtype: z.ZodLiteral<"ui_panes">;
+}, z.core.$strip>, z.ZodObject<{
+    subtype: z.ZodLiteral<"ui_close">;
+    id: z.ZodString;
+}, z.core.$strip>], "subtype">;
+export type ViewerRequest = z.infer<typeof ViewerRequestSchema>;
+/** One line a viewer sends the relay: a UI request it numbers itself. */
+export declare const ViewerMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    request: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        subtype: z.ZodLiteral<"ui_render">;
+        component: z.ZodString;
+        instance_id: z.ZodString;
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            columns: z.ZodNumber;
+            rows: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        subtype: z.ZodLiteral<"ui_press">;
+        plugin: z.ZodString;
+        handle: z.ZodNumber;
+        key: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        subtype: z.ZodLiteral<"ui_input">;
+        plugin: z.ZodString;
+        handle: z.ZodNumber;
+        kind: z.ZodEnum<{
+            change: "change";
+            submit: "submit";
+        }>;
+        value: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+        instance_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        subtype: z.ZodLiteral<"ui_select">;
+        plugin: z.ZodString;
+        handle: z.ZodNumber;
+        value: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+        instance_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        subtype: z.ZodLiteral<"ui_panes">;
+    }, z.core.$strip>, z.ZodObject<{
+        subtype: z.ZodLiteral<"ui_close">;
+        id: z.ZodString;
+    }, z.core.$strip>], "subtype">;
+}, z.core.$strip>;
+export type ViewerMessage = z.infer<typeof ViewerMessageSchema>;
+/** One line the relay sends a viewer. */
+export type RelayMessage = 
+/** The session the relay runs, on connect and whenever it learns more */
+{
+    type: "session";
+    session: SessionInfo;
+}
+/** The engine's answer to a viewer request, or why it failed */
+ | {
+    type: "response";
+    id: string;
+    response?: unknown;
+    error?: string;
+}
+/** An engine push a viewer acts on: `ui_panes` (the pane roster) or `ui_invalidate` (redraw) */
+ | {
+    type: "push";
+    push: Record<string, unknown>;
+};
+/** Subtypes of the engine's `system` messages the relay copies to every viewer. */
+export declare const RELAYED_PUSHES: Set<string>;
+/**
+ * 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 declare function toControlRequest(request: ViewerRequest): Record<string, unknown>;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/relay/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,4EAA4E;AAC5E,eAAO,MAAM,cAAc,WAAa,CAAC;AACzC,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,yFAAyF;AACzF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAoC9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,yCAAyC;AACzC,MAAM,MAAM,YAAY;AACtB,yEAAyE;AACvE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE;AAC3C,gEAAgE;GAC9D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACtE,gGAAgG;GAC9F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEpD,mFAAmF;AACnF,eAAO,MAAM,cAAc,aAAyC,CAAC;AAErE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYhF"}

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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"}