agent-nuvira 1.16.1 → 1.18.0
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 +208 -26
- package/dist/inference/factory.d.ts.map +1 -1
- package/dist/inference/factory.js +2 -1
- package/dist/inference/factory.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,7 +15,7 @@ agent-nuvira config list
|
|
|
15
15
|
|
|
16
16
|
## Features
|
|
17
17
|
|
|
18
|
-
- **Unified interface** across
|
|
18
|
+
- **Unified interface** across 17+ providers: 5 built-in (local/Ollama, Groq, NVIDIA NIM, Google Gemini, OpenRouter) + 12 configurable via environment variables (OpenAI, Anthropic, Mistral, Cohere, Together, DeepInfra, Fireworks, Perplexity, Azure, LM Studio, Anyscale, vLLM)
|
|
19
19
|
- **Model discovery** — `agent-nuvira models` lists available models from any configured provider, with search/filter support
|
|
20
20
|
- **Interactive chat** with conversation history, file context, and session commands
|
|
21
21
|
- **AI-assisted file editing** with dry-run mode for safe previews
|
|
@@ -27,7 +27,7 @@ agent-nuvira config list
|
|
|
27
27
|
- **Context-preserving model switching** — `agent-nuvira model switch` changes providers mid-session without losing agent state
|
|
28
28
|
- **Skill compiler** — automatically extracts reusable patterns from successful agent runs into executable skills (`agent-nuvira skill run`)
|
|
29
29
|
- **Context-window memory pruner** — prevents long multi-agent chains from exceeding model token limits
|
|
30
|
-
- **Complete streaming support** — all
|
|
30
|
+
- **Complete streaming support** — all 17+ providers support real-time token-by-token output
|
|
31
31
|
- **Cost tracking** — per-provider/session/monthly costs with `agent-nuvira stats cost`
|
|
32
32
|
- **Prompt history search** — keyword and semantic search across past conversations (`/search`, `buff history`)
|
|
33
33
|
- **Native embedding support** — 3-tier embedder with `@huggingface/transformers` for 10x faster semantic search
|
|
@@ -47,8 +47,17 @@ agent-nuvira config list
|
|
|
47
47
|
- **Security scan CLI** — `buff security scan` detects PII, prompt injections, and dangerous code patterns
|
|
48
48
|
- **Feedback & rating system** — `buff feedback record/list/stats/clear` drives self-improvement scoring
|
|
49
49
|
- **Marketplace unified CLI** — `buff marketplace browse/search/install/info` for workflow templates + plugins
|
|
50
|
-
- **MCP (Model Context Protocol) integration** — connect to databases, APIs, and file systems via MCP servers
|
|
50
|
+
- **MCP (Model Context Protocol) integration** — connect to databases, APIs, and file systems via MCP servers with SSE transport support
|
|
51
51
|
- **AST-aware code editing** — structural analysis engine understands functions, classes, methods across JS/TS/Python/Go/Rust
|
|
52
|
+
- **Auto error-repair engine** — automatic diagnosis and repair of test failures with configurable retry budgets
|
|
53
|
+
- **A2A (Agent-to-Agent) Protocol** — inter-agent communication standard for multi-machine collaboration
|
|
54
|
+
- **CI/CD headless mode** — `buff ci` for automated pipelines with GitHub Actions integration
|
|
55
|
+
- **npm publishing & one-line install** — `npx agent-nuvira` and `npx buff` for zero-setup onboarding
|
|
56
|
+
- **Marketing website** — `website/` directory with a full landing page, SEO meta tags, and Netlify-ready deployment config
|
|
57
|
+
- **Interactive development mode** — `buff execute` without a goal launches a guided interactive loop with session save/resume, follow-up suggestions, and failure analysis
|
|
58
|
+
- **Session persistence** — save and resume development sessions across CLI restarts with full history
|
|
59
|
+
- **Failure analysis** — automatic diagnosis of agent failures with specific recovery options per agent type
|
|
60
|
+
- **Follow-up suggestions** — LLM-powered contextual next-step recommendations after goal completion
|
|
52
61
|
- **Configuration** via JSON config file + environment variables
|
|
53
62
|
- **No server dependency** — no telemetry, no subscriptions, no outbound calls to a hosted backend
|
|
54
63
|
|
|
@@ -897,17 +906,35 @@ agent-nuvira execute "migrate database schema" --context-prune aggressive
|
|
|
897
906
|
The pruner automatically compresses the shared agent context between pipeline steps using 5 strategies: metadata stripping, file change collapsing, conversation truncation, artifact summarization, and aggressive fallback.
|
|
898
907
|
|
|
899
908
|
|
|
900
|
-
The pipeline runs these agents in
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
909
|
+
The pipeline runs these agents in dependency-aware order with parallelization:
|
|
910
|
+
|
|
911
|
+
| # | Agent | Type | Description |
|
|
912
|
+
|---|-------|------|-------------|
|
|
913
|
+
| 1 | **Planner** | Core | Analyzes the goal, creates a dependency-aware task plan |
|
|
914
|
+
| 2 | **Context Gatherer** | Core | Scans the codebase for relevant files and artifacts |
|
|
915
|
+
| 3 | **Security Scanner** | Safety | Scans for PII, prompt injection, and dangerous patterns |
|
|
916
|
+
| 4 | **Writer** | Core | Implements the code changes based on plan and context |
|
|
917
|
+
| 5 | **Reviewer** | Quality | Validates changes for bugs, security, and code style |
|
|
918
|
+
| 6 | **Tester** | Testing | Runs tests in a sandboxed temp directory or Docker container |
|
|
919
|
+
| 7 | **Debugger** | Testing | Iteratively diagnoses and fixes test failures via LLM |
|
|
920
|
+
| 8 | **Runner** | Execution | Executes shell commands to verify the program works |
|
|
921
|
+
| 9 | **MCP Agent** | Integration | Invokes external tools from connected MCP servers |
|
|
922
|
+
| 10 | **Skill Runner** | Learning | Executes compiled skill scripts as pre-built task plans |
|
|
923
|
+
| 11 | **Git Agent** | Publishing | Creates branches, commits with LLM-generated messages |
|
|
924
|
+
| 12 | **PR Description** | Publishing | Generates PR descriptions from git diff via LLM |
|
|
925
|
+
| 13 | **Package Agent** | Publishing | Bumps versions, builds, publishes to npm |
|
|
926
|
+
| 14 | **GitHub Release** | Publishing | Creates tags, release notes, and GitHub releases |
|
|
927
|
+
|
|
928
|
+
**Parallel execution:** Independent agents (e.g., Reviewer + Tester) run concurrently via `Promise.all()`. Exclusive agents (Runner, Debugger) get dedicated access. Results are merged with conflict resolution.
|
|
929
|
+
|
|
930
|
+
**Interactive development mode:** `buff execute` without a goal launches an interactive loop with:
|
|
931
|
+
- **Model picker** — Choose your provider/model interactively
|
|
932
|
+
- **Session tracking** — Full history of goals executed in the session
|
|
933
|
+
- **Failure analysis** — Per-agent-type diagnosis with recovery actions
|
|
934
|
+
- **Follow-up suggestions** — LLM-powered contextual next steps
|
|
935
|
+
- **/fix** — Retry the last failed goal with failure context
|
|
936
|
+
- **/save / /resume** — Save and restore sessions across restarts
|
|
937
|
+
- **/suggest** — Search past trajectories for similar goals
|
|
911
938
|
|
|
912
939
|
---
|
|
913
940
|
|
|
@@ -933,15 +960,20 @@ Adapter Adapter Adapter Adapter Adapter
|
|
|
933
960
|
│ Core Pipeline │
|
|
934
961
|
│ ┌────────────────────────┐ │
|
|
935
962
|
│ │ Orchestrator │ │
|
|
936
|
-
│ │ ├─ Planner
|
|
937
|
-
│ │ ├─
|
|
938
|
-
│ │ ├─ Writer
|
|
939
|
-
│ │ ├─ Reviewer
|
|
940
|
-
│ │ ├─ Tester
|
|
941
|
-
│ │ ├─ Runner
|
|
942
|
-
│ │ ├─ Debugger
|
|
943
|
-
│ │ ├─ GitAgent
|
|
944
|
-
│ │
|
|
963
|
+
│ │ │ ├─ Planner │ │
|
|
964
|
+
│ │ ├─ ContextGatherer │ │
|
|
965
|
+
│ │ ├─ Writer │ │
|
|
966
|
+
│ │ ├─ Reviewer │ │
|
|
967
|
+
│ │ ├─ Tester │ │
|
|
968
|
+
│ │ ├─ Runner │ │
|
|
969
|
+
│ │ ├─ Debugger │ │
|
|
970
|
+
│ │ ├─ GitAgent │ │
|
|
971
|
+
│ │ ├─ PackageAgent │ │
|
|
972
|
+
│ │ ├─ GitHubReleaseAgent │ │
|
|
973
|
+
│ │ ├─ SecurityAgent │ │
|
|
974
|
+
│ │ ├─ SkillRunner │ │
|
|
975
|
+
│ │ ├─ MCPAgent │ │
|
|
976
|
+
│ │ └─ PRDescriptionAgent │ │
|
|
945
977
|
│ └────────────────────────┘ │
|
|
946
978
|
│ │
|
|
947
979
|
│ ┌────────────────────────┐ │
|
|
@@ -981,6 +1013,21 @@ Adapter Adapter Adapter Adapter Adapter
|
|
|
981
1013
|
└──────────────────────────────┘
|
|
982
1014
|
```
|
|
983
1015
|
|
|
1016
|
+
### Website (Marketing Site)
|
|
1017
|
+
|
|
1018
|
+
The `website/` directory contains a complete static landing page for Agent-Nuvira (`agent-nuvira.com`):
|
|
1019
|
+
|
|
1020
|
+
| File | Purpose |
|
|
1021
|
+
|---|---|
|
|
1022
|
+
| `index.html` | Full marketing landing page with hero, features, pipeline visualization, provider cards, quickstart guide, extensions, and comparison table |
|
|
1023
|
+
| `styles.css` | Complete styling with gradient text, animated particles, responsive grid, and dark theme |
|
|
1024
|
+
| `script.js` | Interactive elements: scroll animations, copy-to-clipboard, mobile nav toggle, particle system |
|
|
1025
|
+
| `_redirects` | Netlify/Cloudflare Page redirect rules |
|
|
1026
|
+
| `_headers` | Custom HTTP security and cache headers |
|
|
1027
|
+
| `assets/` | Hero images, screenshots, and OG meta assets |
|
|
1028
|
+
|
|
1029
|
+
The site is pre-configured for Netlify deployment with zero-configuration.
|
|
1030
|
+
|
|
984
1031
|
### Key Modules
|
|
985
1032
|
|
|
986
1033
|
| Module | Path | Purpose |
|
|
@@ -1292,11 +1339,13 @@ npx tsc --noEmit
|
|
|
1292
1339
|
|
|
1293
1340
|
**Phases 1–3 (25 phases) are complete.** Phase 4 (Industry Standards & Autonomous Polish) is in progress. See [UPGRADE_ROADMAP.md](./UPGRADE_ROADMAP.md) for the full implementation journey.
|
|
1294
1341
|
|
|
1342
|
+
> 📊 **Product strategy and pitch materials:** [PRODUCT_STRATEGY.md](./PRODUCT_STRATEGY.md) — Competitive landscape, positioning map, OKR framework, and risk register. [PITCH_DECK.md](./PITCH_DECK.md) — 10-slide investor presentation outline with talking points and data.
|
|
1343
|
+
|
|
1295
1344
|
| Phase | Feature | Status |
|
|
1296
1345
|
|---|---|---|
|
|
1297
1346
|
| **Phase 1: Quick Wins** | | |
|
|
1298
1347
|
| 1.1 | Auto-discovery plugin loader — drop `.js` into `~/.buff/plugins/` | ✅ Complete |
|
|
1299
|
-
| 1.2 | Complete streaming support — all
|
|
1348
|
+
| 1.2 | Complete streaming support — all 17+ providers | ✅ Complete |
|
|
1300
1349
|
| 1.3 | Cost tracking — per-provider/session/monthly | ✅ Complete |
|
|
1301
1350
|
| 1.4 | `buff init` — interactive project scaffolding | ✅ Complete |
|
|
1302
1351
|
| 1.5 | Prompt history search — keyword + semantic | ✅ Complete |
|
|
@@ -1322,12 +1371,145 @@ npx tsc --noEmit
|
|
|
1322
1371
|
| 3.9 | Security scan CLI (`buff security scan`) | ✅ Complete |
|
|
1323
1372
|
| 3.10 | Feedback & rating system (`buff feedback`) | ✅ Complete |
|
|
1324
1373
|
| 3.11 | Marketplace unified CLI (`buff marketplace browse/search/install`) | ✅ Complete |
|
|
1325
|
-
| **Phase 4: Industry Standards** |
|
|
1326
|
-
| 4.1 | MCP (Model Context Protocol)
|
|
1374
|
+
| **Phase 4: Industry Standards** | | |
|
|
1375
|
+
| 4.1 | MCP (Model Context Protocol) — client/manager/CLI with SSE transport + Firecrawl | ✅ Complete |
|
|
1327
1376
|
| 4.2 | AST-aware code editing — structural analysis engine (JS/TS/Python/Go/Rust) | ✅ Complete |
|
|
1377
|
+
| 4.3 | Auto error-repair engine — diagnosis & retry budgets for test failures | ✅ Complete |
|
|
1378
|
+
| 4.4 | A2A (Agent-to-Agent) Protocol — inter-agent communication standard | ✅ Complete |
|
|
1379
|
+
| 4.5 | CI/CD headless mode — `buff ci` with GitHub Actions integration | ✅ Complete |
|
|
1380
|
+
| 4.6 | npm publishing & one-line install — `npx agent-nuvira` / `npx buff` | ✅ Complete |
|
|
1381
|
+
| **Phase 5: Interactive UX** | | |
|
|
1382
|
+
| 5.1 | Interactive dev mode — guided loop with model picker, session save/resume | ✅ Complete |
|
|
1383
|
+
| 5.2 | Failure analysis — per-agent-type diagnosis with recovery actions | ✅ Complete |
|
|
1384
|
+
| 5.3 | Follow-up suggestions — LLM-powered contextual next-step recommendations | ✅ Complete |
|
|
1385
|
+
| 5.4 | /fix command — retry last failed goal with failure context | ✅ Complete |
|
|
1386
|
+
| 5.5 | Test coverage — 1830+ tests across 55 test files | ✅ Complete |
|
|
1387
|
+
|
|
1388
|
+
---
|
|
1389
|
+
|
|
1390
|
+
## Version History
|
|
1391
|
+
|
|
1392
|
+
| Version | Date | Key Changes |
|
|
1393
|
+
|---------|------|-------------|
|
|
1394
|
+
| **v1.0.0** | Apr 2026 | Initial release — Core CLI with chat, 5 built-in providers (expandable to 17+ via plugins), config, models |
|
|
1395
|
+
| **v1.1.0** | Apr 2026 | Model discovery with search/filter |
|
|
1396
|
+
| **v1.2.0** | Apr 2026 | AI-assisted file editing (edit command) |
|
|
1397
|
+
| **v1.3.0** | May 2026 | Implementation plans (plan command) |
|
|
1398
|
+
| **v1.4.0** | May 2026 | Multi-agent pipeline (execute command) with Planner, Writer, ContextGatherer |
|
|
1399
|
+
| **v1.5.0** | May 2026 | Additional agents — Tester, Runner, Debugger |
|
|
1400
|
+
| **v1.6.0** | Jun 2026 | Agent retry logic, format validation, git integration |
|
|
1401
|
+
| **v1.7.0** | Jun 2026 | Phase 1 features — plugin system, cost tracking, logging |
|
|
1402
|
+
| **v1.8.0** | Jun 2026 | Native embeddings, vector store, trajectory memory |
|
|
1403
|
+
| **v1.9.0** | Jul 2026 | Workflow templates, model benchmarking |
|
|
1404
|
+
| **v1.10.0** | Jul 2026 | Docker sandbox, provider health dashboard |
|
|
1405
|
+
| **v1.11.0** | Jul 2026 | Skill compiler, context pruner, model switching |
|
|
1406
|
+
| **v1.12.0** | Jul 2026 | VS Code extension, web dashboard, agent federation |
|
|
1407
|
+
| **v1.13.0** | Jul 2026 | Hybrid model routing, team collaboration, Agent SDK |
|
|
1408
|
+
| **v1.14.0** | Jul 2026 | Provider fallback, security scan, feedback system, marketplace CLI |
|
|
1409
|
+
| **v1.14.6** | Jul 2026 | Skill compiler system, context-window pruner, Docker Compose onboarding |
|
|
1410
|
+
| **v1.15.0** | Aug 2026 | npm publishing — `npx buff` / `npx agent-nuvira` live on npm (1.3 MB) |
|
|
1411
|
+
| **v1.15.1** | Aug 2026 | Interactive dev mode — model picker, session tracking, /save / /resume, /suggest |
|
|
1412
|
+
| **v1.15.2** | Aug 2026 | Windows compatibility fixes |
|
|
1413
|
+
| **v1.15.3** | Aug 2026 | Accessibility fix — `window.open` → native `<a>` tags |
|
|
1414
|
+
| **v1.15.4** | Aug 2026 | Search/filter bar, column count toggle, speech provider section |
|
|
1415
|
+
| **v1.15.5** | Aug 2026 | SSE header support for MCP |
|
|
1416
|
+
| **v1.15.6** | Aug 2026 | Firecrawl integration for web search |
|
|
1417
|
+
| **v1.16.0** | Aug 2026 | Comprehensive MCP README docs, SSE header support |
|
|
1418
|
+
| **v1.16.1** | Aug 2026 | Interactive dev mode enhancements — failure analysis, follow-up suggestions, /fix command, 35 new unit tests |
|
|
1328
1419
|
|
|
1329
1420
|
---
|
|
1330
1421
|
|
|
1422
|
+
## Phase-Wise Feature Summary
|
|
1423
|
+
|
|
1424
|
+
### Phase 0: Foundation — Core CLI & Provider Layer
|
|
1425
|
+
| Feature | Description |
|
|
1426
|
+
|---------|-------------|
|
|
1427
|
+
| **17+ Inference Providers** | 5 built-in (Groq, NVIDIA NIM, Google Gemini, OpenRouter, Local) + 12 configurable via env vars (OpenAI, Anthropic, Mistral, Cohere, Together, DeepInfra, Fireworks, Perplexity, Azure, LM Studio, Anyscale, vLLM) |
|
|
1428
|
+
| **Unified CLI** | 25+ commands via Commander.js with shared options |
|
|
1429
|
+
| **Config System** | JSON config file + env vars + CLI flags priority chain |
|
|
1430
|
+
| **Streaming** | Real-time token-by-token output for all 17+ providers |
|
|
1431
|
+
| **Response Caching** | SQLite-backed cache with configurable TTL |
|
|
1432
|
+
| **Chat Interface** | Interactive chat with conversation history and `/` commands |
|
|
1433
|
+
| **File Editing** | AI-assisted file editing with dry-run mode |
|
|
1434
|
+
| **Implementation Plans** | Codebase-aware plan generation with architecture impact analysis |
|
|
1435
|
+
|
|
1436
|
+
### Phase 1: Quick Wins — Developer Experience
|
|
1437
|
+
| Feature | Description |
|
|
1438
|
+
|---------|-------------|
|
|
1439
|
+
| **Plugin System** | Programmatic API + auto-discovery from `~/.buff/plugins/` |
|
|
1440
|
+
| **Project Scaffolding** | `buff init` with 5 built-in templates + interactive provider wizard |
|
|
1441
|
+
| **Model Discovery** | `buff models` with search/filter across all providers |
|
|
1442
|
+
| **Model Switching** | Context-preserving provider/model switch mid-session |
|
|
1443
|
+
| **Cost Tracking** | Per-provider, per-session, and monthly cost dashboards |
|
|
1444
|
+
| **History Search** | Keyword + semantic search across past conversations |
|
|
1445
|
+
| **Skill Compiler** | Auto-extracts reusable patterns from trajectories into runnable skills |
|
|
1446
|
+
| **Context Pruner** | 5-strategy token compression for long agent chains |
|
|
1447
|
+
|
|
1448
|
+
### Phase 2: Structural Changes — Memory & Infrastructure
|
|
1449
|
+
| Feature | Description |
|
|
1450
|
+
|---------|-------------|
|
|
1451
|
+
| **Vector Store** | Cosine similarity search over embedded trajectories |
|
|
1452
|
+
| **Trajectory Store** | Few-shot example storage with quality scoring |
|
|
1453
|
+
| **3-Tier Embedder** | Xenova (fast) → Python (medium) → LLM (fallback) |
|
|
1454
|
+
| **Workflow Marketplace** | 10 built-in templates + GitHub registry with install/publish |
|
|
1455
|
+
| **Model Benchmarking** | 21 standardized coding tasks with scoring and A/B comparison |
|
|
1456
|
+
| **Docker Sandbox** | 8 base images, resource limits, network-isolated execution |
|
|
1457
|
+
| **Provider Health** | `buff doctor` with color-coded status, watch mode, auto-fix |
|
|
1458
|
+
| **Memory Compression** | Automatic trajectory summarization with configurable retention |
|
|
1459
|
+
|
|
1460
|
+
### Phase 3: Major Upgrades — Advanced Agent Systems
|
|
1461
|
+
| Feature | Description |
|
|
1462
|
+
|---------|-------------|
|
|
1463
|
+
| **VS Code Extension** | 9 commands, inline code suggestions, diff viewer, agent progress panel |
|
|
1464
|
+
| **Agent Federation** | Multi-machine collaboration via A2A protocol, server, and client |
|
|
1465
|
+
| **Web Dashboard** | React + Recharts + DAG visualization, model health, cost charts |
|
|
1466
|
+
| **Hybrid Model Routing** | Complexity-based model selection with cost optimization |
|
|
1467
|
+
| **Team Collaboration** | Git-synced shared config, memory, and review pipelines |
|
|
1468
|
+
| **Agent SDK** | `@agent-nuvira/sdk` npm package with scaffolding CLI |
|
|
1469
|
+
| **Provider CLI** | `buff provider list/health` with per-provider diagnostics |
|
|
1470
|
+
| **Provider Fallback** | Auto-failover with circuit breaker and configurable chain |
|
|
1471
|
+
| **Security Scanner** | Detects PII, prompt injections, and dangerous code patterns |
|
|
1472
|
+
| **Feedback System** | `buff feedback record/list/stats/clear` drives self-improvement |
|
|
1473
|
+
| **Marketplace CLI** | Unified `buff marketplace browse/search/install/info` |
|
|
1474
|
+
|
|
1475
|
+
### Phase 4: Industry Standards — Protocol & Integration
|
|
1476
|
+
| Feature | Description |
|
|
1477
|
+
|---------|-------------|
|
|
1478
|
+
| **MCP Protocol** | Model Context Protocol client/manager with stdio + SSE transport |
|
|
1479
|
+
| **AST Editing Engine** | Structural code analysis for JS/TS/Python/Go/Rust |
|
|
1480
|
+
| **Auto Error-Repair** | Automatic diagnosis and repair with configurable retry budgets |
|
|
1481
|
+
| **A2A Protocol** | Agent-to-Agent communication standard for federation |
|
|
1482
|
+
| **CI/CD Headless** | `buff ci` for automated pipelines with GitHub Actions |
|
|
1483
|
+
| **npm Publishing** | `npx agent-nuvira` / `npx buff` for zero-setup onboarding |
|
|
1484
|
+
|
|
1485
|
+
### Phase 5: Interactive UX — Developer Experience
|
|
1486
|
+
| Feature | Description |
|
|
1487
|
+
|---------|-------------|
|
|
1488
|
+
| **Interactive Dev Mode** | Guided loop with model picker, session management, and goal tracking |
|
|
1489
|
+
| **Session Save/Resume** | Save and restore development sessions with full history |
|
|
1490
|
+
| **Failure Analysis** | Per-agent-type diagnosis with specific recovery actions |
|
|
1491
|
+
| **Follow-up Suggestions** | LLM-powered contextual next-step recommendations |
|
|
1492
|
+
| **/fix Command** | Retry last failed goal with failure context |
|
|
1493
|
+
| **Graceful Error Recovery** | Rate-limit handling, auth failures, and network error recovery |
|
|
1494
|
+
|
|
1495
|
+
### Agent Catalog — 15 Agent Roles & Management
|
|
1496
|
+
| Agent/Component | Type | Description |
|
|
1497
|
+
|-----------------|------|-------------|
|
|
1498
|
+
| **PlannerAgent** | Core | Analyzes goals, creates dependency-aware task plans |
|
|
1499
|
+
| **ContextGathererAgent** | Core | Scans codebase, identifies relevant files and artifacts |
|
|
1500
|
+
| **WriterAgent** | Core | Implements code changes based on plan and gathered context |
|
|
1501
|
+
| **ReviewerAgent** | Core | Validates changes for bugs, security, and style |
|
|
1502
|
+
| **RunnerAgent** | Execution | Executes shell commands and captures output |
|
|
1503
|
+
| **TesterAgent** | Testing | Runs tests in sandboxed temp directory or Docker container |
|
|
1504
|
+
| **DebuggerAgent** | Testing | Iteratively diagnoses and fixes test failures via LLM |
|
|
1505
|
+
| **GitAgent** | Publishing | Creates branches, commits with LLM messages, generates PR descriptions |
|
|
1506
|
+
| **PackageAgent** | Publishing | Bumps version, builds, publishes to npm, generates changelogs |
|
|
1507
|
+
| **GitHubReleaseAgent** | Publishing | Creates tags, release notes, and GitHub releases via `gh` CLI or API |
|
|
1508
|
+
| **SecurityAgent** | Safety | Scans for PII, prompt injection, and dangerous code patterns |
|
|
1509
|
+
| **SkillRunnerAgent** | Learning | Executes compiled skill scripts as pre-built task plans |
|
|
1510
|
+
| **MCPAgent** | Integration | Invokes MCP tools from connected servers via stdio or SSE transport |
|
|
1511
|
+
| **Orchestrator** | Management | Coordinates all agents with dependency-aware scheduling, parallel execution, context pruning, and interactive recovery |
|
|
1512
|
+
|
|
1331
1513
|
## License
|
|
1332
1514
|
|
|
1333
1515
|
MIT
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/inference/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMnD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGlE;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,iBAAiB;
|
|
1
|
+
{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/inference/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMnD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGlE;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,iBAAiB;CA0B9F"}
|
|
@@ -38,7 +38,8 @@ export class ProviderFactory {
|
|
|
38
38
|
return registry.createProviderFromPlugin(type, config);
|
|
39
39
|
}
|
|
40
40
|
throw new Error(`Unknown provider type: '${type}'. Available built-in: nim, gemini, openrouter, groq, local. ` +
|
|
41
|
-
`Check ~/.buff/plugins/ for auto-discovered plugins
|
|
41
|
+
`Check ~/.buff/plugins/ for auto-discovered plugins. ` +
|
|
42
|
+
`Supports 17+ total providers via env vars and plugin system (OpenAI, Anthropic, Mistral, Cohere, Together, DeepInfra, Fireworks, Perplexity, Azure, LM Studio, Anyscale, vLLM and more).`);
|
|
42
43
|
}
|
|
43
44
|
}
|
|
44
45
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/inference/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAA2B,EAAE,MAAsB;QACvE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,KAAK;gBACR,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAChC,KAAK,QAAQ;gBACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;YACnC,KAAK,YAAY;gBACf,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACvC,KAAK,MAAM;gBACT,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,OAAO;gBACV,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC,CAAC;gBACR,sDAAsD;gBACtD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;gBACrC,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,OAAO,QAAQ,CAAC,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,+DAA+D;oBAC9F,
|
|
1
|
+
{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/inference/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAA2B,EAAE,MAAsB;QACvE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,KAAK;gBACR,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAChC,KAAK,QAAQ;gBACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;YACnC,KAAK,YAAY;gBACf,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACvC,KAAK,MAAM;gBACT,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,OAAO;gBACV,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC,CAAC;gBACR,sDAAsD;gBACtD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;gBACrC,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,OAAO,QAAQ,CAAC,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,+DAA+D;oBAC9F,sDAAsD;oBACtD,0LAA0L,CAC3L,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-nuvira",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.18.0",
|
|
4
4
|
"description": "Agent-Nuvira: Multi-agent AI coding CLI — plan, write, review, test, and publish code with local models (Ollama) or cloud APIs (Groq, NVIDIA NIM, Google Gemini, OpenRouter)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|