symposium 1.0.5 → 1.1.0

package/Agent.js

@@ -4,6 +4,8 @@ import BufferedEventEmitter from "./BufferedEventEmitter.js";
 
 import Symposium from "./Symposium.js";
 import Thread from "./Thread.js";
+import Tool from "./Tool.js";
+import Context from "./Context.js";
 
 export default class Agent {
 	name = 'Agent';
@@ -12,6 +14,7 @@ export default class Agent {
 	threads;
 	functions = null;
 	tools = new Map();
+	context = [];
 	default_model = 'gpt-4o';
 	max_retries = 5;
 	type = 'chat'; // chat, utility
@@ -61,11 +64,48 @@ export default class Agent {
 	}
 
 	addTool(tool) {
+		if (!(tool instanceof Tool) || !tool.name)
+			throw new Error('Tool must be an instance of Tool class');
+		if (this.tools.has(tool.name))
+			throw new Error('Tool with name ' + tool.name + ' already exists in agent');
+
 		this.tools.set(tool.name, tool);
 	}
 
+	addContext(context) {
+		if (!(context instanceof Context))
+			throw new Error('Context must be an instance of Context class');
+
+		// TODO: on-request contexts
+		// TODO: summarization based on tokens
+		// TODO: RAG
+
+		this.context.push(context);
+	}
+
 	async initThread(thread) {
 		await this.doInitThread(thread);
+
+		const context_texts = [];
+		for (let context of this.context) {
+			const text = await context.getText();
+			if (text)
+				context_texts.push('<context>' + text + '</context>');
+		}
+
+		if (context_texts.length) {
+			let system_message_found = null;
+			for (let messages of thread.messages) {
+				if (messages.role === 'system')
+					system_message_found = messages;
+			}
+
+			if (system_message_found)
+				system_message_found.content[0].content += '<context_info>' + context_texts.join('\n') + '</context_info>';
+			else
+				thread.addMessage('system', '<context_info>' + context_texts.join('\n') + '</context_info>');
+		}
+
 		await thread.storeState();
 	}
 

package/Context.js

@@ -0,0 +1,8 @@
+export default class Context {
+	/**
+	 * @returns {Promise<string|null>}
+	 */
+	async getText() {
+		return null;
+	}
+}

package/Contexts/File.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+import Context from "../Context.js";
+
+export default class File extends Context {
+	constructor(file) {
+		super();
+		this.file = file;
+	}
+
+	async getText() {
+		if (this.file.startsWith('http://') || this.file.startsWith('https://')) {
+			return fetch(this.file);
+		} else {
+			if (fs.existsSync(this.file))
+				return fs.promises.readFile(this.file, "utf8");
+			else
+				throw new Error(`File not found: ${this.file}`);
+		}
+	}
+}

package/README.md

@@ -62,9 +62,41 @@ async function main() {
 main();
 ```
 
-### 2. Create your Agent
+### 2. One shot prompts
 
-Create a new class that extends `Agent`. At a minimum, you'll want to define a name and a system prompt.
+You can also use the static `Symposium.prompt()` method for one-off prompts without creating an agent.
+
+```javascript
+import { Symposium } from 'symposium';
+await Symposium.init();
+
+const response = await Symposium.prompt('Translate the text from English to French.', 'Hello, how are you?');
+console.log(response); // "Bonjour, comment ça va?"
+
+const structured_response = await Symposium.prompt('Extract name and emails from the following email', email_text, {
+	response: {
+		type: 'json',
+        function: {
+            name: 'extract_data',
+            parameters: {
+                type: 'array',
+                items: {
+	                type: 'object',
+	                properties: {
+		                name: {type: 'string'},
+		                email: {type: 'string'},
+	                },
+	                required: ['name', 'email'],
+                },
+            },
+        },
+    },
+});
+```
+
+### 3. Create your Agent
+
+For more structured and/or reusable tasks, create a new class that extends `Agent`. At a minimum, you'll want to define a name and a system prompt.
 
 ```javascript
 // MyChatAgent.js
@@ -80,7 +112,7 @@ export default class MyChatAgent extends Agent {
 }
 ```
 
-### 3. Start a Conversation
+### 4. Start a Conversation
 
 Now you can instantiate your agent and start a conversation.
 

package/Symposium.js

@@ -116,7 +116,7 @@ export default class Symposium {
 		return mimeToExt[mime] || null;
 	}
 
-	static async oneShot(system, prompt, options = {}) {
+	static async prompt(system, prompt, options = {}) {
 		const agent = new Agent(options.agent || {});
 		agent.type = 'utility';
 		agent.utility = options.response || {

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "symposium",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Agents",
   "main": "index.js",
   "author": "Domenico Giambra",