@alfe.ai/integrations 0.0.15 → 0.0.17

package/dist/index.d.ts

@@ -261,7 +261,9 @@ interface CommandDeclaration {
 }
 interface SkillInstall {
   /** Relative path within the integration repo to the skill directory */
-  path: string;
+  path?: string;
+  /** ClawHub skill slug to install from the registry */
+  clawhub?: string;
 }
 interface PluginInstall {
   /** npm package name to install */
@@ -332,6 +334,12 @@ interface IntegrationManifest {
    * Example: ['openclaw'] means this integration only works with OpenClaw.
    */
   supported_agents?: AgentRuntime[];
+  /**
+   * Scopes where this integration can be installed.
+   * Default: ['agent'] (per-agent only).
+   * 'org' means it can be installed at the org level and cascades to all agents.
+   */
+  supported_scopes?: ('agent' | 'org')[];
   /** Marketplace metadata */
   publisherId?: string;
   icon?: string;
@@ -367,6 +375,8 @@ interface RuntimeApplier {
   removePlugin(pkg: string): Promise<void>;
   /** Copy a skill directory into this runtime's skills location */
   applySkill(name: string, srcPath: string): Promise<void>;
+  /** Install a skill from ClawHub registry */
+  applyClawHubSkill(slug: string): Promise<void>;
   /** Remove a skill directory from this runtime */
   removeSkill(name: string): Promise<void>;
   /** Deep-merge config into the runtime's agent configuration */
@@ -502,6 +512,16 @@ declare class IntegrationManager {
    * 5. Remove from state file
    */
   uninstall(params: IntegrationRemoveParams): Promise<ManagerResponse>;
+  /**
+   * Reinstall an integration — full teardown then fresh install + activate.
+   *
+   * 1. Uninstall (deactivates plugins/skills/config, runs hooks, removes git clone + state)
+   * 2. Fresh install (git clone, hooks, state)
+   * 3. Activate (apply plugins/skills/config to runtime)
+   *
+   * If not currently installed, does a normal install + activate.
+   */
+  reinstall(params: IntegrationInstallParams): Promise<ManagerResponse>;
   /**
    * Run health checks for one or all integrations.
    */
@@ -691,6 +711,7 @@ declare class OpenClawApplier implements RuntimeApplier {
   private isPluginInstalled;
   removePlugin(pkg: string): Promise<void>;
   applySkill(name: string, srcPath: string): Promise<void>;
+  applyClawHubSkill(slug: string): Promise<void>;
   removeSkill(name: string): Promise<void>;
   /**
    * Apply integration config to the OpenClaw runtime via `openclaw config set`.
@@ -772,6 +793,7 @@ interface IIntegrationManager {
     id: string;
     version: string;
     status: string;
+    installedAt?: string;
   }[]>;
   /** Install an integration at a specific version with config */
   install(integrationId: string, version: string, config: unknown): Promise<void>;
@@ -781,6 +803,8 @@ interface IIntegrationManager {
   deactivate(integrationId: string): Promise<void>;
   /** Uninstall an integration */
   uninstall(integrationId: string): Promise<void>;
+  /** Reinstall an integration — full teardown then fresh install + activate */
+  reinstall(integrationId: string, version: string, config: unknown): Promise<void>;
 }
 declare class IntegrationManagerAdapter implements IIntegrationManager {
   private readonly manager;
@@ -789,11 +813,13 @@ declare class IntegrationManagerAdapter implements IIntegrationManager {
     id: string;
     version: string;
     status: string;
+    installedAt?: string;
   }[]>;
   install(integrationId: string, version: string, config: unknown): Promise<void>;
   activate(integrationId: string): Promise<void>;
   deactivate(integrationId: string): Promise<void>;
   uninstall(integrationId: string): Promise<void>;
+  reinstall(integrationId: string, version: string, config: unknown): Promise<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

@@ -549,10 +549,11 @@ var LockManager = class {
 			integrationVersion: version
 		});
 		for (const skill of skills) {
-			const name = skill.path.split("/").pop() ?? skill.path;
+			const name = skill.clawhub ?? skill.path?.split("/").pop() ?? "unknown";
+			const sourcePath = skill.path ? join(installPath, skill.path) : `clawhub:${skill.clawhub ?? ""}`;
 			if (!state.skills.some((s) => s.name === name && s.sourceIntegration === integrationId)) state.skills.push({
 				name,
-				sourcePath: join(installPath, skill.path),
+				sourcePath,
 				sourceIntegration: integrationId,
 				integrationVersion: version
 			});
@@ -1009,7 +1010,10 @@ var IntegrationManager = class {
 					this.log.info(`Applying plugin ${plugin.package} to ${runtimeName}`);
 					await applier.applyPlugin(plugin.package, installPath);
 				}
-				for (const skill of skills) {
+				for (const skill of skills) if (skill.clawhub) {
+					this.log.info(`Installing ClawHub skill ${skill.clawhub} to ${runtimeName}`);
+					await applier.applyClawHubSkill(skill.clawhub);
+				} else if (skill.path) {
 					const skillName = skill.path.split("/").pop() ?? skill.path;
 					const srcPath = join(installPath, skill.path);
 					this.log.info(`Applying skill ${skillName} to ${runtimeName}`);
@@ -1195,6 +1199,37 @@ var IntegrationManager = class {
 		}
 	}
 	/**
+	* Reinstall an integration — full teardown then fresh install + activate.
+	*
+	* 1. Uninstall (deactivates plugins/skills/config, runs hooks, removes git clone + state)
+	* 2. Fresh install (git clone, hooks, state)
+	* 3. Activate (apply plugins/skills/config to runtime)
+	*
+	* If not currently installed, does a normal install + activate.
+	*/
+	async reinstall(params) {
+		const { name } = params;
+		if (!name) return this.err("INVALID_PARAMS", "Integration name is required");
+		if (!this.state.get(name)) {
+			const installResult = await this.install(params);
+			if (!installResult.ok) return installResult;
+			return this.activate(name);
+		}
+		this.log.info(`Reinstalling integration: ${name}`);
+		try {
+			const uninstallResult = await this.uninstall({ name });
+			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);
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			this.log.error(`Failed to reinstall "${name}": ${message}`);
+			this.state.setStatus(name, "error", message);
+			return this.err("REINSTALL_FAILED", message);
+		}
+	}
+	/**
 	* Run health checks for one or all integrations.
 	*/
 	async health(params) {
@@ -1463,6 +1498,19 @@ var OpenClawApplier = class {
 		cpSync(srcPath, join(this.skillsDir, name), { recursive: true });
 		return Promise.resolve();
 	}
+	async applyClawHubSkill(slug) {
+		log.info({ slug }, "Installing skill from ClawHub");
+		try {
+			await execFileAsync("clawhub", ["install", slug], { timeout: 6e4 });
+			log.info({ slug }, "ClawHub skill installed");
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			log.warn({
+				slug,
+				err: msg
+			}, "ClawHub skill install failed — clawhub CLI may not be available");
+		}
+	}
 	removeSkill(name) {
 		const skillPath = join(this.skillsDir, name);
 		if (existsSync(skillPath)) rmSync(skillPath, {
@@ -1557,7 +1605,8 @@ var IntegrationManagerAdapter = class {
 		return Promise.resolve(integrations.map((i) => ({
 			id: i.id,
 			version: i.version ?? "unknown",
-			status: i.status
+			status: i.status,
+			installedAt: i.installedAt
 		})));
 	}
 	async install(integrationId, version, config) {
@@ -1580,6 +1629,14 @@ var IntegrationManagerAdapter = class {
 		const result = await this.manager.uninstall({ name: integrationId });
 		if (!result.ok) throw new Error(result.error?.message ?? `Failed to uninstall ${integrationId}`);
 	}
+	async reinstall(integrationId, version, config) {
+		const result = await this.manager.reinstall({
+			name: integrationId,
+			version,
+			config
+		});
+		if (!result.ok) throw new Error(result.error?.message ?? `Failed to reinstall ${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.15",
+  "version": "0.0.17",
   "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.6"
+    "@alfe.ai/integration-manifest": "^0.0.7"
   },
   "files": [
     "dist"