@alfe.ai/integrations 0.2.8 → 0.2.10

package/dist/index.d.ts

@@ -610,6 +610,15 @@ declare class IntegrationManager {
   clear(): void;
   private checkHealth;
   private err;
+  /**
+   * True when the manifest's `supported_agents` (if declared) intersects the
+   * registered runtime appliers. Hooks and MCP registration run once per
+   * integration (not per runtime), so they must use this aggregate check —
+   * the per-runtime loop's check only protects plugin/skill/config apply.
+   * The daemon registers exactly the agent's runtime, so checking the
+   * registered appliers' keys is sufficient.
+   */
+  private manifestSupportsRegisteredRuntime;
 }
 //#endregion
 //#region src/state.d.ts
@@ -699,6 +708,13 @@ interface HookEnvOptions {
   config?: Record<string, unknown>;
   /** Secret key-value pairs (in-memory only, injected as env vars) */
   secrets?: Map<string, unknown>;
+  /**
+   * Registered runtime name(s) on this agent (e.g. ["openclaw"]). Injected as
+   * ALFE_AGENT_RUNTIME so hooks can branch on runtime instead of sniffing for
+   * runtime binaries. The daemon registers exactly one runtime today; the
+   * value is comma-joined if that ever changes.
+   */
+  runtimes?: string[];
 }
 /**
  * Build the environment variables for a hook script execution.
@@ -706,6 +722,7 @@ interface HookEnvOptions {
  * Injects:
  * - ALFE_INTEGRATION_DIR=~/.alfe/integrations/{name}/
  * - ALFE_STATE_DIR=~/.alfe/state/{name}/ (creates dir if needed)
+ * - ALFE_AGENT_RUNTIME=openclaw (comma-joined registered runtime names)
  * - ALFE_<NAME_UPPER>_<KEY_UPPER>=value for each config entry
  * - ALFE_<NAME_UPPER>_<KEY_UPPER>=value for each secret entry
  */

package/dist/index.js

@@ -671,11 +671,12 @@ const STATE_BASE_DIR = join(homedir(), ".alfe", "state");
 * Injects:
 * - ALFE_INTEGRATION_DIR=~/.alfe/integrations/{name}/
 * - ALFE_STATE_DIR=~/.alfe/state/{name}/ (creates dir if needed)
