@alfe.ai/integrations 0.5.3 → 0.6.0

package/dist/index.d.ts

@@ -290,6 +290,21 @@ declare class Installer {
    */
   private installLocalDependencies;
   private runNpmInstall;
+  /**
+   * Pre-fetch every npx-executed MCP server package the manifest declares
+   * (e.g. `command: npx, args: ["-y", "@alfe.ai/xero-mcp@0.3.8"]`) into the
+   * npx cache, WITHOUT executing the server. The first bundler connect then
+   * spawns from a warm cache instead of paying a 30-90s npm download during
+   * the MCP handshake — where it used to blow the connect budget and strand
+   * the server's tools until a daemon restart.
+   *
+   * Strictly best-effort: a missing/unparseable manifest, a non-npx command,
+   * or a failed download logs a warning and moves on — an install must never
+   * fail because a pre-warm did.
+   */
+  prewarmMcpNpxPackages(installPath: string): Promise<void>;
+  /** Populate the npx cache for a package spec via a no-op command. */
+  private runNpx;
   /**
    * List all locally installed integrations.
    */

package/dist/index.js

@@ -157,6 +157,7 @@ const log$6 = createLogger("Installer");
 const INTEGRATIONS_DIR = join(homedir(), ".alfe", "integrations");
 const GIT_TIMEOUT_MS = 6e4;
 const NPM_TIMEOUT_MS = 6e4;
+const NPX_PREWARM_TIMEOUT_MS = 12e4;
 /**
 * Dot-prefix for the transient staging directories used by the diff-based
 * in-place upgrade (`stage()` → `commitStaged()`). Dot-prefixed so `list()`
@@ -214,6 +215,7 @@ var Installer = class {
 		else await this.cloneDirect(resolved, installPath);
 		await this.ensureSharedPackages();
 		await this.installLocalDependencies(installPath);
+		await this.prewarmMcpNpxPackages(installPath);
 		return installPath;
 	}
 	/**
@@ -304,6 +306,7 @@ var Installer = class {
 			else await this.cloneDirect(resolved, stagingPath);
 			await this.ensureSharedPackages();
 			await this.installLocalDependencies(stagingPath);
+			await this.prewarmMcpNpxPackages(stagingPath);
 			return stagingPath;
 		} catch (err) {
 			if (existsSync(stagingPath)) rmSync(stagingPath, {
@@ -426,6 +429,63 @@ var Installer = class {
 		}
 	}
 	/**
+	* Pre-fetch every npx-executed MCP server package the manifest declares
+	* (e.g. `command: npx, args: ["-y", "@alfe.ai/xero-mcp@0.3.8"]`) into the
+	* npx cache, WITHOUT executing the server. The first bundler connect then
+	* spawns from a warm cache instead of paying a 30-90s npm download during
+	* the MCP handshake — where it used to blow the connect budget and strand
+	* the server's tools until a daemon restart.
+	*
+	* Strictly best-effort: a missing/unparseable manifest, a non-npx command,
+	* or a failed download logs a warning and moves on — an install must never
+	* fail because a pre-warm did.
+	*/
+	async prewarmMcpNpxPackages(installPath) {
+		let servers;
+		try {
+			const manifestPath = join(installPath, "alfe-integration.yaml");
+			if (!existsSync(manifestPath)) return;
+			servers = parseManifestFile(manifestPath).mcp_servers;
+		} catch (err) {
+			log$6.warn({
+				path: installPath,
+				err: err instanceof Error ? err.message : String(err)
+			}, "Skipping MCP npx pre-warm — manifest unreadable");
+			return;
+		}
+		for (const server of servers) {
+			if (server.command !== "npx") continue;
+			const spec = (server.args ?? []).find((a) => !a.startsWith("-"));
+			if (!spec) continue;
+			try {
+				log$6.info({
+					server: server.id,
+					spec
+				}, "Pre-warming npx cache for MCP server package");
+				await this.runNpx(spec);
+			} catch (err) {
+				log$6.warn({
+					server: server.id,
+					spec,
+					err: err instanceof Error ? err.message : String(err)
+				}, "MCP npx pre-warm failed — first connect will pay the cold download");
+			}
+		}
+	}
+	/** Populate the npx cache for a package spec via a no-op command. */
+	async runNpx(spec) {
+		await execFileAsync$2("npx", [
+			"-y",
+			"-p",
+			spec,
+			"-c",
+			"exit 0"
+		], {
+			timeout: NPX_PREWARM_TIMEOUT_MS,
+			maxBuffer: 16 * 1024 * 1024
+		});
+	}
+	/**
 	* List all locally installed integrations.
 	*/
 	list() {
@@ -4235,6 +4295,17 @@ const log = createLogger("McpApplier");
 const CONFIG_TEMPLATE_RE = /\{\{config\.([a-zA-Z0-9_]+)\}\}/g;
 const CREDENTIALS_TEMPLATE_RE = /\{\{credentials\.([a-z0-9-]+)\.([a-zA-Z0-9_]+)\}\}/g;
 const ALFE_TEMPLATE_RE = /\{\{alfe\.([a-zA-Z0-9_]+)\}\}/g;
+/**
+* Budget for the activation-time warm of each applied server. Matches the
+* bundler's default `connectTimeoutMs` so the warm never reports "failed"
+* for a connect that would still succeed within its own bound. Generous
+* enough to cover a cold `npx` npm download when the installer's pre-warm
+* failed; typically the pre-warm makes this a <5s cache hit. The warm is
+* fire-and-forget (see applyForIntegration), so this budget never extends
+* the reconcile pass — a warm that fails anyway is picked up by the
+* bundler's `retryNeverConnected` sweep within a minute.
+*/
+const MCP_ACTIVATION_WARM_TIMEOUT_MS = 12e4;
 var McpApplier = class {
 	manager;
 	credentials;
@@ -4275,6 +4346,25 @@ var McpApplier = class {
 			});
 			applied.push(id);
 		}
+		for (const id of applied) this.manager.warmServer(id, MCP_ACTIVATION_WARM_TIMEOUT_MS).then((status) => {
+			if (!status) return;
+			if (status.connected) log.info({
+				integrationId,
+				server: id,
+				toolCount: status.toolCount
+			}, "MCP server warmed on activation");
+			else log.warn({
+				integrationId,
+				server: id,
+				lastError: status.lastError
+			}, "MCP server failed activation warm — retry sweep will re-attempt");
+		}).catch((err) => {
+			log.warn({
+				integrationId,
+				server: id,
+				err: errMsg(err)
+			}, "MCP activation warm threw — retry sweep will re-attempt");
+		});
 		return applied;
 	}
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,8 +14,8 @@
   "dependencies": {
     "@auriclabs/logger": "^0.1.1",
     "yaml": ">=2.8.3",
-    "@alfe.ai/integration-manifest": "^0.3.3",
-    "@alfe.ai/mcp-bundler": "^0.3.2"
+    "@alfe.ai/integration-manifest": "^0.3.4",
+    "@alfe.ai/mcp-bundler": "^0.4.0"
   },
   "files": [
     "dist"