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

package/dist/afs.d.cts

@@ -0,0 +1,275 @@
+import { AFSExplainResult } from "./meta/type.cjs";
+import { AFSChangeListener, AFSDeleteOptions, AFSDeleteResult, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "./type.cjs";
+
+//#region src/afs.d.ts
+/**
+ * Information about a mounted module
+ */
+interface MountInfo {
+  /** The namespace (null for default namespace) */
+  namespace: string | null;
+  /** The mount path within the namespace */
+  path: string;
+  /** The mounted module */
+  module: AFSModule;
+}
+/**
+ * Options for mounting a module
+ */
+interface MountOptions {
+  /** Namespace to mount into (null/undefined for default namespace) */
+  namespace?: string | null;
+  /** Replace existing mount at the same path */
+  replace?: boolean;
+}
+interface AFSOptions {
+  modules?: AFSModule[];
+  onChange?: AFSChangeListener;
+}
+declare class AFS implements AFSRoot {
+  options: AFSOptions;
+  name: string;
+  /**
+   * Injectable method for loading and mounting a provider from a URI.
+   * Injected by CLI layer (afs-loader.ts) with full pipeline:
+   *   1. ProviderRegistry.createProvider({ uri, path, ...options }) → provider instance
+   *   2. afs.mount(provider, path)
+   *
+   * Used by root-level /.actions/mount action and registry mount action.
+   */
+  loadProvider?: (uri: string, path: string, options?: Record<string, unknown>) => Promise<void>;
+  /**
+   * Injectable callback for removing a provider's config on unmount.
+   * Injected by CLI layer (afs-loader.ts) for persistence sync.
+   */
+  unloadProvider?: (path: string, options?: Record<string, unknown>) => Promise<void>;
+  /**
+   * Injectable callback for updating a provider's options in the config file.
+   * Injected by CLI layer (afs-loader.ts) for persistence sync.
+   * Used by providers to persist runtime config changes (e.g., default model selection).
+   */
+  updateProviderConfig?: (mountPath: string, optionUpdates: Record<string, unknown>) => Promise<void>;
+  constructor(options?: AFSOptions);
+  /**
+   * Internal storage: Map<compositeKey, MountEntry>
+   * compositeKey = `${namespace ?? ""}:${path}`
+   */
+  private mounts;
+  /**
+   * Legacy compatibility: Map<path, AFSModule> for modules mounted via old API
+   * This is used internally by findModules for backward compatibility
+   */
+  private get modules();
+  /**
+   * Create composite key for mount storage
+   */
+  private makeKey;
+  /**
+   * Check if write operations are allowed for the given module.
+   * Throws AFSReadonlyError if not allowed.
+   */
+  /** Fire-and-forget change notification */
+  private notifyChange;
+  private checkWritePermission;
+  /**
+   * Check provider availability on mount.
+   * Validates that the provider can successfully respond to stat/read
+   * and list (if childrenCount indicates children exist).
+   *
+   * @throws AFSMountError if validation fails
+   */
+  private checkProviderOnMount;
+  /**
+   * Mount a module at a path in a namespace
+   *
+   * @param module - The module to mount
+   * @param path - The path to mount at (optional, defaults to /modules/{module.name} for backward compatibility)
+   * @param options - Mount options (namespace, replace)
+   */
+  mount(module: AFSModule, path?: string, options?: MountOptions): Promise<this>;
+  /**
+   * Get all mounts, optionally filtered by namespace
+   *
+   * @param namespace - Filter by namespace (undefined = all, null = default only)
+   */
+  getMounts(namespace?: string | null): MountInfo[];
+  /**
+   * Get all unique namespaces that have mounts
+   */
+  getNamespaces(): (string | null)[];
+  /**
+   * Unmount a module at a path in a namespace
+   *
+   * @param path - The path to unmount
+   * @param namespace - The namespace (undefined/null for default namespace)
+   * @returns true if unmounted, false if not found
+   */
+  unmount(path: string, namespace?: string | null): boolean;
+  /**
+   * Check if a path is mounted in a namespace
+   *
+   * @param path - The path to check
+   * @param namespace - The namespace (undefined/null for default namespace)
+   */
+  isMounted(path: string, namespace?: string | null): boolean;
+  listModules(): Promise<{
+    name: string;
+    path: string;
+    namespace: string | null;
+    description?: string;
+    module: AFSModule;
+  }[]>;
+  /**
+   * Parse a path and extract namespace if it's a canonical path
+   * Returns the namespace and the path within the namespace
+   */
+  private parsePathWithNamespace;
+  /**
+   * Find modules that can handle a path in a specific namespace
+   */
+  private findModulesInNamespace;
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  private _list;
+  /**
+   * Check if a path should skip auto-enrichment.
+   * Paths ending with /.meta or /.actions should not be enriched
+   * to avoid recursive fetches, but their children (e.g., /.meta/kinds)
+   * can still be enriched.
+   */
+  private shouldSkipEnrich;
+  /**
+   * Fetch actions for a path by listing path/.actions.
+   * Returns ActionSummary[] on success, [] on failure.
+   */
+  private fetchActions;
+  /**
+   * Fetch meta for a path by reading path/.meta.
+   * Returns the meta content on success, null on failure.
+   */
+  private fetchMeta;
+  /**
+   * Type for data that can be enriched (has path, optional actions, optional meta)
+   */
+  private enrichData;
+  read(path: string, _options?: AFSReadOptions): Promise<AFSReadResult>;
+  /**
+   * Check if a path is a virtual intermediate directory.
+   * Returns a read result if the path is a parent of one or more mount paths.
+   */
+  private resolveVirtualDirectory;
+  /**
+   * Aggregate capabilities from all mounted providers.
+   *
+   * For each provider:
+   * - Read /.meta/.capabilities
+   * - Merge tools with provider prefix and mount path prefix
+   * - Merge actions with mount path prefix on discovery.pathTemplate
+   * - Silently skip providers that fail or don't implement capabilities
+   */
+  private aggregateCapabilities;
+  write(path: string, content: AFSWriteEntryPayload, options?: AFSWriteOptions): Promise<AFSWriteResult>;
+  delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
+  rename(oldPath: string, newPath: string, options?: AFSRenameOptions): Promise<AFSRenameResult>;
+  search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  private _search;
+  exec(path: string, args: Record<string, any>, options?: AFSExecOptions): Promise<AFSExecResult>;
+  /**
+   * Read a root-level action entry (/.actions/mount, /.actions/unmount).
+   * Returns the action entry with metadata including inputSchema.
+   */
+  private readRootAction;
+  /**
+   * Read root metadata (/.meta).
+   * Returns mounted providers list, root actions, and childrenCount.
+   */
+  private readRootMeta;
+  /**
+   * Read root actions directory (/.actions).
+   * Returns content with actions list.
+   */
+  private readRootActions;
+  /**
+   * Stat a root action path (/.actions or /.actions/{name}).
+   */
+  private statRootAction;
+  /**
+   * Stat a root meta path (/.meta or /.meta/{subpath}).
+   */
+  private statRootMeta;
+  /**
+   * List root-level actions (/.actions).
+   */
+  private listRootActions;
+  /**
+   * Handle root-level action execution (/.actions/*).
+   * Supports:
+   * - /.actions/mount: Load and mount a provider via loadProvider
+   * - /.actions/unmount: Unmount a provider at a given path
+   */
+  private execRootAction;
+  /**
+   * Execute root-level mount action.
+   * Validates input and delegates to loadProvider.
+   */
+  private execRootMountAction;
+  /**
+   * Execute root-level unmount action.
+   * Validates input and delegates to unmount().
+   */
+  private execRootUnmountAction;
+  /**
+   * Validate exec input args against inputSchema.
+   * Throws AFSValidationError if validation fails.
+   * Uses zod-from-json-schema for full JSON Schema validation.
+   */
+  private validateExecInput;
+  /**
+   * Get stat information for a path
+   *
+   * Resolution order:
+   * 1. Provider's stat() method (if implemented)
+   * 2. Fallback to read() - extracts stat data from AFSEntry
+   *
+   * This allows providers to implement only read() while stat() still works.
+   */
+  stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult>;
+  /**
+   * Get human-readable explanation for a path
+   *
+   * Resolution order:
+   * 1. Provider's explain() method (if implemented)
+   * 2. Fallback to stat() - builds explanation from metadata
+   *
+   * This allows providers to skip implementing explain() while it still works.
+   */
+  explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult>;
+  /**
+   * Format bytes to human-readable string
+   */
+  private buildVirtualDirExplain;
+  /**
+   * Explain root path ('/').
+   * Generates a complete navigation guide with 4 required sections.
+   */
+  private explainRoot;
+  /**
+   * Explain a root action path (/.actions or /.actions/{name}).
+   */
+  private explainRootAction;
+  /**
+   * Explain a root meta path (/.meta or /.meta/{subpath}).
+   */
+  private explainRootMeta;
+  /**
+   * Build explain markdown from stat data.
+   * Used by both the module-found fallback and the no-module safety net.
+   */
+  private buildExplainFromStat;
+  private formatBytes;
+  private physicalPath?;
+  initializePhysicalPath(): Promise<string>;
+  cleanupPhysicalPath(): Promise<void>;
+}
+//#endregion
+export { AFS, AFSOptions, MountInfo, MountOptions };
+//# sourceMappingURL=afs.d.cts.map

package/dist/afs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"afs.d.cts","names":[],"sources":["../src/afs.ts"],"mappings":"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"}

