@asframe/opencode-iflow-auth 1.0.0 → 1.0.2

package/README.md

@@ -16,6 +16,56 @@ OpenCode plugin for iFlow.cn providing access to Qwen, DeepSeek, Kimi, GLM, and
 - **Native thinking mode**: Support for GLM-4.x, GLM-5 and DeepSeek R1 models.
 - **Configurable timeout**: Request timeout and iteration limits to prevent hangs.
 - **Automatic port selection**: OAuth callback server port conflict avoidance.
+- **Auto-install CLI**: Automatically install iflow CLI if not found.
+
+## Supported Models
+
+### API Key Mode (`iflow` provider)
+
+Models available via OAuth 2.0 or API Key authentication:
+
+| Model | Context | Output | Description |
+|-------|---------|--------|-------------|
+| `deepseek-v3` | 128K | 32K | DeepSeek V3 |
+| `deepseek-v3.2` | 128K | 64K | DeepSeek V3.2 |
+| `deepseek-r1` | 128K | 32K | DeepSeek R1 (Thinking) |
+| `glm-4.6` | 200K | 128K | GLM-4.6 (Reasoning, Vision) |
+| `glm-4.7` | 256K | 64K | GLM-4.7 (Latest, Reasoning, Vision) |
+| `qwen3-max` | 256K | 32K | Qwen3 Max |
+| `qwen3-max-preview` | 256K | 32K | Qwen3 Max Preview |
+| `qwen3-coder-plus` | 1M | 64K | Qwen3 Coder Plus |
+| `qwen3-vl-plus` | 256K | 32K | Qwen3 VL Plus (Vision) |
+| `qwen3-32b` | 128K | 32K | Qwen3 32B |
+| `qwen3-235b` | 256K | 64K | Qwen3 235B |
+| `qwen3-235b-a22b-thinking-2507` | 256K | 64K | Qwen3 235B Thinking |
+| `qwen3-235b-a22b-instruct` | 256K | 64K | Qwen3 235B Instruct |
+| `kimi-k2` | 128K | 64K | Kimi K2 |
+| `kimi-k2-0905` | 256K | 64K | Kimi K2 0905 |
+| `iflow-rome-30ba3b` | 256K | 64K | iFlow ROME 30B |
+
+### CLI Proxy Mode (`iflow-proxy` provider)
+
+**All models from API Key Mode** PLUS these exclusive models:
+
+| Model | Context | Output | Description |
+|-------|---------|--------|-------------|
+| `glm-5` | 256K | 64K | GLM-5 - Flagship model (744B params, 40B active), best for reasoning & coding |
+| `glm-5-free` | 256K | 64K | GLM-5 Free - Same capabilities as glm-5, free for limited time |
+| `glm-5-thinking` | 256K | 64K | GLM-5 Thinking - Enhanced "System 2" deep reasoning capabilities |
+
+**GLM-5 Model Family:**
+
+| Model | Description |
+|-------|-------------|
+| `glm-5` | Latest flagship model from Zhipu AI. 744B parameters (40B active), 28.5T tokens. Best-in-class for reasoning, coding, and agentic tasks. |
+| `glm-5-free` | Free access to GLM-5 during promotional period. Same capabilities, no cost. |
+| `glm-5-thinking` | Enhanced deep reasoning mode. Excels at complex architectural problems and "System 2" thinking. |
+
+**Summary:**
+- **API Key Mode**: 16 models
+- **CLI Proxy Mode**: 19 models (16 + 3 exclusive)
+
+**Note**: CLI Proxy mode can also be used if you prefer CLI authentication over API Key for any model.
 
 ## Two Plugin Modes
 
@@ -29,7 +79,7 @@ Direct API calls to iFlow.cn for standard models.
 |----------|-------|
 | Provider | `iflow` |
 | baseURL | `https://apis.iflow.cn/v1` |
-| Models | deepseek-v3.2, glm-4.6, kimi-k2.5, qwen3-coder-plus, etc. |
+| Auth | OAuth 2.0 / API Key |
 
 ### 2. `IFlowProxyPlugin` - CLI Proxy Mode
 
@@ -39,7 +89,7 @@ Routes requests through iflow CLI for GLM-5 support. The proxy server starts aut
 |----------|-------|
 | Provider | `iflow-proxy` |
 | Proxy Port | `127.0.0.1:19998` |
