@framers/agentos 0.1.0

package/dist/core/tools/ToolOrchestrator.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview Implements the ToolOrchestrator class, which serves as the central
+ * hub for managing, discovering, authorizing, and orchestrating the execution of tools
+ * within the AgentOS system.
+ *
+ * The ToolOrchestrator acts as a facade over the `ToolPermissionManager` and `ToolExecutor`.
+ * It provides a unified and simplified interface for higher-level components, such as GMIs
+ * (Generalized Mind Instances) or the main AgentOS orchestrator, to interact with the tool ecosystem.
+ *
+ * Key Responsibilities:
+ * - Tool Registration: Manages an internal registry of available `ITool` instances.
+ * - Tool Discovery: Provides methods like `listAvailableTools()` to get tool definitions
+ * suitable for LLM consumption (e.g., for function calling).
+ * - Permission Enforcement: Collaborates with `IToolPermissionManager` to authorize tool calls
+ * based on Persona capabilities, user subscriptions, or other defined policies.
+ * - Execution Delegation: Delegates the actual tool execution (including argument validation)
+ * to the `ToolExecutor`.
+ * - Result Formatting: Standardizes and returns tool execution results (`ToolCallResult` for GMIs).
+ * - Lifecycle Management: Handles initialization and shutdown of itself and potentially registered tools.
+ *
+ * @module backend/agentos/core/tools/ToolOrchestrator
+ * @see ./IToolOrchestrator.ts for the interface definition.
+ * @see ./ITool.ts for the core tool contract and related types like ToolExecutionResult.
+ * @see ./IToolPermissionManager.ts for permission management logic and related types.
+ * @see ./ToolExecutor.ts for the component that directly executes tools.
+ * @see ../../config/ToolOrchestratorConfig.ts for configuration options.
+ * @see ../../cognitive_substrate/IGMI.ts for GMI-related types like ToolCallRequest, ToolCallResult, UserContext.
+ */
+import { IToolOrchestrator, ToolDefinitionForLLM } from './IToolOrchestrator';
+import { ITool } from './ITool';
+import { IToolPermissionManager } from './permissions/IToolPermissionManager';
+import { ToolExecutor, ToolExecutionRequestDetails } from './ToolExecutor';
+import { ToolOrchestratorConfig } from '../../config/ToolOrchestratorConfig';
+import { ToolCallResult, UserContext } from '../../cognitive_substrate/IGMI';
+/**
+ * @class ToolOrchestrator
+ * @implements {IToolOrchestrator}
+ * @description The central component responsible for the comprehensive management of tools.
+ * It orchestrates their registration, discovery, permission-based authorization, and execution,
+ * acting as a crucial facade for higher-level system components like GMIs.
+ */
+export declare class ToolOrchestrator implements IToolOrchestrator {
+    /**
+     * A unique identifier for this ToolOrchestrator instance, useful for logging and telemetry.
+     * @public
+     * @readonly
+     * @type {string}
+     */
+    readonly orchestratorId: string;
+    /**
+     * Holds the resolved configuration for this orchestrator instance, merging defaults with user-provided settings.
+     * @private
+     * @type {Readonly<Required<ToolOrchestratorConfig>>}
+     */
+    private config;
+    /**
+     * An instance of the permission manager used to authorize tool calls.
+     * @private
+     * @type {IToolPermissionManager}
+     */
+    private permissionManager;
+    /**
+     * An instance of the tool executor responsible for the actual invocation of tool logic.
+     * @private
+     * @type {ToolExecutor}
+     */
+    private toolExecutor;
+    /**
+     * A flag indicating whether the orchestrator has been successfully initialized and is ready for operation.
+     * @private
+     * @type {boolean}
+     */
+    private isInitialized;
+    /**
+     * Default configuration values for the ToolOrchestrator.
+     * These are applied if specific values are not provided during initialization, ensuring robust default behavior.
+     * @private
+     * @static
+     * @readonly
+     */
+    private static readonly DEFAULT_CONFIG;
+    /**
+     * Constructs a ToolOrchestrator instance.
+     * The orchestrator is not operational until the `initialize` method has been successfully called.
+     * An `orchestratorId` is generated upon construction.
+     */
+    constructor();
+    /**
+     * @inheritdoc
+     */
+    initialize(config: ToolOrchestratorConfig | undefined, // Can be undefined
+    permissionManager: IToolPermissionManager, toolExecutor: ToolExecutor, initialTools?: ITool[]): Promise<void>;
+    /**
+     * Ensures the ToolOrchestrator instance has been initialized before allowing operations.
+     * @private
+     * @throws {GMIError} if the orchestrator is not initialized (`GMIErrorCode.NOT_INITIALIZED`).
+     */
+    private ensureInitialized;
+    /**
+     * @inheritdoc
+     */
+    registerTool(tool: ITool): Promise<void>;
+    /**
+     * @inheritdoc
+     */
+    unregisterTool(toolName: string): Promise<boolean>;
+    /**
+     * @inheritdoc
+     */
+    getTool(toolName: string): Promise<ITool | undefined>;
+    /**
+     * @inheritdoc
+     */
+    listAvailableTools(context?: {
+        personaId?: string;
+        personaCapabilities?: string[];
+        userContext?: UserContext;
+    }): Promise<ToolDefinitionForLLM[]>;
+    /**
+       * @inheritdoc
+       */
+    processToolCall(requestDetails: ToolExecutionRequestDetails): Promise<ToolCallResult>;
+    /**
+     * @inheritdoc
+     */
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: any;
+    }>;
+    /**
+     * Shuts down all registered tools that implement the `shutdown` method.
+     * Prefers using `ToolExecutor.shutdownAllTools()` if available.
+     * @private
+     * @async
+     */
+    private shutdownRegisteredTools;
+    /**
+     * @inheritdoc
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ToolOrchestrator.d.ts.map

package/dist/core/tools/ToolOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/tools/ToolOrchestrator.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAyC,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAiD,MAAM,sCAAsC,CAAC;AAC7H,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7E;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD;;;;;OAKG;IACH,SAAgB,cAAc,EAAE,MAAM,CAAC;IAEvC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAA8C;IAE5D;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAA0B;IAEnD;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAgB;IAEpC;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAkB;IAEvC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAYpC;IAEF;;;;OAIG;;IAMH;;OAEG;IACU,UAAU,CACrB,MAAM,EAAE,sBAAsB,GAAG,SAAS,EAAE,mBAAmB;IAC/D,iBAAiB,EAAE,sBAAsB,EACzC,YAAY,EAAE,YAAY,EAC1B,YAAY,CAAC,EAAE,KAAK,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC;IA8ChB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACU,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrD;;OAEG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB/D;;OAEG;IACU,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAKlE;;OAEG;IACU,kBAAkB,CAAC,OAAO,CAAC,EAAE;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA2DrC;;SAEK;IACU,eAAe,CAAC,cAAc,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC;IA6FlG;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAgC1E;;;;;OAKG;YACW,uBAAuB;IAmBrC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYvC"}

package/dist/core/tools/ToolOrchestrator.js

@@ -0,0 +1,373 @@
+// File: backend/agentos/core/tools/ToolOrchestrator.ts
+/**
+ * @fileoverview Implements the ToolOrchestrator class, which serves as the central
+ * hub for managing, discovering, authorizing, and orchestrating the execution of tools
+ * within the AgentOS system.
+ *
+ * The ToolOrchestrator acts as a facade over the `ToolPermissionManager` and `ToolExecutor`.
+ * It provides a unified and simplified interface for higher-level components, such as GMIs
+ * (Generalized Mind Instances) or the main AgentOS orchestrator, to interact with the tool ecosystem.
+ *
+ * Key Responsibilities:
+ * - Tool Registration: Manages an internal registry of available `ITool` instances.
+ * - Tool Discovery: Provides methods like `listAvailableTools()` to get tool definitions
+ * suitable for LLM consumption (e.g., for function calling).
+ * - Permission Enforcement: Collaborates with `IToolPermissionManager` to authorize tool calls
+ * based on Persona capabilities, user subscriptions, or other defined policies.
+ * - Execution Delegation: Delegates the actual tool execution (including argument validation)
+ * to the `ToolExecutor`.
+ * - Result Formatting: Standardizes and returns tool execution results (`ToolCallResult` for GMIs).
+ * - Lifecycle Management: Handles initialization and shutdown of itself and potentially registered tools.
+ *
+ * @module backend/agentos/core/tools/ToolOrchestrator
+ * @see ./IToolOrchestrator.ts for the interface definition.
+ * @see ./ITool.ts for the core tool contract and related types like ToolExecutionResult.
+ * @see ./IToolPermissionManager.ts for permission management logic and related types.
+ * @see ./ToolExecutor.ts for the component that directly executes tools.
+ * @see ../../config/ToolOrchestratorConfig.ts for configuration options.
+ * @see ../../cognitive_substrate/IGMI.ts for GMI-related types like ToolCallRequest, ToolCallResult, UserContext.
+ */
+import { uuidv4 } from '../../utils/uuid.js';
+import { GMIError, GMIErrorCode, createGMIErrorFromError } from '../../utils/errors.js';
+/**
+ * @class ToolOrchestrator
+ * @implements {IToolOrchestrator}
+ * @description The central component responsible for the comprehensive management of tools.
+ * It orchestrates their registration, discovery, permission-based authorization, and execution,
+ * acting as a crucial facade for higher-level system components like GMIs.
+ */
+export class ToolOrchestrator {
+    /**
+     * Constructs a ToolOrchestrator instance.
+     * The orchestrator is not operational until the `initialize` method has been successfully called.
+     * An `orchestratorId` is generated upon construction.
+     */
+    constructor() {
+        /**
+         * A flag indicating whether the orchestrator has been successfully initialized and is ready for operation.
+         * @private
+         * @type {boolean}
+         */
+        this.isInitialized = false;
+        this.orchestratorId = `tool-orch-${uuidv4()}`;
+        this.config = { ...ToolOrchestrator.DEFAULT_CONFIG, orchestratorId: this.orchestratorId };
+    }
+    /**
+     * @inheritdoc
+     */
+    async initialize(config, // Can be undefined
+    permissionManager, toolExecutor, initialTools) {
+        if (this.isInitialized) {
+            console.warn(`ToolOrchestrator (ID: ${this.orchestratorId}): Attempting to re-initialize an already initialized instance. Existing tools will be cleared and re-registered if provided.`);
+            await this.shutdownRegisteredTools();
+        }
+        const baseConfig = { ...ToolOrchestrator.DEFAULT_CONFIG, orchestratorId: this.orchestratorId };
+        this.config = Object.freeze({
+            ...baseConfig,
+            ...(config || {}), // Handle undefined config
+            toolRegistrySettings: {
+                ...baseConfig.toolRegistrySettings,
+                ...(config?.toolRegistrySettings || {}),
+            }
+        });
+        if (!permissionManager) {
+            throw new GMIError('IToolPermissionManager dependency is required for ToolOrchestrator initialization.', GMIErrorCode.DEPENDENCY_ERROR, { orchestratorId: this.orchestratorId, missingDependency: 'IToolPermissionManager' });
+        }
+        if (!toolExecutor) {
+            throw new GMIError('ToolExecutor dependency is required for ToolOrchestrator initialization.', GMIErrorCode.DEPENDENCY_ERROR, { orchestratorId: this.orchestratorId, missingDependency: 'ToolExecutor' });
+        }
+        this.permissionManager = permissionManager;
+        this.toolExecutor = toolExecutor;
+        if (initialTools && initialTools.length > 0) {
+            console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Registering ${initialTools.length} initial tool(s)...`);
+            for (const tool of initialTools) {
+                try {
+                    await this.registerTool(tool);
+                }
+                catch (registrationError) {
+                    const errorMsg = `Failed to register initial tool '${tool.name || tool.id}': ${registrationError.message}`;
+                    console.error(`ToolOrchestrator (ID: ${this.orchestratorId}): ${errorMsg}`, registrationError.details || registrationError);
+                }
+            }
+        }
+        this.isInitialized = true;
+        console.log(`ToolOrchestrator (ID: ${this.orchestratorId}) initialized. Registered tools: ${this.toolExecutor.listAvailableTools().length}. Logging tool calls: ${this.config.logToolCalls}.`);
+    }
+    /**
+     * Ensures the ToolOrchestrator instance has been initialized before allowing operations.
+     * @private
+     * @throws {GMIError} if the orchestrator is not initialized (`GMIErrorCode.NOT_INITIALIZED`).
+     */
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new GMIError(`ToolOrchestrator (ID: ${this.orchestratorId}) is not initialized. Please call the initialize() method with valid configuration and dependencies.`, GMIErrorCode.NOT_INITIALIZED, { component: 'ToolOrchestrator', orchestratorId: this.orchestratorId });
+        }
+    }
+    /**
+     * @inheritdoc
+     */
+    async registerTool(tool) {
+        this.ensureInitialized();
+        if (!this.config.toolRegistrySettings.allowDynamicRegistration) {
+            throw new GMIError("Dynamic tool registration is disabled by the current ToolOrchestrator configuration.", GMIErrorCode.PERMISSION_DENIED, { toolName: tool?.name, orchestratorId: this.orchestratorId });
+        }
+        if (!tool || typeof tool.name !== 'string' || !tool.name.trim() || typeof tool.id !== 'string' || !tool.id.trim()) {
+            throw new GMIError("Tool registration failed: The provided tool object is invalid or missing required 'id' or 'name' properties.", GMIErrorCode.INVALID_ARGUMENT, { receivedToolDetails: { id: tool?.id, name: tool?.name } });
+        }
+        if (this.config.globalDisabledTools?.includes(tool.name) || this.config.globalDisabledTools?.includes(tool.id)) {
+            console.warn(`ToolOrchestrator (ID: ${this.orchestratorId}): Registering tool '${tool.name}' (ID: '${tool.id}'), but it is listed as globally disabled. It may not be executable.`);
+        }
+        await this.toolExecutor.registerTool(tool);
+        console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Tool '${tool.name}' (ID: '${tool.id}', Version: ${tool.version || 'N/A'}) successfully registered.`);
+    }
+    /**
+     * @inheritdoc
+     */
+    async unregisterTool(toolName) {
+        this.ensureInitialized();
+        if (!this.config.toolRegistrySettings.allowDynamicRegistration) {
+            throw new GMIError("Dynamic tool unregistration is disabled by the current ToolOrchestrator configuration.", GMIErrorCode.PERMISSION_DENIED, { toolName, orchestratorId: this.orchestratorId });
+        }
+        const success = await this.toolExecutor.unregisterTool(toolName);
+        if (success) {
+            console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Tool '${toolName}' successfully unregistered.`);
+        }
+        else {
+            console.warn(`ToolOrchestrator (ID: ${this.orchestratorId}): Attempted to unregister tool '${toolName}', but it was not found in the registry.`);
+        }
+        return success;
+    }
+    /**
+     * @inheritdoc
+     */
+    async getTool(toolName) {
+        this.ensureInitialized();
+        return this.toolExecutor.getTool(toolName);
+    }
+    /**
+     * @inheritdoc
+     */
+    async listAvailableTools(context) {
+        this.ensureInitialized();
+        const availableToolsLLM = [];
+        const activeTools = this.toolExecutor.listAvailableTools();
+        for (const toolSummary of activeTools) {
+            const tool = await this.getTool(toolSummary.name);
+            if (!tool) {
+                continue;
+            }
+            if (this.config.globalDisabledTools?.includes(tool.name) ||
+                this.config.globalDisabledTools?.includes(tool.id)) {
+                if (this.config.logToolCalls) {
+                    console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Tool '${tool.name}' (ID: '${tool.id}') skipped from listing as it is globally disabled.`);
+                }
+                continue;
+            }
+            if (context && context.personaId && context.userContext && context.personaCapabilities) {
+                const permissionContext = {
+                    tool,
+                    personaId: context.personaId,
+                    personaCapabilities: context.personaCapabilities,
+                    userContext: context.userContext,
+                };
+                try {
+                    const permissionResult = await this.permissionManager.isExecutionAllowed(permissionContext);
+                    if (!permissionResult.isAllowed) {
+                        if (this.config.logToolCalls) {
+                            console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Tool '${tool.name}' filtered out for persona '${context.personaId}' due to permission policy. Reason: ${permissionResult.reason || 'N/A'}.`);
+                        }
+                        continue;
+                    }
+                }
+                catch (permissionError) {
+                    console.error(`ToolOrchestrator (ID: ${this.orchestratorId}): Error while evaluating permissions for tool '${tool.name}'.`, permissionError);
+                    continue;
+                }
+            }
+            availableToolsLLM.push({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+                outputSchema: tool.outputSchema,
+            });
+        }
+        return availableToolsLLM;
+    }
+    /**
+       * @inheritdoc
+       */
+    async processToolCall(requestDetails) {
+        this.ensureInitialized();
+        const { toolCallRequest, gmiId, personaId, personaCapabilities, userContext } = requestDetails;
+        // Check if toolCallRequest and toolCallRequest.name are valid
+        if (!toolCallRequest || !toolCallRequest.name || typeof toolCallRequest.name !== 'string') {
+            const errorMsg = "Invalid ToolCallRequest: 'name' is missing or not a string.";
+            console.error(`ToolOrchestrator (ID: ${this.orchestratorId}): ${errorMsg}`, { requestDetails });
+            return { toolCallId: toolCallRequest?.id || `invalid-call-${uuidv4()}`, toolName: "unknown", output: null, isError: true, errorDetails: { message: errorMsg, code: GMIErrorCode.VALIDATION_ERROR } };
+        }
+        const toolName = toolCallRequest.name;
+        const llmProvidedCallId = toolCallRequest.id;
+        const logPrefix = `ToolOrchestrator (ID: ${this.orchestratorId}, GMI: ${gmiId}, Persona: ${personaId}, LLMCallID: ${llmProvidedCallId}, Tool: ${toolName}):`;
+        if (this.config.logToolCalls) {
+            const argsPreview = JSON.stringify(toolCallRequest.arguments).substring(0, 200) + (JSON.stringify(toolCallRequest.arguments).length > 200 ? '...' : '');
+            console.log(`${logPrefix} Received tool call request. Arguments preview: ${argsPreview}`);
+        }
+        if (this.config.globalDisabledTools?.includes(toolName)) {
+            const errorMsg = `Attempted to execute globally disabled tool '${toolName}'. Execution denied.`;
+            console.warn(`${logPrefix} ${errorMsg}`);
+            return {
+                toolCallId: llmProvidedCallId,
+                toolName,
+                output: null,
+                isError: true,
+                errorDetails: { message: errorMsg, code: GMIErrorCode.PERMISSION_DENIED, reason: "Tool is globally disabled." },
+            };
+        }
+        const tool = await this.getTool(toolName);
+        if (!tool) {
+            const errorMsg = `Tool '${toolName}' not found in orchestrator's tool registry.`;
+            console.error(`${logPrefix} ${errorMsg}`);
+            return { toolCallId: llmProvidedCallId, toolName, output: null, isError: true, errorDetails: { message: errorMsg, code: GMIErrorCode.TOOL_NOT_FOUND } };
+        }
+        if (this.config.globalDisabledTools?.includes(tool.name) || this.config.globalDisabledTools?.includes(tool.id)) {
+            const errorMsg = `Attempted to execute globally disabled tool '${toolName}' (ID: '${tool.id}'). Execution denied.`;
+            console.warn(`${logPrefix} ${errorMsg}`);
+            return { toolCallId: llmProvidedCallId, toolName, output: null, isError: true, errorDetails: { message: errorMsg, code: GMIErrorCode.PERMISSION_DENIED, reason: "Tool is globally disabled." } };
+        }
+        const permissionContext = { tool, personaId, personaCapabilities, userContext, gmiId };
+        let permissionResult;
+        try {
+            permissionResult = await this.permissionManager.isExecutionAllowed(permissionContext);
+        }
+        catch (permError) {
+            const errorMsg = `An unexpected error occurred during permission check for tool '${toolName}'.`;
+            console.error(`${logPrefix} ${errorMsg}`, permError);
+            const wrappedError = createGMIErrorFromError(permError, GMIErrorCode.PERMISSION_DENIED, permissionContext, errorMsg);
+            return { toolCallId: llmProvidedCallId, toolName, output: null, isError: true, errorDetails: { message: wrappedError.message, code: wrappedError.code, details: wrappedError.details } };
+        }
+        if (!permissionResult.isAllowed) {
+            const errorMsg = permissionResult.reason || `Permission denied by ToolPermissionManager for tool '${toolName}'.`;
+            console.warn(`${logPrefix} ${errorMsg}`, permissionResult.details);
+            return { toolCallId: llmProvidedCallId, toolName, output: null, isError: true, errorDetails: { message: errorMsg, code: GMIErrorCode.PERMISSION_DENIED, details: permissionResult.details } };
+        }
+        if (this.config.logToolCalls) {
+            console.log(`${logPrefix} Permissions granted for tool '${toolName}'. Delegating execution to ToolExecutor.`);
+        }
+        let coreExecutorResult;
+        try {
+            coreExecutorResult = await this.toolExecutor.executeTool(requestDetails);
+        }
+        catch (executorPipelineError) {
+            const errorMsg = `Critical error within ToolExecutor's internal pipeline while processing '${toolName}'. This is not an error from the tool's execute method itself.`;
+            console.error(`${logPrefix} ${errorMsg}`, executorPipelineError);
+            const wrappedError = createGMIErrorFromError(executorPipelineError, GMIErrorCode.TOOL_EXECUTION_FAILED, requestDetails, errorMsg);
+            return { toolCallId: llmProvidedCallId, toolName, output: null, isError: true, errorDetails: { message: wrappedError.message, code: wrappedError.code, details: wrappedError.details } };
+        }
+        if (this.config.logToolCalls) {
+            const outputPreview = coreExecutorResult.output ? JSON.stringify(coreExecutorResult.output).substring(0, 150) + (JSON.stringify(coreExecutorResult.output).length > 150 ? '...' : '') : 'N/A';
+            console.log(`${logPrefix} Tool '${toolName}' execution completed by executor. Success: ${coreExecutorResult.success}. Output Preview: ${outputPreview}. Error: ${coreExecutorResult.error || 'N/A'}`);
+        }
+        return {
+            toolCallId: llmProvidedCallId,
+            toolName: toolName,
+            output: coreExecutorResult.success ? coreExecutorResult.output : null,
+            isError: !coreExecutorResult.success,
+            errorDetails: !coreExecutorResult.success ? {
+                message: coreExecutorResult.error || `Tool '${toolName}' reported failure without a specific error message.`,
+                details: coreExecutorResult.details,
+            } : undefined,
+        };
+    }
+    /**
+     * @inheritdoc
+     */
+    async checkHealth() {
+        this.ensureInitialized();
+        let pmHealth = { isHealthy: true, details: "ToolPermissionManager: Health not explicitly checked or no checkHealth method available." };
+        if (this.permissionManager && typeof this.permissionManager.checkHealth === 'function') {
+            try {
+                pmHealth = await this.permissionManager.checkHealth();
+            }
+            catch (e) {
+                pmHealth = { isHealthy: false, details: `Failed to retrieve ToolPermissionManager health: ${e.message}` };
+            }
+        }
+        let execHealth = { isHealthy: true, details: "ToolExecutor: Health not explicitly checked or no checkHealth method available." };
+        if (this.toolExecutor && typeof this.toolExecutor.checkHealth === 'function') {
+            try {
+                execHealth = await this.toolExecutor.checkHealth();
+            }
+            catch (e) {
+                execHealth = { isHealthy: false, details: `Failed to retrieve ToolExecutor health: ${e.message}` };
+            }
+        }
+        const isOverallHealthy = this.isInitialized && pmHealth.isHealthy && execHealth.isHealthy;
+        return {
+            isHealthy: isOverallHealthy,
+            details: {
+                orchestratorId: this.orchestratorId,
+                status: this.isInitialized ? 'INITIALIZED' : 'NOT_INITIALIZED',
+                registeredToolCount: this.toolExecutor.listAvailableTools().length,
+                configSnapshot: {
+                    logToolCalls: this.config.logToolCalls,
+                    allowDynamicRegistration: this.config.toolRegistrySettings.allowDynamicRegistration,
+                    globalDisabledToolsCount: this.config.globalDisabledTools.length,
+                },
+                permissionManagerStatus: pmHealth,
+                toolExecutorStatus: execHealth,
+            },
+        };
+    }
+    /**
+     * Shuts down all registered tools that implement the `shutdown` method.
+     * Prefers using `ToolExecutor.shutdownAllTools()` if available.
+     * @private
+     * @async
+     */
+    async shutdownRegisteredTools() {
+        console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Initiating shutdown for registered tools via ToolExecutor.`);
+        if (this.toolExecutor && typeof this.toolExecutor.shutdownAllTools === 'function') {
+            try {
+                await this.toolExecutor.shutdownAllTools();
+                console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): ToolExecutor successfully completed shutdownAllTools.`);
+            }
+            catch (e) {
+                console.error(`ToolOrchestrator (ID: ${this.orchestratorId}): Error during ToolExecutor.shutdownAllTools: ${e.message}`, e);
+            }
+        }
+    }
+    /**
+     * @inheritdoc
+     */
+    async shutdown() {
+        if (!this.isInitialized) {
+            console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Shutdown called, but orchestrator was not initialized or already shut down.`);
+            return;
+        }
+        console.log(`ToolOrchestrator (ID: ${this.orchestratorId}): Initiating shutdown sequence...`);
+        await this.shutdownRegisteredTools();
+        this.isInitialized = false;
+        console.log(`ToolOrchestrator (ID: ${this.orchestratorId}) shut down complete. All tools processed for shutdown and registry cleared.`);
+    }
+}
+/**
+ * Default configuration values for the ToolOrchestrator.
+ * These are applied if specific values are not provided during initialization, ensuring robust default behavior.
+ * @private
+ * @static
+ * @readonly
+ */
+ToolOrchestrator.DEFAULT_CONFIG = {
+    orchestratorId: '',
+    defaultToolCallTimeoutMs: 30000,
+    maxConcurrentToolCalls: 10,
+    logToolCalls: true,
+    globalDisabledTools: [],
+    toolRegistrySettings: {
+        allowDynamicRegistration: true,
+        persistRegistry: false,
+        persistencePath: undefined,
+    },
+    customParameters: {},
+};
+//# sourceMappingURL=ToolOrchestrator.js.map

package/dist/core/tools/ToolOrchestrator.js.map

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