feature-architect-agent 1.0.11 → 1.0.12

package/README.md

@@ -63,7 +63,17 @@ npm install && npm run build && npm link
 
 ### API Key / Provider Setup
 
-**Option 1: Use FREE local models (Recommended for hackathons!)**
+**Option 1: Use FREE cloud models (Recommended for hackathons!)**
+
+```bash
+# MiniMax M2.5 - FREE tier available!
+export MINIMAX_API_KEY=xxx
+
+# Z AI GLM - FREE tier available!
+export ZAI_API_KEY=xxx
+```
+
+**Option 2: Use FREE local models**
 
 ```bash
 # OpenCode / Ollama - No API key needed!
@@ -71,7 +81,7 @@ export OPENCODE_BASE_URL=http://localhost:11434/v1
 export OPENCODE_MODEL=llama3.2
 ```
 
-**Option 2: Use cloud providers**
+**Option 3: Use cloud providers**
 
 ```bash
 # Gemini (Google)
@@ -87,7 +97,7 @@ export ANTHROPIC_API_KEY=sk-ant-xxx
 **For persistent configuration**, add to `~/.bashrc` or `~/.zshrc`:
 
 ```bash
-echo 'export OPENCODE_BASE_URL=http://localhost:11434/v1' >> ~/.bashrc
+echo 'export MINIMAX_API_KEY=xxx' >> ~/.bashrc
 source ~/.bashrc
 ```
 
@@ -530,14 +540,22 @@ $ feature-architect plan "Add user comments"
 The agent automatically detects which API key is available and uses the appropriate provider. No manual selection needed!
 
 **Priority order:**
-1. `OPENCODE_BASE_URL` → OpenCode/Ollama (FREE - no API key needed!)
-2. `GOOGLE_API_KEY` → Gemini
-3. `OPENAI_API_KEY` → OpenAI (GPT-4, etc.)
-4. `ANTHROPIC_API_KEY` → Claude (Anthropic)
-5. `AI_API_KEY` → Generic fallback
+1. `MINIMAX_API_KEY` → MiniMax M2.5 (FREE - no signup required!)
+2. `ZAI_API_KEY` → Z AI GLM (FREE tier available!)
+3. `OPENCODE_BASE_URL` → OpenCode/Ollama (FREE - local!)
+4. `GOOGLE_API_KEY` → Gemini
+5. `OPENAI_API_KEY` → OpenAI (GPT-4, etc.)
+6. `ANTHROPIC_API_KEY` → Claude (Anthropic)
+7. `AI_API_KEY` → Generic fallback
 
 **Force specific provider:**
 ```bash
+# Use MiniMax (free M2.5 model)
+feature-architect plan "user profile" --provider minimax
+
+# Use Z AI (free GLM models)
+feature-architect plan "user profile" --provider zai
+
 # Use OpenCode (free local models)
 feature-architect plan "user profile" --provider opencode
 
@@ -588,7 +606,7 @@ feature-architect import-context --input team-context.json
 ## 🚦 Getting Started
 
 1. **Install**: `npm install -g feature-architect-agent`
-2. **Set Provider**: `export OPENCODE_BASE_URL=http://localhost:11434/v1` (FREE!)
+2. **Set Provider**: `export MINIMAX_API_KEY=xxx` (FREE!)
 3. **Setup**: `cd your-project && feature-architect init`
 4. **Plan**: `feature-architect plan "your feature here"`
 5. **Implement**: Use the generated plan as your blueprint

package/dist/cli/index.js

@@ -10,7 +10,7 @@ const program = new commander_1.Command();
 program
     .name('feature-architect')
     .description('AI-powered feature planning agent - generate complete technical specifications')
-    .version('1.0.0');
+    .version('1.0.11');
 program
     .command('init')
     .description('Initialize in project (analyze codebase)')
@@ -52,11 +52,11 @@ program
 });
 // Default: show help if no command
 program.on('command:*', () => {
-    (0, logger_js_1.header)('Feature Architect Agent v1.0.0');
+    (0, logger_js_1.header)('Feature Architect Agent v1.0.11');
     (0, logger_js_1.info)('AI-powered feature planning for development teams\n');
     (0, logger_js_1.dim)('Quick start:');
     (0, logger_js_1.dim)('  1. feature-architect init          # Analyze codebase');
-    (0, logger_js_1.dim)('  2. export ANTHROPIC_API_KEY=xxx   # Set API key');
+    (0, logger_js_1.dim)('  2. export MINIMAX_API_KEY=xxx      # Set API key (MiniMax M2.5 - FREE!)');
     (0, logger_js_1.dim)('  3. feature-architect plan "feature"  # Plan feature');
     console.log('');
 });

