@aigne/afs 1.11.0-beta → 1.11.0-beta.10

package/dist/registry.mjs

@@ -0,0 +1,360 @@
+import { __require } from "./_virtual/rolldown_runtime.mjs";
+import { parseURI } from "./utils/uri.mjs";
+import { extractSchemeFromTemplate, parseTemplate } from "./utils/uri-template.mjs";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/registry.ts
+/**
+* Resolve a package specifier to an importable path.
+* If the specifier is a directory path (e.g. from npm install),
+* read its package.json to find the ESM entry point.
+*/
+function resolveImportPath(specifier) {
+	if (!specifier.startsWith("/")) return specifier;
+	const pkgJsonPath = join(specifier, "package.json");
+	if (!existsSync(pkgJsonPath)) return specifier;
+	try {
+		const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+		const esmEntry = typeof pkg.exports === "object" && pkg.exports["."]?.import || pkg.module;
+		if (esmEntry) return join(specifier, esmEntry);
+		if (pkg.main) return join(specifier, pkg.main);
+	} catch {}
+	return specifier;
+}
+/** Mutex for npm install operations to prevent concurrent installs */
+const npmInstallLocks = /* @__PURE__ */ new Map();
+/**
+* Validate npm package name format.
+* Rejects path traversal and shell metacharacters.
+*/
+function isValidNpmPackageName(name) {
+	if (!name || name.length > 214) return false;
+	if (name.includes("..") || name.startsWith("/") || name.startsWith("\\")) return false;
+	for (const char of [
+		";",
+		"|",
+		"&",
+		"`",
+		"$",
+		"(",
+		")",
+		">",
+		"<",
+		"\n",
+		"\r",
+		"	",
+		"\0"
+	]) if (name.includes(char)) return false;
+	if (name.startsWith("@")) {
+		const parts = name.slice(1).split("/");
+		if (parts.length !== 2 || !parts[0] || !parts[1]) return false;
+	}
+	return true;
+}
+/**
+* Install an npm package if not already present.
+* Uses per-package mutex to prevent concurrent installs.
+*/
+async function npmInstall(packageName, packagesDir) {
+	const existing = npmInstallLocks.get(packageName);
+	if (existing) {
+		await existing;
+		return;
+	}
+	const { mkdir } = await import("node:fs/promises");
+	const installPromise = (async () => {
+		await mkdir(packagesDir, { recursive: true });
+		const { execSync } = await import("node:child_process");
+		try {
+			execSync(`npm install --prefix ${JSON.stringify(packagesDir)} ${JSON.stringify(packageName)}`, {
+				stdio: "pipe",
+				timeout: 12e4
+			});
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(`Failed to install npm package "${packageName}": ${message}`);
+		}
+	})();
+	npmInstallLocks.set(packageName, installPromise);
+	try {
+		await installPromise;
+	} finally {
+		npmInstallLocks.delete(packageName);
+	}
+}
+/**
+* Get the npm packages install directory (~/.afs-config/packages/).
+*/
+function getNpmPackagesDir() {
+	const os = __require("node:os");
+	const { resolve } = __require("node:path");
+	return resolve(os.homedir(), ".afs-config", "packages");
+}
+/** How often to check for package updates (24 hours). */
+const UPDATE_CHECK_STALE_MS = 1440 * 60 * 1e3;
+/**
+* Trigger a background npm update if the package hasn't been checked recently.
+* Completely silent — never blocks, never throws, never produces output.
+*/
+function npmUpdateIfStale(packageName, packagesDir) {
+	const checkFile = join(packagesDir, ".update-check.json");
+	const now = Date.now();
+	let checks = {};
+	try {
+		checks = JSON.parse(readFileSync(checkFile, "utf-8"));
+	} catch {}
+	if (now - (checks[packageName] ?? 0) < UPDATE_CHECK_STALE_MS) return;
+	checks[packageName] = now;
+	try {
+		writeFileSync(checkFile, JSON.stringify(checks, null, 2));
+	} catch {}
+	npmUpdateBackground(packageName, packagesDir).catch(() => {});
+}
+/**
+* Run `npm update` for a single package in the background.
+* Errors are silently swallowed (e.g. no network).
+*/
+async function npmUpdateBackground(packageName, packagesDir) {
+	const { execSync } = await import("node:child_process");
+	try {
+		execSync(`npm update --prefix ${JSON.stringify(packagesDir)} ${JSON.stringify(packageName)}`, {
+			stdio: "ignore",
+			timeout: 12e4
+		});
+	} catch {}
+}
+/**
+* Package name overrides for schemes that don't follow the @aigne/afs-{scheme} convention.
+* Class discovery uses the .manifest() static method — no class name mapping needed.
+*/
+const PACKAGE_OVERRIDES = { https: "@aigne/afs-http" };
+/**
+* Derive the base scheme for compound schemes.
+* e.g. "mcp+stdio" → "mcp", "mcp+http" → "mcp"
+*/
+function baseScheme(scheme) {
+	const plusIdx = scheme.indexOf("+");
+	return plusIdx >= 0 ? scheme.slice(0, plusIdx) : scheme;
+}
+/**
+* Registry of provider factories with unified manifest-driven loading.
+*
+* Loading flow:
+* 1. parseURI → get scheme
+* 2. Check registered factories (workspace, custom) → use directly
+* 3. Resolve package: mount.provider or @aigne/afs-{baseScheme}
+* 4. Import package → get ProviderClass
+* 5. Get manifest from ProviderClass.manifest()
+* 6. Match manifest by scheme (for multi-manifest providers)
+* 7. parseTemplate(uriTemplate, body) → extract path variables
+* 8. Merge params: body vars > query > mount.options
+* 9. Construct provider with merged options
+*/
+var ProviderRegistry = class {
+	factories = /* @__PURE__ */ new Map();
+	/** Register a scheme → factory mapping. Overwrites any existing registration. */
+	register(scheme, factory) {
+		this.factories.set(scheme.toLowerCase(), factory);
+	}
+	/** Check if a scheme has a registered factory. */
+	has(scheme) {
+		return this.factories.has(scheme.toLowerCase());
+	}
+	/**
+	* Get provider metadata (schema, auth, manifest) for a URI.
+	*
+	* Used by CLI credential resolution to get schema and auth method
+	* without constructing the provider.
+	*
+	* Returns null if the provider class can't be loaded (e.g., unknown scheme).
+	*/
+	async getProviderInfo(uri) {
+		try {
+			const parsed = parseURI(uri);
+			const base = baseScheme(parsed.scheme);
+			const packageName = PACKAGE_OVERRIDES[base] ?? `@aigne/afs-${base}`;
+			const ProviderClass = await this.importProviderClass(packageName, base);
+			const auth = ProviderClass.auth ? ProviderClass.auth.bind(ProviderClass) : void 0;
+			let manifest = null;
+			if (ProviderClass.manifest) {
+				const manifests = this.getManifests(ProviderClass, packageName);
+				manifest = this.matchManifest(manifests, parsed.scheme, packageName);
+			}
+			let schema = null;
+			if (manifest?.schema) try {
+				const { z } = await import("zod");
+				schema = z.toJSONSchema(manifest.schema);
+			} catch {}
+			if (!schema && ProviderClass.schema) try {
+				const zodSchema = ProviderClass.schema();
+				const { z } = await import("zod");
+				schema = z.toJSONSchema(zodSchema);
+			} catch {}
+			return {
+				schema,
+				auth,
+				manifest
+			};
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Create a provider from a mount config.
+	*
+	* Uses registered factory if available, otherwise auto-loads
+	* via manifest-driven resolution.
+	*/
+	async createProvider(mount) {
+		const parsed = parseURI(mount.uri);
+		const factory = this.factories.get(parsed.scheme);
+		if (factory) {
+			const provider$1 = await factory(mount, parsed);
+			provider$1.uri = mount.uri;
+			return provider$1;
+		}
+		const provider = await this.autoLoadProvider(mount, parsed);
+		provider.uri = mount.uri;
+		return provider;
+	}
+	/**
+	* Auto-load a provider using the manifest-driven unified flow.
+	*/
+	async autoLoadProvider(mount, parsed) {
+		const base = baseScheme(parsed.scheme);
+		const packageName = PACKAGE_OVERRIDES[base] ?? `@aigne/afs-${base}`;
+		const ProviderClass = await this.importProviderClass(packageName, base);
+		const manifests = this.getManifests(ProviderClass, packageName);
+		const manifest = this.matchManifest(manifests, parsed.scheme, packageName);
+		const templateVars = parseTemplate(manifest.uriTemplate, parsed.body);
+		const mergedOptions = this.mergeOptions(templateVars, parsed.query, mount);
+		return this.constructProvider(ProviderClass, mount, parsed, mergedOptions, manifest);
+	}
+	/**
+	* Import a provider class from a package name.
+	* Resolution order:
+	* 1. Direct import (works when package is a dependency of the importing module)
+	* 2. createRequire from process.cwd() (works in monorepo dev environments)
+	* 3. npm auto-install to ~/.afs-config/packages/
+	*/
+	async importProviderClass(packageName, scheme, explicitClassName) {
+		let mod;
+		try {
+			mod = await this.resolveAndImport(packageName);
+		} catch {
+			if (!isValidNpmPackageName(packageName)) throw new Error(`Unknown URI scheme "${scheme}": package "${packageName}" not found and name is invalid.`);
+			const packagesDir = getNpmPackagesDir();
+			const { resolve } = await import("node:path");
+			const nodeModulesPath = resolve(packagesDir, "node_modules", ...packageName.split("/"));
+			if (!existsSync(nodeModulesPath)) await npmInstall(packageName, packagesDir);
+			else npmUpdateIfStale(packageName, packagesDir);
+			const importPath = resolveImportPath(nodeModulesPath);
+			try {
+				mod = await import(importPath);
+			} catch (error) {
+				const msg = error instanceof Error ? error.message : String(error);
+				throw new Error(`Failed to import provider package "${packageName}" for scheme "${scheme}": ${msg}`);
+			}
+		}
+		if (explicitClassName && mod[explicitClassName]) return mod[explicitClassName];
+		const conventionName = `AFS${scheme.charAt(0).toUpperCase()}${scheme.slice(1).toUpperCase()}`;
+		if (mod[conventionName]) return mod[conventionName];
+		for (const key of Object.keys(mod)) {
+			const val = mod[key];
+			if (typeof val === "function" && key !== "default" && val.manifest) return val;
+		}
+		if (mod.default && typeof mod.default === "function") return mod.default;
+		throw new Error(`Package "${packageName}" does not export a valid AFS Provider class for scheme "${scheme}".`);
+	}
+	/**
+	* Get manifest(s) from a provider class.
+	*/
+	getManifests(ProviderClass, packageName) {
+		if (!ProviderClass.manifest) throw new Error(`Provider class from "${packageName}" does not implement static manifest(). Please add a static manifest() method to the provider class.`);
+		const result = ProviderClass.manifest();
+		return Array.isArray(result) ? result : [result];
+	}
+	/**
+	* Find the matching manifest for a given scheme.
+	* For multi-manifest providers (e.g., MCP with mcp+stdio, mcp+http, mcp+sse),
+	* match by the full scheme from the URI template.
+	*/
+	matchManifest(manifests, scheme, packageName) {
+		if (manifests.length === 1) return manifests[0];
+		for (const m of manifests) try {
+			if (extractSchemeFromTemplate(m.uriTemplate) === scheme) return m;
+		} catch {}
+		if (manifests.length > 0) return manifests[0];
+		throw new Error(`No matching manifest found for scheme "${scheme}" in package "${packageName}".`);
+	}
+	/**
+	* Merge parameters from multiple sources.
+	* Priority: template vars (from URI body) > query params > mount.options
+	*/
+	mergeOptions(templateVars, query, mount) {
+		const result = {};
+		if (mount.options) Object.assign(result, mount.options);
+		for (const [key, value] of Object.entries(query)) if (value !== "") result[key] = value;
+		for (const [key, value] of Object.entries(templateVars)) if (value !== void 0) result[key] = value;
+		return result;
+	}
+	/**
+	* Construct a provider instance with merged options.
+	*/
+	async constructProvider(ProviderClass, mount, _parsed, mergedOptions, manifest) {
+		const constructorOptions = {
+			...mergedOptions,
+			name: mount.path.slice(1).replace(/\//g, "-") || manifest.name,
+			description: mount.description,
+			accessMode: mount.access_mode,
+			uri: mount.uri
+		};
+		if (mount.auth !== void 0) constructorOptions.auth = mount.auth;
+		if (mount.token !== void 0) constructorOptions.token = mount.token;
+		const provider = new ProviderClass(constructorOptions);
+		if (typeof provider.ready === "function") await provider.ready();
+		return provider;
+	}
+	/**
+	* Resolve and import a package, trying multiple resolution strategies.
+	*
+	* In a monorepo (pnpm workspace), `import("@aigne/afs-fs")` inside packages/core
+	* won't find packages/cli's dependencies. We locate the package directory via
+	* createRequire, then use resolveImportPath to find the correct ESM entry.
+	*/
+	async resolveAndImport(packageName) {
+		try {
+			return await import(resolveImportPath(packageName));
+		} catch {}
+		const packageDir = this.locatePackageDir(packageName);
+		if (packageDir) return await import(resolveImportPath(packageDir));
+		throw new Error(`Cannot resolve module "${packageName}"`);
+	}
+	/**
+	* Locate a package directory using createRequire from various contexts.
+	* Returns the package directory path, or undefined if not found.
+	*/
+	locatePackageDir(packageName) {
+		const { createRequire } = __require("node:module");
+		const { dirname } = __require("node:path");
+		const contexts = [join(process.cwd(), "__resolve__.js"), ...process.argv[1] ? [join(dirname(process.argv[1]), "__resolve__.js")] : []];
+		for (const context of contexts) try {
+			return dirname(createRequire(context).resolve(join(packageName, "package.json")));
+		} catch {
+			try {
+				let dir = dirname(createRequire(context).resolve(packageName));
+				for (let i = 0; i < 5; i++) {
+					if (existsSync(join(dir, "package.json"))) return dir;
+					const parent = dirname(dir);
+					if (parent === dir) break;
+					dir = parent;
+				}
+			} catch {}
+		}
+	}
+};
+
+//#endregion
+export { ProviderRegistry };
+//# sourceMappingURL=registry.mjs.map

package/dist/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","names":["provider"],"sources":["../src/registry.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AFSModule, MountConfig, ProviderManifest } from \"./type.js\";\nimport { type ParsedURI, parseURI } from \"./utils/uri.js\";\nimport { extractSchemeFromTemplate, parseTemplate } from \"./utils/uri-template.js\";\n\n/**\n * Factory function that creates a provider from a mount config and pre-parsed URI.\n */\nexport type ProviderFactory = (mount: MountConfig, parsed: ParsedURI) => Promise<AFSModule>;\n\n/**\n * Resolve a package specifier to an importable path.\n * If the specifier is a directory path (e.g. from npm install),\n * read its package.json to find the ESM entry point.\n */\nfunction resolveImportPath(specifier: string): string {\n  if (!specifier.startsWith(\"/\")) return specifier;\n\n  const pkgJsonPath = join(specifier, \"package.json\");\n  if (!existsSync(pkgJsonPath)) return specifier;\n\n  try {\n    const pkg = JSON.parse(readFileSync(pkgJsonPath, \"utf-8\"));\n    const esmEntry = (typeof pkg.exports === \"object\" && pkg.exports[\".\"]?.import) || pkg.module;\n    if (esmEntry) return join(specifier, esmEntry);\n    if (pkg.main) return join(specifier, pkg.main);\n  } catch {\n    // Fall through to use original specifier\n  }\n  return specifier;\n}\n\n/** Mutex for npm install operations to prevent concurrent installs */\nconst npmInstallLocks = new Map<string, Promise<void>>();\n\n/**\n * Validate npm package name format.\n * Rejects path traversal and shell metacharacters.\n */\nfunction isValidNpmPackageName(name: string): boolean {\n  if (!name || name.length > 214) return false;\n  if (name.includes(\"..\") || name.startsWith(\"/\") || name.startsWith(\"\\\\\")) return false;\n  const dangerous = [\";\", \"|\", \"&\", \"`\", \"$\", \"(\", \")\", \">\", \"<\", \"\\n\", \"\\r\", \"\\t\", \"\\x00\"];\n  for (const char of dangerous) {\n    if (name.includes(char)) return false;\n  }\n  if (name.startsWith(\"@\")) {\n    const parts = name.slice(1).split(\"/\");\n    if (parts.length !== 2 || !parts[0] || !parts[1]) return false;\n  }\n  return true;\n}\n\n/**\n * Install an npm package if not already present.\n * Uses per-package mutex to prevent concurrent installs.\n */\nasync function npmInstall(packageName: string, packagesDir: string): Promise<void> {\n  const existing = npmInstallLocks.get(packageName);\n  if (existing) {\n    await existing;\n    return;\n  }\n\n  const { mkdir } = await import(\"node:fs/promises\");\n  const installPromise = (async () => {\n    await mkdir(packagesDir, { recursive: true });\n    const { execSync } = await import(\"node:child_process\");\n    try {\n      execSync(\n        `npm install --prefix ${JSON.stringify(packagesDir)} ${JSON.stringify(packageName)}`,\n        { stdio: \"pipe\", timeout: 120_000 },\n      );\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw new Error(`Failed to install npm package \"${packageName}\": ${message}`);\n    }\n  })();\n\n  npmInstallLocks.set(packageName, installPromise);\n  try {\n    await installPromise;\n  } finally {\n    npmInstallLocks.delete(packageName);\n  }\n}\n\n/**\n * Get the npm packages install directory (~/.afs-config/packages/).\n */\nfunction getNpmPackagesDir(): string {\n  const os = require(\"node:os\") as typeof import(\"node:os\");\n  const { resolve } = require(\"node:path\") as typeof import(\"node:path\");\n  return resolve(os.homedir(), \".afs-config\", \"packages\");\n}\n\n/** How often to check for package updates (24 hours). */\nconst UPDATE_CHECK_STALE_MS = 24 * 60 * 60 * 1000;\n\n/**\n * Trigger a background npm update if the package hasn't been checked recently.\n * Completely silent — never blocks, never throws, never produces output.\n */\nfunction npmUpdateIfStale(packageName: string, packagesDir: string): void {\n  const checkFile = join(packagesDir, \".update-check.json\");\n  const now = Date.now();\n\n  let checks: Record<string, number> = {};\n  try {\n    checks = JSON.parse(readFileSync(checkFile, \"utf-8\"));\n  } catch {\n    /* file missing or corrupt — treat all packages as stale */\n  }\n\n  const lastCheck = checks[packageName] ?? 0;\n  if (now - lastCheck < UPDATE_CHECK_STALE_MS) return;\n\n  // Record check time immediately to prevent duplicate triggers\n  checks[packageName] = now;\n  try {\n    writeFileSync(checkFile, JSON.stringify(checks, null, 2));\n  } catch {\n    /* write failure is non-fatal */\n  }\n\n  // Fire-and-forget background update\n  npmUpdateBackground(packageName, packagesDir).catch(() => {});\n}\n\n/**\n * Run `npm update` for a single package in the background.\n * Errors are silently swallowed (e.g. no network).\n */\nasync function npmUpdateBackground(packageName: string, packagesDir: string): Promise<void> {\n  const { execSync } = await import(\"node:child_process\");\n  try {\n    execSync(`npm update --prefix ${JSON.stringify(packagesDir)} ${JSON.stringify(packageName)}`, {\n      stdio: \"ignore\",\n      timeout: 120_000,\n    });\n  } catch {\n    // Silent — no network, npm error, etc.\n  }\n}\n\n// ─── Built-in provider package mapping ─────────────────────────────────────\n// Maps base scheme → npm package name for providers that don't follow\n// the @aigne/afs-{scheme} convention, or need explicit class name mapping.\n\n/**\n * Package name overrides for schemes that don't follow the @aigne/afs-{scheme} convention.\n * Class discovery uses the .manifest() static method — no class name mapping needed.\n */\nconst PACKAGE_OVERRIDES: Record<string, string> = {\n  https: \"@aigne/afs-http\",\n};\n\n/**\n * Derive the base scheme for compound schemes.\n * e.g. \"mcp+stdio\" → \"mcp\", \"mcp+http\" → \"mcp\"\n */\nfunction baseScheme(scheme: string): string {\n  const plusIdx = scheme.indexOf(\"+\");\n  return plusIdx >= 0 ? scheme.slice(0, plusIdx) : scheme;\n}\n\n/**\n * Registry of provider factories with unified manifest-driven loading.\n *\n * Loading flow:\n * 1. parseURI → get scheme\n * 2. Check registered factories (workspace, custom) → use directly\n * 3. Resolve package: mount.provider or @aigne/afs-{baseScheme}\n * 4. Import package → get ProviderClass\n * 5. Get manifest from ProviderClass.manifest()\n * 6. Match manifest by scheme (for multi-manifest providers)\n * 7. parseTemplate(uriTemplate, body) → extract path variables\n * 8. Merge params: body vars > query > mount.options\n * 9. Construct provider with merged options\n */\nexport class ProviderRegistry {\n  private factories = new Map<string, ProviderFactory>();\n\n  /** Register a scheme → factory mapping. Overwrites any existing registration. */\n  register(scheme: string, factory: ProviderFactory): void {\n    this.factories.set(scheme.toLowerCase(), factory);\n  }\n\n  /** Check if a scheme has a registered factory. */\n  has(scheme: string): boolean {\n    return this.factories.has(scheme.toLowerCase());\n  }\n\n  /**\n   * Get provider metadata (schema, auth, manifest) for a URI.\n   *\n   * Used by CLI credential resolution to get schema and auth method\n   * without constructing the provider.\n   *\n   * Returns null if the provider class can't be loaded (e.g., unknown scheme).\n   */\n  async getProviderInfo(uri: string): Promise<{\n    schema: any | null;\n    auth: ((context: any) => Promise<Record<string, unknown> | null>) | undefined;\n    manifest: ProviderManifest | null;\n  } | null> {\n    try {\n      const parsed = parseURI(uri);\n      const base = baseScheme(parsed.scheme);\n      const packageName = PACKAGE_OVERRIDES[base] ?? `@aigne/afs-${base}`;\n\n      const ProviderClass = await this.importProviderClass(packageName, base);\n\n      // Get auth method\n      const auth = ProviderClass.auth ? ProviderClass.auth.bind(ProviderClass) : undefined;\n\n      // Get manifest\n      let manifest: ProviderManifest | null = null;\n      if (ProviderClass.manifest) {\n        const manifests = this.getManifests(ProviderClass, packageName);\n        manifest = this.matchManifest(manifests, parsed.scheme, packageName);\n      }\n\n      // Get schema: prefer manifest.schema (user-facing fields only),\n      // fall back to deprecated static schema() (full constructor schema)\n      let schema: any = null;\n      if (manifest?.schema) {\n        try {\n          const { z } = await import(\"zod\");\n          schema = (z as any).toJSONSchema(manifest.schema);\n        } catch {\n          // Schema conversion failed — fall through\n        }\n      }\n      if (!schema && ProviderClass.schema) {\n        try {\n          const zodSchema = ProviderClass.schema();\n          const { z } = await import(\"zod\");\n          schema = (z as any).toJSONSchema(zodSchema);\n        } catch {\n          // Schema conversion failed — fall through\n        }\n      }\n\n      return { schema, auth, manifest };\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Create a provider from a mount config.\n   *\n   * Uses registered factory if available, otherwise auto-loads\n   * via manifest-driven resolution.\n   */\n  async createProvider(mount: MountConfig): Promise<AFSModule> {\n    const parsed = parseURI(mount.uri);\n\n    // Step 1: Check registered factories (workspace, custom providers)\n    const factory = this.factories.get(parsed.scheme);\n    if (factory) {\n      const provider = await factory(mount, parsed);\n      (provider as { uri?: string }).uri = mount.uri;\n      return provider;\n    }\n\n    // Step 2: Auto-load via manifest-driven resolution\n    const provider = await this.autoLoadProvider(mount, parsed);\n    (provider as { uri?: string }).uri = mount.uri;\n    return provider;\n  }\n\n  /**\n   * Auto-load a provider using the manifest-driven unified flow.\n   */\n  private async autoLoadProvider(mount: MountConfig, parsed: ParsedURI): Promise<AFSModule> {\n    // Step 3: Resolve package name\n    const base = baseScheme(parsed.scheme);\n    const packageName = PACKAGE_OVERRIDES[base] ?? `@aigne/afs-${base}`;\n\n    // Step 4: Import the provider package\n    const ProviderClass = await this.importProviderClass(packageName, base);\n\n    // Step 5: Get manifest(s)\n    const manifests = this.getManifests(ProviderClass, packageName);\n\n    // Step 6: Match manifest by scheme\n    const manifest = this.matchManifest(manifests, parsed.scheme, packageName);\n\n    // Step 7: Parse template — extract path variables from URI body\n    const templateVars = parseTemplate(manifest.uriTemplate, parsed.body);\n\n    // Step 8: Merge params (body vars > query > mount.options)\n    const mergedOptions = this.mergeOptions(templateVars, parsed.query, mount);\n\n    // Step 9: Construct provider\n    return this.constructProvider(ProviderClass, mount, parsed, mergedOptions, manifest);\n  }\n\n  /**\n   * Import a provider class from a package name.\n   * Resolution order:\n   * 1. Direct import (works when package is a dependency of the importing module)\n   * 2. createRequire from process.cwd() (works in monorepo dev environments)\n   * 3. npm auto-install to ~/.afs-config/packages/\n   */\n  private async importProviderClass(\n    packageName: string,\n    scheme: string,\n    explicitClassName?: string,\n  ): Promise<ProviderClassLike> {\n    let mod: Record<string, unknown>;\n\n    try {\n      mod = await this.resolveAndImport(packageName);\n    } catch {\n      // Package not found locally — try npm auto-install.\n      // This covers both @aigne/* packages (e.g. used from core without CLI)\n      // and third-party packages.\n      if (!isValidNpmPackageName(packageName)) {\n        throw new Error(\n          `Unknown URI scheme \"${scheme}\": package \"${packageName}\" not found and name is invalid.`,\n        );\n      }\n\n      const packagesDir = getNpmPackagesDir();\n      const { resolve } = await import(\"node:path\");\n      const nodeModulesPath = resolve(packagesDir, \"node_modules\", ...packageName.split(\"/\"));\n\n      if (!existsSync(nodeModulesPath)) {\n        await npmInstall(packageName, packagesDir);\n      } else {\n        // Package exists — check for stale version and update in background\n        npmUpdateIfStale(packageName, packagesDir);\n      }\n\n      const importPath = resolveImportPath(nodeModulesPath);\n      try {\n        mod = (await import(importPath)) as Record<string, unknown>;\n      } catch (error) {\n        const msg = error instanceof Error ? error.message : String(error);\n        throw new Error(\n          `Failed to import provider package \"${packageName}\" for scheme \"${scheme}\": ${msg}`,\n        );\n      }\n    }\n\n    // Find the provider class in the module\n    if (explicitClassName && mod[explicitClassName]) {\n      return mod[explicitClassName] as ProviderClassLike;\n    }\n\n    // Convention: try common export patterns\n    // 1. Named export matching AFS{PascalCase}\n    const conventionName = `AFS${scheme.charAt(0).toUpperCase()}${scheme.slice(1).toUpperCase()}`;\n    if (mod[conventionName]) return mod[conventionName] as ProviderClassLike;\n\n    // 2. Try common naming patterns for the scheme\n    for (const key of Object.keys(mod)) {\n      const val = mod[key];\n      if (typeof val === \"function\" && key !== \"default\" && (val as any).manifest) {\n        return val as ProviderClassLike;\n      }\n    }\n\n    // 3. Default export\n    if (mod.default && typeof mod.default === \"function\") {\n      return mod.default as ProviderClassLike;\n    }\n\n    throw new Error(\n      `Package \"${packageName}\" does not export a valid AFS Provider class for scheme \"${scheme}\".`,\n    );\n  }\n\n  /**\n   * Get manifest(s) from a provider class.\n   */\n  private getManifests(ProviderClass: ProviderClassLike, packageName: string): ProviderManifest[] {\n    if (!ProviderClass.manifest) {\n      throw new Error(\n        `Provider class from \"${packageName}\" does not implement static manifest(). ` +\n          `Please add a static manifest() method to the provider class.`,\n      );\n    }\n\n    const result = ProviderClass.manifest();\n    return Array.isArray(result) ? result : [result];\n  }\n\n  /**\n   * Find the matching manifest for a given scheme.\n   * For multi-manifest providers (e.g., MCP with mcp+stdio, mcp+http, mcp+sse),\n   * match by the full scheme from the URI template.\n   */\n  private matchManifest(\n    manifests: ProviderManifest[],\n    scheme: string,\n    packageName: string,\n  ): ProviderManifest {\n    if (manifests.length === 1) {\n      return manifests[0]!;\n    }\n\n    // Match by extracting scheme from each manifest's uriTemplate\n    for (const m of manifests) {\n      try {\n        const templateScheme = extractSchemeFromTemplate(m.uriTemplate);\n        if (templateScheme === scheme) return m;\n      } catch {\n        // Skip invalid templates\n      }\n    }\n\n    // Fallback: use first manifest\n    if (manifests.length > 0) {\n      return manifests[0]!;\n    }\n\n    throw new Error(\n      `No matching manifest found for scheme \"${scheme}\" in package \"${packageName}\".`,\n    );\n  }\n\n  /**\n   * Merge parameters from multiple sources.\n   * Priority: template vars (from URI body) > query params > mount.options\n   */\n  private mergeOptions(\n    templateVars: Record<string, string | undefined>,\n    query: Record<string, string | string[]>,\n    mount: MountConfig,\n  ): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    // Start with mount.options (lowest priority)\n    if (mount.options) {\n      Object.assign(result, mount.options);\n    }\n\n    // Layer on query params (medium priority)\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== \"\") {\n        result[key] = value;\n      }\n    }\n\n    // Layer on template vars (highest priority)\n    for (const [key, value] of Object.entries(templateVars)) {\n      if (value !== undefined) {\n        result[key] = value;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Construct a provider instance with merged options.\n   */\n  private async constructProvider(\n    ProviderClass: ProviderClassLike,\n    mount: MountConfig,\n    _parsed: ParsedURI,\n    mergedOptions: Record<string, unknown>,\n    manifest: ProviderManifest,\n  ): Promise<AFSModule> {\n    const constructorOptions: Record<string, unknown> = {\n      ...mergedOptions,\n      name: mount.path.slice(1).replace(/\\//g, \"-\") || manifest.name,\n      description: mount.description,\n      accessMode: mount.access_mode,\n      uri: mount.uri,\n    };\n\n    // Mount-level auth/token passthrough\n    if (mount.auth !== undefined) constructorOptions.auth = mount.auth;\n    if (mount.token !== undefined) constructorOptions.token = mount.token;\n\n    // Construct the provider — all normalization is handled by the provider itself\n    const provider = new (ProviderClass as any)(constructorOptions) as AFSModule;\n\n    // Generic post-construction initialization\n    if (typeof (provider as any).ready === \"function\") {\n      await (provider as any).ready();\n    }\n\n    return provider;\n  }\n\n  /**\n   * Resolve and import a package, trying multiple resolution strategies.\n   *\n   * In a monorepo (pnpm workspace), `import(\"@aigne/afs-fs\")` inside packages/core\n   * won't find packages/cli's dependencies. We locate the package directory via\n   * createRequire, then use resolveImportPath to find the correct ESM entry.\n   */\n  private async resolveAndImport(packageName: string): Promise<Record<string, unknown>> {\n    // Strategy 1: Direct import (works if package is a direct/transitive dependency)\n    try {\n      const importPath = resolveImportPath(packageName);\n      return (await import(importPath)) as Record<string, unknown>;\n    } catch {\n      // Fall through to next strategy\n    }\n\n    // Strategy 2+3: Locate the package directory via createRequire,\n    // then use resolveImportPath to find the correct ESM entry point.\n    const packageDir = this.locatePackageDir(packageName);\n    if (packageDir) {\n      const importPath = resolveImportPath(packageDir);\n      return (await import(importPath)) as Record<string, unknown>;\n    }\n\n    // All strategies failed\n    throw new Error(`Cannot resolve module \"${packageName}\"`);\n  }\n\n  /**\n   * Locate a package directory using createRequire from various contexts.\n   * Returns the package directory path, or undefined if not found.\n   */\n  private locatePackageDir(packageName: string): string | undefined {\n    const { createRequire } = require(\"node:module\") as typeof import(\"node:module\");\n    const { dirname } = require(\"node:path\") as typeof import(\"node:path\");\n\n    // Try resolving the package's package.json to find its directory\n    const contexts = [\n      join(process.cwd(), \"__resolve__.js\"),\n      ...(process.argv[1] ? [join(dirname(process.argv[1]), \"__resolve__.js\")] : []),\n    ];\n\n    for (const context of contexts) {\n      try {\n        const req = createRequire(context);\n        // Resolve package.json to get the package directory reliably\n        const pkgJsonPath = req.resolve(join(packageName, \"package.json\"));\n        return dirname(pkgJsonPath);\n      } catch {\n        // Try resolving the main entry and walking up to find package.json\n        try {\n          const req = createRequire(context);\n          const resolvedEntry = req.resolve(packageName);\n          // Walk up from the resolved entry to find the package root\n          let dir = dirname(resolvedEntry);\n          for (let i = 0; i < 5; i++) {\n            if (existsSync(join(dir, \"package.json\"))) {\n              return dir;\n            }\n            const parent = dirname(dir);\n            if (parent === dir) break;\n            dir = parent;\n          }\n        } catch {\n          // Continue to next context\n        }\n      }\n    }\n\n    return undefined;\n  }\n}\n\n/**\n * Provider class shape (what we expect from importing a provider package).\n */\ntype ProviderClassLike = {\n  manifest?(): ProviderManifest | ProviderManifest[];\n  schema?(): any;\n  auth?(context: any): Promise<Record<string, unknown> | null>;\n  new (options: any): AFSModule;\n};\n"],"mappings":"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"}

