updated agentlib

Author: Nursid

.gitignore

@@ -19,3 +19,4 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 .codeboltAgents
+.qodo

docs/api/agentlib/taskInstructions.md

@@ -0,0 +1,63 @@
+---
+name: TaskInstruction
+cbbaseinfo:
+  description: Encapsulates task instructions and their metadata, handling loading/processing from YAML files.
+cbparameters:
+  parameters:
+    - name: tools
+      typeName: Tools
+      description: Object containing tool definitions with descriptions and usage examples
+    - name: userMessage
+      typeName: UserMessage
+      description: User message content handler for prompt generation
+    - name: filepath
+      typeName: string
+      description: Path to YAML file containing task definitions
+    - name: refsection
+      typeName: string
+      description: Specific section key to load from the YAML file
+  returns:
+    signatureTypeName: TaskInstruction
+    description: New TaskInstruction instance configured with provided parameters
+    typeArgs: []
+data:
+  name: TaskInstruction
+  category: task-management
+  link: TaskInstruction.md
+---
+<CBBaseInfo/>
+<CBParameters/>
+
+### Example
+
+```js
+import { TaskInstruction } from './task-instruction';
+import { UserMessage } from './usermessage';
+
+// Sample tools configuration
+const tools = {
+  fileProcessor: {
+    description: "Handles file operations",
+    usage: "processFile(filename)",
+    example: "processFile('data.txt')"
+  }
+};
+
+// Create a UserMessage instance 
+const userMsg = new UserMessage(/* message configuration */);
+
+// Initialize task instruction loader
+const taskInstruction = new TaskInstruction(
+  tools,
+  userMsg,
+  "./tasks/data_processing.yml",
+  "data_cleanup"
+);
+
+// Generate prompts with task details
+try {
+  const prompts = await taskInstruction.toPrompt();
+  console.log("Generated prompts:", prompts);
+} catch (error) {
+  console.error("Failed to process task:", error);
+}

docs/api/agentlib/usermessage.md

@@ -0,0 +1,47 @@
+---
+name: UserMessage
+cbbaseinfo:
+  description: Handles user message processing with file/environment context attachment
+cbparameters:
+  parameters:
+    - name: message
+      typeName: Message
+      description: Message object containing user input and file/MCP references
+    - name: promptOverride
+      typeName: boolean
+      description: Flag to enable custom prompt rendering (default false)
+  returns:
+    signatureTypeName: UserMessage
+    description: Configured message processor with context attachment capabilities
+    typeArgs: []
+data:
+  name: UserMessage
+  category: message-processing
+  link: UserMessage.md
+---
+<CBBaseInfo/>
+<CBParameters/>
+
+### Example
+
+```js
+import { UserMessage } from './usermessage';
+
+// Create a message with file references
+const message = {
+  userMessage: "Please analyze these config files",
+  mentionedFiles: ["/src/config/app.json"],
+  mentionedMCPs: ["config-validator"]
+};
+
+// Initialize processor
+const userMsgProcessor = new UserMessage(message);
+
+// Generate full context prompt
+const fullPrompt = await userMsgProcessor.toPrompt(
+  true,   // Attach files
+  false,  // Skip images
+  true    // Include environment
+);
+
+console.log("Context-rich prompt:", fullPrompt);