@link-assistant/agent 0.16.12 → 0.16.14

package/README.md

@@ -20,11 +20,11 @@
 
 > This is the JavaScript/Bun implementation. See also the [Rust implementation](../rust/README.md).
 
-This is an MVP implementation of an OpenCode-compatible CLI agent, focused on maximum efficiency and unrestricted execution. We reproduce OpenCode's `run --format json --model opencode/kimi-k2.5-free` mode with:
+This is an MVP implementation of an OpenCode-compatible CLI agent, focused on maximum efficiency and unrestricted execution. We reproduce OpenCode's `run --format json --model opencode/minimax-m2.5-free` mode with:
 
-- ✅ **JSON Input/Output**: Compatible with `opencode run --format json --model opencode/kimi-k2.5-free`
+- ✅ **JSON Input/Output**: Compatible with `opencode run --format json --model opencode/minimax-m2.5-free`
 - ✅ **Plain Text Input**: Also accepts plain text messages (auto-converted to JSON format)
-- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen Kimi K2.5, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Claude OAuth](../docs/claude-oauth.md), [Groq](../docs/groq.md), and [OpenRouter](../docs/openrouter.md) providers
+- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen MiniMax M2.5 Free, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Claude OAuth](../docs/claude-oauth.md), [Groq](../docs/groq.md), and [OpenRouter](../docs/openrouter.md) providers
 - ✅ **No Restrictions**: Fully unrestricted file system and command execution access (no sandbox)
 - ✅ **Minimal Footprint**: Built with Bun.sh for maximum efficiency
 - ✅ **Full Tool Support**: 13 tools including websearch, codesearch, batch - all enabled by default
@@ -169,7 +169,7 @@ echo '{"message":"hi"}' | agent
 **With custom model:**
 
 ```bash
-echo "hi" | agent --model opencode/kimi-k2.5-free
+echo "hi" | agent --model opencode/minimax-m2.5-free
 ```
 
 ### More Examples
