@g3nomaly/mods 0.1.0 → 0.1.2

package/dist/viewer/extension.d.ts

@@ -1,18 +1,28 @@
 /** Lowest Claude Code release whose mod API the g3n mods are written against. */
 export declare const MIN_ENGINE_VERSION = "2.1.296";
-/** One installed copy of the Claude Code VS Code extension. */
+/**
+ * @brief One installed copy of the Claude Code VS Code extension.
+ *
+ * @property version - Release the folder name carries, e.g. `2.1.296`.
+ * @property dir - Absolute extension folder, e.g. `/home/me/.vscode/extensions/anthropic.claude-code-2.1.296`.
+ */
 export interface ClaudeExtension {
     version: string;
-    /** Absolute extension folder */
     dir: string;
 }
-/** Compares two `major.minor.patch` versions; negative when `a` is older than `b`. */
+/**
+ * @brief Compares two `major.minor.patch` versions; negative when `a` is older than `b`.
+ *
+ * @param a - Version to compare, e.g. `2.1.296`.
+ * @param b - Version to compare against, e.g. `2.1.300`.
+ * @returns Negative when `a` is older, `0` when equal, positive when `a` is newer.
+ */
 export declare function compareVersions(a: string, b: string): number;
 /**
- * Newest Claude Code extension installed for any editor of the VS Code family.
+ * @brief Newest Claude Code extension installed for any editor of the VS Code family.
  *
- * @param home - Home directory to search under; the current user's by default
- * @returns the newest copy, or `null` when none is installed
+ * @param home - Home directory to search under; the current user's by default.
+ * @returns The newest copy with its version and folder, or `null` when none is installed.
  */
 export declare function findClaudeExtension(home?: string): ClaudeExtension | null;
 //# sourceMappingURL=extension.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/viewer/extension.ts"],"names":[],"mappings":"AAKA,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAO5C,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,GAAG,EAAM,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAqB,GAAG,eAAe,GAAG,IAAI,CAYvF"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/viewer/extension.ts"],"names":[],"mappings":"AAKA,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAO5C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAM,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAqB,GAAG,eAAe,GAAG,IAAI,CAYvF"}

package/dist/viewer/extension.js

@@ -7,7 +7,13 @@ export const MIN_ENGINE_VERSION = "2.1.296";
 /** Extension folders of the VS Code family, relative to the home directory: local, WSL/SSH server, Insiders, Cursor. */
 const EXTENSION_ROOTS = [".vscode/extensions", ".vscode-server/extensions", ".vscode-insiders/extensions", ".cursor/extensions"];
 const EXTENSION_DIR = /^anthropic\.claude-code-(\d+\.\d+\.\d+)(?:-.+)?$/;
