apcore-js 0.9.0 → 0.11.0

package/README.md

@@ -11,7 +11,7 @@ apcore provides a unified task orchestration framework with schema validation, a
 ## Features
 
 - **Schema-driven modules** — Define input/output schemas with TypeBox for runtime validation
-- **Executor pipeline** — 10-step execution pipeline: context → safety checks → lookup → ACL → validation → middleware before → execute → output validation → middleware after → return
+- **Executor pipeline** — 11-step execution pipeline: context → safety checks → lookup → ACL → approval gate → validation → middleware before → execute → output validation → middleware after → return
 - **Registry system** — File-based module discovery with metadata, dependencies, and topological ordering
 - **Binding loader** — YAML-based module registration for no-code integration
 - **Access control (ACL)** — Pattern-based rules with identity types, roles, and call-depth conditions
@@ -22,7 +22,7 @@ apcore provides a unified task orchestration framework with schema validation, a
 
 ## Documentation
 
-For full documentation, including Quick Start guides for both Python and TypeScript, visit:
+For full documentation, including Quick Start guides and API reference, visit:
 **[https://aipartnerup.github.io/apcore/getting-started.html](https://aipartnerup.github.io/apcore/getting-started.html)**
 
 ## Requirements
@@ -38,11 +38,39 @@ npm install apcore-js
 
 ## Quick Start
 
+### Simplified Client (Recommended)
+
+The `APCore` client provides a unified entry point that manages Registry and Executor for you:
+
+```typescript
+import { Type } from '@sinclair/typebox';
+import { APCore } from 'apcore-js';
+
+const client = new APCore();
+
+// Register a module
+client.module({
+  id: 'math.add',
+  description: 'Add two numbers',
+  inputSchema: Type.Object({ a: Type.Number(), b: Type.Number() }),
+  outputSchema: Type.Object({ sum: Type.Number() }),
+  execute: (inputs) => ({ sum: (inputs.a as number) + (inputs.b as number) }),
+});
+
+// Call, validate, stream — all from one client
+const result = await client.call('math.add', { a: 10, b: 5 });
+// => { sum: 15 }
+
+const preflight = client.validate('math.add', { a: 10, b: 5 });
+// => { valid: true, checks: [...], requiresApproval: false, errors: [] }
+```
+
+### Advanced: Manual Registry + Executor
+
 ```typescript
 import { Type } from '@sinclair/typebox';
 import { FunctionModule, Registry, Executor } from 'apcore-js';
 
-// Define a module
 const greet = new FunctionModule({
   execute: (inputs) => ({ greeting: `Hello, ${inputs.name}!` }),
   moduleId: 'example.greet',
@@ -51,7 +79,6 @@ const greet = new FunctionModule({
   description: 'Greet a user',
 });
 
-// Register and execute
 const registry = new Registry();
 registry.register('example.greet', greet);
 
@@ -60,12 +87,39 @@ const result = await executor.call('example.greet', { name: 'World' });
 // => { greeting: 'Hello, World!' }
 ```
 
+## API Overview
+
+| Class | Description |
+|-------|-------------|
+| `APCore` | High-level client — register modules, call, stream, validate |
+| `Registry` | Module storage — discover, register, get, list, watch |
+| `Executor` | Execution engine — call with middleware pipeline, ACL, approval |
+| `Context` | Request context — trace ID, identity, call chain, cancel token |
+| `Config` | Configuration — load from YAML, get/set values |
+| `ACL` | Access control — rule-based caller/target authorization |
+| `Middleware` | Pipeline hooks — before/after/onError interception |
+| `EventEmitter` | Event system — subscribe, emit, flush |
+
+## Examples
+
+The `examples/` directory contains runnable examples demonstrating key features:
+
+| Example | Description |
+|---------|-------------|
+| `simple-client.ts` | APCore client with module registration and calls |
+| `modules/greet.ts` | Minimal FunctionModule |
+| `modules/get-user.ts` | Readonly + idempotent annotations |
+| `modules/send-email.ts` | Full-featured: annotations, examples, metadata, ContextLogger |
+| `modules/decorated-add.ts` | `module()` function for creating modules |
+| `bindings/format-date/` | YAML binding with target function |
+
 ## Architecture
 
 ```
 src/
   index.ts              # Public API exports
-  executor.ts           # 10-step execution pipeline
+  client.ts             # High-level APCore client (unified entry point)
+  executor.ts           # 11-step execution pipeline
   context.ts            # Execution context and identity
   config.ts             # Dot-path configuration accessor
   acl.ts                # Access control with pattern matching
@@ -74,16 +128,27 @@ src/
   cancel.ts             # Cancellation token support
   decorator.ts          # FunctionModule class and helpers
   bindings.ts           # YAML binding loader
-  errors.ts             # Error hierarchy (30+ typed errors)
+  errors.ts             # Error hierarchy (35 typed errors)
+  error-code-registry.ts # Custom error code registration with collision detection
   extensions.ts         # Extension manager
   module.ts             # Module types and annotations
-  trace-context.ts     # W3C trace context (inject/extract)
+  trace-context.ts      # W3C trace context (inject/extract)
+  version.ts            # Version negotiation (semver parsing)
+  events/
+    index.ts            # Event module barrel exports
+    emitter.ts          # Global event bus with fan-out delivery
+    subscribers.ts      # Webhook and A2A protocol event subscribers
   middleware/
+    index.ts            # Middleware barrel exports
     base.ts             # Middleware base class
     manager.ts          # MiddlewareManager (onion model)
     adapters.ts         # BeforeMiddleware, AfterMiddleware adapters
     logging.ts          # LoggingMiddleware
+    retry.ts            # RetryMiddleware for automatic retry of retryable errors
+    error-history.ts    # Middleware that records errors into ErrorHistory
+    platform-notify.ts  # Threshold sensor with hysteresis for error/latency alerts
   registry/
+    index.ts            # Registry barrel exports
     registry.ts         # Registry with discover() pipeline
     scanner.ts          # File-based module discovery
     entry-point.ts      # Dynamic import and entry point resolution
@@ -93,18 +158,36 @@ src/
     schema-export.ts    # Schema export (JSON/YAML, strict/compact)
     types.ts            # Registry type definitions
   schema/
+    index.ts            # Schema barrel exports
     loader.ts           # JSON Schema to TypeBox conversion
     validator.ts        # Schema validation
     exporter.ts         # Schema serialization
     ref-resolver.ts     # $ref resolution
     strict.ts           # Strict schema transforms
     types.ts            # Schema type definitions
+    annotations.ts      # Annotation conflict resolution (YAML + code metadata)
   observability/
+    index.ts            # Observability barrel exports
     tracing.ts          # Span, SpanExporter, TracingMiddleware
     metrics.ts          # MetricsCollector, MetricsMiddleware
+    metrics-utils.ts    # Shared metric extraction utilities
     context-logger.ts   # ContextLogger, ObsLoggingMiddleware
+    usage.ts            # Time-windowed usage tracking with analytics
+    error-history.ts    # Error history with ring-buffer eviction and dedup
+  sys-modules/
+    index.ts            # System module barrel exports
+    registration.ts     # Auto-registration of sys.* modules and middleware
+    control.ts          # Runtime config update and hot-reload modules
+    health.ts           # System and per-module health modules
+    manifest.ts         # Module metadata and system manifest modules
+    toggle.ts           # Module disable/enable without unloading
+    usage.ts            # Usage summary and per-module usage detail modules
   utils/
+    index.ts            # Utils barrel exports
     pattern.ts          # Glob-style pattern matching
+    call-chain.ts       # Call chain safety guard (depth, frequency, cycles)
+    error-propagation.ts # Standardized error wrapping
+    normalize.ts        # Cross-language module ID normalization
 ```
 
 ## Development

package/dist/client.d.ts

@@ -0,0 +1,130 @@
+/**
+ * High-level client for apcore to simplify interaction.
+ */
+import type { TSchema } from '@sinclair/typebox';
+import type { Config } from './config.js';
+import type { Context } from './context.js';
+import { FunctionModule } from './decorator.js';
+import type { ApCoreEvent, EventSubscriber } from './events/emitter.js';
+import { EventEmitter } from './events/emitter.js';
+import { Executor } from './executor.js';
+import type { Middleware } from './middleware/index.js';
+import type { ModuleAnnotations, ModuleExample, PreflightResult } from './module.js';
+import type { MetricsCollector } from './observability/metrics.js';
+import { Registry } from './registry/registry.js';
+export interface APCoreOptions {
+    registry?: Registry;
+    executor?: Executor;
+    config?: Config;
+    metricsCollector?: MetricsCollector;
+}
+export interface ModuleOptions {
+    id?: string;
+    inputSchema: TSchema;
+    outputSchema: TSchema;
+    description?: string;
+    documentation?: string | null;
+    annotations?: ModuleAnnotations | null;
+    tags?: string[] | null;
+    version?: string;
+    metadata?: Record<string, unknown> | null;
+    examples?: ModuleExample[] | null;
+    execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
+}
+/**
+ * A high-level client that manages Registry and Executor.
+ *
+ * Provides a unified entry point for apcore, making it easier
+ * for beginners to get started without manually managing multiple objects.
+ */
+export declare class APCore {
+    readonly registry: Registry;
+    readonly executor: Executor;
+    readonly config: Config | null;
+    readonly metricsCollector: MetricsCollector | null;
+    private _sysModulesContext;
+    constructor(options?: APCoreOptions);
+    /**
+     * Create and register a FunctionModule.
+     *
+     * TypeScript version requires explicit schemas (no runtime type inference).
+     */
+    module(options: ModuleOptions): FunctionModule;
+    /**
+     * Register a module object directly.
+     */
+    register(moduleId: string, moduleObj: unknown): void;
+    /**
+     * Execute an async module call.
+     */
+    call(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null, versionHint?: string | null): Promise<Record<string, unknown>>;
+    /**
+     * Async module call (alias for call).
+     */
+    callAsync(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null, versionHint?: string | null): Promise<Record<string, unknown>>;
+    /**
+     * Stream module output chunk by chunk.
+     */
+    stream(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null, versionHint?: string | null): AsyncGenerator<Record<string, unknown>>;
+    /**
+     * Non-destructive preflight check without execution.
+     */
+    validate(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null): PreflightResult;
+    /**
+     * Get module description info (for AI/LLM use).
+     */
+    describe(moduleId: string): string;
+    /**
+     * Add class-based middleware. Returns self for chaining.
+     */
+    use(middleware: Middleware): APCore;
+    /**
+     * Add before function middleware. Returns self for chaining.
+     */
+    useBefore(callback: (moduleId: string, inputs: Record<string, unknown>, context: Context) => Record<string, unknown> | null): APCore;
+    /**
+     * Add after function middleware. Returns self for chaining.
+     */
+    useAfter(callback: (moduleId: string, inputs: Record<string, unknown>, output: Record<string, unknown>, context: Context) => Record<string, unknown> | null): APCore;
+    /**
+     * Remove middleware by identity. Returns true if found and removed.
+     */
+    remove(middleware: Middleware): boolean;
+    /**
+     * Discover and register modules from configured extension directories.
+     */
+    discover(): Promise<number>;
+    /**
+     * Return sorted list of registered module IDs, optionally filtered.
+     */
+    listModules(options?: {
+        tags?: string[];
+        prefix?: string;
+    }): string[];
+    /**
+     * Access the event emitter (available when sys_modules.events is enabled).
+     */
+    get events(): EventEmitter | null;
+    /**
+     * Subscribe to events of a specific type with a simple callback.
+     *
+     * Returns the subscriber for later unsubscription via off().
+     */
+    on(eventType: string, handler: (event: ApCoreEvent) => void | Promise<void>): EventSubscriber;
+    /**
+     * Unsubscribe a previously registered event subscriber.
+     */
+    off(subscriber: EventSubscriber): void;
+    /**
+     * Disable a module without unloading it.
+     * Convenience wrapper around system.control.toggle_feature.
+     */
+    disable(moduleId: string, reason?: string): Promise<Record<string, unknown>>;
+    /**
+     * Re-enable a previously disabled module.
+     * Convenience wrapper around system.control.toggle_feature.
+     */
+    enable(moduleId: string, reason?: string): Promise<Record<string, unknown>>;
+    private _requireSysModules;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,187 @@
+/**
+ * High-level client for apcore to simplify interaction.
+ */
+import { module as createModule } from './decorator.js';
+import { Executor } from './executor.js';
+import { Registry } from './registry/registry.js';
+import { registerSysModules } from './sys-modules/registration.js';
+/**
+ * A high-level client that manages Registry and Executor.
+ *
+ * Provides a unified entry point for apcore, making it easier
+ * for beginners to get started without manually managing multiple objects.
+ */
+export class APCore {
+    registry;
+    executor;
+    config;
+    metricsCollector;
+    _sysModulesContext = {};
+    constructor(options) {
+        this.registry = options?.registry ?? new Registry();
+        this.config = options?.config ?? null;
+        this.metricsCollector = options?.metricsCollector ?? null;
+        this.executor = options?.executor ?? new Executor({
+            registry: this.registry,
+            config: this.config,
+        });
+        // Auto-register sys modules if config is provided and enabled
+        if (this.config) {
+            this._sysModulesContext = registerSysModules(this.registry, this.executor, this.config, options?.metricsCollector);
+        }
+    }
+    /**
+     * Create and register a FunctionModule.
+     *
+     * TypeScript version requires explicit schemas (no runtime type inference).
+     */
+    module(options) {
+        return createModule({
+            ...options,
+            registry: this.registry,
+        });
+    }
+    /**
+     * Register a module object directly.
+     */
+    register(moduleId, moduleObj) {
+        this.registry.register(moduleId, moduleObj);
+    }
+    /**
+     * Execute an async module call.
+     */
+    async call(moduleId, inputs, context, versionHint) {
+        return this.executor.call(moduleId, inputs, context, versionHint);
+    }
+    /**
+     * Async module call (alias for call).
+     */
+    async callAsync(moduleId, inputs, context, versionHint) {
+        return this.executor.call(moduleId, inputs, context, versionHint);
+    }
+    /**
+     * Stream module output chunk by chunk.
+     */
+    async *stream(moduleId, inputs, context, versionHint) {
+        yield* this.executor.stream(moduleId, inputs, context, versionHint);
+    }
+    /**
+     * Non-destructive preflight check without execution.
+     */
+    validate(moduleId, inputs, context) {
+        return this.executor.validate(moduleId, inputs, context);
+    }
+    /**
+     * Get module description info (for AI/LLM use).
+     */
+    describe(moduleId) {
+        return this.registry.describe(moduleId);
+    }
+    /**
+     * Add class-based middleware. Returns self for chaining.
+     */
+    use(middleware) {
+        this.executor.use(middleware);
+        return this;
+    }
+    /**
+     * Add before function middleware. Returns self for chaining.
+     */
+    useBefore(callback) {
+        this.executor.useBefore(callback);
+        return this;
+    }
+    /**
+     * Add after function middleware. Returns self for chaining.
+     */
+    useAfter(callback) {
+        this.executor.useAfter(callback);
+        return this;
+    }
+    /**
+     * Remove middleware by identity. Returns true if found and removed.
+     */
+    remove(middleware) {
+        return this.executor.remove(middleware);
+    }
+    /**
+     * Discover and register modules from configured extension directories.
+     */
+    async discover() {
+        return this.registry.discover();
+    }
+    /**
+     * Return sorted list of registered module IDs, optionally filtered.
+     */
+    listModules(options) {
+        return this.registry.list(options);
+    }
+    /**
+     * Access the event emitter (available when sys_modules.events is enabled).
+     */
+    get events() {
+        return this._sysModulesContext.eventEmitter ?? null;
+    }
+    /**
+     * Subscribe to events of a specific type with a simple callback.
+     *
+     * Returns the subscriber for later unsubscription via off().
+     */
+    on(eventType, handler) {
+        const emitter = this.events;
+        if (!emitter) {
+            throw new Error('Events are not enabled. Set sys_modules.enabled=true and '
+                + 'sys_modules.events.enabled=true in config.');
+        }
+        const subscriber = {
+            onEvent(event) {
+                if (event.eventType === eventType) {
+                    return handler(event);
+                }
+            },
+        };
+        emitter.subscribe(subscriber);
+        return subscriber;
+    }
+    /**
+     * Unsubscribe a previously registered event subscriber.
+     */
+    off(subscriber) {
+        const emitter = this.events;
+        if (!emitter) {
+            throw new Error('Events are not enabled. Set sys_modules.enabled=true and '
+                + 'sys_modules.events.enabled=true in config.');
+        }
+        emitter.unsubscribe(subscriber);
+    }
+    /**
+     * Disable a module without unloading it.
+     * Convenience wrapper around system.control.toggle_feature.
+     */
+    async disable(moduleId, reason = 'Disabled via APCore client') {
+        this._requireSysModules('disable');
+        return this.executor.call('system.control.toggle_feature', {
+            module_id: moduleId,
+            enabled: false,
+            reason,
+        });
+    }
+    /**
+     * Re-enable a previously disabled module.
+     * Convenience wrapper around system.control.toggle_feature.
+     */
+    async enable(moduleId, reason = 'Enabled via APCore client') {
+        this._requireSysModules('enable');
+        return this.executor.call('system.control.toggle_feature', {
+            module_id: moduleId,
+            enabled: true,
+            reason,
+        });
+    }
+    _requireSysModules(method) {
+        if (!this._sysModulesContext.eventEmitter) {
+            throw new Error(`Cannot call ${method}(): sys_modules with events must be enabled in config.`);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -46,6 +46,10 @@ export declare class ModuleNotFoundError extends ModuleError {
     static readonly DEFAULT_RETRYABLE: boolean | null;
     constructor(moduleId: string, options?: ErrorOptions);
 }
+export declare class ModuleDisabledError extends ModuleError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, options?: ErrorOptions);
+}
 export declare class ModuleTimeoutError extends ModuleError {
     static readonly DEFAULT_RETRYABLE: boolean | null;
     constructor(moduleId: string, timeoutMs: number, options?: ErrorOptions);
@@ -126,10 +130,22 @@ export declare class CircularDependencyError extends ModuleError {
     static readonly DEFAULT_RETRYABLE: boolean | null;
     constructor(cyclePath: string[], options?: ErrorOptions);
 }
+export declare class DependencyNotFoundError extends ModuleError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, dependencyId: string, options?: ErrorOptions);
+}
+export declare class FeatureNotImplementedError extends ModuleError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message?: string, options?: ErrorOptions);
+}
 export declare class ModuleLoadError extends ModuleError {
     static readonly DEFAULT_RETRYABLE: boolean | null;
     constructor(moduleId: string, reason: string, options?: ErrorOptions);
 }
+export declare class ReloadFailedError extends ModuleError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, reason: string, options?: ErrorOptions);
+}
 export declare class ModuleExecuteError extends ModuleError {
     static readonly DEFAULT_RETRYABLE: boolean | null;
     constructor(moduleId: string, reason: string, options?: ErrorOptions);
@@ -172,8 +188,10 @@ export declare const ErrorCodes: Readonly<{
     readonly ACL_RULE_ERROR: "ACL_RULE_ERROR";
     readonly ACL_DENIED: "ACL_DENIED";
     readonly MODULE_NOT_FOUND: "MODULE_NOT_FOUND";
+    readonly MODULE_DISABLED: "MODULE_DISABLED";
     readonly MODULE_TIMEOUT: "MODULE_TIMEOUT";
     readonly MODULE_LOAD_ERROR: "MODULE_LOAD_ERROR";
+    readonly RELOAD_FAILED: "RELOAD_FAILED";
     readonly MODULE_EXECUTE_ERROR: "MODULE_EXECUTE_ERROR";
     readonly SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR";
     readonly SCHEMA_NOT_FOUND: "SCHEMA_NOT_FOUND";

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -99,6 +99,13 @@ export class ModuleNotFoundError extends ModuleError {
         this.name = 'ModuleNotFoundError';
     }
 }
+export class ModuleDisabledError extends ModuleError {
+    static DEFAULT_RETRYABLE = false;
+    constructor(moduleId, options) {
+        super('MODULE_DISABLED', `Module is disabled: ${moduleId}`, { moduleId }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
+        this.name = 'ModuleDisabledError';
+    }
+}
 export class ModuleTimeoutError extends ModuleError {
     static DEFAULT_RETRYABLE = true;
     constructor(moduleId, timeoutMs, options) {
@@ -249,6 +256,20 @@ export class CircularDependencyError extends ModuleError {
         this.name = 'CircularDependencyError';
     }
 }
+export class DependencyNotFoundError extends ModuleError {
+    static DEFAULT_RETRYABLE = false;
+    constructor(moduleId, dependencyId, options) {
+        super('DEPENDENCY_NOT_FOUND', `Dependency '${dependencyId}' not found for module '${moduleId}'`, { moduleId, dependencyId }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
+        this.name = 'DependencyNotFoundError';
+    }
+}
+export class FeatureNotImplementedError extends ModuleError {
+    static DEFAULT_RETRYABLE = false;
+    constructor(message = 'Feature not implemented', options) {
+        super('GENERAL_NOT_IMPLEMENTED', message, {}, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
+        this.name = 'FeatureNotImplementedError';
+    }
+}
 export class ModuleLoadError extends ModuleError {
     static DEFAULT_RETRYABLE = false;
     constructor(moduleId, reason, options) {
@@ -256,6 +277,13 @@ export class ModuleLoadError extends ModuleError {
         this.name = 'ModuleLoadError';
     }
 }
+export class ReloadFailedError extends ModuleError {
+    static DEFAULT_RETRYABLE = true;
+    constructor(moduleId, reason, options) {
+        super('RELOAD_FAILED', `Failed to reload module '${moduleId}': ${reason}`, { moduleId, reason }, options?.cause, options?.traceId, options?.retryable, options?.aiGuidance, options?.userFixable, options?.suggestion);
+        this.name = 'ReloadFailedError';
+    }
+}
 export class ModuleExecuteError extends ModuleError {
     static DEFAULT_RETRYABLE = null;
     constructor(moduleId, reason, options) {
@@ -331,8 +359,10 @@ export const ErrorCodes = Object.freeze({
     ACL_RULE_ERROR: "ACL_RULE_ERROR",
     ACL_DENIED: "ACL_DENIED",
     MODULE_NOT_FOUND: "MODULE_NOT_FOUND",
+    MODULE_DISABLED: "MODULE_DISABLED",
     MODULE_TIMEOUT: "MODULE_TIMEOUT",
     MODULE_LOAD_ERROR: "MODULE_LOAD_ERROR",
+    RELOAD_FAILED: "RELOAD_FAILED",
     MODULE_EXECUTE_ERROR: "MODULE_EXECUTE_ERROR",
     SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR",
     SCHEMA_NOT_FOUND: "SCHEMA_NOT_FOUND",
@@ -358,8 +388,6 @@ export const ErrorCodes = Object.freeze({
     APPROVAL_PENDING: "APPROVAL_PENDING",
     VERSION_INCOMPATIBLE: "VERSION_INCOMPATIBLE",
     ERROR_CODE_COLLISION: "ERROR_CODE_COLLISION",
-    // Forward declarations for Level 2 Phase 2 features.
-    // Exception classes will be added when the corresponding features are implemented.
     GENERAL_NOT_IMPLEMENTED: "GENERAL_NOT_IMPLEMENTED",
     DEPENDENCY_NOT_FOUND: "DEPENDENCY_NOT_FOUND",
 });