agent-pulse 1.2.0 → 1.3.0

package/README.md

@@ -154,7 +154,8 @@ The `response` event and the `agent.run()` promise resolve to a standardized `Ag
 
 ```typescript
 {
-    content: string | object, // The Markdown text or parsed JSON
+    content: string | object, // The Markdown text, parsed JSON, or tool result (if iterations=1)
+    message?: string,          // The original LLM text response (useful when a tool is also called)
     usage: {
         input_tokens: number,
         output_tokens: number,
@@ -167,6 +168,9 @@ The `response` event and the `agent.run()` promise resolve to a standardized `Ag
 }
 ```
 
+> [!NOTE]
+> If an LLM responds with both text and a tool call (common in Gemini), `content` stays consistent with legacy behavior (holding the tool result), while the new `message` field preserves the original LLM text.
+
 You can access token usage stats from the `usage` property.
 
 ## Error Codes
@@ -226,7 +230,18 @@ if (result.content?.type === 'INTENT_COMPLETE') {
 }
 ```
 
-#### Option B: Events (Side Effects)
+#### Option B: Handling Text + Tool (Gemini Style)
+When using models like Gemini that often provide a text explanation *and* a tool call in one turn, use the `message` field to access the text.
+
+```typescript
+const result = await agent.run("Tell me a joke and then get the weather.");
+
+// If weatherTool was called:
+console.log(result.message); // "Sure! Here's a joke: ... Now, let me get the weather for you."
+console.log(result.content); // { temp: 20, unit: 'celsius' } (The tool result)
+```
+
+#### Option C: Events (Side Effects)
 Best for logging, UI updates, or real-time monitoring.
 
 ```typescript

package/dist/agent.js

@@ -39,6 +39,10 @@ class Agent extends events_1.EventEmitter {
                 iterations++;
                 const response = await this.provider.generate(this.config.system, messages, this.config.files, this.config.tools, this.config.config, this.config.output_schema, (token) => this.emit('token', token));
                 lastResponse = response;
+                // Capture the original text as the "message" (LLM's primary text response)
+                if (typeof response.content === 'string') {
+                    lastResponse.message = response.content;
+                }
                 // Handle Tool Execution
                 if (response.tool_calls && this.config.tools) {
                     // Add Assistant's tool call message to history

package/dist/types.d.ts

@@ -29,6 +29,7 @@ export interface AgentTool {
 export interface AgentResponse {
     content: string | object;
     tool_calls?: any[];
+    message?: string;
     usage: {
         input_tokens: number;
         output_tokens: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agent-pulse",
-    "version": "1.2.0",
+    "version": "1.3.0",
     "description": "A lightweight, agentic AI framework for JavaScript/TypeScript",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",