@framers/agentos 0.1.0

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

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Implements the ToolExecutor class, responsible for the direct
+ * execution of tools conforming to the ITool interface. It handles critical
+ * aspects like input argument validation against JSON schemas and invoking
+ * the tool's core logic.
+ *
+ * @module backend/agentos/core/tools/ToolExecutor
+ * @see ./ITool.ts for ITool, ToolExecutionResult, ToolExecutionContext.
+ * @see ../cognitive_substrate/IGMI.ts for ToolCallRequest, UserContext.
+ * @see @framers/agentos/utils/errors.ts for GMIError, GMIErrorCode, createGMIErrorFromError.
+ */
+import { ITool, ToolExecutionResult } from './ITool';
+import { ToolCallRequest, UserContext } from '../../cognitive_substrate/IGMI';
+import type { IAuthService, ISubscriptionService } from '../../services/user_auth/types';
+import { ExtensionRegistry } from '../../extensions';
+/**
+ * @interface ToolExecutionRequestDetails
+ * @description Encapsulates all necessary information for the `ToolExecutor` to execute a tool.
+ * This includes the specific tool call request (typically originating from an LLM),
+ * and crucial contextual information about the invoking GMI, Persona, and User.
+ *
+ * @property {ToolCallRequest} toolCallRequest - The raw tool call request containing the target tool's
+ * function name and its arguments (usually as a JSON string or pre-parsed object).
+ * @property {string} gmiId - The ID of the GMI (Generalized Mind Instance) initiating the tool call.
+ * @property {string} personaId - The ID of the active Persona within the GMI.
+ * @property {string[]} personaCapabilities - Capabilities of the active Persona, used for preliminary checks.
+ * @property {UserContext} userContext - Contextual information about the end-user.
+ * @property {string} [correlationId] - Optional ID for tracing this specific execution across logs and systems.
+ */
+export interface ToolExecutionRequestDetails {
+    toolCallRequest: ToolCallRequest;
+    gmiId: string;
+    personaId: string;
+    personaCapabilities: string[];
+    userContext: UserContext;
+    correlationId?: string;
+}
+/**
+ * @class ToolExecutor
+ * @description Manages a registry of `ITool` instances and robustly handles their execution.
+ * Key responsibilities include validating input arguments against each tool's defined JSON schema
+ * using Ajv, and then invoking the tool's `execute` method with the appropriate `ToolExecutionContext`.
+ * It ensures that tools are called correctly and their outputs (or errors) are processed consistently.
+ */
+export declare class ToolExecutor {
+    private readonly toolRegistry;
+    private readonly directRegistrations;
+    private readonly authService?;
+    private readonly subscriptionService?;
+    /**
+     * Instance of Ajv for JSON schema validation.
+     * Note: The TS2709 error "Cannot use namespace 'Ajv' as a type" might indicate
+     * an issue with TypeScript configuration (e.g., esModuleInterop) or Ajv's type
+     * definitions version mismatch if it persists. The `import Ajv from 'ajv';`
+     * and `ajv: Ajv` usage with `new Ajv()` is standard for Ajv v8+.
+     * @private
+     * @type {InstanceType<typeof Ajv>}
+     */
+    private readonly ajv;
+    /**
+    * Creates an instance of ToolExecutor.
+    * Initializes an empty tool registry and configures an Ajv instance for JSON schema validation.
+    * Default tools can be registered via `registerDefaultTools` or explicitly.
+    *
+    * @constructor
+    * @param {IAuthService} [authService] - Optional. An instance of an authentication service.
+    * Used for potential future integration with more complex user-specific permission checks directly within the executor,
+    * though primary permission logic resides in `ToolPermissionManager`.
+    * @param {ISubscriptionService} [subscriptionService] - Optional. An instance of a subscription service.
+    * Similarly used for potential future feature-based tool access control at the executor level.
+    */
+    constructor(authService?: IAuthService, subscriptionService?: ISubscriptionService, toolRegistry?: ExtensionRegistry<ITool>);
+    /**
+    * Registers a tool with the executor, making it available for subsequent execution.
+    * Tools are indexed by their functional `name` property, which must be unique within the registry.
+    *
+    * @public
+    * @param {ITool} tool - The tool instance to register. It must conform to the `ITool` interface.
+    * @returns {void}
+    * @throws {GMIError} If the tool is invalid (e.g., missing `id` or `name` - `GMIErrorCode.INVALID_ARGUMENT`),
+    * or if a tool with the same functional `name` is already registered (`GMIErrorCode.ALREADY_EXISTS`).
+    */
+    registerTool(tool: ITool): Promise<void>;
+    /**
+    * Retrieves a registered tool instance by its functional name.
+    *
+    * @public
+    * @param {string} toolName - The `name` of the tool (as specified in `ITool.name` and used in `ToolCallRequest.name`).
+    * @returns {ITool | undefined} The `ITool` instance if found in the registry; otherwise, `undefined`.
+    */
+    getTool(toolName: string): ITool | undefined;
+    /**
+    * Unregisters a tool from the executor using its functional name.
+    * If the tool has a `shutdown` method, it is called prior to removal from the registry.
+    *
+    * @public
+    * @async
+    * @param {string} toolName - The `name` of the tool to unregister.
+    * @returns {Promise<boolean>} A promise resolving to `true` if the tool was found and successfully unregistered (including its shutdown, if applicable), `false` otherwise.
+    */
+    unregisterTool(toolName: string): Promise<boolean>;
+    /**
+    * Returns an array of definitions for all currently registered tools.
+    * This list typically includes essential information like the tool's name, description,
+    * input/output schemas, category, and required capabilities, making it suitable for
+    * LLM consumption for function calling or for UI display.
+    *
+    * @public
+    * @returns {Array<Pick<ITool, 'name' | 'description' | 'inputSchema' | 'outputSchema' | 'displayName' | 'category' | 'requiredCapabilities'>>}
+    * An array of partial tool information objects.
+    */
+    listAvailableTools(): Array<Pick<ITool, 'name' | 'description' | 'inputSchema' | 'outputSchema' | 'displayName' | 'category' | 'requiredCapabilities'>>;
+    /**
+    * Executes a specified tool based on the details provided in a `ToolExecutionRequestDetails` object.
+    * This is the core method of the executor, orchestrating validation, context preparation,
+    * actual tool invocation, and result packaging.
+    *
+    * @public
+    * @async
+    * @param {ToolExecutionRequestDetails} requestDetails - An object containing all necessary details for the tool execution,
+    * including the `ToolCallRequest` from the LLM and contextual GMI/user information.
+    * @returns {Promise<ToolExecutionResult>} A promise that resolves with the `ToolExecutionResult` object.
+    * This result indicates the success or failure of the execution and provides the tool's output or error details.
+    */
+    executeTool(requestDetails: ToolExecutionRequestDetails): Promise<ToolExecutionResult>;
+    /** @private
+    * Registers example tools. In a production system, tools would be loaded dynamically or via configuration.
+    */
+    private createDescriptorFromTool;
+    private registerDefaultTools;
+    /**
+    * Gracefully shuts down all registered tools that implement the optional `shutdown` method.
+    * This is typically called when the ToolExecutor itself is being shut down as part of a larger
+    * application termination sequence.
+    *
+    * @public
+    * @async
+    * @returns {Promise<void[]>} A promise that resolves when all tool shutdown attempts are complete.
+    * Individual tool shutdown errors are logged but do not prevent other tools from attempting shutdown.
+    */
+    shutdownAllTools(): Promise<void[]>;
+}
+//# sourceMappingURL=ToolExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../../src/core/tools/ToolExecutor.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,KAAK,EAAoB,mBAAmB,EAAwB,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAuC,MAAM,kBAAkB,CAAC;AAW1F;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAuB;IAC5D;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAE/C;;;;;;;;;;;MAWE;gBAEA,WAAW,CAAC,EAAE,YAAY,EAC1B,mBAAmB,CAAC,EAAE,oBAAoB,EAC1C,YAAY,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC;IAgBzC;;;;;;;;;MASE;IACW,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrD;;;;;;MAME;IACK,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAInD;;;;;;;;MAQE;IACW,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB/D;;;;;;;;;MASE;IACK,kBAAkB,IAAI,KAAK,CAChC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,sBAAsB,CAAC,CAC3H;IAYD;;;;;;;;;;;MAWE;IACW,WAAW,CAAC,cAAc,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiInG;;MAEE;IACF,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,oBAAoB;IAqD5B;;;;;;;;;MASE;IACW,gBAAgB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;CAOjD"}

