@alfe.ai/integrations 0.0.29 → 0.0.31

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

@@ -1509,28 +1509,77 @@ var IntegrationManager = class {
 const execFileAsync = promisify(execFile);
 const log = createLogger("OpenClawApplier");
 const DEFAULT_SKILLS_DIR = join(homedir(), ".alfe", "skills");
-/**
-* Flatten a nested config object into dot-path key-value pairs.
-* e.g. { gateway: { bind: "lan" } } → [["gateway.bind", "lan"]]
-*/
 function flattenConfig(obj, prefix = "") {
-	const pairs = [];
+	const entries = [];
 	for (const [key, val] of Object.entries(obj)) {
+		if (key.includes(".")) {
+			entries.push({
+				kind: "subtree",
+				parentPath: prefix,
+				dottedKey: key,
+				value: val
+			});
+			continue;
+		}
 		const path = prefix ? `${prefix}.${key}` : key;
-		if (val !== null && typeof val === "object" && !Array.isArray(val)) pairs.push(...flattenConfig(val, path));
-		else pairs.push([path, val]);
+		if (val !== null && typeof val === "object" && !Array.isArray(val)) entries.push(...flattenConfig(val, path));
+		else entries.push({
+			kind: "leaf",
+			path,
+			value: val
+		});
+	}
+	return entries;
+}
+function partitionEntries(entries) {
+	const leaves = [];
+	const subtreesByParent = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		if (entry.kind === "leaf") {
+			leaves.push({
+				path: entry.path,
+				value: entry.value
+			});
+			continue;
+		}
+		if (!entry.parentPath) throw new Error(`OpenClawApplier: top-level config keys containing dots are not supported (key: "${entry.dottedKey}")`);
+		let bucket = subtreesByParent.get(entry.parentPath);
+		if (!bucket) {
+			bucket = /* @__PURE__ */ new Map();
+			subtreesByParent.set(entry.parentPath, bucket);
+		}
+		bucket.set(entry.dottedKey, entry.value);
 	}
-	return pairs;
+	return {
+		leaves,
+		subtreesByParent
+	};
+}
+async function readParentObject(parentPath) {
+	try {
+		const { stdout } = await execFileAsync("openclaw", [
+			"config",
+			"get",
+			parentPath
+		], { timeout: 1e4 });
+		const parsed = JSON.parse(stdout.trim());
+		if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
+	} catch {}
+	return {};
 }
 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 +1595,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,11 +1660,16 @@ 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) {
-		const extensionsDir = join(homedir(), ".openclaw", "extensions");
+		if (existsSync(join(this.home, "npm", "node_modules", ...pkg.split("/")))) return true;
+		const extensionsDir = join(this.home, "extensions");
 		if (!existsSync(extensionsDir)) return false;
 		const prefix = pkg.replaceAll("/", "-") + "-";
 		return readdirSync(extensionsDir).some((dir) => dir.startsWith(prefix) && /^[0-9a-f]+$/i.test(dir.slice(prefix.length)));
@@ -1659,7 +1710,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,
@@ -1689,21 +1740,36 @@ var OpenClawApplier = class {
 		integrations[integrationId] = config;
 		tracking._integrations = integrations;
 		this.writeTracking(tracking);
-		const batch = flattenConfig(config).map(([path, value]) => ({
-			path,
-			value
-		}));
-		try {
+		const { leaves, subtreesByParent } = partitionEntries(flattenConfig(config));
+		for (const [parentPath, dottedKvs] of subtreesByParent) {
+			const merged = { ...await readParentObject(parentPath) };
+			for (const [k, v] of dottedKvs) merged[k] = v;
+			try {
+				await execFileAsync("openclaw", [
+					"config",
+					"set",
+					parentPath,
+					JSON.stringify(merged)
+				], { timeout: 1e4 });
+			} catch (err) {
+				log.error({
+					err: err instanceof Error ? err.message : String(err),
+					parentPath
+				}, "Failed to set config subtree via openclaw config set");
+				throw err;
+			}
+		}
+		if (leaves.length > 0) try {
 			await execFileAsync("openclaw", [
 				"config",
 				"set",
 				"--batch-json",
-				JSON.stringify(batch)
+				JSON.stringify(leaves)
 			], { timeout: 1e4 });
 		} catch (err) {
 			log.error({
 				err: err instanceof Error ? err.message : String(err),
-				batch
+				batch: leaves
 			}, "Failed to set config via openclaw config set --batch-json");
 			throw err;
 		}
@@ -1719,8 +1785,8 @@ var OpenClawApplier = class {
 		const integrations = tracking._integrations ?? {};
 		if (!(integrationId in integrations)) return;
 		const integrationConfig = integrations[integrationId];
-		const pairs = flattenConfig(integrationConfig);
-		for (const [path] of pairs) try {
+		const { leaves, subtreesByParent } = partitionEntries(flattenConfig(integrationConfig));
+		for (const { path } of leaves) try {
 			await execFileAsync("openclaw", [
 				"config",
 				"unset",
@@ -1732,6 +1798,29 @@ var OpenClawApplier = class {
 				path
 			}, "Failed to unset config via openclaw config unset");
 		}
+		for (const [parentPath, dottedKvs] of subtreesByParent) {
+			const existing = await readParentObject(parentPath);
+			const remaining = Object.fromEntries(Object.entries(existing).filter(([k]) => !dottedKvs.has(k)));
+			if (Object.keys(existing).length === 0) continue;
+			try {
+				if (Object.keys(remaining).length === 0) await execFileAsync("openclaw", [
+					"config",
+					"unset",
+					parentPath
+				], { timeout: 1e4 });
+				else await execFileAsync("openclaw", [
+					"config",
+					"set",
+					parentPath,
+					JSON.stringify(remaining)
+				], { timeout: 1e4 });
+			} catch (err) {
+				log.warn({
+					err: err instanceof Error ? err.message : String(err),
+					parentPath
+				}, "Failed to update parent config during remove");
+			}
+		}
 		tracking._integrations = Object.fromEntries(Object.entries(integrations).filter(([key]) => key !== integrationId));
 		this.writeTracking(tracking);
 	}
@@ -1812,7 +1901,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.31",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",