@alfe.ai/integrations 0.0.29 → 0.0.30

package/dist/index.d.ts

@@ -245,6 +245,10 @@ interface ConfigSchemaField {
   select_options?: SelectOption[];
   /** OAuth provider identifier for oauth_connect fields */
   oauth_provider?: string;
+  /** Force specific scope groups for OAuth (e.g. ["chat"]) — hides other scopes in the dashboard */
+  oauth_scopes?: string[];
+  /** Integration ID to patch on OAuth callback (when using a shared OAuth provider) */
+  oauth_integration_id?: 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) */
@@ -748,16 +752,30 @@ declare function runHookWithContext(integrationPath: string, hookScript: string,
 //#endregion
 //#region src/appliers/openclaw-applier.d.ts
 interface OpenClawApplierOptions {
-  /** Path to the OpenClaw workspace directory (e.g. ~/.openclaw) */
-  workspace: string;
+  /**
+   * Path to the OpenClaw home directory (e.g. ~/.openclaw) — where openclaw.json,
+   * plugins/, and extensions/ live.
+   */
+  home?: string;
+  /**
+   * Path to the agent workspace directory (e.g. ~/.openclaw/workspace) — where
+   * the agent's CWD lives, including SOUL.md / AGENTS.md / skills/. Defaults to
+   * `${home}/workspace` (OpenClaw's default for `agents.defaults.workspace`).
+   */
+  agentWorkspace?: string;
+  /**
+   * @deprecated Use `home` instead. Kept for back-compat — when set, used as `home`.
+   */
+  workspace?: string;
   /** Override skills directory (defaults to ~/.alfe/skills/) */
   skillsDir?: string;
-  /** Path to the integration tracking file (defaults to {workspace}/config.json) */
+  /** Path to the integration tracking file (defaults to {home}/config.json) */
   configPath?: string;
 }
 declare class OpenClawApplier implements RuntimeApplier {
   readonly runtime = "openclaw";
-  private workspace;
+  private home;
+  private agentWorkspace;
   private skillsDir;
   private trackingPath;
   constructor(options: OpenClawApplierOptions);
@@ -770,8 +788,12 @@ declare class OpenClawApplier implements RuntimeApplier {
    */
   private ensurePluginsAllow;
   /**
-   * Check if a plugin is already installed in ~/.openclaw/extensions/.
-   * OpenClaw names extension dirs as {pkg-name-with-dashes}-{hash}.
+   * Check if a plugin is already installed.
+   *
+   * OpenClaw 2026.4 stored plugins under `~/.openclaw/extensions/{pkg-name-with-dashes}-{hash}`.
+   * 2026.5+ added an npm registry at `~/.openclaw/npm/node_modules/<pkg>` for npm-source
+   * plugins. We must check both — the extensions-only check missed npm-installed
+   * plugins under 2026.5+, which made force-mode skip its uninstall step.
    */
   private isPluginInstalled;
   removePlugin(pkg: string): Promise<void>;

package/dist/index.js

@@ -1524,13 +1524,17 @@ function flattenConfig(obj, prefix = "") {
 }
 var OpenClawApplier = class {
 	runtime = "openclaw";
-	workspace;
+	home;
+	agentWorkspace;
 	skillsDir;
 	trackingPath;
 	constructor(options) {
-		this.workspace = options.workspace;
+		const home = options.home ?? options.workspace;
+		if (!home) throw new Error("OpenClawApplier requires `home` (or legacy `workspace`) option");
+		this.home = home;
+		this.agentWorkspace = options.agentWorkspace ?? join(home, "workspace");
 		this.skillsDir = options.skillsDir ?? DEFAULT_SKILLS_DIR;
-		this.trackingPath = options.configPath ?? join(this.workspace, "config.json");
+		this.trackingPath = options.configPath ?? join(this.home, "config.json");
 	}
 	async applyPlugin(pkg, _installPath, opts) {
 		await this.ensurePluginsAllow(pkg);
@@ -1546,25 +1550,22 @@ var OpenClawApplier = class {
 			}
 		}
 		if (!this.isPluginInstalled(pkg)) {
+			const baseArgs = [
+				"plugins",
+				"install",
+				pkg,
+				"--force"
+			];
+			const useUnsafeFlag = pkg.startsWith("@alfe.ai/");
+			const args = useUnsafeFlag ? [...baseArgs, "--dangerously-force-unsafe-install"] : baseArgs;
 			try {
-				const args = [
-					"plugins",
-					"install",
-					pkg
-				];
-				const useUnsafeFlag = pkg.startsWith("@alfe.ai/");
-				if (useUnsafeFlag) args.push("--dangerously-force-unsafe-install");
 				try {
 					await execFileAsync("openclaw", args, { timeout: 6e4 });
 				} catch (err) {
 					const errText = err instanceof Error ? `${err.message}\n${err.stderr ?? ""}` : String(err);
 					if (useUnsafeFlag && errText.includes("unknown option")) {
 						log.info({ pkg }, "OpenClaw does not support --dangerously-force-unsafe-install, retrying without");
-						await execFileAsync("openclaw", [
-							"plugins",
-							"install",
-							pkg
-						], { timeout: 6e4 });
+						await execFileAsync("openclaw", baseArgs, { timeout: 6e4 });
 					} else throw err;
 				}
 			} catch (err) {
@@ -1614,10 +1615,15 @@ var OpenClawApplier = class {
 		}
 	}
 	/**
-	* Check if a plugin is already installed in ~/.openclaw/extensions/.
-	* OpenClaw names extension dirs as {pkg-name-with-dashes}-{hash}.
+	* Check if a plugin is already installed.
+	*
+	* OpenClaw 2026.4 stored plugins under `~/.openclaw/extensions/{pkg-name-with-dashes}-{hash}`.
+	* 2026.5+ added an npm registry at `~/.openclaw/npm/node_modules/<pkg>` for npm-source
+	* plugins. We must check both — the extensions-only check missed npm-installed
+	* plugins under 2026.5+, which made force-mode skip its uninstall step.
 	*/
 	isPluginInstalled(pkg) {
+		if (existsSync(join(homedir(), ".openclaw", "npm", "node_modules", ...pkg.split("/")))) return true;
 		const extensionsDir = join(homedir(), ".openclaw", "extensions");
 		if (!existsSync(extensionsDir)) return false;
 		const prefix = pkg.replaceAll("/", "-") + "-";
@@ -1659,7 +1665,7 @@ var OpenClawApplier = class {
 		}
 	}
 	removeClawHubSkill(slug) {
-		const workspaceSkillsDir = join(this.workspace, "skills", slug);
+		const workspaceSkillsDir = join(this.agentWorkspace, "skills", slug);
 		if (existsSync(workspaceSkillsDir)) {
 			rmSync(workspaceSkillsDir, {
 				recursive: true,
@@ -1812,7 +1818,7 @@ var OpenClawApplier = class {
 		this.writeTracking(tracking);
 	}
 	isAvailable() {
-		return Promise.resolve(existsSync(this.workspace));
+		return Promise.resolve(existsSync(this.home));
 	}
 	readTracking() {
 		if (!existsSync(this.trackingPath)) return {};

package/package.json

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