coderaft 0.0.41 → 0.0.42

package/README.md

@@ -186,7 +186,7 @@ const instance = await startCodeServer({
 Works with `createCodeServer`, `startCodeServer`, and `spawnCodeServer`, and on the CLI:
 
 ```sh
-coderaft --install-extension esbenp.prettier-vscode --install-extension dbaeumer.vscode-eslint
+coderaft --preinstall-extension esbenp.prettier-vscode --preinstall-extension dbaeumer.vscode-eslint
 ```
 
 - **Idempotent** — already-installed extensions are skipped, so warm restarts pay no cost. Installs run only when something is missing.
@@ -196,6 +196,18 @@ coderaft --install-extension esbenp.prettier-vscode --install-extension dbaeumer
 > [!NOTE]
 > Installation runs in a short-lived child process before the server boots (VS Code's extension CLI calls `process.exit()` when done). The first cold start with new extensions takes ~1s longer per extension; subsequent starts are instant.
 
+### Managing extensions without starting a server
+
+`--install-extension`, `--uninstall-extension`, and `--list-extensions` behave like the `code` CLI: they act on the extensions dir, print the result, and exit. That is what tooling which shells out to `code --install-extension <id>` (IDE extension installers, provisioning scripts) expects, so coderaft can stand in for `code` on the `PATH`.
+
+```sh
+coderaft --install-extension esbenp.prettier-vscode   # add --force to reinstall
+coderaft --list-extensions --show-versions
+coderaft --uninstall-extension esbenp.prettier-vscode
+```
+
+The exit code reflects the outcome — a spec that failed to install exits non-zero. Use `--preinstall-extension` when you want to install _and then_ serve.
+
 ## CLI Options
 
 ### Server
@@ -273,15 +285,28 @@ coderaft --install-extension esbenp.prettier-vscode --install-extension dbaeumer
 | `--disable-update-check`    | Disable update check                             |
 | `--disable-experiments`     | Disable experiments                              |
 
+### Extension Management
+
+These run against the extensions dir and exit without starting a server (see [Extensions](#extensions)).
+
+| Option                           | Description                                           |
+| -------------------------------- | ----------------------------------------------------- |
+| `--install-extension <ext-id>`   | Install an extension from Open VSX (repeatable)       |
+| `--uninstall-extension <ext-id>` | Uninstall an extension (repeatable)                   |
+| `--list-extensions`              | List installed extensions                             |
+| `--show-versions`                | Show versions in `--list-extensions` output           |
+| `--force`                        | Reinstall even if the extension is already installed  |
+| `--pre-release`                  | Install the pre-release version when one is available |
+
 ### Features
 
-| Option                               | Description                                                                       |
-| ------------------------------------ | --------------------------------------------------------------------------------- |
-| `--enable-sync`                      | Enable settings sync                                                              |
-| `--install-extension <ext-id>`       | Preinstall an extension from Open VSX (repeatable, see [Extensions](#extensions)) |
-| `--enable-proposed-api <ext-id>`     | Enable proposed API for an extension (repeatable)                                 |
-| `--disable-workspace-trust`          | Disable workspace trust                                                           |
-| `--disable-getting-started-override` | Disable getting started override                                                  |
+| Option                               | Description                                                                                 |
+| ------------------------------------ | ------------------------------------------------------------------------------------------- |
+| `--enable-sync`                      | Enable settings sync                                                                        |
+| `--preinstall-extension <ext-id>`    | Install an extension before starting the server (repeatable, see [Extensions](#extensions)) |
+| `--enable-proposed-api <ext-id>`     | Enable proposed API for an extension (repeatable)                                           |
+| `--disable-workspace-trust`          | Disable workspace trust                                                                     |
+| `--disable-getting-started-override` | Disable getting started override                                                            |
 
 ### Remote
 

package/code.mjs

@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
 
 // Auto-updated by scripts/pack.ts
-const codeArchiveHash = "5c5869e2d6a5cfa9";
+const codeArchiveHash = "1bd91db31c40505f";
 
 const archivePath = fileURLToPath(new URL("./code.tar.zst", import.meta.url));
 

package/dist/_chunks/_args.mjs

@@ -44,11 +44,23 @@ const cliOptions = {
 	"disable-telemetry": { type: "boolean" },
 	"disable-update-check": { type: "boolean" },
 	"disable-experiments": { type: "boolean" },
-	"enable-sync": { type: "boolean" },
 	"install-extension": {
 		type: "string",
 		multiple: true
 	},
+	"uninstall-extension": {
+		type: "string",
+		multiple: true
+	},
+	"list-extensions": { type: "boolean" },
+	"show-versions": { type: "boolean" },
+	force: { type: "boolean" },
+	"pre-release": { type: "boolean" },
+	"enable-sync": { type: "boolean" },
+	"preinstall-extension": {
+		type: "string",
+		multiple: true
+	},
 	"disable-extensions": { type: "boolean" },
 	"disable-extension": {
 		type: "string",
@@ -184,9 +196,17 @@ const helpText = `
         --disable-update-check           Disable update check
         --disable-experiments            Disable experiments
 
+  Extensions (run and exit, no server):
+        --install-extension <ext-id>     Install an extension from Open VSX (repeatable)
+        --uninstall-extension <ext-id>   Uninstall an extension (repeatable)
+        --list-extensions                List installed extensions
+        --show-versions                  Show versions in --list-extensions output
+        --force                          Reinstall even if already installed
+        --pre-release                    Install the pre-release version when available
+
   Features:
         --enable-sync                    Enable settings sync
-        --install-extension <ext-id>     Preinstall an extension from Open VSX before start (repeatable)
+        --preinstall-extension <ext-id>  Install an extension before starting the server (repeatable)
         --disable-extensions             Disable all installed extensions
         --disable-extension <ext-id>     Disable specific extension (repeatable)
         --enable-proposed-api <ext-id>   Enable proposed API for extension (repeatable)

package/dist/_chunks/extensions.mjs

@@ -0,0 +1,196 @@
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
+import { fork } from "node:child_process";
+import { join } from "node:path";
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
+if (process.platform === "android") {
+	if (process.execPath.includes("linker64") || process.execPath.startsWith("/apex/")) {
+		const resolved = process.env.TERMUX_EXEC__PROC_SELF_EXE || "/data/data/com.termux/files/usr/bin/node";
+		Object.defineProperty(process, "execPath", {
+			value: resolved,
+			writable: true,
+			configurable: true,
+			enumerable: true
+		});
+	}
+	const preload = `--require "${fileURLToPath(import.meta.resolve("#android-preload"))}"`;
+	process.env.NODE_OPTIONS = process.env.NODE_OPTIONS ? `${process.env.NODE_OPTIONS} ${preload}` : preload;
+	const _fs = process.getBuiltinModule?.("fs") ?? __require("node:fs");
+	const { syncBuiltinESMExports: _syncESM } = process.getBuiltinModule?.("module") ?? __require("node:module");
+	const TERMUX_EXEC_LIB = "/data/data/com.termux/files/usr/lib/libtermux-exec.so";
+	try {
+		_fs.accessSync(TERMUX_EXEC_LIB);
+		const _cp = process.getBuiltinModule?.("child_process") ?? __require("node:child_process");
+		const _injectLdPreload = (opts) => {
+			if (opts && typeof opts === "object" && opts.env) {
+				const env = opts.env;
+				if (!env.LD_PRELOAD) env.LD_PRELOAD = TERMUX_EXEC_LIB;
+			}
+		};
+		const _spawn = _cp.spawn;
+		_cp.spawn = function spawn(...spawnArgs) {
+			_injectLdPreload(spawnArgs[2]);
+			return _spawn.apply(this, spawnArgs);
+		};
+		const _fork = _cp.fork;
+		_cp.fork = function fork(modulePath, ...rest) {
+			for (const arg of rest) if (arg && typeof arg === "object" && !Array.isArray(arg)) {
+				_injectLdPreload(arg);
+				break;
+			}
+			return _fork.call(this, modulePath, ...rest);
+		};
+		_syncESM();
+	} catch {}
+	if (process.env.PATH) {
+		const accessible = process.env.PATH.split(":").filter((dir) => {
+			try {
+				_fs.accessSync(dir, _fs.constants.R_OK);
+				return true;
+			} catch {
+				return false;
+			}
+		});
+		if (accessible.length > 0) process.env.PATH = accessible.join(":");
+	}
+	const _os = process.getBuiltinModule?.("os") ?? __require("node:os");
+	const _crypto = process.getBuiltinModule?.("crypto") ?? __require("node:crypto");
+	const BLACKLISTED = /* @__PURE__ */ new Set([
+		"00:00:00:00:00:00",
+		"ff:ff:ff:ff:ff:ff",
+		"ac:de:48:00:11:22"
+	]);
+	const original = _os.networkInterfaces;
+	_os.networkInterfaces = function networkInterfaces() {
+		const ifaces = original.call(_os);
+		for (const name in ifaces) for (const info of ifaces[name]) if (info.mac && !BLACKLISTED.has(info.mac)) return ifaces;
+		const hash = _crypto.createHash("md5").update(_os.hostname()).digest();
+		hash[0] = (hash[0] | 2) & 254;
+		ifaces._coderaft = [{
+			address: "10.0.0.1",
+			netmask: "255.255.255.0",
+			family: "IPv4",
+			mac: [...hash.subarray(0, 6)].map((b) => b.toString(16).padStart(2, "0")).join(":"),
+			internal: false,
+			cidr: "10.0.0.1/24"
+		}];
+		return ifaces;
+	};
+	_syncESM();
+}
+var extensions_exports = /* @__PURE__ */ __exportAll({
+	ensureExtensions: () => ensureExtensions,
+	readInstalledExtensions: () => readInstalledExtensions,
+	resolveExtensionDirs: () => resolveExtensionDirs,
+	runExtensionCommand: () => runExtensionCommand
+});
+const _os = process.getBuiltinModule?.("os") ?? __require("node:os");
+function resolveExtensionDirs(vscode = {}) {
+	const serverDataDir = vscode["server-data-dir"] ?? join(_os.homedir(), ".vscode-server-oss");
+	return {
+		serverDataDir,
+		userDataDir: vscode["user-data-dir"] ?? join(serverDataDir, "data"),
+		extensionsDir: vscode["extensions-dir"] ?? join(serverDataDir, "extensions")
+	};
+}
+function readInstalledExtensions(extensionsDir) {
+	try {
+		const raw = readFileSync(join(extensionsDir, "extensions.json"), "utf8");
+		const entries = JSON.parse(raw);
+		return new Set(entries.map((e) => e.identifier?.id?.toLowerCase()).filter((id) => typeof id === "string"));
+	} catch {
+		return /* @__PURE__ */ new Set();
+	}
+}
+function specId(spec) {
+	const at = spec.indexOf("@", 1);
+	return (at === -1 ? spec : spec.slice(0, at)).toLowerCase();
+}
+function pendingExtensions(specs, extensionsDir) {
+	const installed = readInstalledExtensions(extensionsDir);
+	return specs.filter((spec) => {
+		if (spec.toLowerCase().endsWith(".vsix")) return true;
+		return !installed.has(specId(spec));
+	});
+}
+async function ensureExtensions(specs, opts) {
+	const pending = opts.force ? specs : pendingExtensions(specs, opts.extensionsDir);
+	if (pending.length === 0) return;
+	console.log(`[coderaft] Installing ${pending.length} extension${pending.length === 1 ? "" : "s"}: ${pending.join(", ")}`);
+	await forkCli({
+		ids: pending,
+		...opts
+	});
+	const installed = readInstalledExtensions(opts.extensionsDir);
+	for (const spec of pending) {
+		if (spec.toLowerCase().endsWith(".vsix")) continue;
+		if (!installed.has(specId(spec))) console.warn(`[coderaft] Extension failed to install: ${spec}`);
+	}
+}
+async function runExtensionCommand(cmd, dirs) {
+	const code = await forkCli({
+		ids: cmd.install,
+		...cmd,
+		...dirs
+	});
+	if (code !== 0 || !cmd.install?.length) return code;
+	const installed = readInstalledExtensions(dirs.extensionsDir);
+	const failed = cmd.install.filter((spec) => !spec.toLowerCase().endsWith(".vsix") && !installed.has(specId(spec)));
+	if (failed.length === 0) return 0;
+	console.error(`[coderaft] Extension failed to install: ${failed.join(", ")}`);
+	return 1;
+}
+function forkCli(cfg) {
+	const installPath = fileURLToPath(import.meta.resolve("#install"));
+	return new Promise((resolve, reject) => {
+		const child = fork(installPath, {
+			stdio: [
+				"ignore",
+				"pipe",
+				"inherit",
+				"ipc"
+			],
+			env: {
+				...process.env,
+				CODERAFT_INSTALL: JSON.stringify({
+					ids: cfg.ids,
+					uninstall: cfg.uninstall,
+					list: cfg.list,
+					showVersions: cfg.showVersions,
+					extensionsDir: cfg.extensionsDir,
+					userDataDir: cfg.userDataDir,
+					serverDataDir: cfg.serverDataDir,
+					force: cfg.force,
+					preRelease: cfg.preRelease
+				})
+			}
+		});
+		let buf = "";
+		child.stdout?.on("data", (chunk) => {
+			buf += chunk.toString();
+			const lines = buf.split("\n");
+			buf = lines.pop() ?? "";
+			for (const line of lines) {
+				if (/^\s*(info|debug|trace)\s+\[/.test(line)) continue;
+				if (line.trim()) console.log(line);
+			}
+		});
+		child.once("exit", (code, signal) => {
+			if (buf.trim() && !/^\s*(info|debug|trace)\s+\[/.test(buf)) console.log(buf);
+			resolve(code ?? (signal ? 1 : 0));
+		});
+		child.once("error", reject);
+	});
+}
+export { __exportAll, ensureExtensions, extensions_exports, readInstalledExtensions, resolveExtensionDirs, runExtensionCommand };

package/dist/_chunks/server.mjs

@@ -1,169 +1,12 @@
+import { __exportAll, ensureExtensions, resolveExtensionDirs } from "./extensions.mjs";
 import { createProxyServer } from "./libs/httpxy.mjs";
-import { createRequire } from "node:module";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { pathToFileURL } from "node:url";
 import { createReadStream, readFileSync, readdirSync, unlinkSync } from "node:fs";
-import { fork } from "node:child_process";
 import { randomBytes, randomUUID } from "node:crypto";
 import { createServer } from "node:http";
 import { extname, join, normalize, sep } from "node:path";
 import { stat } from "node:fs/promises";
 import { loadCode } from "#code";
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
-if (process.platform === "android") {
-	if (process.execPath.includes("linker64") || process.execPath.startsWith("/apex/")) {
-		const resolved = process.env.TERMUX_EXEC__PROC_SELF_EXE || "/data/data/com.termux/files/usr/bin/node";
-		Object.defineProperty(process, "execPath", {
-			value: resolved,
-			writable: true,
-			configurable: true,
-			enumerable: true
-		});
-	}
-	const preload = `--require "${fileURLToPath(import.meta.resolve("#android-preload"))}"`;
-	process.env.NODE_OPTIONS = process.env.NODE_OPTIONS ? `${process.env.NODE_OPTIONS} ${preload}` : preload;
-	const _fs = process.getBuiltinModule?.("fs") ?? __require("node:fs");
-	const { syncBuiltinESMExports: _syncESM } = process.getBuiltinModule?.("module") ?? __require("node:module");
-	const TERMUX_EXEC_LIB = "/data/data/com.termux/files/usr/lib/libtermux-exec.so";
-	try {
-		_fs.accessSync(TERMUX_EXEC_LIB);
-		const _cp = process.getBuiltinModule?.("child_process") ?? __require("node:child_process");
-		const _injectLdPreload = (opts) => {
-			if (opts && typeof opts === "object" && opts.env) {
-				const env = opts.env;
-				if (!env.LD_PRELOAD) env.LD_PRELOAD = TERMUX_EXEC_LIB;
-			}
-		};
-		const _spawn = _cp.spawn;
-		_cp.spawn = function spawn(...spawnArgs) {
-			_injectLdPreload(spawnArgs[2]);
-			return _spawn.apply(this, spawnArgs);
-		};
-		const _fork = _cp.fork;
-		_cp.fork = function fork(modulePath, ...rest) {
-			for (const arg of rest) if (arg && typeof arg === "object" && !Array.isArray(arg)) {
-				_injectLdPreload(arg);
-				break;
-			}
-			return _fork.call(this, modulePath, ...rest);
-		};
-		_syncESM();
-	} catch {}
-	if (process.env.PATH) {
-		const accessible = process.env.PATH.split(":").filter((dir) => {
-			try {
-				_fs.accessSync(dir, _fs.constants.R_OK);
-				return true;
-			} catch {
-				return false;
-			}
-		});
-		if (accessible.length > 0) process.env.PATH = accessible.join(":");
-	}
-	const _os = process.getBuiltinModule?.("os") ?? __require("node:os");
-	const _crypto = process.getBuiltinModule?.("crypto") ?? __require("node:crypto");
-	const BLACKLISTED = /* @__PURE__ */ new Set([
-		"00:00:00:00:00:00",
-		"ff:ff:ff:ff:ff:ff",
-		"ac:de:48:00:11:22"
-	]);
-	const original = _os.networkInterfaces;
-	_os.networkInterfaces = function networkInterfaces() {
-		const ifaces = original.call(_os);
-		for (const name in ifaces) for (const info of ifaces[name]) if (info.mac && !BLACKLISTED.has(info.mac)) return ifaces;
-		const hash = _crypto.createHash("md5").update(_os.hostname()).digest();
-		hash[0] = (hash[0] | 2) & 254;
-		ifaces._coderaft = [{
-			address: "10.0.0.1",
-			netmask: "255.255.255.0",
-			family: "IPv4",
-			mac: [...hash.subarray(0, 6)].map((b) => b.toString(16).padStart(2, "0")).join(":"),
-			internal: false,
-			cidr: "10.0.0.1/24"
-		}];
-		return ifaces;
-	};
-	_syncESM();
-}
-function readInstalledExtensions(extensionsDir) {
-	try {
-		const raw = readFileSync(join(extensionsDir, "extensions.json"), "utf8");
-		const entries = JSON.parse(raw);
-		return new Set(entries.map((e) => e.identifier?.id?.toLowerCase()).filter((id) => typeof id === "string"));
-	} catch {
-		return /* @__PURE__ */ new Set();
-	}
-}
-function specId(spec) {
-	const at = spec.indexOf("@", 1);
-	return (at === -1 ? spec : spec.slice(0, at)).toLowerCase();
-}
-function pendingExtensions(specs, extensionsDir) {
-	const installed = readInstalledExtensions(extensionsDir);
-	return specs.filter((spec) => {
-		if (spec.toLowerCase().endsWith(".vsix")) return true;
-		return !installed.has(specId(spec));
-	});
-}
-async function ensureExtensions(specs, opts) {
-	const pending = opts.force ? specs : pendingExtensions(specs, opts.extensionsDir);
-	if (pending.length === 0) return;
-	console.log(`[coderaft] Installing ${pending.length} extension${pending.length === 1 ? "" : "s"}: ${pending.join(", ")}`);
-	await runInstall(pending, opts);
-	const installed = readInstalledExtensions(opts.extensionsDir);
-	for (const spec of pending) {
-		if (spec.toLowerCase().endsWith(".vsix")) continue;
-		if (!installed.has(specId(spec))) console.warn(`[coderaft] Extension failed to install: ${spec}`);
-	}
-}
-function runInstall(specs, opts) {
-	const installPath = fileURLToPath(import.meta.resolve("#install"));
-	return new Promise((resolve, reject) => {
-		const child = fork(installPath, {
-			stdio: [
-				"ignore",
-				"pipe",
-				"inherit",
-				"ipc"
-			],
-			env: {
-				...process.env,
-				CODERAFT_INSTALL: JSON.stringify({
-					ids: specs,
-					extensionsDir: opts.extensionsDir,
-					userDataDir: opts.userDataDir,
-					serverDataDir: opts.serverDataDir,
-					force: opts.force,
-					preRelease: opts.preRelease
-				})
-			}
-		});
-		let buf = "";
-		child.stdout?.on("data", (chunk) => {
-			buf += chunk.toString();
-			const lines = buf.split("\n");
-			buf = lines.pop() ?? "";
-			for (const line of lines) {
-				if (/^\s*(info|debug|trace)\s+\[/.test(line)) continue;
-				if (line.trim()) console.log(line);
-			}
-		});
-		child.once("exit", () => {
-			if (buf.trim() && !/^\s*(info|debug|trace)\s+\[/.test(buf)) console.log(buf);
-			resolve();
-		});
-		child.once("error", reject);
-	});
-}
 const STATIC_MIME = {
 	".js": "text/javascript",
 	".mjs": "text/javascript",
@@ -209,7 +52,6 @@ var server_exports = /* @__PURE__ */ __exportAll({
 	createCodeServer: () => createCodeServer,
 	startCodeServer: () => startCodeServer
 });
-const _os = process.getBuiltinModule?.("os") ?? __require("node:os");
 const MANIFEST_BODY = JSON.stringify({
 	name: "coderaft",
 	short_name: "coderaft",
@@ -242,9 +84,7 @@ async function createCodeServer(opts = {}) {
 	process.env.NODE_EXEC_PATH ??= process.execPath;
 	if (opts.proxyURI) process.env.VSCODE_PROXY_URI = opts.proxyURI;
 	else if (baseURL) process.env.VSCODE_PROXY_URI ??= `${baseURL}/proxy/{{port}}/`;
-	const serverDataDir = opts.vscode?.["server-data-dir"] ?? join(_os.homedir(), ".vscode-server-oss");
-	const userDataDir = opts.vscode?.["user-data-dir"] ?? join(serverDataDir, "data");
-	const extensionsDir = opts.vscode?.["extensions-dir"] ?? join(serverDataDir, "extensions");
+	const { serverDataDir, userDataDir, extensionsDir } = resolveExtensionDirs(opts.vscode);
 	cleanupStaleLocks(userDataDir);
 	watchChildProcessHealth();
 	const { modulesDir } = await loadCode();
@@ -511,4 +351,4 @@ function sendJson(res, status, body) {
 	});
 	res.end(payload);
 }
-export { createCodeServer, ensureExtensions, readInstalledExtensions, server_exports, startCodeServer };
+export { createCodeServer, server_exports, startCodeServer };

package/dist/cli.mjs

@@ -237,6 +237,19 @@ async function startMain() {
 	const vscode = {};
 	for (const key of vsKeys) if (values[key] !== void 0) vscode[key] = values[key];
 	if (values["logs-path"]) vscode.logsPath = values["logs-path"];
+	const install = values["install-extension"];
+	const uninstall = values["uninstall-extension"];
+	if (install?.length || uninstall?.length || values["list-extensions"]) {
+		const { resolveExtensionDirs, runExtensionCommand } = await import("./_chunks/extensions.mjs").then((n) => n.extensions_exports);
+		process.exit(await runExtensionCommand({
+			install,
+			uninstall,
+			list: values["list-extensions"],
+			showVersions: values["show-versions"],
+			force: values.force,
+			preRelease: values["pre-release"]
+		}, resolveExtensionDirs(vscode)));
+	}
 	const dir = positionals[0];
 	if (dir) vscode["disable-workspace-trust"] = true;
 	const opts = {
@@ -247,7 +260,7 @@ async function startMain() {
 		proxyURI: values["proxy-uri"],
 		defaultFolder: dir || values["default-folder"],
 		connectionToken: values["connection-token"] ?? values.token,
-		extensions: values["install-extension"],
+		extensions: values["preinstall-extension"],
 		vscode
 	};
 	const interactive = process.stdout.isTTY && !values["no-tui"];

package/dist/index.d.mts

@@ -204,6 +204,20 @@ declare class SpawnedCodeServer extends EventEmitter {
   reload(): Promise<void>;
 }
 declare function spawnCodeServer(opts?: SpawnCodeServerOptions): Promise<SpawnedCodeServer>;
+interface ExtensionDirs {
+  /** VS Code server data directory. */
+  serverDataDir: string;
+  /** VS Code user data directory. */
+  userDataDir: string;
+  /** Directory extensions are installed into. */
+  extensionsDir: string;
+}
+/**
+ * Resolve the data directories extension management and the running server must
+ * agree on, mirroring VS Code's OSS server defaults
+ * (`~/.vscode-server-oss/{,data,extensions}`).
+ */
+declare function resolveExtensionDirs(vscode?: VSCodeServerOptions): ExtensionDirs;
 interface EnsureExtensionsOptions {
   /** Directory extensions are installed into (must match the running server). */
   extensionsDir: string;
@@ -230,4 +244,28 @@ declare function readInstalledExtensions(extensionsDir: string): Set<string>;
  * so a bad id or a gallery outage never blocks startup.
  */
 declare function ensureExtensions(specs: string[], opts: EnsureExtensionsOptions): Promise<void>;
-export { type CodeServerHandle, type CodeServerHandler, type CreateCodeServerOptions, type EnsureExtensionsOptions, type SpawnCodeServerOptions, type SpawnProcessOptions, SpawnedCodeServer, type StartCodeServerOptions, createCodeServer, ensureExtensions, readInstalledExtensions, spawnCodeServer, startCodeServer };
+interface ExtensionCommand {
+  /** Specs to install: gallery id, `id@version`, or a path to a local `.vsix`. */
+  install?: string[];
+  /** Extension ids to uninstall. */
+  uninstall?: string[];
+  /** Print the installed extensions to stdout. */
+  list?: boolean;
+  /** Append `@version` to each id in `list` output. */
+  showVersions?: boolean;
+  /** Reinstall even if the extension is already present. */
+  force?: boolean;
+  /** Install pre-release versions when available. */
+  preRelease?: boolean;
+}
+/**
+ * Run VS Code's own extension CLI to completion and resolve with the exit code
+ * to hand back to the shell. This backs the `code`-compatible one-shot commands
+ * (`--install-extension`, `--uninstall-extension`, `--list-extensions`), which
+ * manage extensions and exit instead of booting a server.
+ *
+ * A zero exit from the CLI is verified against the extensions manifest, so a
+ * spec that silently didn't land still reports failure to the caller.
+ */
+declare function runExtensionCommand(cmd: ExtensionCommand, dirs: ExtensionDirs): Promise<number>;
+export { type CodeServerHandle, type CodeServerHandler, type CreateCodeServerOptions, type EnsureExtensionsOptions, type ExtensionCommand, type ExtensionDirs, type SpawnCodeServerOptions, type SpawnProcessOptions, SpawnedCodeServer, type StartCodeServerOptions, createCodeServer, ensureExtensions, readInstalledExtensions, resolveExtensionDirs, runExtensionCommand, spawnCodeServer, startCodeServer };

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { createCodeServer, ensureExtensions, readInstalledExtensions, startCodeServer } from "./_chunks/server.mjs";
+import { ensureExtensions, readInstalledExtensions, resolveExtensionDirs, runExtensionCommand } from "./_chunks/extensions.mjs";
+import { createCodeServer, startCodeServer } from "./_chunks/server.mjs";
 import { fileURLToPath } from "node:url";
 import { fork } from "node:child_process";
 import { EventEmitter } from "node:events";
@@ -168,4 +169,4 @@ async function terminateChild(proc) {
 		proc.kill("SIGTERM");
 	});
 }
-export { SpawnedCodeServer, createCodeServer, ensureExtensions, readInstalledExtensions, spawnCodeServer, startCodeServer };
+export { SpawnedCodeServer, createCodeServer, ensureExtensions, readInstalledExtensions, resolveExtensionDirs, runExtensionCommand, spawnCodeServer, startCodeServer };

package/install.mjs

@@ -1,8 +1,9 @@
-// Forked child entry used to preinstall extensions through VS Code's own CLI
-// (`spawnCli`). This runs in a dedicated process because `spawnCli` calls
-// `process.exit()` once installs settle — doing it in-process would tear down
-// the parent's long-lived server. Config is passed via the `CODERAFT_INSTALL`
-// env var (JSON); progress is logged to stdout/stderr by VS Code itself.
+// Forked child entry used to drive extension management through VS Code's own
+// CLI (`spawnCli`) — install, uninstall, and list. This runs in a dedicated
+// process because `spawnCli` calls `process.exit()` once the command settles —
+// doing it in-process would tear down the parent's long-lived server. Config is
+// passed via the `CODERAFT_INSTALL` env var (JSON); progress is logged to
+// stdout/stderr by VS Code itself.
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { loadCode } from "#code";
@@ -19,12 +20,25 @@ const vsRoot = join(modulesDir, "code-server", "lib", "vscode");
 const mod = await import(pathToFileURL(join(vsRoot, "out/server-main.js")).href);
 const serverModule = await mod.loadCodeWithNls();
 
+// The uninstall path compares every candidate against
+// `productService.defaultChatAgent.extensionId` to keep the built-in chat agent
+// from being removed. code-server's product.json has no `defaultChatAgent`, so
+// the comparison throws before anything is uninstalled. An empty id is a valid
+// operand that no real extension id can equal.
+const _product = globalThis._VSCODE_PRODUCT_JSON;
+if (_product) {
+  _product.defaultChatAgent ??= { extensionId: "" };
+}
+
 // `spawnCli` consumes a VS Code NativeParsedArgs object. Extensions resolve
 // against the gallery baked into the patched server-main.js, which defaults to
 // Open VSX (https://open-vsx.org/vscode/gallery).
 await serverModule.spawnCli({
   _: [],
-  "install-extension": cfg.ids,
+  ...(cfg.ids?.length ? { "install-extension": cfg.ids } : {}),
+  ...(cfg.uninstall?.length ? { "uninstall-extension": cfg.uninstall } : {}),
+  ...(cfg.list ? { "list-extensions": true } : {}),
+  ...(cfg.showVersions ? { "show-versions": true } : {}),
   "extensions-dir": cfg.extensionsDir,
   "user-data-dir": cfg.userDataDir,
   "server-data-dir": cfg.serverDataDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coderaft",
-  "version": "0.0.41",
+  "version": "0.0.42",
   "repository": "pithings/coderaft",
   "bin": {
     "coderaft": "./dist/cli.mjs"
@@ -31,14 +31,14 @@
     "build": "obuild"
   },
   "devDependencies": {
-    "code-server": "https://github.com/coder/code-server/releases/download/v4.130.0/package.tar.gz",
+    "code-server": "https://github.com/coder/code-server/releases/download/v4.133.0/package.tar.gz",
     "@github/copilot": "workspace:*",
     "@github/copilot-sdk": "workspace:*",
     "@microsoft/1ds-core-js": "workspace:*",
     "@microsoft/1ds-post-js": "workspace:*",
     "@microsoft/mxc-sdk": "0.6.1",
     "@parcel/watcher": "workspace:*",
-    "@vscode/copilot-api": "^0.4.2",
+    "@vscode/copilot-api": "^0.5.2",
     "@vscode/deviceid": "workspace:*",
     "@vscode/fs-copyfile": "workspace:*",
     "@vscode/iconv-lite-umd": "0.7.1",
@@ -53,16 +53,16 @@
     "@vscode/vscode-languagedetection": "1.0.23",
     "@vscode/windows-process-tree": "workspace:*",
     "@vscode/windows-registry": "workspace:*",
-    "@xterm/addon-clipboard": "^0.3.0-beta.288",
-    "@xterm/addon-image": "^0.10.0-beta.288",
-    "@xterm/addon-ligatures": "^0.11.0-beta.288",
-    "@xterm/addon-progress": "^0.3.0-beta.288",
-    "@xterm/addon-search": "^0.17.0-beta.288",
-    "@xterm/addon-serialize": "^0.15.0-beta.288",
-    "@xterm/addon-unicode11": "^0.10.0-beta.288",
-    "@xterm/addon-webgl": "^0.20.0-beta.287",
-    "@xterm/headless": "^6.1.0-beta.288",
-    "@xterm/xterm": "^6.1.0-beta.288",
+    "@xterm/addon-clipboard": "^0.3.0-beta.292",
+    "@xterm/addon-image": "^0.10.0-beta.292",
+    "@xterm/addon-ligatures": "^0.11.0-beta.292",
+    "@xterm/addon-progress": "^0.3.0-beta.292",
+    "@xterm/addon-search": "^0.17.0-beta.292",
+    "@xterm/addon-serialize": "^0.15.0-beta.292",
+    "@xterm/addon-unicode11": "^0.10.0-beta.292",
+    "@xterm/addon-webgl": "^0.20.0-beta.291",
+    "@xterm/headless": "^6.1.0-beta.292",
+    "@xterm/xterm": "^6.1.0-beta.292",
     "cookie": "^0.7.0",
     "detect-libc": "^2.1.2",
     "http-proxy-agent": "^7.0.0",
@@ -75,7 +75,7 @@
     "node-addon-api": "^6.0.0",
     "node-pty": "workspace:*",
     "ssh2": "workspace:*",
-    "tar": "^7.5.9",
+    "tar": "^7.5.20",
     "tas-client": "0.3.1",
     "typescript": "^6.0.3",
     "vscode-oniguruma": "1.7.0",
@@ -84,6 +84,6 @@
     "ws": "^8.19.0",
     "yauzl": "^3.3.1",
     "yazl": "^2.4.3",
-    "zod": "^3.25.76"
+    "zod": "^4.4.3"
   }
 }