symposium 1.0.3 → 1.0.5

package/Agent.js

@@ -72,7 +72,10 @@ export default class Agent {
 	async doInitThread(thread) {
 	}
 
-	async getThread(id) {
+	async getThread(id = null) {
+		if (id === null)
+			id = uuid();
+
 		let thread = this.threads.get(id);
 		if (!thread) {
 			thread = new Thread(id, this);
@@ -359,6 +362,10 @@ export default class Agent {
 		return value;
 	}
 
+	getEmitter() {
+		return new BufferedEventEmitter();
+	}
+
 	async getFunctions(parsed = true) {
 		if (this.functions === null) {
 			this.functions = new Map();
@@ -382,23 +389,26 @@ export default class Agent {
 			return this.functions;
 	}
 
-	async callFunction(thread, function_call, emitter) {
+	async callFunction(thread, function_call, emitter = null) {
 		const functions = await this.getFunctions(false);
 		if (!functions.has(function_call.name))
 			throw new Error('Unrecognized function ' + function_call.name);
 
 		const func = functions.get(function_call.name);
 		const partialOutput = func.partialOutput ? ((typeof func.partialOutput) === 'text' ? func.partialOutput : func.partialOutput.call(this, function_call.arguments)) : 'Uso lo strumento ' + function_call.name + '...';
-		emitter.emit('partial', partialOutput);
+		if (emitter)
+			emitter.emit('partial', partialOutput);
 
 		await this.log('function_call', function_call);
 
 		try {
 			const response = await func.tool.callFunction(thread, function_call.name, function_call.arguments);
-			emitter.emit('partial', 'Risposta ricevuta da ' + func.tool.name);
+			if (emitter)
+				emitter.emit('partial', 'Risposta ricevuta da ' + func.tool.name);
 			return response;
 		} catch (error) {
-			emitter.emit('partial', 'Ricevuto errore da ' + func.tool.name);
+			if (emitter)
+				emitter.emit('partial', 'Ricevuto errore da ' + func.tool.name);
 			return {error};
 		}
 	}

package/{MemoryHandler.js → ContextHandler.js}

@@ -1,4 +1,4 @@
-export default class MemoryHandler {
+export default class ContextHandler {
 	agent = null;
 
 	setAgent(agent) {

package/README.md

@@ -38,7 +38,7 @@ The framework is built around a few core components:
 -   **`Thread`**: Represents a single conversation with an agent. It maintains the message history and the agent's state for that conversation. Each thread has a unique ID.
 -   **`Tool`**: A base class for creating tools that an `Agent` can use. Tools expose functions that the LLM can call to interact with external APIs or data.
 -   **`Message`**: A wrapper for messages within a `Thread`, containing the role (`user`, `assistant`, `system`, `tool`), content, and other metadata.
--   **`MemoryHandler`**: A class for managing an agent's long-term memory. It can be extended to create custom memory strategies.
+-   **`ContextHandler`**: A class for managing an agent's long contexts. It can be extended to create custom memory strategies.
 -   **`Summarizer`**: A utility agent for summarizing text or conversations.
 -   **`Logger`**: A simple logging utility that can be passed to an agent to log its activity.
 
@@ -338,7 +338,7 @@ This is a high-level overview. For details, please refer to the source code.
 
 ### Other Classes
 
--   **`MemoryHandler`**: Provides a base for implementing long-term memory for an agent.
+-   **`ContextHandler`**: Provides a base for managing long-term context. Can be extended for custom memory strategies.
 -   **`Summarizer`**: A utility agent for text summarization.
 -   **`Logger`**: A simple logger for agent activity.
 

package/Summarizer.js

@@ -1,7 +1,7 @@
 import Symposium from "./Symposium.js";
-import MemoryHandler from "./MemoryHandler.js";
+import ContextHandler from "./ContextHandler.js";
 
-export default class Summarizer extends MemoryHandler {
+export default class Summarizer extends ContextHandler {
 	constructor(threshold = 0.7, summary_length = 0.5) {
 		super();
 		this.threshold = threshold;

package/Symposium.js

@@ -2,6 +2,8 @@ import fs from 'fs';
 import path from 'path';
 import {fileURLToPath} from 'url';
 
+import Agent from "./Agent.js";
+
 export default class Symposium {
 	static models = new Map();
 	static storage = null;
@@ -113,4 +115,19 @@ export default class Symposium {
 
 		return mimeToExt[mime] || null;
 	}
+
+	static async oneShot(system, prompt, options = {}) {
+		const agent = new Agent(options.agent || {});
+		agent.type = 'utility';
+		agent.utility = options.response || {
+			type: 'text',
+		};
+
+		agent.doInitThread = async thread => {
+			await thread.addMessage('system', system);
+		};
+
+		const thread = await agent.getThread();
+		return agent.message(prompt, thread);
+	}
 }

package/index.js

@@ -5,7 +5,7 @@ import Agent from "./Agent.js";
 import Thread from "./Thread.js";
 import Tool from "./Tool.js";
 import Logger from "./Logger.js";
-import MemoryHandler from "./MemoryHandler.js";
+import ContextHandler from "./ContextHandler.js";
 import Summarizer from "./Summarizer.js";
 
 export {
@@ -14,6 +14,6 @@ export {
 	Thread,
 	Tool,
 	Logger,
-	MemoryHandler,
+	ContextHandler,
 	Summarizer,
 };

package/package.json

@@ -1,16 +1,16 @@
 {
   "type": "module",
   "name": "symposium",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Agents",
   "main": "index.js",
   "author": "Domenico Giambra",
   "license": "ISC",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.60.0",
-    "groq-sdk": "^0.30.0",
+    "@anthropic-ai/sdk": "^0.64.0",
+    "groq-sdk": "^0.32.0",
     "openai": "^5.0.0",
     "tiktoken": "^1.0.10",
-    "uuid": "^11.1.0"
+    "uuid": "^13.0.0"
   }
 }