-/** Compares two `major.minor.patch` versions; negative when `a` is older than `b`. */
+/**
+ * @brief Compares two `major.minor.patch` versions; negative when `a` is older than `b`.
+ *
+ * @param a - Version to compare, e.g. `2.1.296`.
+ * @param b - Version to compare against, e.g. `2.1.300`.
+ * @returns Negative when `a` is older, `0` when equal, positive when `a` is newer.
+ */
 export function compareVersions(a, b) {
     const pa = a.split(".").map(Number);
     const pb = b.split(".").map(Number);
@@ -19,10 +25,10 @@ export function compareVersions(a, b) {
     return 0;
 }
 /**
- * Newest Claude Code extension installed for any editor of the VS Code family.
+ * @brief Newest Claude Code extension installed for any editor of the VS Code family.
  *
- * @param home - Home directory to search under; the current user's by default
- * @returns the newest copy, or `null` when none is installed
+ * @param home - Home directory to search under; the current user's by default.
+ * @returns The newest copy with its version and folder, or `null` when none is installed.
  */
 export function findClaudeExtension(home = os.homedir()) {
     let newest = null;

package/dist/viewer/extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/viewer/extension.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,wHAAwH;AACxH,MAAM,eAAe,GAAG,CAAC,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,oBAAoB,CAAC,CAAC;AAEjI,MAAM,aAAa,GAAG,kDAAkD,CAAC;AASzE,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAI,GAAW,EAAE,CAAC,OAAO,EAAE;IAC7D,IAAI,MAAM,GAA2B,IAAI,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,SAAS;gBAAE,SAAS;YACpC,IAAI,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACvH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/viewer/extension.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,wHAAwH;AACxH,MAAM,eAAe,GAAG,CAAC,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,oBAAoB,CAAC,CAAC;AAEjI,MAAM,aAAa,GAAG,kDAAkD,CAAC;AAazE;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAI,GAAW,EAAE,CAAC,OAAO,EAAE;IAC7D,IAAI,MAAM,GAA2B,IAAI,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,SAAS;gBAAE,SAAS;YACpC,IAAI,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACvH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

package/dist/viewer/relay.js

@@ -0,0 +1,51 @@
+// packages/mods/src/viewer/relay.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { hashString } from "@g3nomaly/core/hash";
+import { findPackageRoot } from "@g3nomaly/core/utils";
+/** Where `init` builds the relay: one executable per machine, since VS Code sets the wrapper per machine. */
+export function relayBinaryPath(home = os.homedir()) {
+    return path.join(home, ".claude", "g3n-mods", "bin", "g3n-mods-relay");
+}
+/** The relay's entry and the files it is built from: the compiled ones of an installed package, else the sources of this repository. */
+function relaySources() {
+    const root = findPackageRoot(import.meta.dir);
+    for (const [dir, entry] of [["dist/relay", "index.js"], ["src/relay", "index.ts"]]) {
+        const folder = path.join(root, dir);
+        if (fs.existsSync(path.join(folder, entry))) {
+            const files = fs.readdirSync(folder).filter((name) => /\.(js|ts)$/.test(name) && !name.endsWith(".d.ts")).sort().map((name) => path.join(folder, name));
+            return { entry: path.join(folder, entry), files };
+        }
+    }
+    throw new Error(`no relay sources under ${root}`);
+}
+/**
+ * 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 async function installRelay(home = os.homedir()) {
+    const binary = relayBinaryPath(home);
+    const stamp = `${binary}.sources`;
+    let sources;
+    try {
+        sources = relaySources();
+    }
+    catch (error) {
+        return { kind: "failed", binary, reason: error instanceof Error ? error.message : String(error) };
+    }
+    const hash = await hashString(sources.files.map((file) => fs.readFileSync(file, "utf8")).join("\0"));
+    if (fs.existsSync(binary) && fs.existsSync(stamp) && fs.readFileSync(stamp, "utf8") === hash)
+        return { kind: "current", binary };
+    fs.mkdirSync(path.dirname(binary), { recursive: true });
+    const built = Bun.spawnSync(["bun", "build", "--compile", sources.entry, "--outfile", binary], { stdout: "pipe", stderr: "pipe" });
+    if (built.exitCode !== 0) {
+        return { kind: "failed", binary, reason: built.stderr.toString().trim() || `bun build exited with ${built.exitCode}` };
+    }
+    fs.writeFileSync(stamp, hash);
+    return { kind: "built", binary };
+}
+//# sourceMappingURL=relay.js.map

package/dist/viewer/relay.js.map

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

package/dist/viewer/settings.d.ts

@@ -4,28 +4,34 @@ export declare const ViewerLocationSchema: z.ZodEnum<{
     panel: "panel";
     sidebar: "sidebar";
 }>;
+/** Value of `ViewerLocationSchema`: `panel` for an editor tab, `sidebar` for the side bar. */
 export type ViewerLocation = z.infer<typeof ViewerLocationSchema>;
-/** What `configureViewer` did to the workspace settings. */
+/**
+ * @brief What `configureViewer` did to the workspace settings.
+ *
+ * @property kind - `written` when the file changed, `unchanged` when it already held the values, `unreadable` when the file is not plain JSON (comments, trailing commas); nothing is written then.
+ * @property file - Absolute path of `.vscode/settings.json`.
+ * @property settings - Values that would have been written; present only with `unreadable`.
+ */
 export type ViewerSettingsResult = {
     kind: "written";
     file: string;
 } | {
     kind: "unchanged";
     file: string;
-}
-/** The file exists but is not plain JSON (comments, trailing commas); nothing was written */
- | {
+} | {
     kind: "unreadable";
     file: string;
     settings: Record<string, unknown>;
 };
 /**
- * Points the project's VS Code workspace at the extension's native UI, the
+ * @brief Points the project's VS Code workspace at the extension's native UI, the
  * surface mods draw on: sets where Claude opens and turns off terminal mode.
  * Other settings in the file are kept.
  *
- * @param projectRoot - Absolute project root holding `.vscode/`
- * @param location - Where Claude opens; when absent, a location already set is kept and `panel` is the default
+ * @param projectRoot - Absolute project root holding `.vscode/`.
+ * @param location - Where Claude opens; when absent, a location already set is kept and `panel` is the default.
+ * @returns What was done to the settings file.
  */
 export declare function configureViewer(projectRoot: string, location?: ViewerLocation): ViewerSettingsResult;
 //# sourceMappingURL=settings.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/viewer/settings.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,eAAO,MAAM,oBAAoB;;;EAA+B,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAQlE,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrC,6FAA6F;GAC3F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAkBpG"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/viewer/settings.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,eAAO,MAAM,oBAAoB;;;EAA+B,CAAC;AAEjE,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAQlE;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE5E;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAkBpG"}

package/dist/viewer/settings.js

@@ -9,12 +9,13 @@ const LOCATION_KEY = "claudeCode.preferredLocation";
 const TERMINAL_KEY = "claudeCode.useTerminal";
 const SettingsSchema = z.record(z.string(), z.unknown());
 /**
- * Points the project's VS Code workspace at the extension's native UI, the
+ * @brief Points the project's VS Code workspace at the extension's native UI, the
  * surface mods draw on: sets where Claude opens and turns off terminal mode.
  * Other settings in the file are kept.
  *
- * @param projectRoot - Absolute project root holding `.vscode/`
- * @param location - Where Claude opens; when absent, a location already set is kept and `panel` is the default
+ * @param projectRoot - Absolute project root holding `.vscode/`.
+ * @param location - Where Claude opens; when absent, a location already set is kept and `panel` is the default.
+ * @returns What was done to the settings file.
  */
 export function configureViewer(projectRoot, location) {
     const file = path.join(projectRoot, SETTINGS_FILE);
@@ -33,6 +34,12 @@ export function configureViewer(projectRoot, location) {
     fs.writeFileSync(file, JSON.stringify({ ...current, ...wanted }, null, 2) + "\n");
     return { kind: "written", file };
 }
+/**
+ * @brief Parses JSON text, returning `undefined` instead of throwing.
+ *
+ * @param text - Raw file contents, e.g. the text of a `settings.json` file.
+ * @returns The parsed value, or `undefined` when the text is not valid JSON.
+ */
 function safeJson(text) {
     try {
         return JSON.parse(text);

package/dist/viewer/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/viewer/settings.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAIjE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC5D,MAAM,YAAY,GAAI,8BAA8B,CAAC;AACrD,MAAM,YAAY,GAAI,wBAAwB,CAAC;AAE/C,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AASzD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,QAAyB;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEnD,IAAI,OAAO,GAAwC,EAAE,CAAC;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAK,oBAAoB,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IAC3G,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEjF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE/G,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/viewer/settings.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAKjE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC5D,MAAM,YAAY,GAAI,8BAA8B,CAAC;AACrD,MAAM,YAAY,GAAI,wBAAwB,CAAC;AAE/C,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAczD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,QAAyB;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEnD,IAAI,OAAO,GAAwC,EAAE,CAAC;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAK,oBAAoB,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IAC3G,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEjF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE/G,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/viewer/viewerExtension.d.ts

@@ -0,0 +1,27 @@
+/** The viewer extension's id in VS Code: `<publisher>.<name>` from `vscode/package.json`. */
+export declare const VIEWER_EXTENSION_ID = "g3nomaly.g3n-mods-viewer";
+/** Absolute path of the packed viewer, built into `dist/vscode/` by `bun run build`. */
+export declare function viewerPackagePath(): string;
+/** What `installViewer` did. */
+export type ViewerInstallResult = {
+    kind: "installed";
+    cli: string;
+} | {
+    kind: "no-package";
+    vsix: string;
+} | {
+    kind: "no-cli";
+    vsix: string;
+} | {
+    kind: "failed";
+    vsix: string;
+    reason: string;
+};
+/**
+ * Installs the viewer extension into VS Code with `code --install-extension`,
+ * replacing an older copy.
+ *
+ * @param home - Home directory to look for a VS Code server under; the current user's by default
+ */
+export declare function installViewer(home?: string): ViewerInstallResult;
+//# sourceMappingURL=viewerExtension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewerExtension.d.ts","sourceRoot":"","sources":["../../src/viewer/viewerExtension.ts"],"names":[],"mappings":"AAMA,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,wFAAwF;AACxF,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,gCAAgC;AAChC,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBrD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAqB,GAAG,mBAAmB,CAQ9E"}

package/dist/viewer/viewerExtension.js

@@ -0,0 +1,48 @@
+// packages/mods/src/viewer/viewerExtension.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { findPackageRoot } from "@g3nomaly/core/utils";
+/** The viewer extension's id in VS Code: `<publisher>.<name>` from `vscode/package.json`. */
+export const VIEWER_EXTENSION_ID = "g3nomaly.g3n-mods-viewer";
+/** Absolute path of the packed viewer, built into `dist/vscode/` by `bun run build`. */
+export function viewerPackagePath() {
+    return path.join(findPackageRoot(import.meta.dir), "dist", "vscode", "g3n-mods-viewer.vsix");
+}
+/** VS Code's `code` command: on the PATH, else the one a VS Code server ships for its own terminals. */
+function findCodeCli(home) {
+    for (const dir of (process.env.PATH ?? "").split(path.delimiter)) {
+        for (const name of process.platform === "win32" ? ["code.cmd", "code"] : ["code"]) {
+            const candidate = path.join(dir, name);
+            if (dir !== "" && fs.existsSync(candidate))
+                return candidate;
+        }
+    }
+    const servers = path.join(home, ".vscode-server", "bin");
+    if (!fs.existsSync(servers))
+        return null;
+    const clis = fs.readdirSync(servers)
+        .map((commit) => path.join(servers, commit, "bin", "remote-cli", "code"))
+        .filter((cli) => fs.existsSync(cli))
+        .sort((a, b) => fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs);
+    return clis[0] ?? null;
+}
+/**
+ * Installs the viewer extension into VS Code with `code --install-extension`,
+ * replacing an older copy.
+ *
+ * @param home - Home directory to look for a VS Code server under; the current user's by default
+ */
+export function installViewer(home = os.homedir()) {
+    const vsix = viewerPackagePath();
+    if (!fs.existsSync(vsix))
+        return { kind: "no-package", vsix };
+    const cli = findCodeCli(home);
+    if (cli === null)
+        return { kind: "no-cli", vsix };
+    const run = Bun.spawnSync([cli, "--install-extension", vsix, "--force"], { stdout: "pipe", stderr: "pipe" });
+    if (run.exitCode !== 0)
+        return { kind: "failed", vsix, reason: (run.stderr.toString() || run.stdout.toString()).trim() };
+    return { kind: "installed", cli };
+}
+//# sourceMappingURL=viewerExtension.js.map

package/dist/viewer/viewerExtension.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@g3nomaly/mods",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Installer for Claude Code mods: registers mod sources and installs, updates and removes mods from them.",
   "type": "module",
   "bin": {
@@ -18,18 +18,22 @@
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf dist && tsc --project tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "mods": "bun run src/cli/index.ts"
+    "build": "rm -rf dist && tsc --project tsconfig.build.json && bun run build:viewer",
+    "typecheck": "tsc --noEmit && tsc --noEmit --project vscode/tsconfig.json",
+    "mods": "bun run src/cli/index.ts",
+    "build:viewer": "bun scripts/build-viewer.ts"
   },
   "dependencies": {
-    "@g3nomaly/core": "^0.3.1",
+    "@g3nomaly/core": "^0.3.3",
     "chalk": "^6.0.0",
     "commander": "^15.0.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/bun": "^1.4.0",
+    "@types/node": "^22",
+    "@types/vscode": "~1.100.0",
+    "marked": "^16",
     "typescript": "~7.0.2"
   },
   "license": "Elastic-2.0",