opencode-agora 0.4.2 → 0.4.3

package/dist/stack/adapters/windsurf.js

@@ -0,0 +1,218 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { atomicWriteFile } from '../../atomic-write.js';
+function resolveHome(opts) {
+    return opts.home ?? homedir();
+}
+const REMOTE_TYPES = new Set(['sse', 'http', 'streamable-http']);
+const LOCAL_TYPES = new Set(['stdio']);
+/** Fix 2: robust transport detection */
+function isRemoteEntry(entry) {
+    const t = typeof entry['type'] === 'string' ? entry['type'] : undefined;
+    const tr = typeof entry['transport'] === 'string' ? entry['transport'] : undefined;
+    const hasUrl = 'url' in entry;
+    const hasCommand = 'command' in entry;
+    if (t && REMOTE_TYPES.has(t))
+        return true;
+    if (tr && REMOTE_TYPES.has(tr))
+        return true;
+    if (t && LOCAL_TYPES.has(t))
+        return false;
+    if (tr && LOCAL_TYPES.has(tr))
+        return false;
+    if (hasCommand)
+        return false;
+    return hasUrl;
+}
+function parseJson(path) {
+    try {
+        const content = readFileSync(path, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fix 1: Merge a DesiredServer into an existing entry, preserving unknown keys.
+ * Returns null when the server should not be written (disabled).
+ */
+function mergeEntry(ds, existing) {
+    // windsurf has no enabled field — skip disabled servers
+    if (ds.enabled === false)
+        return null;
+    const base = existing !== undefined ? { ...existing } : {};
+    if (ds.url) {
+        // REMOTE
+        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 {
+        // LOCAL
+        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;
+}
+function entriesEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+export const windsurfAdapter = {
+    id: 'windsurf',
+    displayName: 'Windsurf',
+    locations(opts) {
+        const home = resolveHome(opts);
+        return [
+            {
+                path: join(home, '.codeium', 'windsurf', 'mcp_config.json'),
+                scope: 'user'
+            }
+        ];
+    },
+    writeLocation(opts, scope) {
+        if (scope === 'project')
+            return null; // windsurf has no project config
+        const home = resolveHome(opts);
+        return {
+            path: join(home, '.codeium', 'windsurf', 'mcp_config.json'),
+            scope: 'user'
+        };
+    },
+    writeServers(location, desired, opts) {
+        const filePath = location.path;
+        let doc = {};
+        if (existsSync(filePath)) {
+            const raw = readFileSync(filePath, 'utf8');
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch (e) {
+                throw new Error(`windsurf config at ${filePath} is not valid JSON — refusing to overwrite: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+            }
+            if (typeof parsed === 'object' && parsed !== null) {
+                doc = parsed;
+            }
+        }
+        const result = { ...doc };
+        const existingMcp = typeof doc['mcpServers'] === 'object' && doc['mcpServers'] !== null
+            ? { ...doc['mcpServers'] }
+            : {};
+        const added = [];
+        const updated = [];
+        const removed = [];
+        const desiredMap = new Map(desired.map((d) => [d.name, d]));
+        const newMcp = opts.prune ? {} : { ...existingMcp };
+        for (const ds of desired) {
+            const existingEntry = typeof existingMcp[ds.name] === 'object' && existingMcp[ds.name] !== null
+                ? existingMcp[ds.name]
+                : undefined;
+            const mergedEntry = mergeEntry(ds, existingEntry);
+            if (mergedEntry === null) {
+                // disabled — skip writing
+                if (opts.prune)
+                    delete newMcp[ds.name];
+                continue;
+            }
+            if (existingEntry === undefined) {
+                added.push(ds.name);
+            }
+            else {
+                if (!entriesEqual(existingEntry, mergedEntry)) {
+                    updated.push(ds.name);
+                }
+            }
+            newMcp[ds.name] = mergedEntry;
+        }
+        if (opts.prune) {
+            for (const name of Object.keys(existingMcp)) {
+                if (!desiredMap.has(name)) {
+                    removed.push(name);
+                }
+            }
+        }
+        result['mcpServers'] = newMcp;
+        atomicWriteFile(filePath, JSON.stringify(result, null, 2) + '\n', 0o644);
+        return { added, updated, removed };
+    },
+    readServers(opts) {
+        const home = resolveHome(opts);
+        const filePath = join(home, '.codeium', 'windsurf', 'mcp_config.json');
+        if (!existsSync(filePath))
+            return [];
+        const parsed = parseJson(filePath);
+        if (parsed === null)
+            return [];
+        const doc = parsed;
+        const mcpServers = doc['mcpServers'];
+        if (typeof mcpServers !== 'object' || mcpServers === null)
+            return [];
+        const servers = [];
+        for (const [name, v] of Object.entries(mcpServers)) {
+            if (typeof v !== 'object' || v === null)
+                continue;
+            const entry = v;
+            if (isRemoteEntry(entry)) {
+                servers.push({
+                    name,
+                    tool: 'windsurf',
+                    scope: 'user',
+                    configPath: filePath,
+                    transport: 'remote',
+                    url: typeof entry['url'] === 'string' ? entry['url'] : undefined,
+                    enabled: true,
+                    raw: entry
+                });
+            }
+            else {
+                const cmd = typeof entry['command'] === 'string' ? entry['command'] : '';
+                const args = Array.isArray(entry['args']) ? entry['args'] : [];
+                const env = typeof entry['env'] === 'object' && entry['env'] !== null
+                    ? entry['env']
+                    : undefined;
+                const argv = [cmd, ...args];
+                servers.push({
+                    name,
+                    tool: 'windsurf',
+                    scope: 'user',
+                    configPath: filePath,
+                    transport: 'local',
+                    command: argv,
+                    env,
+                    enabled: true,
+                    raw: entry
+                });
+            }
+        }
+        return servers;
+    }
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/stack/adapters/windsurf.js.map

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

package/dist/stack/capability-cache.d.ts

@@ -0,0 +1,19 @@
+import type { McpTool } from './mcp-probe.js';
+export interface ServerCapabilities {
+    key: string;
+    name: string;
+    command: string[];
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    tools: McpTool[];
+    ok: boolean;
+    probedAt: string;
+}
+export declare function capabilityCachePath(dataDir: string): string;
+export declare function capabilityKey(name: string, command: string[]): string;
+export declare function readCapabilityCache(dataDir: string): ServerCapabilities[];
+export declare function writeCapabilityCache(dataDir: string, entries: ServerCapabilities[]): void;
+export declare function upsertCapabilities(dataDir: string, entry: ServerCapabilities): void;
+//# sourceMappingURL=capability-cache.d.ts.map

package/dist/stack/capability-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-cache.d.ts","sourceRoot":"","sources":["../../src/stack/capability-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAGrE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAWzE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CASnF"}

package/dist/stack/capability-cache.js

@@ -0,0 +1,41 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWriteFile } from '../atomic-write.js';
+export function capabilityCachePath(dataDir) {
+    return join(dataDir, 'capabilities.json');
+}
+export function capabilityKey(name, command) {
+    const hash = createHash('sha1').update(command.join(' ')).digest('hex').slice(0, 8);
+    return `${name}@${hash}`;
+}
+export function readCapabilityCache(dataDir) {
+    const path = capabilityCachePath(dataDir);
+    if (!existsSync(path))
+        return [];
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed;
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+export function writeCapabilityCache(dataDir, entries) {
+    atomicWriteFile(capabilityCachePath(dataDir), JSON.stringify(entries, null, 2));
+}
+export function upsertCapabilities(dataDir, entry) {
+    const existing = readCapabilityCache(dataDir);
+    const idx = existing.findIndex((e) => e.key === entry.key);
+    if (idx >= 0) {
+        existing[idx] = entry;
+    }
+    else {
+        existing.push(entry);
+    }
+    writeCapabilityCache(dataDir, existing);
+}
+//# sourceMappingURL=capability-cache.js.map

package/dist/stack/capability-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-cache.js","sourceRoot":"","sources":["../../src/stack/capability-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAarD,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAiB;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAA8B,CAAC;QACjE,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,OAA6B;IACjF,eAAe,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAyB;IAC3E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/dist/stack/doctor.d.ts

@@ -0,0 +1,30 @@
+import type { ConfiguredServer, StackEnv } from './types.js';
+export type HealthStatus = 'ok' | 'warn' | 'error';
+export interface HealthCheck {
+    name: string;
+    ok: boolean;
+    level: 'warn' | 'error';
+    detail?: string;
+}
+export interface ServerHealth {
+    name: string;
+    instances: ConfiguredServer[];
+    status: HealthStatus;
+    checks: HealthCheck[];
+}
+export interface StackHealth {
+    servers: ServerHealth[];
+    summary: {
+        ok: number;
+        warn: number;
+        error: number;
+    };
+}
+export interface DoctorOptions extends StackEnv {
+    probe?: boolean;
+    probeTimeoutMs?: number;
+    dataDir?: string;
+}
+export declare function checkServer(name: string, instances: ConfiguredServer[], opts?: DoctorOptions): ServerHealth;
+export declare function checkStack(servers: ConfiguredServer[], opts?: DoctorOptions): Promise<StackHealth>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/stack/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4KD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,gBAAgB,EAAE,EAC7B,IAAI,CAAC,EAAE,aAAa,GACnB,YAAY,CAqBd;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,WAAW,CAAC,CAsDtB"}

package/dist/stack/doctor.js

@@ -0,0 +1,227 @@
+import { KNOWN_RUNNERS, resolveOnPath } from './path-resolve.js';
+import { probeMcpServer } from './mcp-probe.js';
+import { upsertCapabilities, capabilityKey } from './capability-cache.js';
+function deriveStatus(checks) {
+    if (checks.some((c) => !c.ok && c.level === 'error'))
+        return 'error';
+    if (checks.some((c) => !c.ok && c.level === 'warn'))
+        return 'warn';
+    return 'ok';
+}
+function checkCommandResolvable(instances, opts) {
+    // Only applies to local transports
+    const localInstances = instances.filter((s) => s.transport === 'local');
+    if (localInstances.length === 0)
+        return null;
+    const pathEnv = opts?.env;
+    for (const inst of localInstances) {
+        const argv = inst.command ?? [];
+        if (argv.length === 0) {
+            return {
+                name: 'command-resolvable',
+                ok: false,
+                level: 'error',
+                detail: `${inst.tool}: command is empty`
+            };
+        }
+        const token = argv[0];
+        const resolved = resolveOnPath(token, pathEnv);
+        if (!resolved) {
+            return {
+                name: 'command-resolvable',
+                ok: false,
+                level: 'error',
+                detail: `${inst.tool}: '${token}' not found on PATH`
+            };
+        }
+        // If the token is a known runner, require a non-flag package/script arg
+        if (KNOWN_RUNNERS.has(token)) {
+            const hasNonFlagArg = argv.slice(1).some((a) => !a.startsWith('-'));
+            if (!hasNonFlagArg) {
+                return {
+                    name: 'command-resolvable',
+                    ok: false,
+                    level: 'error',
+                    detail: `${inst.tool}: runner '${token}' has no package/script argument`
+                };
+            }
+        }
+    }
+    return { name: 'command-resolvable', ok: true, level: 'error' };
+}
+function checkRemoteUrl(instances) {
+    const remoteInstances = instances.filter((s) => s.transport === 'remote');
+    if (remoteInstances.length === 0)
+        return null;
+    for (const inst of remoteInstances) {
+        if (!inst.url) {
+            return {
+                name: 'remote-url',
+                ok: false,
+                level: 'warn',
+                detail: `${inst.tool}: remote entry has no url`
+            };
+        }
+        try {
+            const parsed = new URL(inst.url);
+            if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+                return {
+                    name: 'remote-url',
+                    ok: false,
+                    level: 'warn',
+                    detail: `${inst.tool}: url '${inst.url}' is not http(s)`
+                };
+            }
+        }
+        catch {
+            return {
+                name: 'remote-url',
+                ok: false,
+                level: 'warn',
+                detail: `${inst.tool}: url '${inst.url}' is not a valid URL`
+            };
+        }
+    }
+    return { name: 'remote-url', ok: true, level: 'warn' };
+}
+function checkDisabled(instances) {
+    if (instances.every((s) => s.enabled === false)) {
+        return {
+            name: 'disabled',
+            ok: false,
+            level: 'warn',
+            detail: 'all instances are disabled'
+        };
+    }
+    return null;
+}
+function checkConflictingDefinition(instances) {
+    if (instances.length < 2)
+        return null;
+    // Collect unique signatures (command joined or url)
+    const signatures = new Set();
+    for (const inst of instances) {
+        if (inst.transport === 'local') {
+            signatures.add(`local:${(inst.command ?? []).join(' ')}`);
+        }
+        else {
+            signatures.add(`remote:${inst.url ?? ''}`);
+        }
+    }
+    if (signatures.size > 1) {
+        return {
+            name: 'conflicting-definition',
+            ok: false,
+            level: 'warn',
+            detail: `${instances.length} instances differ in command/url across tools/scopes`
+        };
+    }
+    return null;
+}
+async function probeServer(inst, opts, timeoutMs) {
+    if (inst.transport !== 'local' || !inst.command || inst.command.length === 0) {
+        const check = {
+            name: 'probe',
+            ok: true,
+            level: 'error',
+            detail: 'skipped (not local)'
+        };
+        return { check, result: { ok: true } };
+    }
+    const result = await probeMcpServer(inst.command, {
+        env: opts.env,
+        cwd: opts.cwd,
+        timeoutMs
+    });
+    let detail;
+    if (result.ok) {
+        const toolCount = result.tools?.length ?? 0;
+        const parts = [`started · ${toolCount} tool(s)`];
+        if (result.serverInfo?.name || result.serverInfo?.version) {
+            const info = [result.serverInfo.name, result.serverInfo.version].filter(Boolean).join(' ');
+            parts.push(info);
+        }
+        detail = parts.join(' · ');
+    }
+    else {
+        detail =
+            result.error ??
+                (result.exitCode !== undefined && result.exitCode !== null
+                    ? `exited with code ${result.exitCode}`
+                    : 'probe failed');
+    }
+    const check = { name: 'probe', ok: result.ok, level: 'error', detail };
+    return { check, result };
+}
+export function checkServer(name, instances, opts) {
+    const checks = [];
+    const resolvableCheck = checkCommandResolvable(instances, opts);
+    if (resolvableCheck)
+        checks.push(resolvableCheck);
+    const remoteCheck = checkRemoteUrl(instances);
+    if (remoteCheck)
+        checks.push(remoteCheck);
+    const disabledCheck = checkDisabled(instances);
+    if (disabledCheck)
+        checks.push(disabledCheck);
+    const conflictCheck = checkConflictingDefinition(instances);
+    if (conflictCheck)
+        checks.push(conflictCheck);
+    return {
+        name,
+        instances,
+        status: deriveStatus(checks),
+        checks
+    };
+}
+export async function checkStack(servers, opts) {
+    const probeTimeoutMs = opts?.probeTimeoutMs ?? 8000;
+    // Group by name
+    const grouped = new Map();
+    for (const s of servers) {
+        const existing = grouped.get(s.name);
+        if (existing) {
+            existing.push(s);
+        }
+        else {
+            grouped.set(s.name, [s]);
+        }
+    }
+    const serverHealthList = [];
+    for (const [name, instances] of grouped) {
+        const health = checkServer(name, instances, opts);
+        // Optional probe: only local servers, only when probe=true
+        if (opts?.probe) {
+            const localEnabled = instances.filter((s) => s.transport === 'local' && s.enabled !== false);
+            for (const inst of localEnabled) {
+                const { check, result } = await probeServer(inst, opts ?? {}, probeTimeoutMs);
+                health.checks.push(check);
+                if (opts?.dataDir && inst.command && inst.command.length > 0) {
+                    try {
+                        upsertCapabilities(opts.dataDir, {
+                            key: capabilityKey(name, inst.command),
+                            name,
+                            command: inst.command,
+                            serverInfo: result.serverInfo,
+                            tools: result.tools ?? [],
+                            ok: result.ok,
+                            probedAt: new Date().toISOString()
+                        });
+                    }
+                    catch {
+                        // best-effort
+                    }
+                }
+            }
+            // Recompute status with probe results
+            health.status = deriveStatus(health.checks);
+        }
+        serverHealthList.push(health);
+    }
+    const summary = { ok: 0, warn: 0, error: 0 };
+    for (const h of serverHealthList) {
+        summary[h.status]++;
+    }
+    return { servers: serverHealthList, summary };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/stack/doctor.js.map

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

package/dist/stack/manifest.d.ts

@@ -0,0 +1,40 @@
+import type { FetchLike } from '../live.js';
+import type { ConfiguredServer, StackEnv } from './types.js';
+export interface ManifestEntry {
+    command?: string[];
+    url?: string;
+    env?: Record<string, string>;
+    enabled?: boolean;
+}
+export interface StackManifest {
+    mcp: Record<string, ManifestEntry>;
+    skills?: Record<string, ManifestEntry>;
+    workflows?: Record<string, ManifestEntry>;
+}
+export declare function manifestPath(env: StackEnv): string;
+export type OpencodeMcpEntry = {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+    enabled?: boolean;
+} | {
+    type: 'remote';
+    url: string;
+    enabled?: boolean;
+};
+export declare function opencodeEntryToManifest(entry: OpencodeMcpEntry): ManifestEntry;
+export declare function serverToEntry(server: ConfiguredServer): ManifestEntry;
+export declare function serializeManifest(m: StackManifest): string;
+export declare function parseManifest(text: string): StackManifest;
+export declare function readManifest(path: string): StackManifest | null;
+export declare function writeManifest(path: string, m: StackManifest): void;
+/**
+ * Load a StackManifest from a URL or file path.
+ * Throws a descriptive Error on fetch failure, missing file, or parse error.
+ * The caller is responsible for mapping thrown errors to usageError output.
+ */
+export declare function loadManifestFromSource(source: string, opts: {
+    cwd?: string;
+    fetcher?: FetchLike;
+}): Promise<StackManifest>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/stack/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI7D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC3C;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAKlD;AAID,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAc9E;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAcrE;AAoDD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAkB1D;AAgHD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAmFzD;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAI/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,GAAG,IAAI,CAElE;AAID;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAC1C,OAAO,CAAC,aAAa,CAAC,CAoCxB"}