@alfe.ai/integrations 0.0.14 → 0.0.16

package/dist/index.d.ts

@@ -247,6 +247,18 @@ interface ConfigSchemaField {
   /** Only show this field if a specific integration is installed */
   depends_on_integration?: string;
 }
+interface CommandDeclaration {
+  /** Dot-namespaced command name (e.g. "support.diagnostic") */
+  name: string;
+  /** Relative path to handler file within integration directory */
+  handler: string;
+  /** Exported function name (default: "handle") */
+  method?: string;
+  /** Timeout in milliseconds (default: 30000) */
+  timeout_ms?: number;
+  /** Human-readable description */
+  description?: string;
+}
 interface SkillInstall {
   /** Relative path within the integration repo to the skill directory */
   path: string;
@@ -311,6 +323,7 @@ interface IntegrationManifest {
   config_schema: ConfigSchemaField[];
   capabilities: string[];
   hooks: IntegrationHooks;
+  commands: CommandDeclaration[];
   /** Git repository URL (HTTPS) — not present in YAML, injected by the publish API */
   repository?: string;
   /**
@@ -489,6 +502,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.
    */
@@ -501,6 +524,21 @@ declare class IntegrationManager {
    * Get a specific integration by name.
    */
   get(name: string): IntegrationInfo | undefined;
+  /**
+   * Get command declarations from all active integrations with resolved absolute paths.
+   * Used by the daemon to rebuild the command registry after reconciliation.
+   */
+  getActiveCommands(): {
+    integrationId: string;
+    commands: {
+      name: string;
+      handler: string;
+      resolvedPath: string;
+      method: string;
+      timeoutMs: number;
+      description?: string;
+    }[];
+  }[];
   /**
    * Clear in-memory secrets (called on daemon restart).
    */
@@ -744,6 +782,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>;
@@ -753,6 +792,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;
@@ -761,11 +802,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

@@ -137,7 +137,8 @@ const NPM_TIMEOUT_MS = 6e4;
 /** Shared @alfe.ai packages available to all integration hooks */
 const SHARED_PACKAGES = {
 	"@alfe.ai/config": "latest",
-	"@alfe.ai/agent-api-client": "latest"
+	"@alfe.ai/agent-api-client": "latest",
+	"@alfe.ai/doctor": "latest"
 };
 var InstallerError = class extends Error {
 	constructor(message) {
@@ -1194,6 +1195,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) {
@@ -1247,6 +1279,37 @@ var IntegrationManager = class {
 		};
 	}
 	/**
+	* Get command declarations from all active integrations with resolved absolute paths.
+	* Used by the daemon to rebuild the command registry after reconciliation.
+	*/
+	getActiveCommands() {
+		const result = [];
+		for (const entry of this.state.list()) {
+			if (entry.status !== "active") continue;
+			const installPath = this.installer.getInstallPath(entry.id);
+			const manifestPath = join(installPath, "alfe-integration.yaml");
+			if (!existsSync(manifestPath)) continue;
+			try {
+				const manifest = parseManifestFile(manifestPath);
+				if (manifest.commands.length === 0) continue;
+				result.push({
+					integrationId: entry.id,
+					commands: manifest.commands.map((cmd) => ({
+						name: cmd.name,
+						handler: cmd.handler,
+						resolvedPath: join(installPath, cmd.handler),
+						method: cmd.method ?? "handle",
+						timeoutMs: cmd.timeout_ms ?? 3e4,
+						description: cmd.description
+					}))
+				});
+			} catch (err) {
+				this.log.warn(`Failed to read commands for "${entry.id}": ${err instanceof Error ? err.message : String(err)}`);
+			}
+		}
+		return result;
+	}
+	/**
 	* Clear in-memory secrets (called on daemon restart).
 	*/
 	clear() {
@@ -1525,7 +1588,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) {
@@ -1548,6 +1612,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.14",
+  "version": "0.0.16",
   "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.5"
+    "@alfe.ai/integration-manifest": "^0.0.6"
   },
   "files": [
     "dist"