@alfe.ai/integrations 0.0.25 → 0.0.27

package/dist/index.d.ts

@@ -193,6 +193,11 @@ declare class Installer {
    * Node module resolution from hook scripts (e.g.
    * ~/.alfe/integrations/console/hooks/post_install.js) walks up to
    * ~/.alfe/integrations/node_modules/ and finds these packages.
+   *
+   * Uses `"latest"` versions — npm install is always run when node_modules
+   * exists to pick up newer published versions (e.g. new API client methods).
+   * The in-memory `sharedPackagesReady` flag prevents redundant installs
+   * within a single daemon process lifetime.
    */
   private ensureSharedPackages;
   /**
@@ -389,7 +394,9 @@ interface RuntimeApplier {
   /** The runtime identifier (e.g. 'openclaw', 'nanoclaw') */
   readonly runtime: string;
   /** Install a plugin package into this runtime */
-  applyPlugin(pkg: string, integrationInstallPath: string): Promise<void>;
+  applyPlugin(pkg: string, integrationInstallPath: string, opts?: {
+    force?: boolean;
+  }): Promise<void>;
   /** Remove a plugin package from this runtime */
   removePlugin(pkg: string): Promise<void>;
   /** Copy a skill directory into this runtime's skills location */
@@ -517,7 +524,9 @@ declare class IntegrationManager {
    * 4. Run health_check hook if present
    * 5. Mark as active in state
    */
-  activate(integrationId: string): Promise<ManagerResponse>;
+  activate(integrationId: string, opts?: {
+    forcePlugins?: boolean;
+  }): Promise<ManagerResponse>;
   /**
    * Deactivate a running integration.
    *
@@ -728,7 +737,9 @@ declare class OpenClawApplier implements RuntimeApplier {
   private skillsDir;
   private trackingPath;
   constructor(options: OpenClawApplierOptions);
-  applyPlugin(pkg: string): Promise<void>;
+  applyPlugin(pkg: string, _installPath?: string, opts?: {
+    force?: boolean;
+  }): Promise<void>;
   /**
    * Ensure the plugin is in plugins.allow in openclaw.json.
    * Uses `openclaw config set` to avoid clobbering OpenClaw's own file format.

package/dist/index.js

@@ -1,7 +1,7 @@
 import { execFile, spawn } from "node:child_process";
 import { promisify } from "node:util";
 import { dirname, join } from "node:path";
-import { homedir, tmpdir } from "node:os";
+import { homedir, platform, tmpdir } from "node:os";
 import { closeSync, cpSync, existsSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { buildConfigValidationSchema, parseManifestFile } from "@alfe.ai/integration-manifest";
 import { createLogger } from "@auriclabs/logger";
@@ -276,24 +276,15 @@ var Installer = class {
 	* Node module resolution from hook scripts (e.g.
 	* ~/.alfe/integrations/console/hooks/post_install.js) walks up to
 	* ~/.alfe/integrations/node_modules/ and finds these packages.
+	*
+	* Uses `"latest"` versions — npm install is always run when node_modules
+	* exists to pick up newer published versions (e.g. new API client methods).
+	* The in-memory `sharedPackagesReady` flag prevents redundant installs
+	* within a single daemon process lifetime.
 	*/
 	async ensureSharedPackages() {
 		if (this.sharedPackagesReady) return;
 		const pkgJsonPath = join(this.basePath, "package.json");
-		const nodeModulesExists = existsSync(join(this.basePath, "node_modules"));
-		let needsInstall = false;
-		if (existsSync(pkgJsonPath)) try {
-			const deps = JSON.parse(readFileSync(pkgJsonPath, "utf-8")).dependencies ?? {};
-			needsInstall = Object.keys(SHARED_PACKAGES).some((pkg) => !(pkg in deps));
-		} catch {
-			needsInstall = true;
-		}
-		else needsInstall = true;
-		if (!needsInstall && !nodeModulesExists) needsInstall = true;
-		if (!needsInstall) {
-			this.sharedPackagesReady = true;
-			return;
-		}
 		const pkgJson = {
 			name: "alfe-integrations-root",
 			private: true,
@@ -663,6 +654,7 @@ function buildHookEnv(options, additionalEnv) {
 * 3. Default → "bash"
 */
 function resolveInterpreter(scriptPath) {
+	const isWindows = platform() === "win32";
 	try {
 		const fd = openSync(scriptPath, "r");
 		const buf = Buffer.alloc(256);
@@ -678,8 +670,13 @@ function resolveInterpreter(scriptPath) {
 					args: [...parts.slice(1), scriptPath]
 				};
 			}
+			const cmd = shebang.split(/\s+/)[0];
+			if (isWindows && cmd.startsWith("/")) return {
+				command: cmd.split("/").pop() ?? cmd,
+				args: [scriptPath]
+			};
 			return {
-				command: shebang.split(/\s+/)[0],
+				command: cmd,
 				args: [scriptPath]
 			};
 		}
@@ -689,7 +686,7 @@ function resolveInterpreter(scriptPath) {
 		args: [scriptPath]
 	};
 	if (scriptPath.endsWith(".py")) return {
-		command: "python3",
+		command: isWindows ? "python" : "python3",
 		args: [scriptPath]
 	};
 	return {
@@ -1010,7 +1007,7 @@ var IntegrationManager = class {
 	* 4. Run health_check hook if present
 	* 5. Mark as active in state
 	*/
-	async activate(integrationId) {
+	async activate(integrationId, opts) {
 		const entry = this.state.get(integrationId);
 		if (!entry) return this.err("NOT_FOUND", `Integration "${integrationId}" is not installed`);
 		if (entry.status === "active") return {
@@ -1046,7 +1043,7 @@ var IntegrationManager = class {
 				const { plugins, skills, config: runtimeConfig } = resolveInstallsForRuntime(manifest, runtimeName);
 				for (const plugin of plugins) {
 					this.log.info(`Applying plugin ${plugin.package} to ${runtimeName}`);
-					await applier.applyPlugin(plugin.package, installPath);
+					await applier.applyPlugin(plugin.package, installPath, { force: opts?.forcePlugins });
 				}
 				for (const skill of skills) if (skill.clawhub) {
 					this.log.info(`Installing ClawHub skill ${skill.clawhub} to ${runtimeName}`);
@@ -1064,7 +1061,7 @@ var IntegrationManager = class {
 					await applier.applyConfig(integrationId, interpolatedConfig);
 					configApplied = true;
 				}
-				const mcpServers = manifest.mcp_servers;
+				const mcpServers = manifest.mcp_servers ?? [];
 				if (mcpServers.length > 0) {
 					const secretEntries = this.secrets.get(integrationId);
 					const interpolatedServers = interpolateMcpServerEnvs(mcpServers, {
@@ -1116,6 +1113,7 @@ var IntegrationManager = class {
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
 			this.log.error(`Failed to activate "${integrationId}": ${message}`);
+			this.state.setStatus(integrationId, "error", message);
 			return this.err("ACTIVATE_FAILED", message);
 		}
 	}
@@ -1284,7 +1282,7 @@ var IntegrationManager = class {
 			if (!uninstallResult.ok) this.log.warn(`Uninstall returned error during reinstall: ${String(uninstallResult.error?.message)} — proceeding with install`);
 			const installResult = await this.install(params);
 			if (!installResult.ok) return installResult;
-			return await this.activate(name);
+			return await this.activate(name, { forcePlugins: true });
 		} catch (err) {
 			const message = err instanceof Error ? err.message : String(err);
 			this.log.error(`Failed to reinstall "${name}": ${message}`);
@@ -1364,11 +1362,11 @@ var IntegrationManager = class {
 			const manifestPath = join(installPath, "alfe-integration.yaml");
 			if (!existsSync(manifestPath)) continue;
 			try {
-				const manifest = parseManifestFile(manifestPath);
-				if (manifest.commands.length === 0) continue;
+				const commands = parseManifestFile(manifestPath).commands ?? [];
+				if (commands.length === 0) continue;
 				result.push({
 					integrationId: entry.id,
-					commands: manifest.commands.map((cmd) => ({
+					commands: commands.map((cmd) => ({
 						name: cmd.name,
 						handler: cmd.handler,
 						resolvedPath: join(installPath, cmd.handler),
@@ -1488,8 +1486,19 @@ var OpenClawApplier = class {
 		this.skillsDir = options.skillsDir ?? DEFAULT_SKILLS_DIR;
 		this.trackingPath = options.configPath ?? join(this.workspace, "config.json");
 	}
-	async applyPlugin(pkg) {
+	async applyPlugin(pkg, _installPath, opts) {
 		await this.ensurePluginsAllow(pkg);
+		if (opts?.force && this.isPluginInstalled(pkg)) {
+			log.info({ pkg }, "Force mode — uninstalling plugin before reinstall");
+			try {
+				await this.removePlugin(pkg);
+			} catch (err) {
+				log.warn({
+					pkg,
+					err: err instanceof Error ? err.message : String(err)
+				}, "Failed to uninstall plugin during force reinstall — proceeding");
+			}
+		}
 		if (!this.isPluginInstalled(pkg)) {
 			try {
 				const args = [
@@ -1549,8 +1558,7 @@ var OpenClawApplier = class {
 				"config",
 				"set",
 				"plugins.allow",
-				JSON.stringify(updated),
-				"--strict-json"
+				JSON.stringify(updated)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.warn({
@@ -1594,6 +1602,10 @@ var OpenClawApplier = class {
 			log.info({ slug }, "ClawHub skill installed");
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
+			if (msg.includes("already exists") || msg.includes("Skill already exists")) {
+				log.info({ slug }, "ClawHub skill already installed (skipped)");
+				return;
+			}
 			log.error({
 				slug,
 				err: msg
@@ -1640,8 +1652,7 @@ var OpenClawApplier = class {
 				"config",
 				"set",
 				"--batch-json",
-				JSON.stringify(batch),
-				"--strict-json"
+				JSON.stringify(batch)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.error({
@@ -1713,8 +1724,7 @@ var OpenClawApplier = class {
 				"config",
 				"set",
 				"--batch-json",
-				JSON.stringify(batch),
-				"--strict-json"
+				JSON.stringify(batch)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.error({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",