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

package/dist/core/commands/explore.mjs

@@ -8,20 +8,55 @@ import { VERSION } from "../../version.mjs";
 function createExploreCommand(options) {
 	return {
 		command: "explore [path]",
-		describe: "Interactive TUI explorer",
-		builder: { path: {
-			type: "string",
-			default: "/",
-			description: "Starting path"
-		} },
+		describe: "Interactive explorer (TUI or web)",
+		builder: {
+			path: {
+				type: "string",
+				default: "/",
+				description: "Starting path"
+			},
+			web: {
+				type: "boolean",
+				default: false,
+				description: "Launch web-based explorer"
+			},
+			port: {
+				type: "number",
+				default: 0,
+				description: "Port for web explorer (0 = auto)"
+			}
+		},
 		handler: async (argv) => {
 			const afs = await resolveAFS(options);
-			const { createExplorerScreen } = await import("../../explorer/screen.mjs");
-			await createExplorerScreen({
-				afs,
-				startPath: argv.path,
-				version: VERSION
-			});
+			if (argv.web) {
+				const { startExplorer } = await import("@aigne/afs-explorer");
+				const { resolve } = await import("node:path");
+				let webRoot;
+				try {
+					const { createRequire } = await import("node:module");
+					webRoot = resolve(createRequire(import.meta.url).resolve("@aigne/afs-explorer/package.json"), "..", "web");
+				} catch {}
+				const info = await startExplorer(afs, {
+					port: argv.port,
+					host: "localhost",
+					webRoot,
+					open: true
+				});
+				console.log(`AFS Explorer running at ${info.url}`);
+				console.log("Press Ctrl+C to stop");
+				process.on("SIGINT", () => {
+					info.stop();
+					process.exit(0);
+				});
+				await new Promise(() => {});
+			} else {
+				const { createExplorerScreen } = await import("../../explorer/screen.mjs");
+				await createExplorerScreen({
+					afs,
+					startPath: argv.path,
+					version: VERSION
+				});
+			}
 		}
 	};
 }

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

