@framers/agentos 0.1.126 → 0.1.128

package/dist/agents/definitions/AgentCore.js

@@ -0,0 +1,519 @@
+/**
+ * @fileoverview Provides an abstract base class, `AgentCore`, for all agents in AgentOS.
+ * This class implements the `IAgent` interface and offers foundational functionalities
+ * common to most agents, such as configuration management, basic state handling,
+ * interaction with the PromptEngine, AI Model Providers, and an optional UtilityAI service.
+ *
+ * Concrete agent implementations (e.g., a `SimpleChatAgent`, `ToolUsingAgent`, or `AgentPoolAgent`)
+ * should extend `AgentCore` and implement the abstract `processTurn` method, which defines
+ * the agent's primary turn-taking logic. `AgentCore` provides protected helper methods
+ * for common tasks like LLM calls and response parsing, promoting code reuse and consistency.
+ *
+ * The design emphasizes:
+ * - Clear separation of concerns: Agent logic is distinct from orchestration or tool execution.
+ * - Configurability: Agents are defined by an `AgentConfig` object.
+ * - Extensibility: Easy to create new agent types by inheriting from `AgentCore`.
+ * - Dependency Injection: Core services (PromptEngine, ProviderManager, etc.) are injected.
+ * @module backend/agentos/agents/definitions/AgentCore
+ */
+import { MessageRole } from '../../core/conversation/ConversationMessage.js';
+// AIModelProviderManager import moved to IAgentFactory (used for AgentDependencies type)
+/**
+ * Defines the type of an agent, used for categorization and potentially for
+ * determining specific handling or factory instantiation logic.
+ * @enum {string}
+ */
+export var AgentType;
+(function (AgentType) {
+    /** A standard, general-purpose agent. */
+    AgentType["STANDARD"] = "standard";
+    /** An agent that manages a pool of other sub-agents (e.g., a router or mixture-of-experts). */
+    AgentType["POOL"] = "pool";
+    /** A specialized agent focused on a particular task or domain. */
+    AgentType["SPECIALIZED"] = "specialized";
+    /** An agent primarily designed for research or experimental purposes. */
+    AgentType["RESEARCH"] = "research";
+})(AgentType || (AgentType = {}));
+/**
+ * Custom error class for issues specific to AgentCore operations.
+ * @class AgentCoreError
+ * @extends {Error}
+ */
+export class AgentCoreError extends Error {
+    /**
+     * Creates an instance of AgentCoreError.
+     * @param {string} message - The error message.
+     * @param {string} code - The error code (e.g., 'LLM_CALL_FAILED', 'PROMPT_PARSE_ERROR').
+     * @param {any} [details] - Additional error details.
+     */
+    constructor(message, code, details) {
+        super(message);
+        this.name = 'AgentCoreError';
+        this.code = code;
+        this.details = details;
+        Object.setPrototypeOf(this, AgentCoreError.prototype);
+    }
+}
+/**
+ * Provides a foundational abstract class for creating specialized agents.
+ * It manages configuration, interaction with the `PromptEngine`, `IProvider` (LLM),
+ * and an optional `IUtilityAI` service. Concrete agents must implement `processTurn`.
+ *
+ * @class AgentCore
+ * @abstract
+ * @implements {IAgent}
+ */
+export class AgentCore {
+    /**
+     * Constructs an `AgentCore` instance.
+     *
+     * @param {AgentConfig} config - The configuration for this agent. Must include `id`, `name`,
+     * `description`, `systemPrompt`, and `modelTargetInfo`.
+     * @param {IPromptEngine} promptEngine - An instance of the `IPromptEngine`.
+     * @param {IProvider} llmProvider - The primary AI model provider for this agent.
+     * @param {IUtilityAI} [utilityAI] - Optional. An instance of an `IUtilityAI` service.
+     * @param {IAgentFactory} [agentFactory] - Optional. An instance of `IAgentFactory`,
+     * primarily for agents that manage other agents (e.g., `AgentPoolAgent`).
+     * @throws {AgentCoreError} If essential configuration or dependencies are missing.
+     */
+    constructor(config, promptEngine, llmProvider, utilityAI, agentFactory) {
+        /**
+         * Indicates if the agent has been successfully initialized.
+         * @protected
+         * @type {boolean}
+         */
+        this.isInitialized = false;
+        if (!config || !config.id || !config.name || !config.description || !config.systemPrompt || !config.modelTargetInfo) {
+            throw new AgentCoreError("AgentCore: Missing required configuration properties (id, name, description, systemPrompt, modelTargetInfo).", 'AGENT_CONFIG_INVALID');
+        }
+        if (!promptEngine) {
+            throw new AgentCoreError("AgentCore: IPromptEngine dependency is required.", 'DEPENDENCY_MISSING_PROMPTENGINE');
+        }
+        if (!llmProvider) {
+            throw new AgentCoreError("AgentCore: IProvider (llmProvider) dependency is required.", 'DEPENDENCY_MISSING_LLMPROVIDER');
+        }
+        this.id = config.id;
+        this.name = config.name;
+        this.description = config.description;
+        this.agentConfig = { type: AgentType.STANDARD, ...config }; // Default type if not specified
+        this.promptEngine = promptEngine;
+        this.llmProvider = llmProvider;
+        this.utilityAI = utilityAI;
+        this.agentFactory = agentFactory;
+        // console.log(`AgentCore instance '${this.name}' (ID: ${this.id}) constructed. Awaiting initialization.`);
+    }
+    /**
+     * Ensures the agent has been initialized before performing operations that depend on it.
+     * @protected
+     * @throws {AgentCoreError} If the agent is not initialized.
+     */
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new AgentCoreError(`Agent '${this.name}' (ID: ${this.id}) is not initialized. Call initialize() first.`, 'AGENT_NOT_INITIALIZED');
+        }
+    }
+    /**
+     * Handles results from tool calls requested by this agent.
+     *
+     * Subclasses can override this when they need tool-specific handling logic.
+     *
+     * @throws {AgentCoreError} If adding the tool result to context fails or if the LLM call for explanation fails.
+     */
+    async handleToolResult(toolCallId, toolOutput, toolName, conversationContext) {
+        this.ensureInitialized();
+        // console.log(`Agent '${this.name}': Handling tool result for call '${toolCallId}' from tool '${toolName}'.`);
+        try {
+            conversationContext.addMessage({
+                role: MessageRole.TOOL,
+                content: typeof toolOutput === 'string' ? toolOutput : JSON.stringify(toolOutput, null, 2),
+                tool_call_id: toolCallId,
+                name: toolName, // Standard practice to include tool name here
+            });
+        }
+        catch (error) {
+            console.error(`Agent '${this.name}': Failed to add tool result to conversation context: ${error.message}`, error);
+            // This is a significant issue as context is now inconsistent.
+            throw new AgentCoreError(`Failed to add tool result for '${toolName}' to context: ${error.message}`, 'CONTEXT_UPDATE_FAILED_TOOL_RESULT', error);
+        }
+        // Default behavior: Attempt to explain/summarize the tool output using the LLM.
+        // This is particularly useful if the tool output is verbose or technical.
+        let summarizedOutput = `Tool '${toolName}' (call ID: ${toolCallId}) executed.`;
+        if (toolOutput !== undefined && toolOutput !== null) {
+            summarizedOutput += ` Output: ${typeof toolOutput === 'string' ? toolOutput.substring(0, 500) : JSON.stringify(toolOutput).substring(0, 500)}`;
+            if (summarizedOutput.length > 500)
+                summarizedOutput += "... (output truncated for summary prompt)";
+        }
+        else {
+            summarizedOutput += " The tool did not produce any explicit output content.";
+        }
+        // Use a meta-prompt to guide the LLM in processing the tool output.
+        const metaSystemPromptContent = this.agentConfig.metaSystemPromptForUnexpectedSituations ||
+            `You are an AI assistant. A tool named '${toolName}' was just executed as part of your thought process.
+      Its output is: "${summarizedOutput}".
+      Your task is to now decide the next step. You can either:
+      1. Formulate a response to the user based on this tool output and the conversation history.
+      2. Decide to call another tool if necessary.
+      3. Ask the user for clarification if the tool output is ambiguous or insufficient.
+      Present your decision or response clearly.`;
+        try {
+            const promptComponents = {
+                systemPrompts: [{ content: metaSystemPromptContent, priority: -100 }], // High priority for meta-task
+                conversationHistory: [...conversationContext.getHistory()], // Pass full available history
+                // No direct userInput here; the "input" is effectively the tool result.
+                // The LLM prompt will need to be framed such that it processes the history + tool result.
+            };
+            // We need a user-like message to "prompt" the LLM about the tool result
+            const userPromptForToolResult = `The tool '${toolName}' has completed. Output: ${summarizedOutput}. What is the next step or the response to the user?`;
+            promptComponents.userInput = userPromptForToolResult;
+            const llmResponse = await this.callLLM(this.llmProvider, promptComponents, {
+                temperature: this.agentConfig.defaultModelCompletionOptions?.temperature ?? 0.5, // Default or configured
+                maxTokens: this.agentConfig.defaultModelCompletionOptions?.maxTokens ?? 1000, // Allow ample space for reasoning
+                // Tools should still be available if the agent needs to chain tool calls
+                tools: this.agentConfig.toolIds ? (await this.getAvailableToolDefinitions(this.agentConfig.toolIds)) : undefined,
+            });
+            const parsedResponse = this.parseLLMResponse(llmResponse);
+            return {
+                responseText: parsedResponse.responseText ?? undefined,
+                toolCalls: parsedResponse.toolCalls,
+                isComplete: !parsedResponse.toolCalls || parsedResponse.toolCalls.length === 0, // Complete if no further tool calls
+                rawModelResponse: parsedResponse.rawResponseMessage,
+                metadata: { processedToolResult: toolName, toolCallId },
+            };
+        }
+        catch (llmError) {
+            const errorMsg = `Agent '${this.name}': Failed to process tool result for '${toolName}' using LLM: ${llmError.message}`;
+            console.error(errorMsg, llmError);
+            return {
+                responseText: `I received a result from the '${toolName}' tool, but I encountered an issue while trying to process it. Please try rephrasing your request or try again later.`,
+                isComplete: true, // Mark as complete as it cannot proceed with this path.
+                error: new AgentCoreError(errorMsg, 'TOOL_RESULT_LLM_PROCESSING_FAILED', llmError),
+            };
+        }
+    }
+    /**
+     * Initializes the agent with optional configuration overrides.
+     */
+    async initialize(config) {
+        if (this.isInitialized && !config) {
+            // console.log(`Agent '${this.name}' (ID: ${this.id}) already initialized. Skipping no-op re-initialization.`);
+            return;
+        }
+        if (config) {
+            // Deep merge might be preferable for complex configurations.
+            // For now, Object.assign provides a shallow merge, overriding top-level properties.
+            // This is generally fine if `AgentConfig` is structured and `config` provides overrides.
+            Object.assign(this.agentConfig, config);
+            // console.log(`Agent '${this.name}' (ID: ${this.id}) re-configured during initialization.`);
+        }
+        this.isInitialized = true;
+        // console.log(`Agent '${this.name}' (ID: ${this.id}) initialized. Config:`, this.agentConfig);
+    }
+    /**
+     * Resets any agent-specific state between conversations or sessions.
+     */
+    reset() {
+        this.ensureInitialized(); // Should be initialized to be reset
+        // console.log(`Agent '${this.name}' (ID: ${this.id}) state reset. (Base implementation, no specific state cleared here).`);
+        // Subclasses should call super.reset() and then clear their own state.
+    }
+    /**
+     * Provides a default implementation for handling internal agent errors.
+     *
+     * This method leverages the agent's primary LLM to generate a user-friendly explanation
+     * of the error and potentially ask for user guidance.
+     *
+     * @throws {AgentCoreError} If the LLM call for error explanation itself fails.
+     */
+    async handleInternalAgentError(internalErrorDescriptionOrError, conversationContext, isFatalForTurn = true) {
+        this.ensureInitialized();
+        const internalErrorDescription = typeof internalErrorDescriptionOrError === 'string' ? internalErrorDescriptionOrError : internalErrorDescriptionOrError.message;
+        console.error(`Agent '${this.name}' (ID: ${this.id}) encountered an internal error: ${internalErrorDescription}`, typeof internalErrorDescriptionOrError !== 'string' ? internalErrorDescriptionOrError : '');
+        const metaSystemPrompt = this.agentConfig.metaSystemPromptForUnexpectedSituations ||
+            `You are an AI assistant. You've encountered an internal operational issue.
+      Your task is to clearly and apologetically explain this problem to the user.
+      If possible, suggest how the user might rephrase their request or provide information that could help.
+      The internal issue was: "${internalErrorDescription.substring(0, 300)}${internalErrorDescription.length > 300 ? '...' : ''}".`;
+        try {
+            const promptComponents = {
+                systemPrompts: [{ content: metaSystemPrompt, priority: -200 }], // High priority for this meta-task
+                conversationHistory: [...conversationContext.getHistory(3)], // Limited recent history for context
+                userInput: `I've encountered an internal technical difficulty described as: "${internalErrorDescription}". I need to inform the user about this. How should I phrase it and what should I suggest?`,
+            };
+            const llmResponse = await this.callLLM(this.llmProvider, promptComponents, {
+                temperature: 0.5, // Neutral temperature for explanation
+                maxTokens: 500, // Sufficient for a concise explanation
+                tools: [], // Typically no tools needed to explain an error
+            });
+            const parsedResponse = this.parseLLMResponse(llmResponse);
+            return {
+                responseText: parsedResponse.responseText || `I'm sorry, I've encountered an unexpected internal issue and cannot proceed as expected with your request. The issue was related to: ${internalErrorDescription.substring(0, 100)}...`,
+                isComplete: isFatalForTurn,
+                error: new AgentCoreError(internalErrorDescription, 'INTERNAL_AGENT_ERROR_EXPLAINED', internalErrorDescriptionOrError),
+                rawModelResponse: parsedResponse.rawResponseMessage,
+            };
+        }
+        catch (llmError) {
+            const errorMsg = `Agent '${this.name}': Critical failure. LLM failed to generate an explanation for its own internal error: ${llmError.message}`;
+            console.error(errorMsg, llmError);
+            // Fallback to a very generic error message if the LLM can't even explain the error.
+            throw new AgentCoreError(errorMsg, 'INTERNAL_ERROR_EXPLANATION_FAILED', llmError);
+        }
+    }
+    /**
+     * Protected helper to construct prompt components for the `PromptEngine`.
+     * Gathers system prompt, conversation history, user input, and tool schemas based on agent configuration.
+     *
+     * @protected
+     * @param {string | null} userInput - The current user input.
+     * @param {ConversationContext} conversationContext - The conversation context.
+     * @param {Tool[]} [availableTools] - Tools available for this turn.
+     * @param {Array<{ content: string; priority?: number }>} [additionalSystemPrompts] - Optional additional system prompts to layer in.
+     * @returns {Promise<Partial<PromptComponents>>} The assembled prompt components.
+     * @throws {AgentCoreError} If `PromptEngine`'s configuration cannot be accessed.
+     */
+    async gatherPromptComponents(userInput, conversationContext, availableTools, additionalSystemPrompts) {
+        this.ensureInitialized();
+        const systemPromptsFromConfig = Array.isArray(this.agentConfig.systemPrompt)
+            ? [...this.agentConfig.systemPrompt]
+            : [{ content: this.agentConfig.systemPrompt, priority: 0 }];
+        const finalSystemPrompts = additionalSystemPrompts
+            ? [...systemPromptsFromConfig, ...additionalSystemPrompts].sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0))
+            : systemPromptsFromConfig;
+        // Access PromptEngine's own config for defaults if agent doesn't override.
+        // This requires PromptEngine to expose its config or have a method for it.
+        // For now, we assume promptEngineConfigOverrides are comprehensive if used.
+        const historyMaxMessages = this.agentConfig.promptEngineConfigOverrides?.historyManagement?.defaultMaxMessages ??
+            20; // Hard fallback
+        const components = {
+            systemPrompts: finalSystemPrompts,
+            conversationHistory: [...conversationContext.getHistory(historyMaxMessages)],
+            userInput: userInput ?? undefined, // Pass undefined if null, as per PromptComponents
+        };
+        if (availableTools &&
+            availableTools.length > 0 &&
+            this.agentConfig.modelTargetInfo.toolSupport?.supported) {
+            components.tools = availableTools;
+        }
+        return components;
+    }
+    /**
+     * Protected helper method to make a call to the LLM provider via the `PromptEngine`.
+     *
+     * @protected
+     * @param {IProvider} llmProvider - The LLM provider instance to use for this call.
+     * @param {Partial<PromptComponents>} promptComponents - Components to build the prompt.
+     * @param {Partial<ModelCompletionOptions>} [overrideOptions] - Options to override agent's defaults for this specific call.
+     * @returns {Promise<ModelCompletionResponse>} The LLM's full response.
+     * @throws {AgentCoreError} If prompt construction fails with an error, or if the LLM call itself fails.
+     */
+    async callLLM(llmProvider, // Allow specifying provider for advanced scenarios (e.g. utility LLM call)
+    promptComponents, overrideOptions) {
+        this.ensureInitialized();
+        let promptResult;
+        try {
+            promptResult = await this.promptEngine.constructPrompt(promptComponents, this.agentConfig.modelTargetInfo, // Agent's primary model target
+            undefined, this.agentConfig.promptTemplateName);
+        }
+        catch (error) {
+            console.error(`Agent '${this.name}': Error during prompt construction: ${error.message}`, error);
+            throw new AgentCoreError(`Prompt construction failed: ${error.message}`, 'PROMPT_CONSTRUCTION_ERROR', error);
+        }
+        if (promptResult.issues?.some(i => i.type === 'error')) {
+            const errorMessages = promptResult.issues.filter(i => i.type === 'error').map(i => i.message).join('; ');
+            console.error(`Agent '${this.name}': Critical errors during prompt construction:`, promptResult.issues);
+            throw new AgentCoreError(`Prompt construction failed with critical errors: ${errorMessages}`, 'PROMPT_VALIDATION_ERROR', promptResult.issues);
+        }
+        if (promptResult.issues?.some(i => i.type === 'warning')) {
+            console.warn(`Agent '${this.name}': Warnings during prompt construction:`, promptResult.issues);
+        }
+        const completionOptions = {
+            modelId: this.agentConfig.modelTargetInfo.modelId, // From agent's primary target
+            ...this.agentConfig.defaultModelCompletionOptions, // Agent's defaults
+            ...overrideOptions, // Call-specific overrides
+            tools: promptResult.formattedToolSchemas, // Schemas formatted by PromptEngine
+        };
+        if (!completionOptions.modelId) {
+            throw new AgentCoreError(`No modelId configured for agent '${this.name}'. Verify agentConfig.modelTargetInfo.modelId.`, 'MODEL_ID_MISSING');
+        }
+        // console.debug(`Agent '${this.name}' (ID: ${this.id}) calling LLM (${completionOptions.modelId || 'N/A'}) on provider ${llmProvider.providerId}. Options:`, completionOptions, `Prompt metadata:`, promptResult.metadata);
+        let llmResponse;
+        try {
+            llmResponse = await llmProvider.generateCompletion(completionOptions.modelId, promptResult.prompt, completionOptions);
+        }
+        catch (error) {
+            console.error(`Agent '${this.name}': LLM Provider (${llmProvider.providerId}) .generateCompletion failed for model ${completionOptions.modelId}: ${error.message}`, error);
+            throw new AgentCoreError(`LLM Provider Error on .generateCompletion (${completionOptions.modelId}, ${llmProvider.providerId}): ${error.message}`, 'LLM_PROVIDER_EXECUTION_ERROR', error);
+        }
+        if (llmResponse.error) {
+            console.error(`Agent '${this.name}': LLM Provider (${llmProvider.providerId}) returned an error for model ${completionOptions.modelId}:`, llmResponse.error);
+            throw new AgentCoreError(`LLM Provider Error (${completionOptions.modelId}, ${llmProvider.providerId}): ${llmResponse.error.message}`, 'LLM_PROVIDER_RESPONSE_ERROR', llmResponse.error);
+        }
+        return llmResponse;
+    }
+    /**
+     * Protected helper to parse an LLM response, extracting the primary text content and any tool calls.
+     * It handles parsing of tool call arguments from their typical JSON string format into objects.
+     *
+     * @protected
+     * @param {ModelCompletionResponse} llmResponse - The complete response object from the LLM provider.
+     * @returns {{ responseText: string | null; toolCalls?: AgentToolCall[]; rawResponseMessage?: any; }}
+     * An object containing:
+     * - `responseText`: The main textual content from the LLM, or `null` if none.
+     * - `toolCalls`: An array of `AgentToolCall` objects if the LLM requested tool executions, `undefined` otherwise.
+     * - `rawResponseMessage`: The actual message object from the LLM's first choice, for debugging or advanced needs.
+     * @throws {AgentCoreError} If no valid choice is found in the LLM response.
+     */
+    parseLLMResponse(llmResponse) {
+        this.ensureInitialized();
+        // Error in llmResponse object itself should have been handled by callLLM.
+        const choice = llmResponse.choices?.[0];
+        if (!choice) {
+            const errorMsg = `No valid choice found in LLM response. Response ID: ${llmResponse.id}`;
+            console.error(`Agent '${this.name}': ${errorMsg}`, llmResponse);
+            throw new AgentCoreError(errorMsg, 'LLM_RESPONSE_NO_CHOICE', { responseId: llmResponse.id });
+        }
+        // Extract text content. Handle both direct text and message.content.
+        const responseText = this.extractTextFromMessageContent(choice.message?.content) ??
+            (typeof choice.text === 'string' ? choice.text : null);
+        let agentToolCalls = undefined;
+        if (choice.message?.tool_calls && choice.message.tool_calls.length > 0) {
+            agentToolCalls = [];
+            for (const tc of choice.message.tool_calls) {
+                if (tc.type === 'function' && tc.function) {
+                    try {
+                        const callId = tc.id || `tool_call_${Date.now()}_${Math.random().toString(36).substring(7)}`; // Ensure callId
+                        agentToolCalls.push({
+                            callId: callId,
+                            toolId: tc.function.name,
+                            arguments: JSON.parse(tc.function.arguments || '{}'), // Ensure arguments are parsed; default to empty object if null/undefined
+                        });
+                    }
+                    catch (e) {
+                        const parseErrorMsg = `Failed to parse tool call arguments for tool '${tc.function.name}' (ID: ${tc.id}). Arguments: "${tc.function.arguments}". Error: ${e.message}`;
+                        console.error(`Agent '${this.name}': ${parseErrorMsg}`, e);
+                        // Optionally, include this error information in the agent's output or a system message to the user/orchestrator.
+                        // For now, we skip the malformed tool call.
+                        // A more robust system might try to self-correct or ask for clarification.
+                    }
+                }
+                else {
+                    console.warn(`Agent '${this.name}': Received tool_call of unhandled type '${tc.type}' or malformed function call structure for call ID '${tc.id}'. Skipping.`);
+                }
+            }
+            if (agentToolCalls.length === 0) {
+                agentToolCalls = undefined; // Ensure it's undefined if no valid tool calls were parsed.
+            }
+        }
+        return { responseText, toolCalls: agentToolCalls, rawResponseMessage: choice.message };
+    }
+    /**
+     * Normalizes a provider message content payload into plain text where possible.
+     */
+    extractTextFromMessageContent(content) {
+        if (content === null || content === undefined) {
+            return null;
+        }
+        if (typeof content === 'string') {
+            const trimmed = content.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        if (Array.isArray(content)) {
+            const combined = content
+                .map(part => {
+                if (!part || typeof part !== 'object') {
+                    return '';
+                }
+                if (typeof part.text === 'string') {
+                    return part.text;
+                }
+                if (typeof part.content === 'string') {
+                    return part.content;
+                }
+                if (part.type === 'tool_result' && typeof part.content === 'string') {
+                    return part.content;
+                }
+                return '';
+            })
+                .filter(chunk => typeof chunk === 'string' && chunk.trim().length > 0)
+                .join(' ')
+                .trim();
+            return combined.length > 0 ? combined : null;
+        }
+        if (typeof content === 'object') {
+            return JSON.stringify(content);
+        }
+        return null;
+    }
+    /**
+     * Protected helper to get `ToolDefinition`s for a list of tool IDs.
+     * Used internally when `callLLM` needs to pass tool schemas.
+     * This assumes tools are registered with a `ToolRegistry` or accessible via `AgentOrchestrator`
+     * or similar mechanism that can provide `Tool` instances.
+     * For `AgentCore`, it needs a way to access these definitions.
+     * A simple approach is to assume `this.agentConfig.toolIds` refers to tools
+     * whose definitions can be fetched. This detail depends on how tools are managed globally.
+     * For now, this is a placeholder and might require a `ToolRegistry` dependency.
+     *
+     * @param _toolIds List of tool IDs.
+     * @returns Array of ToolDefinitions.
+     */
+    async getAvailableToolDefinitions(_toolIds) {
+        // This is a conceptual placeholder. In a real system, you'd fetch Tool instances
+        // from a ToolRegistry or via the orchestrator, then get their definitions.
+        // For AgentCore, it doesn't manage tools directly.
+        // If an orchestrator provides `availableTools: Tool[]` to `processTurn`, that's the source.
+        // If this agent needs to pass tools to `callLLM` outside of `processTurn` (e.g., in `handleToolResult`),
+        // it needs a way to get those definitions.
+        // For now, return undefined, assuming the orchestrator handles tool provisioning to processTurn.
+        console.warn(`AgentCore.getAvailableToolDefinitions: Placeholder used. Tool definitions not dynamically fetched based on toolIds in this base class. Ensure tools are provided to processTurn or handleToolResult if needed for sub-calls.`);
+        return undefined;
+    }
+    // --- Convenience output builders ---
+    /**
+     * Creates a standard text-only agent output.
+     * @param {string} text - The textual response from the agent.
+     * @param {boolean} [isComplete=true] - Indicates if the agent's turn is complete with this output.
+     * @param {Record<string, any>} [metadata] - Optional metadata to include.
+     * @returns {AgentOutput} The structured agent output.
+     */
+    textOutput(text, isComplete = true, metadata) {
+        return { responseText: text, isComplete, metadata };
+    }
+    /**
+     * Creates an agent output that requests UI components to be rendered by the client.
+     * @param {UIComponentSpecification[]} components - An array of UI component specifications.
+     * @param {string} [responseText] - Optional accompanying textual response.
+     * @param {boolean} [isComplete=true] - Indicates if the agent's turn is complete.
+     * @param {Record<string, any>} [metadata] - Optional metadata.
+     * @returns {AgentOutput} The structured agent output.
+     */
+    uiOutput(components, responseText, isComplete = true, metadata) {
+        return { uiComponents: components, responseText, isComplete, metadata };
+    }
+    /**
+     * Creates an agent output that requests one or more tool calls to be executed.
+     * This typically means the agent's turn is **not yet complete** (`isComplete: false`),
+     * as it will await the results of these tool calls.
+     *
+     * @param {AgentToolCall[]} toolCalls - An array of tool call objects.
+     * @param {string} [responseText] - Optional interim text to provide to the user
+     * (e.g., "Okay, I will search the web for that information.").
+     * @param {Record<string, any>} [metadata] - Optional metadata.
+     * @returns {AgentOutput} The structured agent output.
+     * @throws {AgentCoreError} If `toolCalls` array is empty or not provided.
+     */
+    toolCallOutput(toolCalls, responseText, metadata) {
+        if (!toolCalls || toolCalls.length === 0) {
+            console.warn(`Agent '${this.name}': toolCallOutput was called with no toolCalls. This is likely an error in agent logic.`);
+            // Return an error output or a fallback text output indicating an issue.
+            return {
+                responseText: responseText || "I was about to use a tool, but encountered an issue selecting one. Please try again.",
+                isComplete: true, // Since no tool call can be made, the turn is effectively stalled/complete.
+                error: new AgentCoreError("Attempted to create toolCallOutput with no tool calls.", 'EMPTY_TOOL_CALL_REQUEST'),
+                metadata,
+            };
+        }
+        return { toolCalls, responseText, isComplete: false, metadata }; // isComplete is false as it awaits tool results
+    }
+}
+//# sourceMappingURL=AgentCore.js.map

package/dist/agents/definitions/AgentCore.js.map

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