@alfe.ai/integrations 0.0.26 → 0.0.28

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;
   /**
@@ -240,6 +245,8 @@ interface ConfigSchemaField {
   select_options?: SelectOption[];
   /** OAuth provider identifier for oauth_connect fields */
   oauth_provider?: string;
+  /** If true, this field is not shown in the dashboard UI (install wizard or configure modal) */
+  hidden?: boolean;
   /** Only show this field if another field has a truthy value (string) or matches a specific value (object) */
   depends_on_field?: string | {
     key: string;
@@ -374,6 +381,8 @@ interface IntegrationStateEntry {
   installedAt: string;
   config: Record<string, unknown>;
   error?: string;
+  /** Number of consecutive auto-reinstall attempts. Reset on success or explicit reinstall. */
+  reinstallAttempts?: number;
 }
 interface IntegrationsStateFile {
   version: number;
@@ -389,7 +398,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 +528,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.
    *
@@ -560,6 +573,18 @@ declare class IntegrationManager {
    * Returns false if the state says installed but files are missing (corrupted install).
    */
   isInstallIntact(integrationId: string): boolean;
+  /**
+   * Get the number of consecutive auto-reinstall attempts for an integration.
+   */
+  getReinstallAttempts(integrationId: string): number;
+  /**
+   * Increment the auto-reinstall attempt counter.
+   */
+  incrementReinstallAttempts(integrationId: string): void;
+  /**
+   * Reset the auto-reinstall attempt counter.
+   */
+  resetReinstallAttempts(integrationId: string): void;
   /**
    * Get a specific integration by name.
    */
@@ -630,6 +655,14 @@ declare class StateManager {
    * Check if an integration is in a given status.
    */
   hasStatus(name: string, ...statuses: IntegrationStatus[]): boolean;
+  /**
+   * Increment the auto-reinstall attempt counter.
+   */
+  incrementReinstallAttempts(name: string): void;
+  /**
+   * Reset the auto-reinstall attempt counter (on success or explicit reinstall).
+   */
+  resetReinstallAttempts(name: string): void;
 }
 //#endregion
 //#region src/hooks.d.ts
@@ -728,7 +761,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.
@@ -856,6 +891,12 @@ interface IIntegrationManager {
   }>;
   /** Check if an integration's install directory and manifest are intact on disk */
   isInstallIntact(integrationId: string): Promise<boolean>;
+  /** Get the number of consecutive auto-reinstall attempts */
+  getReinstallAttempts(integrationId: string): number;
+  /** Increment the auto-reinstall attempt counter */
+  incrementReinstallAttempts(integrationId: string): void;
+  /** Reset the auto-reinstall attempt counter */
+  resetReinstallAttempts(integrationId: string): void;
 }
 declare class IntegrationManagerAdapter implements IIntegrationManager {
   private readonly manager;
@@ -876,6 +917,9 @@ declare class IntegrationManagerAdapter implements IIntegrationManager {
     configApplied: boolean;
   }>;
   isInstallIntact(integrationId: string): Promise<boolean>;
+  getReinstallAttempts(integrationId: string): number;
+  incrementReinstallAttempts(integrationId: string): void;
+  resetReinstallAttempts(integrationId: string): void;
 }
 //#endregion
 export { type HookEnvOptions, type HookResult, type IIntegrationManager, type InstalledInfo, Installer, InstallerError, type IntegrationConfigureParams, type IntegrationHealthParams, type IntegrationInfo, type IntegrationInstallParams, IntegrationManager, IntegrationManagerAdapter, type IntegrationManagerOptions, type IntegrationRemoveParams, LockManager, OpenClawApplier, type OpenClawApplierOptions, Registry, type RegistryEntry, type RegistryFetcher, type RegistryIndex, RegistryResolveError, type ResolvedIntegration, Resolver, type RuntimeApplier, type RuntimeDesiredState, type RuntimeLockFile, type RuntimePluginEntry, type RuntimeSkillEntry, StateManager, buildHookEnv, resolveInstallsForRuntime, runHook, runHookWithContext };

package/dist/index.js

@@ -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,
@@ -479,6 +470,24 @@ var StateManager = class {
 		if (!entry) return false;
 		return statuses.includes(entry.status);
 	}
+	/**
+	* Increment the auto-reinstall attempt counter.
+	*/
+	incrementReinstallAttempts(name) {
+		const state = this.read();
+		if (!(name in state.integrations)) return;
+		state.integrations[name].reinstallAttempts = (state.integrations[name].reinstallAttempts ?? 0) + 1;
+		this.write(state);
+	}
+	/**
+	* Reset the auto-reinstall attempt counter (on success or explicit reinstall).
+	*/
+	resetReinstallAttempts(name) {
+		const state = this.read();
+		if (!(name in state.integrations)) return;
+		state.integrations[name].reinstallAttempts = 0;
+		this.write(state);
+	}
 };
 //#endregion
 //#region src/lock.ts
@@ -1016,7 +1025,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 {
@@ -1050,10 +1059,19 @@ var IntegrationManager = class {
 					continue;
 				}
 				const { plugins, skills, config: runtimeConfig } = resolveInstallsForRuntime(manifest, runtimeName);
+				const pluginFailures = [];
 				for (const plugin of plugins) {
 					this.log.info(`Applying plugin ${plugin.package} to ${runtimeName}`);
-					await applier.applyPlugin(plugin.package, installPath);
+					try {
+						await applier.applyPlugin(plugin.package, installPath, { force: opts?.forcePlugins });
+					} catch (err) {
+						const msg = err instanceof Error ? err.message : String(err);
+						this.log.error(`Failed to apply plugin ${plugin.package}: ${msg}`);
+						pluginFailures.push(plugin.package);
+					}
 				}
+				if (pluginFailures.length > 0 && pluginFailures.length === plugins.length) throw new Error(`All plugins failed to install: ${pluginFailures.join(", ")}`);
+				if (pluginFailures.length > 0) this.log.warn(`Continuing activation with ${String(pluginFailures.length)} failed plugin(s): ${pluginFailures.join(", ")}`);
 				for (const skill of skills) if (skill.clawhub) {
 					this.log.info(`Installing ClawHub skill ${skill.clawhub} to ${runtimeName}`);
 					await applier.applyClawHubSkill(skill.clawhub);
@@ -1083,7 +1101,8 @@ var IntegrationManager = class {
 						configApplied = true;
 					}
 				}
-				if (plugins.length > 0 || skills.length > 0) this.lockManager.addEntries(runtimeName, integrationId, manifest.version, plugins, skills, installPath);
+				const appliedPlugins = plugins.filter((p) => !pluginFailures.includes(p.package));
+				if (appliedPlugins.length > 0 || skills.length > 0) this.lockManager.addEntries(runtimeName, integrationId, manifest.version, appliedPlugins, skills, installPath);
 			}
 			this.state.setStatus(integrationId, "active");
 			if (manifest.hooks.post_activate) {
@@ -1122,6 +1141,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);
 		}
 	}