@@ -1 +1 @@
-{"version":3,"file":"explore.mjs","names":[],"sources":["../../../src/core/commands/explore.ts"],"sourcesContent":["/**\n * AFS Explore Command\n *\n * Interactive TUI explorer for AFS\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { VERSION } from \"../../version.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\nexport interface ExploreArgs {\n  path: string;\n}\n\n/**\n * Create explore command\n */\nexport function createExploreCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExploreArgs> {\n  return {\n    command: \"explore [path]\",\n    describe: \"Interactive TUI explorer\",\n    builder: {\n      path: { type: \"string\", default: \"/\", description: \"Starting path\" },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const { createExplorerScreen } = await import(\"../../explorer/screen.js\");\n      await createExplorerScreen({ afs, startPath: argv.path, version: VERSION });\n    },\n  };\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GAAE,MAAM;GAAU,SAAS;GAAK,aAAa;GAAiB,EACrE;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAC9C,SAAM,qBAAqB;IAAE;IAAK,WAAW,KAAK;IAAM,SAAS;IAAS,CAAC;;EAE9E"}
+{"version":3,"file":"explore.mjs","names":[],"sources":["../../../src/core/commands/explore.ts"],"sourcesContent":["/**\n * AFS Explore Command\n *\n * Interactive TUI explorer or web-based explorer for AFS\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { VERSION } from \"../../version.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\nexport interface ExploreArgs {\n  path: string;\n  web: boolean;\n  port: number;\n}\n\n/**\n * Create explore command\n */\nexport function createExploreCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExploreArgs> {\n  return {\n    command: \"explore [path]\",\n    describe: \"Interactive explorer (TUI or web)\",\n    builder: {\n      path: { type: \"string\", default: \"/\", description: \"Starting path\" },\n      web: { type: \"boolean\", default: false, description: \"Launch web-based explorer\" },\n      port: { type: \"number\", default: 0, description: \"Port for web explorer (0 = auto)\" },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n\n      if (argv.web) {\n        const { startExplorer } = await import(\"@aigne/afs-explorer\");\n        const { resolve } = await import(\"node:path\");\n\n        // Locate web assets: try node_modules first, then relative path\n        let webRoot: string | undefined;\n        try {\n          const { createRequire } = await import(\"node:module\");\n          const req = createRequire(import.meta.url);\n          const explorerPkg = req.resolve(\"@aigne/afs-explorer/package.json\");\n          webRoot = resolve(explorerPkg, \"..\", \"web\");\n        } catch {\n          // Fallback — not critical if embedded assets are used\n        }\n\n        const info = await startExplorer(afs, {\n          port: argv.port,\n          host: \"localhost\",\n          webRoot,\n          open: true,\n        });\n\n        console.log(`AFS Explorer running at ${info.url}`);\n        console.log(\"Press Ctrl+C to stop\");\n\n        // Keep process alive\n        process.on(\"SIGINT\", () => {\n          info.stop();\n          process.exit(0);\n        });\n        await new Promise(() => {});\n      } else {\n        const { createExplorerScreen } = await import(\"../../explorer/screen.js\");\n        await createExplorerScreen({ afs, startPath: argv.path, version: VERSION });\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;GACP,MAAM;IAAE,MAAM;IAAU,SAAS;IAAK,aAAa;IAAiB;GACpE,KAAK;IAAE,MAAM;IAAW,SAAS;IAAO,aAAa;IAA6B;GAClF,MAAM;IAAE,MAAM;IAAU,SAAS;IAAG,aAAa;IAAoC;GACtF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;AAErC,OAAI,KAAK,KAAK;IACZ,MAAM,EAAE,kBAAkB,MAAM,OAAO;IACvC,MAAM,EAAE,YAAY,MAAM,OAAO;IAGjC,IAAI;AACJ,QAAI;KACF,MAAM,EAAE,kBAAkB,MAAM,OAAO;AAGvC,eAAU,QAFE,cAAc,OAAO,KAAK,IAAI,CAClB,QAAQ,mCAAmC,EACpC,MAAM,MAAM;YACrC;IAIR,MAAM,OAAO,MAAM,cAAc,KAAK;KACpC,MAAM,KAAK;KACX,MAAM;KACN;KACA,MAAM;KACP,CAAC;AAEF,YAAQ,IAAI,2BAA2B,KAAK,MAAM;AAClD,YAAQ,IAAI,uBAAuB;AAGnC,YAAQ,GAAG,gBAAgB;AACzB,UAAK,MAAM;AACX,aAAQ,KAAK,EAAE;MACf;AACF,UAAM,IAAI,cAAc,GAAG;UACtB;IACL,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAC9C,UAAM,qBAAqB;KAAE;KAAK,WAAW,KAAK;KAAM,SAAS;KAAS,CAAC;;;EAGhF"}

package/dist/core/commands/gen-agent-md.cjs

@@ -0,0 +1,126 @@
+
+//#region src/core/commands/gen-agent-md.ts
+/**
+* Generate AGENT.md content from manifest and optional treeSchema.
+*
+* Exported for direct use in tests and other tools.
+*/
+function generateAgentMd(manifest, treeSchema) {
+	const lines = [];
+	lines.push("---");
+	lines.push(`name: ${manifest.name}`);
+	lines.push(`category: ${manifest.category}`);
+	lines.push(`uri: ${manifest.uriTemplate}`);
+	if (treeSchema) {
+		lines.push("operations:");
+		for (const op of treeSchema.operations) lines.push(`  - ${op}`);
+	}
+	if (manifest.tags?.length) {
+		lines.push("tags:");
+		for (const tag of manifest.tags) lines.push(`  - ${tag}`);
+	}
+	if (treeSchema?.auth) {
+		lines.push(`auth: ${treeSchema.auth.type}`);
+		if (treeSchema.auth.env?.length) {
+			lines.push("auth_env:");
+			for (const env of treeSchema.auth.env) lines.push(`  - ${env}`);
+		}
+	}
+	lines.push("---");
+	lines.push("");
+	lines.push(`# ${manifest.name}`);
+	lines.push("");
+	lines.push(manifest.description);
+	lines.push("");
+	if (treeSchema) {
+		lines.push("## Path Structure");
+		lines.push("");
+		for (const [path, node] of Object.entries(treeSchema.tree)) {
+			let line = `- \`${path}\` — ${node.kind}`;
+			if (node.actions?.length) line += ` (actions: ${node.actions.join(", ")})`;
+			if (node.destructive?.length) line += ` **[destructive: ${node.destructive.join(", ")}]**`;
+			lines.push(line);
+		}
+		lines.push("");
+	}
+	if (manifest.useCases?.length) {
+		lines.push("## Use Cases");
+		lines.push("");
+		for (const uc of manifest.useCases) lines.push(`- ${uc}`);
+		lines.push("");
+	}
+	if (treeSchema?.bestFor?.length) {
+		lines.push("## Best For");
+		lines.push("");
+		for (const item of treeSchema.bestFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	if (treeSchema?.notFor?.length) {
+		lines.push("## Not Recommended For");
+		lines.push("");
+		for (const item of treeSchema.notFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+const formatGenAgentMd = (result) => {
+	if (typeof result === "string") return result;
+	return JSON.stringify(result, null, 2);
+};
+function createGenAgentMdCommand(options) {
+	return {
+		command: "gen-agent-md <provider>",
+		describe: "Generate .afs/AGENT.md for a provider package",
+		builder: { provider: {
+			type: "string",
+			description: "Provider package name (e.g., @aigne/afs-sqlite) or directory path",
+			demandOption: true
+		} },
+		handler: async (argv) => {
+			try {
+				const providerPath = argv.provider;
+				const mod = await import(providerPath);
+				let manifest;
+				let treeSchema;
+				for (const key of Object.keys(mod)) {
+					const val = mod[key];
+					if (typeof val !== "function") continue;
+					if (typeof val.manifest !== "function") continue;
+					const result = val.manifest();
+					const m = Array.isArray(result) ? result[0] : result;
+					if (m?.name) {
+						manifest = m;
+						if (typeof val.treeSchema === "function") treeSchema = val.treeSchema();
+						break;
+					}
+				}
+				if (!manifest) {
+					options.onResult({
+						command: "gen-agent-md",
+						result: null,
+						format: formatGenAgentMd,
+						error: { message: `No provider class with static manifest() found in ${providerPath}` }
+					});
+					return;
+				}
+				const content = generateAgentMd(manifest, treeSchema);
+				options.onResult({
+					command: "gen-agent-md",
+					result: content,
+					format: formatGenAgentMd
+				});
+			} catch (err) {
+				options.onResult({
+					command: "gen-agent-md",
+					result: null,
+					format: formatGenAgentMd,
+					error: { message: `Failed to generate AGENT.md: ${err}` }
+				});
+			}
+		}
+	};
+}
+
+//#endregion
+exports.createGenAgentMdCommand = createGenAgentMdCommand;
+exports.generateAgentMd = generateAgentMd;

package/dist/core/commands/gen-agent-md.d.mts

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

package/dist/core/commands/gen-agent-md.mjs

@@ -0,0 +1,125 @@
+//#region src/core/commands/gen-agent-md.ts
+/**
+* Generate AGENT.md content from manifest and optional treeSchema.
+*
+* Exported for direct use in tests and other tools.
+*/
+function generateAgentMd(manifest, treeSchema) {
+	const lines = [];
+	lines.push("---");
+	lines.push(`name: ${manifest.name}`);
+	lines.push(`category: ${manifest.category}`);
+	lines.push(`uri: ${manifest.uriTemplate}`);
+	if (treeSchema) {
+		lines.push("operations:");
+		for (const op of treeSchema.operations) lines.push(`  - ${op}`);
+	}
+	if (manifest.tags?.length) {
+		lines.push("tags:");
+		for (const tag of manifest.tags) lines.push(`  - ${tag}`);
+	}
+	if (treeSchema?.auth) {
+		lines.push(`auth: ${treeSchema.auth.type}`);
+		if (treeSchema.auth.env?.length) {
+			lines.push("auth_env:");
+			for (const env of treeSchema.auth.env) lines.push(`  - ${env}`);
+		}
+	}
+	lines.push("---");
+	lines.push("");
+	lines.push(`# ${manifest.name}`);
+	lines.push("");
+	lines.push(manifest.description);
+	lines.push("");
+	if (treeSchema) {
+		lines.push("## Path Structure");
+		lines.push("");
+		for (const [path, node] of Object.entries(treeSchema.tree)) {
+			let line = `- \`${path}\` — ${node.kind}`;
+			if (node.actions?.length) line += ` (actions: ${node.actions.join(", ")})`;
+			if (node.destructive?.length) line += ` **[destructive: ${node.destructive.join(", ")}]**`;
+			lines.push(line);
+		}
+		lines.push("");
+	}
+	if (manifest.useCases?.length) {
+		lines.push("## Use Cases");
+		lines.push("");
+		for (const uc of manifest.useCases) lines.push(`- ${uc}`);
+		lines.push("");
+	}
+	if (treeSchema?.bestFor?.length) {
+		lines.push("## Best For");
+		lines.push("");
+		for (const item of treeSchema.bestFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	if (treeSchema?.notFor?.length) {
+		lines.push("## Not Recommended For");
+		lines.push("");
+		for (const item of treeSchema.notFor) lines.push(`- ${item}`);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+const formatGenAgentMd = (result) => {
+	if (typeof result === "string") return result;
+	return JSON.stringify(result, null, 2);
+};
+function createGenAgentMdCommand(options) {
+	return {
+		command: "gen-agent-md <provider>",
+		describe: "Generate .afs/AGENT.md for a provider package",
+		builder: { provider: {
+			type: "string",
+			description: "Provider package name (e.g., @aigne/afs-sqlite) or directory path",
+			demandOption: true
+		} },
+		handler: async (argv) => {
+			try {
+				const providerPath = argv.provider;
+				const mod = await import(providerPath);
+				let manifest;
+				let treeSchema;
+				for (const key of Object.keys(mod)) {
+					const val = mod[key];
+					if (typeof val !== "function") continue;
+					if (typeof val.manifest !== "function") continue;
+					const result = val.manifest();
+					const m = Array.isArray(result) ? result[0] : result;
+					if (m?.name) {
+						manifest = m;
+						if (typeof val.treeSchema === "function") treeSchema = val.treeSchema();
+						break;
+					}
+				}
+				if (!manifest) {
+					options.onResult({
+						command: "gen-agent-md",
+						result: null,
+						format: formatGenAgentMd,
+						error: { message: `No provider class with static manifest() found in ${providerPath}` }
+					});
+					return;
+				}
+				const content = generateAgentMd(manifest, treeSchema);
+				options.onResult({
+					command: "gen-agent-md",
+					result: content,
+					format: formatGenAgentMd
+				});
+			} catch (err) {
+				options.onResult({
+					command: "gen-agent-md",
+					result: null,
+					format: formatGenAgentMd,
+					error: { message: `Failed to generate AGENT.md: ${err}` }
+				});
+			}
+		}
+	};
+}
+
+//#endregion
+export { createGenAgentMdCommand, generateAgentMd };
+//# sourceMappingURL=gen-agent-md.mjs.map

package/dist/core/commands/gen-agent-md.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen-agent-md.mjs","names":[],"sources":["../../../src/core/commands/gen-agent-md.ts"],"sourcesContent":["/**\n * gen-agent-md Command\n *\n * Generates a .afs/AGENT.md file from a provider's manifest and treeSchema.\n * This is a developer tool for provider authors.\n */\n\nimport type { CommandModule } from \"yargs\";\nimport type { CommandFactoryOptions, FormatFunction } from \"./types.js\";\n\nexport interface GenAgentMdArgs {\n  provider: string;\n}\n\ninterface ManifestInput {\n  name: string;\n  description: string;\n  category: string;\n  uriTemplate: string;\n  tags?: string[];\n  useCases?: string[];\n}\n\ninterface TreeSchemaInput {\n  operations: string[];\n  tree: Record<\n    string,\n    { kind: string; operations?: string[]; actions?: string[]; destructive?: string[] }\n  >;\n  auth?: { type: string; env?: string[] };\n  bestFor?: string[];\n  notFor?: string[];\n}\n\n/**\n * Generate AGENT.md content from manifest and optional treeSchema.\n *\n * Exported for direct use in tests and other tools.\n */\nexport function generateAgentMd(manifest: ManifestInput, treeSchema?: TreeSchemaInput): string {\n  const lines: string[] = [];\n\n  // YAML frontmatter\n  lines.push(\"---\");\n  lines.push(`name: ${manifest.name}`);\n  lines.push(`category: ${manifest.category}`);\n  lines.push(`uri: ${manifest.uriTemplate}`);\n\n  if (treeSchema) {\n    lines.push(\"operations:\");\n    for (const op of treeSchema.operations) {\n      lines.push(`  - ${op}`);\n    }\n  }\n\n  if (manifest.tags?.length) {\n    lines.push(\"tags:\");\n    for (const tag of manifest.tags) {\n      lines.push(`  - ${tag}`);\n    }\n  }\n\n  if (treeSchema?.auth) {\n    lines.push(`auth: ${treeSchema.auth.type}`);\n    if (treeSchema.auth.env?.length) {\n      lines.push(\"auth_env:\");\n      for (const env of treeSchema.auth.env) {\n        lines.push(`  - ${env}`);\n      }\n    }\n  }\n\n  lines.push(\"---\");\n  lines.push(\"\");\n\n  // Markdown body\n  lines.push(`# ${manifest.name}`);\n  lines.push(\"\");\n  lines.push(manifest.description);\n  lines.push(\"\");\n\n  // Path structure from treeSchema\n  if (treeSchema) {\n    lines.push(\"## Path Structure\");\n    lines.push(\"\");\n    for (const [path, node] of Object.entries(treeSchema.tree)) {\n      let line = `- \\`${path}\\` — ${node.kind}`;\n      if (node.actions?.length) {\n        line += ` (actions: ${node.actions.join(\", \")})`;\n      }\n      if (node.destructive?.length) {\n        line += ` **[destructive: ${node.destructive.join(\", \")}]**`;\n      }\n      lines.push(line);\n    }\n    lines.push(\"\");\n  }\n\n  // Use cases\n  if (manifest.useCases?.length) {\n    lines.push(\"## Use Cases\");\n    lines.push(\"\");\n    for (const uc of manifest.useCases) {\n      lines.push(`- ${uc}`);\n    }\n    lines.push(\"\");\n  }\n\n  // Best for / Not for\n  if (treeSchema?.bestFor?.length) {\n    lines.push(\"## Best For\");\n    lines.push(\"\");\n    for (const item of treeSchema.bestFor) {\n      lines.push(`- ${item}`);\n    }\n    lines.push(\"\");\n  }\n\n  if (treeSchema?.notFor?.length) {\n    lines.push(\"## Not Recommended For\");\n    lines.push(\"\");\n    for (const item of treeSchema.notFor) {\n      lines.push(`- ${item}`);\n    }\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\nconst formatGenAgentMd: FormatFunction = (result) => {\n  if (typeof result === \"string\") return result;\n  return JSON.stringify(result, null, 2);\n};\n\nexport function createGenAgentMdCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, GenAgentMdArgs> {\n  return {\n    command: \"gen-agent-md <provider>\",\n    describe: \"Generate .afs/AGENT.md for a provider package\",\n    builder: {\n      provider: {\n        type: \"string\",\n        description: \"Provider package name (e.g., @aigne/afs-sqlite) or directory path\",\n        demandOption: true,\n      },\n    },\n    handler: async (argv) => {\n      try {\n        const providerPath = argv.provider;\n\n        // Dynamic import the provider package\n        const mod = (await import(providerPath)) as Record<string, unknown>;\n\n        // Find the provider class with static manifest()\n        let manifest: ManifestInput | undefined;\n        let treeSchema: TreeSchemaInput | undefined;\n\n        for (const key of Object.keys(mod)) {\n          const val = mod[key];\n          if (typeof val !== \"function\") continue;\n          if (typeof (val as any).manifest !== \"function\") continue;\n\n          const result = (val as any).manifest();\n          const m = Array.isArray(result) ? result[0] : result;\n          if (m?.name) {\n            manifest = m;\n            if (typeof (val as any).treeSchema === \"function\") {\n              treeSchema = (val as any).treeSchema();\n            }\n            break;\n          }\n        }\n\n        if (!manifest) {\n          options.onResult({\n            command: \"gen-agent-md\",\n            result: null,\n            format: formatGenAgentMd,\n            error: { message: `No provider class with static manifest() found in ${providerPath}` },\n          });\n          return;\n        }\n\n        const content = generateAgentMd(manifest, treeSchema);\n\n        options.onResult({\n          command: \"gen-agent-md\",\n          result: content,\n          format: formatGenAgentMd,\n        });\n      } catch (err) {\n        options.onResult({\n          command: \"gen-agent-md\",\n          result: null,\n          format: formatGenAgentMd,\n          error: { message: `Failed to generate AGENT.md: ${err}` },\n        });\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/index.cjs

@@ -1,15 +1,21 @@
+const require_connect = require('./connect.cjs');
+const require_daemon = require('./daemon.cjs');
 const require_types = require('./types.cjs');
 const require_delete = require('./delete.cjs');
 const require_exec_args = require('../helpers/exec-args.cjs');
 const require_exec = require('./exec.cjs');
 const require_explain = require('./explain.cjs');
 const require_explore = require('./explore.cjs');
+const require_gen_agent_md = require('./gen-agent-md.cjs');
+const require_install = require('./install.cjs');
 const require_ls = require('./ls.cjs');
+const require_mcp_bridge = require('./mcp-bridge.cjs');
 const require_mount = require('./mount.cjs');
 const require_read = require('./read.cjs');
 const require_search = require('./search.cjs');
 const require_serve = require('./serve.cjs');
 const require_stat = require('./stat.cjs');
+const require_vault = require('./vault.cjs');
 const require_write = require('./write.cjs');
 
 //#region src/core/commands/index.ts
@@ -29,7 +35,13 @@ const commandFactories = [
 	require_search.createSearchCommand,
 	require_mount.createMountCommand,
 	require_serve.createServeCommand,
-	require_explore.createExploreCommand
+	require_explore.createExploreCommand,
+	require_vault.createVaultCommand,
+	require_daemon.createServiceCommand,
+	require_connect.createConnectCommand,
+	require_mcp_bridge.createMcpBridgeCommand,
+	require_gen_agent_md.createGenAgentMdCommand,
+	require_install.createInstallCommand
 ];
 
 //#endregion

package/dist/core/commands/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cAmDa,gBAAA,EAAkB,cAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cAoEa,gBAAA,EAAkB,cAAA"}

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

@@ -1,15 +1,21 @@
 import { CommandFactory, CommandFactoryOptions, CommandOutput, FormatFunction } from "./types.mjs";
+import "./connect.mjs";
+import "./daemon.mjs";
 import { DeleteArgs, createDeleteCommand } from "./delete.mjs";
 import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.mjs";
 import { ExecArgs, createExecCommand } from "./exec.mjs";
 import { ExplainArgs, createExplainCommand } from "./explain.mjs";
 import "./explore.mjs";
+import "./gen-agent-md.mjs";
+import "./install.mjs";
 import { LsArgs, createLsCommand } from "./ls.mjs";
+import "./mcp-bridge.mjs";
 import { MountAddArgs, MountListArgs, MountRemoveArgs, createMountCommand } from "./mount.mjs";
 import { ReadArgs, createReadCommand } from "./read.mjs";
 import "./search.mjs";
 import "./serve.mjs";
 import { StatArgs, createStatCommand } from "./stat.mjs";
+import "./vault.mjs";
 import { WriteArgs, createWriteCommand } from "./write.mjs";
 
 //#region src/core/commands/index.d.ts

package/dist/core/commands/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;cAmDa,gBAAA,EAAkB,cAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;cAoEa,gBAAA,EAAkB,cAAA"}

package/dist/core/commands/index.mjs

@@ -1,15 +1,21 @@
+import { createConnectCommand } from "./connect.mjs";
+import { createServiceCommand } from "./daemon.mjs";
 import { resolveAFS } from "./types.mjs";
 import { createDeleteCommand } from "./delete.mjs";
 import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.mjs";
 import { createExecCommand } from "./exec.mjs";
 import { createExplainCommand } from "./explain.mjs";
 import { createExploreCommand } from "./explore.mjs";
+import { createGenAgentMdCommand, generateAgentMd } from "./gen-agent-md.mjs";
+import { createInstallCommand } from "./install.mjs";
 import { createLsCommand } from "./ls.mjs";
+import { createMcpBridgeCommand } from "./mcp-bridge.mjs";
 import { createMountCommand } from "./mount.mjs";
 import { createReadCommand } from "./read.mjs";
 import { createSearchCommand } from "./search.mjs";
 import { createServeCommand } from "./serve.mjs";
 import { createStatCommand } from "./stat.mjs";
+import { createVaultCommand } from "./vault.mjs";
 import { createWriteCommand } from "./write.mjs";
 
 //#region src/core/commands/index.ts
@@ -29,7 +35,13 @@ const commandFactories = [
 	createSearchCommand,
 	createMountCommand,
 	createServeCommand,
-	createExploreCommand
+	createExploreCommand,
+	createVaultCommand,
+	createServiceCommand,
+	createConnectCommand,
+	createMcpBridgeCommand,
+	createGenAgentMdCommand,
+	createInstallCommand
 ];
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/commands/index.ts"],"sourcesContent":["/**\n * CLI Core Commands\n *\n * Re-exports all command implementations and factories.\n */\n\n// Command factories and types\nexport { createDeleteCommand, type DeleteArgs } from \"./delete.js\";\nexport { createExecCommand, type ExecArgs, parseExecArgs, parseValueBySchema } from \"./exec.js\";\nexport { createExplainCommand, type ExplainArgs } from \"./explain.js\";\nexport { createExploreCommand, type ExploreArgs } from \"./explore.js\";\nexport { createLsCommand, type LsArgs } from \"./ls.js\";\nexport {\n  createMountCommand,\n  type MountAddArgs,\n  type MountListArgs,\n  type MountRemoveArgs,\n} from \"./mount.js\";\nexport { createReadCommand, type ReadArgs } from \"./read.js\";\nexport { createSearchCommand, type SearchArgs } from \"./search.js\";\nexport { createServeCommand, type ServeArgs, type ServeResult } from \"./serve.js\";\nexport { createStatCommand, type StatArgs } from \"./stat.js\";\n// Types and helpers\nexport type {\n  CommandFactory,\n  CommandFactoryOptions,\n  CommandOutput,\n  FormatFunction,\n} from \"./types.js\";\nexport { resolveAFS } from \"./types.js\";\nexport { createWriteCommand, type WriteArgs } from \"./write.js\";\n\n// Import factories for array export\nimport { createDeleteCommand } from \"./delete.js\";\nimport { createExecCommand } from \"./exec.js\";\nimport { createExplainCommand } from \"./explain.js\";\nimport { createExploreCommand } from \"./explore.js\";\nimport { createLsCommand } from \"./ls.js\";\nimport { createMountCommand } from \"./mount.js\";\nimport { createReadCommand } from \"./read.js\";\nimport { createSearchCommand } from \"./search.js\";\nimport { createServeCommand } from \"./serve.js\";\nimport { createStatCommand } from \"./stat.js\";\nimport type { CommandFactory } from \"./types.js\";\nimport { createWriteCommand } from \"./write.js\";\n\n/**\n * Array of all command factories\n *\n * Used by AFSCommandExecutor to register all commands.\n */\nexport const commandFactories: CommandFactory[] = [\n  createLsCommand,\n  createReadCommand,\n  createWriteCommand,\n  createDeleteCommand,\n  createStatCommand,\n  createExecCommand,\n  createExplainCommand,\n  createSearchCommand,\n  createMountCommand,\n  createServeCommand,\n  createExploreCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,mBAAqC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/commands/index.ts"],"sourcesContent":["/**\n * CLI Core Commands\n *\n * Re-exports all command implementations and factories.\n */\n\nexport { type ConnectArgs, createConnectCommand } from \"./connect.js\";\nexport { createServiceCommand, type ServiceArgs } from \"./daemon.js\";\n// Command factories and types\nexport { createDeleteCommand, type DeleteArgs } from \"./delete.js\";\nexport { createExecCommand, type ExecArgs, parseExecArgs, parseValueBySchema } from \"./exec.js\";\nexport { createExplainCommand, type ExplainArgs } from \"./explain.js\";\nexport { createExploreCommand, type ExploreArgs } from \"./explore.js\";\nexport { createGenAgentMdCommand, type GenAgentMdArgs, generateAgentMd } from \"./gen-agent-md.js\";\nexport {\n  createInstallCommand,\n  type InstallAddArgs,\n  type InstallConfigureArgs,\n  type InstallRemoveArgs,\n} from \"./install.js\";\nexport { createLsCommand, type LsArgs } from \"./ls.js\";\nexport { createMcpBridgeCommand, type McpBridgeArgs } from \"./mcp-bridge.js\";\nexport {\n  createMountCommand,\n  type MountAddArgs,\n  type MountListArgs,\n  type MountRemoveArgs,\n} from \"./mount.js\";\nexport { createReadCommand, type ReadArgs } from \"./read.js\";\nexport { createSearchCommand, type SearchArgs } from \"./search.js\";\nexport { createServeCommand, type ServeArgs, type ServeResult } from \"./serve.js\";\nexport { createStatCommand, type StatArgs } from \"./stat.js\";\n// Types and helpers\nexport type {\n  CommandFactory,\n  CommandFactoryOptions,\n  CommandOutput,\n  FormatFunction,\n} from \"./types.js\";\nexport { resolveAFS } from \"./types.js\";\nexport { createVaultCommand } from \"./vault.js\";\nexport { createWriteCommand, type WriteArgs } from \"./write.js\";\n\n// Import factories for array export\nimport { createConnectCommand } from \"./connect.js\";\nimport { createServiceCommand } from \"./daemon.js\";\nimport { createDeleteCommand } from \"./delete.js\";\nimport { createExecCommand } from \"./exec.js\";\nimport { createExplainCommand } from \"./explain.js\";\nimport { createExploreCommand } from \"./explore.js\";\nimport { createGenAgentMdCommand } from \"./gen-agent-md.js\";\nimport { createInstallCommand } from \"./install.js\";\nimport { createLsCommand } from \"./ls.js\";\nimport { createMcpBridgeCommand } from \"./mcp-bridge.js\";\nimport { createMountCommand } from \"./mount.js\";\nimport { createReadCommand } from \"./read.js\";\nimport { createSearchCommand } from \"./search.js\";\nimport { createServeCommand } from \"./serve.js\";\nimport { createStatCommand } from \"./stat.js\";\nimport type { CommandFactory } from \"./types.js\";\nimport { createVaultCommand } from \"./vault.js\";\nimport { createWriteCommand } from \"./write.js\";\n\n/**\n * Array of all command factories\n *\n * Used by AFSCommandExecutor to register all commands.\n */\nexport const commandFactories: CommandFactory[] = [\n  createLsCommand,\n  createReadCommand,\n  createWriteCommand,\n  createDeleteCommand,\n  createStatCommand,\n  createExecCommand,\n  createExplainCommand,\n  createSearchCommand,\n  createMountCommand,\n  createServeCommand,\n  createExploreCommand,\n  createVaultCommand,\n  createServiceCommand,\n  createConnectCommand,\n  createMcpBridgeCommand,\n  createGenAgentMdCommand,\n  createInstallCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,MAAa,mBAAqC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/core/commands/install.cjs

@@ -0,0 +1,139 @@
+const require_install = require('../formatters/install.cjs');
+const require_program_install = require('../../config/program-install.cjs');
+
+//#region src/core/commands/install.ts
+/**
+* Create program command factory (with subcommands)
+*/
+function createInstallCommand(options) {
+	return {
+		command: "program",
+		describe: "Install and manage AFS programs",
+		builder: (yargs) => yargs.command(createProgramInstallSubcommand(options)).command(createProgramListSubcommand(options)).command(createProgramUninstallSubcommand(options)).command(createProgramConfigureSubcommand(options)).demandCommand(1, "Specify a subcommand: install, list, uninstall, configure").alias("help", "h"),
+		handler: () => {}
+	};
+}
+/**
+* program install <source>
+*/
+function createProgramInstallSubcommand(options) {
+	return {
+		command: "install <source>",
+		describe: "Install a program from local directory, GitHub URL, or zip file",
+		builder: { source: {
+			type: "string",
+			demandOption: true,
+			description: "Source: local path, GitHub URL, or .zip file"
+		} },
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			const result = await require_program_install.installProgram(argv.source, { cwd });
+			options.onResult({
+				command: "program install",
+				result,
+				format: require_install.formatInstallAddOutput
+			});
+		}
+	};
+}
+/**
+* program list
+*/
+function createProgramListSubcommand(options) {
+	return {
+		command: ["list", "ls"],
+		describe: "List installed programs",
+		handler: async () => {
+			const programs = await require_program_install.listInstalledPrograms();
+			options.onResult({
+				command: "program list",
+				result: programs,
+				format: require_install.formatInstallListOutput
+			});
+		}
+	};
+}
+/**
+* program uninstall <id>
+*/
+function createProgramUninstallSubcommand(options) {
+	return {
+		command: "uninstall <id>",
+		describe: "Uninstall an installed program",
+		builder: {
+			id: {
+				type: "string",
+				demandOption: true,
+				description: "Program ID to uninstall"
+			},
+			purge: {
+				type: "boolean",
+				default: false,
+				description: "Also remove program data directory"
+			}
+		},
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			const result = await require_program_install.removeProgram(argv.id, {
+				purge: argv.purge,
+				cwd
+			});
+			options.onResult({
+				command: "program uninstall",
+				result,
+				format: require_install.formatInstallRemoveOutput
+			});
+		}
+	};
+}
+/**
+* program configure <id>
+*/
+function createProgramConfigureSubcommand(options) {
+	return {
+		command: "configure <id>",
+		describe: "Configure mount credentials for an installed program",
+		builder: {
+			id: {
+				type: "string",
+				demandOption: true,
+				description: "Program ID to configure"
+			},
+			force: {
+				type: "string",
+				alias: "f",
+				description: "Force re-configure (optionally specify mount path, e.g. /telegram)"
+			},
+			list: {
+				type: "boolean",
+				alias: "l",
+				default: false,
+				description: "List configurable mounts and their status"
+			}
+		},
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			if (argv.list) {
+				const result$1 = await require_program_install.listProgramMountStatus(argv.id);
+				options.onResult({
+					command: "program configure --list",
+					result: result$1,
+					format: require_install.formatConfigureListOutput
+				});
+				return;
+			}
+			const result = await require_program_install.configureProgramMounts(argv.id, {
+				cwd,
+				force: argv.force
+			});
+			options.onResult({
+				command: "program configure",
+				result,
+				format: require_install.formatConfigureOutput
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createInstallCommand = createInstallCommand;

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

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