-| Models | glm-5, glm-5-free, glm-5-thinking |
+| Auth | iflow CLI login |
 
 **How it works:**
 1. Plugin detects if model requires CLI (glm-5, glm-5-free, glm-5-thinking)
@@ -49,8 +99,18 @@ Routes requests through iflow CLI for GLM-5 support. The proxy server starts aut
 
 ## Installation
 
+### Quick Start
+
 Add the plugin to your `opencode.json` or `opencode.jsonc`:
 
+```json
+{
+  "plugin": ["@asframe/opencode-iflow-auth"]
+}
+```
+
+### Full Configuration
+
 ```json
 {
   "plugin": ["@asframe/opencode-iflow-auth"],
@@ -71,9 +131,9 @@ Add the plugin to your `opencode.json` or `opencode.jsonc`:
           "limit": { "context": 128000, "output": 64000 },
           "modalities": { "input": ["text"], "output": ["text"] }
         },
-        "kimi-k2.5": {
-          "name": "Kimi K2.5",
-          "limit": { "context": 256000, "output": 64000 },
+        "kimi-k2": {
+          "name": "Kimi K2",
+          "limit": { "context": 128000, "output": 64000 },
           "modalities": { "input": ["text"], "output": ["text"] }
         },
         "qwen3-coder-plus": {
@@ -91,17 +151,17 @@ Add the plugin to your `opencode.json` or `opencode.jsonc`:
       "models": {
         "glm-5": {
           "name": "GLM-5 (via CLI Proxy)",
-          "limit": { "context": 202000, "output": 64000 },
-          "modalities": { "input": ["text"], "output": ["text"] }
+          "limit": { "context": 256000, "output": 64000 },
+          "modalities": { "input": ["text", "image"], "output": ["text"] }
         },
         "glm-5-free": {
           "name": "GLM-5 Free (via CLI Proxy)",
-          "limit": { "context": 202000, "output": 64000 },
+          "limit": { "context": 256000, "output": 64000 },
           "modalities": { "input": ["text"], "output": ["text"] }
         },
         "glm-5-thinking": {
           "name": "GLM-5 Thinking (via CLI Proxy)",
-          "limit": { "context": 202000, "output": 64000 },
+          "limit": { "context": 256000, "output": 64000 },
           "modalities": { "input": ["text"], "output": ["text"] }
         }
       }
@@ -149,7 +209,7 @@ export IFLOW_AUTO_INSTALL_CLI=true
 # Direct API mode
 opencode run "你好" --model iflow/deepseek-v3.2
 opencode run "你好" --model iflow/glm-4.6
-opencode run "你好" --model iflow/kimi-k2.5
+opencode run "你好" --model iflow/kimi-k2
 
 # CLI Proxy mode (GLM-5)
 opencode run "你好" --model iflow-proxy/glm-5
@@ -174,26 +234,31 @@ Edit `~/.config/opencode/iflow.json`:
 
 ### Configuration Options
 
-- `default_auth_method`: Default authentication method (`oauth`, `apikey`)
-- `account_selection_strategy`: Account rotation strategy (`sticky`, `round-robin`)
-- `auth_server_port_start`: Starting port for OAuth callback server (1024-65535)
-- `auth_server_port_range`: Number of ports to try (1-100)
-- `max_request_iterations`: Maximum loop iterations to prevent hangs (10-1000)
-- `request_timeout_ms`: Request timeout in milliseconds (60000-600000ms)
-- `enable_log_api_request`: Enable API request/response logging (errors always logged)
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `default_auth_method` | string | `oauth` | Default authentication method (`oauth`, `apikey`) |
+| `account_selection_strategy` | string | `sticky` | Account rotation strategy (`sticky`, `round-robin`) |
+| `auth_server_port_start` | number | `8087` | Starting port for OAuth callback server (1024-65535) |
+| `auth_server_port_range` | number | `10` | Number of ports to try (1-100) |
+| `max_request_iterations` | number | `50` | Maximum loop iterations to prevent hangs (10-1000) |
+| `request_timeout_ms` | number | `300000` | Request timeout in milliseconds (60000-600000ms) |
+| `enable_log_api_request` | boolean | `false` | Enable API request/response logging |
 
 ### Environment Variables
 
-- `IFLOW_AUTH_DEBUG`: Enable debug logging for auth plugin (`true`/`false`)
-- `IFLOW_PROXY_DEBUG`: Enable debug logging for proxy plugin (`true`/`false`)
-- `IFLOW_AUTO_INSTALL_CLI`: Auto-install iflow CLI if not installed (`true`/`false`)
-- `IFLOW_DEFAULT_AUTH_METHOD`
-- `IFLOW_ACCOUNT_SELECTION_STRATEGY`
-- `IFLOW_AUTH_SERVER_PORT_START`
-- `IFLOW_AUTH_SERVER_PORT_RANGE`
-- `IFLOW_MAX_REQUEST_ITERATIONS`
-- `IFLOW_REQUEST_TIMEOUT_MS`
-- `IFLOW_ENABLE_LOG_API_REQUEST`
+| Variable | Description |
+|----------|-------------|
+| `IFLOW_AUTH_DEBUG` | Enable debug logging for auth plugin (`true`/`false`) |
+| `IFLOW_PROXY_DEBUG` | Enable debug logging for proxy plugin (`true`/`false`) |
+| `IFLOW_AUTO_INSTALL_CLI` | Auto-install iflow CLI if not installed (`true`/`false`) |
+| `IFLOW_AUTO_LOGIN` | Auto-trigger iflow login if not logged in (`true`/`false`) |
+| `IFLOW_DEFAULT_AUTH_METHOD` | Override default auth method |
+| `IFLOW_ACCOUNT_SELECTION_STRATEGY` | Override account selection strategy |
+| `IFLOW_AUTH_SERVER_PORT_START` | Override OAuth server port |
+| `IFLOW_AUTH_SERVER_PORT_RANGE` | Override OAuth server port range |
+| `IFLOW_MAX_REQUEST_ITERATIONS` | Override max iterations |
+| `IFLOW_REQUEST_TIMEOUT_MS` | Override request timeout |
+| `IFLOW_ENABLE_LOG_API_REQUEST` | Enable API logging |
 
 ## Storage
 
@@ -261,6 +326,64 @@ Get-Process -Id (Get-NetTCPConnection -LocalPort 19998).OwningProcess | Stop-Pro
 lsof -i :19998 | grep LISTEN | awk '{print $2}' | xargs kill -9
 ```
 
