@iworkforces/tracelattice 2.0.3

package/dist/di/Container.d.ts

@@ -0,0 +1,253 @@
+import type { Logger } from '../logger/StructuredLogger.js';
+import type { ServerConfig } from '../ServerConfig.js';
+import type { ConfigFileOptions } from '../config/ConfigLoader.js';
+import type { IDisposable } from '../types/disposable.js';
+import type { ServiceKey, ServiceRegistry } from './ServiceRegistry.js';
+/**
+ * Lightweight dependency injection container for managing service dependencies.
+ *
+ * This container supports:
+ * - Instance registration (singleton-like behavior)
+ * - Factory registration (lazy instantiation with caching)
+ * - Transient factory registration (new instance each time)
+ *
+ * The container is type-safe when using ServiceKey from ServiceRegistry.
+ * For dynamic/unknown services, use string keys with generic type parameters.
+ *
+ * @example
+ * ```typescript
+ * const container = new Container();
+ *
+ * // Type-safe registration with ServiceKey (recommended)
+ * container.registerInstance('Logger', new StructuredLogger());
+ *
+ * // Type inference works automatically
+ * const logger = container.resolve('Logger');  // Type: StructuredLogger
+ *
+ * // Register a factory with caching (singleton per container)
+ * container.register('HistoryManager', () =>
+ *   new HistoryManager({ logger: container.resolve('Logger') })
+ * );
+ *
+ * // Register a transient factory (new instance each time)
+ * container.registerFactory('RequestContext', () =>
+ *   new RequestContext()
+ * );
+ *
+ * // For dynamic services not in ServiceRegistry, use the escape hatch
+ * container.registerDynamicInstance('MyService', myService);
+ * const service = container.resolveDynamic('MyService') as MyService;
+ * ```
+ */
+export declare class Container {
+    private _services;
+    private _factories;
+    private _transientFactories;
+    private _resolving;
+    private _disposables;
+    /**
+     * Register a singleton instance that will be returned for all resolutions.
+     *
+     * @param name - The unique name/identifier for the service
+     * @param instance - The instance to register
+     *
+     * @example
+     * ```typescript
+     * container.registerInstance('Config', new ServerConfig({ ... }));
+     * ```
+     */
+    registerInstance<K extends ServiceKey>(name: K, instance: ServiceRegistry[K]): void;
+    /**
+     * Register a factory function that will be called once and cached.
+     * The first call to `resolve` will invoke the factory and cache the result.
+     * Subsequent calls will return the cached instance (singleton behavior).
+     *
+     * @param name - The unique name/identifier for the service
+     * @param factory - A factory function that creates the service
+     *
+     * @example
+     * ```typescript
+     * container.register('HistoryManager', () =>
+     *   new HistoryManager({ logger: container.resolve('Logger') })
+     * );
+     * ```
+     */
+    register<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;
+    /**
+     * Register a transient factory function that will be called on every resolution.
+     * Each call to `resolve` will invoke the factory and return a new instance.
+     *
+     * @param name - The unique name/identifier for the service
+     * @param factory - A factory function that creates the service
+     *
+     * @example
+     * ```typescript
+     * container.registerFactory('RequestContext', () =>
+     *   new RequestContext()
+     * );
+     * ```
+     */
+    registerFactory<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;
+    /**
+     * Resolve a service by name.
+     *
+     * Resolution order:
+     * 1. If a registered instance exists, return it
+     * 2. If a cached factory exists, return it
+     * 3. If a factory exists, invoke it, cache the result, and return it
+     * 4. If a transient factory exists, invoke it and return a new instance
+     * 5. Throw an error if the service is not found
+     *
+     * @param name - The name/identifier of service to resolve
+     * @returns The resolved service instance
+     * @throws {Error} If the service is not registered
+     *
+     * @example
+     * ```typescript
+     * // Type-safe: ServiceRegistry provides autocomplete
+     * const logger = container.resolve('Logger');  // Type: StructuredLogger
+     * const config = container.resolve('Config');  // Type: ServerConfig
+ * ```
+ */
+    resolve<K extends ServiceKey>(name: K): ServiceRegistry[K];
+    /**
+     * Resolve a service by name with an `unknown` return type.
+     * Use this when the service key is not in ServiceRegistry.
+     *
+     * @param name - The name/identifier of the service
+     * @returns The service instance as `unknown` — caller must narrow
+     */
+    resolveDynamic(name: string): unknown;
+    /**
+     * Register a factory for a service key not present in `ServiceRegistry`.
+     * Use this for runtime-keyed registrations that cannot be expressed as typed services.
+     *
+     * @param name - Arbitrary string key
+     * @param factory - Factory returning the dynamic instance
+     */
+    registerDynamic(name: string, factory: () => unknown): void;
+    /**
+     * Register a singleton instance for a service key not present in `ServiceRegistry`.
+     *
+     * @param name - Arbitrary string key
+     * @param instance - The instance to register
+     */
+    registerDynamicInstance(name: string, instance: unknown): void;
+    /**
+     * Register a transient factory for a service key not present in `ServiceRegistry`.
+     * Each `resolveDynamic` call invokes the factory and returns a new instance.
+     *
+     * @param name - Arbitrary string key
+     * @param factory - Factory returning a new instance per call
+     */
+    registerDynamicFactory(name: string, factory: () => unknown): void;
+    /**
+     * Check if a service is registered (either as instance or factory).
+     *
+     * @param name - The name/identifier of the service to check
+     * @returns `true` if the service is registered, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * if (!container.has('Logger')) {
+     *   container.registerInstance('Logger', new StructuredLogger());
+     * }
+     * ```
+     */
+    has(name: string): boolean;
+    /**
+     * Remove a registered service from the container.
+     *
+     * @param name - The name/identifier of the service to unregister
+     * @returns `true` if the service was found and removed, `false` otherwise
+     *
+     * @example
+     * ```typescript
+     * container.unregister('HistoryManager');
+     * ```
+     */
+    unregister(name: string): boolean;
+    /**
+     * Clear all registered services and factories from the container.
+     *
+     * @example
+     * ```typescript
+     * container.clear();
+     * ```
+     */
+    clear(): void;
+    /**
+     * Get the number of registered services (including instances, factories, and transient factories).
+     *
+     * @returns The total count of registered services
+     *
+     * @example
+     * ```typescript
+     * console.log(`Registered services: ${container.size}`);
+     * ```
+     */
+    get size(): number;
+    /**
+     * Get an array of all registered service names.
+     *
+     * @returns An array of service names
+     *
+     * @example
+     * ```typescript
+     * const names = container.registeredServices();
+     * console.log('Registered:', names.join(', '));
+     * ```
+     */
+    registeredServices(): string[];
+    /**
+     * Register an instance as disposable for lifecycle management.
+     * The instance will have its `dispose()` method called when the container is disposed.
+     *
+     * @param name - The service name (must already be registered)
+     * @param instance - The disposable instance to track
+     *
+     * @example
+     * ```typescript
+     * const pool = new ConnectionPool();
+     * container.registerInstance('ConnectionPool', pool);
+     * container.registerDisposable('ConnectionPool', pool);
+     * ```
+     */
+    registerDisposable(name: string, instance: IDisposable): void;
+    /**
+     * Dispose of all registered disposable services.
+     * Calls `dispose()` on each registered disposable in reverse registration order.
+     * Errors during individual disposal are caught and logged to prevent cascading failures.
+     *
+     * @example
+     * ```typescript
+     * await container.dispose();
+     * ```
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Create a pre-configured container with all default services registered.
+ *
+ * This factory function creates a container with all standard services
+ * for the ToolAwareSequentialThinkingServer.
+ *
+ * @param options - Configuration options for the container
+ * @returns A configured container ready to use
+ *
+ * @example
+ * ```typescript
+ * const container = createDefaultContainer({
+ *   logger: customLogger,
+ *   config: customConfig
+ * });
+ * const server = new ToolAwareSequentialThinkingServer({ container });
+ * ```
+ */
+export interface CreateContainerOptions {
+    logger?: Logger;
+    config?: ServerConfig;
+    fileConfig?: ConfigFileOptions;
+}
+export declare function createDefaultContainer(options?: CreateContainerOptions): Container;
+//# sourceMappingURL=Container.d.ts.map

package/dist/di/Container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/di/Container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAoB,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,YAAY,CAAuC;IAE3D;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAYnF;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAYhF;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAYvF;;;;;;;;;;;;;;;;;;;;GAoBE;IACF,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAoC1D;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI;IAW3D;;;;;OAKG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAW9D;;;;;;OAMG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI;IAWlE;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM1B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAQb;;;;;;;;;OASG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAQ9B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI7D;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,sBAAsB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,CActF"}

package/dist/di/Container.js

@@ -0,0 +1,111 @@
+class Container {
+    _services = new Map();
+    _factories = new Map();
+    _transientFactories = new Map();
+    _resolving = new Set();
+    _disposables = new Map();
+    registerInstance(name, instance) {
+        if (this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)) throw new Error(`Service '${name}' is already registered`);
+        this._services.set(name, instance);
+    }
+    register(name, factory) {
+        if (this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)) throw new Error(`Service '${name}' is already registered`);
+        this._factories.set(name, factory);
+    }
+    registerFactory(name, factory) {
+        if (this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)) throw new Error(`Service '${name}' is already registered`);
+        this._transientFactories.set(name, factory);
+    }
+    resolve(name) {
+        if (this._resolving.has(name)) throw new Error(`Circular dependency detected while resolving service: ${name}`);
+        this._resolving.add(name);
+        try {
+            if (this._services.has(name)) return this._services.get(name);
+            if (this._factories.has(name)) {
+                const factory = this._factories.get(name);
+                const instance = factory();
+                this._services.set(name, instance);
+                this._factories.delete(name);
+                return instance;
+            }
+            if (this._transientFactories.has(name)) {
+                const factory = this._transientFactories.get(name);
+                return factory();
+            }
+            throw new Error(`Service not found: ${name}. Did you forget to register it?`);
+        } finally{
+            this._resolving.delete(name);
+        }
+    }
+    resolveDynamic(name) {
+        return this.resolve(name);
+    }
+    registerDynamic(name, factory) {
+        if (this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)) throw new Error(`Service '${name}' is already registered`);
+        this._factories.set(name, factory);
+    }
+    registerDynamicInstance(name, instance) {
+        if (this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)) throw new Error(`Service '${name}' is already registered`);
+        this._services.set(name, instance);
+    }
+    registerDynamicFactory(name, factory) {
+        if (this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)) throw new Error(`Service '${name}' is already registered`);
+        this._transientFactories.set(name, factory);
+    }
+    has(name) {
+        return this._services.has(name) || this._factories.has(name) || this._transientFactories.has(name);
+    }
+    unregister(name) {
+        const hadInstance = this._services.delete(name);
+        const hadFactory = this._factories.delete(name);
+        const hadTransient = this._transientFactories.delete(name);
+        this._disposables.delete(name);
+        return hadInstance || hadFactory || hadTransient;
+    }
+    clear() {
+        this._services.clear();
+        this._factories.clear();
+        this._transientFactories.clear();
+        this._resolving.clear();
+        this._disposables.clear();
+    }
+    get size() {
+        return this._services.size + this._factories.size + this._transientFactories.size;
+    }
+    registeredServices() {
+        const names = new Set();
+        for (const name of this._services.keys())names.add(name);
+        for (const name of this._factories.keys())names.add(name);
+        for (const name of this._transientFactories.keys())names.add(name);
+        return Array.from(names);
+    }
+    registerDisposable(name, instance) {
+        this._disposables.set(name, instance);
+    }
+    async dispose() {
+        const entries = Array.from(this._disposables.entries()).reverse();
+        const errors = [];
+        for (const [name, disposable] of entries)try {
+            await disposable.dispose();
+        } catch (error) {
+            errors.push({
+                name,
+                error
+            });
+        }
+        this._disposables.clear();
+        if (errors.length > 0) {
+            const messages = errors.map((e)=>`${e.name}: ${e.error instanceof Error ? e.error.message : String(e.error)}`);
+            throw new Error(`Failed to dispose services: ${messages.join(', ')}`);
+        }
+    }
+}
+function createDefaultContainer(options = {}) {
+    const container = new Container();
+    if (options.logger) container.registerInstance('Logger', options.logger);
+    if (options.config) container.registerInstance('Config', options.config);
+    return container;
+}
+export { Container, createDefaultContainer };
+
+//# sourceMappingURL=Container.js.map

