opencode-agora 0.4.1 → 0.4.3

package/dist/stack/mcp-probe.d.ts

@@ -0,0 +1,23 @@
+export interface McpTool {
+    name: string;
+    description?: string;
+}
+export interface McpProbeResult {
+    ok: boolean;
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    capabilities?: unknown;
+    tools?: McpTool[];
+    error?: string;
+    stderr?: string;
+    exitCode?: number | null;
+    durationMs?: number;
+}
+export declare function probeMcpServer(command: string[], opts?: {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<McpProbeResult>;
+//# sourceMappingURL=mcp-probe.d.ts.map

package/dist/stack/mcp-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-probe.d.ts","sourceRoot":"","sources":["../../src/stack/mcp-probe.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE;IACL,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,cAAc,CAAC,CAyNzB"}

package/dist/stack/mcp-probe.js

@@ -0,0 +1,230 @@
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+let _pkgVersion;
+function getPkgVersion() {
+    if (_pkgVersion !== undefined)
+        return _pkgVersion;
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+        _pkgVersion = pkg.version ?? '0';
+    }
+    catch {
+        _pkgVersion = '0';
+    }
+    return _pkgVersion;
+}
+const STDERR_CAP = 4000;
+function appendStderr(buf, chunk) {
+    const combined = buf + chunk;
+    if (combined.length <= STDERR_CAP)
+        return combined;
+    // Keep the tail
+    return combined.slice(combined.length - STDERR_CAP);
+}
+function stderrSnippet(buf) {
+    const trimmed = buf.trimEnd();
+    if (!trimmed)
+        return '';
+    // Last ~200 chars, collapsed to a single line
+    const tail = trimmed.length > 200 ? trimmed.slice(trimmed.length - 200) : trimmed;
+    return tail.replace(/\r?\n/g, ' ').trim();
+}
+export async function probeMcpServer(command, opts) {
+    const timeoutMs = opts?.timeoutMs ?? 15000;
+    const startMs = Date.now();
+    const mergedEnv = {};
+    for (const [k, v] of Object.entries(process.env)) {
+        if (v !== undefined)
+            mergedEnv[k] = v;
+    }
+    if (opts?.env) {
+        for (const [k, v] of Object.entries(opts.env)) {
+            if (v !== undefined)
+                mergedEnv[k] = v;
+        }
+    }
+    return new Promise((resolveOuter) => {
+        let settled = false;
+        let timer = null;
+        let currentStage = 'initialize';
+        const child = spawn(command[0], command.slice(1), {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: false,
+            env: mergedEnv,
+            cwd: opts?.cwd
+        });
+        // Pending RPC handlers keyed by message id
+        const pending = new Map();
+        // Partial line buffer for stdout
+        let lineBuffer = '';
+        // Bounded stderr capture (tail up to STDERR_CAP chars)
+        let stderrBuf = '';
+        function durationMs() {
+            return Date.now() - startMs;
+        }
+        function cleanup() {
+            if (timer !== null) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            try {
+                child.kill('SIGTERM');
+                // Give it a short grace period then SIGKILL
+                setTimeout(() => {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        // already dead
+                    }
+                }, 300);
+            }
+            catch {
+                // already dead
+            }
+        }
+        function resolve(result) {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            const capturedStderr = stderrBuf.trimEnd();
+            const withStderr = {
+                ...result,
+                durationMs: durationMs(),
+                ...(capturedStderr ? { stderr: capturedStderr } : {})
+            };
+            resolveOuter(withStderr);
+        }
+        // Capture stderr (bounded)
+        child.stderr.on('data', (chunk) => {
+            stderrBuf = appendStderr(stderrBuf, chunk.toString('utf8'));
+        });
+        // Set overall timeout
+        timer = setTimeout(() => {
+            const snippet = stderrSnippet(stderrBuf);
+            const base = `timed out waiting for ${currentStage}`;
+            resolve({ ok: false, error: snippet ? `${base} — stderr: ${snippet}` : base });
+        }, timeoutMs);
+        child.on('error', (err) => {
+            const snippet = stderrSnippet(stderrBuf);
+            resolve({ ok: false, error: snippet ? `${err.message} — stderr: ${snippet}` : err.message });
+        });
+        child.on('close', (code) => {
+            if (!settled) {
+                const snippet = stderrSnippet(stderrBuf);
+                const base = 'server exited';
+                resolve({
+                    ok: false,
+                    error: snippet ? `${base} — stderr: ${snippet}` : base,
+                    exitCode: code
+                });
+            }
+        });
+        // Parse stdout as newline-delimited JSON
+        child.stdout.on('data', (chunk) => {
+            lineBuffer += chunk.toString('utf8');
+            const lines = lineBuffer.split('\n');
+            // Keep the last (potentially incomplete) segment
+            lineBuffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                let msg;
+                try {
+                    msg = JSON.parse(trimmed);
+                }
+                catch {
+                    // Not JSON (e.g. server debug output) — ignore
+                    continue;
+                }
+                if (typeof msg !== 'object' || msg === null)
+                    continue;
+                const record = msg;
+                const id = record.id;
+                if (typeof id === 'number' && pending.has(id)) {
+                    const handler = pending.get(id);
+                    pending.delete(id);
+                    handler(msg);
+                }
+            }
+        });
+        function writeMsg(msg) {
+            const line = JSON.stringify(msg) + '\n';
+            child.stdin.write(line);
+        }
+        // ── Handshake ────────────────────────────────────────────────────────────
+        function awaitResponse(id) {
+            return new Promise((res) => {
+                pending.set(id, (msg) => res(msg));
+            });
+        }
+        async function handshake() {
+            // 1. Send initialize
+            currentStage = 'initialize';
+            writeMsg({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'initialize',
+                params: {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: { name: 'agora', version: getPkgVersion() }
+                }
+            });
+            const initResp = await awaitResponse(1);
+            if (settled)
+                return;
+            if (initResp.error) {
+                const rpcErr = initResp.error;
+                const errMsg = typeof rpcErr === 'object' && rpcErr !== null
+                    ? (rpcErr.message ?? JSON.stringify(rpcErr))
+                    : String(rpcErr);
+                resolve({ ok: false, error: errMsg });
+                return;
+            }
+            const result = (initResp.result ?? {});
+            const serverInfo = result.serverInfo;
+            const capabilities = result.capabilities;
+            // 2. Send initialized notification (no id)
+            currentStage = 'initialized notification';
+            writeMsg({ jsonrpc: '2.0', method: 'notifications/initialized' });
+            // 3. Request tools/list
+            currentStage = 'tools/list';
+            writeMsg({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} });
+            const toolsResp = await awaitResponse(2);
+            if (settled)
+                return;
+            if (toolsResp.error) {
+                // Initialize succeeded; tools/list failed — server is still usable
+                const rpcErr = toolsResp.error;
+                const errMsg = typeof rpcErr === 'object' && rpcErr !== null
+                    ? (rpcErr.message ?? JSON.stringify(rpcErr))
+                    : String(rpcErr);
+                resolve({ ok: true, serverInfo, capabilities, tools: [], error: errMsg });
+                return;
+            }
+            const toolsResult = (toolsResp.result ?? {});
+            const rawTools = Array.isArray(toolsResult.tools) ? toolsResult.tools : [];
+            const tools = rawTools.map((t) => {
+                const tool = t;
+                return {
+                    name: typeof tool.name === 'string' ? tool.name : '(unknown)',
+                    ...(typeof tool.description === 'string' ? { description: tool.description } : {})
+                };
+            });
+            resolve({ ok: true, serverInfo, capabilities, tools });
+        }
+        // Start handshake; any thrown error becomes a failure
+        handshake().catch((err) => {
+            if (!settled) {
+                resolve({
+                    ok: false,
+                    error: err instanceof Error ? err.message : String(err)
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=mcp-probe.js.map

package/dist/stack/mcp-probe.js.map

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

package/dist/stack/path-resolve.d.ts

@@ -0,0 +1,7 @@
+export declare const KNOWN_RUNNERS: Set<string>;
+/**
+ * Returns the absolute path of `command` if found by scanning PATH dirs,
+ * else null. Respects PATHEXT on win32. Reads env.PATH or process.env.PATH.
+ */
+export declare function resolveOnPath(command: string, env?: Record<string, string | undefined>): string | null;
+//# sourceMappingURL=path-resolve.d.ts.map

package/dist/stack/path-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolve.d.ts","sourceRoot":"","sources":["../../src/stack/path-resolve.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,aASxB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACvC,MAAM,GAAG,IAAI,CAwBf"}

package/dist/stack/path-resolve.js

@@ -0,0 +1,37 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+export const KNOWN_RUNNERS = new Set([
+    'npx',
+    'bunx',
+    'uvx',
+    'node',
+    'python',
+    'python3',
+    'deno',
+    'uv'
+]);
+/**
+ * Returns the absolute path of `command` if found by scanning PATH dirs,
+ * else null. Respects PATHEXT on win32. Reads env.PATH or process.env.PATH.
+ */
+export function resolveOnPath(command, env) {
+    // If already an absolute path, just check existence
+    if (command.startsWith('/') || command.startsWith('\\')) {
+        return existsSync(command) ? command : null;
+    }
+    const pathEnv = (env?.PATH ?? process.env.PATH) || '';
+    const dirs = pathEnv.split(process.platform === 'win32' ? ';' : ':').filter(Boolean);
+    const extensions = process.platform === 'win32'
+        ? (process.env.PATHEXT || '.EXE;.CMD;.BAT').split(';').map((e) => e.toLowerCase())
+        : [''];
+    for (const dir of dirs) {
+        for (const ext of extensions) {
+            const candidate = join(dir, command + ext);
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=path-resolve.js.map

package/dist/stack/path-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolve.js","sourceRoot":"","sources":["../../src/stack/path-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,IAAI;CACL,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,GAAwC;IAExC,oDAAoD;IACpD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAErF,MAAM,UAAU,GACd,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAClF,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEX,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAAC,CAAC;YAC3C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/stack/registry.d.ts

@@ -0,0 +1,11 @@
+import type { AgentToolId, ConfiguredServer, StackEnv, ToolAdapter, ToolConfigLocation } from './types.js';
+export declare const ALL_ADAPTERS: ToolAdapter[];
+export declare function getAdapter(id: AgentToolId): ToolAdapter | undefined;
+export declare function detectTools(opts: StackEnv): {
+    adapter: ToolAdapter;
+    locations: ToolConfigLocation[];
+    present: boolean;
+}[];
+export declare function readAllServers(opts: StackEnv): ConfiguredServer[];
+export declare function groupServersByName(servers: ConfiguredServer[]): Map<string, ConfiguredServer[]>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/stack/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/stack/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,YAAY,EAAE,WAAW,EAKrC,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,GACb;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,CAM/E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,EAAE,CAMjE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAW/F"}

package/dist/stack/registry.js

@@ -0,0 +1,42 @@
+import { existsSync } from 'node:fs';
+import { opencodeAdapter } from './adapters/opencode.js';
+import { claudeCodeAdapter } from './adapters/claude-code.js';
+import { cursorAdapter } from './adapters/cursor.js';
+import { windsurfAdapter } from './adapters/windsurf.js';
+export const ALL_ADAPTERS = [
+    opencodeAdapter,
+    claudeCodeAdapter,
+    cursorAdapter,
+    windsurfAdapter
+];
+export function getAdapter(id) {
+    return ALL_ADAPTERS.find((a) => a.id === id);
+}
+export function detectTools(opts) {
+    return ALL_ADAPTERS.map((adapter) => {
+        const locations = adapter.locations(opts);
+        const present = locations.some((loc) => existsSync(loc.path));
+        return { adapter, locations, present };
+    });
+}
+export function readAllServers(opts) {
+    const results = [];
+    for (const adapter of ALL_ADAPTERS) {
+        results.push(...adapter.readServers(opts));
+    }
+    return results;
+}
+export function groupServersByName(servers) {
+    const map = new Map();
+    for (const server of servers) {
+        const existing = map.get(server.name);
+        if (existing) {
+            existing.push(server);
+        }
+        else {
+            map.set(server.name, [server]);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=registry.js.map

package/dist/stack/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/stack/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AASzD,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,eAAe;IACf,iBAAiB;IACjB,aAAa;IACb,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAe;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAc;IAEd,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA2B;IAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/stack/sync.d.ts

@@ -0,0 +1,20 @@
+import type { AgentToolId, StackEnv, SyncChange, ToolConfigLocation } from './types.js';
+import type { StackManifest } from './manifest.js';
+export interface ToolSyncPlan {
+    tool: AgentToolId;
+    location: ToolConfigLocation | null;
+    change: SyncChange;
+    skipped: {
+        name: string;
+        reason: string;
+    }[];
+}
+/**
+ * PURE / read-only: compute what would change for each target tool without writing.
+ */
+export declare function planSync(manifest: StackManifest, opts: StackEnv, targets: AgentToolId[], scope: 'project' | 'user', prune: boolean): ToolSyncPlan[];
+/**
+ * Apply the sync — calls each adapter's writeServers and returns actually-applied changes.
+ */
+export declare function applySync(manifest: StackManifest, opts: StackEnv, targets: AgentToolId[], scope: 'project' | 'user', prune: boolean): ToolSyncPlan[];
+//# sourceMappingURL=sync.d.ts.map

package/dist/stack/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/stack/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAEX,QAAQ,EACR,UAAU,EACV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,eAAe,CAAC;AAIlE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAuKD;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,KAAK,EAAE,OAAO,GACb,YAAY,EAAE,CAwBhB;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,KAAK,EAAE,OAAO,GACb,YAAY,EAAE,CAwChB"}

package/dist/stack/sync.js

@@ -0,0 +1,226 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { getAdapter } from './registry.js';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function manifestEntryToDesired(name, entry) {
+    const ds = { name };
+    if (entry.command)
+        ds.command = entry.command;
+    if (entry.url)
+        ds.url = entry.url;
+    if (entry.env && Object.keys(entry.env).length > 0)
+        ds.env = entry.env;
+    if (entry.enabled === false)
+        ds.enabled = false;
+    return ds;
+}
+function manifestToDesired(manifest) {
+    return Object.entries(manifest.mcp).map(([name, entry]) => manifestEntryToDesired(name, entry));
+}
+/**
+ * Compute a diff between the current on-disk MCP config and the desired
+ * servers WITHOUT writing anything.
+ */
+function computeDiff(filePath, tool, desired, prune) {
+    const skipped = [];
+    // Determine which desired entries are "writable" for this tool
+    const needsEnabled = tool === 'opencode';
+    const writableDesired = [];
+    for (const ds of desired) {
+        if (ds.enabled === false && !needsEnabled) {
+            skipped.push({
+                name: ds.name,
+                reason: `${tool} does not support disabled servers; skipped`
+            });
+        }
+        else {
+            writableDesired.push(ds);
+        }
+    }
+    // Read existing MCP container
+    let existingMcp = {};
+    if (existsSync(filePath)) {
+        const raw = readFileSync(filePath, 'utf8');
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            // Can't diff an unparseable file — report as empty
+            parsed = {};
+        }
+        if (typeof parsed === 'object' && parsed !== null) {
+            const doc = parsed;
+            const mcpKey = tool === 'opencode' ? 'mcp' : 'mcpServers';
+            const mcpVal = doc[mcpKey];
+            if (typeof mcpVal === 'object' && mcpVal !== null) {
+                existingMcp = mcpVal;
+            }
+        }
+    }
+    const added = [];
+    const updated = [];
+    const removed = [];
+    const desiredMap = new Map(writableDesired.map((d) => [d.name, d]));
+    for (const ds of writableDesired) {
+        const existing = existingMcp[ds.name];
+        if (existing === undefined) {
+            added.push(ds.name);
+        }
+        else {
+            // Check if it differs — build the would-be new entry and compare
+            const newEntry = buildEntry(tool, ds, existing);
+            if (JSON.stringify(existing) !== JSON.stringify(newEntry)) {
+                updated.push(ds.name);
+            }
+        }
+    }
+    if (prune) {
+        for (const name of Object.keys(existingMcp)) {
+            if (!desiredMap.has(name)) {
+                removed.push(name);
+            }
+        }
+    }
+    return { change: { added, updated, removed }, skipped };
+}
+const REMOTE_TYPES = new Set(['sse', 'http', 'streamable-http']);
+const LOCAL_TYPES = new Set(['stdio']);
+/**
+ * Build what the new entry would look like for comparison purposes.
+ * Mirrors the merge logic in each adapter: starts from existingRaw, applies
+ * managed fields, removes keys that no longer apply.
+ */
+function buildEntry(tool, ds, existingRaw) {
+    if (tool === 'opencode') {
+        const base = { ...existingRaw };
+        if (ds.url) {
+            base['type'] = 'remote';
+            base['url'] = ds.url;
+            delete base['command'];
+            delete base['environment'];
+        }
+        else {
+            base['type'] = 'local';
+            base['command'] = ds.command ?? [];
+            if (ds.env && Object.keys(ds.env).length > 0) {
+                base['environment'] = ds.env;
+            }
+            else {
+                delete base['environment'];
+            }
+            delete base['url'];
+        }
+        if (ds.enabled === false) {
+            base['enabled'] = false;
+        }
+        else {
+            delete base['enabled'];
+        }
+        return base;
+    }
+    // claude-code, cursor, windsurf — same merge format
+    const base = { ...existingRaw };
+    if (ds.url) {
+        base['url'] = ds.url;
+        delete base['command'];
+        delete base['args'];
+        delete base['env'];
+        const t = typeof base['type'] === 'string' ? base['type'] : undefined;
+        if (t && LOCAL_TYPES.has(t))
+            delete base['type'];
+        const tr = typeof base['transport'] === 'string' ? base['transport'] : undefined;
+        if (tr && LOCAL_TYPES.has(tr))
+            delete base['transport'];
+    }
+    else {
+        const [cmd, ...args] = ds.command ?? [];
+        base['command'] = cmd ?? '';
+        if (args.length > 0) {
+            base['args'] = args;
+        }
+        else {
+            delete base['args'];
+        }
+        if (ds.env && Object.keys(ds.env).length > 0) {
+            base['env'] = ds.env;
+        }
+        else {
+            delete base['env'];
+        }
+        delete base['url'];
+        const t = typeof base['type'] === 'string' ? base['type'] : undefined;
+        if (t && REMOTE_TYPES.has(t))
+            delete base['type'];
+        const tr = typeof base['transport'] === 'string' ? base['transport'] : undefined;
+        if (tr && REMOTE_TYPES.has(tr))
+            delete base['transport'];
+    }
+    return base;
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * PURE / read-only: compute what would change for each target tool without writing.
+ */
+export function planSync(manifest, opts, targets, scope, prune) {
+    const desired = manifestToDesired(manifest);
+    const plans = [];
+    for (const toolId of targets) {
+        const adapter = getAdapter(toolId);
+        if (!adapter)
+            continue;
+        const location = adapter.writeLocation(opts, scope);
+        if (location === null) {
+            plans.push({
+                tool: toolId,
+                location: null,
+                change: { added: [], updated: [], removed: [] },
+                skipped: [{ name: '*', reason: `${toolId} has no ${scope} config location` }]
+            });
+            continue;
+        }
+        const { change, skipped } = computeDiff(location.path, toolId, desired, prune);
+        plans.push({ tool: toolId, location, change, skipped });
+    }
+    return plans;
+}
+/**
+ * Apply the sync — calls each adapter's writeServers and returns actually-applied changes.
+ */
+export function applySync(manifest, opts, targets, scope, prune) {
+    const desired = manifestToDesired(manifest);
+    const results = [];
+    for (const toolId of targets) {
+        const adapter = getAdapter(toolId);
+        if (!adapter)
+            continue;
+        const location = adapter.writeLocation(opts, scope);
+        if (location === null) {
+            results.push({
+                tool: toolId,
+                location: null,
+                change: { added: [], updated: [], removed: [] },
+                skipped: [{ name: '*', reason: `${toolId} has no ${scope} config location` }]
+            });
+            continue;
+        }
+        // Separate skipped (disabled on tools that can't represent them) from writable
+        const needsEnabled = toolId === 'opencode';
+        const skipped = [];
+        const writableDesired = [];
+        for (const ds of desired) {
+            if (ds.enabled === false && !needsEnabled) {
+                skipped.push({
+                    name: ds.name,
+                    reason: `${toolId} does not support disabled servers; skipped`
+                });
+            }
+            else {
+                writableDesired.push(ds);
+            }
+        }
+        const change = adapter.writeServers(location, writableDesired, { prune });
+        results.push({ tool: toolId, location, change, skipped });
+    }
+    return results;
+}
+//# sourceMappingURL=sync.js.map

package/dist/stack/sync.js.map

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