+* - ALFE_AGENT_RUNTIME=openclaw (comma-joined registered runtime names)
 * - ALFE_<NAME_UPPER>_<KEY_UPPER>=value for each config entry
 * - ALFE_<NAME_UPPER>_<KEY_UPPER>=value for each secret entry
 */
 function buildHookEnv(options, additionalEnv) {
-	const { integrationName, config, secrets } = options;
+	const { integrationName, config, secrets, runtimes } = options;
 	const nameUpper = integrationName.toUpperCase().replace(/[^A-Z0-9]/g, "_");
 	const integrationDir = join(INTEGRATIONS_BASE_DIR, integrationName);
 	const stateDir = join(STATE_BASE_DIR, integrationName);
@@ -688,6 +689,7 @@ function buildHookEnv(options, additionalEnv) {
 		ALFE_INTEGRATION_DIR: integrationDir,
 		ALFE_STATE_DIR: stateDir
 	};
+	if (runtimes && runtimes.length > 0) env.ALFE_AGENT_RUNTIME = runtimes.join(",");
 	if (config) {
 		for (const [key, value] of Object.entries(config)) if (value !== void 0 && value !== null) {
 			const envKey = `ALFE_${nameUpper}_${key.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`;
@@ -1037,17 +1039,20 @@ var IntegrationManager = class {
 				const depState = this.state.get(dep);
 				if (!depState || depState.status === "error") throw new Error(`Dependency "${dep}" is not installed. Install it first: alfe integration install ${dep}`);
 			}
-			if (manifest.hooks.pre_install) {
+			const installHooksSupported = this.manifestSupportsRegisteredRuntime(manifest);
+			if (!installHooksSupported && (manifest.hooks.pre_install || manifest.hooks.post_install)) this.log.warn(`Integration "${name}" install hooks skipped — no registered runtime (${[...this.runtimeAppliers.keys()].join(", ")}) is in supported_agents (${(manifest.supported_agents ?? []).join(", ")})`);
+			if (installHooksSupported && manifest.hooks.pre_install) {
 				this.log.info(`Running pre_install hook: ${manifest.hooks.pre_install}`);
 				const hookResult = await runHook(installPath, manifest.hooks.pre_install);
 				if (hookResult.exitCode !== 0) throw new Error(`pre_install hook failed (exit ${String(hookResult.exitCode)}): ${hookResult.stderr || hookResult.stdout}`);
 			}
-			if (manifest.hooks.post_install) {
+			if (installHooksSupported && manifest.hooks.post_install) {
 				this.log.info(`Running post_install hook: ${manifest.hooks.post_install}`);
 				const hookResult = await runHookWithContext(installPath, manifest.hooks.post_install, {
 					integrationName: name,
 					config: config ?? {},
-					secrets: this.secrets.get(name)
+					secrets: this.secrets.get(name),
+					runtimes: [...this.runtimeAppliers.keys()]
 				});
 				if (hookResult.exitCode !== 0) throw new Error(`post_install hook failed (exit ${String(hookResult.exitCode)}): ${hookResult.stderr || hookResult.stdout}`);
 			}
@@ -1213,8 +1218,8 @@ var IntegrationManager = class {
 				if (appliedPlugins.length > 0 || skills.length > 0 || runtimeConfigApplied) this.lockManager.addEntries(runtimeName, integrationId, manifest.version, appliedPlugins, skills, installPath, { configApplied: runtimeConfigApplied });
 			}
 			const mcpServers = manifest.mcp_servers ?? [];
-			const runtimeSupportsMcp = !supportedAgents || supportedAgents.length === 0 || [...this.runtimeAppliers.keys()].some((r) => supportedAgents.includes(r));
-			if (mcpServers.length > 0 && !runtimeSupportsMcp) this.log.warn(`Integration "${integrationId}" declares ${String(mcpServers.length)} mcp_server(s) but no registered runtime (${[...this.runtimeAppliers.keys()].join(", ")}) is in supported_agents (${supportedAgents.join(", ")}) — skipping MCP registration`);
+			const runtimeSupported = this.manifestSupportsRegisteredRuntime(manifest);
+			if (mcpServers.length > 0 && !runtimeSupported) this.log.warn(`Integration "${integrationId}" declares ${String(mcpServers.length)} mcp_server(s) but no registered runtime (${[...this.runtimeAppliers.keys()].join(", ")}) is in supported_agents (${(supportedAgents ?? []).join(", ")}) — skipping MCP registration`);
 			else if (mcpServers.length > 0) if (!this.mcpApplier) this.log.warn(`Integration "${integrationId}" declares ${String(mcpServers.length)} mcp_server(s) but no mcpApplier is wired — skipping MCP registration`);
 			else {
 				const secretEntries = this.secrets.get(integrationId);
@@ -1226,24 +1231,28 @@ var IntegrationManager = class {
 				await this.mcpApplier.applyForIntegration(integrationId, mcpServers, mergedConfig, { connectionId: entry.customConnectionId });
 			}
 			this.state.setStatus(integrationId, "active");
-			if (manifest.hooks.post_activate) {
+			if (manifest.hooks.post_activate && !runtimeSupported) this.log.warn(`Integration "${integrationId}" post_activate hook skipped — no registered runtime (${[...this.runtimeAppliers.keys()].join(", ")}) is in supported_agents (${(supportedAgents ?? []).join(", ")})`);
+			else if (manifest.hooks.post_activate) {
 				this.log.info(`Running post_activate hook: ${manifest.hooks.post_activate}`);
 				const hookResult = await runHookWithContext(installPath, manifest.hooks.post_activate, {
 					integrationName: integrationId,
 					config: entry.config,
-					secrets: this.secrets.get(integrationId)
+					secrets: this.secrets.get(integrationId),
+					runtimes: [...this.runtimeAppliers.keys()]
 				});
 				if (hookResult.exitCode !== 0) {
 					this.state.setStatus(integrationId, "error", `post_activate hook failed: ${hookResult.stderr || hookResult.stdout}`);
 					return this.err("POST_ACTIVATE_FAILED", `post_activate hook failed (exit ${String(hookResult.exitCode)}): ${hookResult.stderr || hookResult.stdout}`);
 				}
 			}
-			if (manifest.hooks.health_check) {
+			if (manifest.hooks.health_check && !runtimeSupported) this.log.warn(`Integration "${integrationId}" health_check hook skipped — no registered runtime (${[...this.runtimeAppliers.keys()].join(", ")}) is in supported_agents (${(supportedAgents ?? []).join(", ")})`);
+			else if (manifest.hooks.health_check) {
 				this.log.info(`Running health check: ${manifest.hooks.health_check}`);
 				const hookResult = await runHookWithContext(installPath, manifest.hooks.health_check, {
 					integrationName: integrationId,
 					config: entry.config,
-					secrets: this.secrets.get(integrationId)
+					secrets: this.secrets.get(integrationId),
+					runtimes: [...this.runtimeAppliers.keys()]
 				});
 				if (hookResult.exitCode !== 0) {
 					this.state.setStatus(integrationId, "error", `Health check failed: ${hookResult.stderr || hookResult.stdout}`);
@@ -1386,21 +1395,25 @@ var IntegrationManager = class {
 			} catch {
 				this.log.warn(`Could not parse manifest for "${name}" — proceeding with basic cleanup`);
 			}
-			if (manifest?.hooks.pre_uninstall) {
+			const uninstallHooksSupported = manifest ? this.manifestSupportsRegisteredRuntime(manifest) : true;
+			if (manifest && !uninstallHooksSupported && (manifest.hooks.pre_uninstall || manifest.hooks.post_uninstall)) this.log.warn(`Integration "${name}" uninstall hooks skipped — no registered runtime (${[...this.runtimeAppliers.keys()].join(", ")}) is in supported_agents (${(manifest.supported_agents ?? []).join(", ")})`);
+			if (uninstallHooksSupported && manifest?.hooks.pre_uninstall) {
 				this.log.info(`Running pre_uninstall hook: ${manifest.hooks.pre_uninstall}`);
 				const hookResult = await runHookWithContext(installPath, manifest.hooks.pre_uninstall, {
 					integrationName: name,
 					config: entry.config,
-					secrets: this.secrets.get(name)
+					secrets: this.secrets.get(name),
+					runtimes: [...this.runtimeAppliers.keys()]
 				});
 				if (hookResult.exitCode !== 0) this.log.warn(`pre_uninstall hook failed (continuing): ${hookResult.stderr}`);
 			}
-			if (manifest?.hooks.post_uninstall) {
+			if (uninstallHooksSupported && manifest?.hooks.post_uninstall) {
 				this.log.info(`Running post_uninstall hook: ${manifest.hooks.post_uninstall}`);
 				const hookResult = await runHookWithContext(installPath, manifest.hooks.post_uninstall, {
 					integrationName: name,
 					config: entry.config,
-					secrets: this.secrets.get(name)
+					secrets: this.secrets.get(name),
+					runtimes: [...this.runtimeAppliers.keys()]
 				});
 				if (hookResult.exitCode !== 0) this.log.warn(`post_uninstall hook failed (non-fatal): ${hookResult.stderr}`);
 			}
@@ -1597,10 +1610,19 @@ var IntegrationManager = class {
 				version: manifest.version,
 				message: "No health check hook defined"
 			};
+			if (!this.manifestSupportsRegisteredRuntime(manifest)) return {
+				id,
+				name: manifest.name,
+				healthy: entry.status === "active" || entry.status === "configured" || entry.status === "installed",
+				status: entry.status,
+				version: manifest.version,
+				message: "Health check hook skipped — integration does not support this agent runtime"
+			};
 			const hookResult = await runHookWithContext(installPath, manifest.hooks.health_check, {
 				integrationName: id,
 				config: entry.config,
-				secrets: this.secrets.get(id)
+				secrets: this.secrets.get(id),
+				runtimes: [...this.runtimeAppliers.keys()]
 			});
 			return {
 				id,
@@ -1631,6 +1653,18 @@ var IntegrationManager = class {
 			}
 		};
 	}
+	/**
+	* True when the manifest's `supported_agents` (if declared) intersects the
+	* registered runtime appliers. Hooks and MCP registration run once per
+	* integration (not per runtime), so they must use this aggregate check —
+	* the per-runtime loop's check only protects plugin/skill/config apply.
+	* The daemon registers exactly the agent's runtime, so checking the
+	* registered appliers' keys is sufficient.
+	*/
+	manifestSupportsRegisteredRuntime(manifest) {
+		const supported = manifest.supported_agents;
+		return !supported || supported.length === 0 || [...this.runtimeAppliers.keys()].some((r) => supported.includes(r));
+	}
 };
 //#endregion
 //#region src/openclaw-cli-lock.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,7 @@
     "@auriclabs/logger": "^0.1.1",
     "yaml": ">=2.8.3",
     "@alfe.ai/integration-manifest": "^0.3.1",
-    "@alfe.ai/mcp-bundler": "^0.2.2"
+    "@alfe.ai/mcp-bundler": "^0.3.0"
   },
   "files": [
     "dist"