@voltagent/core 0.1.19 → 0.1.20

package/dist/index.js

@@ -56,6 +56,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -139,12 +143,13 @@ var import_events2 = require("events");
 // src/server/registry.ts
 var _AgentRegistry = class {
   constructor() {
-    this.agents = /* @__PURE__ */ new Map();
-    this.isInitialized = false;
+    __publicField(this, "agents", /* @__PURE__ */ new Map());
+    __publicField(this, "isInitialized", false);
+    __publicField(this, "globalVoltAgentExporter");
     /**
      * Track parent-child relationships between agents (child -> parents)
      */
-    this.agentRelationships = /* @__PURE__ */ new Map();
+    __publicField(this, "agentRelationships", /* @__PURE__ */ new Map());
   }
   /**
    * Get the singleton instance of AgentRegistry
@@ -279,14 +284,14 @@ var _AgentRegistry = class {
 };
 var AgentRegistry = _AgentRegistry;
 __name(AgentRegistry, "AgentRegistry");
-AgentRegistry.instance = null;
+__publicField(AgentRegistry, "instance", null);
 
 // src/events/index.ts
 var import_uuid = require("uuid");
 var _AgentEventEmitter = class extends import_events2.EventEmitter {
   constructor() {
     super();
-    this.trackedEvents = /* @__PURE__ */ new Map();
+    __publicField(this, "trackedEvents", /* @__PURE__ */ new Map());
   }
   /**
    * Get the singleton instance of AgentEventEmitter
@@ -547,7 +552,7 @@ var _AgentEventEmitter = class extends import_events2.EventEmitter {
 };
 var AgentEventEmitter = _AgentEventEmitter;
 __name(AgentEventEmitter, "AgentEventEmitter");
-AgentEventEmitter.instance = null;
+__publicField(AgentEventEmitter, "instance", null);
 
 // src/utils/update/index.ts
 var import_node_path = __toESM(require("path"));
@@ -860,7 +865,7 @@ var MessageContentSchema = import_zod.z.union([
   import_zod.z.array(ContentPartSchema).openapi({ description: "An array of content parts (text, image, file)." })
 ]);
 var MessageObjectSchema = import_zod.z.object({
-  role: import_zod.z.string().openapi({
+  role: import_zod.z.enum(["system", "user", "assistant", "tool"]).openapi({
     description: "Role of the sender (e.g., 'user', 'assistant')"
   }),
   content: MessageContentSchema
@@ -1275,7 +1280,7 @@ app.openapi(getAgentsRoute, (c) => {
       data: agentDataArray
       // Ensure data array matches schema
     };
-    return c.json(response);
+    return c.json(response, 200);
   } catch (error) {
     console.error("Failed to get agents:", error);
     return c.json(
@@ -1351,7 +1356,10 @@ app.openapi(textRoute, (c) => __async(void 0, null, function* () {
   try {
     const { input, options = {} } = c.req.valid("json");
     const response = yield agent.generateText(input, options);
-    return c.json({ success: true, data: response });
+    return c.json(
+      { success: true, data: response },
+      200
+    );
   } catch (error) {
     return c.json(
       {
@@ -1484,7 +1492,10 @@ app.openapi(objectRoute, (c) => __async(void 0, null, function* () {
       options = {}
     } = c.req.valid("json");
     const response = yield agent.generateObject(input, schema, options);
-    return c.json({ success: true, data: response });
+    return c.json(
+      { success: true, data: response },
+      200
+    );
   } catch (error) {
     return c.json(
       {
@@ -1915,10 +1926,11 @@ var InMemoryStorage = class {
    * @param options Configuration options
    */
   constructor(options = {}) {
-    this.storage = {};
-    this.conversations = /* @__PURE__ */ new Map();
-    this.historyEntries = /* @__PURE__ */ new Map();
-    this.agentHistory = {};
+    __publicField(this, "storage", {});
+    __publicField(this, "conversations", /* @__PURE__ */ new Map());
+    __publicField(this, "historyEntries", /* @__PURE__ */ new Map());
+    __publicField(this, "agentHistory", {});
+    __publicField(this, "options");
     this.options = {
       storageLimit: options.storageLimit || 100,
       debug: options.debug || false
@@ -2300,6 +2312,9 @@ var LibSQLStorage = class {
    * @param options Configuration options
    */
   constructor(options) {
+    __publicField(this, "client");
+    __publicField(this, "options");
+    __publicField(this, "initialized");
     this.options = {
       storageLimit: options.storageLimit || 100,
       tablePrefix: options.tablePrefix || "voltagent_memory",
@@ -3083,6 +3098,18 @@ var MemoryManager = class {
    * Creates a new MemoryManager
    */
   constructor(resourceId, memory, options = {}) {
+    /**
+     * The memory storage instance
+     */
+    __publicField(this, "memory");
+    /**
+     * Memory configuration options
+     */
+    __publicField(this, "options");
+    /**
+     * The ID of the resource (agent) that owns this memory manager
+     */
+    __publicField(this, "resourceId");
     this.resourceId = resourceId;
     if (memory === false) {
       this.memory = void 0;
@@ -3730,11 +3757,11 @@ var ToolManager = class {
     /**
      * Standalone tools managed by this manager.
      */
-    this.tools = [];
+    __publicField(this, "tools", []);
     /**
      * Toolkits managed by this manager.
      */
-    this.toolkits = [];
+    __publicField(this, "toolkits", []);
     this.addItems(items);
   }
   /**
@@ -4013,6 +4040,26 @@ var Tool = class {
    * Create a new tool
    */
   constructor(options) {
+    /**
+     * Unique identifier for the tool
+     */
+    __publicField(this, "id");
+    /**
+     * Name of the tool
+     */
+    __publicField(this, "name");
+    /**
+     * Description of the tool
+     */
+    __publicField(this, "description");
+    /**
+     * Tool parameter schema
+     */
+    __publicField(this, "parameters");
+    /**
+     * Function to execute when the tool is called
+     */
+    __publicField(this, "execute");
     if (!options.name) {
       throw new Error("Tool name is required");
     }
@@ -4050,6 +4097,23 @@ var HistoryManager = class {
    * @param voltAgentExporter - Optional exporter for telemetry
    */
   constructor(agentId, memoryManager, maxEntries = 0, voltAgentExporter) {
+    /**
+     * Maximum number of history entries to keep
+     * Set to 0 for unlimited
+     */
+    __publicField(this, "maxEntries");
+    /**
+     * Agent ID for emitting events
+     */
+    __publicField(this, "agentId");
+    /**
+     * Memory manager for storing history entries
+     */
+    __publicField(this, "memoryManager");
+    /**
+     * Optional VoltAgentExporter for sending telemetry data.
+     */
+    __publicField(this, "voltAgentExporter");
     this.agentId = agentId;
     this.memoryManager = memoryManager;
     this.maxEntries = maxEntries;
@@ -4438,10 +4502,14 @@ var SubAgentManager = class {
    * @param subAgents - Initial sub-agents to add
    */
   constructor(agentName, subAgents = []) {
+    /**
+     * The name of the agent that owns this sub-agent manager
+     */
+    __publicField(this, "agentName");
     /**
      * Sub-agents that the parent agent can delegate tasks to
      */
-    this.subAgents = [];
+    __publicField(this, "subAgents", []);
     this.agentName = agentName;
     this.subAgents = [];
     subAgents.forEach((agent) => this.addSubAgent(agent));
@@ -4933,10 +5001,66 @@ var Agent = class {
    * Create a new agent
    */
   constructor(options) {
+    /**
+     * Unique identifier for the agent
+     */
+    __publicField(this, "id");
+    /**
+     * Agent name
+     */
+    __publicField(this, "name");
+    /**
+     * @deprecated Use `instructions` instead. Will be removed in a future version.
+     */
+    __publicField(this, "description");
+    /**
+     * Agent instructions. This is the preferred field over `description`.
+     */
+    __publicField(this, "instructions");
+    /**
+     * The LLM provider to use
+     */
+    __publicField(this, "llm");
+    /**
+     * The AI model to use
+     */
+    __publicField(this, "model");
+    /**
+     * Hooks for agent lifecycle events
+     */
+    __publicField(this, "hooks");
+    /**
+     * Voice provider for the agent
+     */
+    __publicField(this, "voice");
+    /**
+     * Indicates if the agent should format responses using Markdown.
+     */
+    __publicField(this, "markdown");
+    /**
+     * Memory manager for the agent
+     */
+    __publicField(this, "memoryManager");
+    /**
+     * Tool manager for the agent
+     */
+    __publicField(this, "toolManager");
+    /**
+     * Sub-agent manager for the agent
+     */
+    __publicField(this, "subAgentManager");
+    /**
+     * History manager for the agent
+     */
+    __publicField(this, "historyManager");
+    /**
+     * Retriever for automatic RAG
+     */
+    __publicField(this, "retriever");
     /**
      * Standard timeline event creator
      */
-    this.createStandardTimelineEvent = /* @__PURE__ */ __name((historyId, eventName, status, nodeType, nodeName, data = {}, type = "agent", context) => {
+    __publicField(this, "createStandardTimelineEvent", /* @__PURE__ */ __name((historyId, eventName, status, nodeType, nodeName, data = {}, type = "agent", context) => {
       if (!historyId)
         return;
       const affectedNodeId = createNodeId(nodeType, nodeName, this.id);
@@ -4976,11 +5100,11 @@ var Agent = class {
         });
         AgentEventEmitter.getInstance().addHistoryEvent(parentEventPayload);
       }
-    }, "createStandardTimelineEvent");
+    }, "createStandardTimelineEvent"));
     /**
      * Fix delete operator usage for better performance
      */
-    this.addToolEvent = /* @__PURE__ */ __name((_0, _1, _2, _3, ..._4) => __async(this, [_0, _1, _2, _3, ..._4], function* (context, eventName, toolName, status, data = {}) {
+    __publicField(this, "addToolEvent", /* @__PURE__ */ __name((_0, _1, _2, _3, ..._4) => __async(this, [_0, _1, _2, _3, ..._4], function* (context, eventName, toolName, status, data = {}) {
       var _a;
       if (!context.toolSpans) {
         context.toolSpans = /* @__PURE__ */ new Map();
@@ -5059,11 +5183,11 @@ var Agent = class {
         }
         return result;
       });
-    }), "addToolEvent");
+    }), "addToolEvent"));
     /**
      * Agent event creator (update)
      */
-    this.addAgentEvent = /* @__PURE__ */ __name((context, eventName, status, data = {}) => {
+    __publicField(this, "addAgentEvent", /* @__PURE__ */ __name((context, eventName, status, data = {}) => {
       const otelSpan = context.otelSpan;
       if (otelSpan) {
         endOperationSpan({
@@ -5094,7 +5218,7 @@ var Agent = class {
         "agent",
         context
       );
-    }, "addAgentEvent");
+    }, "addAgentEvent"));
     var _a, _b, _c;
     this.id = options.id || options.name;
     this.name = options.name;
@@ -6644,6 +6768,29 @@ var BaseRetriever = class {
    * @param options - Configuration options for the retriever.
    */
   constructor(options = {}) {
+    /**
+     * Options that configure the retriever's behavior
+     */
+    __publicField(this, "options");
+    /**
+     * Ready-to-use tool property for direct destructuring
+     * This can be used with object destructuring syntax
+     *
+     * @example
+     * ```typescript
+     * // ✅ You can use destructuring with the tool property
+     * const { tool } = new SimpleRetriever();
+     *
+     * // And use it directly in an agent
+     * const agent = new Agent({
+     *   name: "RAG Agent",
+     *   model: "gpt-4",
+     *   provider,
+     *   tools: [tool],
+     * });
+     * ```
+     */
+    __publicField(this, "tool");
     this.options = __spreadValues({}, options);
     const toolParams = {
       name: this.options.toolName || "search_knowledge",
@@ -6677,11 +6824,30 @@ var MCPClient = class extends import_node_events.EventEmitter {
   constructor(config) {
     var _a;
     super();
+    /**
+     * Underlying MCP client instance from the SDK.
+     */
+    __publicField(this, "client");
+    // Renamed back from sdkClient
+    /**
+     * Communication channel (transport layer) for MCP interactions.
+     */
+    __publicField(this, "transport");
     // Renamed back from communicationChannel
     /**
      * Tracks the connection status to the server.
      */
-    this.connected = false;
+    __publicField(this, "connected", false);
+    // Renamed back from isConnected
+    /**
+     * Maximum time allowed for requests in milliseconds.
+     */
+    __publicField(this, "timeout");
+    // Renamed back from requestTimeoutMs
+    /**
+     * Information identifying this client to the server.
+     */
+    __publicField(this, "clientInfo");
     this.clientInfo = config.clientInfo;
     this.client = new import_client2.Client(this.clientInfo, {
       capabilities: config.capabilities || {}
@@ -6941,10 +7107,14 @@ var MCPConfiguration = class {
    * @param options Configuration options including server definitions.
    */
   constructor(options) {
+    /**
+     * Map of server configurations keyed by server names.
+     */
+    __publicField(this, "serverConfigs");
     /**
      * Map of connected MCP clients keyed by server names (local cache).
      */
-    this.mcpClientsById = /* @__PURE__ */ new Map();
+    __publicField(this, "mcpClientsById", /* @__PURE__ */ new Map());
     this.serverConfigs = options.servers;
   }
   /**
@@ -7192,6 +7362,8 @@ __name(MCPConfiguration, "MCPConfiguration");
 // src/telemetry/client/index.ts
 var TelemetryServiceApiClient = class {
   constructor(options) {
+    __publicField(this, "options");
+    __publicField(this, "fetchImplementation");
     this.options = options;
     this.fetchImplementation = options.fetch || globalThis.fetch;
     if (!this.fetchImplementation) {
@@ -7283,6 +7455,8 @@ __name(TelemetryServiceApiClient, "TelemetryServiceApiClient");
 // src/telemetry/exporter/index.ts
 var VoltAgentExporter = class {
   constructor(options) {
+    __publicField(this, "apiClient");
+    __publicField(this, "publicKey");
     let baseUrl = options.baseUrl;
     if (baseUrl.includes("https://server.voltagent.dev")) {
       baseUrl = `${baseUrl}/functions/v1`;
@@ -7366,7 +7540,8 @@ var isTelemetryInitializedByVoltAgent = false;
 var registeredProvider = null;
 var VoltAgent = class {
   constructor(options) {
-    this.serverStarted = false;
+    __publicField(this, "registry");
+    __publicField(this, "serverStarted", false);
     this.registry = AgentRegistry.getInstance();
     this.registerAgents(options.agents);
     if (options.telemetryExporter) {