package/dist/type.cjs

@@ -0,0 +1,34 @@
+let zod = require("zod");
+
+//#region src/type.ts
+/**
+* Zod schema for access mode validation.
+* Can be reused across modules that support access mode configuration.
+*/
+const accessModeSchema = zod.z.enum(["readonly", "readwrite"]).optional();
+/**
+* Zod schema for ActionSummary validation.
+*/
+const actionSummarySchema = zod.z.object({
+	name: zod.z.string(),
+	description: zod.z.string().optional(),
+	inputSchema: zod.z.record(zod.z.string(), zod.z.any()).optional()
+});
+const afsEntrySchema = zod.z.object({
+	id: zod.z.string(),
+	createdAt: zod.z.date().optional(),
+	updatedAt: zod.z.date().optional(),
+	path: zod.z.string(),
+	userId: zod.z.string().nullable().optional(),
+	sessionId: zod.z.string().nullable().optional(),
+	summary: zod.z.string().nullable().optional(),
+	meta: zod.z.record(zod.z.string(), zod.z.any()).nullable().optional(),
+	linkTo: zod.z.string().nullable().optional(),
+	content: zod.z.any().optional(),
+	actions: zod.z.array(actionSummarySchema).optional()
+});
+
+//#endregion
+exports.accessModeSchema = accessModeSchema;
+exports.actionSummarySchema = actionSummarySchema;
+exports.afsEntrySchema = afsEntrySchema;