opencode-qwencode-auth 1.0.1 → 1.2.0

package/README.md

@@ -8,7 +8,7 @@
   <img src="assets/screenshot.png" alt="OpenCode with Qwen Code" width="800">
 </p>
 
-**Authenticate OpenCode CLI with your qwen.ai account.** This plugin enables you to use Qwen3-Coder models with **2,000 free requests per day** - no API key or credit card required!
+**Authenticate OpenCode CLI with your qwen.ai account.** This plugin enables you to use Qwen models (Coder, Max, Plus and more) with **2,000 free requests per day** - no API key or credit card required!
 
 [🇧🇷 Leia em Português](./README.pt-BR.md)
 
@@ -69,22 +69,35 @@ Select **"Qwen Code (qwen.ai OAuth)"**
 
 ## 🎯 Available Models
 
+### Coding Models
+
 | Model | Context | Max Output | Best For |
 |-------|---------|------------|----------|
 | `qwen3-coder-plus` | 1M tokens | 64K tokens | Complex coding tasks |
-| `qwen3-coder-flash` | 1M tokens | 64K tokens | Fast responses |
+| `qwen3-coder-flash` | 1M tokens | 64K tokens | Fast coding responses |
+
+### General Purpose Models
+
+| Model | Context | Max Output | Reasoning | Best For |
+|-------|---------|------------|-----------|----------|
+| `qwen3-max` | 256K tokens | 64K tokens | No | Flagship model, complex reasoning and tool use |
+| `qwen-plus-latest` | 128K tokens | 16K tokens | Yes | Balanced quality-speed with thinking mode |
+| `qwen3-235b-a22b` | 128K tokens | 32K tokens | Yes | Largest open-weight MoE with thinking mode |
+| `qwen-flash` | 1M tokens | 8K tokens | No | Ultra-fast, low-cost simple tasks |
 
 ### Using a specific model
 
 ```bash
 opencode --provider qwen-code --model qwen3-coder-plus
+opencode --provider qwen-code --model qwen3-max
+opencode --provider qwen-code --model qwen-plus-latest
 ```
 
 ## ⚙️ How It Works
 
 ```
 ┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
-│   OpenCode CLI  │────▶│  qwen.ai OAuth   │────▶│  Qwen3-Coder    │
+│   OpenCode CLI  │────▶│  qwen.ai OAuth   │────▶│  Qwen Models    │
 │                 │◀────│  (Device Flow)   │◀────│  API            │
 └─────────────────┘     └──────────────────┘     └─────────────────┘
 ```

package/README.pt-BR.md

@@ -8,7 +8,7 @@
   <img src="assets/screenshot.png" alt="OpenCode com Qwen Code" width="800">
 </p>
 
-**Autentique o OpenCode CLI com sua conta qwen.ai.** Este plugin permite usar modelos Qwen3-Coder com **2.000 requisições gratuitas por dia** - sem API key ou cartão de crédito!
+**Autentique o OpenCode CLI com sua conta qwen.ai.** Este plugin permite usar modelos Qwen (Coder, Max, Plus e mais) com **2.000 requisições gratuitas por dia** - sem API key ou cartão de crédito!
 
 [🇺🇸 Read in English](./README.md)
 
@@ -69,22 +69,35 @@ Selecione **"Qwen Code (qwen.ai OAuth)"**
 
 ## 🎯 Modelos Disponíveis
 
+### Modelos de Código
+
 | Modelo | Contexto | Max Output | Melhor Para |
 |--------|----------|------------|-------------|
 | `qwen3-coder-plus` | 1M tokens | 64K tokens | Tarefas complexas de código |
