@alfe.ai/mcp-bundler 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -350,36 +350,13 @@ declare function toStoredEntry(config: McpServerConfig, meta: {
 }): StoredServerEntry;
 //#endregion
 //#region src/manager.d.ts
-/**
- * Shells out to `openclaw config set --batch-json` / `openclaw config unset`
- * to keep `openclaw.json#mcp.servers.*` in sync with the bundler store.
- * Default executor reuses the same machinery the integrations applier has
- * used for ~6 months; tests inject a fake.
- */
-interface OpenclawExecutor {
-  setBatch: (batch: {
-    path: string;
-    value: unknown;
-  }[]) => Promise<void>;
-  unset: (path: string) => Promise<void>;
-}
-declare const defaultOpenclawExecutor: OpenclawExecutor;
 interface ManagerOptions {
   /** Pre-constructed store. If omitted, one is built with default options. */
   store?: Store;
-  /** Override for the openclaw mirror executor (tests inject a fake). */
-  executor?: OpenclawExecutor;
   logger?: Logger;
-  /**
-   * Debounce window for the mirror-write. Mutations landing inside this
-   * window coalesce into a single openclaw config update, avoiding the
-   * auto-restart race where two back-to-back `addServer` calls hit an
-   * openclaw that's mid-shutdown from the first write's watcher.
-   */
-  mirrorDebounceMs?: number;
 }
 interface AddServerOptions {
-  /** Required — flat-namespace key under `mcp.servers.*`. */
+  /** Required — flat-namespace key under the bundler store. */
   id: string;
   /** Marks ownership for bulk removal. Defaults to `manual`. */
   owner?: ServerOwner;
@@ -389,21 +366,23 @@ interface AddServerOptions {
   transport?: McpTransportKind;
 }
 /**
- * Bundler manager — owns the alfe store, mirrors it into openclaw.json,
- * and surfaces a small CRUD API the CLI and integration applier both
- * call into.
+ * Bundler manager — owns the `~/.alfe/mcp/servers.json` store and surfaces a
+ * small CRUD API the CLI and integration applier both call into.
+ *
+ * Single source of truth: every consumer (daemon-hosted bundler, CLI `alfe mcp
+ * list`, integration uninstall) reads from this store. Openclaw.json is no
+ * longer kept in sync — the daemon hosts the bundler children and the
+ * openclaw plugin reaches them via IPC, so the openclaw.json mirror became
+ * dead weight and an active source of duplicate spawning on claude-cli /
+ * codex-cli backends.
  *
- * The store is the Alfe-owned source of truth; openclaw.json is a
- * derived mirror so the runtime keeps consuming its existing format.
+ * Call `loadIntoBundler(bundler)` once at daemon startup to wire the store
+ * into a live `McpBundler` — subsequent store mutations (including those
+ * landed by other processes via the file watcher) re-reconcile automatically.
  */
 declare class Manager {
   private readonly store;
-  private readonly executor;
   private readonly logger?;
-  private readonly mirrorDebounceMs;
-  private mirrorTimer?;
-  private mirrorPromise;
-  private mirrorPending?;
   private bundler?;
   private changeListeners;
   private storeUnsubscribe?;
@@ -411,10 +390,10 @@ declare class Manager {
   /** Direct accessor — handy for tests and the CLI's `alfe mcp list`. */
   getStore(): Store;
   /**
-   * Register or overwrite a server entry. Resolves as soon as the store
-   * mutation is committed to disk — the openclaw.json mirror runs async
-   * in the background and is debounced so back-to-back calls coalesce
-   * into one runtime restart. Call `flush()` to await the mirror.
+   * Register or overwrite a server entry. Mutation lands in the store
+   * synchronously; if a bundler has been attached via `loadIntoBundler`,
+   * it gets re-reconciled in the background (errors logged, never
+   * thrown — the store is the source of truth, the bundler is derived).
    */
   addServer(config: McpServerConfig, opts: AddServerOptions): Promise<void>;
   /**
@@ -422,9 +401,6 @@ declare class Manager {
    * Refuses to remove an entry whose owner doesn't match `expectedOwner`
    * when supplied — the CLI uses this to guard `alfe mcp remove` from
    * accidentally clobbering integration- or cli-owned entries.
-   *
-   * Resolves as soon as the store mutation is committed. Mirror runs
-   * async; call `flush()` to await it.
    */
   removeServer(id: string, opts?: {
     expectedOwner?: ServerOwner;
@@ -445,30 +421,75 @@ declare class Manager {
   /** Subscribe to store mutations. Returns an unsubscribe fn. */
   onChange(cb: () => void): () => void;
   /**
-   * Cancel any pending mirror-write, flush the in-flight one, and stop
-   * watching the store. Safe to call multiple times.
+   * Detach from the bundler and stop watching the store. Safe to call
+   * multiple times. Does not dispose the underlying `Store` so the
+   * shared instance survives multi-manager environments (rare).
    */
   dispose(): Promise<void>;
+  private scheduleBundlerReconcile;
+  private reconcileBundler;
+  private fireChange;
+}
+//# sourceMappingURL=manager.d.ts.map
+//#endregion
+//#region src/pattern-a-validator.d.ts
+/**
+ * A tool descriptor that the validator can inspect. Plugins can pass
+ * either {@link McpToolDescriptor} (for proxy plugins surfacing child
+ * tools) or a leaner local shape (for direct-MCP plugins). Both come
+ * down to a tool name and a JSON Schema parameter object.
+ */
+interface ValidatableTool {
+  /** Tool name as the LLM sees it (post-namespacing). */
+  name: string;
+  /** JSON Schema for tool parameters (the `inputSchema`). */
+  parameters: Record<string, unknown>;
+}
+interface PatternAOptions {
   /**
-   * Force the debounced mirror to run now and wait for it to finish.
-   * Surfaces the executor error if the mirror failed — callers wrap in
-   * try/catch (or .rejects in tests) if they need to handle it.
+   * The required selector property name. Provider-specific (Google uses
+   * `email`; Notion will use `workspaceId`; Xero will use `xeroTenantId`;
+   * MYOB will use `myobBusinessId`). Plugins MAY support more than one
+   * acceptable name — pass an array.
    */
-  flush(): Promise<void>;
-  private scheduleMirror;
-  private runMirror;
+  selector: string | readonly string[];
   /**
-   * Compute the diff between this manager's owned set and what the store
-   * declares now, then apply the openclaw config delta. Foreign keys
-   * (entries in openclaw.json#mcp.servers.* not in our store) are
-   * preserved — we only touch the names we previously claimed.
+   * Tool names exempt from the selector requirement — typically the
+   * `list_accounts` discovery tool and any pure-utility tools that don't
+   * touch credentials. Match is exact (post-namespacing).
    */
-  private applyMirror;
-  private reconcileBundler;
-  private fireChange;
+  exempt?: readonly string[];
 }
-//# sourceMappingURL=manager.d.ts.map
+interface PatternAViolation {
+  tool: string;
+  reason: "missing-selector-property" | "selector-not-required" | "selector-property-not-string";
+  detail: string;
+}
+/**
+ * Validate that every non-exempt tool's JSON Schema declares the selector
+ * property AND lists it in `required`. Returns the full set of violations
+ * so the caller can report them all in one pass — failing fast on the
+ * first one tends to hide cascading bugs in real plugins.
+ *
+ * The check is intentionally schema-shape-only — it does NOT execute the
+ * tool, call the LLM, or talk to the cloud. It's a fast structural pass
+ * suitable for build-time use.
+ */
+declare function checkPatternA(tools: readonly ValidatableTool[], options: PatternAOptions): PatternAViolation[];
+/**
+ * Thin wrapper that throws an Error listing every violation if any are
+ * present. Convenient for build scripts that want a single guard call.
+ */
+declare function assertPatternA(tools: readonly ValidatableTool[], options: PatternAOptions): void;
+/**
+ * Cast an {@link McpToolDescriptor} (proxy-plugin shape) to the leaner
+ * {@link ValidatableTool} the validator accepts. Useful for proxy
+ * plugins that already maintain a `cachedTools: McpToolDescriptor[]`
+ * collection.
+ */
+declare function fromMcpDescriptor(descriptor: McpToolDescriptor): ValidatableTool;
+//# sourceMappingURL=pattern-a-validator.d.ts.map
 
 //#endregion
-export { type AddServerOptions, type BundlerOptions, Connection, type ConnectionDeps, type Logger, Manager, type ManagerOptions, McpBundler, type McpClientHandle, type McpServerConfig, type McpToolCallResult, type McpToolDescriptor, type McpTransportKind, type OpenclawExecutor, type ReconcileDiff, type RemoteServerConfig, STDIO_ENV_DENYLIST, type ServerOwner, type StdioServerConfig, Store, type StoreOptions, type StoreSchema, type StoredServerEntry, buildNamespacedToolName, defaultConnect, defaultOpenclawExecutor, defaultStorePath, disambiguateAgainst, sanitizeNameSegment, sanitizeStdioEnv, toServerConfig, toStoredEntry };
+export { type AddServerOptions, type BundlerOptions, Connection, type ConnectionDeps, type Logger, Manager, type ManagerOptions, McpBundler, type McpClientHandle, type McpServerConfig, type McpToolCallResult, type McpToolDescriptor, type McpTransportKind, type PatternAOptions, type PatternAViolation, type ReconcileDiff, type RemoteServerConfig, STDIO_ENV_DENYLIST, type ServerOwner, type StdioServerConfig, Store, type StoreOptions, type StoreSchema, type StoredServerEntry, type ValidatableTool, assertPatternA, buildNamespacedToolName, checkPatternA, defaultConnect, defaultStorePath, disambiguateAgainst, fromMcpDescriptor, sanitizeNameSegment, sanitizeStdioEnv, toServerConfig, toStoredEntry };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/connection.ts","../src/bundler.ts","../src/tool-naming.ts","../src/store.ts","../src/manager.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/connection.ts","../src/bundler.ts","../src/tool-naming.ts","../src/store.ts","../src/manager.ts","../src/pattern-a-validator.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,6 @@
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, statSync, unlinkSync, watch, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
 //#region src/tool-naming.ts
 /**
 * Tool name sanitization and collision handling.
@@ -716,60 +714,40 @@ function errMsg$1(err) {
 }
 //#endregion
 //#region src/manager.ts
-const execFileAsync = promisify(execFile);
-const defaultOpenclawExecutor = {
-	async setBatch(batch) {
-		if (batch.length === 0) return;
-		await execFileAsync("openclaw", [
-			"config",
-			"set",
-			"--batch-json",
-			JSON.stringify(batch)
-		], { timeout: 1e4 });
-	},
-	async unset(path) {
-		await execFileAsync("openclaw", [
-			"config",
-			"unset",
-			path
-		], { timeout: 1e4 });
-	}
-};
-const DEFAULT_MIRROR_DEBOUNCE_MS = 250;
 /**
-* Bundler manager — owns the alfe store, mirrors it into openclaw.json,
-* and surfaces a small CRUD API the CLI and integration applier both
-* call into.
+* Bundler manager — owns the `~/.alfe/mcp/servers.json` store and surfaces a
+* small CRUD API the CLI and integration applier both call into.
 *
-* The store is the Alfe-owned source of truth; openclaw.json is a
-* derived mirror so the runtime keeps consuming its existing format.
+* Single source of truth: every consumer (daemon-hosted bundler, CLI `alfe mcp
+* list`, integration uninstall) reads from this store. Openclaw.json is no
+* longer kept in sync — the daemon hosts the bundler children and the
+* openclaw plugin reaches them via IPC, so the openclaw.json mirror became
+* dead weight and an active source of duplicate spawning on claude-cli /
+* codex-cli backends.
+*
+* Call `loadIntoBundler(bundler)` once at daemon startup to wire the store
+* into a live `McpBundler` — subsequent store mutations (including those
+* landed by other processes via the file watcher) re-reconcile automatically.
 */
 var Manager = class {
 	store;
-	executor;
 	logger;
-	mirrorDebounceMs;
-	mirrorTimer;
-	mirrorPromise = Promise.resolve();
-	mirrorPending;
 	bundler;
 	changeListeners = /* @__PURE__ */ new Set();
 	storeUnsubscribe;
 	constructor(opts = {}) {
 		this.store = opts.store ?? new Store({ logger: opts.logger });
-		this.executor = opts.executor ?? defaultOpenclawExecutor;
 		this.logger = opts.logger;
-		this.mirrorDebounceMs = opts.mirrorDebounceMs ?? DEFAULT_MIRROR_DEBOUNCE_MS;
 	}
 	/** Direct accessor — handy for tests and the CLI's `alfe mcp list`. */
 	getStore() {
 		return this.store;
 	}
 	/**
-	* Register or overwrite a server entry. Resolves as soon as the store
-	* mutation is committed to disk — the openclaw.json mirror runs async
-	* in the background and is debounced so back-to-back calls coalesce
-	* into one runtime restart. Call `flush()` to await the mirror.
+	* Register or overwrite a server entry. Mutation lands in the store
+	* synchronously; if a bundler has been attached via `loadIntoBundler`,
+	* it gets re-reconciled in the background (errors logged, never
+	* thrown — the store is the source of truth, the bundler is derived).
 	*/
 	async addServer(config, opts) {
 		if (!opts.id) throw new Error("Manager.addServer: id is required");
@@ -790,7 +768,7 @@ var Manager = class {
 				}
 			};
 		});
-		this.scheduleMirror();
+		this.scheduleBundlerReconcile();
 		this.fireChange();
 		return Promise.resolve();
 	}
@@ -799,9 +777,6 @@ var Manager = class {
 	* Refuses to remove an entry whose owner doesn't match `expectedOwner`
 	* when supplied — the CLI uses this to guard `alfe mcp remove` from
 	* accidentally clobbering integration- or cli-owned entries.
-	*
-	* Resolves as soon as the store mutation is committed. Mirror runs
-	* async; call `flush()` to await it.
 	*/
 	removeServer(id, opts = {}) {
 		const existing = lookupEntry(this.store.read().servers, id);
@@ -811,7 +786,7 @@ var Manager = class {
 			...cur,
 			servers: Object.fromEntries(Object.entries(cur.servers).filter(([k]) => k !== id))
 		}));
-		this.scheduleMirror();
+		this.scheduleBundlerReconcile();
 		this.fireChange();
 		return Promise.resolve(true);
 	}
@@ -829,7 +804,7 @@ var Manager = class {
 			};
 		});
 		if (removed.length > 0) {
-			this.scheduleMirror();
+			this.scheduleBundlerReconcile();
 			this.fireChange();
 		}
 		return Promise.resolve(removed);
