@aigne/afs-cli 1.11.0-beta.11 → 1.11.0-beta.13

package/dist/daemon/config-manager.mjs

@@ -0,0 +1,279 @@
+import { ConfigLoader } from "../config/loader.mjs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parse, stringify } from "smol-toml";
+import { ProviderRegistry } from "@aigne/afs";
+import { watch } from "node:fs";
+
+//#region src/daemon/config-manager.ts
+/**
+* ConfigManager Implementation
+*
+* Manages config.toml read/write operations for the daemon.
+* Implements the ConfigManager interface from @aigne/afs-explorer.
+*/
+var DaemonConfigManager = class {
+	cwd;
+	afs;
+	onConfigChanged;
+	watcher;
+	_selfWriteTimestamp = 0;
+	_debounceTimer;
+	_failures = [];
+	/** Tracks mount paths that originated from config.toml. Only these are eligible for unmount on reload. */
+	configManagedPaths;
+	registry;
+	constructor(options) {
+		this.cwd = options.cwd;
+		this.afs = options.afs;
+		this.registry = options.registry;
+		this.onConfigChanged = options.onConfigChanged;
+		this.configManagedPaths = new Set(options.configMountPaths ?? []);
+		if (options.failures) this._failures = [...options.failures];
+	}
+	async getConfig() {
+		return new ConfigLoader().load(this.cwd);
+	}
+	async getMountList() {
+		const mounts = this.afs.getMounts();
+		return {
+			mounts: await Promise.all(mounts.map(async (m) => {
+				const ctor = m.module.constructor;
+				const manifest = typeof ctor.manifest === "function" ? ctor.manifest() : null;
+				let url;
+				try {
+					if (typeof m.module.stat === "function") url = (await m.module.stat("/", {}))?.data?.meta?.url || void 0;
+				} catch {}
+				return {
+					namespace: m.namespace,
+					path: m.path,
+					name: m.module.name,
+					description: m.module.description,
+					accessMode: m.module.accessMode,
+					category: manifest?.category || void 0,
+					tags: manifest?.tags || void 0,
+					uri: manifest?.uriTemplate || void 0,
+					url
+				};
+			})),
+			failures: this._failures
+		};
+	}
+	async addMount(mount) {
+		const uri = mount.uri;
+		const path = mount.path;
+		if (!uri || !path) throw new Error("uri and path are required");
+		const mountConfig = await this.buildMountWithCredentials(uri, path, mount.auth, {
+			description: mount.description,
+			access_mode: mount.accessMode,
+			namespace: mount.namespace,
+			options: mount.options
+		});
+		const provider = await (this.registry ?? new ProviderRegistry()).createProvider(mountConfig);
+		await this.afs.mount(provider, path, { namespace: mountConfig.namespace ?? null });
+		await this.persistAddMount(mountConfig);
+		this.configManagedPaths.add(path);
+	}
+	async removeMount(path) {
+		this.afs.unmount(path);
+		await this.persistRemoveMount(path);
+		this.configManagedPaths.delete(path);
+	}
+	async updateMount(path, updates) {
+		const config = await this.readConfigFile();
+		const entry = (config.mounts ?? []).find((m) => m.path === path);
+		if (!entry) throw new Error(`Mount "${path}" not found in config`);
+		if (updates.description !== void 0) entry.description = updates.description;
+		if (updates.accessMode !== void 0) entry.access_mode = updates.accessMode;
+		if (updates.auth !== void 0) entry.auth = updates.auth;
+		await this.writeConfigFile(config);
+		try {
+			this.afs.unmount(path);
+		} catch {}
+		const mount = await this.buildMountWithCredentials(entry.uri, entry.path, entry.auth, {
+			description: entry.description,
+			access_mode: entry.access_mode,
+			namespace: entry.namespace,
+			options: entry.options
+		});
+		const provider = await new ProviderRegistry().createProvider(mount);
+		await this.afs.mount(provider, path, { namespace: entry.namespace ?? null });
+	}
+	async testMount(uri, auth) {
+		try {
+			const registry = new ProviderRegistry();
+			const mount = await this.buildMountWithCredentials(uri, "/test", auth);
+			const provider = await registry.createProvider(mount);
+			await provider.list("/", {});
+			const providerName = provider.name;
+			try {
+				await provider.close?.();
+			} catch {}
+			return {
+				success: true,
+				providerName
+			};
+		} catch (err) {
+			return {
+				success: false,
+				error: err instanceof Error ? err.message : String(err)
+			};
+		}
+	}
+	async reloadConfig() {
+		const newConfig = await new ConfigLoader().load(this.cwd);
+		const currentMounts = new Set(this.afs.getMounts().map((m) => m.path));
+		const newMountPaths = new Set(newConfig.mounts.map((m) => m.path));
+		const removed = [];
+		for (const path of this.configManagedPaths) if (!newMountPaths.has(path)) {
+			try {
+				this.afs.unmount(path);
+				removed.push(path);
+			} catch {}
+			this.configManagedPaths.delete(path);
+		}
+		const added = [];
+		const registry = new ProviderRegistry();
+		for (const mount of newConfig.mounts) if (!currentMounts.has(mount.path)) try {
+			const provider = await registry.createProvider(mount);
+			await this.afs.mount(provider, mount.path, { namespace: mount.namespace ?? null });
+			added.push(mount.path);
+			this.configManagedPaths.add(mount.path);
+		} catch (err) {
+			console.warn(`[reload] Failed to mount ${mount.path}: ${err instanceof Error ? err.message : String(err)}`);
+		}
+		if (this.onConfigChanged && (added.length > 0 || removed.length > 0)) this.onConfigChanged(added, removed);
+	}
+	/**
+	* Start watching config file for external changes.
+	*/
+	startWatching() {
+		const configPath = this.getConfigPath();
+		try {
+			this.watcher = watch(dirname(configPath), (_event, filename) => {
+				if (filename !== "config.toml") return;
+				if (Date.now() - this._selfWriteTimestamp < 500) return;
+				if (this._debounceTimer) clearTimeout(this._debounceTimer);
+				this._debounceTimer = setTimeout(() => {
+					this.reloadConfig().catch((err) => {
+						console.warn(`[watch] Reload failed: ${err instanceof Error ? err.message : String(err)}`);
+					});
+				}, 300);
+			});
+		} catch {}
+	}
+	async getRegistry() {
+		try {
+			const { scanInstalledProviders } = await import("@aigne/afs-registry");
+			return (await scanInstalledProviders()).map((m) => ({
+				name: m.name,
+				description: m.description,
+				category: m.category,
+				uriTemplate: m.uriTemplate,
+				tags: m.tags
+			}));
+		} catch {
+			return [];
+		}
+	}
+	stopWatching() {
+		if (this.watcher) {
+			this.watcher.close();
+			this.watcher = void 0;
+		}
+		if (this._debounceTimer) {
+			clearTimeout(this._debounceTimer);
+			this._debounceTimer = void 0;
+		}
+	}
+	/**
+	* Build a MountConfig with proper credential mapping.
+	*
+	* Uses the provider schema to:
+	* 1. Resolve credentials from env vars (e.g. AIGNE_HUB_API_KEY)
+	* 2. Resolve credentials from the credential store (vault)
+	* 3. Map generic `auth` to the provider's specific credential field (e.g. apiKey)
+	*/
+	async buildMountWithCredentials(uri, path, auth, extra) {
+		const mount = {
+			uri,
+			path,
+			auth,
+			description: extra?.description,
+			access_mode: extra?.access_mode,
+			namespace: extra?.namespace,
+			options: extra?.options ? { ...extra.options } : void 0
+		};
+		try {
+			const info = await new ProviderRegistry().getProviderInfo(uri);
+			if (!info?.schema) return mount;
+			const { getSensitiveFields, resolveEnvFromSchema } = await import("@aigne/afs/utils/schema");
+			const opts = mount.options ?? {};
+			const envResolved = resolveEnvFromSchema(info.schema);
+			for (const [field, value] of Object.entries(envResolved)) if (opts[field] === void 0) opts[field] = value;
+			try {
+				const { createCredentialStore } = await import("../credential/store.mjs");
+				const stored = await createCredentialStore().get(uri);
+				if (stored) {
+					for (const [field, value] of Object.entries(stored)) if (!field.startsWith("env:") && opts[field] === void 0) opts[field] = value;
+				}
+			} catch {}
+			if (auth) {
+				const sensitiveFields = getSensitiveFields(info.schema);
+				for (const field of sensitiveFields) if (field !== "auth" && field !== "token" && opts[field] === void 0) {
+					opts[field] = auth;
+					break;
+				}
+			}
+			if (Object.keys(opts).length > 0) mount.options = opts;
+		} catch {}
+		return mount;
+	}
+	getConfigPath() {
+		return join(this.cwd, ".afs-config", "config.toml");
+	}
+	async readConfigFile() {
+		const configPath = this.getConfigPath();
+		try {
+			return parse(await readFile(configPath, "utf-8"));
+		} catch {
+			return { mounts: [] };
+		}
+	}
+	async writeConfigFile(config) {
+		const configPath = this.getConfigPath();
+		const configDir = dirname(configPath);
+		try {
+			await mkdir(configDir, { recursive: true });
+		} catch {}
+		this._selfWriteTimestamp = Date.now();
+		await writeFile(configPath, stringify(config), "utf-8");
+	}
+	async persistAddMount(mount) {
+		const config = await this.readConfigFile();
+		const mounts = config.mounts ?? [];
+		const entry = {
+			path: mount.path,
+			uri: mount.uri
+		};
+		if (mount.description) entry.description = mount.description;
+		if (mount.access_mode) entry.access_mode = mount.access_mode;
+		if (mount.auth) entry.auth = mount.auth;
+		if (mount.namespace) entry.namespace = mount.namespace;
+		if (mount.options) entry.options = mount.options;
+		const existing = mounts.findIndex((m) => m.path === mount.path);
+		if (existing >= 0) mounts[existing] = entry;
+		else mounts.push(entry);
+		config.mounts = mounts;
+		await this.writeConfigFile(config);
+	}
+	async persistRemoveMount(path) {
+		const config = await this.readConfigFile();
+		config.mounts = (config.mounts ?? []).filter((m) => m.path !== path);
+		await this.writeConfigFile(config);
+	}
+};
+
+//#endregion
+export { DaemonConfigManager };
+//# sourceMappingURL=config-manager.mjs.map

