@opencodehub/cli 0.1.0

package/dist/editors/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/editors/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAOpC,MAAM,UAAU,iBAAiB,CAAC,OAA2B,EAAE;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC1D,OAAO;QACL,EAAE,EAAE,OAAO;QACX,UAAU;QACV,KAAK,CAAC,QAAQ,EAAE,UAAU;YACxB,OAAO,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA4B,EAAE,UAAyB;IACtF,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,GAAG,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;IAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAmB,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,UAAyB;IAChD,MAAM,KAAK,GAA4B;QACrC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC;KAC3B,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/editors/cursor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cursor MCP config writer.
+ *
+ * Targets `~/.cursor/mcp.json` (global scope). Same `mcpServers` shape as
+ * Claude Code, so we reuse the shared merger.
+ */
+import type { EditorWriter } from "./types.js";
+export interface CursorWriterOptions {
+    /** Override the home directory used to resolve the config path. */
+    readonly home?: string;
+}
+export declare function createCursorWriter(opts?: CursorWriterOptions): EditorWriter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/editors/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/editors/cursor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAU/E"}

package/dist/editors/cursor.js

@@ -0,0 +1,21 @@
+/**
+ * Cursor MCP config writer.
+ *
+ * Targets `~/.cursor/mcp.json` (global scope). Same `mcpServers` shape as
+ * Claude Code, so we reuse the shared merger.
+ */
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { mergeMcpServers } from "./claude-code.js";
+export function createCursorWriter(opts = {}) {
+    const home = opts.home ?? homedir();
+    const configPath = resolve(home, ".cursor", "mcp.json");
+    return {
+        id: "cursor",
+        configPath,
+        merge(existing, invocation) {
+            return mergeMcpServers(existing, invocation);
+        },
+    };
+}
+//# sourceMappingURL=cursor.js.map

package/dist/editors/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/editors/cursor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAQnD,MAAM,UAAU,kBAAkB,CAAC,OAA4B,EAAE;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACxD,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,UAAU;QACV,KAAK,CAAC,QAAQ,EAAE,UAAU;YACxB,OAAO,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/editors/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Barrel for editor writers + shared helpers.
+ */
+export { createClaudeCodeWriter } from "./claude-code.js";
+export { createCodexWriter, mergeCodexConfig } from "./codex.js";
+export { createCursorWriter } from "./cursor.js";
+export { createOpenCodeWriter, mergeOpenCodeConfig } from "./opencode.js";
+export type { EditorId, EditorWriter, McpInvocation } from "./types.js";
+export { ALL_EDITOR_IDS } from "./types.js";
+export { maybeWrapForWindows } from "./windows-wrap.js";
+export { createWindsurfWriter } from "./windsurf.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/editors/index.js

@@ -0,0 +1,11 @@
+/**
+ * Barrel for editor writers + shared helpers.
+ */
+export { createClaudeCodeWriter } from "./claude-code.js";
+export { createCodexWriter, mergeCodexConfig } from "./codex.js";
+export { createCursorWriter } from "./cursor.js";
+export { createOpenCodeWriter, mergeOpenCodeConfig } from "./opencode.js";
+export { ALL_EDITOR_IDS } from "./types.js";
+export { maybeWrapForWindows } from "./windows-wrap.js";
+export { createWindsurfWriter } from "./windsurf.js";
+//# sourceMappingURL=index.js.map

package/dist/editors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/editors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/editors/opencode.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OpenCode MCP config writer.
+ *
+ * Targets `<project>/opencode.json`. The OpenCode schema deviates from the
+ * others:
+ *   - top-level key is `mcp`, NOT `mcpServers`
+ *   - each entry uses `type: "local"` (not `stdio`)
+ *   - `command` is a single ARRAY `[exec, ...args]`, not `command` + `args`
+ *   - env lives under `environment`, not `env`
+ *   - `enabled` and `timeout` are conventional extras
+ *
+ * Other top-level keys and other entries under `mcp` are preserved.
+ */
+import type { EditorWriter, McpInvocation } from "./types.js";
+export interface OpenCodeWriterOptions {
+    /** Absolute project root. The writer targets `<root>/opencode.json`. */
+    readonly projectRoot: string;
+    /** Optional timeout in ms for the MCP server startup. Default 10_000. */
+    readonly timeoutMs?: number;
+}
+export declare function createOpenCodeWriter(opts: OpenCodeWriterOptions): EditorWriter;
+export declare function mergeOpenCodeConfig(existing: string | undefined, invocation: McpInvocation, timeoutMs?: number): string;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/editors/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/editors/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,YAAY,CAU9E;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE,aAAa,EACzB,SAAS,GAAE,MAA2B,GACrC,MAAM,CAMR"}

