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

package/dist/index.d.cts

@@ -1,300 +1,18 @@
-import { Emitter } from "strict-event-emitter";
-import { ZodType, z } from "zod";
-
-//#region src/type.d.ts
-/**
- * Access mode for AFS modules and root.
- * - "readonly": Only read operations are allowed (list, read, search)
- * - "readwrite": All operations are allowed
- */
-type AFSAccessMode = "readonly" | "readwrite";
-/**
- * Zod schema for access mode validation.
- * Can be reused across modules that support access mode configuration.
- */
-declare const accessModeSchema: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
-interface AFSOperationOptions {
-  context?: any;
-}
-interface AFSListOptions extends AFSOperationOptions {
-  filter?: {
-    agentId?: string;
-    userId?: string;
-    sessionId?: string;
-    before?: string;
-    after?: string;
-  };
-  maxDepth?: number;
-  limit?: number;
-  orderBy?: [string, "asc" | "desc"][];
-  maxChildren?: number;
-  onOverflow?: "truncate";
-  /**
-       * Whether to disable .gitignore files when listing files.
-       * @default false
-       */
-  disableGitignore?: boolean;
-  /**
-       * Glob pattern to filter entries by path.
-       * Examples: "*.ts", "**\/*.js", "src/**\/*.{ts,tsx}"
-       */
-  pattern?: string;
-}
-interface AFSListResult {
-  data: AFSEntry[];
-  message?: string;
-}
-interface AFSSearchOptions extends AFSOperationOptions {
-  limit?: number;
-  caseSensitive?: boolean;
-}
-interface AFSSearchResult {
-  data: AFSEntry[];
-  message?: string;
-}
-interface AFSReadOptions extends AFSOperationOptions {
-  filter?: AFSListOptions["filter"];
-}
-interface AFSReadResult {
-  data?: AFSEntry;
-  message?: string;
-}
-interface AFSDeleteOptions extends AFSOperationOptions {
-  recursive?: boolean;
-}
-interface AFSDeleteResult {
-  message?: string;
-}
-interface AFSRenameOptions extends AFSOperationOptions {
-  overwrite?: boolean;
-}
-interface AFSRenameResult {
-  message?: string;
-}
-interface AFSWriteOptions extends AFSOperationOptions {
-  append?: boolean;
-}
-interface AFSWriteResult {
-  data: AFSEntry;
-  message?: string;
-  context?: any;
-}
-interface AFSWriteEntryPayload extends Omit<AFSEntry, "id" | "path"> {}
-interface AFSExecOptions extends AFSOperationOptions {}
-interface AFSExecResult {
-  data: Record<string, any>;
-}
-interface AFSModule {
-  readonly name: string;
-  readonly description?: string;
-  /**
-       * Access mode for this module.
-       * - "readonly": Only read operations are allowed
-       * - "readwrite": All operations are allowed
-       * Default behavior is implementation-specific.
-       */
-  readonly accessMode?: AFSAccessMode;
-  /**
-       * Enable automatic agent skill scanning for this module.
-       * When set to true, the system will scan this module for agent skills.
-       * @default false
-       */
-  readonly agentSkills?: boolean;
-  onMount?(root: AFSRoot): void;
-  symlinkToPhysical?(path: string): Promise<void>;
-  list?(path: string, options?: AFSListOptions): Promise<AFSListResult>;
-  read?(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
-  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>;
-  exec?(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
-}
-/**
- * Parameters for loading a module from configuration.
- */
-interface AFSModuleLoadParams {
-  /** Path to the configuration file */
-  filepath: string;
-  /** Parsed configuration object */
-  parsed?: object;
-}
-/**
- * Interface for module classes that support schema validation and loading from configuration.
- * This describes the static part of a module class.
- *
- * @example
- * ```typescript
- * class MyModule implements AFSModule {
- *   static schema() { return mySchema; }
- *   static async load(params: AFSModuleLoadParams) { ... }
- *   // ...
- * }
- *
- * // Type check
- * const _check: AFSModuleClass<MyModule, MyModuleOptions> = MyModule;
- * ```
- */
-interface AFSModuleClass<T extends AFSModule = AFSModule, O extends object = object> {
-  /** Returns the Zod schema for validating module configuration */
-  schema(): ZodType<O>;
-  /** Loads a module instance from configuration file path and parsed config */
-  load(params: AFSModuleLoadParams): Promise<T>;
-  /** Constructor */
-  new (options: O): T;
-}
-type AFSRootEvents = {
-  agentSucceed: [{
-    agentId?: string;
-    userId?: string;
-    sessionId?: string;
-    input: object;
-    output: object;
-    messages?: object[];
-  }];
-  historyCreated: [{
-    entry: AFSEntry;
-  }, options: AFSOperationOptions];
-};
-interface AFSRootListOptions extends AFSListOptions, AFSContextPreset {
-  preset?: string;
-}
-interface AFSRootListResult extends Omit<AFSListResult, "data"> {
-  data: any;
-}
-interface AFSRootSearchOptions extends AFSSearchOptions, AFSContextPreset {
-  preset?: string;
-}
-interface AFSRootSearchResult extends Omit<AFSSearchResult, "data"> {
-  data: any;
-}
-interface AFSRoot extends Emitter<AFSRootEvents>, AFSModule {
-  list(path: string, options?: AFSRootListOptions): Promise<AFSRootListResult>;
-  search(path: string, query: string, options: AFSRootSearchOptions): Promise<AFSRootSearchResult>;
-  initializePhysicalPath(): Promise<string>;
-  cleanupPhysicalPath(): Promise<void>;
-}
-interface AFSEntryMetadata extends Record<string, any> {
-  execute?: {
-    name: string;
-    description?: string;
-    inputSchema?: Record<string, any>;
-    outputSchema?: Record<string, any>;
-  };
-  childrenCount?: number;
-  childrenTruncated?: boolean;
-  gitignored?: boolean;
-}
-interface AFSEntry<T = any> {
-  id: string;
-  createdAt?: Date;
-  updatedAt?: Date;
-  path: string;
-  agentId?: string | null;
-  userId?: string | null;
-  sessionId?: string | null;
-  summary?: string | null;
-  description?: string | null;
-  metadata?: AFSEntryMetadata | null;
-  linkTo?: string | null;
-  content?: T;
-}
-declare const afsEntrySchema: ZodType<AFSEntry>;
-interface AFSContextPreset {
-  /**
-       * The view template for presenting the search results.
-       */
-  view?: string;
-  select?: AFSContextPresetOptionAgent<{
-    path: string;
-    query?: string;
-  }, {
-    data: string[];
-  }>;
-  per?: AFSContextPresetOptionAgent<{
-    data: AFSEntry;
-  }, {
-    data: unknown;
-  }>;
-  dedupe?: AFSContextPresetOptionAgent<{
-    data: unknown[];
-  }, {
-    data: unknown;
-  }>;
-  format?: "default" | "simple-list" | "tree" | AFSContextPresetOptionAgent<{
-    data: unknown;
-  }, {
-    data: unknown;
-  }>;
-}
-interface AFSContextPresetOptionAgent<I = any, O = any> {
-  invoke(input: I, options?: any): Promise<O>;
-}
-interface AFSContext {
-  search?: {
-    presets?: Record<string, AFSContextPreset>;
-  };
-  list?: {
-    presets?: Record<string, AFSContextPreset>;
-  };
-}
-//#endregion
-//#region src/afs.d.ts
-interface AFSOptions {
-  modules?: AFSModule[];
-  context?: AFSContext;
-}
-declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
-  options: AFSOptions;
-  name: string;
-  constructor(options?: AFSOptions);
-  private modules;
-  /**
-       * Check if write operations are allowed for the given module.
-       * Throws AFSReadonlyError if not allowed.
-       */
-  private checkWritePermission;
-  mount(module: AFSModule): this;
-  listModules(): Promise<{
-    name: string;
-    path: string;
-    description?: string;
-    module: AFSModule;
-  }[]>;
-  list(path: string, options?: AFSRootListOptions): Promise<AFSRootListResult>;
-  private _list;
-  read(path: string, _options?: AFSReadOptions): Promise<AFSReadResult>;
-  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?: AFSRootSearchOptions): Promise<AFSRootSearchResult>;
-  private processWithPreset;
-  private _select;
-  private _search;
-  private findModules;
-  exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
-  private buildSimpleListView;
-  private buildTreeView;
-  private buildMetadataSuffix;
-  private physicalPath?;
-  initializePhysicalPath(): Promise<string>;
-  cleanupPhysicalPath(): Promise<void>;
-}
-//#endregion
-//#region src/error.d.ts
-/**
- * Base error class for all AFS errors.
- */
-declare class AFSError extends Error {
-  readonly code: string;
-  constructor(message: string, code: string);
-}
-/**
- * Error thrown when attempting write operations on a readonly AFS or module.
- */
-declare class AFSReadonlyError extends AFSError {
-  constructor(message: string);
-}
-//#endregion
-export { AFS, AFSAccessMode, AFSContext, AFSContextPreset, AFSContextPresetOptionAgent, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSError, AFSExecOptions, AFSExecResult, AFSListOptions, AFSListResult, AFSModule, AFSModuleClass, AFSModuleLoadParams, AFSOperationOptions, AFSOptions, AFSReadOptions, AFSReadResult, AFSReadonlyError, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSRootEvents, AFSRootListOptions, AFSRootListResult, AFSRootSearchOptions, AFSRootSearchResult, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult, accessModeSchema, afsEntrySchema };
-//# sourceMappingURL=index.d.cts.map
+import { JSONSchema7 } from "./node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.cjs";
+import { AFSExplainResult, KindSchema, MetaPathInfo, NodeConstraint, NodesConstraints, ValidationError, ValidationResult } from "./meta/type.cjs";
+import { AFSAccessMode, AFSActionResult, AFSChangeListener, AFSChangeRecord, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSListOptions, AFSListResult, AFSModule, AFSModuleClass, AFSModuleLoadParams, AFSOperationOptions, AFSReadOptions, AFSReadResult, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult, ActionSummary, AuthContext, CallbackServer, MountConfig, ProviderManifest, accessModeSchema, actionSummarySchema, afsEntrySchema } from "./type.cjs";
+import { AFS, AFSOptions, MountInfo, MountOptions } from "./afs.cjs";
+import { ActionCatalog, ActionDefinition, AggregatedCapabilities, CapabilitiesManifest, OperationsDeclaration, ToolDefinition } from "./capabilities/types.cjs";
+import { AFSWorldMappingCapable, ExternalRef, MappingStatus, MutateAction, MutateResult, ProjectionContext, isWorldMappingCapable } from "./capabilities/world-mapping.cjs";
+import { AFSError, AFSMountError, AFSNotFoundError, AFSReadonlyError, AFSValidationError } from "./error.cjs";
+import { Kind, KindDefinition, KindError, KindResolver, createKindResolver, defaultKindResolver, defineKind, getInheritanceChain, resolveKindSchema } from "./meta/kind.cjs";
+import { KINDS_SEGMENT, META_SEGMENT, getNodePathFromMetaPath, isKindsPath, isMetaPath, parseMetaPath } from "./meta/path.cjs";
+import { combineValidationResults, validateNodes } from "./meta/validation.cjs";
+import { WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, afsDocument, afsExecutable, afsImage, afsLink, afsNode, commonMetaSchema, getWellKnownKind, isWellKnownKind } from "./meta/well-known-kinds.cjs";
+import { AFSPathError, ParsedCanonicalPath, isCanonicalPath, normalizePath, parseCanonicalPath, toCanonicalPath, validateModuleName, validatePath } from "./path.cjs";
+import { DeleteRouteHandler, ExecRouteHandler, ExplainRouteHandler, ListDecoratorOptions, ListHandlerResult, ListRouteHandler, ReadRouteHandler, RenameRouteHandler, RouteContext, RouteDefinition, RouteHandler, RouteMatch, RouteMetadata, RouteOperation, SearchRouteHandler, StatRouteHandler, WriteRouteHandler } from "./provider/types.cjs";
+import { ProviderRouter } from "./provider/router.cjs";
+import { AFSBaseProvider } from "./provider/base.cjs";
+import { Actions, Delete, Exec, Explain, List, Meta, Read, Rename, Search, Stat, Write, clearRoutes, getRoutes } from "./provider/decorators.cjs";
+import { ProviderFactory, ProviderRegistry } from "./registry.cjs";
+export { AFS, AFSAccessMode, AFSActionResult, AFSBaseProvider, AFSChangeListener, AFSChangeRecord, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSError, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSExplainResult, AFSListOptions, AFSListResult, AFSModule, AFSModuleClass, AFSModuleLoadParams, AFSMountError, AFSNotFoundError, AFSOperationOptions, AFSOptions, AFSPathError, AFSReadOptions, AFSReadResult, AFSReadonlyError, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSValidationError, AFSWorldMappingCapable, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult, ActionCatalog, ActionDefinition, ActionSummary, Actions, AggregatedCapabilities, AuthContext, CallbackServer, CapabilitiesManifest, Delete, DeleteRouteHandler, Exec, ExecRouteHandler, Explain, ExplainRouteHandler, ExternalRef, JSONSchema7, KINDS_SEGMENT, Kind, KindDefinition, KindError, KindResolver, KindSchema, List, ListDecoratorOptions, ListHandlerResult, ListRouteHandler, META_SEGMENT, MappingStatus, Meta, MetaPathInfo, MountConfig, MountInfo, MountOptions, MutateAction, MutateResult, NodeConstraint, NodesConstraints, OperationsDeclaration, ParsedCanonicalPath, ProjectionContext, ProviderFactory, ProviderManifest, ProviderRegistry, ProviderRouter, Read, ReadRouteHandler, Rename, RenameRouteHandler, RouteContext, RouteDefinition, RouteHandler, RouteMatch, RouteMetadata, RouteOperation, Search, SearchRouteHandler, Stat, StatRouteHandler, ToolDefinition, ValidationError, ValidationResult, WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, Write, WriteRouteHandler, accessModeSchema, actionSummarySchema, afsDocument, afsEntrySchema, afsExecutable, afsImage, afsLink, afsNode, clearRoutes, combineValidationResults, commonMetaSchema, createKindResolver, defaultKindResolver, defineKind, getInheritanceChain, getNodePathFromMetaPath, getRoutes, getWellKnownKind, isCanonicalPath, isKindsPath, isMetaPath, isWellKnownKind, isWorldMappingCapable, normalizePath, parseCanonicalPath, parseMetaPath, resolveKindSchema, toCanonicalPath, validateModuleName, validateNodes, validatePath };