package/dist/daemon/config-manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.mjs","names":[],"sources":["../../src/daemon/config-manager.ts"],"sourcesContent":["/**\n * ConfigManager Implementation\n *\n * Manages config.toml read/write operations for the daemon.\n * Implements the ConfigManager interface from @aigne/afs-explorer.\n */\n\nimport { type FSWatcher, watch } from \"node:fs\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport type { AFS } from \"@aigne/afs\";\nimport { ProviderRegistry } from \"@aigne/afs\";\nimport type { ConfigManager } from \"@aigne/afs-explorer\";\nimport { parse, stringify } from \"smol-toml\";\nimport { ConfigLoader } from \"../config/loader.js\";\nimport type { MountConfig } from \"../config/schema.js\";\n\nexport interface MountFailure {\n  path: string;\n  uri: string;\n  reason: string;\n}\n\nexport interface ConfigManagerOptions {\n  /** Working directory for config resolution. */\n  cwd: string;\n  /** AFS instance to mount/unmount providers on. */\n  afs: AFS;\n  /** Provider registry for creating providers at runtime (e.g. add-mount). */\n  registry?: ProviderRegistry;\n  /** Mount paths that came from config.toml at startup (only these are unmounted on reload). */\n  configMountPaths?: string[];\n  /** Initial mount failures from startup. */\n  failures?: MountFailure[];\n  /** Callback when config changes are detected (for WS broadcast). */\n  onConfigChanged?: (added: string[], removed: string[]) => void;\n}\n\ninterface ConfigMountEntry {\n  path: string;\n  uri: string;\n  namespace?: string;\n  description?: string;\n  access_mode?: \"readonly\" | \"readwrite\";\n  auth?: string;\n  token?: string;\n  options?: Record<string, unknown>;\n}\n\nexport class DaemonConfigManager implements ConfigManager {\n  private cwd: string;\n  private afs: AFS;\n  private onConfigChanged?: (added: string[], removed: string[]) => void;\n  private watcher?: FSWatcher;\n  private _selfWriteTimestamp = 0;\n  private _debounceTimer?: ReturnType<typeof setTimeout>;\n  private _failures: MountFailure[] = [];\n  /** Tracks mount paths that originated from config.toml. Only these are eligible for unmount on reload. */\n  private configManagedPaths: Set<string>;\n  private registry?: ProviderRegistry;\n\n  constructor(options: ConfigManagerOptions) {\n    this.cwd = options.cwd;\n    this.afs = options.afs;\n    this.registry = options.registry;\n    this.onConfigChanged = options.onConfigChanged;\n    this.configManagedPaths = new Set(options.configMountPaths ?? []);\n    if (options.failures) this._failures = [...options.failures];\n  }\n\n  async getConfig(): Promise<unknown> {\n    const loader = new ConfigLoader();\n    return loader.load(this.cwd);\n  }\n\n  async getMountList(): Promise<{ mounts: unknown[]; failures: unknown[] }> {\n    const mounts = this.afs.getMounts();\n    const mountInfos = await Promise.all(\n      mounts.map(async (m) => {\n        const ctor = m.module.constructor as unknown as Record<string, unknown>;\n        const manifest =\n          typeof ctor.manifest === \"function\" ? (ctor.manifest() as Record<string, unknown>) : null;\n\n        // Try to get URL from provider meta (e.g. UI providers with web servers)\n        let url: string | undefined;\n        try {\n          if (typeof m.module.stat === \"function\") {\n            const statResult = await m.module.stat(\"/\", {});\n            url = (statResult?.data?.meta?.url as string) || undefined;\n          }\n        } catch {\n          // Provider may not support stat — ignore\n        }\n\n        return {\n          namespace: m.namespace,\n          path: m.path,\n          name: m.module.name,\n          description: m.module.description,\n          accessMode: m.module.accessMode,\n          category: (manifest?.category as string) || undefined,\n          tags: (manifest?.tags as string[]) || undefined,\n          uri: (manifest?.uriTemplate as string) || undefined,\n          url,\n        };\n      }),\n    );\n    return { mounts: mountInfos, failures: this._failures };\n  }\n\n  async addMount(mount: Record<string, unknown>): Promise<void> {\n    const uri = mount.uri as string;\n    const path = mount.path as string;\n    if (!uri || !path) throw new Error(\"uri and path are required\");\n\n    // Build mount config with credential resolution (env, store, auth→field mapping)\n    const mountConfig = await this.buildMountWithCredentials(\n      uri,\n      path,\n      mount.auth as string | undefined,\n      {\n        description: mount.description as string | undefined,\n        access_mode: mount.accessMode as \"readonly\" | \"readwrite\" | undefined,\n        namespace: mount.namespace as string | undefined,\n        options: mount.options as Record<string, unknown> | undefined,\n      },\n    );\n\n    const registry = this.registry ?? new ProviderRegistry();\n    const provider = await registry.createProvider(mountConfig);\n    await this.afs.mount(provider, path, {\n      namespace: mountConfig.namespace ?? null,\n    });\n\n    // Persist to config.toml and track as config-managed\n    await this.persistAddMount(mountConfig);\n    this.configManagedPaths.add(path);\n  }\n\n  async removeMount(path: string): Promise<void> {\n    // Unmount from AFS\n    this.afs.unmount(path);\n\n    // Remove from config.toml and stop tracking\n    await this.persistRemoveMount(path);\n    this.configManagedPaths.delete(path);\n  }\n\n  async updateMount(path: string, updates: Record<string, unknown>): Promise<void> {\n    // Update config.toml\n    const config = await this.readConfigFile();\n    const mounts = (config.mounts as ConfigMountEntry[]) ?? [];\n    const entry = mounts.find((m) => m.path === path);\n    if (!entry) throw new Error(`Mount \"${path}\" not found in config`);\n\n    if (updates.description !== undefined) entry.description = updates.description as string;\n    if (updates.accessMode !== undefined)\n      entry.access_mode = updates.accessMode as \"readonly\" | \"readwrite\";\n    if (updates.auth !== undefined) entry.auth = updates.auth as string;\n\n    await this.writeConfigFile(config);\n\n    // Re-mount with updated config: unmount + remount\n    try {\n      this.afs.unmount(path);\n    } catch {\n      // May not be mounted\n    }\n\n    const mount = await this.buildMountWithCredentials(entry.uri, entry.path, entry.auth, {\n      description: entry.description,\n      access_mode: entry.access_mode,\n      namespace: entry.namespace,\n      options: entry.options,\n    });\n\n    const registry = new ProviderRegistry();\n    const provider = await registry.createProvider(mount);\n    await this.afs.mount(provider, path, {\n      namespace: entry.namespace ?? null,\n    });\n  }\n\n  async testMount(\n    uri: string,\n    auth?: string,\n  ): Promise<{ success: boolean; error?: string; providerName?: string }> {\n    try {\n      const registry = new ProviderRegistry();\n      const mount = await this.buildMountWithCredentials(uri, \"/test\", auth);\n      const provider = await registry.createProvider(mount);\n\n      // Try listing root to verify connection\n      await provider.list!(\"/\", {});\n      const providerName = provider.name;\n\n      // Clean up\n      try {\n        await provider.close?.();\n      } catch {\n        // ignore\n      }\n\n      return { success: true, providerName };\n    } catch (err) {\n      return {\n        success: false,\n        error: err instanceof Error ? err.message : String(err),\n      };\n    }\n  }\n\n  async reloadConfig(): Promise<void> {\n    const loader = new ConfigLoader();\n    const newConfig = await loader.load(this.cwd);\n\n    const currentMounts = new Set(this.afs.getMounts().map((m) => m.path));\n    const newMountPaths = new Set(newConfig.mounts.map((m) => m.path));\n\n    // Find removed mounts — only check config-managed paths (leave code-managed providers untouched)\n    const removed: string[] = [];\n    for (const path of this.configManagedPaths) {\n      if (!newMountPaths.has(path)) {\n        try {\n          this.afs.unmount(path);\n          removed.push(path);\n        } catch {\n          // ignore\n        }\n        this.configManagedPaths.delete(path);\n      }\n    }\n\n    // Find added mounts\n    const added: string[] = [];\n    const registry = new ProviderRegistry();\n    for (const mount of newConfig.mounts) {\n      if (!currentMounts.has(mount.path)) {\n        try {\n          const provider = await registry.createProvider(mount);\n          await this.afs.mount(provider, mount.path, {\n            namespace: mount.namespace ?? null,\n          });\n          added.push(mount.path);\n          this.configManagedPaths.add(mount.path);\n        } catch (err) {\n          console.warn(\n            `[reload] Failed to mount ${mount.path}: ${err instanceof Error ? err.message : String(err)}`,\n          );\n        }\n      }\n    }\n\n    if (this.onConfigChanged && (added.length > 0 || removed.length > 0)) {\n      this.onConfigChanged(added, removed);\n    }\n  }\n\n  /**\n   * Start watching config file for external changes.\n   */\n  startWatching(): void {\n    const configPath = this.getConfigPath();\n    try {\n      this.watcher = watch(dirname(configPath), (_event, filename) => {\n        if (filename !== \"config.toml\") return;\n\n        // Skip self-write events\n        if (Date.now() - this._selfWriteTimestamp < 500) return;\n\n        // Debounce\n        if (this._debounceTimer) clearTimeout(this._debounceTimer);\n        this._debounceTimer = setTimeout(() => {\n          this.reloadConfig().catch((err) => {\n            console.warn(\n              `[watch] Reload failed: ${err instanceof Error ? err.message : String(err)}`,\n            );\n          });\n        }, 300);\n      });\n    } catch {\n      // fs.watch may not be supported\n    }\n  }\n\n  async getRegistry(): Promise<\n    Array<{\n      name: string;\n      description: string;\n      category: string;\n      uriTemplate: string;\n      tags?: string[];\n      packageName?: string;\n    }>\n  > {\n    try {\n      const { scanInstalledProviders } = await import(\"@aigne/afs-registry\");\n      const manifests = await scanInstalledProviders();\n      return manifests.map((m) => ({\n        name: m.name,\n        description: m.description,\n        category: m.category,\n        uriTemplate: m.uriTemplate,\n        tags: m.tags,\n      }));\n    } catch {\n      return [];\n    }\n  }\n\n  stopWatching(): void {\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = undefined;\n    }\n    if (this._debounceTimer) {\n      clearTimeout(this._debounceTimer);\n      this._debounceTimer = undefined;\n    }\n  }\n\n  // ── Private helpers ──\n\n  /**\n   * Build a MountConfig with proper credential mapping.\n   *\n   * Uses the provider schema to:\n   * 1. Resolve credentials from env vars (e.g. AIGNE_HUB_API_KEY)\n   * 2. Resolve credentials from the credential store (vault)\n   * 3. Map generic `auth` to the provider's specific credential field (e.g. apiKey)\n   */\n  private async buildMountWithCredentials(\n    uri: string,\n    path: string,\n    auth?: string,\n    extra?: {\n      description?: string;\n      access_mode?: \"readonly\" | \"readwrite\";\n      namespace?: string;\n      options?: Record<string, unknown>;\n    },\n  ): Promise<MountConfig> {\n    const mount: MountConfig = {\n      uri,\n      path,\n      auth,\n      description: extra?.description,\n      access_mode: extra?.access_mode,\n      namespace: extra?.namespace,\n      options: extra?.options ? { ...extra.options } : undefined,\n    };\n\n    try {\n      const registry = new ProviderRegistry();\n      const info = await registry.getProviderInfo(uri);\n      if (!info?.schema) return mount;\n\n      const { getSensitiveFields, resolveEnvFromSchema } = await import(\"@aigne/afs/utils/schema\");\n      const opts = mount.options ?? {};\n\n      // Step 1: Resolve env vars declared in schema (e.g. AIGNE_HUB_API_KEY → apiKey)\n      const envResolved = resolveEnvFromSchema(info.schema);\n      for (const [field, value] of Object.entries(envResolved)) {\n        if (opts[field] === undefined) {\n          opts[field] = value;\n        }\n      }\n\n      // Step 2: Resolve from credential store\n      try {\n        const { createCredentialStore } = await import(\"../credential/store.js\");\n        const store = createCredentialStore();\n        const stored = await store.get(uri);\n        if (stored) {\n          for (const [field, value] of Object.entries(stored)) {\n            if (!field.startsWith(\"env:\") && opts[field] === undefined) {\n              opts[field] = value;\n            }\n          }\n        }\n      } catch {\n        // Credential store unavailable — continue\n      }\n\n      // Step 3: Map generic auth → provider's sensitive credential field\n      // e.g. auth token → apiKey for aignehub, token for github\n      if (auth) {\n        const sensitiveFields = getSensitiveFields(info.schema);\n        for (const field of sensitiveFields) {\n          if (field !== \"auth\" && field !== \"token\" && opts[field] === undefined) {\n            opts[field] = auth;\n            break;\n          }\n        }\n      }\n\n      if (Object.keys(opts).length > 0) {\n        mount.options = opts;\n      }\n    } catch {\n      // Schema resolution failed — return mount as-is\n    }\n\n    return mount;\n  }\n\n  private getConfigPath(): string {\n    return join(this.cwd, \".afs-config\", \"config.toml\");\n  }\n\n  private async readConfigFile(): Promise<Record<string, unknown>> {\n    const configPath = this.getConfigPath();\n    try {\n      const content = await readFile(configPath, \"utf-8\");\n      return parse(content) as Record<string, unknown>;\n    } catch {\n      return { mounts: [] };\n    }\n  }\n\n  private async writeConfigFile(config: Record<string, unknown>): Promise<void> {\n    const configPath = this.getConfigPath();\n    const configDir = dirname(configPath);\n    try {\n      await mkdir(configDir, { recursive: true });\n    } catch {\n      // may exist\n    }\n    this._selfWriteTimestamp = Date.now();\n    await writeFile(configPath, stringify(config), \"utf-8\");\n  }\n\n  private async persistAddMount(mount: MountConfig): Promise<void> {\n    const config = await this.readConfigFile();\n    const mounts = (config.mounts as ConfigMountEntry[]) ?? [];\n\n    const entry: ConfigMountEntry = {\n      path: mount.path,\n      uri: mount.uri,\n    };\n    if (mount.description) entry.description = mount.description;\n    if (mount.access_mode) entry.access_mode = mount.access_mode;\n    if (mount.auth) entry.auth = mount.auth;\n    if (mount.namespace) entry.namespace = mount.namespace;\n    if (mount.options) entry.options = mount.options;\n\n    // Upsert\n    const existing = mounts.findIndex((m) => m.path === mount.path);\n    if (existing >= 0) {\n      mounts[existing] = entry;\n    } else {\n      mounts.push(entry);\n    }\n    config.mounts = mounts;\n\n    await this.writeConfigFile(config);\n  }\n\n  private async persistRemoveMount(path: string): Promise<void> {\n    const config = await this.readConfigFile();\n    const mounts = (config.mounts as ConfigMountEntry[]) ?? [];\n    config.mounts = mounts.filter((m) => m.path !== path);\n    await this.writeConfigFile(config);\n  }\n}\n"],"mappings":"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"}

