agentic-flow 1.6.2 β 1.6.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -38,7 +38,6 @@ Most AI coding agents are **painfully slow** and **frustratingly forgetful**. Th
|
|
|
38
38
|
- **After learning**: 90%+ success, **46% faster execution**
|
|
39
39
|
- **Manual intervention**: Required every time β **Zero needed**
|
|
40
40
|
- **Improvement**: Gets smarter with every task
|
|
41
|
-
- **Storage**: Node.js (SQLite, persistent) or WASM (IndexedDB/Memory)
|
|
42
41
|
|
|
43
42
|
### π° Combined Impact on Real Workflows
|
|
44
43
|
|
|
@@ -53,30 +52,27 @@ Most AI coding agents are **painfully slow** and **frustratingly forgetful**. Th
|
|
|
53
52
|
|
|
54
53
|
| Component | Description | Performance | Documentation |
|
|
55
54
|
|-----------|-------------|-------------|---------------|
|
|
56
|
-
| **Agent Booster** | Ultra-fast local code transformations via Rust/WASM | 352x faster, $0 cost | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agent-booster) |
|
|
57
|
-
| **ReasoningBank** | Persistent learning memory with
|
|
55
|
+
| **Agent Booster** | Ultra-fast local code transformations via Rust/WASM (auto-detects edits) | 352x faster, $0 cost | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agent-booster) |
|
|
56
|
+
| **ReasoningBank** | Persistent learning memory system with semantic search | 46% faster, 100% success | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/src/reasoningbank) |
|
|
58
57
|
| **Multi-Model Router** | Intelligent cost optimization across 100+ LLMs | 85-99% cost savings | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/src/router) |
|
|
58
|
+
| **QUIC Transport** | Ultra-low latency agent communication via Rust/WASM QUIC protocol | 50-70% faster than TCP, 0-RTT | [Docs](https://github.com/ruvnet/agentic-flow/tree/main/crates/agentic-flow-quic) |
|
|
59
59
|
|
|
60
|
-
**
|
|
61
|
-
**
|
|
60
|
+
**CLI Usage**: Multi-Model Router via `--optimize`, Agent Booster (automatic), ReasoningBank (API only), QUIC Transport (API only)
|
|
61
|
+
**Programmatic**: All components importable: `agentic-flow/router`, `agentic-flow/reasoningbank`, `agentic-flow/agent-booster`, `agentic-flow/transport/quic`
|
|
62
62
|
|
|
63
63
|
**Get Started:**
|
|
64
64
|
```bash
|
|
65
|
-
# CLI
|
|
65
|
+
# CLI: Auto-optimization (Agent Booster runs automatically on code edits)
|
|
66
66
|
npx agentic-flow --agent coder --task "Build a REST API" --optimize
|
|
67
67
|
|
|
68
|
-
# Programmatic
|
|
69
|
-
npm install agentic-flow
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
```javascript
|
|
73
|
-
// Import any component
|
|
68
|
+
# Programmatic: Import any component
|
|
74
69
|
import { ModelRouter } from 'agentic-flow/router';
|
|
75
70
|
import * as reasoningbank from 'agentic-flow/reasoningbank';
|
|
76
71
|
import { AgentBooster } from 'agentic-flow/agent-booster';
|
|
72
|
+
import { QuicTransport } from 'agentic-flow/transport/quic';
|
|
77
73
|
```
|
|
78
74
|
|
|
79
|
-
Built on **[Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk)
|
|
75
|
+
Built on **[Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk)** by Anthropic, powered by **[Claude Flow](https://github.com/ruvnet/claude-flow)** (101 MCP tools), **[Flow Nexus](https://github.com/ruvnet/flow-nexus)** (96 cloud tools), **[OpenRouter](https://openrouter.ai)** (100+ LLM models), **[Google Gemini](https://ai.google.dev)** (fast, cost-effective inference), **[Agentic Payments](https://github.com/ruvnet/agentic-flow/tree/main/agentic-payments)** (payment authorization), and **[ONNX Runtime](https://onnxruntime.ai)** (free local CPU or GPU inference).
|
|
80
76
|
|
|
81
77
|
---
|
|
82
78
|
|
|
@@ -236,45 +232,154 @@ npx agentic-flow --agent coder --task "Code cleanup" --optimize --max-cost 0.001
|
|
|
236
232
|
|
|
237
233
|
---
|
|
238
234
|
|
|
239
|
-
## π Commands
|
|
235
|
+
## π CLI Commands
|
|
236
|
+
|
|
237
|
+
```bash
|
|
238
|
+
# Agent execution with auto-optimization
|
|
239
|
+
npx agentic-flow --agent coder --task "Build REST API" --optimize
|
|
240
|
+
npx agentic-flow --agent coder --task "Fix bug" --provider openrouter --priority cost
|
|
241
|
+
|
|
242
|
+
# MCP server management (7 tools built-in)
|
|
243
|
+
npx agentic-flow mcp start # Start MCP server
|
|
244
|
+
npx agentic-flow mcp list # List 7 agentic-flow tools
|
|
245
|
+
npx agentic-flow mcp status # Check server status
|
|
246
|
+
|
|
247
|
+
# Agent management
|
|
248
|
+
npx agentic-flow --list # List all 79 agents
|
|
249
|
+
npx agentic-flow agent info coder # Get agent details
|
|
250
|
+
npx agentic-flow agent create # Create custom agent
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
**Built-in MCP Tools** (7): agent execution, list agents, create agent, agent info, conflicts check, model optimizer, list all agents
|
|
254
|
+
**External MCP Servers**: claude-flow (101 tools), flow-nexus (96 tools), agentic-payments (10 tools)
|
|
255
|
+
|
|
256
|
+
---
|
|
257
|
+
|
|
258
|
+
## β‘ QUIC Transport (Ultra-Low Latency)
|
|
259
|
+
|
|
260
|
+
**NEW in v1.6.0**: QUIC protocol support for ultra-fast agent communication, embedding agentic intelligence in the fabric of the internet.
|
|
261
|
+
|
|
262
|
+
### Why QUIC?
|
|
263
|
+
|
|
264
|
+
QUIC (Quick UDP Internet Connections) is a UDP-based transport protocol offering **50-70% faster connections** than traditional TCP, perfect for high-frequency agent coordination and real-time swarm communication. By leveraging QUIC's native internet-layer capabilities, agentic-flow embeds AI agent intelligence directly into the infrastructure of the web, enabling seamless, ultra-low latency coordination at internet scale.
|
|
265
|
+
|
|
266
|
+
### Performance Benefits
|
|
240
267
|
|
|
241
|
-
|
|
268
|
+
| Feature | TCP/HTTP2 | QUIC | Improvement |
|
|
269
|
+
|---------|-----------|------|-------------|
|
|
270
|
+
| **Connection Setup** | 3 round trips | 0-RTT (instant) | **Instant reconnection** |
|
|
271
|
+
| **Latency** | Baseline | 50-70% lower | **2x faster** |
|
|
272
|
+
| **Concurrent Streams** | Head-of-line blocking | True multiplexing | **100+ streams** |
|
|
273
|
+
| **Network Changes** | Connection drop | Migration support | **Survives WiFiβcellular** |
|
|
274
|
+
| **Security** | Optional TLS | Built-in TLS 1.3 | **Always encrypted** |
|
|
275
|
+
|
|
276
|
+
### CLI Usage
|
|
242
277
|
|
|
243
278
|
```bash
|
|
244
|
-
# Start
|
|
245
|
-
npx agentic-flow
|
|
279
|
+
# Start QUIC server (default port 4433)
|
|
280
|
+
npx agentic-flow quic
|
|
281
|
+
|
|
282
|
+
# Custom configuration
|
|
283
|
+
npx agentic-flow quic --port 5000 --cert ./certs/cert.pem --key ./certs/key.pem
|
|
284
|
+
|
|
285
|
+
# Using environment variables
|
|
286
|
+
export QUIC_PORT=4433
|
|
287
|
+
export QUIC_CERT_PATH=./certs/cert.pem
|
|
288
|
+
export QUIC_KEY_PATH=./certs/key.pem
|
|
289
|
+
npx agentic-flow quic
|
|
290
|
+
|
|
291
|
+
# View QUIC options
|
|
292
|
+
npx agentic-flow quic --help
|
|
293
|
+
```
|
|
246
294
|
|
|
247
|
-
|
|
248
|
-
npx agentic-flow mcp list
|
|
295
|
+
### Programmatic API
|
|
249
296
|
|
|
250
|
-
|
|
251
|
-
|
|
297
|
+
```javascript
|
|
298
|
+
import { QuicTransport } from 'agentic-flow/transport/quic';
|
|
299
|
+
import { getQuicConfig } from 'agentic-flow/dist/config/quic.js';
|
|
300
|
+
|
|
301
|
+
// Create QUIC transport
|
|
302
|
+
const transport = new QuicTransport({
|
|
303
|
+
host: 'localhost',
|
|
304
|
+
port: 4433,
|
|
305
|
+
maxConcurrentStreams: 100 // 100+ parallel agent messages
|
|
306
|
+
});
|
|
307
|
+
|
|
308
|
+
// Connect to QUIC server
|
|
309
|
+
await transport.connect();
|
|
310
|
+
|
|
311
|
+
// Send agent tasks with minimal latency
|
|
312
|
+
await transport.send({
|
|
313
|
+
type: 'task',
|
|
314
|
+
agent: 'coder',
|
|
315
|
+
data: { action: 'refactor', files: [...] }
|
|
316
|
+
});
|
|
317
|
+
|
|
318
|
+
// Get connection stats
|
|
319
|
+
const stats = transport.getStats();
|
|
320
|
+
console.log(`RTT: ${stats.rttMs}ms, Active streams: ${stats.activeStreams}`);
|
|
321
|
+
|
|
322
|
+
// Graceful shutdown
|
|
323
|
+
await transport.close();
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
### Use Cases
|
|
327
|
+
|
|
328
|
+
**Perfect for:**
|
|
329
|
+
- π **Multi-agent swarm coordination** (mesh/hierarchical topologies)
|
|
330
|
+
- β‘ **High-frequency task distribution** across worker agents
|
|
331
|
+
- π **Real-time state synchronization** between agents
|
|
332
|
+
- π **Low-latency RPC** for distributed agent systems
|
|
333
|
+
- π **Live agent orchestration** with instant feedback
|
|
334
|
+
|
|
335
|
+
**Real-World Example:**
|
|
336
|
+
```javascript
|
|
337
|
+
// Coordinate 10 agents processing 1000 files
|
|
338
|
+
const swarm = await createSwarm({ topology: 'mesh', transport: 'quic' });
|
|
339
|
+
|
|
340
|
+
// QUIC enables instant task distribution
|
|
341
|
+
for (const file of files) {
|
|
342
|
+
// 0-RTT: No connection overhead between tasks
|
|
343
|
+
await swarm.assignTask({ type: 'analyze', file });
|
|
344
|
+
}
|
|
252
345
|
|
|
253
|
-
|
|
254
|
-
npx agentic-flow mcp add weather '{"command":"npx","args":["-y","weather-mcp"]}'
|
|
346
|
+
// Result: 50-70% faster than TCP-based coordination
|
|
255
347
|
```
|
|
256
348
|
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
349
|
+
### Environment Variables
|
|
350
|
+
|
|
351
|
+
| Variable | Description | Default |
|
|
352
|
+
|----------|-------------|---------|
|
|
353
|
+
| `QUIC_PORT` | Server port | 4433 |
|
|
354
|
+
| `QUIC_CERT_PATH` | TLS certificate path | `./certs/cert.pem` |
|
|
355
|
+
| `QUIC_KEY_PATH` | TLS private key path | `./certs/key.pem` |
|
|
356
|
+
|
|
357
|
+
### Technical Details
|
|
358
|
+
|
|
359
|
+
- **Protocol**: QUIC (RFC 9000) via Rust/WASM
|
|
360
|
+
- **Transport**: UDP-based with built-in congestion control
|
|
361
|
+
- **Security**: TLS 1.3 encryption (always on)
|
|
362
|
+
- **Multiplexing**: Stream-level flow control (no head-of-line blocking)
|
|
363
|
+
- **Connection Migration**: Survives IP address changes
|
|
364
|
+
- **WASM Size**: 130 KB (optimized Rust binary)
|
|
365
|
+
|
|
366
|
+
**Learn More:** [QUIC Documentation](https://github.com/ruvnet/agentic-flow/tree/main/crates/agentic-flow-quic)
|
|
262
367
|
|
|
263
368
|
---
|
|
264
369
|
|
|
265
370
|
## ποΈ Programmatic API
|
|
266
371
|
|
|
267
|
-
### Multi-Model Router
|
|
372
|
+
### Multi-Model Router
|
|
268
373
|
|
|
269
374
|
```javascript
|
|
270
375
|
import { ModelRouter } from 'agentic-flow/router';
|
|
271
376
|
|
|
272
377
|
const router = new ModelRouter();
|
|
273
378
|
const response = await router.chat({
|
|
274
|
-
model: 'auto', priority: 'cost', // Auto-select cheapest
|
|
379
|
+
model: 'auto', priority: 'cost', // Auto-select cheapest model
|
|
275
380
|
messages: [{ role: 'user', content: 'Your prompt' }]
|
|
276
381
|
});
|
|
277
|
-
console.log(`
|
|
382
|
+
console.log(`Cost: $${response.metadata.cost}, Model: ${response.metadata.model}`);
|
|
278
383
|
```
|
|
279
384
|
|
|
280
385
|
### ReasoningBank (Learning Memory)
|
|
@@ -283,25 +388,16 @@ console.log(`Used: ${response.metadata.model}, Cost: $${response.metadata.cost}`
|
|
|
283
388
|
import * as reasoningbank from 'agentic-flow/reasoningbank';
|
|
284
389
|
|
|
285
390
|
await reasoningbank.initialize();
|
|
286
|
-
await reasoningbank.storeMemory('
|
|
287
|
-
const results = await reasoningbank.queryMemories('search', {
|
|
288
|
-
const status = await reasoningbank.getStatus();
|
|
391
|
+
await reasoningbank.storeMemory('pattern_name', 'pattern_value', { namespace: 'api' });
|
|
392
|
+
const results = await reasoningbank.queryMemories('search query', { namespace: 'api' });
|
|
289
393
|
```
|
|
290
394
|
|
|
291
|
-
### Agent Booster (
|
|
395
|
+
### Agent Booster (Auto-Optimizes Code Edits)
|
|
292
396
|
|
|
293
|
-
|
|
294
|
-
import { AgentBooster } from 'agentic-flow/agent-booster'
|
|
295
|
-
|
|
296
|
-
const booster = new AgentBooster();
|
|
297
|
-
await booster.editFile({
|
|
298
|
-
target_filepath: 'src/app.js',
|
|
299
|
-
instructions: 'Add error handling',
|
|
300
|
-
code_edit: '/* your code here */'
|
|
301
|
-
});
|
|
302
|
-
```
|
|
397
|
+
**Automatic**: Detects code editing tasks and applies 352x speedup with $0 cost
|
|
398
|
+
**Manual**: `import { AgentBooster } from 'agentic-flow/agent-booster'` for direct control
|
|
303
399
|
|
|
304
|
-
**Providers**: Anthropic, OpenRouter (100+ models), Gemini, ONNX (local)
|
|
400
|
+
**Providers**: Anthropic (Claude), OpenRouter (100+ models), Gemini (fast), ONNX (free local)
|
|
305
401
|
|
|
306
402
|
---
|
|
307
403
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentic-flow",
|
|
3
|
-
"version": "1.6.
|
|
3
|
+
"version": "1.6.3",
|
|
4
4
|
"description": "Production-ready AI agent orchestration platform with 66 specialized agents, 213 MCP tools, ReasoningBank learning memory, and autonomous multi-agent swarms. Built by @ruvnet with Claude Agent SDK, neural networks, memory persistence, GitHub integration, and distributed consensus protocols.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -258,7 +258,7 @@ export function log(message) {
|
|
|
258
258
|
wasm.log(ptr0, len0);
|
|
259
259
|
}
|
|
260
260
|
|
|
261
|
-
function
|
|
261
|
+
function __wbg_adapter_4(arg0, arg1, arg2) {
|
|
262
262
|
wasm.__wbindgen_export_5(arg0, arg1, addHeapObject(arg2));
|
|
263
263
|
}
|
|
264
264
|
|
|
@@ -540,7 +540,7 @@ export function __wbindgen_cast_2241b6af4c4b2941(arg0, arg1) {
|
|
|
540
540
|
|
|
541
541
|
export function __wbindgen_cast_8eb6fd44e7238d11(arg0, arg1) {
|
|
542
542
|
// Cast intrinsic for `Closure(Closure { dtor_idx: 62, function: Function { arguments: [Externref], shim_idx: 63, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
|
|
543
|
-
const ret = makeMutClosure(arg0, arg1, 62,
|
|
543
|
+
const ret = makeMutClosure(arg0, arg1, 62, __wbg_adapter_4);
|
|
544
544
|
return addHeapObject(ret);
|
|
545
545
|
};
|
|
546
546
|
|
|
Binary file
|