package/dist/di/Container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"di/Container.js","sources":["../../src/di/Container.ts"],"sourcesContent":["import type { Logger, StructuredLogger } from '../logger/StructuredLogger.js';\nimport type { ServerConfig } from '../ServerConfig.js';\nimport type { ConfigFileOptions } from '../config/ConfigLoader.js';\n\nimport type { IDisposable } from '../types/disposable.js';\nimport type { ServiceKey, ServiceRegistry } from './ServiceRegistry.js';\n\n/**\n * Lightweight dependency injection container for managing service dependencies.\n *\n * This container supports:\n * - Instance registration (singleton-like behavior)\n * - Factory registration (lazy instantiation with caching)\n * - Transient factory registration (new instance each time)\n *\n * The container is type-safe when using ServiceKey from ServiceRegistry.\n * For dynamic/unknown services, use string keys with generic type parameters.\n *\n * @example\n * ```typescript\n * const container = new Container();\n *\n * // Type-safe registration with ServiceKey (recommended)\n * container.registerInstance('Logger', new StructuredLogger());\n *\n * // Type inference works automatically\n * const logger = container.resolve('Logger');  // Type: StructuredLogger\n *\n * // Register a factory with caching (singleton per container)\n * container.register('HistoryManager', () =>\n *   new HistoryManager({ logger: container.resolve('Logger') })\n * );\n *\n * // Register a transient factory (new instance each time)\n * container.registerFactory('RequestContext', () =>\n *   new RequestContext()\n * );\n *\n * // For dynamic services not in ServiceRegistry, use the escape hatch\n * container.registerDynamicInstance('MyService', myService);\n * const service = container.resolveDynamic('MyService') as MyService;\n * ```\n */\nexport class Container {\n\tprivate _services: Map<string, unknown> = new Map();\n\tprivate _factories: Map<string, () => unknown> = new Map();\n\tprivate _transientFactories: Map<string, () => unknown> = new Map();\n\tprivate _resolving: Set<string> = new Set();\n\tprivate _disposables: Map<string, IDisposable> = new Map();\n\n\t/**\n\t * Register a singleton instance that will be returned for all resolutions.\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param instance - The instance to register\n\t *\n\t * @example\n\t * ```typescript\n\t * container.registerInstance('Config', new ServerConfig({ ... }));\n\t * ```\n\t */\n\tregisterInstance<K extends ServiceKey>(name: K, instance: ServiceRegistry[K]): void;\n\tregisterInstance(name: string, instance: unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._services.set(name, instance);\n\t}\n\n\t/**\n\t * Register a factory function that will be called once and cached.\n\t * The first call to `resolve` will invoke the factory and cache the result.\n\t * Subsequent calls will return the cached instance (singleton behavior).\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param factory - A factory function that creates the service\n\t *\n\t * @example\n\t * ```typescript\n\t * container.register('HistoryManager', () =>\n\t *   new HistoryManager({ logger: container.resolve('Logger') })\n\t * );\n\t * ```\n\t */\n\tregister<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;\n\tregister(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._factories.set(name, factory);\n\t}\n\n\t/**\n\t * Register a transient factory function that will be called on every resolution.\n\t * Each call to `resolve` will invoke the factory and return a new instance.\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param factory - A factory function that creates the service\n\t *\n\t * @example\n\t * ```typescript\n\t * container.registerFactory('RequestContext', () =>\n\t *   new RequestContext()\n\t * );\n\t * ```\n\t */\n\tregisterFactory<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;\n\tregisterFactory(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._transientFactories.set(name, factory);\n\t}\n\n\t/**\n\t * Resolve a service by name.\n\t *\n\t * Resolution order:\n\t * 1. If a registered instance exists, return it\n\t * 2. If a cached factory exists, return it\n\t * 3. If a factory exists, invoke it, cache the result, and return it\n\t * 4. If a transient factory exists, invoke it and return a new instance\n\t * 5. Throw an error if the service is not found\n\t *\n\t * @param name - The name/identifier of service to resolve\n\t * @returns The resolved service instance\n\t * @throws {Error} If the service is not registered\n\t *\n\t * @example\n\t * ```typescript\n\t * // Type-safe: ServiceRegistry provides autocomplete\n\t * const logger = container.resolve('Logger');  // Type: StructuredLogger\n\t * const config = container.resolve('Config');  // Type: ServerConfig\n * ```\n */\n\tresolve<K extends ServiceKey>(name: K): ServiceRegistry[K];\n\tresolve(name: string): unknown {\n\t\tif (this._resolving.has(name)) {\n\t\t\tthrow new Error(`Circular dependency detected while resolving service: ${name}`);\n\t\t}\n\n\t\tthis._resolving.add(name);\n\n\t\ttry {\n\t\t\t// Check for registered instance first\n\t\t\tif (this._services.has(name)) {\n\t\t\t\treturn this._services.get(name);\n\t\t\t}\n\n\t\t\t// Check for cached factory result\n\t\t\tif (this._factories.has(name)) {\n\t\t\t\tconst factory = this._factories.get(name)!;\n\t\t\t\tconst instance = factory();\n\t\t\t\t// Cache the result for future calls (singleton behavior)\n\t\t\t\tthis._services.set(name, instance);\n\t\t\t\tthis._factories.delete(name);\n\t\t\t\treturn instance;\n\t\t\t}\n\n\t\t\t// Check for transient factory (call every time)\n\t\t\tif (this._transientFactories.has(name)) {\n\t\t\t\tconst factory = this._transientFactories.get(name)!;\n\t\t\t\treturn factory();\n\t\t\t}\n\n\t\t\tthrow new Error(`Service not found: ${name}. Did you forget to register it?`);\n\t\t} finally {\n\t\t\tthis._resolving.delete(name);\n\t\t}\n\t}\n\n\t/**\n\t * Resolve a service by name with an `unknown` return type.\n\t * Use this when the service key is not in ServiceRegistry.\n\t *\n\t * @param name - The name/identifier of the service\n\t * @returns The service instance as `unknown` — caller must narrow\n\t */\n\tresolveDynamic(name: string): unknown {\n\t\treturn this.resolve(name as never);\n\t}\n\n\t/**\n\t * Register a factory for a service key not present in `ServiceRegistry`.\n\t * Use this for runtime-keyed registrations that cannot be expressed as typed services.\n\t *\n\t * @param name - Arbitrary string key\n\t * @param factory - Factory returning the dynamic instance\n\t */\n\tregisterDynamic(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._factories.set(name, factory);\n\t}\n\n\t/**\n\t * Register a singleton instance for a service key not present in `ServiceRegistry`.\n\t *\n\t * @param name - Arbitrary string key\n\t * @param instance - The instance to register\n\t */\n\tregisterDynamicInstance(name: string, instance: unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._services.set(name, instance);\n\t}\n\n\t/**\n\t * Register a transient factory for a service key not present in `ServiceRegistry`.\n\t * Each `resolveDynamic` call invokes the factory and returns a new instance.\n\t *\n\t * @param name - Arbitrary string key\n\t * @param factory - Factory returning a new instance per call\n\t */\n\tregisterDynamicFactory(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._transientFactories.set(name, factory);\n\t}\n\n\t/**\n\t * Check if a service is registered (either as instance or factory).\n\t *\n\t * @param name - The name/identifier of the service to check\n\t * @returns `true` if the service is registered, `false` otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * if (!container.has('Logger')) {\n\t *   container.registerInstance('Logger', new StructuredLogger());\n\t * }\n\t * ```\n\t */\n\thas(name: string): boolean {\n\t\treturn (\n\t\t\tthis._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)\n\t\t);\n\t}\n\n\t/**\n\t * Remove a registered service from the container.\n\t *\n\t * @param name - The name/identifier of the service to unregister\n\t * @returns `true` if the service was found and removed, `false` otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * container.unregister('HistoryManager');\n\t * ```\n\t */\n\tunregister(name: string): boolean {\n\t\tconst hadInstance = this._services.delete(name);\n\t\tconst hadFactory = this._factories.delete(name);\n\t\tconst hadTransient = this._transientFactories.delete(name);\n\t\tthis._disposables.delete(name);\n\t\treturn hadInstance || hadFactory || hadTransient;\n\t}\n\n\t/**\n\t * Clear all registered services and factories from the container.\n\t *\n\t * @example\n\t * ```typescript\n\t * container.clear();\n\t * ```\n\t */\n\tclear(): void {\n\t\tthis._services.clear();\n\t\tthis._factories.clear();\n\t\tthis._transientFactories.clear();\n\t\tthis._resolving.clear();\n\t\tthis._disposables.clear();\n\t}\n\n\t/**\n\t * Get the number of registered services (including instances, factories, and transient factories).\n\t *\n\t * @returns The total count of registered services\n\t *\n\t * @example\n\t * ```typescript\n\t * console.log(`Registered services: ${container.size}`);\n\t * ```\n\t */\n\tget size(): number {\n\t\treturn this._services.size + this._factories.size + this._transientFactories.size;\n\t}\n\n\t/**\n\t * Get an array of all registered service names.\n\t *\n\t * @returns An array of service names\n\t *\n\t * @example\n\t * ```typescript\n\t * const names = container.registeredServices();\n\t * console.log('Registered:', names.join(', '));\n\t * ```\n\t */\n\tregisteredServices(): string[] {\n\t\tconst names = new Set<string>();\n\t\tfor (const name of this._services.keys()) names.add(name);\n\t\tfor (const name of this._factories.keys()) names.add(name);\n\t\tfor (const name of this._transientFactories.keys()) names.add(name);\n\t\treturn Array.from(names);\n\t}\n\n\t/**\n\t * Register an instance as disposable for lifecycle management.\n\t * The instance will have its `dispose()` method called when the container is disposed.\n\t *\n\t * @param name - The service name (must already be registered)\n\t * @param instance - The disposable instance to track\n\t *\n\t * @example\n\t * ```typescript\n\t * const pool = new ConnectionPool();\n\t * container.registerInstance('ConnectionPool', pool);\n\t * container.registerDisposable('ConnectionPool', pool);\n\t * ```\n\t */\n\tregisterDisposable(name: string, instance: IDisposable): void {\n\t\tthis._disposables.set(name, instance);\n\t}\n\n\t/**\n\t * Dispose of all registered disposable services.\n\t * Calls `dispose()` on each registered disposable in reverse registration order.\n\t * Errors during individual disposal are caught and logged to prevent cascading failures.\n\t *\n\t * @example\n\t * ```typescript\n\t * await container.dispose();\n\t * ```\n\t */\n\tasync dispose(): Promise<void> {\n\t\tconst entries = Array.from(this._disposables.entries()).reverse();\n\t\tconst errors: Array<{ name: string; error: unknown }> = [];\n\n\t\tfor (const [name, disposable] of entries) {\n\t\t\ttry {\n\t\t\t\tawait disposable.dispose();\n\t\t\t} catch (error) {\n\t\t\t\terrors.push({ name, error });\n\t\t\t}\n\t\t}\n\n\t\tthis._disposables.clear();\n\n\t\tif (errors.length > 0) {\n\t\t\tconst messages = errors.map(\n\t\t\t\t(e) => `${e.name}: ${e.error instanceof Error ? e.error.message : String(e.error)}`\n\t\t\t);\n\t\t\tthrow new Error(`Failed to dispose services: ${messages.join(', ')}`);\n\t\t}\n\t}\n}\n\n/**\n * Create a pre-configured container with all default services registered.\n *\n * This factory function creates a container with all standard services\n * for the ToolAwareSequentialThinkingServer.\n *\n * @param options - Configuration options for the container\n * @returns A configured container ready to use\n *\n * @example\n * ```typescript\n * const container = createDefaultContainer({\n *   logger: customLogger,\n *   config: customConfig\n * });\n * const server = new ToolAwareSequentialThinkingServer({ container });\n * ```\n */\nexport interface CreateContainerOptions {\n\tlogger?: Logger;\n\tconfig?: ServerConfig;\n\tfileConfig?: ConfigFileOptions;\n}\n\nexport function createDefaultContainer(options: CreateContainerOptions = {}): Container {\n\tconst container = new Container();\n\n\t// Register logger if provided\n\tif (options.logger) {\n\t\tcontainer.registerInstance('Logger', options.logger as StructuredLogger);\n\t}\n\n\t// Register config if provided\n\tif (options.config) {\n\t\tcontainer.registerInstance('Config', options.config);\n\t}\n\n\treturn container;\n}\n"],"names":["Container","Map","Set","name","instance","Error","factory","hadInstance","hadFactory","hadTransient","names","Array","entries","errors","disposable","error","messages","e","String","createDefaultContainer","options","container"],"mappings":"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"}

package/dist/di/ServiceRegistry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Service registry type definitions for the DI container.
+ *
+ * Maps service keys to their concrete types for type-safe resolution.
+ * Interface types are imported from contracts/ to reduce coupling.
+ * Concrete types are imported only where needed for DI resolution.
+ */
+import type { PersistenceBackend } from '../contracts/PersistenceBackend.js';
+import type { HistoryManager } from '../core/HistoryManager.js';
+import type { EdgeStore } from '../core/graph/EdgeStore.js';
+import type { ICalibrator } from '../contracts/calibrator.js';
+import type { IOutcomeRecorder, ISessionLock } from '../contracts/interfaces.js';
+import type { IReasoningStrategy } from '../contracts/strategy.js';
+import type { ThoughtEvaluator } from '../core/ThoughtEvaluator.js';
+import type { IThoughtFormatter } from '../core/IThoughtFormatter.js';
+import type { ThoughtProcessor } from '../core/ThoughtProcessor.js';
+import type { StructuredLogger } from '../logger/StructuredLogger.js';
+import type { Metrics } from '../metrics/metrics.impl.js';
+import type { SkillRegistry } from '../registry/SkillRegistry.js';
+import type { ToolRegistry } from '../registry/ToolRegistry.js';
+import type { ServerConfig } from '../ServerConfig.js';
+import type { ISummaryStore } from '../contracts/summary.js';
+import type { CompressionService } from '../core/compression/CompressionService.js';
+import type { ISuspensionStore } from '../contracts/suspension.js';
+import type { ConfigFileOptions } from '../config/ConfigLoader.js';
+import type { SessionLifecycleCoordinator } from '../core/SessionLifecycleCoordinator.js';
+export interface ServiceRegistry {
+    Logger: StructuredLogger;
+    Config: ServerConfig;
+    FileConfig: ConfigFileOptions;
+    HistoryManager: HistoryManager;
+    ThoughtProcessor: ThoughtProcessor;
+    ThoughtFormatter: IThoughtFormatter;
+    ThoughtEvaluator: ThoughtEvaluator;
+    Persistence: PersistenceBackend | null;
+    ToolRegistry: ToolRegistry;
+    SkillRegistry: SkillRegistry;
+    Metrics: Metrics;
+    EdgeStore: EdgeStore;
+    reasoningStrategy: IReasoningStrategy;
+    outcomeRecorder: IOutcomeRecorder;
+    calibrator: ICalibrator;
+    summaryStore: ISummaryStore;
+    compressionService: CompressionService;
+    suspensionStore: ISuspensionStore;
+    sessionLock: ISessionLock;
+    sessionLifecycle: SessionLifecycleCoordinator;
+}
+export type ServiceKey = keyof ServiceRegistry;
+//# sourceMappingURL=ServiceRegistry.d.ts.map

package/dist/di/ServiceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceRegistry.d.ts","sourceRoot":"","sources":["../../src/di/ServiceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAE1F,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,eAAe,EAAE,gBAAgB,CAAC;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,gBAAgB,CAAC;IAClC,WAAW,EAAE,YAAY,CAAC;IAC1B,gBAAgB,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC"}

package/dist/di/ServiceRegistry.js

@@ -0,0 +1 @@
+export { };