package/dist/daemon/manager.cjs

@@ -0,0 +1,164 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let node_child_process = require("node:child_process");
+let node_fs_promises = require("node:fs/promises");
+let node_os = require("node:os");
+let node_path = require("node:path");
+
+//#region src/daemon/manager.ts
+/**
+* Daemon Process Manager
+*
+* Manages PID/port files in ~/.afs/ and provides daemon lifecycle operations.
+*/
+const DAEMON_DIR = (0, node_path.join)((0, node_os.homedir)(), ".afs");
+const PID_FILE = (0, node_path.join)(DAEMON_DIR, "daemon.pid");
+const PORT_FILE = (0, node_path.join)(DAEMON_DIR, "daemon.port");
+const LOG_FILE = (0, node_path.join)(DAEMON_DIR, "daemon.log");
+function getLogFile() {
+	return LOG_FILE;
+}
+async function ensureDaemonDir() {
+	await (0, node_fs_promises.mkdir)(DAEMON_DIR, { recursive: true });
+}
+async function writePidFile(pid) {
+	await ensureDaemonDir();
+	await (0, node_fs_promises.writeFile)(PID_FILE, String(pid), "utf-8");
+}
+async function writePortFile(port) {
+	await ensureDaemonDir();
+	await (0, node_fs_promises.writeFile)(PORT_FILE, String(port), "utf-8");
+}
+async function readPidFile() {
+	try {
+		const content = await (0, node_fs_promises.readFile)(PID_FILE, "utf-8");
+		const pid = Number.parseInt(content.trim(), 10);
+		return Number.isNaN(pid) ? null : pid;
+	} catch {
+		return null;
+	}
+}
+async function readPortFile() {
+	try {
+		const content = await (0, node_fs_promises.readFile)(PORT_FILE, "utf-8");
+		const port = Number.parseInt(content.trim(), 10);
+		return Number.isNaN(port) ? null : port;
+	} catch {
+		return null;
+	}
+}
+async function cleanPidFiles() {
+	try {
+		await (0, node_fs_promises.rm)(PID_FILE, { force: true });
+	} catch {}
+	try {
+		await (0, node_fs_promises.rm)(PORT_FILE, { force: true });
+	} catch {}
+}
+/**
+* Check if a process is alive by sending signal 0.
+*/
+function isProcessAlive(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Check if daemon is currently running.
+* Returns DaemonInfo if alive, null if not running (cleans stale PID files).
+*/
+async function getDaemonStatus() {
+	const pid = await readPidFile();
+	if (pid === null) return null;
+	if (!isProcessAlive(pid)) {
+		await cleanPidFiles();
+		return null;
+	}
+	const port = await readPortFile();
+	if (port === null) return null;
+	return {
+		pid,
+		port,
+		url: `http://localhost:${port}`,
+		mcpUrl: `http://localhost:${port}/mcp`
+	};
+}
+/**
+* Stop the daemon by sending SIGTERM to the PID.
+*/
+async function stopDaemon() {
+	const pid = await readPidFile();
+	if (pid === null) return false;
+	if (!isProcessAlive(pid)) {
+		await cleanPidFiles();
+		return false;
+	}
+	try {
+		process.kill(pid, "SIGTERM");
+	} catch {}
+	for (let i = 0; i < 50; i++) {
+		await new Promise((r) => setTimeout(r, 100));
+		if (!isProcessAlive(pid)) {
+			await cleanPidFiles();
+			return true;
+		}
+	}
+	try {
+		process.kill(pid, "SIGKILL");
+	} catch {}
+	await cleanPidFiles();
+	return true;
+}
+/**
+* Spawn a detached daemon child process (`afs daemon _run`).
+*
+* The parent opens a log file, spawns the child detached, then polls for
+* the port file the child writes on successful startup.
+*
+* Returns DaemonInfo once the child is confirmed running, or throws on timeout.
+*/
+async function spawnDaemon(port) {
+	await ensureDaemonDir();
+	const logFd = await (0, node_fs_promises.open)(LOG_FILE, "w");
+	const fd = logFd.fd;
+	const args = [
+		...process.execArgv,
+		process.argv[1],
+		"service",
+		"_run",
+		"--port",
+		String(port)
+	];
+	const opts = {
+		detached: true,
+		stdio: [
+			"ignore",
+			fd,
+			fd
+		],
+		env: process.env
+	};
+	(0, node_child_process.spawn)(process.execPath, args, opts).unref();
+	await logFd.close();
+	const maxWait = 15e3;
+	const interval = 100;
+	const deadline = Date.now() + maxWait;
+	while (Date.now() < deadline) {
+		const info = await getDaemonStatus();
+		if (info) return info;
+		await new Promise((r) => setTimeout(r, interval));
+	}
+	throw new Error(`Daemon did not start within ${maxWait / 1e3}s — check ${LOG_FILE}`);
+}
+
+//#endregion
+exports.cleanPidFiles = cleanPidFiles;
+exports.ensureDaemonDir = ensureDaemonDir;
+exports.getDaemonStatus = getDaemonStatus;
+exports.getLogFile = getLogFile;
+exports.spawnDaemon = spawnDaemon;
+exports.stopDaemon = stopDaemon;
+exports.writePidFile = writePidFile;
+exports.writePortFile = writePortFile;

package/dist/daemon/manager.mjs

@@ -0,0 +1,157 @@
+import { spawn } from "node:child_process";
+import { mkdir, open, readFile, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+//#region src/daemon/manager.ts
+/**
+* Daemon Process Manager
+*
+* Manages PID/port files in ~/.afs/ and provides daemon lifecycle operations.
+*/
+const DAEMON_DIR = join(homedir(), ".afs");
+const PID_FILE = join(DAEMON_DIR, "daemon.pid");
+const PORT_FILE = join(DAEMON_DIR, "daemon.port");
+const LOG_FILE = join(DAEMON_DIR, "daemon.log");
+function getLogFile() {
+	return LOG_FILE;
+}
+async function ensureDaemonDir() {
+	await mkdir(DAEMON_DIR, { recursive: true });
+}
+async function writePidFile(pid) {
+	await ensureDaemonDir();
+	await writeFile(PID_FILE, String(pid), "utf-8");
+}
+async function writePortFile(port) {
+	await ensureDaemonDir();
+	await writeFile(PORT_FILE, String(port), "utf-8");
+}
+async function readPidFile() {
+	try {
+		const content = await readFile(PID_FILE, "utf-8");
+		const pid = Number.parseInt(content.trim(), 10);
+		return Number.isNaN(pid) ? null : pid;
+	} catch {
+		return null;
+	}
+}
+async function readPortFile() {
+	try {
+		const content = await readFile(PORT_FILE, "utf-8");
+		const port = Number.parseInt(content.trim(), 10);
+		return Number.isNaN(port) ? null : port;
+	} catch {
+		return null;
+	}
+}
+async function cleanPidFiles() {
+	try {
+		await rm(PID_FILE, { force: true });
+	} catch {}
+	try {
+		await rm(PORT_FILE, { force: true });
+	} catch {}
+}
+/**
+* Check if a process is alive by sending signal 0.
+*/
+function isProcessAlive(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Check if daemon is currently running.
+* Returns DaemonInfo if alive, null if not running (cleans stale PID files).
+*/
+async function getDaemonStatus() {
+	const pid = await readPidFile();
+	if (pid === null) return null;
+	if (!isProcessAlive(pid)) {
+		await cleanPidFiles();
+		return null;
+	}
+	const port = await readPortFile();
+	if (port === null) return null;
+	return {
+		pid,
+		port,
+		url: `http://localhost:${port}`,
+		mcpUrl: `http://localhost:${port}/mcp`
+	};
+}
+/**
+* Stop the daemon by sending SIGTERM to the PID.
+*/
+async function stopDaemon() {
+	const pid = await readPidFile();
+	if (pid === null) return false;
+	if (!isProcessAlive(pid)) {
+		await cleanPidFiles();
+		return false;
+	}
+	try {
+		process.kill(pid, "SIGTERM");
+	} catch {}
+	for (let i = 0; i < 50; i++) {
+		await new Promise((r) => setTimeout(r, 100));
+		if (!isProcessAlive(pid)) {
+			await cleanPidFiles();
+			return true;
+		}
+	}
+	try {
+		process.kill(pid, "SIGKILL");
+	} catch {}
+	await cleanPidFiles();
+	return true;
+}
+/**
+* Spawn a detached daemon child process (`afs daemon _run`).
+*
+* The parent opens a log file, spawns the child detached, then polls for
+* the port file the child writes on successful startup.
+*
+* Returns DaemonInfo once the child is confirmed running, or throws on timeout.
+*/
+async function spawnDaemon(port) {
+	await ensureDaemonDir();
+	const logFd = await open(LOG_FILE, "w");
+	const fd = logFd.fd;
+	const args = [
+		...process.execArgv,
+		process.argv[1],
+		"service",
+		"_run",
+		"--port",
+		String(port)
+	];
+	const opts = {
+		detached: true,
+		stdio: [
+			"ignore",
+			fd,
+			fd
+		],
+		env: process.env
+	};
+	spawn(process.execPath, args, opts).unref();
+	await logFd.close();
+	const maxWait = 15e3;
+	const interval = 100;
+	const deadline = Date.now() + maxWait;
+	while (Date.now() < deadline) {
+		const info = await getDaemonStatus();
+		if (info) return info;
+		await new Promise((r) => setTimeout(r, interval));
+	}
+	throw new Error(`Daemon did not start within ${maxWait / 1e3}s — check ${LOG_FILE}`);
+}
+
+//#endregion
+export { cleanPidFiles, ensureDaemonDir, getDaemonStatus, getLogFile, spawnDaemon, stopDaemon, writePidFile, writePortFile };
+//# sourceMappingURL=manager.mjs.map

package/dist/daemon/manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.mjs","names":[],"sources":["../../src/daemon/manager.ts"],"sourcesContent":["/**\n * Daemon Process Manager\n *\n * Manages PID/port files in ~/.afs/ and provides daemon lifecycle operations.\n */\n\nimport { type SpawnOptions, spawn } from \"node:child_process\";\nimport { mkdir, open, readFile, rm, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface DaemonInfo {\n  pid: number;\n  port: number;\n  url: string;\n  mcpUrl: string;\n}\n\nconst DAEMON_DIR = join(homedir(), \".afs\");\nconst PID_FILE = join(DAEMON_DIR, \"daemon.pid\");\nconst PORT_FILE = join(DAEMON_DIR, \"daemon.port\");\nconst LOG_FILE = join(DAEMON_DIR, \"daemon.log\");\n\nexport function getDaemonDir(): string {\n  return DAEMON_DIR;\n}\n\nexport function getLogFile(): string {\n  return LOG_FILE;\n}\n\nexport async function ensureDaemonDir(): Promise<void> {\n  await mkdir(DAEMON_DIR, { recursive: true });\n}\n\nexport async function writePidFile(pid: number): Promise<void> {\n  await ensureDaemonDir();\n  await writeFile(PID_FILE, String(pid), \"utf-8\");\n}\n\nexport async function writePortFile(port: number): Promise<void> {\n  await ensureDaemonDir();\n  await writeFile(PORT_FILE, String(port), \"utf-8\");\n}\n\nexport async function readPidFile(): Promise<number | null> {\n  try {\n    const content = await readFile(PID_FILE, \"utf-8\");\n    const pid = Number.parseInt(content.trim(), 10);\n    return Number.isNaN(pid) ? null : pid;\n  } catch {\n    return null;\n  }\n}\n\nexport async function readPortFile(): Promise<number | null> {\n  try {\n    const content = await readFile(PORT_FILE, \"utf-8\");\n    const port = Number.parseInt(content.trim(), 10);\n    return Number.isNaN(port) ? null : port;\n  } catch {\n    return null;\n  }\n}\n\nexport async function cleanPidFiles(): Promise<void> {\n  try {\n    await rm(PID_FILE, { force: true });\n  } catch {\n    // ignore\n  }\n  try {\n    await rm(PORT_FILE, { force: true });\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Check if a process is alive by sending signal 0.\n */\nfunction isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Check if daemon is currently running.\n * Returns DaemonInfo if alive, null if not running (cleans stale PID files).\n */\nexport async function getDaemonStatus(): Promise<DaemonInfo | null> {\n  const pid = await readPidFile();\n  if (pid === null) return null;\n\n  if (!isProcessAlive(pid)) {\n    // Stale PID file — clean up\n    await cleanPidFiles();\n    return null;\n  }\n\n  const port = await readPortFile();\n  if (port === null) return null;\n\n  return {\n    pid,\n    port,\n    url: `http://localhost:${port}`,\n    mcpUrl: `http://localhost:${port}/mcp`,\n  };\n}\n\n/**\n * Stop the daemon by sending SIGTERM to the PID.\n */\nexport async function stopDaemon(): Promise<boolean> {\n  const pid = await readPidFile();\n  if (pid === null) return false;\n\n  if (!isProcessAlive(pid)) {\n    await cleanPidFiles();\n    return false;\n  }\n\n  try {\n    process.kill(pid, \"SIGTERM\");\n  } catch {\n    // Process may have already exited\n  }\n\n  // Wait for process to exit (up to 5 seconds)\n  for (let i = 0; i < 50; i++) {\n    await new Promise((r) => setTimeout(r, 100));\n    if (!isProcessAlive(pid)) {\n      await cleanPidFiles();\n      return true;\n    }\n  }\n\n  // Force kill if still alive\n  try {\n    process.kill(pid, \"SIGKILL\");\n  } catch {\n    // ignore\n  }\n  await cleanPidFiles();\n  return true;\n}\n\n/**\n * Spawn a detached daemon child process (`afs daemon _run`).\n *\n * The parent opens a log file, spawns the child detached, then polls for\n * the port file the child writes on successful startup.\n *\n * Returns DaemonInfo once the child is confirmed running, or throws on timeout.\n */\nexport async function spawnDaemon(port: number): Promise<DaemonInfo> {\n  await ensureDaemonDir();\n\n  // Truncate / create log file\n  const logFd = await open(LOG_FILE, \"w\");\n  const fd = logFd.fd;\n\n  // No --cwd: _run defaults to homedir() for config discovery.\n  // The daemon serves a global AFS instance, independent of caller's cwd.\n  const args = [...process.execArgv, process.argv[1]!, \"service\", \"_run\", \"--port\", String(port)];\n  const opts: SpawnOptions = {\n    detached: true,\n    stdio: [\"ignore\", fd, fd],\n    env: process.env,\n  };\n\n  const child = spawn(process.execPath, args, opts);\n  child.unref();\n\n  // Close our handle — the child inherited the fd\n  await logFd.close();\n\n  // Poll for port file (child writes it on successful startup)\n  const maxWait = 15_000;\n  const interval = 100;\n  const deadline = Date.now() + maxWait;\n\n  while (Date.now() < deadline) {\n    const info = await getDaemonStatus();\n    if (info) return info;\n    await new Promise((r) => setTimeout(r, interval));\n  }\n\n  throw new Error(`Daemon did not start within ${maxWait / 1000}s — check ${LOG_FILE}`);\n}\n"],"mappings":"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"}