Update docs and changelog

CHANGELOG.md

@@ -1,3 +1,20 @@
+# 1.4.0 (2025-06-06)
+
+### Features
+
+- add plugin system with dynamic loading
+- add Redis-backed message bus
+- add multi-flow runner via `runAgentFlows`
+- add CLI `inspect` command
+- add HttpNode for HTTP requests
+
+### Bug Fixes
+
+- fix HttpNode typing for typedoc
+- fix context type declarations
+
+---
+
 # 1.0.0 (2025-04-19)
 
 ### Bug Fixes

README.md

@@ -220,6 +220,20 @@ const decideNode = new DecisionNode('decide', async (context) => {
 });
 ```
 
+### HttpNode
+
+`HttpNode` performs HTTP requests during a flow. Provide the request `url`,
+optional `method`, headers and body. Values can be static or derived from the
+current context.
+
+```typescript
+import { HttpNode } from 'ai-agent-flow/nodes/http';
+
+const fetchData = new HttpNode('fetch-data', {
+  url: 'https://api.example.com/data',
+});
+```
+
 ### MessageBus
 
 The `MessageBus` enables event-driven communication between agents. It allows agents to send and subscribe to messages asynchronously.

docs/examples.md

@@ -102,6 +102,32 @@ flowchart TD
 
 ---
 
+## 🌐 4. HTTP Request Example
+
+**File:** `examples/http-request.ts`
+
+Fetches data from a REST API using `HttpNode`.
+
+### 🧱 Flow Structure:
+
+```mermaid
+flowchart TD
+  HTTP[HttpNode: fetch data] --> DONE[Flow completed]
+```
+
+### 💡 What it does:
+
+- Sends a GET request to a JSON placeholder API
+- Parses the JSON response
+- Prints the result to the console
+
+### ✨ Key Features:
+
+- Shows how to call external APIs within a flow
+- Supports dynamic URL and headers from context
+
+---
+
 ## 🛠 Tips for Customization
 
 You can modify any example to: