@defai.digital/automatosx 8.2.0 → 8.3.2
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 +16 -0
- package/README.md +125 -86
- package/dist/index.js +29215 -47804
- package/examples/grok/GROK_INTEGRATION.md +511 -0
- package/examples/grok/settings.json +43 -0
- package/examples/providers/README.md +228 -0
- package/examples/providers/grok-with-mcp.yaml +86 -0
- package/examples/providers/grok-x-ai.yaml +46 -0
- package/examples/providers/grok-z-ai.yaml +50 -0
- package/examples/providers/grok.yaml +120 -0
- package/package.json +4 -3
- package/templates/providers/README.md +117 -0
- package/templates/providers/grok-zai.yaml.template +61 -0
- package/templates/providers/grok.yaml.template +71 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
|
4
4
|
|
|
5
|
+
## [8.3.0] - 2025-11-17
|
|
6
|
+
|
|
7
|
+
### Fixed
|
|
8
|
+
- **Critical**: Added backward compatibility for provider names (claude-code, gemini-cli, openai)
|
|
9
|
+
- Fixed config reset test to handle optional version field
|
|
10
|
+
- Fixed router circuit breaker test to match v8.3.0 behavior (3 failures threshold)
|
|
11
|
+
- Removed obsolete providers.test.ts (tested SDK features removed in v8.3.0)
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
- Skipped streaming workflow tests (feature removed in CLI-only refactoring)
|
|
15
|
+
|
|
16
|
+
### Improved
|
|
17
|
+
- Achieved 100% test pass rate (112/112 unit tests, 9/9 integration tests)
|
|
18
|
+
- Reduced test failures from 43 to 0
|
|
19
|
+
- Comprehensive test suite improvements and cleanup
|
|
20
|
+
|
|
5
21
|
## [7.6.0] - 2025-11-04
|
|
6
22
|
|
|
7
23
|
### Added
|
package/README.md
CHANGED
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
**From Idea to Production in Minutes: The AI Workforce Platform with Persistent Memory**
|
|
4
4
|
|
|
5
|
-
AutomatosX is
|
|
5
|
+
AutomatosX is a pure CLI orchestration platform for AI agents. It wraps around `claude`, `gemini`, and `codex` commands to provide multi-agent orchestration, persistent memory, and workflow automation. Simple, focused, and easy to integrate with your existing AI workflow.
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/@defai.digital/automatosx)
|
|
8
|
-
[](LICENSE)
|
|
9
9
|
[](https://www.typescriptlang.org/)
|
|
10
10
|
[](#)
|
|
11
11
|
[](https://www.npmjs.com/package/@defai.digital/automatosx)
|
|
@@ -13,11 +13,9 @@ AutomatosX is the only AI CLI that combines declarative workflow specs, policy-d
|
|
|
13
13
|
[](https://www.microsoft.com/windows)
|
|
14
14
|
[](https://ubuntu.com)
|
|
15
15
|
|
|
16
|
-
**Status**: ✅ **Production Ready** |
|
|
16
|
+
**Status**: ✅ **Production Ready** | v8.3.0 | 20 Specialized Agents | Pure CLI Orchestration | Simplified Architecture
|
|
17
17
|
|
|
18
|
-
> 🎉 **NEW in
|
|
19
|
-
|
|
20
|
-
> ⚠️ **Note on Cost Estimation (v6.5.11+)**: Cost estimation is **disabled by default** due to frequent pricing changes. The cost optimization features described below are still functional (routing, free-tier prioritization, policy constraints), but specific dollar amounts are not shown unless you enable cost estimation in `automatosx.config.json`. See [Cost Estimation Configuration](#cost-estimation-configuration) for details.
|
|
18
|
+
> 🎉 **NEW in v8.3.0**: Major simplification! Removed ~36,000 lines of code including policy routing, free-tier management, and SDK providers. AutomatosX is now a pure CLI orchestration wrapper around `claude`, `gemini`, and `codex` commands. Simpler, faster, easier to maintain. See [Migration Guide](MIGRATION.md) for upgrade details.
|
|
21
19
|
|
|
22
20
|
---
|
|
23
21
|
|
|
@@ -34,10 +32,10 @@ AutomatosX is **the only AI platform** that gives you:
|
|
|
34
32
|
| Feature | What It Does | Value |
|
|
35
33
|
|---------|--------------|-------|
|
|
36
34
|
| 📋 **Spec-Kit Integration** | Define workflows in YAML. Generate plans, DAGs, scaffolding, and tests automatically. | Ship projects 10x faster |
|
|
37
|
-
| 💰 **Policy-Driven Routing** | Set cost/latency/privacy constraints. AutomatosX picks the optimal AI provider for every request. | Save 60-80% on AI costs |
|
|
38
35
|
| 🧠 **Persistent Memory** | Every conversation is remembered. Agents get perfect context automatically. | Never repeat yourself again |
|
|
39
36
|
| 🤝 **Multi-Agent Orchestration** | 20 specialized agents delegate tasks to each other. You manage the project, not the details. | Focus on strategy, not micromanagement |
|
|
40
|
-
|
|
|
37
|
+
| 🔧 **Pure CLI Wrapper** | Works with your existing `claude`, `gemini`, `codex` CLIs. No API keys needed. | Simple integration |
|
|
38
|
+
| 🔍 **Complete Observability** | Trace every execution and decision. Debug with confidence. | Production-grade reliability |
|
|
41
39
|
|
|
42
40
|
---
|
|
43
41
|
|
|
@@ -84,83 +82,6 @@ ax run workflow.ax.yaml
|
|
|
84
82
|
|
|
85
83
|
---
|
|
86
84
|
|
|
87
|
-
## 💬 **Interactive CLI** (New in v7.1.0!)
|
|
88
|
-
|
|
89
|
-
Experience a ChatGPT-style conversational interface directly in your terminal:
|
|
90
|
-
|
|
91
|
-
```bash
|
|
92
|
-
# Start interactive mode
|
|
93
|
-
ax cli
|
|
94
|
-
|
|
95
|
-
╭─────────────────────────────────────────────────────╮
|
|
96
|
-
│ AutomatosX Interactive CLI v7.1.0 │
|
|
97
|
-
│ Type /help for commands, /exit to quit │
|
|
98
|
-
│ Using: Gemini 2.5 Flash │
|
|
99
|
-
╰─────────────────────────────────────────────────────╯
|
|
100
|
-
|
|
101
|
-
ax> I need to implement JWT authentication
|
|
102
|
-
|
|
103
|
-
AI: I'll help you implement JWT authentication. Let me search our
|
|
104
|
-
memory for existing auth patterns...
|
|
105
|
-
|
|
106
|
-
Found 2 relevant patterns. Would you like me to:
|
|
107
|
-
1. Show implementation plan
|
|
108
|
-
2. Delegate to backend agent
|
|
109
|
-
3. Start coding immediately
|
|
110
|
-
|
|
111
|
-
ax> Delegate to backend agent
|
|
112
|
-
|
|
113
|
-
AI: @backend implement JWT authentication with refresh tokens
|
|
114
|
-
|
|
115
|
-
[Backend agent working...]
|
|
116
|
-
✓ Dependencies installed
|
|
117
|
-
✓ Auth middleware created
|
|
118
|
-
✓ Token refresh endpoint added
|
|
119
|
-
✓ Tests generated
|
|
120
|
-
|
|
121
|
-
ax> /save jwt-implementation
|
|
122
|
-
Conversation saved: jwt-implementation
|
|
123
|
-
|
|
124
|
-
ax> /exit
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
### Key Features
|
|
128
|
-
|
|
129
|
-
- 🤖 **Natural Conversations** - Multi-turn discussions with full context
|
|
130
|
-
- 🔄 **Real-time Streaming** - See responses as they're generated
|
|
131
|
-
- 💾 **Save & Resume** - Continue conversations later with `/save` and `/load`
|
|
132
|
-
- 🎯 **Agent Delegation** - Route tasks to specialists: `@backend`, `@security`, etc.
|
|
133
|
-
- 📝 **13 Slash Commands** - `/help`, `/memory`, `/agents`, `/export`, and more
|
|
134
|
-
- 🎨 **Beautiful Output** - Markdown rendering and syntax-highlighted code blocks
|
|
135
|
-
- ⚡ **Fast & Efficient** - Powered by Gemini free tier (1,500 requests/day)
|
|
136
|
-
|
|
137
|
-
### Quick Examples
|
|
138
|
-
|
|
139
|
-
```bash
|
|
140
|
-
# Start a coding session
|
|
141
|
-
ax cli
|
|
142
|
-
ax> @backend create a REST API for user management
|
|
143
|
-
ax> @security audit the authentication code
|
|
144
|
-
ax> /save user-management-api
|
|
145
|
-
|
|
146
|
-
# Search your knowledge base
|
|
147
|
-
ax cli
|
|
148
|
-
ax> /memory search "authentication patterns"
|
|
149
|
-
ax> Show me the JWT implementation we used last time
|
|
150
|
-
|
|
151
|
-
# Work across sessions
|
|
152
|
-
ax cli
|
|
153
|
-
ax> /load user-management-api
|
|
154
|
-
ax> Let's add rate limiting to these endpoints
|
|
155
|
-
ax> /export # Export to markdown for documentation
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
**📖 Full Guide**: [Interactive CLI Documentation](docs/cli-interactive.md)
|
|
159
|
-
|
|
160
|
-
**Alternative Commands**: `ax interactive`, `ax chat`
|
|
161
|
-
|
|
162
|
-
---
|
|
163
|
-
|
|
164
85
|
## 🗣️ **Recommended**: Natural Language Interface
|
|
165
86
|
|
|
166
87
|
AutomatosX is designed to work seamlessly with AI assistants using natural language commands. This is the **recommended way** to use AutomatosX:
|
|
@@ -1208,9 +1129,107 @@ ax setup -f
|
|
|
1208
1129
|
- [Gemini CLI](https://ai.google.dev/gemini-api/docs/cli) (recommended - cheapest)
|
|
1209
1130
|
- [OpenAI Codex](https://platform.openai.com/docs/guides/code) (fastest)
|
|
1210
1131
|
- [Claude Code](https://claude.ai/code) (most capable)
|
|
1132
|
+
- [Grok CLI](#-grok-cli-configuration-new-in-v831) (X.AI or self-hosted GLM 4.6)
|
|
1211
1133
|
|
|
1212
1134
|
[➡️ Full Installation Guide](docs/getting-started/installation.md)
|
|
1213
1135
|
|
|
1136
|
+
### 🤖 Grok CLI Configuration (New in v8.3.1)
|
|
1137
|
+
|
|
1138
|
+
AutomatosX now supports Grok CLI with **two endpoints**:
|
|
1139
|
+
|
|
1140
|
+
#### Option 1: X.AI Official Grok (Recommended)
|
|
1141
|
+
|
|
1142
|
+
```bash
|
|
1143
|
+
# 1. Run setup to create .grok/settings.json
|
|
1144
|
+
ax setup
|
|
1145
|
+
|
|
1146
|
+
# 2. Edit .grok/settings.json
|
|
1147
|
+
{
|
|
1148
|
+
"baseURL": "https://api.x.ai/v1",
|
|
1149
|
+
"model": "grok-3-fast",
|
|
1150
|
+
"apiKey": "xai-your-key-here"
|
|
1151
|
+
}
|
|
1152
|
+
|
|
1153
|
+
# 3. Enable in automatosx.config.json
|
|
1154
|
+
"grok": { "enabled": true }
|
|
1155
|
+
|
|
1156
|
+
# 4. Verify
|
|
1157
|
+
ax doctor grok
|
|
1158
|
+
ax providers list
|
|
1159
|
+
```
|
|
1160
|
+
|
|
1161
|
+
**Get X.AI API Key**: https://console.x.ai/api-keys
|
|
1162
|
+
|
|
1163
|
+
#### Option 2: Z.AI GLM 4.6 (Code-Optimized)
|
|
1164
|
+
|
|
1165
|
+
```bash
|
|
1166
|
+
# Edit .grok/settings.json
|
|
1167
|
+
{
|
|
1168
|
+
"baseURL": "https://api.z.ai/api/coding/paas/v4",
|
|
1169
|
+
"model": "glm-4.6",
|
|
1170
|
+
"apiKey": "your-zai-key"
|
|
1171
|
+
}
|
|
1172
|
+
```
|
|
1173
|
+
|
|
1174
|
+
**Get Z.AI API Key**: https://z.ai/developer
|
|
1175
|
+
|
|
1176
|
+
#### Option 3: Self-Hosted GLM 4.6 API Server
|
|
1177
|
+
|
|
1178
|
+
**Use your own local coding system with AutomatosX!**
|
|
1179
|
+
|
|
1180
|
+
You can point AutomatosX to your own GLM 4.6 API server for complete control:
|
|
1181
|
+
|
|
1182
|
+
```bash
|
|
1183
|
+
# Edit .grok/settings.json
|
|
1184
|
+
{
|
|
1185
|
+
"baseURL": "http://localhost:8000/v1", # Your local API server
|
|
1186
|
+
"model": "glm-4.6",
|
|
1187
|
+
"apiKey": "your-local-api-key" # Optional if your server requires it
|
|
1188
|
+
}
|
|
1189
|
+
```
|
|
1190
|
+
|
|
1191
|
+
**Benefits of Self-Hosted:**
|
|
1192
|
+
- 🏠 Complete data privacy - all processing stays local
|
|
1193
|
+
- 💰 No usage costs - run as much as you want
|
|
1194
|
+
- ⚡ Lower latency - no network round trips
|
|
1195
|
+
- 🔧 Full customization - fine-tune the model for your needs
|
|
1196
|
+
- 🔒 Enterprise security - meets corporate requirements
|
|
1197
|
+
|
|
1198
|
+
**Popular GLM 4.6 API Server Implementations:**
|
|
1199
|
+
- [vLLM](https://github.com/vllm-project/vllm) - Fast inference server
|
|
1200
|
+
- [Text Generation Inference](https://github.com/huggingface/text-generation-inference) - HuggingFace's solution
|
|
1201
|
+
- [Ollama](https://ollama.ai) - Easy local deployment
|
|
1202
|
+
- Custom FastAPI/Flask wrapper around GLM 4.6
|
|
1203
|
+
|
|
1204
|
+
**Example Docker Setup:**
|
|
1205
|
+
```bash
|
|
1206
|
+
# Run GLM 4.6 API server locally
|
|
1207
|
+
docker run -d \
|
|
1208
|
+
-p 8000:8000 \
|
|
1209
|
+
-v ~/.cache/huggingface:/root/.cache/huggingface \
|
|
1210
|
+
vllm/vllm-openai:latest \
|
|
1211
|
+
--model THUDM/glm-4-6 \
|
|
1212
|
+
--port 8000
|
|
1213
|
+
|
|
1214
|
+
# Configure AutomatosX to use it
|
|
1215
|
+
# Edit .grok/settings.json with baseURL: "http://localhost:8000/v1"
|
|
1216
|
+
```
|
|
1217
|
+
|
|
1218
|
+
**📄 License Note for Self-Hosted/Commercial Use:**
|
|
1219
|
+
|
|
1220
|
+
AutomatosX is licensed under Apache 2.0 for **non-commercial use**. For commercial use or to remove license restrictions:
|
|
1221
|
+
|
|
1222
|
+
- 💼 **Commercial License**: Visit https://license.defai.digital/automatosx
|
|
1223
|
+
- 📋 **Custom Terms**: Available for enterprise deployments
|
|
1224
|
+
- 🤝 **Volume Discounts**: Contact us for team/organization pricing
|
|
1225
|
+
|
|
1226
|
+
**See [GROK.md](GROK.md) for complete setup guide, including:**
|
|
1227
|
+
- Model comparison (grok-3-fast vs glm-4.6)
|
|
1228
|
+
- Environment variable configuration
|
|
1229
|
+
- Switching between endpoints
|
|
1230
|
+
- Troubleshooting guide
|
|
1231
|
+
- Cost optimization tips
|
|
1232
|
+
|
|
1214
1233
|
---
|
|
1215
1234
|
|
|
1216
1235
|
## 🗺️ Roadmap
|
|
@@ -1366,7 +1385,27 @@ npm run build
|
|
|
1366
1385
|
|
|
1367
1386
|
## 📄 License
|
|
1368
1387
|
|
|
1369
|
-
|
|
1388
|
+
AutomatosX is dual-licensed:
|
|
1389
|
+
|
|
1390
|
+
- **Apache License 2.0** - See [LICENSE](LICENSE) for code licensing
|
|
1391
|
+
- **Commercial License with OpenRAIL-M** - See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) for commercial use and model restrictions
|
|
1392
|
+
|
|
1393
|
+
### TL;DR - When Do You Need a Commercial License?
|
|
1394
|
+
|
|
1395
|
+
**✅ FREE for**:
|
|
1396
|
+
- Research and academic use
|
|
1397
|
+
- Personal projects
|
|
1398
|
+
- Startups with < $2M revenue AND < $2M funding
|
|
1399
|
+
|
|
1400
|
+
**❌ Commercial License Required for**:
|
|
1401
|
+
- Companies with ≥ $2M annual revenue OR ≥ $2M total funding
|
|
1402
|
+
- Competitive products against DEFAI's offerings
|
|
1403
|
+
- SaaS or managed services built on AutomatosX
|
|
1404
|
+
- Commercial redistribution or embedding
|
|
1405
|
+
|
|
1406
|
+
**Learn more**: See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) for full details.
|
|
1407
|
+
|
|
1408
|
+
**Get a commercial license**: https://license.defai.digital/automatox
|
|
1370
1409
|
|
|
1371
1410
|
Copyright 2025 DEFAI Private Limited
|
|
1372
1411
|
|