@alfe.ai/integrations 0.0.30 → 0.0.32

package/dist/index.d.ts

@@ -796,6 +796,16 @@ declare class OpenClawApplier implements RuntimeApplier {
    * plugins under 2026.5+, which made force-mode skip its uninstall step.
    */
   private isPluginInstalled;
+  /**
+   * Remove an extensions/ install that has no matching record in
+   * plugins/installs.json. OpenClaw 2026.5+ tracks installs via the records
+   * file — a leftover dir from 2026.4 is invisible to `openclaw plugins
+   * uninstall` (it errors with "not managed by plugins config/install
+   * records") and its pre-migration manifest blocks the new effective-plugin-
+   * set loader from importing it. Resetting the dir makes the next install
+   * write through the npm path with a proper tracking record.
+   */
+  private cleanupUntrackedExtensionInstall;
   removePlugin(pkg: string): Promise<void>;
   applySkill(name: string, srcPath: string): Promise<void>;
   applyClawHubSkill(slug: string): Promise<void>;

package/dist/index.js

@@ -1509,18 +1509,63 @@ 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 pairs;
+	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 {
+		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";
@@ -1538,6 +1583,7 @@ var OpenClawApplier = class {
 	}
 	async applyPlugin(pkg, _installPath, opts) {
 		await this.ensurePluginsAllow(pkg);
+		this.cleanupUntrackedExtensionInstall(pkg);
 		if (opts?.force && this.isPluginInstalled(pkg)) {
 			log.info({ pkg }, "Force mode — uninstalling plugin before reinstall");
 			try {
@@ -1623,12 +1669,57 @@ var OpenClawApplier = class {
 	* 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(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)));
 	}
+	/**
+	* Remove an extensions/ install that has no matching record in
+	* plugins/installs.json. OpenClaw 2026.5+ tracks installs via the records
+	* file — a leftover dir from 2026.4 is invisible to `openclaw plugins
+	* uninstall` (it errors with "not managed by plugins config/install
+	* records") and its pre-migration manifest blocks the new effective-plugin-
+	* set loader from importing it. Resetting the dir makes the next install
+	* write through the npm path with a proper tracking record.
+	*/
+	cleanupUntrackedExtensionInstall(pkg) {
+		const installsPath = join(this.home, "plugins", "installs.json");
+		if (!existsSync(installsPath)) return;
+		let tracked = false;
+		try {
+			const raw = readFileSync(installsPath, "utf8");
+			const data = JSON.parse(raw);
+			tracked = Object.prototype.hasOwnProperty.call(data.installRecords ?? {}, pkg);
+		} catch {
+			return;
+		}
+		if (tracked) return;
+		const extensionsDir = join(this.home, "extensions");
+		if (!existsSync(extensionsDir)) return;
+		const prefix = pkg.replaceAll("/", "-") + "-";
+		const stale = readdirSync(extensionsDir).filter((dir) => dir.startsWith(prefix) && /^[0-9a-f]+$/i.test(dir.slice(prefix.length)));
+		for (const dir of stale) {
+			const fullPath = join(extensionsDir, dir);
+			try {
+				rmSync(fullPath, {
+					recursive: true,
+					force: true
+				});
+				log.info({
+					pkg,
+					removed: fullPath
+				}, "Removed untracked extensions/ install — will reinstall via npm path");
+			} catch (err) {
+				log.warn({
+					pkg,
+					removed: fullPath,
+					err: err instanceof Error ? err.message : String(err)
+				}, "Failed to remove untracked extensions/ install");
+			}
+		}
+	}
 	async removePlugin(pkg) {
 		await execFileAsync("openclaw", [
 			"plugins",
@@ -1695,21 +1786,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;
 		}
@@ -1725,8 +1831,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",
@@ -1738,6 +1844,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);
 	}

package/package.json

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