agentic-flow 1.9.4 → 1.10.1
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/CHANGELOG.md +246 -0
- package/dist/proxy/adaptive-proxy.js +224 -0
- package/dist/proxy/anthropic-to-gemini.js +2 -2
- package/dist/proxy/http2-proxy-optimized.js +191 -0
- package/dist/proxy/http2-proxy.js +381 -0
- package/dist/proxy/http3-proxy-old.js +331 -0
- package/dist/proxy/http3-proxy.js +51 -0
- package/dist/proxy/websocket-proxy.js +406 -0
- package/dist/utils/adaptive-pool-sizing.js +414 -0
- package/dist/utils/auth.js +52 -0
- package/dist/utils/circular-rate-limiter.js +391 -0
- package/dist/utils/compression-middleware.js +149 -0
- package/dist/utils/connection-pool.js +184 -0
- package/dist/utils/dynamic-compression.js +298 -0
- package/dist/utils/http2-multiplexing.js +319 -0
- package/dist/utils/lazy-auth.js +311 -0
- package/dist/utils/rate-limiter.js +48 -0
- package/dist/utils/response-cache.js +211 -0
- package/dist/utils/server-push.js +251 -0
- package/dist/utils/streaming-optimizer.js +141 -0
- package/dist/utils/zero-copy-buffer.js +286 -0
- package/docs/.claude-flow/metrics/performance.json +3 -3
- package/docs/.claude-flow/metrics/task-metrics.json +3 -3
- package/docs/DOCKER-VERIFICATION.md +207 -0
- package/docs/ISSUE-55-VALIDATION.md +171 -0
- package/docs/NPX_AGENTDB_SETUP.md +175 -0
- package/docs/OPTIMIZATIONS.md +460 -0
- package/docs/PHASE2-IMPLEMENTATION-SUMMARY.md +275 -0
- package/docs/PHASE2-PHASE3-COMPLETE-SUMMARY.md +453 -0
- package/docs/PHASE3-IMPLEMENTATION-SUMMARY.md +357 -0
- package/docs/PUBLISH_GUIDE.md +438 -0
- package/docs/README.md +217 -0
- package/docs/RELEASE-v1.10.0-COMPLETE.md +382 -0
- package/docs/archive/.agentdb-instructions.md +66 -0
- package/docs/archive/AGENT-BOOSTER-STATUS.md +292 -0
- package/docs/archive/CHANGELOG-v1.3.0.md +120 -0
- package/docs/archive/COMPLETION_REPORT_v1.7.1.md +335 -0
- package/docs/archive/IMPLEMENTATION_SUMMARY_v1.7.1.md +241 -0
- package/docs/archive/SUPABASE-INTEGRATION-COMPLETE.md +357 -0
- package/docs/archive/TESTING_QUICK_START.md +223 -0
- package/docs/archive/TOOL-EMULATION-INTEGRATION-ISSUE.md +669 -0
- package/docs/archive/VALIDATION_v1.7.1.md +234 -0
- package/docs/issues/ISSUE-xenova-transformers-dependency.md +380 -0
- package/docs/releases/PUBLISH_CHECKLIST_v1.10.0.md +396 -0
- package/docs/releases/PUBLISH_SUMMARY_v1.7.1.md +198 -0
- package/docs/releases/RELEASE_NOTES_v1.10.0.md +464 -0
- package/docs/releases/RELEASE_NOTES_v1.7.0.md +297 -0
- package/docs/releases/RELEASE_v1.7.1.md +327 -0
- package/package.json +1 -1
- package/scripts/claude +31 -0
- package/validation/docker-npm-validation.sh +170 -0
- package/validation/simple-npm-validation.sh +131 -0
- package/validation/test-gemini-exclusiveMinimum-fix.ts +142 -0
- package/validation/test-gemini-models.ts +200 -0
- package/validation/validate-v1.10.0-docker.sh +296 -0
- package/wasm/reasoningbank/reasoningbank_wasm_bg.js +2 -2
- package/wasm/reasoningbank/reasoningbank_wasm_bg.wasm +0 -0
- package/docs/INDEX.md +0 -279
- package/docs/guides/.claude-flow/metrics/agent-metrics.json +0 -1
- package/docs/guides/.claude-flow/metrics/performance.json +0 -9
- package/docs/guides/.claude-flow/metrics/task-metrics.json +0 -10
- package/docs/router/.claude-flow/metrics/agent-metrics.json +0 -1
- package/docs/router/.claude-flow/metrics/performance.json +0 -9
- package/docs/router/.claude-flow/metrics/task-metrics.json +0 -10
- /package/docs/{TEST-V1.7.8.Dockerfile → docker-tests/TEST-V1.7.8.Dockerfile} +0 -0
- /package/docs/{TEST-V1.7.9-NODE20.Dockerfile → docker-tests/TEST-V1.7.9-NODE20.Dockerfile} +0 -0
- /package/docs/{TEST-V1.7.9.Dockerfile → docker-tests/TEST-V1.7.9.Dockerfile} +0 -0
- /package/docs/{v1.7.1-QUICK-START.md → guides/QUICK-START-v1.7.1.md} +0 -0
- /package/docs/{INTEGRATION-COMPLETE.md → integration-docs/INTEGRATION-COMPLETE.md} +0 -0
- /package/docs/{LANDING-PAGE-PROVIDER-CONTENT.md → providers/LANDING-PAGE-PROVIDER-CONTENT.md} +0 -0
- /package/docs/{PROVIDER-FALLBACK-GUIDE.md → providers/PROVIDER-FALLBACK-GUIDE.md} +0 -0
- /package/docs/{PROVIDER-FALLBACK-SUMMARY.md → providers/PROVIDER-FALLBACK-SUMMARY.md} +0 -0
- /package/docs/{QUIC_FINAL_STATUS.md → quic/QUIC_FINAL_STATUS.md} +0 -0
- /package/docs/{README_QUIC_PHASE1.md → quic/README_QUIC_PHASE1.md} +0 -0
- /package/docs/{AGENTDB_TESTING.md → testing/AGENTDB_TESTING.md} +0 -0
|
@@ -0,0 +1,296 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# v1.10.0 Docker Validation Script
|
|
3
|
+
# Validates all multi-protocol proxy features in isolated environment
|
|
4
|
+
|
|
5
|
+
set -e
|
|
6
|
+
|
|
7
|
+
echo "🔍 v1.10.0 Multi-Protocol Proxy Validation"
|
|
8
|
+
echo "=========================================="
|
|
9
|
+
echo ""
|
|
10
|
+
|
|
11
|
+
# Colors
|
|
12
|
+
GREEN='\033[0;32m'
|
|
13
|
+
RED='\033[0;31m'
|
|
14
|
+
YELLOW='\033[1;33m'
|
|
15
|
+
NC='\033[0m' # No Color
|
|
16
|
+
|
|
17
|
+
# Configuration
|
|
18
|
+
DOCKER_IMAGE="agentic-flow-v1.10.0-test"
|
|
19
|
+
TEST_API_KEY="test-api-key-$(date +%s)"
|
|
20
|
+
|
|
21
|
+
# Cleanup function
|
|
22
|
+
cleanup() {
|
|
23
|
+
echo ""
|
|
24
|
+
echo "🧹 Cleaning up..."
|
|
25
|
+
docker ps -a | grep "$DOCKER_IMAGE" | awk '{print $1}' | xargs -r docker stop 2>/dev/null || true
|
|
26
|
+
docker ps -a | grep "$DOCKER_IMAGE" | awk '{print $1}' | xargs -r docker rm 2>/dev/null || true
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
trap cleanup EXIT
|
|
30
|
+
|
|
31
|
+
# Test results
|
|
32
|
+
TESTS_PASSED=0
|
|
33
|
+
TESTS_FAILED=0
|
|
34
|
+
|
|
35
|
+
test_result() {
|
|
36
|
+
local test_name=$1
|
|
37
|
+
local result=$2
|
|
38
|
+
|
|
39
|
+
if [ $result -eq 0 ]; then
|
|
40
|
+
echo -e "${GREEN}✅ PASS${NC}: $test_name"
|
|
41
|
+
((TESTS_PASSED++))
|
|
42
|
+
else
|
|
43
|
+
echo -e "${RED}❌ FAIL${NC}: $test_name"
|
|
44
|
+
((TESTS_FAILED++))
|
|
45
|
+
fi
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
# Step 1: Build Docker image
|
|
49
|
+
echo "📦 Step 1: Building Docker image..."
|
|
50
|
+
docker build -f Dockerfile.multi-protocol -t $DOCKER_IMAGE . > /dev/null 2>&1
|
|
51
|
+
test_result "Docker image build" $?
|
|
52
|
+
|
|
53
|
+
# Step 2: Test TypeScript compilation
|
|
54
|
+
echo ""
|
|
55
|
+
echo "🔧 Step 2: Validating TypeScript compilation..."
|
|
56
|
+
docker run --rm $DOCKER_IMAGE npm run build > /tmp/docker-build.log 2>&1
|
|
57
|
+
if grep -q "error TS" /tmp/docker-build.log; then
|
|
58
|
+
# Check if errors are only in unrelated files
|
|
59
|
+
if grep -q "error TS" /tmp/docker-build.log | grep -v "federation\|memory/Shared\|onnx-local\|supabase-adapter"; then
|
|
60
|
+
test_result "TypeScript compilation (proxy files)" 1
|
|
61
|
+
else
|
|
62
|
+
test_result "TypeScript compilation (proxy files)" 0
|
|
63
|
+
fi
|
|
64
|
+
else
|
|
65
|
+
test_result "TypeScript compilation" 0
|
|
66
|
+
fi
|
|
67
|
+
|
|
68
|
+
# Step 3: Test HTTP/1.1 Proxy
|
|
69
|
+
echo ""
|
|
70
|
+
echo "🌐 Step 3: Testing HTTP/1.1 Proxy..."
|
|
71
|
+
docker run -d --name ${DOCKER_IMAGE}-http1 \
|
|
72
|
+
-e GOOGLE_GEMINI_API_KEY=test-key \
|
|
73
|
+
-p 3000:3000 \
|
|
74
|
+
$DOCKER_IMAGE \
|
|
75
|
+
node dist/proxy/anthropic-to-gemini.js > /dev/null 2>&1
|
|
76
|
+
|
|
77
|
+
sleep 3
|
|
78
|
+
|
|
79
|
+
# Check if proxy started
|
|
80
|
+
if curl -s http://localhost:3000/health > /dev/null 2>&1; then
|
|
81
|
+
test_result "HTTP/1.1 Proxy startup" 0
|
|
82
|
+
else
|
|
83
|
+
test_result "HTTP/1.1 Proxy startup" 1
|
|
84
|
+
fi
|
|
85
|
+
|
|
86
|
+
docker stop ${DOCKER_IMAGE}-http1 > /dev/null 2>&1
|
|
87
|
+
docker rm ${DOCKER_IMAGE}-http1 > /dev/null 2>&1
|
|
88
|
+
|
|
89
|
+
# Step 4: Test HTTP/2 Proxy
|
|
90
|
+
echo ""
|
|
91
|
+
echo "🚀 Step 4: Testing HTTP/2 Proxy..."
|
|
92
|
+
docker run -d --name ${DOCKER_IMAGE}-http2 \
|
|
93
|
+
-e GOOGLE_GEMINI_API_KEY=test-key \
|
|
94
|
+
-e PROXY_API_KEYS=$TEST_API_KEY \
|
|
95
|
+
-p 3001:3001 \
|
|
96
|
+
$DOCKER_IMAGE \
|
|
97
|
+
node dist/proxy/http2-proxy.js > /dev/null 2>&1
|
|
98
|
+
|
|
99
|
+
sleep 3
|
|
100
|
+
|
|
101
|
+
# Check if proxy started
|
|
102
|
+
if docker logs ${DOCKER_IMAGE}-http2 2>&1 | grep -q "HTTP/2 Proxy running"; then
|
|
103
|
+
test_result "HTTP/2 Proxy startup" 0
|
|
104
|
+
else
|
|
105
|
+
test_result "HTTP/2 Proxy startup" 1
|
|
106
|
+
fi
|
|
107
|
+
|
|
108
|
+
# Check security features
|
|
109
|
+
if docker logs ${DOCKER_IMAGE}-http2 2>&1 | grep -q "Rate limiting enabled"; then
|
|
110
|
+
test_result "HTTP/2 Rate limiting configuration" 0
|
|
111
|
+
else
|
|
112
|
+
test_result "HTTP/2 Rate limiting configuration" 1
|
|
113
|
+
fi
|
|
114
|
+
|
|
115
|
+
docker stop ${DOCKER_IMAGE}-http2 > /dev/null 2>&1
|
|
116
|
+
docker rm ${DOCKER_IMAGE}-http2 > /dev/null 2>&1
|
|
117
|
+
|
|
118
|
+
# Step 5: Test Optimized HTTP/2 Proxy
|
|
119
|
+
echo ""
|
|
120
|
+
echo "⚡ Step 5: Testing Optimized HTTP/2 Proxy..."
|
|
121
|
+
docker run -d --name ${DOCKER_IMAGE}-optimized \
|
|
122
|
+
-e GOOGLE_GEMINI_API_KEY=test-key \
|
|
123
|
+
-e PROXY_API_KEYS=$TEST_API_KEY \
|
|
124
|
+
-p 3002:3001 \
|
|
125
|
+
$DOCKER_IMAGE \
|
|
126
|
+
node dist/proxy/http2-proxy-optimized.js > /dev/null 2>&1
|
|
127
|
+
|
|
128
|
+
sleep 3
|
|
129
|
+
|
|
130
|
+
# Check if optimizations are enabled
|
|
131
|
+
if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Connection pooling enabled"; then
|
|
132
|
+
test_result "Connection pooling enabled" 0
|
|
133
|
+
else
|
|
134
|
+
test_result "Connection pooling enabled" 1
|
|
135
|
+
fi
|
|
136
|
+
|
|
137
|
+
if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Response caching enabled"; then
|
|
138
|
+
test_result "Response caching enabled" 0
|
|
139
|
+
else
|
|
140
|
+
test_result "Response caching enabled" 1
|
|
141
|
+
fi
|
|
142
|
+
|
|
143
|
+
if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Streaming optimization enabled"; then
|
|
144
|
+
test_result "Streaming optimization enabled" 0
|
|
145
|
+
else
|
|
146
|
+
test_result "Streaming optimization enabled" 1
|
|
147
|
+
fi
|
|
148
|
+
|
|
149
|
+
if docker logs ${DOCKER_IMAGE}-optimized 2>&1 | grep -q "Compression enabled"; then
|
|
150
|
+
test_result "Compression enabled" 0
|
|
151
|
+
else
|
|
152
|
+
test_result "Compression enabled" 1
|
|
153
|
+
fi
|
|
154
|
+
|
|
155
|
+
docker stop ${DOCKER_IMAGE}-optimized > /dev/null 2>&1
|
|
156
|
+
docker rm ${DOCKER_IMAGE}-optimized > /dev/null 2>&1
|
|
157
|
+
|
|
158
|
+
# Step 6: Test WebSocket Proxy
|
|
159
|
+
echo ""
|
|
160
|
+
echo "🔌 Step 6: Testing WebSocket Proxy..."
|
|
161
|
+
docker run -d --name ${DOCKER_IMAGE}-ws \
|
|
162
|
+
-e GOOGLE_GEMINI_API_KEY=test-key \
|
|
163
|
+
-p 8080:8080 \
|
|
164
|
+
$DOCKER_IMAGE \
|
|
165
|
+
node dist/proxy/websocket-proxy.js > /dev/null 2>&1
|
|
166
|
+
|
|
167
|
+
sleep 3
|
|
168
|
+
|
|
169
|
+
if docker logs ${DOCKER_IMAGE}-ws 2>&1 | grep -q "WebSocket proxy running"; then
|
|
170
|
+
test_result "WebSocket Proxy startup" 0
|
|
171
|
+
else
|
|
172
|
+
test_result "WebSocket Proxy startup" 1
|
|
173
|
+
fi
|
|
174
|
+
|
|
175
|
+
# Check DoS protection
|
|
176
|
+
if docker logs ${DOCKER_IMAGE}-ws 2>&1 | grep -q "DoS protection"; then
|
|
177
|
+
test_result "WebSocket DoS protection" 0
|
|
178
|
+
else
|
|
179
|
+
test_result "WebSocket DoS protection" 1
|
|
180
|
+
fi
|
|
181
|
+
|
|
182
|
+
docker stop ${DOCKER_IMAGE}-ws > /dev/null 2>&1
|
|
183
|
+
docker rm ${DOCKER_IMAGE}-ws > /dev/null 2>&1
|
|
184
|
+
|
|
185
|
+
# Step 7: Test Adaptive Proxy
|
|
186
|
+
echo ""
|
|
187
|
+
echo "🎯 Step 7: Testing Adaptive Multi-Protocol Proxy..."
|
|
188
|
+
docker run -d --name ${DOCKER_IMAGE}-adaptive \
|
|
189
|
+
-e GOOGLE_GEMINI_API_KEY=test-key \
|
|
190
|
+
-p 3003:3000 \
|
|
191
|
+
$DOCKER_IMAGE \
|
|
192
|
+
node dist/proxy/adaptive-proxy.js > /dev/null 2>&1
|
|
193
|
+
|
|
194
|
+
sleep 3
|
|
195
|
+
|
|
196
|
+
if docker logs ${DOCKER_IMAGE}-adaptive 2>&1 | grep -q "Adaptive"; then
|
|
197
|
+
test_result "Adaptive Proxy startup" 0
|
|
198
|
+
else
|
|
199
|
+
test_result "Adaptive Proxy startup" 1
|
|
200
|
+
fi
|
|
201
|
+
|
|
202
|
+
docker stop ${DOCKER_IMAGE}-adaptive > /dev/null 2>&1
|
|
203
|
+
docker rm ${DOCKER_IMAGE}-adaptive > /dev/null 2>&1
|
|
204
|
+
|
|
205
|
+
# Step 8: Test Utility Files
|
|
206
|
+
echo ""
|
|
207
|
+
echo "🛠️ Step 8: Testing Utility Files..."
|
|
208
|
+
|
|
209
|
+
# Check if utility files were built
|
|
210
|
+
docker run --rm $DOCKER_IMAGE ls dist/utils/ > /tmp/utils-files.txt 2>&1
|
|
211
|
+
|
|
212
|
+
if grep -q "connection-pool.js" /tmp/utils-files.txt; then
|
|
213
|
+
test_result "Connection pool utility compiled" 0
|
|
214
|
+
else
|
|
215
|
+
test_result "Connection pool utility compiled" 1
|
|
216
|
+
fi
|
|
217
|
+
|
|
218
|
+
if grep -q "response-cache.js" /tmp/utils-files.txt; then
|
|
219
|
+
test_result "Response cache utility compiled" 0
|
|
220
|
+
else
|
|
221
|
+
test_result "Response cache utility compiled" 1
|
|
222
|
+
fi
|
|
223
|
+
|
|
224
|
+
if grep -q "streaming-optimizer.js" /tmp/utils-files.txt; then
|
|
225
|
+
test_result "Streaming optimizer utility compiled" 0
|
|
226
|
+
else
|
|
227
|
+
test_result "Streaming optimizer utility compiled" 1
|
|
228
|
+
fi
|
|
229
|
+
|
|
230
|
+
if grep -q "compression-middleware.js" /tmp/utils-files.txt; then
|
|
231
|
+
test_result "Compression middleware utility compiled" 0
|
|
232
|
+
else
|
|
233
|
+
test_result "Compression middleware utility compiled" 1
|
|
234
|
+
fi
|
|
235
|
+
|
|
236
|
+
if grep -q "rate-limiter.js" /tmp/utils-files.txt; then
|
|
237
|
+
test_result "Rate limiter utility compiled" 0
|
|
238
|
+
else
|
|
239
|
+
test_result "Rate limiter utility compiled" 1
|
|
240
|
+
fi
|
|
241
|
+
|
|
242
|
+
if grep -q "auth.js" /tmp/utils-files.txt; then
|
|
243
|
+
test_result "Auth utility compiled" 0
|
|
244
|
+
else
|
|
245
|
+
test_result "Auth utility compiled" 1
|
|
246
|
+
fi
|
|
247
|
+
|
|
248
|
+
# Step 9: Test Documentation
|
|
249
|
+
echo ""
|
|
250
|
+
echo "📚 Step 9: Validating Documentation..."
|
|
251
|
+
|
|
252
|
+
if [ -f "docs/OPTIMIZATIONS.md" ]; then
|
|
253
|
+
test_result "OPTIMIZATIONS.md exists" 0
|
|
254
|
+
else
|
|
255
|
+
test_result "OPTIMIZATIONS.md exists" 1
|
|
256
|
+
fi
|
|
257
|
+
|
|
258
|
+
if grep -q "Connection Pooling" docs/OPTIMIZATIONS.md 2>/dev/null; then
|
|
259
|
+
test_result "Documentation includes optimizations" 0
|
|
260
|
+
else
|
|
261
|
+
test_result "Documentation includes optimizations" 1
|
|
262
|
+
fi
|
|
263
|
+
|
|
264
|
+
# Step 10: Test CHANGELOG
|
|
265
|
+
echo ""
|
|
266
|
+
echo "📝 Step 10: Validating CHANGELOG..."
|
|
267
|
+
|
|
268
|
+
if grep -q "1.10.0" CHANGELOG.md; then
|
|
269
|
+
test_result "CHANGELOG includes v1.10.0" 0
|
|
270
|
+
else
|
|
271
|
+
test_result "CHANGELOG includes v1.10.0" 1
|
|
272
|
+
fi
|
|
273
|
+
|
|
274
|
+
if grep -q "Phase 1 Optimizations" CHANGELOG.md; then
|
|
275
|
+
test_result "CHANGELOG includes optimization details" 0
|
|
276
|
+
else
|
|
277
|
+
test_result "CHANGELOG includes optimization details" 1
|
|
278
|
+
fi
|
|
279
|
+
|
|
280
|
+
# Summary
|
|
281
|
+
echo ""
|
|
282
|
+
echo "=========================================="
|
|
283
|
+
echo "📊 VALIDATION SUMMARY"
|
|
284
|
+
echo "=========================================="
|
|
285
|
+
echo -e "Total Tests: $((TESTS_PASSED + TESTS_FAILED))"
|
|
286
|
+
echo -e "${GREEN}Passed: $TESTS_PASSED${NC}"
|
|
287
|
+
echo -e "${RED}Failed: $TESTS_FAILED${NC}"
|
|
288
|
+
echo ""
|
|
289
|
+
|
|
290
|
+
if [ $TESTS_FAILED -eq 0 ]; then
|
|
291
|
+
echo -e "${GREEN}✅ ALL TESTS PASSED - Ready for v1.10.0 release!${NC}"
|
|
292
|
+
exit 0
|
|
293
|
+
else
|
|
294
|
+
echo -e "${YELLOW}⚠️ Some tests failed - Review before publishing${NC}"
|
|
295
|
+
exit 1
|
|
296
|
+
fi
|
|
@@ -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
|
package/docs/INDEX.md
DELETED
|
@@ -1,279 +0,0 @@
|
|
|
1
|
-
# Agentic Flow Documentation Index
|
|
2
|
-
|
|
3
|
-
Complete documentation for the Agentic Flow multi-agent orchestration system.
|
|
4
|
-
|
|
5
|
-
## 📋 Quick Navigation
|
|
6
|
-
|
|
7
|
-
### 🚀 Start Here
|
|
8
|
-
- **[README](../README.md)** - Project overview and getting started
|
|
9
|
-
- **[CLAUDE.md](CLAUDE.md)** - Claude Code configuration and SPARC methodology
|
|
10
|
-
- **[PACKAGE_STRUCTURE.md](architecture/PACKAGE_STRUCTURE.md)** - Package organization and structure
|
|
11
|
-
- **[STANDALONE_PROXY_GUIDE.md](guides/STANDALONE_PROXY_GUIDE.md)** - Standalone proxy server setup
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
## 📚 Documentation Categories
|
|
16
|
-
|
|
17
|
-
### 📖 [User Guides](guides/)
|
|
18
|
-
Practical guides and tutorials for using the system.
|
|
19
|
-
|
|
20
|
-
- [Agent SDK Guide](guides/agent-sdk.md) - Building custom agents
|
|
21
|
-
- [Docker Agent Usage](guides/DOCKER_AGENT_USAGE.md) - Running agents in containers
|
|
22
|
-
- [Alternative LLM Models](guides/ALTERNATIVE_LLM_MODELS.md) - Using different language models
|
|
23
|
-
- [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md) - Real-world patterns
|
|
24
|
-
- [NPM Publishing Guide](guides/NPM-PUBLISH.md) - Package publishing
|
|
25
|
-
- [ONNX CLI Usage](guides/ONNX_CLI_USAGE.md) - ONNX command-line interface
|
|
26
|
-
- [ONNX Optimization Guide](guides/ONNX_OPTIMIZATION_GUIDE.md) - Performance optimization
|
|
27
|
-
- [OpenRouter Deployment](guides/OPENROUTER_DEPLOYMENT.md) - OpenRouter setup
|
|
28
|
-
|
|
29
|
-
### 🏗️ [Architecture](architecture/)
|
|
30
|
-
System design, planning, and technical architecture.
|
|
31
|
-
|
|
32
|
-
- [Executive Summary](architecture/EXECUTIVE_SUMMARY.md) - High-level overview
|
|
33
|
-
- [Integration Status](architecture/INTEGRATION-STATUS.md) - Current integration status
|
|
34
|
-
- [Research Summary](architecture/RESEARCH_SUMMARY.md) - Technical research findings
|
|
35
|
-
- [Multi-Model Router Plan](architecture/MULTI_MODEL_ROUTER_PLAN.md) - Router architecture
|
|
36
|
-
- [Improvement Plan](architecture/IMPROVEMENT_PLAN.md) - System improvement roadmap
|
|
37
|
-
- [Quick Wins](architecture/QUICK_WINS.md) - High-impact improvements
|
|
38
|
-
|
|
39
|
-
### 🔌 [Integrations](integrations/)
|
|
40
|
-
Integration guides for external services and frameworks.
|
|
41
|
-
|
|
42
|
-
- [Claude Agents Integration](integrations/CLAUDE_AGENTS_INTEGRATION.md) - Claude agents setup
|
|
43
|
-
- [Claude Flow Integration](integrations/CLAUDE_FLOW_INTEGRATION.md) - Claude Flow orchestration
|
|
44
|
-
- [Flow Nexus Integration](integrations/FLOW-NEXUS-INTEGRATION.md) - Cloud platform integration
|
|
45
|
-
- [FastMCP CLI Integration](integrations/FASTMCP_CLI_INTEGRATION.md) - MCP command-line tools
|
|
46
|
-
- [FastMCP Implementation Plan](integrations/fastmcp-implementation-plan.md) - Detailed MCP strategy
|
|
47
|
-
- [FastMCP POC Integration](integrations/fastmcp-poc-integration.md) - Proof of concept
|
|
48
|
-
|
|
49
|
-
### 🔧 [Router Documentation](router/)
|
|
50
|
-
Multi-model router configuration and usage.
|
|
51
|
-
|
|
52
|
-
- [Router Overview](router/README.md) - Router system overview
|
|
53
|
-
- [Router User Guide](router/ROUTER_USER_GUIDE.md) - Using the router
|
|
54
|
-
- [Router Config Reference](router/ROUTER_CONFIG_REFERENCE.md) - Configuration options
|
|
55
|
-
- [Top 20 Models Matrix](router/TOP20_MODELS_MATRIX.md) - Model comparison guide
|
|
56
|
-
|
|
57
|
-
### ✅ [Testing & Validation](testing/)
|
|
58
|
-
Current test results and development testing documentation.
|
|
59
|
-
|
|
60
|
-
- [Testing Overview](testing/README.md) - Current testing documentation
|
|
61
|
-
- [Agent System Validation](testing/AGENT-SYSTEM-VALIDATION.md) - Multi-agent testing
|
|
62
|
-
- [Final Testing Summary](testing/FINAL-TESTING-SUMMARY.md) - Comprehensive coverage
|
|
63
|
-
- [Regression Test Results](testing/REGRESSION-TEST-RESULTS.md) - Regression testing
|
|
64
|
-
- [Streaming & MCP Validation](testing/STREAMING-AND-MCP-VALIDATION.md) - Integration tests
|
|
65
|
-
|
|
66
|
-
For production validation reports, see [Validation Reports](validation-reports/)
|
|
67
|
-
|
|
68
|
-
### 🔍 [MCP Validation](mcp-validation/)
|
|
69
|
-
Model Context Protocol implementation and validation.
|
|
70
|
-
|
|
71
|
-
- [MCP Validation Overview](mcp-validation/README.md) - MCP testing documentation
|
|
72
|
-
- [Implementation Summary](mcp-validation/IMPLEMENTATION-SUMMARY.md) - MCP implementation
|
|
73
|
-
- [CLI Validation Report](mcp-validation/MCP-CLI-VALIDATION-REPORT.md) - CLI tool testing
|
|
74
|
-
- [Strange Loops Test](mcp-validation/strange-loops-test.md) - Advanced patterns
|
|
75
|
-
|
|
76
|
-
### 📦 [Version Releases](version-releases/)
|
|
77
|
-
Version-specific release notes and publishing documentation.
|
|
78
|
-
|
|
79
|
-
- [Release Overview](version-releases/README.md) - Release documentation index
|
|
80
|
-
- [v1.5.11 Publication Report](version-releases/PUBLICATION_REPORT_v1.5.11.md) - Latest release
|
|
81
|
-
- [v1.5.9 Release Summary](version-releases/v1.5.9-RELEASE-SUMMARY.md) - Previous release
|
|
82
|
-
- [v1.5.9 Docker Verification](version-releases/v1.5.9-DOCKER-VERIFICATION.md) - Docker validation
|
|
83
|
-
|
|
84
|
-
### 🧠 [ReasoningBank](reasoningbank/)
|
|
85
|
-
Cognitive memory system with pattern recognition and adaptive learning.
|
|
86
|
-
|
|
87
|
-
- [ReasoningBank Overview](reasoningbank/README.md) - Feature documentation index
|
|
88
|
-
- [Architecture](reasoningbank/REASONINGBANK_ARCHITECTURE.md) - System architecture
|
|
89
|
-
- [Backends](reasoningbank/REASONINGBANK_BACKENDS.md) - Storage backend options
|
|
90
|
-
- [Validation](reasoningbank/REASONINGBANK_VALIDATION.md) - Testing and validation
|
|
91
|
-
- [Benchmarks](reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md) - Performance metrics
|
|
92
|
-
|
|
93
|
-
### ✅ [Validation Reports](validation-reports/)
|
|
94
|
-
Comprehensive testing, benchmarking, and quality assurance reports.
|
|
95
|
-
|
|
96
|
-
- [Validation Overview](validation-reports/README.md) - Testing documentation index
|
|
97
|
-
- [Performance Benchmarks](validation-reports/BENCHMARK_AND_OPTIMIZATION_REPORT.md) - Optimization analysis
|
|
98
|
-
- [Docker Validation](validation-reports/DOCKER_VALIDATION_RESULTS.md) - Container testing
|
|
99
|
-
- [Regression Tests](validation-reports/NO_REGRESSIONS_CONFIRMED.md) - Stability verification
|
|
100
|
-
- [Alpha Validation](validation-reports/V2.7.0-ALPHA.10_FINAL_VALIDATION.md) - Release validation
|
|
101
|
-
|
|
102
|
-
### 🔌 [Integration Documentation](integration-docs/)
|
|
103
|
-
System integrations, implementations, and compatibility reports.
|
|
104
|
-
|
|
105
|
-
- [Integration Overview](integration-docs/README.md) - Integration documentation index
|
|
106
|
-
- [Agent Booster](integration-docs/AGENT-BOOSTER-INTEGRATION.md) - Ultra-fast code editing
|
|
107
|
-
- [Claude Flow](integration-docs/CLAUDE-FLOW-INTEGRATION-ANALYSIS.md) - Orchestration integration
|
|
108
|
-
- [WASM Integration](integration-docs/WASM_INTEGRATION_COMPLETE.md) - WebAssembly support
|
|
109
|
-
- [CLI Tools](integration-docs/CLI-INTEGRATION-COMPLETE.md) - Command-line integration
|
|
110
|
-
|
|
111
|
-
### 🔬 [Quantum Research](quantum-research/)
|
|
112
|
-
Quantum computing research, literature reviews, and experimental plans.
|
|
113
|
-
|
|
114
|
-
- [Quantum Overview](quantum-research/README.md) - Research documentation index
|
|
115
|
-
- [Literature Review](quantum-research/QUANTUM_RESEARCH_LITERATURE_REVIEW.md) - Comprehensive research
|
|
116
|
-
- [Observer-Agnostic Experiment](../examples/Observer-Agnostic%20Measurement%20and%20No-Retrocausal%20Marginals%20Theorem/) - Quantum measurement testing
|
|
117
|
-
|
|
118
|
-
### 🗄️ [Validation Archive](validation/)
|
|
119
|
-
Historical validation reports and test archives.
|
|
120
|
-
|
|
121
|
-
- [Validation Archive](validation/README.md) - Archived test reports
|
|
122
|
-
|
|
123
|
-
### 📦 [Archived](archived/)
|
|
124
|
-
Historical documentation, completed implementations, and validation reports.
|
|
125
|
-
|
|
126
|
-
#### Validation Reports (Archived)
|
|
127
|
-
- Version-specific validation (v1.1.10, v1.1.11)
|
|
128
|
-
- MCP proxy validation
|
|
129
|
-
- OpenRouter integration validation
|
|
130
|
-
- Docker deployment validation
|
|
131
|
-
- SDK integration reports
|
|
132
|
-
- Model validation reports
|
|
133
|
-
|
|
134
|
-
#### Completed Implementations
|
|
135
|
-
- [Research Complete](archived/RESEARCH_COMPLETE.txt) - Historical research
|
|
136
|
-
- [FastMCP Complete](archived/FASTMCP_COMPLETE.md) - FastMCP completion
|
|
137
|
-
- [Flow Nexus Complete](archived/FLOW-NEXUS-COMPLETE.md) - Flow Nexus completion
|
|
138
|
-
- [OpenRouter Proxy Complete](archived/OPENROUTER_PROXY_COMPLETE.md) - OpenRouter completion
|
|
139
|
-
- [Package Complete](archived/PACKAGE-COMPLETE.md) - Package completion
|
|
140
|
-
- [SDK Setup Complete](archived/SDK-SETUP-COMPLETE.md) - SDK setup completion
|
|
141
|
-
- ONNX implementation reports
|
|
142
|
-
- Integration confirmation reports
|
|
143
|
-
|
|
144
|
-
#### Historical Guides
|
|
145
|
-
- ONNX integration guides (superseded by current guides)
|
|
146
|
-
- Optimization summaries (superseded)
|
|
147
|
-
- Provider instruction optimization
|
|
148
|
-
- Tool instruction enhancements
|
|
149
|
-
|
|
150
|
-
#### Research & Planning
|
|
151
|
-
- ONNX Phi4 research
|
|
152
|
-
- ONNX Runtime integration planning
|
|
153
|
-
- Phi4 hyperoptimization plans
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## 🎯 Reading Paths
|
|
158
|
-
|
|
159
|
-
### Path 1: New Users (30 minutes)
|
|
160
|
-
1. [Main README](../README.md) - Project overview (10 min)
|
|
161
|
-
2. [Claude Config](CLAUDE.md) - Development setup (10 min)
|
|
162
|
-
3. [User Guides](guides/) - Practical tutorials (10 min)
|
|
163
|
-
|
|
164
|
-
### Path 2: Developers (1.5 hours)
|
|
165
|
-
1. [Architecture Overview](architecture/EXECUTIVE_SUMMARY.md) - System design (20 min)
|
|
166
|
-
2. [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md) - Code patterns (40 min)
|
|
167
|
-
3. [Integration Guides](integrations/) - External services (20 min)
|
|
168
|
-
4. [Testing Documentation](testing/) - Quality assurance (10 min)
|
|
169
|
-
|
|
170
|
-
### Path 3: System Architects (2 hours)
|
|
171
|
-
1. [Research Summary](architecture/RESEARCH_SUMMARY.md) - Technical findings (30 min)
|
|
172
|
-
2. [Multi-Model Router Plan](architecture/MULTI_MODEL_ROUTER_PLAN.md) - Router architecture (45 min)
|
|
173
|
-
3. [Integration Status](architecture/INTEGRATION-STATUS.md) - Current state (20 min)
|
|
174
|
-
4. [Router Documentation](router/) - Configuration and usage (15 min)
|
|
175
|
-
5. [MCP Validation](mcp-validation/) - Protocol implementation (10 min)
|
|
176
|
-
|
|
177
|
-
---
|
|
178
|
-
|
|
179
|
-
## 📊 Key Features
|
|
180
|
-
|
|
181
|
-
### Multi-Agent Orchestration
|
|
182
|
-
- Hierarchical, mesh, and hybrid topologies
|
|
183
|
-
- Parallel and sequential execution patterns
|
|
184
|
-
- Claude Flow integration for coordination
|
|
185
|
-
- 54+ specialized agent types
|
|
186
|
-
|
|
187
|
-
### SPARC Methodology
|
|
188
|
-
- Specification → Pseudocode → Architecture → Refinement → Completion
|
|
189
|
-
- Test-driven development workflow
|
|
190
|
-
- Automated task orchestration
|
|
191
|
-
- Neural pattern learning
|
|
192
|
-
|
|
193
|
-
### Model Router
|
|
194
|
-
- Multi-model support (Claude, OpenRouter, ONNX, Gemini)
|
|
195
|
-
- Intelligent model selection
|
|
196
|
-
- Cost optimization
|
|
197
|
-
- Performance monitoring
|
|
198
|
-
|
|
199
|
-
### Cloud Integration
|
|
200
|
-
- Flow Nexus platform support
|
|
201
|
-
- E2B sandbox execution
|
|
202
|
-
- Real-time streaming and monitoring
|
|
203
|
-
- 70+ MCP orchestration tools
|
|
204
|
-
|
|
205
|
-
---
|
|
206
|
-
|
|
207
|
-
## 🔗 External Resources
|
|
208
|
-
|
|
209
|
-
### Official Documentation
|
|
210
|
-
- [Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk/overview)
|
|
211
|
-
- [Model Context Protocol](https://modelcontextprotocol.io/)
|
|
212
|
-
- [Agentic Flow GitHub](https://github.com/ruvnet/agentic-flow)
|
|
213
|
-
- [Flow Nexus Platform](https://flow-nexus.ruv.io)
|
|
214
|
-
|
|
215
|
-
### Community
|
|
216
|
-
- [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
|
|
217
|
-
|
|
218
|
-
---
|
|
219
|
-
|
|
220
|
-
## 📞 Getting Help
|
|
221
|
-
|
|
222
|
-
### Documentation Questions
|
|
223
|
-
1. Check the relevant category above
|
|
224
|
-
2. Review the README for each section
|
|
225
|
-
3. Search for specific topics in the index
|
|
226
|
-
|
|
227
|
-
### Implementation Support
|
|
228
|
-
1. Review [Implementation Examples](guides/IMPLEMENTATION_EXAMPLES.md)
|
|
229
|
-
2. Check [Integration Guides](integrations/)
|
|
230
|
-
3. Consult [Router Documentation](router/)
|
|
231
|
-
|
|
232
|
-
### Architecture Questions
|
|
233
|
-
1. Read [Architecture Documentation](architecture/)
|
|
234
|
-
2. Review [Router Documentation](router/)
|
|
235
|
-
3. Check [Integration Status](architecture/INTEGRATION-STATUS.md)
|
|
236
|
-
|
|
237
|
-
---
|
|
238
|
-
|
|
239
|
-
## 🎯 Quick Links
|
|
240
|
-
|
|
241
|
-
- **License**: [MIT License](LICENSE)
|
|
242
|
-
- **Changelog**: [CHANGELOG.md](../CHANGELOG.md)
|
|
243
|
-
- **Contributing**: See main [README](../README.md)
|
|
244
|
-
- **Issues**: [GitHub Issues](https://github.com/ruvnet/agentic-flow/issues)
|
|
245
|
-
|
|
246
|
-
---
|
|
247
|
-
|
|
248
|
-
## 📂 Documentation Organization
|
|
249
|
-
|
|
250
|
-
### Active Documentation
|
|
251
|
-
All current and actively maintained documentation is organized in the category directories above.
|
|
252
|
-
|
|
253
|
-
### Archived Content
|
|
254
|
-
Historical reports, completed implementations, and superseded guides are in the [archived/](archived/) directory for reference.
|
|
255
|
-
|
|
256
|
-
---
|
|
257
|
-
|
|
258
|
-
**Documentation Status**: ✅ Reorganized and up-to-date
|
|
259
|
-
**Last Updated**: October 14, 2025
|
|
260
|
-
|
|
261
|
-
## 📋 Recent Documentation Updates
|
|
262
|
-
|
|
263
|
-
**v2.7.0 Reorganization (Oct 14, 2025)**:
|
|
264
|
-
- Created `reasoningbank/` for all ReasoningBank feature documentation
|
|
265
|
-
- Created `validation-reports/` for production testing and validation
|
|
266
|
-
- Created `integration-docs/` for system integration documentation
|
|
267
|
-
- Created `quantum-research/` for quantum computing research
|
|
268
|
-
- Created `version-releases/` for release notes and changelogs
|
|
269
|
-
- Added comprehensive README files to all new categories
|
|
270
|
-
- Consolidated loose files into organized subdirectories
|
|
271
|
-
- Improved navigation and discoverability
|
|
272
|
-
|
|
273
|
-
**v2.0 Reorganization (Oct 6, 2025)**:
|
|
274
|
-
- Created dedicated `releases/` directory for version-specific documentation
|
|
275
|
-
- Consolidated testing reports into `testing/` directory
|
|
276
|
-
- Separated MCP validation into dedicated `mcp-validation/` section
|
|
277
|
-
- Added comprehensive READMEs to all major sections
|
|
278
|
-
- Archived historical v1.1.x releases for cleaner navigation
|
|
279
|
-
- Improved documentation index with better categorization
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
/package/docs/{LANDING-PAGE-PROVIDER-CONTENT.md → providers/LANDING-PAGE-PROVIDER-CONTENT.md}
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|