package/dist/editors/opencode.js

@@ -0,0 +1,61 @@
+/**
+ * OpenCode MCP config writer.
+ *
+ * Targets `<project>/opencode.json`. The OpenCode schema deviates from the
+ * others:
+ *   - top-level key is `mcp`, NOT `mcpServers`
+ *   - each entry uses `type: "local"` (not `stdio`)
+ *   - `command` is a single ARRAY `[exec, ...args]`, not `command` + `args`
+ *   - env lives under `environment`, not `env`
+ *   - `enabled` and `timeout` are conventional extras
+ *
+ * Other top-level keys and other entries under `mcp` are preserved.
+ */
+import { resolve } from "node:path";
+const DEFAULT_TIMEOUT_MS = 10_000;
+export function createOpenCodeWriter(opts) {
+    const configPath = resolve(opts.projectRoot, "opencode.json");
+    const timeout = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    return {
+        id: "opencode",
+        configPath,
+        merge(existing, invocation) {
+            return mergeOpenCodeConfig(existing, invocation, timeout);
+        },
+    };
+}
+export function mergeOpenCodeConfig(existing, invocation, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const doc = parseJsonObject(existing);
+    const mcp = isObject(doc["mcp"]) ? { ...doc["mcp"] } : {};
+    mcp["codehub"] = buildOpenCodeEntry(invocation, timeoutMs);
+    doc["mcp"] = mcp;
+    return `${JSON.stringify(doc, null, 2)}\n`;
+}
+function buildOpenCodeEntry(invocation, timeoutMs) {
+    const entry = {
+        type: "local",
+        command: [invocation.command, ...invocation.args],
+        enabled: true,
+        timeout: timeoutMs,
+    };
+    if (Object.keys(invocation.env).length > 0) {
+        entry["environment"] = { ...invocation.env };
+    }
+    return entry;
+}
+function parseJsonObject(input) {
+    if (input === undefined || input.trim().length === 0)
+        return {};
+    const parsed = JSON.parse(stripBom(input));
+    if (!isObject(parsed)) {
+        throw new Error("Expected opencode.json to contain a top-level object");
+    }
+    return { ...parsed };
+}
+function stripBom(s) {
+    return s.charCodeAt(0) === 0xfeff ? s.slice(1) : s;
+}
+function isObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+//# sourceMappingURL=opencode.js.map

