@codebolt/agent 5.0.8 → 6.0.0

package/dist/builderpattern/systemprompt.d.ts

@@ -1,20 +0,0 @@
-/**
- * SystemPrompt class for loading and managing system prompts from YAML files
- */
-declare class SystemPrompt {
-    private filepath;
-    private key;
-    /**
-     * Creates a SystemPrompt instance
-     * @param {string} filepath - Path to the YAML file containing prompts
-     * @param {string} key - Key identifier for the specific prompt
-     */
-    constructor(filepath?: string, key?: string);
-    /**
-     * Loads and returns the prompt text
-     * @returns {string} The prompt text
-     * @throws {Error} If file cannot be read or parsed
-     */
-    toPromptText(): string;
-}
-export { SystemPrompt };

package/dist/builderpattern/systemprompt.js

@@ -1,48 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemPrompt = void 0;
-const js_yaml_1 = __importDefault(require("js-yaml"));
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * SystemPrompt class for loading and managing system prompts from YAML files
- */
-class SystemPrompt {
-    /**
-     * Creates a SystemPrompt instance
-     * @param {string} filepath - Path to the YAML file containing prompts
-     * @param {string} key - Key identifier for the specific prompt
-     */
-    constructor(filepath = "", key = "") {
-        this.filepath = filepath;
-        this.key = key;
-    }
-    /**
-     * Loads and returns the prompt text
-     * @returns {string} The prompt text
-     * @throws {Error} If file cannot be read or parsed
-     */
-    toPromptText() {
-        try {
-            const absolutePath = path_1.default.resolve(this.filepath);
-            const fileContents = fs_1.default.readFileSync(absolutePath, 'utf8');
-            const data = js_yaml_1.default.load(fileContents);
-            if (!data || typeof data !== 'object') {
-                throw new Error('Invalid YAML structure');
-            }
-            if (!data[this.key]) {
-                throw new Error(`Prompt not found for key: ${this.key}`);
-            }
-            const promptData = data[this.key];
-            return typeof promptData === 'string' ? promptData : promptData.prompt;
-        }
-        catch (error) {
-            console.error(`SystemPrompt Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-            throw error; // Re-throw to allow caller handling
-        }
-    }
-}
-exports.SystemPrompt = SystemPrompt;

package/dist/builderpattern/taskInstruction.d.ts

@@ -1,37 +0,0 @@
-import { UserMessage } from "./usermessage";
-import type { UserMessageContent } from "../types/libFunctionTypes";
-import type { Tools, UserMessages } from "../types/InternalTypes";
-/**
- * Class representing a task instruction.
- * Handles loading task data and converting it to prompts.
- */
-declare class TaskInstruction {
-    /** Available tools for the task */
-    tools: Tools;
-    /** Messages from the user for this task */
-    userMessages: UserMessageContent[];
-    /** The user message object containing input */
-    userMessage: UserMessage;
-    /** Path to the YAML file with task instructions */
-    filepath: string;
-    /** The section reference within the YAML file */
-    refsection: string;
-    /**
-     * Creates a new TaskInstruction instance.
-     *
-     * @param tools - Tools available for this task
-     * @param userMessage - User message containing task instructions
-     * @param filepath - Path to the YAML file with task data
-     * @param refsection - Section name within the YAML file
-     */
-    constructor(tools: Tools | undefined, userMessage: UserMessage, filepath?: string, refsection?: string);
-    /**
-     * Converts the task instruction to a prompt format.
-     * Loads data from YAML file and combines with user message.
-     *
-     * @returns Promise with an array of user message content blocks
-     * @throws Error if there's an issue processing the task instruction
-     */
-    toPrompt(): Promise<UserMessages[]>;
-}
-export { TaskInstruction };

package/dist/builderpattern/taskInstruction.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TaskInstruction = void 0;
-/**
- * Encapsulates task instructions and their related metadata.
- * Handles loading and processing of task instructions from YAML files.
- */
-const yaml = require('js-yaml');
-const fs = require('fs');
-const path = require('path');
-/**
- * Class representing a task instruction.
- * Handles loading task data and converting it to prompts.
- */
-class TaskInstruction {
-    /**
-     * Creates a new TaskInstruction instance.
-     *
-     * @param tools - Tools available for this task
-     * @param userMessage - User message containing task instructions
-     * @param filepath - Path to the YAML file with task data
-     * @param refsection - Section name within the YAML file
-     */
-    constructor(tools = {}, userMessage, filepath = "", refsection = "") {
-        /** Messages from the user for this task */
-        this.userMessages = [];
-        this.tools = tools;
-        this.userMessage = userMessage;
-        this.filepath = filepath;
-        this.refsection = refsection;
-    }
-    /**
-     * Converts the task instruction to a prompt format.
-     * Loads data from YAML file and combines with user message.
-     *
-     * @returns Promise with an array of user message content blocks
-     * @throws Error if there's an issue processing the task instruction
-     */
-    async toPrompt() {
-        try {
-            this.userMessages = await this.userMessage.toPrompt();
-            const fileContents = fs.readFileSync(path.resolve(this.filepath), 'utf8');
-            const data = yaml.load(fileContents);
-            const task = data[this.refsection];
-            this.userMessages.push({
-                type: "text",
-                text: `Task Description: ${task.description}\nExpected Output: ${task.expected_output}`
-            });
-            return this.userMessages;
-        }
-        catch (error) {
-            console.error(`Error processing task instruction: ${error}`);
-            throw error;
-        }
-    }
-}
-exports.TaskInstruction = TaskInstruction;

package/dist/builderpattern/usermessage.d.ts

@@ -1,70 +0,0 @@
-import type { UserMessageContent } from "../types/libFunctionTypes";
-import type { Agent } from "../types/commonTypes";
-import type { Message } from "../types/InternalTypes";
-/**
- * Class that processes and manages user messages.
- * Handles converting messages to prompts and extracting mentioned entities.
- */
-declare class UserMessage {
-    /** The message content and metadata */
-    message: Message;
-    /** Whether to override the default prompt generation */
-    promptOverride: boolean;
-    /** Array of content blocks for the user message */
-    userMessages: UserMessageContent[];
-    /** List of MCP tools mentioned in the message */
-    mentionedMCPs: {
-        toolbox: string;
-        toolName: string;
-    }[];
-    /**
-     * Creates a new UserMessage instance.
-     *
-     * @param message - The message content and metadata
-     * @param promptOverride - Whether to override default prompt generation
-     */
-    constructor(message: Message, promptOverride?: boolean);
-    /**
-     * Gets files mentioned in the message.
-     * Currently a placeholder for implementation.
-     */
-    getFiles(): void;
-    /**
-     * Converts the user message to a prompt format.
-     *
-     * @param bAttachFiles - Whether to attach file contents
-     * @param bAttachImages - Whether to attach images
-     * @param bAttachEnvironment - Whether to attach environment details
-     * @returns Promise with an array of content blocks for the prompt
-     */
-    toPrompt(bAttachFiles?: boolean, bAttachImages?: boolean, bAttachEnvironment?: boolean, supportRemix?: boolean): Promise<UserMessageContent[]>;
-    /**
-     * Gets agents mentioned in the message.
-     *
-     * @returns Array of agent objects
-     */
-    getMentionedAgents(): Agent[];
-    /**
-     * Gets MCP tools mentioned in the message.
-     *
-     * @returns Array of MCP tool names
-     */
-    getMentionedMcps(): {
-        toolbox: string;
-        toolName: string;
-    }[];
-    /**
-     * Gets MCP tools in a format suitable for the LLM.
-     *
-     * @returns Promise with an array of MCP tools
-     */
-    getMentionedMcpsTools(): Promise<any>;
-    /**
-     * Gets environment details for the current working directory.
-     *
-     * @param cwd - The current working directory path
-     * @returns Promise with a string containing environment details
-     */
-    private getEnvironmentDetail;
-}
-export { UserMessage };

package/dist/builderpattern/usermessage.js

@@ -1,123 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserMessage = void 0;
-const codeboltjs_1 = __importDefault(require("@codebolt/codeboltjs"));
-const { fs: cbfs, project, mcp } = codeboltjs_1.default;
-// All interfaces moved to appropriate type files
-/**
- * Class that processes and manages user messages.
- * Handles converting messages to prompts and extracting mentioned entities.
- */
-class UserMessage {
-    /**
-     * Creates a new UserMessage instance.
-     *
-     * @param message - The message content and metadata
-     * @param promptOverride - Whether to override default prompt generation
-     */
-    constructor(message, promptOverride = false) {
-        /**
-         * Gets environment details for the current working directory.
-         *
-         * @param cwd - The current working directory path
-         * @returns Promise with a string containing environment details
-         */
-        this.getEnvironmentDetail = async (cwd) => {
-            let details = "";
-            const { success, result } = await cbfs.listFile(cwd, true);
-            details += `\n\n# Current Working Directory (${cwd}) Files\n${result}
-            ? "\n(Note: Only top-level contents shown for Desktop by default. Use list_files to explore further if necessary.)"
-            : ""
-            }`;
-            return `<environment_details>\n${details.trim()}\n</environment_details>`;
-        };
-        this.message = message;
-        this.promptOverride = promptOverride;
-        this.userMessages = [];
-        this.mentionedMCPs = message.mentionedMCPs || [];
-    }
-    /**
-     * Gets files mentioned in the message.
-     * Currently a placeholder for implementation.
-     */
-    getFiles() {
-        // Implementation to be added
-    }
-    /**
-     * Converts the user message to a prompt format.
-     *
-     * @param bAttachFiles - Whether to attach file contents
-     * @param bAttachImages - Whether to attach images
-     * @param bAttachEnvironment - Whether to attach environment details
-     * @returns Promise with an array of content blocks for the prompt
-     */
-    async toPrompt(bAttachFiles = true, bAttachImages = true, bAttachEnvironment = true, supportRemix = true) {
-        var _a;
-        if (bAttachFiles) {
-            if (this.promptOverride) {
-                // Use a rendering engine
-            }
-            else {
-                let finalPrompt = `
-                    The user has sent the following query:
-                   <user_query> ${this.message.userMessage} </user_query>.
-                `;
-                if ((_a = this.message.mentionedFiles) === null || _a === void 0 ? void 0 : _a.length) {
-                    finalPrompt += `The Attached files are:`;
-                    for (const file of this.message.mentionedFiles) {
-                        let filedata = await cbfs.readFile(file);
-                        finalPrompt += `File Name: ${file}, File Path: ${file}, Filedata: ${filedata}`;
-                    }
-                }
-                this.userMessages.push({ type: "text", text: finalPrompt });
-            }
-        }
-        if (bAttachEnvironment) {
-            let { projectPath } = await project.getProjectPath();
-            if (projectPath) {
-                const environmentDetail = await this.getEnvironmentDetail(projectPath);
-                this.userMessages.push({ type: "text", text: environmentDetail });
-            }
-        }
-        if (supportRemix) {
-            if (this.message.remixPrompt)
-                this.userMessages.push({ type: "text", text: this.message.remixPrompt });
-        }
-        return this.userMessages;
-    }
-    /**
-     * Gets agents mentioned in the message.
-     *
-     * @returns Array of agent objects
-     */
-    getMentionedAgents() {
-        //TODO : get config in tool format if neede
-        return this.message.mentionedAgents || [];
-    }
-    /**
-     * Gets MCP tools mentioned in the message.
-     *
-     * @returns Array of MCP tool names
-     */
-    getMentionedMcps() {
-        return this.message.mentionedMCPs || [];
-    }
-    /**
-     * Gets MCP tools in a format suitable for the LLM.
-     *
-     * @returns Promise with an array of MCP tools
-     */
-    async getMentionedMcpsTools() {
-        if (this.mentionedMCPs.length > 0) {
-            const { data } = await mcp.getTools(this.mentionedMCPs);
-            return data;
-        }
-        else {
-            return [];
-        }
-    }
-}
-exports.UserMessage = UserMessage;

package/dist/composablepattern/agent.d.ts

@@ -1,169 +0,0 @@
-/**
- * @fileoverview Main ComposableAgent implementation
- * @description Core agent class that provides a composable API for creating and running agents
- */
-import type { ComposableAgentConfig, ComposableAgent as IComposableAgent, Message, ExecutionResult, ExecutionContext, StreamCallback, Tool, CodeBoltMessage } from './types';
-/**
- * Main ComposableAgent class that provides a simple, composable API for creating agents
- */
-export declare class ComposableAgent implements IComposableAgent {
-    readonly config: ComposableAgentConfig;
-    private conversation;
-    private memory?;
-    private tools;
-    constructor(config: ComposableAgentConfig);
-    /**
-     * Run the agent using globally saved user context from codeboltjs
-     * This is the main method to use within codebolt.onMessage()
-     *
-     * @param options - Execution options
-     * @returns Promise<ExecutionResult>
-     */
-    run(options?: {
-        stream?: boolean;
-        callback?: StreamCallback;
-    }): Promise<ExecutionResult>;
-    /**
-     * Execute a task with the agent using a simple string message
-     *
-     * @param message - User message to process
-     * @param options - Execution options
-     * @returns Promise<ExecutionResult>
-     */
-    execute(message: string, options?: {
-        stream?: boolean;
-        callback?: StreamCallback;
-    }): Promise<ExecutionResult>;
-    /**
-     * Execute a task with the agent using CodeBolt Message format
-     *
-     * @param message - CodeBolt message with enhanced features
-     * @param options - Execution options
-     * @returns Promise<ExecutionResult>
-     */
-    executeMessage(message: CodeBoltMessage, options?: {
-        stream?: boolean;
-        callback?: StreamCallback;
-    }): Promise<ExecutionResult>;
-    /**
-     * Add a message to the conversation
-     *
-     * @param message - Message to add
-     */
-    addMessage(message: Message): void;
-    /**
-     * Get conversation history
-     *
-     * @returns Array of messages
-     */
-    getConversation(): Message[];
-    /**
-     * Clear conversation history (keeps system message)
-     */
-    clearConversation(): void;
-    /**
-     * Save conversation to memory
-     */
-    saveConversation(): Promise<void>;
-    /**
-     * Load conversation from memory
-     */
-    loadConversation(): Promise<void>;
-    /**
-     * Make a request to the LLM
-     *
-     * @returns LLM response
-     */
-    private makeLLMRequest;
-    /**
-     * Execute a tool call
-     *
-     * @param toolCall - Tool call to execute
-     * @returns Tool result message
-     */
-    private executeToolCall;
-    /**
-     * Get list of tools that were used in the conversation
-     *
-     * @returns Array of tool names
-     */
-    private getUsedTools;
-    /**
-     * Get available tools
-     *
-     * @returns Record of available tools
-     */
-    getTools(): Record<string, Tool>;
-    /**
-     * Add a tool to the agent
-     *
-     * @param name - Tool name
-     * @param tool - Tool instance
-     */
-    addTool(name: string, tool: Tool): void;
-    /**
-     * Remove a tool from the agent
-     *
-     * @param name - Tool name
-     */
-    removeTool(name: string): void;
-    /**
-     * Get execution context for tools
-     *
-     * @returns ExecutionContext
-     */
-    getExecutionContext(): ExecutionContext;
-    /**
-     * Process CodeBolt message and enhance agent capabilities
-     *
-     * @param message - CodeBolt message to process
-     */
-    private processCodeBoltMessage;
-    /**
-     * Process remix prompt and enhance system instructions
-     *
-     * @param remixPrompt - Additional instructions to add to system prompt
-     */
-    private processRemixPrompt;
-    /**
-     * Process mentioned MCP tools and add them to available tools
-     *
-     * @param mentionedMCPs - List of MCP tools to process
-     */
-    private processMCPs;
-    /**
-     * Create a generic MCP tool wrapper
-     *
-     * @param toolbox - MCP toolbox name
-     * @param toolName - MCP tool name
-     * @returns Tool instance
-     */
-    private createMCPTool;
-    /**
-     * Process mentioned agents and add them as sub-agent tools
-     *
-     * @param mentionedAgents - List of agents to process
-     */
-    private processAgents;
-    /**
-     * Create a sub-agent tool wrapper
-     *
-     * @param agent - Agent information
-     * @returns Tool instance
-     */
-    private createSubAgentTool;
-    /**
-     * Process mentioned files and return their contents
-     *
-     * @param mentionedFiles - List of file paths
-     * @returns Array of file contents with headers
-     */
-    private processFiles;
-}
-/**
- * Create a new ComposableAgent instance
- *
- * @param config - Agent configuration
- * @returns ComposableAgent instance
- */
-export declare function createAgent(config: ComposableAgentConfig): ComposableAgent;