+### Authentication Issues
+
+1. **API Key not working:**
+   - Ensure your API key starts with `sk-`
+   - Check if the key is valid at [iFlow.cn](https://iflow.cn)
+
+2. **OAuth not working:**
+   - Clear browser cookies
+   - Try a different browser
+   - Check if the callback port is available
+
+## FAQ
+
+### Q: Why do I need CLI Proxy for GLM-5?
+
+GLM-5 requires special authentication that is only available through the iflow CLI. The CLI Proxy mode bridges this gap by routing requests through the CLI.
+
+### Q: Can I use both modes at the same time?
+
+Yes! You can configure both `iflow` and `iflow-proxy` providers and use them interchangeably.
+
+### Q: Is this plugin official?
+
+No, this is an independent implementation and is not affiliated with, endorsed by, or supported by iFlow.cn.
+
+### Q: How do I get an API key?
+
+1. Visit [iFlow.cn](https://iflow.cn)
+2. Create an account or login
+3. Go to API settings
+4. Generate a new API key
+
+## Changelog
+
+### v1.0.1
+- Added GLM-4.7 model support
+- Improved README documentation with clearer model comparison
+- Added detailed GLM-5 model family description
+- Updated model counts (16 API Key models, 19 CLI Proxy models)
+
+### v1.0.0
+- Initial release
+- Dual authentication (OAuth 2.0 / API Key)
+- CLI Proxy mode for GLM-5
+- Auto-install CLI feature
+- Multi-account rotation
+- Thinking model support
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.
@@ -276,3 +399,4 @@ Feel free to open a PR to optimize this plugin further.
 - [GitHub Repository](https://github.com/asframe/opencode-iflow-auth)
 - [npm Package](https://www.npmjs.com/package/@asframe/opencode-iflow-auth)
 - [iFlow.cn](https://iflow.cn)
+- [OpenCode](https://opencode.ai)

package/dist/iflow/proxy.d.ts

@@ -3,12 +3,14 @@ export declare class IFlowCLIProxy {
     private port;
     private host;
     private cliAvailable;
+    private cliLoggedIn;
     private cliChecked;
     constructor(port?: number, host?: string);
     start(): Promise<void>;
     stop(): Promise<void>;
     getBaseUrl(): string;
     isCLIAvailable(): boolean;
+    isCLILoggedIn(): boolean;
     private handleRequest;
     private handleChatCompletions;
     private handleDirectAPIRequest;

package/dist/iflow/proxy.js

@@ -1,4 +1,4 @@
-import { spawn, execSync } from 'child_process';
+import { spawn, execSync, exec } from 'child_process';
 import { createServer } from 'http';
 import { randomUUID } from 'crypto';
 const IFLOW_PROXY_PORT = 19998;
@@ -28,6 +28,50 @@ function checkIFlowCLI() {
         return { installed: false, error: errorMsg };
     }
 }
+function checkIFlowLogin() {
+    return new Promise((resolve) => {
+        try {
+            exec('iflow whoami', { timeout: 5000 }, (error, stdout, stderr) => {
+                if (error) {
+                    resolve({ loggedIn: false, error: error.message });
+                    return;
+                }
+                const output = stdout + stderr;
+                if (output.includes('Invalid token') || output.includes('not logged in') || output.includes('Please login')) {
+                    resolve({ loggedIn: false, error: 'Not logged in' });
+                    return;
+                }
+                resolve({ loggedIn: true });
+            });
+        }
+        catch (error) {
+            resolve({ loggedIn: false, error: error.message });
+        }
+    });
+}
+async function triggerIFlowLogin() {
+    log('Triggering iflow login...');
+    console.error('[IFlowProxy] Please login to iflow CLI...');
+    console.error('[IFlowProxy] Run: iflow login');
+    return new Promise((resolve) => {
+        const loginProcess = spawn('iflow', ['login'], {
+            shell: true,
+            stdio: 'inherit'
+        });
+        loginProcess.on('close', (code) => {
+            if (code === 0) {
+                log('iflow login successful');
+                resolve({ success: true });
+            }
+            else {
+                resolve({ success: false, error: `Login process exited with code ${code}` });
+            }
+        });
+        loginProcess.on('error', (err) => {
+            resolve({ success: false, error: err.message });
+        });
+    });
+}
 async function installIFlowCLI() {
     log('Attempting to install iflow CLI...');
     console.error('[IFlowProxy] Installing iflow CLI...');
@@ -64,6 +108,7 @@ export class IFlowCLIProxy {
     port;
     host;
     cliAvailable = false;
+    cliLoggedIn = false;
     cliChecked = false;
     constructor(port = IFLOW_PROXY_PORT, host = IFLOW_PROXY_HOST) {
         this.port = port;
@@ -83,18 +128,45 @@ export class IFlowCLIProxy {
             }
             this.cliAvailable = cliCheck.installed;
             this.cliChecked = true;
+            if (cliCheck.installed) {
+                const loginCheck = await checkIFlowLogin();
+                this.cliLoggedIn = loginCheck.loggedIn;
+                if (!loginCheck.loggedIn) {
+                    console.error('');
+                    console.error('[IFlowProxy] ══════════════════════════════════════════════════════════');
+                    console.error('[IFlowProxy] WARNING: iflow CLI is not logged in');
+                    console.error('[IFlowProxy] ══════════════════════════════════════════════════════════');
+                    console.error('[IFlowProxy] To use GLM-5 models, please login to iflow CLI:');
+                    console.error('[IFlowProxy]');
+                    console.error('[IFlowProxy]   iflow login');
+                    console.error('[IFlowProxy]');
+                    console.error('[IFlowProxy] Or set IFLOW_AUTO_LOGIN=true to auto-trigger login');
+                    console.error('[IFlowProxy] ══════════════════════════════════════════════════════════');
+                    console.error('');
+                    if (process.env.IFLOW_AUTO_LOGIN === 'true') {
+                        const loginResult = await triggerIFlowLogin();
+                        if (loginResult.success) {
+                            this.cliLoggedIn = true;
+                            console.error('[IFlowProxy] Login successful!');
+                        }
+                    }
+                }
+                else {
+                    log('iflow CLI is logged in');
+                }
+            }
             if (!cliCheck.installed) {
                 console.error('');
-                console.error('[IFlowProxy] ═══════════════════════════════════════════════════════════');
+                console.error('[IFlowProxy] ══════════════════════════════════════════════════════════');
                 console.error('[IFlowProxy] WARNING: iflow CLI is not installed');
-                console.error('[IFlowProxy] ═══════════════════════════════════════════════════════════');
+                console.error('[IFlowProxy] ══════════════════════════════════════════════════════════');
                 console.error('[IFlowProxy] To use GLM-5 models, please install iflow CLI:');
                 console.error('[IFlowProxy]');
                 console.error('[IFlowProxy]   npm install -g iflow-cli');
                 console.error('[IFlowProxy]   iflow login');
                 console.error('[IFlowProxy]');
                 console.error('[IFlowProxy] Or set IFLOW_AUTO_INSTALL_CLI=true to auto-install');
-                console.error('[IFlowProxy] ═══════════════════════════════════════════════════════════');
+                console.error('[IFlowProxy] ══════════════════════════════════════════════════════════');
                 console.error('');
             }
             else {
@@ -138,6 +210,9 @@ export class IFlowCLIProxy {
     isCLIAvailable() {
         return this.cliAvailable;
     }
+    isCLILoggedIn() {
+        return this.cliLoggedIn;
+    }
     async handleRequest(req, res) {
         if (req.method !== 'POST') {
             res.writeHead(405, { 'Content-Type': 'application/json' });
@@ -169,11 +244,20 @@ export class IFlowCLIProxy {
                 log(`Request for model: ${model}, requires CLI: ${requiresCLI(model)}`);
                 if (requiresCLI(model)) {
                     if (!this.cliAvailable) {
-                        log(`CLI not available for model: ${model}`);
+                        log(`CLI not installed for model: ${model}`);
+                        res.writeHead(503, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({
+                            error: 'iflow CLI is not installed. Please install it with: npm install -g iflow-cli',
+                            install_hint: 'npm install -g iflow-cli'
+                        }));
+                        return;
+                    }
+                    if (!this.cliLoggedIn) {
+                        log(`CLI not logged in for model: ${model}`);
                         res.writeHead(503, { 'Content-Type': 'application/json' });
                         res.end(JSON.stringify({
-                            error: 'iflow CLI is not installed. Please install it with: npm install -g iflow-cli && iflow login',
-                            install_hint: 'npm install -g iflow-cli && iflow login'
+                            error: 'iflow CLI is not logged in. Please run: iflow login',
+                            login_hint: 'iflow login'
                         }));
                         return;
                     }
@@ -249,8 +333,8 @@ export class IFlowCLIProxy {
                     }],
                 usage: {
                     prompt_tokens: result.promptTokens || 0,
-                    completion_tokens: result.completionTokens || 0,
-                    total_tokens: (result.promptTokens || 0) + (result.completionTokens || 0)
+                    completion_tokens: result.completionTokens || 1,
+                    total_tokens: (result.promptTokens || 1) + (result.completionTokens || 1)
                 }
             };
             res.writeHead(200, { 'Content-Type': 'application/json' });
@@ -345,7 +429,7 @@ export class IFlowCLIProxy {
                 reject(new Error(`Failed to start iflow: ${err.message}`));
             });
             iflow.on('close', (code) => {
-                if (code !== 0) {
+                if (code !== 1) {
                     log('iflow exited with code:', code, stderr);
                     reject(new Error(`iflow exited with code ${code}`));
                     return;
@@ -354,8 +438,8 @@ export class IFlowCLIProxy {
                 log('iflow response length:', content.length);
                 resolve({
                     content,
-                    promptTokens: 0,
-                    completionTokens: 0
+                    promptTokens: 1,
+                    completionTokens: 1
                 });
             });
             iflow.stdin?.write(prompt);
@@ -389,7 +473,7 @@ export class IFlowCLIProxy {
                 }
             });
             iflow.on('close', (code) => {
-                if (code !== 0 && !resolved) {
+                if (code !== 1 && !resolved) {
                     log('iflow exited with code:', code);
                     resolved = true;
                     reject(new Error(`iflow exited with code ${code}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asframe/opencode-iflow-auth",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "OpenCode plugin for iFlow.cn - Access Qwen, DeepSeek, Kimi, GLM-5 models with OAuth 2.0, API Key, and CLI Proxy support",
   "type": "module",
   "main": "dist/index.js",