package/dist/editors/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/editors/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,UAAU,oBAAoB,CAAC,IAA2B;IAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACrD,OAAO;QACL,EAAE,EAAE,UAAU;QACd,UAAU;QACV,KAAK,CAAC,QAAQ,EAAE,UAAU;YACxB,OAAO,mBAAmB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA4B,EAC5B,UAAyB,EACzB,YAAoB,kBAAkB;IAEtC,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,GAAG,CAAC,SAAS,CAAC,GAAG,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC3D,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IACjB,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAyB,EAAE,SAAiB;IACtE,MAAM,KAAK,GAA4B;QACrC,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC;QACjD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,SAAS;KACnB,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAY,CAAC;IACtD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/editors/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared types used by every editor writer.
+ *
+ * Every writer implements the `EditorWriter` interface: given a resolved MCP
+ * invocation (executable + args + env), it produces a merged file payload that
+ * preserves every pre-existing entry under the editor's MCP key and only
+ * upserts/replaces the single `codehub` entry.
+ *
+ * Writers are pure on their inputs — they never touch the filesystem. The
+ * orchestrator in `commands/setup.ts` handles read, backup, and atomic write.
+ */
+export type EditorId = "claude-code" | "cursor" | "codex" | "windsurf" | "opencode";
+export declare const ALL_EDITOR_IDS: readonly EditorId[];
+/**
+ * Resolved MCP server invocation. The `command` + `args` fields have already
+ * been through any platform-specific wrapping (e.g. `cmd /c` on Windows).
+ */
+export interface McpInvocation {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+}
+export interface EditorWriter {
+    readonly id: EditorId;
+    /** Absolute path of the file this writer targets. */
+    readonly configPath: string;
+    /**
+     * Produce the new file contents. If `existing` is undefined the writer must
+     * emit a fresh document. Otherwise it must preserve every unrelated key.
+     */
+    merge(existing: string | undefined, invocation: McpInvocation): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/editors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/editors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpF,eAAO,MAAM,cAAc,EAAE,SAAS,QAAQ,EAM7C,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,MAAM,CAAC;CACxE"}

package/dist/editors/types.js

@@ -0,0 +1,19 @@
+/**
+ * Shared types used by every editor writer.
+ *
+ * Every writer implements the `EditorWriter` interface: given a resolved MCP
+ * invocation (executable + args + env), it produces a merged file payload that
+ * preserves every pre-existing entry under the editor's MCP key and only
+ * upserts/replaces the single `codehub` entry.
+ *
+ * Writers are pure on their inputs — they never touch the filesystem. The
+ * orchestrator in `commands/setup.ts` handles read, backup, and atomic write.
+ */
+export const ALL_EDITOR_IDS = [
+    "claude-code",
+    "cursor",
+    "codex",
+    "windsurf",
+    "opencode",
+];
+//# sourceMappingURL=types.js.map

package/dist/editors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/editors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,aAAa;IACb,QAAQ;IACR,OAAO;IACP,UAAU;IACV,UAAU;CACX,CAAC"}

package/dist/editors/windows-wrap.d.ts

@@ -0,0 +1,19 @@
+/**
+ * On native Windows, stdio servers launched via `npx` or an unwrapped
+ * `node`/binary shim fail with ENOENT because Node does not route through
+ * `cmd.exe` by default. The standard workaround in MCP client docs is to wrap
+ * the command in `cmd /c <original>`.
+ *
+ * We apply the wrap when:
+ *   - we are running on `win32`, AND
+ *   - the command is `npx`, `npm`, `yarn`, `pnpm`, or a `.cmd`/`.bat` file.
+ *
+ * Pure function; no IO.
+ */
+import type { McpInvocation } from "./types.js";
+export interface WrapOptions {
+    /** Override the detected platform. Defaults to `process.platform`. */
+    readonly platform?: NodeJS.Platform;
+}
+export declare function maybeWrapForWindows(invocation: McpInvocation, opts?: WrapOptions): McpInvocation;
+//# sourceMappingURL=windows-wrap.d.ts.map

package/dist/editors/windows-wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-wrap.d.ts","sourceRoot":"","sources":["../../src/editors/windows-wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,aAAa,EACzB,IAAI,GAAE,WAAgB,GACrB,aAAa,CAaf"}

package/dist/editors/windows-wrap.js

@@ -0,0 +1,28 @@
+/**
+ * On native Windows, stdio servers launched via `npx` or an unwrapped
+ * `node`/binary shim fail with ENOENT because Node does not route through
+ * `cmd.exe` by default. The standard workaround in MCP client docs is to wrap
+ * the command in `cmd /c <original>`.
+ *
+ * We apply the wrap when:
+ *   - we are running on `win32`, AND
+ *   - the command is `npx`, `npm`, `yarn`, `pnpm`, or a `.cmd`/`.bat` file.
+ *
+ * Pure function; no IO.
+ */
+const WRAPPABLE_COMMANDS = new Set(["npx", "npm", "yarn", "pnpm"]);
+export function maybeWrapForWindows(invocation, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    if (platform !== "win32")
+        return invocation;
+    const base = invocation.command.toLowerCase();
+    const needsWrap = WRAPPABLE_COMMANDS.has(base) || base.endsWith(".cmd") || base.endsWith(".bat");
+    if (!needsWrap)
+        return invocation;
+    return {
+        command: "cmd",
+        args: ["/c", invocation.command, ...invocation.args],
+        env: invocation.env,
+    };
+}
+//# sourceMappingURL=windows-wrap.js.map

package/dist/editors/windows-wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-wrap.js","sourceRoot":"","sources":["../../src/editors/windows-wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAOnE,MAAM,UAAU,mBAAmB,CACjC,UAAyB,EACzB,OAAoB,EAAE;IAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC;IAE5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjG,IAAI,CAAC,SAAS;QAAE,OAAO,UAAU,CAAC;IAElC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC;QACpD,GAAG,EAAE,UAAU,CAAC,GAAG;KACpB,CAAC;AACJ,CAAC"}

package/dist/editors/windsurf.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Windsurf MCP config writer.
+ *
+ * Targets `~/.codeium/windsurf/mcp_config.json`. Same `mcpServers` shape as
+ * Claude Code / Cursor.
+ */
+import type { EditorWriter } from "./types.js";
+export interface WindsurfWriterOptions {
+    readonly home?: string;
+}
+export declare function createWindsurfWriter(opts?: WindsurfWriterOptions): EditorWriter;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/editors/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../src/editors/windsurf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,qBAA0B,GAAG,YAAY,CAUnF"}

package/dist/editors/windsurf.js

@@ -0,0 +1,21 @@
+/**
+ * Windsurf MCP config writer.
+ *
+ * Targets `~/.codeium/windsurf/mcp_config.json`. Same `mcpServers` shape as
+ * Claude Code / Cursor.
+ */
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { mergeMcpServers } from "./claude-code.js";
+export function createWindsurfWriter(opts = {}) {
+    const home = opts.home ?? homedir();
+    const configPath = resolve(home, ".codeium", "windsurf", "mcp_config.json");
+    return {
+        id: "windsurf",
+        configPath,
+        merge(existing, invocation) {
+            return mergeMcpServers(existing, invocation);
+        },
+    };
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/editors/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/editors/windsurf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOnD,MAAM,UAAU,oBAAoB,CAAC,OAA8B,EAAE;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC5E,OAAO;QACL,EAAE,EAAE,UAAU;QACd,UAAU;QACV,KAAK,CAAC,QAAQ,EAAE,UAAU;YACxB,OAAO,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/embedder-downloader.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SHA256-pinned downloader for gte-modernbert-base weights.
+ *
+ * Resolves the target directory via {@link resolveModelDir}, then for each
+ * pinned file in {@link GTE_MODERNBERT_BASE_PINS}:
+ *   1. Skip when the file already exists and its SHA256 matches the pin.
+ *   2. Otherwise stream-download to `<target>.tmp`, hash during write, verify
+ *      hash, and atomically rename to the final path.
+ *
+ * Retries transient network errors (ECONNRESET / timeout / 5xx) up to 3 times
+ * with exponential backoff (100ms, 500ms, 2s). A SHA256 mismatch is a hard
+ * error — the `.tmp` file is deleted and the error thrown. We never ship
+ * weights that don't match the pin.
+ *
+ * All disk access is streaming; we never buffer a 596 MB file in memory.
+ */
+/** Fetch function signature for dependency injection (tests mock this). */
+export type FetchFn = typeof fetch;
+/** Options accepted by {@link downloadEmbedderWeights}. */
+export interface DownloadEmbedderOptions {
+    /** Which variant to install. Defaults to `fp32`. */
+    readonly variant: "fp32" | "int8";
+    /** Override target directory. Defaults to the standard model path. */
+    readonly modelDir?: string;
+    /**
+     * Re-download every file even if the existing copy's SHA256 matches. Used
+     * by `--force`. When false, files that already match the pin are skipped.
+     */
+    readonly force?: boolean;
+    /**
+     * Called before each file starts downloading. `pct` is a whole-suite
+     * percentage (0-100) and `file` is the base name of the current file.
+     */
+    readonly onProgress?: (pct: number, file: string) => void;
+    /**
+     * Fetch implementation. Tests inject a stub; production uses global `fetch`.
+     */
+    readonly fetchImpl?: FetchFn;
+    /**
+     * Max retry attempts for a single file. Default 3. Must be >= 1.
+     */
+    readonly maxRetries?: number;
+    /**
+     * Retry backoff ladder in ms. Used positionally by retry index. Default
+     * `[100, 500, 2000]` per the v1.0 spec.
+     */
+    readonly backoffMs?: readonly number[];
+}
+/** Summary returned by {@link downloadEmbedderWeights}. */
+export interface DownloadEmbedderResult {
+    readonly downloaded: number;
+    readonly skipped: number;
+    readonly totalBytes: number;
+    readonly modelDir: string;
+}
+/**
+ * Thrown when a downloaded file's SHA256 doesn't match the pinned value.
+ *
+ * The temp file is deleted before this throws so partial corrupt payloads
+ * never linger on disk.
+ */
+export declare class Sha256MismatchError extends Error {
+    readonly code: "EMBEDDER_SHA256_MISMATCH";
+    readonly fileName: string;
+    readonly expected: string;
+    readonly actual: string;
+    constructor(fileName: string, expected: string, actual: string);
+}
+/**
+ * Thrown for all non-hash download failures (404, network, etc.). Carries the
+ * URL in the message so operators can reproduce with curl.
+ */
+export declare class DownloadError extends Error {
+    readonly code: "EMBEDDER_DOWNLOAD_FAILED";
+    readonly url: string;
+    constructor(url: string, message: string, options?: ErrorOptions);
+}
+/**
+ * Download every pinned file for the requested variant, skipping files whose
+ * on-disk SHA256 already matches the pin (unless `force` is set).
+ *
+ * Returns `{downloaded, skipped, totalBytes}` where `totalBytes` counts the
+ * newly-downloaded bytes only (skipped files are not re-hashed into the
+ * total).
+ */
+export declare function downloadEmbedderWeights(opts: DownloadEmbedderOptions): Promise<DownloadEmbedderResult>;
+//# sourceMappingURL=embedder-downloader.d.ts.map

package/dist/embedder-downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-downloader.d.ts","sourceRoot":"","sources":["../src/embedder-downloader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,2EAA2E;AAC3E,MAAM,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC;AAEnC,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAKD;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,0BAA0B,CAAU;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO/D;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAG,0BAA0B,CAAU;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKjE;AAwLD;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CA0CjC"}