@@ -190,7 +190,7 @@ echo '{"message":"run command","tools":[{"name":"bash","params":{"command":"ls -
 **Using different models:**
 
 ```bash
-# Default model (free Kimi K2.5)
+# Default model (free MiniMax M2.5)
 echo "hi" | agent
 
 # Other free models (in order of recommendation)
@@ -280,7 +280,7 @@ agent [options]
 
 Options:
   --model                        Model to use in format providerID/modelID
-                                 Default: opencode/kimi-k2.5-free
+                                 Default: opencode/minimax-m2.5-free
   --json-standard                JSON output format standard
                                  Choices: "opencode" (default), "claude" (experimental)
   --use-existing-claude-oauth    Use existing Claude OAuth credentials

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.16.12",
+  "version": "0.16.14",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",

package/src/cli/defaults.ts

@@ -0,0 +1,15 @@
+/**
+ * Default CLI configuration values.
+ *
+ * Centralizing defaults here ensures all code references the same value (#208).
+ * When the default model changes, update this file only.
+ */
+
+/** Default model used when no `--model` CLI argument is provided. */
+export const DEFAULT_MODEL = 'opencode/minimax-m2.5-free';
+
+/** Default provider ID extracted from DEFAULT_MODEL. */
+export const DEFAULT_PROVIDER_ID = DEFAULT_MODEL.split('/')[0];
+
+/** Default model ID extracted from DEFAULT_MODEL. */
+export const DEFAULT_MODEL_ID = DEFAULT_MODEL.split('/').slice(1).join('/');

package/src/cli/model-config.js

@@ -1,5 +1,6 @@
 import { getModelFromProcessArgv } from './argv.ts';
 import { Log } from '../util/log.ts';
+import { DEFAULT_PROVIDER_ID, DEFAULT_MODEL_ID } from './defaults.ts';
 
 /**
  * Parse model config from argv. Supports "provider/model" or short "model" format.
@@ -16,7 +17,7 @@ export async function parseModelConfig(argv, outputError, outputStatus) {
   let modelArg = argv.model;
 
   // ALWAYS prefer the CLI value over yargs when available (#196)
-  // The yargs default 'opencode/kimi-k2.5-free' can silently override user's --model argument
+  // The yargs default (DEFAULT_MODEL) can silently override user's --model argument
   if (cliModelArg) {
     if (cliModelArg !== modelArg) {
       Log.Default.warn(() => ({
@@ -45,7 +46,7 @@ export async function parseModelConfig(argv, outputError, outputStatus) {
     // Do NOT fall back to defaults - if the user provided an invalid format, fail clearly (#196)
     if (!providerID || !modelID) {
       throw new Error(
-        `Invalid model format: "${modelArg}". Expected "provider/model" format (e.g., "opencode/kimi-k2.5-free"). ` +
+        `Invalid model format: "${modelArg}". Expected "provider/model" format (e.g., "${DEFAULT_PROVIDER_ID}/${DEFAULT_MODEL_ID}"). ` +
           `Provider: "${providerID || '(empty)'}", Model: "${modelID || '(empty)'}".`
       );
     }
@@ -124,9 +125,9 @@ export async function parseModelConfig(argv, outputError, outputStatus) {
     // Set environment variable for the provider to use
     process.env.CLAUDE_CODE_OAUTH_TOKEN = creds.accessToken;
 
-    // If user specified the default model (opencode/kimi-k2.5-free), switch to claude-oauth
+    // If user specified the default model (DEFAULT_MODEL), switch to claude-oauth
     // If user explicitly specified kilo or another provider, warn but respect their choice
-    if (providerID === 'opencode' && modelID === 'kimi-k2.5-free') {
+    if (providerID === DEFAULT_PROVIDER_ID && modelID === DEFAULT_MODEL_ID) {
       providerID = 'claude-oauth';
       modelID = 'claude-sonnet-4-5';
     } else if (!['claude-oauth', 'anthropic'].includes(providerID)) {

package/src/index.js

@@ -6,6 +6,7 @@ import { Server } from './server/server.ts';
 import { Instance } from './project/instance.ts';
 import { Log } from './util/log.ts';
 import { parseModelConfig } from './cli/model-config.js';
+import { DEFAULT_MODEL } from './cli/defaults.ts';
 // Bus is used via createBusEventSubscription in event-handler.js
 import { Session } from './session/index.ts';
 import { SessionPrompt } from './session/prompt.ts';
@@ -588,7 +589,7 @@ async function main() {
             .option('model', {
               type: 'string',
               description: 'Model to use in format providerID/modelID',
-              default: 'opencode/kimi-k2.5-free',
+              default: DEFAULT_MODEL,
             })
             .option('json-standard', {
               type: 'string',

package/src/provider/provider.ts

@@ -1651,12 +1651,7 @@ export namespace Provider {
       priority = priority.filter((m) => m !== 'claude-haiku-4.5');
     }
     if (providerID === 'opencode' || providerID === 'local') {
-      priority = [
-        'kimi-k2.5-free',
-        'minimax-m2.5-free',
-        'gpt-5-nano',
-        'big-pickle',
-      ];
+      priority = ['minimax-m2.5-free', 'gpt-5-nano', 'big-pickle'];
     }
     if (providerID === 'kilo') {
       priority = [
@@ -1684,7 +1679,6 @@ export namespace Provider {
 
   const priority = [
     'glm-5-free',
-    'kimi-k2.5-free',
     'minimax-m2.5-free',
     'gpt-5-nano',
     'big-pickle',
@@ -1856,7 +1850,7 @@ export namespace Provider {
    * Examples:
    * - "kilo/glm-5-free" -> { providerID: "kilo", modelID: "glm-5-free" }
    * - "glm-5-free" -> { providerID: "kilo", modelID: "glm-5-free" } (resolved)
-   * - "kimi-k2.5-free" -> { providerID: "opencode", modelID: "kimi-k2.5-free" } (resolved)
+   * - "big-pickle" -> { providerID: "opencode", modelID: "big-pickle" } (resolved)
    * - "nonexistent-model" -> throws ModelNotFoundError
    *
    * @param model - Model string with or without provider prefix
@@ -1916,7 +1910,7 @@ export namespace Provider {
    * When one provider hits rate limits, the system can try an alternative.
    *
    * Note: This is only used for models without explicit provider specification.
-   * If user specifies "kilo/kimi-k2.5-free", no fallback will occur.
+   * If user specifies "kilo/deepseek-r1-free", no fallback will occur.
    */
   const SHARED_FREE_MODELS: Record<string, string[]> = {
     // Currently no shared models between OpenCode and Kilo providers.
@@ -1928,7 +1922,7 @@ export namespace Provider {
    * This function returns a list of alternative providers that offer the same model.
    *
    * Note: This only returns alternatives for models without explicit provider specification.
-   * If the original request had an explicit provider (like "kilo/kimi-k2.5-free"), this returns empty array.
+   * If the original request had an explicit provider (like "kilo/deepseek-r1-free"), this returns empty array.
    *
    * @param modelID - The model ID to find alternatives for
    * @param failedProviderID - The provider that failed

package/src/session/processor.ts

@@ -22,6 +22,34 @@ export namespace SessionProcessor {
   const DOOM_LOOP_THRESHOLD = 3;
   const log = Log.create({ service: 'session.processor' });
 
+  /**
+   * Detect model-not-supported errors from an API response body.
+   *
+   * Some providers (e.g., OpenCode, OpenRouter) return HTTP 401 with a body
+   * like {"type":"ModelError","message":"Model X not supported"} instead of
+   * the semantically correct 400/404. Without this check the error looks like
+   * an authentication failure, making diagnostics confusing.
+   *
+   * See: https://github.com/link-assistant/agent/issues/208
+   */
+  export function isModelNotSupportedError(responseBody: string): boolean {
+    try {
+      const parsed = JSON.parse(responseBody);
+      // OpenCode/OpenRouter format: {"type":"error","error":{"type":"ModelError","message":"..."}}
+      if (parsed?.error?.type === 'ModelError') return true;
+      // Flat format: {"type":"ModelError","message":"..."}
+      if (parsed?.type === 'ModelError') return true;
+      return false;
+    } catch {
+      // If response body is not JSON, check for common text patterns
+      return (
+        responseBody.includes('ModelError') ||
+        responseBody.toLowerCase().includes('model not supported') ||
+        responseBody.toLowerCase().includes('model not found')
+      );
+    }
+  }
+
   export type Info = Awaited<ReturnType<typeof create>>;
   export type Result = Awaited<ReturnType<Info['process']>>;
 
@@ -551,6 +579,37 @@ export namespace SessionProcessor {
 
             // Clear retry state on non-retryable error
             SessionRetry.clearRetryState(input.sessionID);
+
+            // Detect model-not-supported errors from provider response body.
+            // OpenCode and similar proxies return HTTP 401 with
+            // {"type":"ModelError","message":"Model X not supported"}.
+            // Without this check the error looks like an auth failure (401),
+            // but it's actually a model-availability issue.
+            // See: https://github.com/link-assistant/agent/issues/208
+            if (
+              error?.name === 'APIError' &&
+              error.data.statusCode === 401 &&
+              error.data.responseBody
+            ) {
+              const isModelError = isModelNotSupportedError(
+                error.data.responseBody
+              );
+              if (isModelError) {
+                log.error(() => ({
+                  message:
+                    'model not supported by provider — this is NOT an auth error',
+                  hint: 'The model was found in the local cache but the provider rejected it. The model may have been removed or is temporarily unavailable.',
+                  providerID: input.providerID,
+                  modelID: input.model.id,
+                  statusCode: error.data.statusCode,
+                  responseBody: error.data.responseBody,
+                  suggestion:
+                    'Try a different model or check the provider status. Use --model <provider>/<model-id> to specify an alternative.',
+                  issue: 'https://github.com/link-assistant/agent/issues/208',
+                }));
+              }
+            }
+
             input.assistantMessage.error = error;
             Bus.publish(Session.Event.Error, {
               sessionID: input.assistantMessage.sessionID,

package/src/tool/task.ts

@@ -9,6 +9,7 @@ import { Agent } from '../agent/agent';
 import { SessionPrompt } from '../session/prompt';
 import { iife } from '../util/iife';
 import { defer } from '../util/defer';
+import { DEFAULT_PROVIDER_ID, DEFAULT_MODEL_ID } from '../cli/defaults';
 
 export const TaskTool = Tool.define('task', async () => {
   const agents = await Agent.list().then((x) =>
@@ -99,8 +100,8 @@ export const TaskTool = Tool.define('task', async () => {
 
       const model = agent.model ??
         parentModel ?? {
-          modelID: 'kimi-k2.5-free',
-          providerID: 'opencode',
+          modelID: DEFAULT_MODEL_ID,
+          providerID: DEFAULT_PROVIDER_ID,
         };
 
       function cancel() {