@agents-dev/cli 0.8.1 → 0.8.3

package/dist/core/updateCheck.js

@@ -0,0 +1,227 @@
+import os from 'node:os';
+import path from 'node:path';
+import { pathExists, readJson, writeJsonAtomic } from './fs.js';
+import { getProjectPaths } from './paths.js';
+import * as ui from './ui.js';
+const NPM_LATEST_URL = 'https://registry.npmjs.org/@agents-dev/cli/latest';
+const DEFAULT_TIMEOUT_MS = 1500;
+const STARTUP_RECHECK_MS = 6 * 60 * 60 * 1000;
+export const UPGRADE_COMMAND = 'npm install -g @agents-dev/cli@latest';
+export async function checkForUpdates(options) {
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const timeoutMs = normalizeTimeout(options.timeoutMs);
+    const storage = await loadStorageState(options.projectRoot);
+    const metadata = readUpdateMetadata(storage.document);
+    const channel = resolveUpdateChannel();
+    if (!channel.ok) {
+        metadata.lastSeenVersion = options.currentVersion;
+        writeUpdateMetadata(storage.document, storage.kind, metadata);
+        await writeJsonAtomic(storage.filePath, storage.document);
+        return {
+            currentVersion: options.currentVersion,
+            latestVersion: normalizeVersion(metadata.latestVersion),
+            isOutdated: false,
+            upgradeCommand: UPGRADE_COMMAND,
+            checkedAt: metadata.lastCheckedAt ?? nowIso,
+            source: 'unavailable',
+            error: channel.error
+        };
+    }
+    let source = 'cache';
+    let latestVersion = normalizeVersion(metadata.latestVersion);
+    let errorMessage;
+    const shouldRefresh = options.forceRefresh === true || !isRecent(metadata.lastCheckedAt, STARTUP_RECHECK_MS);
+    if (!latestVersion || shouldRefresh) {
+        const fetched = await fetchLatestVersion(timeoutMs);
+        if (fetched.version) {
+            latestVersion = fetched.version;
+            metadata.latestVersion = fetched.version;
+            metadata.lastCheckedAt = nowIso;
+            source = 'network';
+        }
+        else if (latestVersion) {
+            source = 'cache-stale';
+            errorMessage = fetched.error;
+        }
+        else {
+            source = 'unavailable';
+            errorMessage = fetched.error;
+        }
+    }
+    metadata.lastSeenVersion = options.currentVersion;
+    const isOutdated = compareVersions(options.currentVersion, latestVersion) < 0;
+    if (isOutdated && options.markNotifiedIfOutdated) {
+        metadata.lastNotifiedAt = nowIso;
+    }
+    writeUpdateMetadata(storage.document, storage.kind, metadata);
+    await writeJsonAtomic(storage.filePath, storage.document);
+    return {
+        currentVersion: options.currentVersion,
+        latestVersion,
+        isOutdated,
+        upgradeCommand: UPGRADE_COMMAND,
+        checkedAt: metadata.lastCheckedAt ?? nowIso,
+        source,
+        error: errorMessage
+    };
+}
+export async function maybeNotifyAboutUpdate(args) {
+    try {
+        const status = await checkForUpdates({
+            currentVersion: args.currentVersion,
+            projectRoot: args.projectRoot,
+            markNotifiedIfOutdated: true
+        });
+        if (!status.isOutdated || !status.latestVersion)
+            return;
+        ui.blank();
+        ui.warning(`Update available: ${status.currentVersion} -> ${status.latestVersion}`);
+        ui.hint(`Run "${status.upgradeCommand}"`);
+    }
+    catch {
+        // Update checks should never block command execution.
+    }
+}
+async function loadStorageState(projectRoot) {
+    const projectLocalPath = projectRoot ? getProjectPaths(projectRoot).agentsLocal : undefined;
+    if (projectLocalPath && (await pathExists(projectLocalPath))) {
+        return {
+            kind: 'project-local',
+            filePath: projectLocalPath,
+            document: await readDocument(projectLocalPath)
+        };
+    }
+    const globalPath = path.join(os.homedir(), '.agents-dev', 'update-check.json');
+    return {
+        kind: 'global',
+        filePath: globalPath,
+        document: await readDocument(globalPath)
+    };
+}
+async function readDocument(filePath) {
+    if (!(await pathExists(filePath)))
+        return {};
+    try {
+        const parsed = await readJson(filePath);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function readUpdateMetadata(document) {
+    const meta = asObject(document.meta);
+    const updateCheck = asObject(meta?.updateCheck);
+    return {
+        lastCheckedAt: asString(updateCheck?.lastCheckedAt),
+        lastSeenVersion: asString(updateCheck?.lastSeenVersion),
+        lastNotifiedAt: asString(updateCheck?.lastNotifiedAt),
+        latestVersion: asString(updateCheck?.latestVersion)
+    };
+}
+function writeUpdateMetadata(document, kind, metadata) {
+    if (kind === 'project-local' && !asObject(document.mcpServers)) {
+        document.mcpServers = {};
+    }
+    const meta = asObject(document.meta) ?? {};
+    meta.updateCheck = {
+        ...(asObject(meta.updateCheck) ?? {}),
+        ...metadata
+    };
+    document.meta = meta;
+}
+async function fetchLatestVersion(timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(NPM_LATEST_URL, {
+            headers: { Accept: 'application/json' },
+            signal: controller.signal
+        });
+        if (!response.ok) {
+            return { version: null, error: `registry request failed (${response.status})` };
+        }
+        const payload = await response.json();
+        const version = normalizeVersion(typeof payload.version === 'string' ? payload.version : null);
+        if (!version) {
+            return { version: null, error: 'invalid registry response' };
+        }
+        return { version };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { version: null, error: message };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function normalizeTimeout(input) {
+    if (!Number.isFinite(input))
+        return DEFAULT_TIMEOUT_MS;
+    if (!input || input <= 0)
+        return DEFAULT_TIMEOUT_MS;
+    return Math.floor(input);
+}
+function isRecent(value, thresholdMs) {
+    if (!value)
+        return false;
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed))
+        return false;
+    return Date.now() - parsed <= thresholdMs;
+}
+function normalizeVersion(value) {
+    if (!value)
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    return trimmed.startsWith('v') ? trimmed.slice(1) : trimmed;
+}
+function compareVersions(current, latest) {
+    if (!latest)
+        return 0;
+    const a = parseSemver(current);
+    const b = parseSemver(latest);
+    if (!a || !b)
+        return 0;
+    for (let i = 0; i < 3; i += 1) {
+        if (a[i] === b[i])
+            continue;
+        return a[i] < b[i] ? -1 : 1;
+    }
+    return 0;
+}
+function parseSemver(value) {
+    const match = value.trim().match(/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
+    if (!match)
+        return null;
+    const major = Number.parseInt(match[1], 10);
+    const minor = Number.parseInt(match[2], 10);
+    const patch = Number.parseInt(match[3], 10);
+    if (![major, minor, patch].every((part) => Number.isInteger(part))) {
+        return null;
+    }
+    return [major, minor, patch];
+}
+function asObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function resolveUpdateChannel() {
+    const raw = (process.env.AGENTS_UPDATE_CHANNEL ?? 'stable').trim().toLowerCase();
+    if (!raw || raw === 'stable') {
+        return { ok: true, value: 'stable' };
+    }
+    return {
+        ok: false,
+        error: `unsupported update channel "${raw}" (only "stable" is currently supported)`
+    };
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/core/updateCheck.js.map

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

package/dist/core/version.d.ts

@@ -0,0 +1 @@
+export declare const CLI_VERSION = "0.8.3";

package/dist/core/version.js

@@ -0,0 +1,2 @@
+export const CLI_VERSION = '0.8.3';
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA"}

package/dist/core/windsurf.d.ts

@@ -0,0 +1,8 @@
+export interface WindsurfMcpPayload {
+    mcpServers?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare function getWindsurfGlobalMcpPath(): string;
+export declare function readWindsurfMcp(pathToRead: string): Promise<WindsurfMcpPayload | undefined>;
+export declare function writeWindsurfMcp(pathToWrite: string, payload: WindsurfMcpPayload): Promise<void>;
+export declare function normalizeWindsurfMcpPayload(payload: WindsurfMcpPayload): WindsurfMcpPayload;

package/dist/core/windsurf.js

@@ -0,0 +1,29 @@
+import os from 'node:os';
+import path from 'node:path';
+import { ensureDir, pathExists, readJson, writeJsonAtomic } from './fs.js';
+export function getWindsurfGlobalMcpPath() {
+    const override = process.env.AGENTS_WINDSURF_MCP_PATH;
+    if (override && override.trim().length > 0) {
+        return path.resolve(override);
+    }
+    return path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+}
+export async function readWindsurfMcp(pathToRead) {
+    if (!(await pathExists(pathToRead)))
+        return undefined;
+    return readJson(pathToRead);
+}
+export async function writeWindsurfMcp(pathToWrite, payload) {
+    await ensureDir(path.dirname(pathToWrite));
+    await writeJsonAtomic(pathToWrite, normalizeWindsurfMcpPayload(payload));
+}
+export function normalizeWindsurfMcpPayload(payload) {
+    return {
+        ...payload,
+        mcpServers: isRecord(payload.mcpServers) ? payload.mcpServers : {}
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/core/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/core/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAO1E,MAAM,UAAU,wBAAwB;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAA;IACrD,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAA;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACrD,OAAO,QAAQ,CAAqB,UAAU,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,OAA2B;IACrF,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;IAC1C,MAAM,eAAe,CAAC,WAAW,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAA2B;IACrE,OAAO;QACL,GAAG,OAAO;QACV,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;KACnE,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC"}

package/dist/integrations/opencode.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedMcpServer } from '../types.js';
+export declare function buildOpencodePayload(servers: ResolvedMcpServer[]): {
+    payload: {
+        mcp: Record<string, unknown>;
+    };
+    warnings: string[];
+};

package/dist/integrations/opencode.js

@@ -0,0 +1,9 @@
+import { renderOpencodeMcp } from '../core/renderers.js';
+export function buildOpencodePayload(servers) {
+    const rendered = renderOpencodeMcp(servers);
+    return {
+        payload: { mcp: rendered.mcp },
+        warnings: rendered.warnings
+    };
+}
+//# sourceMappingURL=opencode.js.map

package/dist/integrations/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/integrations/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAI/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;QAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC"}

package/dist/integrations/registry.js

@@ -4,7 +4,9 @@ export const INTEGRATIONS = [
     { id: 'gemini', label: 'Gemini CLI', requiredBinary: 'gemini' },
     { id: 'copilot_vscode', label: 'Copilot VS Code', requiredBinary: 'code' },
     { id: 'cursor', label: 'Cursor', requiredBinary: 'cursor-agent' },
-    { id: 'antigravity', label: 'Antigravity', requiredBinary: 'antigravity' }
+    { id: 'antigravity', label: 'Antigravity', requiredBinary: 'antigravity' },
+    { id: 'windsurf', label: 'Windsurf' },
+    { id: 'opencode', label: 'OpenCode' }
 ];
 export const INTEGRATION_IDS = INTEGRATIONS.map((item) => item.id);
 export function parseIntegrationList(input) {

package/dist/integrations/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE;IACxD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE;IAChE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE;IAC/D,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,EAAE;IAC1E,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE;IACjE,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE;CAC3E,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAsB,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAErF,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,MAAM,GAAG,KAAK;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAA;IAElB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAuB,CAAC,CAAC,CAAA;IAC3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACxG,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAA2B,CAAC,CAAC,CAAA;AAClD,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE;IACxD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE;IAChE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE;IAC/D,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,EAAE;IAC1E,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE;IACjE,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE;IAC1E,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;IACrC,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;CACtC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAsB,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAErF,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,MAAM,GAAG,KAAK;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAA;IAElB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAuB,CAAC,CAAC,CAAA;IAC3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACxG,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAA2B,CAAC,CAAC,CAAA;AAClD,CAAC"}

package/dist/integrations/windsurf.d.ts

@@ -5,5 +5,3 @@ export declare function buildWindsurfPayload(servers: ResolvedMcpServer[]): {
     };
     warnings: string[];
 };
-export declare function toManagedWindsurfName(projectHash: string, serverName: string): string;
-export declare function deriveWindsurfProjectHash(projectRoot: string): string;

package/dist/integrations/windsurf.js

@@ -1,17 +1,9 @@
-import { createHash } from 'node:crypto';
-import path from 'node:path';
 import { renderWindsurfMcp } from '../core/renderers.js';
 export function buildWindsurfPayload(servers) {
     const rendered = renderWindsurfMcp(servers);
     return {
-        payload: { mcpServers: rendered.servers },
+        payload: { mcpServers: rendered.mcpServers },
         warnings: rendered.warnings
     };
 }
-export function toManagedWindsurfName(projectHash, serverName) {
-    return `agents__${projectHash}__${serverName}`;
-}
-export function deriveWindsurfProjectHash(projectRoot) {
-    return createHash('sha256').update(path.resolve(projectRoot)).digest('hex').slice(0, 12);
-}
 //# sourceMappingURL=windsurf.js.map

package/dist/integrations/windsurf.js.map

@@ -1 +1 @@
-{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/integrations/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAI/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE;QACzC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,UAAkB;IAC3E,OAAO,WAAW,WAAW,KAAK,UAAU,EAAE,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC1F,CAAC"}
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/integrations/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAI/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE;QAC5C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC"}

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 export declare const AGENTS_SCHEMA_VERSION = 3;
-export type IntegrationName = 'codex' | 'claude' | 'gemini' | 'copilot_vscode' | 'cursor' | 'antigravity';
+export type IntegrationName = 'codex' | 'claude' | 'gemini' | 'copilot_vscode' | 'cursor' | 'antigravity' | 'windsurf' | 'opencode';
 export type SyncMode = 'source-only' | 'commit-generated';
 export type McpTransportType = 'stdio' | 'http' | 'sse';
 export interface AgentsConfig {
@@ -40,8 +40,17 @@ export interface McpServerDefinition {
     targets?: IntegrationName[];
     enabled?: boolean;
 }
+export interface UpdateCheckMetadata {
+    lastCheckedAt?: string;
+    lastSeenVersion?: string;
+    lastNotifiedAt?: string;
+    latestVersion?: string;
+}
 export interface LocalOverridesFile {
     mcpServers: Record<string, Partial<McpServerDefinition>>;
+    meta?: {
+        updateCheck?: UpdateCheckMetadata;
+    };
 }
 export interface VscodeSettingsState {
     managedPaths: string[];

package/docs/EXAMPLES.md

@@ -77,33 +77,6 @@ Each project has its own `.agents/` config. No conflicts.
 
 ---
 
-## CI/CD Integration
-
-**.github/workflows/validate-agents.yml:**
-```yaml
-name: Validate Agents Config
-
-on:
-  pull_request:
-    paths:
-      - '.agents/**'
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm install -g @agents-dev/cli
-      - run: agents doctor
-      - run: agents mcp test --json
-      - run: agents sync --check
-```
-
----
-
 ## Monorepo
 
 **Root (company-wide servers):**
@@ -196,8 +169,8 @@ Add to `.bashrc`:
 ```bash
 agents_prompt() {
   if [ -d ".agents" ]; then
-    STATUS=$(agents status --fast --json 2>/dev/null | jq -r '.status')
-    [ "$STATUS" = "synced" ] && echo " 🟢" || echo " 🟡"
+    MCP_COUNT=$(agents status --fast --json 2>/dev/null | jq -r '.mcp.configured')
+    [ "${MCP_COUNT:-0}" -gt 0 ] && echo " 🟢" || echo " 🟡"
   fi
 }
 
@@ -209,3 +182,19 @@ PS1='$(agents_prompt) '"$PS1"
 ## More Examples?
 
 [Open a discussion](https://github.com/amtiYo/agents/discussions) and share your workflow!
+
+---
+
+## Windsurf + OpenCode
+
+```bash
+cd ~/my-project
+agents init
+agents connect --llm windsurf,opencode
+agents sync
+```
+
+**Result:**
+- Windsurf MCP is written to `~/.codeium/windsurf/mcp_config.json`
+- OpenCode MCP is written to project `opencode.json`
+- Skills are available from `.agents/skills` (Windsurf also gets `.windsurf/skills`)

package/docs/README.md

@@ -16,6 +16,7 @@
 ### Tools
 - [Codex](https://developers.openai.com/codex) | [Claude Code](https://code.claude.com/docs) | [Gemini CLI](https://geminicli.com/docs)
 - [Cursor](https://cursor.com/docs) | [Copilot](https://github.com/features/copilot) | [Antigravity](https://antigravity.google/docs)
+- [Windsurf](https://docs.windsurf.com/windsurf/cascade) | [OpenCode](https://opencode.ai/docs/)
 
 ## Contributing
 

package/docs/agents-system.md

@@ -68,7 +68,9 @@ project/
 | **Gemini** | `.gemini/settings.json` |
 | **Cursor** | `.cursor/mcp.json` + CLI enable |
 | **Copilot** | `.vscode/mcp.json` |
-| **Antigravity** | `.antigravity/mcp.json` |
+| **Antigravity** | Global user profile `mcp.json` (not project-local) |
+| **Windsurf** | Global user profile `~/.codeium/windsurf/mcp_config.json` |
+| **OpenCode** | `opencode.json` (`mcp` block) |
 
 ## VS Code Integration
 
@@ -81,6 +83,9 @@ project/
     "**/.cursor": true,
     "**/.gemini": true,
     "**/.antigravity": true,
+    "**/.windsurf": true,
+    "**/.opencode": true,
+    "**/opencode.json": true,
     "**/.agents/generated": true
   }
 }
@@ -97,6 +102,9 @@ project/
 | **Claude** | Symlink to `.claude/skills/` |
 | **Cursor** | Symlink to `.cursor/skills/` |
 | **Gemini** | Symlink to `.gemini/skills/` |
+| **Antigravity** | Reuses `.gemini/skills/` bridge |
+| **Windsurf** | Symlink to `.windsurf/skills/` |
+| **OpenCode** | Reads `.agents/skills/` directly |
 
 **Validation:** `agents doctor` checks frontmatter (`name`, `description`)
 
@@ -171,7 +179,9 @@ project/
 **Gitignored:**
 - ❌ `.agents/local.json`
 - ❌ `.agents/generated/`
-- ❌ `.codex/`, `.claude/`, `.cursor/`, `.gemini/`, `.antigravity/`
+- ❌ `.codex/`, `.claude/`, `.cursor/`, `.gemini/`
+- ❌ `.windsurf/`, `.opencode/`, `opencode.json`
+- ❌ legacy `.antigravity/` (if present from older versions)
 
 ---
 

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@agents-dev/cli",
-  "version": "0.8.1",
-  "description": "One config to rule them all — Practical standard layer for multi-LLM development. Sync MCP servers, skills, and AGENTS.md across Codex, Claude Code, Gemini CLI, Cursor, Copilot, and Antigravity.",
+  "version": "0.8.3",
+  "description": "One config to rule them all — Practical standard layer for multi-LLM development. Sync MCP servers, skills, and AGENTS.md across Codex, Claude Code, Gemini CLI, Cursor, Copilot, Antigravity, Windsurf, and OpenCode.",
   "main": "dist/cli.js",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node -e \"const fs=require('node:fs'); fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
     "dev": "tsx src/cli.ts",
     "lint": "eslint .",
     "test": "vitest run",
+    "test:fast": "vitest run --exclude \"tests/**/*.integration.test.ts\"",
+    "test:integration": "vitest run integration.test.ts",
     "prepack": "npm run build"
   },
   "bin": {
@@ -35,6 +37,8 @@
     "cursor",
     "copilot",
     "antigravity",
+    "windsurf",
+    "opencode",
     "ai-coding",
     "llm-tools",
     "config-sync",

package/templates/agents/README.md

@@ -22,4 +22,7 @@ Project-local standard for AGENTS.md + MCP + SKILLS.
 - `.vscode/mcp.json`
 - `.vscode/settings.json`
 - `.cursor/mcp.json`
-- `.antigravity/mcp.json`
+- `opencode.json`
+- `.windsurf/skills/`
+- `~/.codeium/windsurf/mcp_config.json` (global)
+- `Antigravity User/mcp.json` (global)

package/dist/commands/migrate.d.ts

@@ -1,4 +0,0 @@
-export interface MigrateOptions {
-    projectRoot: string;
-}
-export declare function runMigrate(options: MigrateOptions): Promise<void>;

package/dist/commands/migrate.js

@@ -1,71 +0,0 @@
-import path from 'node:path';
-import { cp, mkdir } from 'node:fs/promises';
-import { createDefaultProjectConfig, loadLegacyConfig, saveProjectConfig } from '../core/config.js';
-import { ensureDir, pathExists, readJson, writeJsonAtomic } from '../core/fs.js';
-import { getProjectPaths } from '../core/paths.js';
-import { MCP_SELECTION_SCHEMA_VERSION } from '../types.js';
-export async function runMigrate(options) {
-    const projectRoot = path.resolve(options.projectRoot);
-    const paths = getProjectPaths(projectRoot);
-    if (await pathExists(paths.agentsProject)) {
-        process.stdout.write(`Migration skipped: already using ${paths.agentsProject}\n`);
-        return;
-    }
-    if (!(await pathExists(paths.agentsLegacyConfig))) {
-        throw new Error(`Legacy config not found at ${paths.agentsLegacyConfig}`);
-    }
-    const legacyConfig = await loadLegacyConfig(projectRoot);
-    const legacyRegistry = (await pathExists(paths.mcpLegacyRegistry))
-        ? await readJson(paths.mcpLegacyRegistry)
-        : { mcpServers: {} };
-    const backupDir = await createBackup(paths);
-    const projectConfig = mapLegacyConfig(legacyConfig);
-    await saveProjectConfig(projectRoot, projectConfig);
-    const selectedServers = Object.entries(legacyRegistry.mcpServers ?? {})
-        .filter(([, server]) => server.enabled !== false)
-        .map(([name]) => name)
-        .sort((a, b) => a.localeCompare(b));
-    const selection = {
-        schemaVersion: MCP_SELECTION_SCHEMA_VERSION,
-        preset: 'migrated-v1',
-        selectedMcpServers: selectedServers
-    };
-    await writeJsonAtomic(paths.mcpSelection, selection);
-    const localPayload = {
-        mcpServers: legacyRegistry.mcpServers ?? {}
-    };
-    await writeJsonAtomic(paths.mcpLocal, localPayload);
-    process.stdout.write(`Migrated v1 -> v2 in ${projectRoot}\n`);
-    process.stdout.write(`Backup created at ${backupDir}\n`);
-    process.stdout.write(`Created:\n- .agents/project.json\n- .agents/mcp/selection.json\n- .agents/mcp/local.json\n`);
-}
-function mapLegacyConfig(legacy) {
-    const config = createDefaultProjectConfig(legacy.projectRoot, legacy.linkMode);
-    config.enabledIntegrations = [...legacy.enabledIntegrations];
-    config.lastSync = legacy.lastSync;
-    config.syncMode = 'source-only';
-    config.selectedSkillPacks = [];
-    config.selectedSkills = [];
-    return config;
-}
-async function createBackup(paths) {
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const backupDir = path.join(paths.agentsBackupDir, timestamp);
-    await ensureDir(backupDir);
-    const filesToBackup = [
-        paths.agentsLegacyConfig,
-        paths.mcpLegacyRegistry,
-        paths.mcpLocal
-    ];
-    for (const filePath of filesToBackup) {
-        if (!(await pathExists(filePath)))
-            continue;
-        const dest = path.join(backupDir, path.basename(filePath));
-        await ensureDir(path.dirname(dest));
-        await cp(filePath, dest, { recursive: true });
-    }
-    // keep backup folder visible even if no files were copied
-    await mkdir(backupDir, { recursive: true });
-    return backupDir;
-}
-//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

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

package/dist/core/catalog.d.ts

@@ -1,8 +0,0 @@
-import type { CatalogFile } from '../types.js';
-export declare function getDefaultCatalog(): CatalogFile;
-export declare function ensureGlobalCatalog(): Promise<{
-    path: string;
-    catalog: CatalogFile;
-    created: boolean;
-}>;
-export declare function validateCatalog(catalog: CatalogFile): void;