package/dist/core/tools/ToolExecutor.js

@@ -0,0 +1,364 @@
+// File: backend/agentos/core/tools/ToolExecutor.ts
+/**
+ * @fileoverview Implements the ToolExecutor class, responsible for the direct
+ * execution of tools conforming to the ITool interface. It handles critical
+ * aspects like input argument validation against JSON schemas and invoking
+ * the tool's core logic.
+ *
+ * @module backend/agentos/core/tools/ToolExecutor
+ * @see ./ITool.ts for ITool, ToolExecutionResult, ToolExecutionContext.
+ * @see ../cognitive_substrate/IGMI.ts for ToolCallRequest, UserContext.
+ * @see @framers/agentos/utils/errors.ts for GMIError, GMIErrorCode, createGMIErrorFromError.
+ */
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { uuidv4 } from '../../utils/uuid.js';
+import { GMIError, GMIErrorCode, createGMIErrorFromError } from '../../utils/errors.js';
+import { ExtensionRegistry, EXTENSION_KIND_TOOL } from '../../extensions/index.js';
+/**
+ * @class ToolExecutor
+ * @description Manages a registry of `ITool` instances and robustly handles their execution.
+ * Key responsibilities include validating input arguments against each tool's defined JSON schema
+ * using Ajv, and then invoking the tool's `execute` method with the appropriate `ToolExecutionContext`.
+ * It ensures that tools are called correctly and their outputs (or errors) are processed consistently.
+ */
+export class ToolExecutor {
+    /**
+    * Creates an instance of ToolExecutor.
+    * Initializes an empty tool registry and configures an Ajv instance for JSON schema validation.
+    * Default tools can be registered via `registerDefaultTools` or explicitly.
+    *
+    * @constructor
+    * @param {IAuthService} [authService] - Optional. An instance of an authentication service.
+    * Used for potential future integration with more complex user-specific permission checks directly within the executor,
+    * though primary permission logic resides in `ToolPermissionManager`.
+    * @param {ISubscriptionService} [subscriptionService] - Optional. An instance of a subscription service.
+    * Similarly used for potential future feature-based tool access control at the executor level.
+    */
+    constructor(authService, subscriptionService, toolRegistry) {
+        this.toolRegistry = toolRegistry ?? new ExtensionRegistry(EXTENSION_KIND_TOOL);
+        this.directRegistrations = new Set();
+        this.authService = authService;
+        this.subscriptionService = subscriptionService;
+        this.ajv = new Ajv({ allErrors: true, coerceTypes: true, useDefaults: true });
+        addFormats(this.ajv); // Adds support for standard formats like "date-time", "email", "uri", etc.
+        this.registerDefaultTools();
+        console.log(`ToolExecutor initialized. Registered tools: ${this.toolRegistry.listActive().length}.`);
+    }
+    /**
+    * Registers a tool with the executor, making it available for subsequent execution.
+    * Tools are indexed by their functional `name` property, which must be unique within the registry.
+    *
+    * @public
+    * @param {ITool} tool - The tool instance to register. It must conform to the `ITool` interface.
+    * @returns {void}
+    * @throws {GMIError} If the tool is invalid (e.g., missing `id` or `name` - `GMIErrorCode.INVALID_ARGUMENT`),
+    * or if a tool with the same functional `name` is already registered (`GMIErrorCode.ALREADY_EXISTS`).
+    */
+    async registerTool(tool) {
+        if (!tool ||
+            typeof tool.name !== 'string' ||
+            !tool.name.trim() ||
+            typeof tool.id !== 'string' ||
+            !tool.id.trim()) {
+            throw new GMIError("Invalid tool object provided for registration: 'id' and 'name' are required and must be non-empty strings.", GMIErrorCode.INVALID_ARGUMENT, { toolDetails: { id: tool?.id, name: tool?.name } });
+        }
+        if (this.directRegistrations.has(tool.name)) {
+            await this.toolRegistry.unregister(tool.name);
+            this.directRegistrations.delete(tool.name);
+        }
+        const descriptor = this.createDescriptorFromTool(tool);
+        await this.toolRegistry.register(descriptor);
+        this.directRegistrations.add(tool.name);
+        console.log(`ToolExecutor: Tool '${tool.name}' (ID: '${tool.id}', Version: ${tool.version || 'N/A'}) successfully registered.`);
+    }
+    /**
+    * Retrieves a registered tool instance by its functional name.
+    *
+    * @public
+    * @param {string} toolName - The `name` of the tool (as specified in `ITool.name` and used in `ToolCallRequest.name`).
+    * @returns {ITool | undefined} The `ITool` instance if found in the registry; otherwise, `undefined`.
+    */
+    getTool(toolName) {
+        return this.toolRegistry.getActive(toolName)?.payload;
+    }
+    /**
+    * Unregisters a tool from the executor using its functional name.
+    * If the tool has a `shutdown` method, it is called prior to removal from the registry.
+    *
+    * @public
+    * @async
+    * @param {string} toolName - The `name` of the tool to unregister.
+    * @returns {Promise<boolean>} A promise resolving to `true` if the tool was found and successfully unregistered (including its shutdown, if applicable), `false` otherwise.
+    */
+    async unregisterTool(toolName) {
+        if (!this.directRegistrations.has(toolName)) {
+            console.warn(`ToolExecutor: Attempted to unregister tool '${toolName}', but no direct registration was found.`);
+            return false;
+        }
+        const removed = await this.toolRegistry.unregister(toolName);
+        if (removed) {
+            this.directRegistrations.delete(toolName);
+            console.log(`ToolExecutor: Tool '${toolName}' successfully unregistered.`);
+        }
+        else {
+            console.warn(`ToolExecutor: Failed to unregister tool '${toolName}'. Descriptor stack may be managed externally.`);
+        }
+        return removed;
+    }
+    /**
+    * Returns an array of definitions for all currently registered tools.
+    * This list typically includes essential information like the tool's name, description,
+    * input/output schemas, category, and required capabilities, making it suitable for
+    * LLM consumption for function calling or for UI display.
+    *
+    * @public
+    * @returns {Array<Pick<ITool, 'name' | 'description' | 'inputSchema' | 'outputSchema' | 'displayName' | 'category' | 'requiredCapabilities'>>}
+    * An array of partial tool information objects.
+    */
+    listAvailableTools() {
+        return this.toolRegistry.listActive().map(({ payload }) => ({
+            name: payload.name,
+            displayName: payload.displayName,
+            description: payload.description,
+            inputSchema: payload.inputSchema,
+            outputSchema: payload.outputSchema,
+            category: payload.category,
+            requiredCapabilities: payload.requiredCapabilities,
+        }));
+    }
+    /**
+    * Executes a specified tool based on the details provided in a `ToolExecutionRequestDetails` object.
+    * This is the core method of the executor, orchestrating validation, context preparation,
+    * actual tool invocation, and result packaging.
+    *
+    * @public
+    * @async
+    * @param {ToolExecutionRequestDetails} requestDetails - An object containing all necessary details for the tool execution,
+    * including the `ToolCallRequest` from the LLM and contextual GMI/user information.
+    * @returns {Promise<ToolExecutionResult>} A promise that resolves with the `ToolExecutionResult` object.
+    * This result indicates the success or failure of the execution and provides the tool's output or error details.
+    */
+    async executeTool(requestDetails) {
+        const { toolCallRequest, gmiId, personaId, personaCapabilities, userContext, correlationId } = requestDetails;
+        if (!toolCallRequest || !toolCallRequest.name || typeof toolCallRequest.name !== 'string') {
+            const errorMsg = "Invalid ToolCallRequest provided to ToolExecutor: 'name' is missing or invalid.";
+            console.error(`ToolExecutor: ${errorMsg}`, requestDetails);
+            return { success: false, error: errorMsg, details: { receivedRequest: toolCallRequest, code: GMIErrorCode.VALIDATION_ERROR } };
+        }
+        const toolName = toolCallRequest.name;
+        const toolDescriptor = this.toolRegistry.getActive(toolName);
+        const tool = toolDescriptor?.payload;
+        const logContext = `ToolExecutor (GMI: ${gmiId}, Persona: ${personaId}, Tool: ${toolName}, LLMCallID: ${toolCallRequest.id || 'N/A'})`;
+        if (!tool) {
+            const errorMsg = `Tool '${toolName}' not found in ToolExecutor registry. Cannot execute.`;
+            console.error(`${logContext}: ${errorMsg}`);
+            return { success: false, error: errorMsg, details: { toolName, reason: "NotRegisteredInExecutor" } };
+        }
+        if (tool.requiredCapabilities && tool.requiredCapabilities.length > 0) {
+            const hasAllCapabilities = tool.requiredCapabilities.every(cap => personaCapabilities.includes(cap));
+            if (!hasAllCapabilities) {
+                const missingCaps = tool.requiredCapabilities.filter(rc => !personaCapabilities.includes(rc));
+                const errorMsg = `Persona (ID: ${personaId}) lacks capabilities for tool '${tool.name}'. Required: [${tool.requiredCapabilities.join(', ')}], Missing: [${missingCaps.join(', ')}].`;
+                console.warn(`${logContext}: Capability check failed - ${errorMsg}`);
+                return { success: false, error: errorMsg, details: { toolName: tool.name, requiredCapabilities: tool.requiredCapabilities, possessedCapabilities: personaCapabilities, missingCapabilities: missingCaps } };
+            }
+        }
+        let parsedArgs;
+        try {
+            // Assuming toolCallRequest.arguments is already a Record<string, any> as per IGMI.ts ToolCallRequest definition
+            // If it can be a string, further parsing logic is needed.
+            if (typeof toolCallRequest.arguments === 'string') {
+                parsedArgs = JSON.parse(toolCallRequest.arguments);
+            }
+            else if (typeof toolCallRequest.arguments === 'object' && toolCallRequest.arguments !== null) {
+                parsedArgs = toolCallRequest.arguments;
+            }
+            else if (toolCallRequest.arguments === undefined || toolCallRequest.arguments === null) {
+                parsedArgs = {};
+            }
+            else {
+                throw new Error(`Tool arguments are not a JSON string or object: ${typeof toolCallRequest.arguments}`);
+            }
+        }
+        catch (parseError) {
+            const errorMsg = `Failed to parse arguments for tool '${tool.name}'. Arguments must be a valid JSON string or object.`;
+            console.warn(`${logContext}: Argument parsing failed. Raw Args: "${JSON.stringify(toolCallRequest.arguments)}". Error: ${parseError.message}`);
+            return { success: false, error: errorMsg, details: { toolName: tool.name, argumentParsingError: parseError.message, rawArguments: toolCallRequest.arguments } };
+        }
+        if (tool.inputSchema) {
+            const validate = this.ajv.compile(tool.inputSchema);
+            if (!validate(parsedArgs)) {
+                const errorMsg = `Invalid arguments for tool '${tool.name}'. Validation failed against input schema.`;
+                const validationErrors = Array.isArray(validate.errors)
+                    ? validate.errors.map(err => ({
+                        path: err.instancePath || err.schemaPath,
+                        message: err.message,
+                        params: err.params,
+                    }))
+                    : [{ message: 'Unknown schema validation error.' }];
+                console.warn(`${logContext}: Argument schema validation failed. Errors:`, JSON.stringify(validationErrors, null, 2), 'Parsed Args:', parsedArgs);
+                return { success: false, error: errorMsg, details: { toolName: tool.name, validationErrors, providedParsedArgs: parsedArgs } };
+            }
+        }
+        const executionContext = {
+            gmiId,
+            personaId,
+            userContext,
+            correlationId: correlationId || `tool-exec-${uuidv4()}`,
+        };
+        try {
+            console.log(`${logContext}: Executing tool '${tool.name}' (ID: '${tool.id}') with validated arguments:`, parsedArgs);
+            const startTime = Date.now();
+            const result = await tool.execute(parsedArgs, executionContext);
+            const durationMs = Date.now() - startTime;
+            const outputPreview = result.output ? JSON.stringify(result.output).substring(0, 150) + (JSON.stringify(result.output).length > 150 ? '...' : '') : 'N/A';
+            if (result.success) {
+                console.log(`${logContext}: Tool execution successful. Duration: ${durationMs}ms. Output preview: ${outputPreview}`);
+            }
+            else {
+                console.warn(`${logContext}: Tool execution reported failure. Duration: ${durationMs}ms. Error: ${result.error}`, result.details);
+            }
+            if (tool.outputSchema && result.success && result.output !== undefined) {
+                const validateOutput = this.ajv.compile(tool.outputSchema);
+                if (!validateOutput(result.output)) {
+                    const outputErrorMsg = `Tool '${tool.name}' produced output that failed its defined output schema validation.`;
+                    const outputValidationErrors = Array.isArray(validateOutput.errors)
+                        ? validateOutput.errors.map(err => ({
+                            path: err.instancePath,
+                            message: err.message,
+                            params: err.params,
+                        }))
+                        : [];
+                    console.warn(`${logContext}: Output schema validation failed for '${tool.name}'. Errors:`, JSON.stringify(outputValidationErrors, null, 2));
+                    return {
+                        ...result,
+                        success: false, // Mark as overall failure if output schema validation fails
+                        error: result.error ? `${result.error} And output schema validation failed.` : outputErrorMsg,
+                        details: {
+                            ...(result.details || {}),
+                            outputValidationWarning: outputErrorMsg,
+                            outputValidationErrors,
+                        },
+                    };
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            const execErrorMsg = `Critical unhandled error during the execution of tool '${tool.name}'.`;
+            console.error(`${logContext}: ${execErrorMsg}`, err);
+            const gmiErr = createGMIErrorFromError(err, GMIErrorCode.TOOL_EXECUTION_FAILED, { toolName: tool.name, arguments: parsedArgs }, execErrorMsg);
+            return {
+                success: false,
+                error: gmiErr.message,
+                details: {
+                    toolName: tool.name,
+                    errorCode: gmiErr.code,
+                    errorDetailsFromGMIError: gmiErr.details,
+                    rawErrorString: err.toString(),
+                    stack: err.stack
+                }
+            };
+        }
+    }
+    /** @private
+    * Registers example tools. In a production system, tools would be loaded dynamically or via configuration.
+    */
+    createDescriptorFromTool(tool) {
+        return {
+            id: tool.name,
+            kind: EXTENSION_KIND_TOOL,
+            payload: tool,
+            metadata: {
+                toolId: tool.id,
+                origin: 'direct-registration',
+            },
+            onDeactivate: async () => {
+                if (typeof tool.shutdown === 'function') {
+                    try {
+                        await tool.shutdown();
+                    }
+                    catch (error) {
+                        console.error(`ToolExecutor: Error during shutdown of tool '${tool.name}' (ID: '${tool.id}')`, error);
+                    }
+                }
+            },
+        };
+    }
+    registerDefaultTools() {
+        const currentTimeTool = {
+            id: "system-current-time-tool-v1.1",
+            name: "getCurrentDateTime",
+            displayName: "Current Date & Time Service",
+            description: "Gets the current date and time, optionally for a specific IANA timezone (e.g., 'America/New_York', 'Europe/London'). Defaults to the server's local timezone if no timezone is provided or if the provided one is invalid.",
+            inputSchema: {
+                type: "object",
+                properties: { timezone: { type: "string", description: "Optional: IANA timezone string (e.g., 'America/Los_Angeles', 'Europe/London'). Examples: 'UTC', 'America/New_York', 'Asia/Tokyo'.", format: "time-zone" } },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    currentTime: { type: "string", description: "The current date and time formatted as a locale string (e.g., '5/24/2025, 11:43:58 AM')." },
+                    timezoneUsed: { type: "string", description: "The IANA timezone that was used for the calculation." },
+                    isoTimestamp: { type: "string", format: "date-time", description: "The current date and time in ISO 8601 format (UTC)." }
+                },
+                required: ["currentTime", "timezoneUsed", "isoTimestamp"]
+            },
+            category: "System Utilities", version: "1.1.0", hasSideEffects: false,
+            execute: async (args, context) => {
+                try {
+                    let effectiveTimezone = args.timezone;
+                    const serverDefaultTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+                    if (effectiveTimezone) {
+                        try {
+                            new Date().toLocaleString("en-US", { timeZone: effectiveTimezone });
+                        }
+                        catch (tzError) {
+                            console.warn(`ToolExecutor[getCurrentDateTime]: Invalid timezone '${args.timezone}' provided by GMI ${context.gmiId}. Falling back to ${serverDefaultTimezone}. Error: ${tzError.message}`);
+                            effectiveTimezone = serverDefaultTimezone;
+                        }
+                    }
+                    else {
+                        effectiveTimezone = serverDefaultTimezone;
+                    }
+                    const currentDate = new Date();
+                    return {
+                        success: true,
+                        output: {
+                            currentTime: currentDate.toLocaleString("en-US", { timeZone: effectiveTimezone, hour12: true, year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric', second: 'numeric' }),
+                            timezoneUsed: effectiveTimezone,
+                            isoTimestamp: currentDate.toISOString(),
+                        },
+                        contentType: "application/json"
+                    };
+                }
+                catch (e) {
+                    return { success: false, error: `Error getting current time: ${e.message}`, details: { stack: e.stack } };
+                }
+            }
+        };
+        this.registerTool(currentTimeTool).catch((e) => {
+            console.error('Error registering default current time tool:', e);
+        });
+    }
+    /**
+    * Gracefully shuts down all registered tools that implement the optional `shutdown` method.
+    * This is typically called when the ToolExecutor itself is being shut down as part of a larger
+    * application termination sequence.
+    *
+    * @public
+    * @async
+    * @returns {Promise<void[]>} A promise that resolves when all tool shutdown attempts are complete.
+    * Individual tool shutdown errors are logged but do not prevent other tools from attempting shutdown.
+    */
+    async shutdownAllTools() {
+        const activeCount = this.toolRegistry.listActive().length;
+        console.log(`ToolExecutor: Initiating shutdown for ${activeCount} registered tool(s)...`);
+        await this.toolRegistry.clear();
+        this.directRegistrations.clear();
+        return [];
+    }
+}
+//# sourceMappingURL=ToolExecutor.js.map

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

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