@dexto/core 1.2.4 → 1.2.5

package/README.md

@@ -108,6 +108,48 @@ const result = await manager.executeTool('readFile', { path: './README.md' });
 await manager.disconnectAll();
 ```
 
+### Agent-to-Agent Delegation
+
+Delegate tasks to other A2A-compliant agents using the built-in `delegate_to_url` tool.
+
+```typescript
+const agent = new DextoAgent({
+  llm: { /* ... */ },
+  internalTools: ['delegate_to_url'] // Enable delegation tool
+});
+await agent.start();
+
+// Delegate via natural language
+await agent.run(`
+  Please delegate this task to the PDF analyzer agent at http://localhost:3001:
+  "Extract all tables from the Q4 sales report"
+`);
+
+// Or call the tool directly
+const tools = await agent.getAllTools();
+const delegateTool = tools.find(t => t.name === 'internal--delegate_to_url');
+// The tool is prefixed with 'internal--' by the ToolManager
+```
+
+**Configuration (YAML):**
+```yaml
+internalTools:
+  - delegate_to_url
+```
+
+**What it provides:**
+- Point-to-point delegation when you know the agent URL
+- A2A Protocol v0.3.0 compliant (JSON-RPC transport)
+- Session management for stateful multi-turn conversations
+- Automatic endpoint discovery (/v1/jsonrpc, /jsonrpc)
+- Timeout handling and error recovery
+
+**Use cases:**
+- Multi-agent systems with known agent URLs
+- Delegation to specialized agents
+- Building agent workflows and pipelines
+- Testing agent-to-agent communication
+
 ### Telemetry
 
 Built-in OpenTelemetry distributed tracing for observability.
@@ -128,6 +170,24 @@ const agent = new DextoAgent({
 
 Automatically traces agent operations, LLM calls with token usage, and tool executions. See `src/telemetry/README.md` for details.
 
+### Logger
+
+Multi-transport logging system (v2) with console, file, and remote transports. Configure in agent YAML:
+
+```yaml
+logger:
+  level: info  # error | warn | info | debug | silly
+  transports:
+    - type: console
+      colorize: true
+    - type: file
+      path: ./logs/agent.log
+      maxSize: 10485760
+      maxFiles: 5
+```
+
+CLI automatically adds per-agent file transport at `~/.dexto/logs/<agent-id>.log`. See architecture in `src/logger/v2/`.
+
 See the DextoAgent API reference for all methods:
 https://docs.dexto.ai/api/dexto-agent/