-| `qwen3-coder-flash` | 1M tokens | 64K tokens | Respostas rápidas |
+| `qwen3-coder-flash` | 1M tokens | 64K tokens | Respostas rápidas de código |
+
+### Modelos de Propósito Geral
+
+| Modelo | Contexto | Max Output | Reasoning | Melhor Para |
+|--------|----------|------------|-----------|-------------|
+| `qwen3-max` | 256K tokens | 64K tokens | Não | Modelo flagship, raciocínio complexo e tool use |
+| `qwen-plus-latest` | 128K tokens | 16K tokens | Sim | Equilíbrio qualidade-velocidade com thinking mode |
+| `qwen3-235b-a22b` | 128K tokens | 32K tokens | Sim | Maior modelo open-weight MoE com thinking mode |
+| `qwen-flash` | 1M tokens | 8K tokens | Não | Ultra-rápido, baixo custo para tarefas simples |
 
 ### Usando um modelo específico
 
 ```bash
 opencode --provider qwen-code --model qwen3-coder-plus
+opencode --provider qwen-code --model qwen3-max
+opencode --provider qwen-code --model qwen-plus-latest
 ```
 
 ## ⚙️ Como Funciona
 
 ```
 ┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
-│   OpenCode CLI  │────▶│  qwen.ai OAuth   │────▶│  Qwen3-Coder    │
+│   OpenCode CLI  │────▶│  qwen.ai OAuth   │────▶│  Qwen Models    │
 │                 │◀────│  (Device Flow)   │◀────│  API            │
 └─────────────────┘     └──────────────────┘     └─────────────────┘
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-qwencode-auth",
-  "version": "1.0.1",
-  "description": "Qwen OAuth authentication plugin for OpenCode - Access Qwen3-Coder models with your qwen.ai account",
+  "version": "1.2.0",
+  "description": "Qwen OAuth authentication plugin for OpenCode - Access Qwen AI models (Coder, Max, Plus and more) with your qwen.ai account",
   "module": "index.ts",
   "type": "module",
   "scripts": {
@@ -14,6 +14,9 @@
     "qwen",
     "qwen-code",
     "qwen3-coder",
+    "qwen3-max",
+    "qwen-plus",
+    "qwen-flash",
     "oauth",
     "authentication",
     "ai",

package/src/constants.ts

@@ -35,14 +35,16 @@ export const QWEN_API_CONFIG = {
 export const CALLBACK_PORT = 14561;
 
 // Available Qwen models through OAuth
-// Baseado nos modelos disponíveis no qwen-code
+// Baseado nos modelos disponíveis no qwen-code + modelos gerais via portal.qwen.ai
 export const QWEN_MODELS = {
+  // --- Coding Models ---
   'qwen3-coder-plus': {
     id: 'qwen3-coder-plus',
     name: 'Qwen3 Coder Plus',
     contextWindow: 1048576, // 1M tokens
     maxOutput: 65536, // 64K tokens
     description: 'Most capable Qwen coding model with 1M context window',
+    reasoning: false,
     cost: { input: 0, output: 0 }, // Free via OAuth
   },
   'qwen3-coder-flash': {
@@ -51,6 +53,44 @@ export const QWEN_MODELS = {
     contextWindow: 1048576,
     maxOutput: 65536,
     description: 'Faster Qwen coding model for quick responses',
+    reasoning: false,
+    cost: { input: 0, output: 0 },
+  },
+  // --- General Purpose Models ---
+  'qwen3-max': {
+    id: 'qwen3-max',
+    name: 'Qwen3 Max',
+    contextWindow: 262144, // 256K tokens
+    maxOutput: 65536, // 64K tokens
+    description: 'Flagship ~1T parameter MoE model, best for complex reasoning and tool use',
+    reasoning: false,
+    cost: { input: 0, output: 0 },
+  },
+  'qwen-plus-latest': {
+    id: 'qwen-plus-latest',
+    name: 'Qwen Plus',
+    contextWindow: 131072, // 128K tokens
+    maxOutput: 16384, // 16K tokens
+    description: 'Balanced model with thinking mode, good quality-speed tradeoff',
+    reasoning: true,
+    cost: { input: 0, output: 0 },
+  },
+  'qwen3-235b-a22b': {
+    id: 'qwen3-235b-a22b',
+    name: 'Qwen3 235B-A22B',
+    contextWindow: 131072, // 128K tokens
+    maxOutput: 32768, // 32K tokens
+    description: 'Largest open-weight Qwen3 MoE model with thinking mode',
+    reasoning: true,
+    cost: { input: 0, output: 0 },
+  },
+  'qwen-flash': {
+    id: 'qwen-flash',
+    name: 'Qwen Flash',
+    contextWindow: 1048576, // 1M tokens
+    maxOutput: 8192, // 8K tokens
+    description: 'Ultra-fast and low-cost model for simple tasks',
+    reasoning: false,
     cost: { input: 0, output: 0 },
   },
 } as const;

package/src/errors.ts

@@ -0,0 +1,75 @@
+/**
+ * Erros customizados do plugin Qwen Auth
+ *
+ * Fornece mensagens amigáveis para o usuário em vez de JSON bruto da API.
+ * Detalhes técnicos só aparecem com OPENCODE_QWEN_DEBUG=1.
+ */
+
+const REAUTH_HINT =
+  'Execute "npx opencode-qwencode-auth" ou "qwen-code auth login" para re-autenticar.';
+
+// ============================================
+// Erro de Autenticação
+// ============================================
+
+export type AuthErrorKind = 'token_expired' | 'refresh_failed' | 'auth_required';
+
+const AUTH_MESSAGES: Record<AuthErrorKind, string> = {
+  token_expired: `[Qwen] Token expirado. ${REAUTH_HINT}`,
+  refresh_failed: `[Qwen] Falha ao renovar token. ${REAUTH_HINT}`,
+  auth_required: `[Qwen] Autenticacao necessaria. ${REAUTH_HINT}`,
+};
+
+export class QwenAuthError extends Error {
+  public readonly kind: AuthErrorKind;
+  public readonly technicalDetail?: string;
+
+  constructor(kind: AuthErrorKind, technicalDetail?: string) {
+    super(AUTH_MESSAGES[kind]);
+    this.name = 'QwenAuthError';
+    this.kind = kind;
+    this.technicalDetail = technicalDetail;
+  }
+}
+
+// ============================================
+// Erro de API
+// ============================================
+
+function classifyApiStatus(statusCode: number): string {
+  if (statusCode === 401 || statusCode === 403) {
+    return `[Qwen] Token invalido ou expirado. ${REAUTH_HINT}`;
+  }
+  if (statusCode === 429) {
+    return '[Qwen] Limite de requisicoes atingido. Aguarde alguns minutos antes de tentar novamente.';
+  }
+  if (statusCode >= 500) {
+    return `[Qwen] Servidor Qwen indisponivel (erro ${statusCode}). Tente novamente em alguns minutos.`;
+  }
+  return `[Qwen] Erro na API Qwen (${statusCode}). Verifique sua conexao e tente novamente.`;
+}
+
+export class QwenApiError extends Error {
+  public readonly statusCode: number;
+  public readonly technicalDetail?: string;
+
+  constructor(statusCode: number, technicalDetail?: string) {
+    super(classifyApiStatus(statusCode));
+    this.name = 'QwenApiError';
+    this.statusCode = statusCode;
+    this.technicalDetail = technicalDetail;
+  }
+}
+
+// ============================================
+// Helper de log condicional
+// ============================================
+
+/**
+ * Loga detalhes técnicos apenas quando debug está ativo.
+ */
+export function logTechnicalDetail(detail: string): void {
+  if (process.env.OPENCODE_QWEN_DEBUG === '1') {
+    console.debug('[Qwen Debug]', detail);
+  }
+}

package/src/index.ts

@@ -23,6 +23,9 @@ import {
   tokenResponseToCredentials,
   refreshAccessToken,
 } from './qwen/oauth.js';
+import { logTechnicalDetail } from './errors.js';
+export { QwenAuthError, QwenApiError } from './errors.js';
+export type { AuthErrorKind } from './errors.js';
 
 // ============================================
 // Helpers
@@ -102,14 +105,25 @@ export const QwenAuthPlugin = async (_input: unknown) => {
             accessToken = refreshed.accessToken;
             saveCredentials(refreshed);
           } catch (e) {
-            console.error('[Qwen] Token refresh failed:', e);
+            const detail = e instanceof Error ? e.message : String(e);
+            logTechnicalDetail(`Token refresh falhou: ${detail}`);
+            // Não continuar com token expirado - tentar fallback
+            accessToken = undefined;
           }
         }
 
         // Fallback para credenciais do qwen-code
         if (!accessToken) {
           const creds = checkExistingCredentials();
-          if (creds) accessToken = creds.accessToken;
+          if (creds) {
+            accessToken = creds.accessToken;
+          } else {
+            console.warn(
+              '[Qwen] Token expirado e sem credenciais alternativas. ' +
+              'Execute "npx opencode-qwencode-auth" ou "qwen-code auth login" para re-autenticar.'
+            );
+            return null;
+          }
         }
 
         if (!accessToken) return null;
@@ -200,7 +214,7 @@ export const QwenAuthPlugin = async (_input: unknown) => {
             {
               id: m.id,
               name: m.name,
-              reasoning: false,
+              reasoning: m.reasoning,
               limit: { context: m.contextWindow, output: m.maxOutput },
               cost: m.cost,
               modalities: { input: ['text'], output: ['text'] },

package/src/plugin/auth.ts

@@ -10,6 +10,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 
 import type { QwenCredentials } from '../types.js';
 import { refreshAccessToken, isCredentialsExpired } from '../qwen/oauth.js';
+import { logTechnicalDetail } from '../errors.js';
 
 /**
  * Get the path to the credentials file
@@ -58,7 +59,7 @@ export function loadCredentials(): QwenCredentials | null {
 
     return null;
   } catch (error) {
-    console.error('Error loading Qwen credentials:', error);
+    logTechnicalDetail(`Erro ao carregar credenciais: ${error}`);
     return null;
   }
 }
@@ -102,7 +103,7 @@ export async function getValidCredentials(): Promise<QwenCredentials | null> {
       credentials = await refreshAccessToken(credentials.refreshToken);
       saveCredentials(credentials);
     } catch (error) {
-      console.error('Failed to refresh token:', error);
+      logTechnicalDetail(`Falha no refresh: ${error}`);
       return null;
     }
   }

package/src/plugin/client.ts

@@ -12,6 +12,7 @@ import type {
   StreamChunk
 } from '../types.js';
 import { getValidCredentials, loadCredentials, isCredentialsExpired } from './auth.js';
+import { QwenAuthError, QwenApiError } from '../errors.js';
 
 /**
  * QwenClient - Makes authenticated API calls to Qwen
@@ -66,7 +67,7 @@ export class QwenClient {
    */
   private getAuthHeader(): string {
     if (!this.credentials) {
-      throw new Error('Not authenticated. Please run the OAuth flow first.');
+      throw new QwenAuthError('auth_required');
     }
     return `Bearer ${this.credentials.accessToken}`;
   }
@@ -87,7 +88,7 @@ export class QwenClient {
     if (!this.credentials) {
       const initialized = await this.initialize();
       if (!initialized) {
-        throw new Error('No valid Qwen credentials found. Please authenticate first.');
+        throw new QwenAuthError('auth_required');
       }
     }
 
@@ -106,7 +107,7 @@ export class QwenClient {
     if (!response.ok) {
       const errorText = await response.text();
       this.log('API Error:', response.status, errorText);
-      throw new Error(`Qwen API error: ${response.status} - ${errorText}`);
+      throw new QwenApiError(response.status, errorText);
     }
 
     const data = await response.json();
@@ -122,7 +123,7 @@ export class QwenClient {
     if (!this.credentials) {
       const initialized = await this.initialize();
       if (!initialized) {
-        throw new Error('No valid Qwen credentials found. Please authenticate first.');
+        throw new QwenAuthError('auth_required');
       }
     }
 
@@ -142,7 +143,7 @@ export class QwenClient {
     if (!response.ok) {
       const errorText = await response.text();
       this.log('API Error:', response.status, errorText);
-      throw new Error(`Qwen API error: ${response.status} - ${errorText}`);
+      throw new QwenApiError(response.status, errorText);
     }
 
     const reader = response.body?.getReader();

package/src/qwen/oauth.ts

@@ -9,6 +9,7 @@ import { randomBytes, createHash, randomUUID } from 'node:crypto';
 
 import { QWEN_OAUTH_CONFIG } from '../constants.js';
 import type { QwenCredentials } from '../types.js';
+import { QwenAuthError, logTechnicalDetail } from '../errors.js';
 
 /**
  * Device authorization response from Qwen OAuth
@@ -87,9 +88,8 @@ export async function requestDeviceAuthorization(
 
   if (!response.ok) {
     const errorData = await response.text();
-    throw new Error(
-      `Device authorization failed: ${response.status} ${response.statusText}. Response: ${errorData}`
-    );
+    logTechnicalDetail(`Device auth HTTP ${response.status}: ${errorData}`);
+    throw new QwenAuthError('auth_required', `HTTP ${response.status}: ${errorData}`);
   }
 
   const result = await response.json() as DeviceAuthorizationResponse;
@@ -193,7 +193,8 @@ export async function refreshAccessToken(refreshToken: string): Promise<QwenCred
 
   if (!response.ok) {
     const errorText = await response.text();
-    throw new Error(`Token refresh failed: ${response.status} - ${errorText}`);
+    logTechnicalDetail(`Token refresh HTTP ${response.status}: ${errorText}`);
+    throw new QwenAuthError('refresh_failed', `HTTP ${response.status}: ${errorText}`);
   }
 
   const data = await response.json() as TokenResponse;