package/dist/afs.d.mts

@@ -0,0 +1,275 @@
+import { AFSExplainResult } from "./meta/type.mjs";
+import { AFSChangeListener, AFSDeleteOptions, AFSDeleteResult, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "./type.mjs";
+
+//#region src/afs.d.ts
+/**
+ * Information about a mounted module
+ */
+interface MountInfo {
+  /** The namespace (null for default namespace) */
+  namespace: string | null;
+  /** The mount path within the namespace */
+  path: string;
+  /** The mounted module */
+  module: AFSModule;
+}
+/**
+ * Options for mounting a module
+ */
+interface MountOptions {
+  /** Namespace to mount into (null/undefined for default namespace) */
+  namespace?: string | null;
+  /** Replace existing mount at the same path */
+  replace?: boolean;
+}
+interface AFSOptions {
+  modules?: AFSModule[];
+  onChange?: AFSChangeListener;
+}
+declare class AFS implements AFSRoot {
+  options: AFSOptions;
+  name: string;
+  /**
+   * Injectable method for loading and mounting a provider from a URI.
+   * Injected by CLI layer (afs-loader.ts) with full pipeline:
+   *   1. ProviderRegistry.createProvider({ uri, path, ...options }) → provider instance
+   *   2. afs.mount(provider, path)
+   *
+   * Used by root-level /.actions/mount action and registry mount action.
+   */
+  loadProvider?: (uri: string, path: string, options?: Record<string, unknown>) => Promise<void>;
+  /**
+   * Injectable callback for removing a provider's config on unmount.
+   * Injected by CLI layer (afs-loader.ts) for persistence sync.
+   */
+  unloadProvider?: (path: string, options?: Record<string, unknown>) => Promise<void>;
+  /**
+   * Injectable callback for updating a provider's options in the config file.
+   * Injected by CLI layer (afs-loader.ts) for persistence sync.
+   * Used by providers to persist runtime config changes (e.g., default model selection).
+   */
+  updateProviderConfig?: (mountPath: string, optionUpdates: Record<string, unknown>) => Promise<void>;
+  constructor(options?: AFSOptions);
+  /**
+   * Internal storage: Map<compositeKey, MountEntry>
+   * compositeKey = `${namespace ?? ""}:${path}`
+   */
+  private mounts;
+  /**
+   * Legacy compatibility: Map<path, AFSModule> for modules mounted via old API
+   * This is used internally by findModules for backward compatibility
+   */
+  private get modules();
+  /**
+   * Create composite key for mount storage
+   */
+  private makeKey;
+  /**
+   * Check if write operations are allowed for the given module.
+   * Throws AFSReadonlyError if not allowed.
+   */
+  /** Fire-and-forget change notification */
+  private notifyChange;
+  private checkWritePermission;
+  /**
+   * Check provider availability on mount.
+   * Validates that the provider can successfully respond to stat/read
+   * and list (if childrenCount indicates children exist).
+   *
+   * @throws AFSMountError if validation fails
+   */
+  private checkProviderOnMount;
+  /**
+   * Mount a module at a path in a namespace
+   *
+   * @param module - The module to mount
+   * @param path - The path to mount at (optional, defaults to /modules/{module.name} for backward compatibility)
+   * @param options - Mount options (namespace, replace)
+   */
+  mount(module: AFSModule, path?: string, options?: MountOptions): Promise<this>;
+  /**
+   * Get all mounts, optionally filtered by namespace
+   *
+   * @param namespace - Filter by namespace (undefined = all, null = default only)
+   */
+  getMounts(namespace?: string | null): MountInfo[];
+  /**
+   * Get all unique namespaces that have mounts
+   */
+  getNamespaces(): (string | null)[];
+  /**
+   * Unmount a module at a path in a namespace
+   *
+   * @param path - The path to unmount
+   * @param namespace - The namespace (undefined/null for default namespace)
+   * @returns true if unmounted, false if not found
+   */
+  unmount(path: string, namespace?: string | null): boolean;
+  /**
+   * Check if a path is mounted in a namespace
+   *
+   * @param path - The path to check
+   * @param namespace - The namespace (undefined/null for default namespace)
+   */
+  isMounted(path: string, namespace?: string | null): boolean;
+  listModules(): Promise<{
+    name: string;
+    path: string;
+    namespace: string | null;
+    description?: string;
+    module: AFSModule;
+  }[]>;
+  /**
+   * Parse a path and extract namespace if it's a canonical path
+   * Returns the namespace and the path within the namespace
+   */
+  private parsePathWithNamespace;
+  /**
+   * Find modules that can handle a path in a specific namespace
+   */
+  private findModulesInNamespace;
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  private _list;
+  /**
+   * Check if a path should skip auto-enrichment.
+   * Paths ending with /.meta or /.actions should not be enriched
+   * to avoid recursive fetches, but their children (e.g., /.meta/kinds)
+   * can still be enriched.
+   */
+  private shouldSkipEnrich;
+  /**
+   * Fetch actions for a path by listing path/.actions.
+   * Returns ActionSummary[] on success, [] on failure.
+   */
+  private fetchActions;
+  /**
+   * Fetch meta for a path by reading path/.meta.
+   * Returns the meta content on success, null on failure.
+   */
+  private fetchMeta;
+  /**
+   * Type for data that can be enriched (has path, optional actions, optional meta)
+   */
+  private enrichData;
+  read(path: string, _options?: AFSReadOptions): Promise<AFSReadResult>;
+  /**
+   * Check if a path is a virtual intermediate directory.
+   * Returns a read result if the path is a parent of one or more mount paths.
+   */
+  private resolveVirtualDirectory;
+  /**
+   * Aggregate capabilities from all mounted providers.
+   *
+   * For each provider:
+   * - Read /.meta/.capabilities
+   * - Merge tools with provider prefix and mount path prefix
+   * - Merge actions with mount path prefix on discovery.pathTemplate
+   * - Silently skip providers that fail or don't implement capabilities
+   */
+  private aggregateCapabilities;
+  write(path: string, content: AFSWriteEntryPayload, options?: AFSWriteOptions): Promise<AFSWriteResult>;
+  delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
+  rename(oldPath: string, newPath: string, options?: AFSRenameOptions): Promise<AFSRenameResult>;
+  search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  private _search;
+  exec(path: string, args: Record<string, any>, options?: AFSExecOptions): Promise<AFSExecResult>;
+  /**
+   * Read a root-level action entry (/.actions/mount, /.actions/unmount).
+   * Returns the action entry with metadata including inputSchema.
+   */
+  private readRootAction;
+  /**
+   * Read root metadata (/.meta).
+   * Returns mounted providers list, root actions, and childrenCount.
+   */
+  private readRootMeta;
+  /**
+   * Read root actions directory (/.actions).
+   * Returns content with actions list.
+   */
+  private readRootActions;
+  /**
+   * Stat a root action path (/.actions or /.actions/{name}).
+   */
+  private statRootAction;
+  /**
+   * Stat a root meta path (/.meta or /.meta/{subpath}).
+   */
+  private statRootMeta;
+  /**
+   * List root-level actions (/.actions).
+   */
+  private listRootActions;
+  /**
+   * Handle root-level action execution (/.actions/*).
+   * Supports:
+   * - /.actions/mount: Load and mount a provider via loadProvider
+   * - /.actions/unmount: Unmount a provider at a given path
+   */
+  private execRootAction;
+  /**
+   * Execute root-level mount action.
+   * Validates input and delegates to loadProvider.
+   */
+  private execRootMountAction;
+  /**
+   * Execute root-level unmount action.
+   * Validates input and delegates to unmount().
+   */
+  private execRootUnmountAction;
+  /**
+   * Validate exec input args against inputSchema.
+   * Throws AFSValidationError if validation fails.
+   * Uses zod-from-json-schema for full JSON Schema validation.
+   */
+  private validateExecInput;
+  /**
+   * Get stat information for a path
+   *
+   * Resolution order:
+   * 1. Provider's stat() method (if implemented)
+   * 2. Fallback to read() - extracts stat data from AFSEntry
+   *
+   * This allows providers to implement only read() while stat() still works.
+   */
+  stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult>;
+  /**
+   * Get human-readable explanation for a path
+   *
+   * Resolution order:
+   * 1. Provider's explain() method (if implemented)
+   * 2. Fallback to stat() - builds explanation from metadata
+   *
+   * This allows providers to skip implementing explain() while it still works.
+   */
+  explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult>;
+  /**
+   * Format bytes to human-readable string
+   */
+  private buildVirtualDirExplain;
+  /**
+   * Explain root path ('/').
+   * Generates a complete navigation guide with 4 required sections.
+   */
+  private explainRoot;
+  /**
+   * Explain a root action path (/.actions or /.actions/{name}).
+   */
+  private explainRootAction;
+  /**
+   * Explain a root meta path (/.meta or /.meta/{subpath}).
+   */
+  private explainRootMeta;
+  /**
+   * Build explain markdown from stat data.
+   * Used by both the module-found fallback and the no-module safety net.
+   */
+  private buildExplainFromStat;
+  private formatBytes;
+  private physicalPath?;
+  initializePhysicalPath(): Promise<string>;
+  cleanupPhysicalPath(): Promise<void>;
+}
+//#endregion
+export { AFS, AFSOptions, MountInfo, MountOptions };
+//# sourceMappingURL=afs.d.mts.map

package/dist/afs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"afs.d.mts","names":[],"sources":["../src/afs.ts"],"mappings":"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"}