package/dist/index.d.mts

@@ -1,300 +1,20 @@
-import { Emitter } from "strict-event-emitter";
-import { ZodType, z } from "zod";
-
-//#region src/type.d.ts
-/**
- * Access mode for AFS modules and root.
- * - "readonly": Only read operations are allowed (list, read, search)
- * - "readwrite": All operations are allowed
- */
-type AFSAccessMode = "readonly" | "readwrite";
-/**
- * Zod schema for access mode validation.
- * Can be reused across modules that support access mode configuration.
- */
-declare const accessModeSchema: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
-interface AFSOperationOptions {
-  context?: any;
-}
-interface AFSListOptions extends AFSOperationOptions {
-  filter?: {
-    agentId?: string;
-    userId?: string;
-    sessionId?: string;
-    before?: string;
-    after?: string;
-  };
-  maxDepth?: number;
-  limit?: number;
-  orderBy?: [string, "asc" | "desc"][];
-  maxChildren?: number;
-  onOverflow?: "truncate";
-  /**
-       * Whether to disable .gitignore files when listing files.
-       * @default false
-       */
-  disableGitignore?: boolean;
-  /**
-       * Glob pattern to filter entries by path.
-       * Examples: "*.ts", "**\/*.js", "src/**\/*.{ts,tsx}"
-       */
-  pattern?: string;
-}
-interface AFSListResult {
-  data: AFSEntry[];
-  message?: string;
-}
-interface AFSSearchOptions extends AFSOperationOptions {
-  limit?: number;
-  caseSensitive?: boolean;
-}
-interface AFSSearchResult {
-  data: AFSEntry[];
-  message?: string;
-}
-interface AFSReadOptions extends AFSOperationOptions {
-  filter?: AFSListOptions["filter"];
-}
-interface AFSReadResult {
-  data?: AFSEntry;
-  message?: string;
-}
-interface AFSDeleteOptions extends AFSOperationOptions {
-  recursive?: boolean;
-}
-interface AFSDeleteResult {
-  message?: string;
-}
-interface AFSRenameOptions extends AFSOperationOptions {
-  overwrite?: boolean;
-}
-interface AFSRenameResult {
-  message?: string;
-}
-interface AFSWriteOptions extends AFSOperationOptions {
-  append?: boolean;
-}
-interface AFSWriteResult {
-  data: AFSEntry;
-  message?: string;
-  context?: any;
-}
-interface AFSWriteEntryPayload extends Omit<AFSEntry, "id" | "path"> {}
-interface AFSExecOptions extends AFSOperationOptions {}
-interface AFSExecResult {
-  data: Record<string, any>;
-}
-interface AFSModule {
-  readonly name: string;
-  readonly description?: string;
-  /**
-       * Access mode for this module.
-       * - "readonly": Only read operations are allowed
-       * - "readwrite": All operations are allowed
-       * Default behavior is implementation-specific.
-       */
-  readonly accessMode?: AFSAccessMode;
-  /**
-       * Enable automatic agent skill scanning for this module.
-       * When set to true, the system will scan this module for agent skills.
-       * @default false
-       */
-  readonly agentSkills?: boolean;
-  onMount?(root: AFSRoot): void;
-  symlinkToPhysical?(path: string): Promise<void>;
-  list?(path: string, options?: AFSListOptions): Promise<AFSListResult>;
-  read?(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
-  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>;
-  exec?(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
-}
-/**
- * Parameters for loading a module from configuration.
- */
-interface AFSModuleLoadParams {
-  /** Path to the configuration file */
-  filepath: string;
-  /** Parsed configuration object */
-  parsed?: object;
-}
-/**
- * Interface for module classes that support schema validation and loading from configuration.
- * This describes the static part of a module class.
- *
- * @example
- * ```typescript
- * class MyModule implements AFSModule {
- *   static schema() { return mySchema; }
- *   static async load(params: AFSModuleLoadParams) { ... }
- *   // ...
- * }
- *
- * // Type check
- * const _check: AFSModuleClass<MyModule, MyModuleOptions> = MyModule;
- * ```
- */
-interface AFSModuleClass<T extends AFSModule = AFSModule, O extends object = object> {
-  /** Returns the Zod schema for validating module configuration */
-  schema(): ZodType<O>;
-  /** Loads a module instance from configuration file path and parsed config */
-  load(params: AFSModuleLoadParams): Promise<T>;
-  /** Constructor */
-  new (options: O): T;
-}
-type AFSRootEvents = {
-  agentSucceed: [{
-    agentId?: string;
-    userId?: string;
-    sessionId?: string;
-    input: object;
-    output: object;
-    messages?: object[];
-  }];
-  historyCreated: [{
-    entry: AFSEntry;
-  }, options: AFSOperationOptions];
-};
-interface AFSRootListOptions extends AFSListOptions, AFSContextPreset {
-  preset?: string;
-}
-interface AFSRootListResult extends Omit<AFSListResult, "data"> {
-  data: any;
-}
-interface AFSRootSearchOptions extends AFSSearchOptions, AFSContextPreset {
-  preset?: string;
-}
-interface AFSRootSearchResult extends Omit<AFSSearchResult, "data"> {
-  data: any;
-}
-interface AFSRoot extends Emitter<AFSRootEvents>, AFSModule {
-  list(path: string, options?: AFSRootListOptions): Promise<AFSRootListResult>;
-  search(path: string, query: string, options: AFSRootSearchOptions): Promise<AFSRootSearchResult>;
-  initializePhysicalPath(): Promise<string>;
-  cleanupPhysicalPath(): Promise<void>;
-}
-interface AFSEntryMetadata extends Record<string, any> {
-  execute?: {
-    name: string;
-    description?: string;
-    inputSchema?: Record<string, any>;
-    outputSchema?: Record<string, any>;
-  };
-  childrenCount?: number;
-  childrenTruncated?: boolean;
-  gitignored?: boolean;
-}
-interface AFSEntry<T = any> {
-  id: string;
-  createdAt?: Date;
-  updatedAt?: Date;
-  path: string;
-  agentId?: string | null;
-  userId?: string | null;
-  sessionId?: string | null;
-  summary?: string | null;
-  description?: string | null;
-  metadata?: AFSEntryMetadata | null;
-  linkTo?: string | null;
-  content?: T;
-}
-declare const afsEntrySchema: ZodType<AFSEntry>;
-interface AFSContextPreset {
-  /**
-       * The view template for presenting the search results.
-       */
-  view?: string;
-  select?: AFSContextPresetOptionAgent<{
-    path: string;
-    query?: string;
-  }, {
-    data: string[];
-  }>;
-  per?: AFSContextPresetOptionAgent<{
-    data: AFSEntry;
-  }, {
-    data: unknown;
-  }>;
-  dedupe?: AFSContextPresetOptionAgent<{
-    data: unknown[];
-  }, {
-    data: unknown;
-  }>;
-  format?: "default" | "simple-list" | "tree" | AFSContextPresetOptionAgent<{
-    data: unknown;
-  }, {
-    data: unknown;
-  }>;
-}
-interface AFSContextPresetOptionAgent<I = any, O = any> {
-  invoke(input: I, options?: any): Promise<O>;
-}
-interface AFSContext {
-  search?: {
-    presets?: Record<string, AFSContextPreset>;
-  };
-  list?: {
-    presets?: Record<string, AFSContextPreset>;
-  };
-}
-//#endregion
-//#region src/afs.d.ts
-interface AFSOptions {
-  modules?: AFSModule[];
-  context?: AFSContext;
-}
-declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
-  options: AFSOptions;
-  name: string;
-  constructor(options?: AFSOptions);
-  private modules;
-  /**
-       * Check if write operations are allowed for the given module.
-       * Throws AFSReadonlyError if not allowed.
-       */
-  private checkWritePermission;
-  mount(module: AFSModule): this;
-  listModules(): Promise<{
-    name: string;
-    path: string;
-    description?: string;
-    module: AFSModule;
-  }[]>;
-  list(path: string, options?: AFSRootListOptions): Promise<AFSRootListResult>;
-  private _list;
-  read(path: string, _options?: AFSReadOptions): Promise<AFSReadResult>;
-  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?: AFSRootSearchOptions): Promise<AFSRootSearchResult>;
-  private processWithPreset;
-  private _select;
-  private _search;
-  private findModules;
-  exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
-  private buildSimpleListView;
-  private buildTreeView;
-  private buildMetadataSuffix;
-  private physicalPath?;
-  initializePhysicalPath(): Promise<string>;
-  cleanupPhysicalPath(): Promise<void>;
-}
-//#endregion
-//#region src/error.d.ts
-/**
- * Base error class for all AFS errors.
- */
-declare class AFSError extends Error {
-  readonly code: string;
-  constructor(message: string, code: string);
-}
-/**
- * Error thrown when attempting write operations on a readonly AFS or module.
- */
-declare class AFSReadonlyError extends AFSError {
-  constructor(message: string);
-}
-//#endregion
-export { AFS, AFSAccessMode, AFSContext, AFSContextPreset, AFSContextPresetOptionAgent, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSError, AFSExecOptions, AFSExecResult, AFSListOptions, AFSListResult, AFSModule, AFSModuleClass, AFSModuleLoadParams, AFSOperationOptions, AFSOptions, AFSReadOptions, AFSReadResult, AFSReadonlyError, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSRootEvents, AFSRootListOptions, AFSRootListResult, AFSRootSearchOptions, AFSRootSearchResult, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult, accessModeSchema, afsEntrySchema };
-//# sourceMappingURL=index.d.mts.map
+import { JSONSchema7 } from "./node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.mjs";
+import { AFSExplainResult, KindSchema, MetaPathInfo, NodeConstraint, NodesConstraints, ValidationError, ValidationResult } from "./meta/type.mjs";
+import { AFSAccessMode, AFSActionResult, AFSChangeListener, AFSChangeRecord, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSListOptions, AFSListResult, AFSModule, AFSModuleClass, AFSModuleLoadParams, AFSOperationOptions, AFSReadOptions, AFSReadResult, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult, ActionSummary, AuthContext, CallbackServer, MountConfig, ProviderManifest, accessModeSchema, actionSummarySchema, afsEntrySchema } from "./type.mjs";
+import { AFS, AFSOptions, MountInfo, MountOptions } from "./afs.mjs";
+import { ActionCatalog, ActionDefinition, AggregatedCapabilities, CapabilitiesManifest, OperationsDeclaration, ToolDefinition } from "./capabilities/types.mjs";
+import { AFSWorldMappingCapable, ExternalRef, MappingStatus, MutateAction, MutateResult, ProjectionContext, isWorldMappingCapable } from "./capabilities/world-mapping.mjs";
+import "./capabilities/index.mjs";
+import { AFSError, AFSMountError, AFSNotFoundError, AFSReadonlyError, AFSValidationError } from "./error.mjs";
+import { Kind, KindDefinition, KindError, KindResolver, createKindResolver, defaultKindResolver, defineKind, getInheritanceChain, resolveKindSchema } from "./meta/kind.mjs";
+import { KINDS_SEGMENT, META_SEGMENT, getNodePathFromMetaPath, isKindsPath, isMetaPath, parseMetaPath } from "./meta/path.mjs";
+import { combineValidationResults, validateNodes } from "./meta/validation.mjs";
+import { WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, afsDocument, afsExecutable, afsImage, afsLink, afsNode, commonMetaSchema, getWellKnownKind, isWellKnownKind } from "./meta/well-known-kinds.mjs";
+import { AFSPathError, ParsedCanonicalPath, isCanonicalPath, normalizePath, parseCanonicalPath, toCanonicalPath, validateModuleName, validatePath } from "./path.mjs";
+import { DeleteRouteHandler, ExecRouteHandler, ExplainRouteHandler, ListDecoratorOptions, ListHandlerResult, ListRouteHandler, ReadRouteHandler, RenameRouteHandler, RouteContext, RouteDefinition, RouteHandler, RouteMatch, RouteMetadata, RouteOperation, SearchRouteHandler, StatRouteHandler, WriteRouteHandler } from "./provider/types.mjs";
+import { ProviderRouter } from "./provider/router.mjs";
+import { AFSBaseProvider } from "./provider/base.mjs";
+import { Actions, Delete, Exec, Explain, List, Meta, Read, Rename, Search, Stat, Write, clearRoutes, getRoutes } from "./provider/decorators.mjs";
+import "./provider/index.mjs";
+import { ProviderFactory, ProviderRegistry } from "./registry.mjs";
+export { AFS, AFSAccessMode, AFSActionResult, AFSBaseProvider, AFSChangeListener, AFSChangeRecord, AFSDeleteOptions, AFSDeleteResult, AFSEntry, AFSEntryMetadata, AFSError, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSExplainResult, AFSListOptions, AFSListResult, AFSModule, AFSModuleClass, AFSModuleLoadParams, AFSMountError, AFSNotFoundError, AFSOperationOptions, AFSOptions, AFSPathError, AFSReadOptions, AFSReadResult, AFSReadonlyError, AFSRenameOptions, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSValidationError, AFSWorldMappingCapable, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult, ActionCatalog, ActionDefinition, ActionSummary, Actions, AggregatedCapabilities, AuthContext, CallbackServer, CapabilitiesManifest, Delete, DeleteRouteHandler, Exec, ExecRouteHandler, Explain, ExplainRouteHandler, ExternalRef, JSONSchema7, KINDS_SEGMENT, Kind, KindDefinition, KindError, KindResolver, KindSchema, List, ListDecoratorOptions, ListHandlerResult, ListRouteHandler, META_SEGMENT, MappingStatus, Meta, MetaPathInfo, MountConfig, MountInfo, MountOptions, MutateAction, MutateResult, NodeConstraint, NodesConstraints, OperationsDeclaration, ParsedCanonicalPath, ProjectionContext, ProviderFactory, ProviderManifest, ProviderRegistry, ProviderRouter, Read, ReadRouteHandler, Rename, RenameRouteHandler, RouteContext, RouteDefinition, RouteHandler, RouteMatch, RouteMetadata, RouteOperation, Search, SearchRouteHandler, Stat, StatRouteHandler, ToolDefinition, ValidationError, ValidationResult, WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, Write, WriteRouteHandler, accessModeSchema, actionSummarySchema, afsDocument, afsEntrySchema, afsExecutable, afsImage, afsLink, afsNode, clearRoutes, combineValidationResults, commonMetaSchema, createKindResolver, defaultKindResolver, defineKind, getInheritanceChain, getNodePathFromMetaPath, getRoutes, getWellKnownKind, isCanonicalPath, isKindsPath, isMetaPath, isWellKnownKind, isWorldMappingCapable, normalizePath, parseCanonicalPath, parseMetaPath, resolveKindSchema, toCanonicalPath, validateModuleName, validateNodes, validatePath };