@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 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 the only AI CLI that combines declarative workflow specs, policy-driven cost optimization, and a persistent AI workforce. Write a YAML spec, and AutomatosX generates your entire project—plans, infrastructure, tests, and execution—while remembering everything and optimizing every API call.
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
  [![npm version](https://img.shields.io/npm/v/@defai.digital/automatosx.svg)](https://www.npmjs.com/package/@defai.digital/automatosx)
8
- [![License](https://img.shields.io/badge/license-Elastic%202.0-orange.svg)](LICENSE)
8
+ [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
9
9
  [![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)
10
10
  [![Tests](https://img.shields.io/badge/tests-2,423+%20passing-brightgreen.svg)](#)
11
11
  [![npm](https://img.shields.io/npm/dt/%40defai.digital%2Fautomatosx.svg?label=total%20downloads&color=blue)](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
  [![Windows](https://img.shields.io/badge/Windows-10+-blue.svg)](https://www.microsoft.com/windows)
14
14
  [![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-blue.svg)](https://ubuntu.com)
15
15
 
16
- **Status**: ✅ **Production Ready** | v7.0.0 | 20 Specialized Agents | Spec-Kit 100% Complete | Policy-Driven Routing | Auto-Generation
16
+ **Status**: ✅ **Production Ready** | v8.3.0 | 20 Specialized Agents | Pure CLI Orchestration | Simplified Architecture
17
17
 
18
- > 🎉 **NEW in v7.0.0**: Unified setup command (`ax setup`), natural language-first design (slash commands removed), enhanced force mode with complete cleanup. See [Migration from v6.x](#migration-from-v6x) for upgrade details.
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
- | 🔍 **Complete Observability** | Trace every routing decision, cost, and latency. Debug with confidence. | Production-grade reliability |
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
- Elastic License 2.0 - See [LICENSE](LICENSE) for details.
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