package/dist/commands/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CAkKf"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC,IAAI,CAAC,CA2Kf"}

package/dist/commands/plan.js

@@ -39,11 +39,16 @@ async function planCommand(feature, options = {}) {
     // Auto-detect if not specified
     if (!provider) {
         // Check for API keys in environment (no built-in keys for security)
-        // Z AI first (free GLM models)
-        if (process.env.ZAI_API_KEY || process.env.ZHIPU_API_KEY) {
+        // MiniMax first (free M2.5 model)
+        if (process.env.MINIMAX_API_KEY) {
+            provider = 'minimax';
+            apiKey = process.env.MINIMAX_API_KEY;
+            // Z AI second (free GLM models)
+        }
+        else if (process.env.ZAI_API_KEY || process.env.ZHIPU_API_KEY) {
             provider = 'zai';
             apiKey = process.env.ZAI_API_KEY || process.env.ZHIPU_API_KEY;
-            // Opencode second (free local models)
+            // Opencode third (free local models)
         }
         else if (process.env.OPENCODE_BASE_URL || process.env.OPENCODE_URL) {
             provider = 'opencode';
@@ -71,13 +76,15 @@ async function planCommand(feature, options = {}) {
             (0, logger_js_1.dim)('You need to set an API key or local LLM to use this tool.');
             (0, logger_js_1.dim)('');
             (0, logger_js_1.dim)('Choose one of these options:');
-            (0, logger_js_1.dim)('  export ZAI_API_KEY=xxx              # For Z AI GLM models (FREE!)');
+            (0, logger_js_1.dim)('  export MINIMAX_API_KEY=xxx           # For MiniMax M2.5 (FREE!)');
+            (0, logger_js_1.dim)('  export ZAI_API_KEY=xxx               # For Z AI GLM models (FREE!)');
             (0, logger_js_1.dim)('  export OPENCODE_BASE_URL=http://localhost:11434/v1  # For OpenCode/Ollama');
             (0, logger_js_1.dim)('  export GOOGLE_API_KEY=xxx           # For Gemini');
             (0, logger_js_1.dim)('  export OPENAI_API_KEY=sk-xxx        # For OpenAI');
             (0, logger_js_1.dim)('  export ANTHROPIC_API_KEY=sk-ant-xxx  # For Claude');
             (0, logger_js_1.dim)('');
             (0, logger_js_1.dim)('Get API keys:');
+            (0, logger_js_1.dim)('  MiniMax: https://www.minimaxi.com/user-center/basic-information/interface-key (M2.5-Free - FREE!)');
             (0, logger_js_1.dim)('  Z AI: https://open.bigmodel.cn/usercenter/apikeys (GLM-4.7-Flash - FREE!)');
             (0, logger_js_1.dim)('  OpenCode/Ollama: Install locally - FREE!');
             (0, logger_js_1.dim)('  Gemini: https://aistudio.google.com/app/apikey');
@@ -111,6 +118,10 @@ async function planCommand(feature, options = {}) {
             provider = 'zai';
             apiKey = process.env.ZAI_API_KEY || process.env.ZHIPU_API_KEY || '';
         }
+        else if (providerLower === 'minimax') {
+            provider = 'minimax';
+            apiKey = process.env.MINIMAX_API_KEY || '';
+        }
         if (!apiKey) {
             (0, logger_js_1.error)(`No API key found for ${provider}`);
             (0, logger_js_1.dim)(`Set it with: export ${provider.toUpperCase()}_API_KEY=xxx`);

package/dist/llm/MiniMax.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MiniMax Provider
+ *
+ * For MiniMax AI models with OpenAI-compatible APIs.
+ * Free models available:
+ * - MiniMax-M2.5-Free (FREE!)
+ * - MiniMax-M2.5
+ * - MiniMax-Text-01
+ * - MiniMax-Audio
+ *
+ * Get API key: https://www.minimaxi.com/user-center/basic-information/interface-key
+ */
+import type { LLMProvider } from './types.js';
+export interface MiniMaxConfig {
+    baseURL?: string;
+    model?: string;
+    groupId?: string;
+}
+export declare class MiniMaxProvider implements LLMProvider {
+    private baseURL;
+    private model;
+    private apiKey;
+    private groupId;
+    constructor(apiKey: string, config?: MiniMaxConfig);
+    generate(prompt: string, options?: {
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<string>;
+    /**
+     * Update the model being used
+     */
+    setModel(model: string): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): {
+        baseURL: string;
+        model: string;
+    };
+}
+//# sourceMappingURL=MiniMax.d.ts.map

package/dist/llm/MiniMax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiniMax.d.ts","sourceRoot":"","sources":["../../src/llm/MiniMax.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAGtB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAkB;IAQtB,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACzD,OAAO,CAAC,MAAM,CAAC;IAuDlB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,SAAS,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAGhD"}

package/dist/llm/MiniMax.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * MiniMax Provider
+ *
+ * For MiniMax AI models with OpenAI-compatible APIs.
+ * Free models available:
+ * - MiniMax-M2.5-Free (FREE!)
+ * - MiniMax-M2.5
+ * - MiniMax-Text-01
+ * - MiniMax-Audio
+ *
+ * Get API key: https://www.minimaxi.com/user-center/basic-information/interface-key
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiniMaxProvider = void 0;
+class MiniMaxProvider {
+    baseURL;
+    model;
+    apiKey;
+    groupId;
+    constructor(apiKey, config = {}) {
+        this.baseURL = config.baseURL || process.env.MINIMAX_BASE_URL || 'https://api.minimax.chat/v1';
+        this.model = config.model || process.env.MINIMAX_MODEL || 'MiniMax-M2.5-Free';
+        this.apiKey = apiKey || process.env.MINIMAX_API_KEY || '';
+        this.groupId = config.groupId || process.env.MINIMAX_GROUP_ID || '';
+    }
+    async generate(prompt, options = {}) {
+        const temperature = options.temperature ?? 0.7;
+        const maxTokens = options.maxTokens ?? 8000;
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`
+            };
+            // MiniMax requires Group ID header
+            if (this.groupId) {
+                headers['GroupId'] = this.groupId;
+            }
+            const response = await fetch(`${this.baseURL}/text/chatcompletion_v2`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    model: this.model,
+                    messages: [
+                        {
+                            role: 'user',
+                            content: prompt
+                        }
+                    ],
+                    temperature,
+                    tokens_to_generate: maxTokens,
+                    stream: false
+                })
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`MiniMax API error: ${response.status} ${response.statusText}\n${errorText}`);
+            }
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(`MiniMax API error: ${data.error.message || JSON.stringify(data.error)}`);
+            }
+            // MiniMax response format
+            return data.choices?.[0]?.message?.content || data.reply || '';
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`MiniMax request failed: ${error.message}`);
+            }
+            throw new Error('MiniMax request failed with unknown error');
+        }
+    }
+    /**
+     * Update the model being used
+     */
+    setModel(model) {
+        this.model = model;
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { baseURL: this.baseURL, model: this.model };
+    }
+}
+exports.MiniMaxProvider = MiniMaxProvider;

package/dist/llm/factory.d.ts

@@ -1,5 +1,5 @@
 import type { LLMProvider } from './types.js';
-export type ProviderType = 'claude' | 'anthropic' | 'openai' | 'gemini' | 'google' | 'opencode' | 'ollama' | 'zai' | 'zhipu';
+export type ProviderType = 'claude' | 'anthropic' | 'openai' | 'gemini' | 'google' | 'opencode' | 'ollama' | 'zai' | 'zhipu' | 'minimax';
 export interface ProviderConfig {
     provider: ProviderType;
     apiKey?: string;

package/dist/llm/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAE7H,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAoDlE"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/llm/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzI,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CA8DlE"}

package/dist/llm/factory.js

@@ -6,6 +6,7 @@ const OpenAI_js_1 = require("./OpenAI.js");
 const Gemini_js_1 = require("./Gemini.js");
 const Opencode_js_1 = require("./Opencode.js");
 const ZAI_js_1 = require("./ZAI.js");
+const MiniMax_js_1 = require("./MiniMax.js");
 /**
  * Normalize provider name - accepts both 'claude'/'anthropic' and 'gemini'/'google'
  */
@@ -40,6 +41,12 @@ function createProvider(config) {
             return new ZAI_js_1.ZAIProvider(apiKey || process.env.ZAI_API_KEY || '', {
                 model: config.model || process.env.ZAI_MODEL || 'GLM-4.7-Flash'
             });
+        case 'minimax':
+            return new MiniMax_js_1.MiniMaxProvider(apiKey || process.env.MINIMAX_API_KEY || '', {
+                baseURL: process.env.MINIMAX_BASE_URL || 'https://api.minimax.chat/v1',
+                groupId: process.env.MINIMAX_GROUP_ID || '',
+                model: config.model || process.env.MINIMAX_MODEL || 'MiniMax-M2.5-Free'
+            });
         case 'ollama':
             throw new Error('Ollama provider not yet implemented');
         default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feature-architect-agent",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "AI-powered feature planning agent - generates complete technical specifications",
   "main": "dist/index.js",
   "bin": {