@@ -864,16 +839,11 @@ var Manager = class {
 		};
 	}
 	/**
-	* Cancel any pending mirror-write, flush the in-flight one, and stop
-	* watching the store. Safe to call multiple times.
+	* Detach from the bundler and stop watching the store. Safe to call
+	* multiple times. Does not dispose the underlying `Store` so the
+	* shared instance survives multi-manager environments (rare).
 	*/
 	async dispose() {
-		if (this.mirrorTimer) {
-			clearTimeout(this.mirrorTimer);
-			this.mirrorTimer = void 0;
-			await this.runMirror();
-		}
-		await this.mirrorPromise.catch(() => void 0);
 		if (this.storeUnsubscribe) {
 			this.storeUnsubscribe();
 			this.storeUnsubscribe = void 0;
@@ -881,80 +851,13 @@ var Manager = class {
 		this.store.dispose();
 		this.changeListeners.clear();
 		this.bundler = void 0;
+		return Promise.resolve();
 	}
-	/**
-	* Force the debounced mirror to run now and wait for it to finish.
-	* Surfaces the executor error if the mirror failed — callers wrap in
-	* try/catch (or .rejects in tests) if they need to handle it.
-	*/
-	async flush() {
-		if (this.mirrorTimer) {
-			clearTimeout(this.mirrorTimer);
-			this.mirrorTimer = void 0;
-			await this.runMirror();
-		}
-		await this.mirrorPromise;
-	}
-	scheduleMirror() {
-		if (this.mirrorPending) return;
-		this.mirrorPromise = new Promise((resolve, reject) => {
-			this.mirrorPending = {
-				resolve,
-				reject
-			};
-		});
-		this.mirrorTimer = setTimeout(() => {
-			this.mirrorTimer = void 0;
-			this.runMirror();
-		}, this.mirrorDebounceMs);
-		this.mirrorTimer.unref();
-	}
-	async runMirror() {
-		const pending = this.mirrorPending;
-		this.mirrorPending = void 0;
-		try {
-			await this.applyMirror();
-			pending?.resolve();
-		} catch (err) {
-			pending?.reject(err);
-			this.logger?.error("[mcp-bundler/manager] mirror write failed", { err: errMsg(err) });
-		}
-	}
-	/**
-	* Compute the diff between this manager's owned set and what the store
-	* declares now, then apply the openclaw config delta. Foreign keys
-	* (entries in openclaw.json#mcp.servers.* not in our store) are
-	* preserved — we only touch the names we previously claimed.
-	*/
-	async applyMirror() {
-		let previousOwned = [];
-		let desiredOwned = [];
-		let batch = [];
-		this.store.update((cur) => {
-			previousOwned = cur._ownedOpenclawKeys.slice();
-			const entries = Object.entries(cur.servers);
-			desiredOwned = entries.map(([id]) => id).sort();
-			batch = entries.flatMap(([id, entry]) => renderEntryToBatch(id, entry));
-			return {
-				...cur,
-				_ownedOpenclawKeys: desiredOwned
-			};
+	scheduleBundlerReconcile() {
+		if (!this.bundler) return;
+		this.reconcileBundler().catch((err) => {
+			this.logger?.warn("[mcp-bundler/manager] bundler reconcile failed", { err: errMsg(err) });
 		});
-		await this.executor.setBatch(batch);
-		const toUnset = previousOwned.filter((k) => !desiredOwned.includes(k));
-		for (const id of toUnset) try {
-			await this.executor.unset(`mcp.servers.${id}`);
-		} catch (err) {
-			this.logger?.warn("[mcp-bundler/manager] mirror unset failed (continuing)", {
-				err: errMsg(err),
-				key: `mcp.servers.${id}`
-			});
-		}
-		if (this.bundler) try {
-			await this.reconcileBundler();
-		} catch (err) {
-			this.logger?.warn("[mcp-bundler/manager] post-mirror reconcile failed", { err: errMsg(err) });
-		}
 	}
 	async reconcileBundler() {
 		if (!this.bundler) return;
@@ -971,53 +874,6 @@ var Manager = class {
 		}
 	}
 };
-/**
-* Render one store entry as the set of dotted-path batch entries that
-* `openclaw config set --batch-json` expects.
-*
-* Mirrors the format the integrations applier already emits today so the
-* runtime sees the same shape regardless of which writer produced it.
-*/
-function renderEntryToBatch(id, entry) {
-	const prefix = `mcp.servers.${id}`;
-	const out = [];
-	if (entry.transport === "stdio") {
-		out.push({
-			path: `${prefix}.command`,
-			value: entry.command
-		});
-		if (entry.args && entry.args.length > 0) out.push({
-			path: `${prefix}.args`,
-			value: entry.args
-		});
-		if (entry.env) for (const [k, v] of Object.entries(entry.env)) out.push({
-			path: `${prefix}.env.${k}`,
-			value: v
-		});
-		if (entry.cwd) out.push({
-			path: `${prefix}.cwd`,
-			value: entry.cwd
-		});
-		return out;
-	}
-	out.push({
-		path: `${prefix}.url`,
-		value: entry.url
-	});
-	out.push({
-		path: `${prefix}.transport`,
-		value: entry.transport
-	});
-	if (entry.headers) for (const [k, v] of Object.entries(entry.headers)) out.push({
-		path: `${prefix}.headers.${k}`,
-		value: v
-	});
-	if (entry.connectionTimeoutMs !== void 0) out.push({
-		path: `${prefix}.connectionTimeoutMs`,
-		value: entry.connectionTimeoutMs
-	});
-	return out;
-}
 function errMsg(err) {
 	return err instanceof Error ? err.message : String(err);
 }
@@ -1035,6 +891,75 @@ function lookupAddedAt(servers, id) {
 	return entry ? entry.addedAt : void 0;
 }
 //#endregion
-export { Connection, Manager, McpBundler, STDIO_ENV_DENYLIST, Store, buildNamespacedToolName, defaultConnect, defaultOpenclawExecutor, defaultStorePath, disambiguateAgainst, sanitizeNameSegment, sanitizeStdioEnv, toServerConfig, toStoredEntry };
+//#region src/pattern-a-validator.ts
+/**
+* Validate that every non-exempt tool's JSON Schema declares the selector
+* property AND lists it in `required`. Returns the full set of violations
+* so the caller can report them all in one pass — failing fast on the
+* first one tends to hide cascading bugs in real plugins.
+*
+* The check is intentionally schema-shape-only — it does NOT execute the
+* tool, call the LLM, or talk to the cloud. It's a fast structural pass
+* suitable for build-time use.
+*/
+function checkPatternA(tools, options) {
+	const selectorNames = typeof options.selector === "string" ? [options.selector] : options.selector;
+	const exempt = new Set(options.exempt ?? []);
+	const violations = [];
+	for (const tool of tools) {
+		if (exempt.has(tool.name)) continue;
+		const schema = tool.parameters;
+		const properties = schema.properties ?? {};
+		const required = schema.required ?? [];
+		const matched = selectorNames.find((name) => name in properties);
+		if (!matched) {
+			violations.push({
+				tool: tool.name,
+				reason: "missing-selector-property",
+				detail: `expected one of [${selectorNames.join(", ")}] in inputSchema.properties`
+			});
+			continue;
+		}
+		if (!required.includes(matched)) {
+			violations.push({
+				tool: tool.name,
+				reason: "selector-not-required",
+				detail: `selector "${matched}" present in properties but missing from inputSchema.required`
+			});
+			continue;
+		}
+		const type = properties[matched].type;
+		if (type !== "string") violations.push({
+			tool: tool.name,
+			reason: "selector-property-not-string",
+			detail: `selector "${matched}" must be JSON Schema type=string (found ${JSON.stringify(type)})`
+		});
+	}
+	return violations;
+}
+/**
+* Thin wrapper that throws an Error listing every violation if any are
+* present. Convenient for build scripts that want a single guard call.
+*/
+function assertPatternA(tools, options) {
+	const violations = checkPatternA(tools, options);
+	if (violations.length === 0) return;
+	const lines = violations.map((v) => `  - [${v.reason}] ${v.tool}: ${v.detail}`);
+	throw new Error(`Pattern A validation failed for ${String(violations.length)} tool(s):\n${lines.join("\n")}`);
+}
+/**
+* Cast an {@link McpToolDescriptor} (proxy-plugin shape) to the leaner
+* {@link ValidatableTool} the validator accepts. Useful for proxy
+* plugins that already maintain a `cachedTools: McpToolDescriptor[]`
+* collection.
+*/
+function fromMcpDescriptor(descriptor) {
+	return {
+		name: descriptor.prefixed,
+		parameters: descriptor.parameters
+	};
+}
+//#endregion
+export { Connection, Manager, McpBundler, STDIO_ENV_DENYLIST, Store, assertPatternA, buildNamespacedToolName, checkPatternA, defaultConnect, defaultStorePath, disambiguateAgainst, fromMcpDescriptor, sanitizeNameSegment, sanitizeStdioEnv, toServerConfig, toStoredEntry };
 
 //# sourceMappingURL=index.js.map