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

package/dist/config/program-install.mjs

@@ -0,0 +1,444 @@
+import { AFS_USER_CONFIG_DIR_ENV, CONFIG_DIR_NAME } from "./loader.mjs";
+import { persistMount, unpersistMount } from "./mount-commands.mjs";
+import { execSync } from "node:child_process";
+import { cp, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
+import { homedir, tmpdir } from "node:os";
+import { isAbsolute, join, resolve } from "node:path";
+import { parseProgramManifest } from "@aigne/afs";
+
+//#region src/config/program-install.ts
+/**
+* Program Installation
+*
+* Business logic for installing, listing, and removing AFS programs.
+* Programs are installed to ~/.afs-config/programs/<id>/ and mounted
+* at /programs/<id> in the CWD config (same as `mount add`).
+*/
+/**
+* Get the user config directory.
+*/
+function getUserConfigDir(override) {
+	return override ?? process.env[AFS_USER_CONFIG_DIR_ENV] ?? join(homedir(), CONFIG_DIR_NAME);
+}
+/**
+* Detect the source type from a source string.
+*/
+function detectSourceType(source) {
+	if (source.endsWith(".zip")) return "zip";
+	if (source.startsWith("https://github.com/") || source.startsWith("http://github.com/") || source.startsWith("github.com/")) return "github";
+	return "local";
+}
+/**
+* Parse a GitHub URL into owner, repo, ref, and optional subdirectory.
+*/
+function parseGitHubURL(url) {
+	let normalized = url;
+	if (normalized.startsWith("github.com/")) normalized = `https://${normalized}`;
+	const match = normalized.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/tree\/([^/]+)\/(.+))?$/);
+	if (!match) return { cloneUrl: normalized.replace(/\/+$/, "") };
+	const [, owner, repo, _ref, subdir] = match;
+	return {
+		cloneUrl: `https://github.com/${owner}/${repo}.git`,
+		subdir: subdir || void 0
+	};
+}
+/**
+* Resolve a source to a local directory path containing program.yaml.
+* For github/zip sources, downloads/extracts to a temp directory.
+*
+* Returns [resolvedPath, tempDir?] — tempDir is set if caller should clean up.
+*/
+async function resolveSource(source, type, cwd) {
+	switch (type) {
+		case "local": {
+			const dirPath = isAbsolute(source) ? source : resolve(cwd, source);
+			try {
+				await readdir(dirPath);
+			} catch {
+				throw new Error(`Source directory does not exist: ${dirPath}`);
+			}
+			return [dirPath, void 0];
+		}
+		case "github": {
+			const { cloneUrl, subdir } = parseGitHubURL(source);
+			const tempDir = join(tmpdir(), `afs-install-${Date.now()}`);
+			await mkdir(tempDir, { recursive: true });
+			try {
+				execSync(`git clone --depth 1 ${cloneUrl} ${join(tempDir, "repo")}`, {
+					stdio: "pipe",
+					timeout: 6e4
+				});
+			} catch (err) {
+				await rm(tempDir, {
+					recursive: true,
+					force: true
+				});
+				const msg = err instanceof Error ? err.message : String(err);
+				throw new Error(`Failed to clone GitHub repository: ${msg}`);
+			}
+			return [subdir ? join(tempDir, "repo", subdir) : join(tempDir, "repo"), tempDir];
+		}
+		case "zip": {
+			const zipPath = isAbsolute(source) ? source : resolve(cwd, source);
+			const tempDir = join(tmpdir(), `afs-install-${Date.now()}`);
+			const extractDir = join(tempDir, "extracted");
+			await mkdir(extractDir, { recursive: true });
+			try {
+				const lines = execSync(`unzip -l "${zipPath}"`, {
+					encoding: "utf-8",
+					stdio: [
+						"pipe",
+						"pipe",
+						"pipe"
+					]
+				}).split("\n");
+				for (const line of lines) {
+					const trimmed = line.trim();
+					if (!trimmed || trimmed.startsWith("Archive:") || trimmed.startsWith("Length") || trimmed.startsWith("---")) continue;
+					const parts = trimmed.split(/\s+/);
+					if (parts.length >= 4) {
+						const name = parts.slice(3).join(" ");
+						if (name.includes("..") || name.startsWith("/")) {
+							await rm(tempDir, {
+								recursive: true,
+								force: true
+							});
+							throw new Error(`Zip file contains unsafe path: ${name}. Refusing to extract.`);
+						}
+					}
+				}
+			} catch (err) {
+				if (err instanceof Error && err.message.includes("unsafe path")) throw err;
+				await rm(tempDir, {
+					recursive: true,
+					force: true
+				});
+				const msg = err instanceof Error ? err.message : String(err);
+				throw new Error(`Failed to read zip file: ${msg}`);
+			}
+			try {
+				execSync(`unzip -o "${zipPath}" -d "${extractDir}"`, {
+					stdio: "pipe",
+					timeout: 3e4
+				});
+			} catch (err) {
+				await rm(tempDir, {
+					recursive: true,
+					force: true
+				});
+				const msg = err instanceof Error ? err.message : String(err);
+				throw new Error(`Failed to extract zip file: ${msg}`);
+			}
+			const entries = await readdir(extractDir);
+			if (entries.includes("program.yaml")) return [extractDir, tempDir];
+			if (entries.length === 1) {
+				const subPath = join(extractDir, entries[0]);
+				try {
+					if ((await readdir(subPath)).includes("program.yaml")) return [subPath, tempDir];
+				} catch {}
+			}
+			await rm(tempDir, {
+				recursive: true,
+				force: true
+			});
+			throw new Error("No program.yaml found in zip archive");
+		}
+		default: throw new Error(`Unsupported source type: ${type}`);
+	}
+}
+/**
+* Validate a directory contains a valid program.yaml.
+* Returns the parsed manifest.
+*/
+async function validateProgramDir(dirPath) {
+	const yamlPath = join(dirPath, "program.yaml");
+	let content;
+	try {
+		content = await readFile(yamlPath, "utf-8");
+	} catch {
+		throw new Error(`No program.yaml found in ${dirPath}`);
+	}
+	return parseProgramManifest(content);
+}
+/**
+* Install a program from a source (local dir, GitHub URL, or zip file).
+*/
+async function installProgram(source, options) {
+	const userConfigDir = getUserConfigDir(options?.userConfigDir);
+	const cwd = options?.cwd ?? process.cwd();
+	const [resolvedPath, tempDir] = await resolveSource(source, detectSourceType(source), cwd);
+	try {
+		const manifest = await validateProgramDir(resolvedPath);
+		const programsDir = join(userConfigDir, "programs");
+		const installPath = join(programsDir, manifest.id);
+		const mountPath = `/programs/${manifest.id}`;
+		await mkdir(programsDir, { recursive: true });
+		const tempInstallPath = `${installPath}.installing`;
+		await rm(tempInstallPath, {
+			recursive: true,
+			force: true
+		});
+		await cp(resolvedPath, tempInstallPath, { recursive: true });
+		await rm(installPath, {
+			recursive: true,
+			force: true
+		});
+		await rename(tempInstallPath, installPath);
+		await mkdir(join(userConfigDir, "data", manifest.id), { recursive: true });
+		await persistMount(cwd, {
+			path: mountPath,
+			uri: `fs://${installPath}`
+		});
+		const { notifyDaemonReload } = await import("../program/daemon-integration.mjs");
+		const { getDaemonStatus } = await import("../daemon/manager.mjs");
+		await notifyDaemonReload({ getDaemonStatus });
+		return {
+			success: true,
+			programId: manifest.id,
+			programName: manifest.name,
+			installPath,
+			mountPath
+		};
+	} finally {
+		if (tempDir) await rm(tempDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+/**
+* List installed programs by scanning ~/.afs-config/programs/.
+*/
+async function listInstalledPrograms(options) {
+	const programsDir = join(getUserConfigDir(options?.userConfigDir), "programs");
+	let entries;
+	try {
+		entries = await readdir(programsDir);
+	} catch {
+		return [];
+	}
+	const programs = [];
+	for (const entry of entries) {
+		const dirPath = join(programsDir, entry);
+		try {
+			const manifest = await validateProgramDir(dirPath);
+			programs.push({
+				id: manifest.id,
+				name: manifest.name,
+				entrypoint: manifest.entrypoint,
+				installPath: dirPath,
+				mountPath: `/programs/${manifest.id}`
+			});
+		} catch {}
+	}
+	return programs;
+}
+/**
+* Remove an installed program.
+*/
+async function removeProgram(programId, options) {
+	const userConfigDir = getUserConfigDir(options?.userConfigDir);
+	const cwd = options?.cwd ?? process.cwd();
+	const installPath = join(userConfigDir, "programs", programId);
+	try {
+		await readdir(installPath);
+	} catch {
+		throw new Error(`Program "${programId}" is not installed`);
+	}
+	await rm(installPath, {
+		recursive: true,
+		force: true
+	});
+	await unpersistMount(cwd, `/programs/${programId}`);
+	let purgedData = false;
+	if (options?.purge) {
+		await rm(join(userConfigDir, "data", programId), {
+			recursive: true,
+			force: true
+		});
+		purgedData = true;
+	}
+	const { notifyDaemonReload } = await import("../program/daemon-integration.mjs");
+	const { getDaemonStatus } = await import("../daemon/manager.mjs");
+	await notifyDaemonReload({ getDaemonStatus });
+	return {
+		success: true,
+		programId,
+		purgedData
+	};
+}
+/**
+* Read per-program mount overrides from mounts.toml.
+*
+* Location: ~/.afs-config/data/{programId}/mounts.toml
+*
+* Returns [] if the file is missing or invalid.
+*/
+async function readProgramMountOverrides(programId, options) {
+	const mountsPath = join(getUserConfigDir(options?.userConfigDir), "data", programId, "mounts.toml");
+	let content;
+	try {
+		content = await readFile(mountsPath, "utf-8");
+	} catch {
+		return [];
+	}
+	try {
+		const { parse } = await import("smol-toml");
+		const mounts = parse(content).mounts;
+		if (!Array.isArray(mounts)) return [];
+		const result = [];
+		for (const entry of mounts) {
+			if (typeof entry !== "object" || entry === null) continue;
+			const { path, uri, options: options$1 } = entry;
+			if (typeof path !== "string" || typeof uri !== "string") continue;
+			const override = {
+				target: path,
+				uri
+			};
+			if (options$1 && typeof options$1 === "object" && !Array.isArray(options$1)) {
+				const opts = options$1;
+				if (Object.keys(opts).length > 0) override.options = opts;
+			}
+			result.push(override);
+		}
+		return result;
+	} catch {
+		return [];
+	}
+}
+/**
+* Interactive configure flow for a program's mount dependencies.
+*
+* Uses the standard credential resolution flow (browser form / OAuth) for each
+* mount. Mounts with already-stored credentials are skipped silently.
+* After resolution, URI templates are rebuilt with collected values and
+* credentials are persisted under the final URI.
+*/
+async function configureProgramMounts(programId, options) {
+	const userConfigDir = getUserConfigDir(options?.userConfigDir);
+	const cwd = options?.cwd ?? process.cwd();
+	const manifest = await validateProgramDir(join(userConfigDir, "programs", programId));
+	const existingOverrides = await readProgramMountOverrides(programId, { userConfigDir });
+	const existingByTarget = new Map(existingOverrides.map((o) => [o.target, o]));
+	const { ProviderRegistry: ProviderRegistry$1 } = await import("@aigne/afs");
+	const { resolveCredentialsForMount } = await import("./credential-helpers.mjs");
+	const { createCLIAuthContext } = await import("../credential/cli-auth-context.mjs");
+	const { createCredentialStore } = await import("../credential/store.mjs");
+	const registry = new ProviderRegistry$1();
+	const authContext = createCLIAuthContext();
+	const credentialStore = createCredentialStore();
+	const configuredMounts = [];
+	const { getTemplateVariableNames } = await import("@aigne/afs/utils/uri-template");
+	for (const mountDecl of manifest.mounts) {
+		const existing = existingByTarget.get(mountDecl.target);
+		const startUri = existing?.uri || mountDecl.uri;
+		try {
+			const forceThis = options?.force === true || options?.force === "" || options?.force === mountDecl.target;
+			const result = await resolveCredentialsForMount({
+				cwd,
+				uri: startUri,
+				mountPath: mountDecl.target,
+				authContext,
+				credentialStore,
+				registry,
+				forceCollect: forceThis || void 0,
+				extraOptions: existing?.options
+			});
+			if (result) {
+				await result.persistCredentials();
+				const finalUri = result.resolvedUri || result.configUri || startUri;
+				const info = await registry.getProviderInfo(startUri);
+				const templateVars = new Set(info?.manifest?.uriTemplate ? getTemplateVariableNames(info.manifest.uriTemplate) : []);
+				const filteredOptions = {};
+				if (existing?.options) {
+					for (const [k, v] of Object.entries(existing.options)) if (!templateVars.has(k)) filteredOptions[k] = v;
+				}
+				if (result.collected) {
+					for (const [k, v] of Object.entries(result.nonSensitive)) if (!templateVars.has(k)) filteredOptions[k] = v;
+				}
+				const options$1 = Object.keys(filteredOptions).length > 0 ? filteredOptions : void 0;
+				configuredMounts.push({
+					target: mountDecl.target,
+					uri: finalUri,
+					options: options$1
+				});
+			} else configuredMounts.push({
+				target: mountDecl.target,
+				uri: startUri,
+				options: existing?.options
+			});
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			console.warn(`  Skipping ${mountDecl.target}: ${msg}`);
+			configuredMounts.push({
+				target: mountDecl.target,
+				uri: startUri,
+				options: existing?.options
+			});
+		}
+	}
+	const changedMounts = configuredMounts.filter((m) => {
+		const decl = manifest.mounts.find((d) => d.target === m.target);
+		return decl && (m.uri !== decl.uri || m.options && Object.keys(m.options).length > 0);
+	});
+	const dataDir = join(userConfigDir, "data", programId);
+	const mountsTomlPath = join(dataDir, "mounts.toml");
+	if (changedMounts.length > 0) {
+		await mkdir(dataDir, { recursive: true });
+		const { stringify } = await import("smol-toml");
+		await writeFile(mountsTomlPath, stringify({ mounts: changedMounts.map((m) => ({
+			path: m.target,
+			uri: m.uri,
+			...m.options && Object.keys(m.options).length > 0 ? { options: m.options } : {}
+		})) }), "utf-8");
+	} else try {
+		await rm(mountsTomlPath);
+	} catch {}
+	try {
+		const { notifyDaemonReload } = await import("../program/daemon-integration.mjs");
+		const { getDaemonStatus } = await import("../daemon/manager.mjs");
+		await notifyDaemonReload({ getDaemonStatus });
+	} catch {}
+	return {
+		success: true,
+		programId,
+		configuredMounts: changedMounts
+	};
+}
+/**
+* List configurable mounts and their current status for a program.
+*/
+async function listProgramMountStatus(programId, options) {
+	const userConfigDir = getUserConfigDir(options?.userConfigDir);
+	const manifest = await validateProgramDir(join(userConfigDir, "programs", programId));
+	const overrides = await readProgramMountOverrides(programId, { userConfigDir });
+	const overrideByTarget = new Map(overrides.map((o) => [o.target, o]));
+	const { createCredentialStore } = await import("../credential/store.mjs");
+	const credentialStore = createCredentialStore();
+	const mounts = [];
+	for (const mountDecl of manifest.mounts) {
+		const override = overrideByTarget.get(mountDecl.target);
+		const effectiveUri = override?.uri || mountDecl.uri;
+		let hasCredentials = false;
+		try {
+			const stored = await credentialStore.get(effectiveUri);
+			hasCredentials = !!stored && Object.keys(stored).length > 0;
+		} catch {}
+		mounts.push({
+			path: mountDecl.target,
+			uri: mountDecl.uri,
+			configuredUri: override?.uri !== mountDecl.uri ? override?.uri : void 0,
+			required: mountDecl.required,
+			hasCredentials,
+			hasOptions: !!(override?.options && Object.keys(override.options).length > 0)
+		});
+	}
+	return {
+		programId,
+		mounts
+	};
+}
+
+//#endregion
+export { configureProgramMounts, getUserConfigDir, installProgram, listInstalledPrograms, listProgramMountStatus, readProgramMountOverrides, removeProgram };
+//# sourceMappingURL=program-install.mjs.map

package/dist/config/program-install.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-install.mjs","names":["options","ProviderRegistry"],"sources":["../../src/config/program-install.ts"],"sourcesContent":["/**\n * Program Installation\n *\n * Business logic for installing, listing, and removing AFS programs.\n * Programs are installed to ~/.afs-config/programs/<id>/ and mounted\n * at /programs/<id> in the CWD config (same as `mount add`).\n */\n\nimport { execSync } from \"node:child_process\";\nimport { cp, mkdir, readdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { type MountOverride, type ProgramManifest, parseProgramManifest } from \"@aigne/afs\";\nimport { AFS_USER_CONFIG_DIR_ENV, CONFIG_DIR_NAME } from \"./loader.js\";\nimport { persistMount, unpersistMount } from \"./mount-commands.js\";\n\n// ─── Types ────────────────────────────────────────────────────────────────\n\nexport type SourceType = \"local\" | \"github\" | \"zip\";\n\nexport interface InstallResult {\n  success: boolean;\n  programId: string;\n  programName: string;\n  installPath: string;\n  mountPath: string;\n}\n\nexport interface InstalledProgram {\n  id: string;\n  name: string;\n  entrypoint: string;\n  installPath: string;\n  mountPath: string;\n}\n\nexport interface RemoveResult {\n  success: boolean;\n  programId: string;\n  purgedData: boolean;\n}\n\nexport interface InstallOptions {\n  /** Override user config dir (for testing) */\n  userConfigDir?: string;\n  /** CWD for persistMount (for testing) */\n  cwd?: string;\n}\n\nexport interface RemoveOptions extends InstallOptions {\n  /** Also remove program data directory */\n  purge?: boolean;\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────\n\n/**\n * Get the user config directory.\n */\nexport function getUserConfigDir(override?: string): string {\n  return override ?? process.env[AFS_USER_CONFIG_DIR_ENV] ?? join(homedir(), CONFIG_DIR_NAME);\n}\n\n/**\n * Detect the source type from a source string.\n */\nexport function detectSourceType(source: string): SourceType {\n  // ZIP file\n  if (source.endsWith(\".zip\")) {\n    return \"zip\";\n  }\n\n  // GitHub URL patterns\n  if (\n    source.startsWith(\"https://github.com/\") ||\n    source.startsWith(\"http://github.com/\") ||\n    source.startsWith(\"github.com/\")\n  ) {\n    return \"github\";\n  }\n\n  // Default: local directory\n  return \"local\";\n}\n\n/**\n * Parse a GitHub URL into owner, repo, ref, and optional subdirectory.\n */\nexport function parseGitHubURL(url: string): {\n  cloneUrl: string;\n  subdir?: string;\n} {\n  // Normalize: ensure https://\n  let normalized = url;\n  if (normalized.startsWith(\"github.com/\")) {\n    normalized = `https://${normalized}`;\n  }\n\n  // Parse: https://github.com/owner/repo[/tree/ref/subdir]\n  const match = normalized.match(\n    /^https?:\\/\\/github\\.com\\/([^/]+)\\/([^/]+?)(?:\\.git)?(?:\\/tree\\/([^/]+)\\/(.+))?$/,\n  );\n  if (!match) {\n    // Simple case: just owner/repo\n    return { cloneUrl: normalized.replace(/\\/+$/, \"\") };\n  }\n\n  const [, owner, repo, _ref, subdir] = match;\n  const cloneUrl = `https://github.com/${owner}/${repo}.git`;\n\n  return {\n    cloneUrl,\n    subdir: subdir || undefined,\n  };\n}\n\n/**\n * Resolve a source to a local directory path containing program.yaml.\n * For github/zip sources, downloads/extracts to a temp directory.\n *\n * Returns [resolvedPath, tempDir?] — tempDir is set if caller should clean up.\n */\nexport async function resolveSource(\n  source: string,\n  type: SourceType,\n  cwd: string,\n): Promise<[string, string | undefined]> {\n  switch (type) {\n    case \"local\": {\n      const dirPath = isAbsolute(source) ? source : resolve(cwd, source);\n      // Verify it's a directory by trying to read it\n      try {\n        await readdir(dirPath);\n      } catch {\n        throw new Error(`Source directory does not exist: ${dirPath}`);\n      }\n      return [dirPath, undefined];\n    }\n\n    case \"github\": {\n      const { cloneUrl, subdir } = parseGitHubURL(source);\n      const tempDir = join(tmpdir(), `afs-install-${Date.now()}`);\n      await mkdir(tempDir, { recursive: true });\n\n      try {\n        execSync(`git clone --depth 1 ${cloneUrl} ${join(tempDir, \"repo\")}`, {\n          stdio: \"pipe\",\n          timeout: 60000,\n        });\n      } catch (err) {\n        await rm(tempDir, { recursive: true, force: true });\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Failed to clone GitHub repository: ${msg}`);\n      }\n\n      const resolvedPath = subdir ? join(tempDir, \"repo\", subdir) : join(tempDir, \"repo\");\n      return [resolvedPath, tempDir];\n    }\n\n    case \"zip\": {\n      const zipPath = isAbsolute(source) ? source : resolve(cwd, source);\n      const tempDir = join(tmpdir(), `afs-install-${Date.now()}`);\n      const extractDir = join(tempDir, \"extracted\");\n      await mkdir(extractDir, { recursive: true });\n\n      // Security: check zip contents for path traversal before extracting\n      try {\n        const listing = execSync(`unzip -l \"${zipPath}\"`, {\n          encoding: \"utf-8\",\n          stdio: [\"pipe\", \"pipe\", \"pipe\"],\n        });\n        // Each line after header has format: \"  length  date  time  name\"\n        const lines = listing.split(\"\\n\");\n        for (const line of lines) {\n          const trimmed = line.trim();\n          // Skip header/footer lines\n          if (\n            !trimmed ||\n            trimmed.startsWith(\"Archive:\") ||\n            trimmed.startsWith(\"Length\") ||\n            trimmed.startsWith(\"---\")\n          )\n            continue;\n          // Extract filename (last column)\n          const parts = trimmed.split(/\\s+/);\n          if (parts.length >= 4) {\n            const name = parts.slice(3).join(\" \");\n            if (name.includes(\"..\") || name.startsWith(\"/\")) {\n              await rm(tempDir, { recursive: true, force: true });\n              throw new Error(`Zip file contains unsafe path: ${name}. Refusing to extract.`);\n            }\n          }\n        }\n      } catch (err) {\n        if (err instanceof Error && err.message.includes(\"unsafe path\")) {\n          throw err;\n        }\n        await rm(tempDir, { recursive: true, force: true });\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Failed to read zip file: ${msg}`);\n      }\n\n      // Extract\n      try {\n        execSync(`unzip -o \"${zipPath}\" -d \"${extractDir}\"`, {\n          stdio: \"pipe\",\n          timeout: 30000,\n        });\n      } catch (err) {\n        await rm(tempDir, { recursive: true, force: true });\n        const msg = err instanceof Error ? err.message : String(err);\n        throw new Error(`Failed to extract zip file: ${msg}`);\n      }\n\n      // Find program.yaml: might be at root or in a single subdirectory\n      const entries = await readdir(extractDir);\n      // Check if program.yaml is at extract root\n      if (entries.includes(\"program.yaml\")) {\n        return [extractDir, tempDir];\n      }\n      // Check single subdirectory\n      if (entries.length === 1) {\n        const subPath = join(extractDir, entries[0]!);\n        try {\n          const subEntries = await readdir(subPath);\n          if (subEntries.includes(\"program.yaml\")) {\n            return [subPath, tempDir];\n          }\n        } catch {\n          // not a directory\n        }\n      }\n\n      await rm(tempDir, { recursive: true, force: true });\n      throw new Error(\"No program.yaml found in zip archive\");\n    }\n\n    default:\n      throw new Error(`Unsupported source type: ${type}`);\n  }\n}\n\n/**\n * Validate a directory contains a valid program.yaml.\n * Returns the parsed manifest.\n */\nexport async function validateProgramDir(dirPath: string): Promise<ProgramManifest> {\n  const yamlPath = join(dirPath, \"program.yaml\");\n  let content: string;\n  try {\n    content = await readFile(yamlPath, \"utf-8\");\n  } catch {\n    throw new Error(`No program.yaml found in ${dirPath}`);\n  }\n\n  return parseProgramManifest(content);\n}\n\n// ─── Main Functions ───────────────────────────────────────────────────────\n\n/**\n * Install a program from a source (local dir, GitHub URL, or zip file).\n */\nexport async function installProgram(\n  source: string,\n  options?: InstallOptions,\n): Promise<InstallResult> {\n  const userConfigDir = getUserConfigDir(options?.userConfigDir);\n  const cwd = options?.cwd ?? process.cwd();\n  const type = detectSourceType(source);\n\n  // 1. Resolve source to local directory\n  const [resolvedPath, tempDir] = await resolveSource(source, type, cwd);\n\n  try {\n    // 2. Validate program.yaml\n    const manifest = await validateProgramDir(resolvedPath);\n\n    // 3. Determine install target\n    const programsDir = join(userConfigDir, \"programs\");\n    const installPath = join(programsDir, manifest.id);\n    const mountPath = `/programs/${manifest.id}`;\n\n    // 4. Atomic install: copy to temp location, swap\n    await mkdir(programsDir, { recursive: true });\n    const tempInstallPath = `${installPath}.installing`;\n\n    // Clean up any previous failed install\n    await rm(tempInstallPath, { recursive: true, force: true });\n\n    // Copy program files\n    await cp(resolvedPath, tempInstallPath, { recursive: true });\n\n    // Remove old version if exists, then rename\n    await rm(installPath, { recursive: true, force: true });\n    await rename(tempInstallPath, installPath);\n\n    // 5. Ensure data directory exists\n    const dataDir = join(userConfigDir, \"data\", manifest.id);\n    await mkdir(dataDir, { recursive: true });\n\n    // 6. Persist mount to CWD config (same as mount add)\n    await persistMount(cwd, {\n      path: mountPath,\n      uri: `fs://${installPath}`,\n    });\n\n    // 7. Notify daemon to reload programs (best-effort)\n    const { notifyDaemonReload } = await import(\"../program/daemon-integration.js\");\n    const { getDaemonStatus } = await import(\"../daemon/manager.js\");\n    await notifyDaemonReload({ getDaemonStatus });\n\n    return {\n      success: true,\n      programId: manifest.id,\n      programName: manifest.name,\n      installPath,\n      mountPath,\n    };\n  } finally {\n    // 8. Cleanup temp dir\n    if (tempDir) {\n      await rm(tempDir, { recursive: true, force: true });\n    }\n  }\n}\n\n/**\n * List installed programs by scanning ~/.afs-config/programs/.\n */\nexport async function listInstalledPrograms(options?: InstallOptions): Promise<InstalledProgram[]> {\n  const userConfigDir = getUserConfigDir(options?.userConfigDir);\n  const programsDir = join(userConfigDir, \"programs\");\n\n  let entries: string[];\n  try {\n    entries = await readdir(programsDir);\n  } catch {\n    return []; // programs/ directory doesn't exist yet\n  }\n\n  const programs: InstalledProgram[] = [];\n\n  for (const entry of entries) {\n    const dirPath = join(programsDir, entry);\n    try {\n      const manifest = await validateProgramDir(dirPath);\n      programs.push({\n        id: manifest.id,\n        name: manifest.name,\n        entrypoint: manifest.entrypoint,\n        installPath: dirPath,\n        mountPath: `/programs/${manifest.id}`,\n      });\n    } catch {\n      // Skip directories without valid program.yaml\n    }\n  }\n\n  return programs;\n}\n\n/**\n * Remove an installed program.\n */\nexport async function removeProgram(\n  programId: string,\n  options?: RemoveOptions,\n): Promise<RemoveResult> {\n  const userConfigDir = getUserConfigDir(options?.userConfigDir);\n  const cwd = options?.cwd ?? process.cwd();\n  const installPath = join(userConfigDir, \"programs\", programId);\n\n  // Verify program exists\n  try {\n    await readdir(installPath);\n  } catch {\n    throw new Error(`Program \"${programId}\" is not installed`);\n  }\n\n  // Remove program directory\n  await rm(installPath, { recursive: true, force: true });\n\n  // Remove mount from config (searches cwd → project → user)\n  await unpersistMount(cwd, `/programs/${programId}`);\n\n  // Optionally purge data\n  let purgedData = false;\n  if (options?.purge) {\n    const dataDir = join(userConfigDir, \"data\", programId);\n    await rm(dataDir, { recursive: true, force: true });\n    purgedData = true;\n  }\n\n  // Notify daemon to reload programs (best-effort)\n  const { notifyDaemonReload } = await import(\"../program/daemon-integration.js\");\n  const { getDaemonStatus } = await import(\"../daemon/manager.js\");\n  await notifyDaemonReload({ getDaemonStatus });\n\n  return {\n    success: true,\n    programId,\n    purgedData,\n  };\n}\n\n// ─── Mount Overrides (mounts.toml) ───────────────────────────────────────\n\n/**\n * Read per-program mount overrides from mounts.toml.\n *\n * Location: ~/.afs-config/data/{programId}/mounts.toml\n *\n * Returns [] if the file is missing or invalid.\n */\nexport async function readProgramMountOverrides(\n  programId: string,\n  options?: { userConfigDir?: string },\n): Promise<MountOverride[]> {\n  const userConfigDir = getUserConfigDir(options?.userConfigDir);\n  const mountsPath = join(userConfigDir, \"data\", programId, \"mounts.toml\");\n\n  let content: string;\n  try {\n    content = await readFile(mountsPath, \"utf-8\");\n  } catch {\n    return []; // File doesn't exist yet\n  }\n\n  try {\n    const { parse } = await import(\"smol-toml\");\n    const parsed = parse(content);\n    const mounts = parsed.mounts;\n    if (!Array.isArray(mounts)) return [];\n\n    const result: MountOverride[] = [];\n    for (const entry of mounts) {\n      if (typeof entry !== \"object\" || entry === null) continue;\n      const { path, uri, options } = entry as Record<string, unknown>;\n      if (typeof path !== \"string\" || typeof uri !== \"string\") continue;\n      const override: MountOverride = { target: path, uri };\n      if (options && typeof options === \"object\" && !Array.isArray(options)) {\n        const opts = options as Record<string, unknown>;\n        if (Object.keys(opts).length > 0) {\n          override.options = opts;\n        }\n      }\n      result.push(override);\n    }\n    return result;\n  } catch {\n    return []; // Invalid TOML\n  }\n}\n\n// ─── Configure Flow ──────────────────────────────────────────────────────\n\nexport interface ConfigureOptions {\n  userConfigDir?: string;\n  cwd?: string;\n  /** Force re-collection: true/\"\" = all mounts, string = specific mount path */\n  force?: string | boolean;\n}\n\nexport interface ConfigureResult {\n  success: boolean;\n  programId: string;\n  configuredMounts: Array<{ target: string; uri: string }>;\n}\n\n/**\n * Interactive configure flow for a program's mount dependencies.\n *\n * Uses the standard credential resolution flow (browser form / OAuth) for each\n * mount. Mounts with already-stored credentials are skipped silently.\n * After resolution, URI templates are rebuilt with collected values and\n * credentials are persisted under the final URI.\n */\nexport async function configureProgramMounts(\n  programId: string,\n  options?: ConfigureOptions,\n): Promise<ConfigureResult> {\n  const userConfigDir = getUserConfigDir(options?.userConfigDir);\n  const cwd = options?.cwd ?? process.cwd();\n\n  // 1. Read program.yaml\n  const installPath = join(userConfigDir, \"programs\", programId);\n  const manifest = await validateProgramDir(installPath);\n\n  // 2. Read existing mounts.toml (if any)\n  const existingOverrides = await readProgramMountOverrides(programId, { userConfigDir });\n  const existingByTarget = new Map(existingOverrides.map((o) => [o.target, o]));\n\n  // 3. Lazy imports\n  const { ProviderRegistry } = await import(\"@aigne/afs\");\n  const { resolveCredentialsForMount } = await import(\"./credential-helpers.js\");\n  const { createCLIAuthContext } = await import(\"../credential/cli-auth-context.js\");\n  const { createCredentialStore } = await import(\"../credential/store.js\");\n\n  const registry = new ProviderRegistry();\n  const authContext = createCLIAuthContext();\n  const credentialStore = createCredentialStore();\n\n  const configuredMounts: Array<{\n    target: string;\n    uri: string;\n    options?: Record<string, unknown>;\n  }> = [];\n\n  const { getTemplateVariableNames } = await import(\"@aigne/afs/utils/uri-template\");\n\n  for (const mountDecl of manifest.mounts) {\n    const existing = existingByTarget.get(mountDecl.target);\n    const startUri = existing?.uri || mountDecl.uri;\n\n    try {\n      const forceThis =\n        options?.force === true || options?.force === \"\" || options?.force === mountDecl.target;\n\n      const result = await resolveCredentialsForMount({\n        cwd,\n        uri: startUri,\n        mountPath: mountDecl.target,\n        authContext,\n        credentialStore,\n        registry,\n        forceCollect: forceThis || undefined,\n        extraOptions: existing?.options,\n      });\n\n      if (result) {\n        await result.persistCredentials();\n        const finalUri = result.resolvedUri || result.configUri || startUri;\n\n        // Filter options: exclude sensitive fields and URI template vars (already in URI)\n        const info = await registry.getProviderInfo(startUri);\n        const templateVars = new Set(\n          info?.manifest?.uriTemplate ? getTemplateVariableNames(info.manifest.uriTemplate) : [],\n        );\n        const filteredOptions: Record<string, unknown> = {};\n        // Preserve existing options from mounts.toml\n        if (existing?.options) {\n          for (const [k, v] of Object.entries(existing.options)) {\n            if (!templateVars.has(k)) filteredOptions[k] = v;\n          }\n        }\n        // Merge newly collected non-sensitive options (overrides existing)\n        if (result.collected) {\n          for (const [k, v] of Object.entries(result.nonSensitive)) {\n            if (!templateVars.has(k)) filteredOptions[k] = v;\n          }\n        }\n\n        const options = Object.keys(filteredOptions).length > 0 ? filteredOptions : undefined;\n        configuredMounts.push({ target: mountDecl.target, uri: finalUri, options });\n      } else {\n        // No schema/credentials needed — preserve existing options\n        configuredMounts.push({\n          target: mountDecl.target,\n          uri: startUri,\n          options: existing?.options,\n        });\n      }\n    } catch (err) {\n      // Credential resolution failed or user cancelled — keep what we have\n      const msg = err instanceof Error ? err.message : String(err);\n      console.warn(`  Skipping ${mountDecl.target}: ${msg}`);\n      configuredMounts.push({\n        target: mountDecl.target,\n        uri: startUri,\n        options: existing?.options,\n      });\n    }\n  }\n\n  // 4. Write mounts.toml for mounts whose URI or options changed from program.yaml\n  const changedMounts = configuredMounts.filter((m) => {\n    const decl = manifest.mounts.find((d: { target: string }) => d.target === m.target);\n    return decl && (m.uri !== decl.uri || (m.options && Object.keys(m.options).length > 0));\n  });\n\n  const dataDir = join(userConfigDir, \"data\", programId);\n  const mountsTomlPath = join(dataDir, \"mounts.toml\");\n\n  if (changedMounts.length > 0) {\n    await mkdir(dataDir, { recursive: true });\n\n    const { stringify } = await import(\"smol-toml\");\n    const tomlContent = stringify({\n      mounts: changedMounts.map((m) => ({\n        path: m.target,\n        uri: m.uri,\n        ...(m.options && Object.keys(m.options).length > 0 ? { options: m.options } : {}),\n      })),\n    });\n    await writeFile(mountsTomlPath, tomlContent, \"utf-8\");\n  } else {\n    // All mounts match program.yaml defaults — remove stale overrides\n    try {\n      await rm(mountsTomlPath);\n    } catch {\n      // File doesn't exist — nothing to clean up\n    }\n  }\n\n  // 5. Notify daemon to reload\n  try {\n    const { notifyDaemonReload } = await import(\"../program/daemon-integration.js\");\n    const { getDaemonStatus } = await import(\"../daemon/manager.js\");\n    await notifyDaemonReload({ getDaemonStatus });\n  } catch {\n    // Best-effort\n  }\n\n  return {\n    success: true,\n    programId,\n    configuredMounts: changedMounts,\n  };\n}\n\n// ─── Mount Status Listing ─────────────────────────────────────────────────\n\nexport interface MountStatus {\n  /** Mount target path, e.g. \"/telegram\" */\n  path: string;\n  /** URI from program.yaml */\n  uri: string;\n  /** Overridden URI from mounts.toml (if different from program.yaml) */\n  configuredUri?: string;\n  /** Whether this mount is required */\n  required: boolean;\n  /** Whether credentials are stored for this mount's effective URI */\n  hasCredentials: boolean;\n  /** Whether mounts.toml has options for this mount */\n  hasOptions: boolean;\n}\n\n/**\n * List configurable mounts and their current status for a program.\n */\nexport async function listProgramMountStatus(\n  programId: string,\n  options?: { userConfigDir?: string },\n): Promise<{ programId: string; mounts: MountStatus[] }> {\n  const userConfigDir = getUserConfigDir(options?.userConfigDir);\n  const installPath = join(userConfigDir, \"programs\", programId);\n  const manifest = await validateProgramDir(installPath);\n\n  const overrides = await readProgramMountOverrides(programId, { userConfigDir });\n  const overrideByTarget = new Map(overrides.map((o) => [o.target, o]));\n\n  const { createCredentialStore } = await import(\"../credential/store.js\");\n  const credentialStore = createCredentialStore();\n\n  const mounts: MountStatus[] = [];\n  for (const mountDecl of manifest.mounts) {\n    const override = overrideByTarget.get(mountDecl.target);\n    const effectiveUri = override?.uri || mountDecl.uri;\n\n    let hasCredentials = false;\n    try {\n      const stored = await credentialStore.get(effectiveUri);\n      hasCredentials = !!stored && Object.keys(stored).length > 0;\n    } catch {\n      // Non-fatal\n    }\n\n    mounts.push({\n      path: mountDecl.target,\n      uri: mountDecl.uri,\n      configuredUri: override?.uri !== mountDecl.uri ? override?.uri : undefined,\n      required: mountDecl.required,\n      hasCredentials,\n      hasOptions: !!(override?.options && Object.keys(override.options).length > 0),\n    });\n  }\n\n  return { programId, mounts };\n}\n"],"mappings":"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"}

package/dist/core/commands/connect.cjs

@@ -0,0 +1,53 @@
+const require_index = require('../../ui/index.cjs');
+
+//#region src/core/commands/connect.ts
+/** No-op formatter for lifecycle commands that manage their own output. */
+const noopFormat = () => "";
+function createConnectCommand(options) {
+	return {
+		command: "connect",
+		describe: "Start service and open web explorer",
+		builder: { port: {
+			type: "number",
+			default: 4900,
+			description: "Port for service"
+		} },
+		handler: async (argv) => {
+			const { getDaemonStatus, spawnDaemon } = await Promise.resolve().then(() => require("../../daemon/manager.cjs"));
+			let info = await getDaemonStatus();
+			if (info) console.log(`${require_index.colors.green("Service already running")} on port ${info.port}`);
+			else {
+				console.log(require_index.colors.dim("Starting AFS service..."));
+				try {
+					info = await spawnDaemon(argv.port);
+					console.log(require_index.colors.green("AFS Service started"));
+					console.log(`  ${require_index.colors.dim("PID:")}  ${info.pid}`);
+					console.log(`  ${require_index.colors.dim("Port:")} ${info.port}`);
+				} catch (err) {
+					console.error(require_index.colors.red(`Failed to start service: ${err.message}`));
+					options.onResult({
+						command: "connect",
+						result: null,
+						format: noopFormat
+					});
+					process.exitCode = 1;
+					return;
+				}
+			}
+			console.log(`  ${require_index.colors.dim("URL:")}  ${require_index.colors.brightCyan(info.url)}`);
+			openBrowser(info.url);
+			options.onResult({
+				command: "connect",
+				result: null,
+				format: noopFormat
+			});
+		}
+	};
+}
+function openBrowser(url) {
+	const { exec } = require("node:child_process");
+	exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"} ${url}`);
+}
+
+//#endregion
+exports.createConnectCommand = createConnectCommand;

package/dist/core/commands/connect.d.mts

@@ -0,0 +1,2 @@
+import "./types.mjs";
+import { CommandModule } from "yargs";

package/dist/core/commands/connect.mjs

@@ -0,0 +1,55 @@
+import { __require } from "../../_virtual/rolldown_runtime.mjs";
+import { colors } from "../../ui/index.mjs";
+
+//#region src/core/commands/connect.ts
+/** No-op formatter for lifecycle commands that manage their own output. */
+const noopFormat = () => "";
+function createConnectCommand(options) {
+	return {
+		command: "connect",
+		describe: "Start service and open web explorer",
+		builder: { port: {
+			type: "number",
+			default: 4900,
+			description: "Port for service"
+		} },
+		handler: async (argv) => {
+			const { getDaemonStatus, spawnDaemon } = await import("../../daemon/manager.mjs");
+			let info = await getDaemonStatus();
+			if (info) console.log(`${colors.green("Service already running")} on port ${info.port}`);
+			else {
+				console.log(colors.dim("Starting AFS service..."));
+				try {
+					info = await spawnDaemon(argv.port);
+					console.log(colors.green("AFS Service started"));
+					console.log(`  ${colors.dim("PID:")}  ${info.pid}`);
+					console.log(`  ${colors.dim("Port:")} ${info.port}`);
+				} catch (err) {
+					console.error(colors.red(`Failed to start service: ${err.message}`));
+					options.onResult({
+						command: "connect",
+						result: null,
+						format: noopFormat
+					});
+					process.exitCode = 1;
+					return;
+				}
+			}
+			console.log(`  ${colors.dim("URL:")}  ${colors.brightCyan(info.url)}`);
+			openBrowser(info.url);
+			options.onResult({
+				command: "connect",
+				result: null,
+				format: noopFormat
+			});
+		}
+	};
+}
+function openBrowser(url) {
+	const { exec } = __require("node:child_process");
+	exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"} ${url}`);
+}
+
+//#endregion
+export { createConnectCommand };
+//# sourceMappingURL=connect.mjs.map

package/dist/core/commands/connect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.mjs","names":[],"sources":["../../../src/core/commands/connect.ts"],"sourcesContent":["/**\n * AFS Connect Command\n *\n * One-command experience: starts service (if not running) + opens browser + exits.\n * This is the primary user entry point.\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { colors } from \"../../ui/index.js\";\nimport type { CommandFactoryOptions } from \"./types.js\";\n\nexport interface ConnectArgs {\n  port: number;\n}\n\n/** No-op formatter for lifecycle commands that manage their own output. */\nconst noopFormat = () => \"\";\n\nexport function createConnectCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ConnectArgs> {\n  return {\n    command: \"connect\",\n    describe: \"Start service and open web explorer\",\n    builder: {\n      port: {\n        type: \"number\",\n        default: 4900,\n        description: \"Port for service\",\n      },\n    },\n    handler: async (argv) => {\n      const { getDaemonStatus, spawnDaemon } = await import(\"../../daemon/manager.js\");\n\n      let info = await getDaemonStatus();\n\n      if (info) {\n        console.log(`${colors.green(\"Service already running\")} on port ${info.port}`);\n      } else {\n        console.log(colors.dim(\"Starting AFS service...\"));\n        try {\n          info = await spawnDaemon(argv.port);\n          console.log(colors.green(\"AFS Service started\"));\n          console.log(`  ${colors.dim(\"PID:\")}  ${info.pid}`);\n          console.log(`  ${colors.dim(\"Port:\")} ${info.port}`);\n        } catch (err) {\n          console.error(colors.red(`Failed to start service: ${(err as Error).message}`));\n          options.onResult({ command: \"connect\", result: null, format: noopFormat });\n          process.exitCode = 1;\n          return;\n        }\n      }\n\n      console.log(`  ${colors.dim(\"URL:\")}  ${colors.brightCyan(info.url)}`);\n      openBrowser(info.url);\n\n      // Signal executor that command ran (output already printed above)\n      options.onResult({ command: \"connect\", result: null, format: noopFormat });\n    },\n  };\n}\n\nfunction openBrowser(url: string): void {\n  const { exec } = require(\"node:child_process\") as typeof import(\"node:child_process\");\n  const cmd =\n    process.platform === \"darwin\" ? \"open\" : process.platform === \"win32\" ? \"start\" : \"xdg-open\";\n  exec(`${cmd} ${url}`);\n}\n"],"mappings":";;;;;AAgBA,MAAM,mBAAmB;AAEzB,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GACJ,MAAM;GACN,SAAS;GACT,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,EAAE,iBAAiB,gBAAgB,MAAM,OAAO;GAEtD,IAAI,OAAO,MAAM,iBAAiB;AAElC,OAAI,KACF,SAAQ,IAAI,GAAG,OAAO,MAAM,0BAA0B,CAAC,WAAW,KAAK,OAAO;QACzE;AACL,YAAQ,IAAI,OAAO,IAAI,0BAA0B,CAAC;AAClD,QAAI;AACF,YAAO,MAAM,YAAY,KAAK,KAAK;AACnC,aAAQ,IAAI,OAAO,MAAM,sBAAsB,CAAC;AAChD,aAAQ,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;AACnD,aAAQ,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO;aAC7C,KAAK;AACZ,aAAQ,MAAM,OAAO,IAAI,4BAA6B,IAAc,UAAU,CAAC;AAC/E,aAAQ,SAAS;MAAE,SAAS;MAAW,QAAQ;MAAM,QAAQ;MAAY,CAAC;AAC1E,aAAQ,WAAW;AACnB;;;AAIJ,WAAQ,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,OAAO,WAAW,KAAK,IAAI,GAAG;AACtE,eAAY,KAAK,IAAI;AAGrB,WAAQ,SAAS;IAAE,SAAS;IAAW,QAAQ;IAAM,QAAQ;IAAY,CAAC;;EAE7E;;AAGH,SAAS,YAAY,KAAmB;CACtC,MAAM,EAAE,mBAAiB,qBAAqB;AAG9C,MAAK,GADH,QAAQ,aAAa,WAAW,SAAS,QAAQ,aAAa,UAAU,UAAU,WACxE,GAAG,MAAM"}