@@ -1290,7 +1310,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}`);
@@ -1344,6 +1364,24 @@ var IntegrationManager = class {
 		return existsSync(join(this.installer.getInstallPath(integrationId), "alfe-integration.yaml"));
 	}
 	/**
+	* Get the number of consecutive auto-reinstall attempts for an integration.
+	*/
+	getReinstallAttempts(integrationId) {
+		return this.state.get(integrationId)?.reinstallAttempts ?? 0;
+	}
+	/**
+	* Increment the auto-reinstall attempt counter.
+	*/
+	incrementReinstallAttempts(integrationId) {
+		this.state.incrementReinstallAttempts(integrationId);
+	}
+	/**
+	* Reset the auto-reinstall attempt counter.
+	*/
+	resetReinstallAttempts(integrationId) {
+		this.state.resetReinstallAttempts(integrationId);
+	}
+	/**
 	* Get a specific integration by name.
 	*/
 	get(name) {
@@ -1494,8 +1532,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 = [
@@ -1555,8 +1604,7 @@ var OpenClawApplier = class {
 				"config",
 				"set",
 				"plugins.allow",
-				JSON.stringify(updated),
-				"--strict-json"
+				JSON.stringify(updated)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.warn({
@@ -1600,6 +1648,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
@@ -1646,8 +1698,7 @@ var OpenClawApplier = class {
 				"config",
 				"set",
 				"--batch-json",
-				JSON.stringify(batch),
-				"--strict-json"
+				JSON.stringify(batch)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.error({
@@ -1719,8 +1770,7 @@ var OpenClawApplier = class {
 				"config",
 				"set",
 				"--batch-json",
-				JSON.stringify(batch),
-				"--strict-json"
+				JSON.stringify(batch)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.error({
@@ -1825,6 +1875,15 @@ var IntegrationManagerAdapter = class {
 	isInstallIntact(integrationId) {
 		return Promise.resolve(this.manager.isInstallIntact(integrationId));
 	}
+	getReinstallAttempts(integrationId) {
+		return this.manager.getReinstallAttempts(integrationId);
+	}
+	incrementReinstallAttempts(integrationId) {
+		this.manager.incrementReinstallAttempts(integrationId);
+	}
+	resetReinstallAttempts(integrationId) {
+		this.manager.resetReinstallAttempts(integrationId);
+	}
 };
 //#endregion
 export { Installer, InstallerError, IntegrationManager, IntegrationManagerAdapter, LockManager, OpenClawApplier, Registry, RegistryResolveError, Resolver, StateManager, buildHookEnv, resolveInstallsForRuntime, runHook, runHookWithContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@auriclabs/logger": "^0.1.1",
-    "@alfe.ai/integration-manifest": "^0.0.9"
+    "@alfe.ai/integration-manifest": "^0.0.10"
   },
   "files": [
     "dist"