@link-assistant/agent 0.27.0 → 0.27.1

package/README.md

@@ -24,7 +24,7 @@ This is an MVP implementation of an OpenCode-compatible CLI agent, focused on ma
 
 - ✅ **JSON Input/Output**: Compatible with `opencode run --format json`
 - ✅ **Plain Text Input**: Also accepts plain text messages (auto-converted to JSON format)
-- ✅ **Flexible Model Selection**: Defaults to free Kilo Nemotron 3 Super (Kilo authentication recommended), supports every [models.dev](https://models.dev) provider OpenCode supports ([full list](../docs/providers.md)), OpenCode's subscription logins, [gpt4free](../docs/gpt4free.md), Pollinations, local servers, [Formal AI](../docs/formal-ai.md) and [Claude OAuth](../docs/claude-oauth.md), with [live model discovery](../docs/model-discovery.md)
+- ✅ **Flexible Model Selection**: Defaults to free Kilo Nemotron 3 Ultra (Kilo authentication recommended), supports every [models.dev](https://models.dev) provider OpenCode supports ([full list](../docs/providers.md)), OpenCode's subscription logins, [gpt4free](../docs/gpt4free.md), Pollinations, local servers, [Formal AI](../docs/formal-ai.md) and [Claude OAuth](../docs/claude-oauth.md), with [live model discovery](../docs/model-discovery.md)
 - ✅ **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 kilo/nemotron-3-super-free
+echo "hi" | agent --model kilo/nemotron-3-ultra-free
 ```
 
 ### More Examples
@@ -190,11 +190,10 @@ echo '{"message":"run command","tools":[{"name":"bash","params":{"command":"ls -
 **Using different models:**
 
 ```bash
-# Default model (free Nemotron 3 Super)
+# Default model (free Nemotron 3 Ultra)
 echo "hi" | agent
 
 # Built-in free models (authenticate with agent auth login or KILO_API_KEY)
-echo "hi" | agent --model kilo/nemotron-3-super-free
 echo "hi" | agent --model kilo/nemotron-3-ultra-free
 echo "hi" | agent --model kilo/nemotron-3.5-lightning-free
 
@@ -285,7 +284,7 @@ agent [options]
 
 Options:
   --model                        Model to use in format providerID/modelID
-                                 Default: kilo/nemotron-3-super-free
+                                 Default: kilo/nemotron-3-ultra-free
   --json-standard                JSON output format standard
                                  Choices: "opencode" (default), "claude" (experimental)
   --output-format                Alias for JSON output format
@@ -311,6 +310,42 @@ Permission Options:
                                  invoked via batch.
                                  Env: LINK_ASSISTANT_AGENT_DISABLE_TOOLS
 
+Compatibility Options (issue #335):
+  Each option restores behaviour from before the OpenCode stability sync, or
+  tunes a new limit. Every option also has a LINK_ASSISTANT_AGENT_* env var.
+  --bash-shell <auto|legacy|path> Shell for the bash tool. "auto" (default):
+                                 $SHELL if POSIX, else bash, else /bin/sh;
+                                 "legacy": /bin/sh as before.
+                                 Env: LINK_ASSISTANT_AGENT_BASH_SHELL
+  --legacy-tool-output           Empty edit/write output, head-truncated bash
+                                 output, empty read past EOF (as before).
+                                 Env: LINK_ASSISTANT_AGENT_LEGACY_TOOL_OUTPUT
+  --legacy-edit-matching         Loose fuzzy edit matching; an empty oldString
+                                 overwrites an existing file (as before).
+                                 Env: LINK_ASSISTANT_AGENT_LEGACY_EDIT_MATCHING
+  --glob-follow-symlinks         Follow symlinked directories in glob/ls.
+                                 Env: LINK_ASSISTANT_AGENT_GLOB_FOLLOW_SYMLINKS
+  --no-grep-hidden               Do not search hidden files in grep.
+                                 Env: LINK_ASSISTANT_AGENT_GREP_HIDDEN=false
+  --grep-timeout-ms <ms>         Timeout of one grep search (default 30000,
+                                 0 = none). Env: LINK_ASSISTANT_AGENT_GREP_TIMEOUT_MS
+  --read-max-lines <n>           Max lines per read call (default 2000,
+                                 0 = no cap). Env: LINK_ASSISTANT_AGENT_READ_MAX_LINES
+  --read-max-bytes <n>           Max bytes per read call (default 51200,
+                                 0 = no cap). Env: LINK_ASSISTANT_AGENT_READ_MAX_BYTES
+  --legacy-error-names           Report ContextOverflowError as a
+                                 non-retryable APIError in JSON output.
+                                 Env: LINK_ASSISTANT_AGENT_LEGACY_ERROR_NAMES
+  --legacy-token-usage           tokens.output includes reasoning tokens.
+                                 Env: LINK_ASSISTANT_AGENT_LEGACY_TOKEN_USAGE
+  --legacy-loop-exit             End the turn on a "stop" finish even when
+                                 tools ran in that step.
+                                 Env: LINK_ASSISTANT_AGENT_LEGACY_LOOP_EXIT
+  --mcp-connect-timeout <ms>     Default MCP connect/initialize timeout
+                                 (default 30000, 0 = none). Per server:
+                                 "connect_timeout" in the mcp config.
+                                 Env: LINK_ASSISTANT_AGENT_MCP_CONNECT_TIMEOUT
+
 Stdin Mode Options:
   -p, --prompt                   Direct prompt (bypasses stdin reading)
   --disable-stdin                Disable stdin streaming (requires --prompt)
@@ -509,6 +544,13 @@ This will create a configuration file at `~/.config/link-assistant-agent/opencod
 }
 ```
 
+**MCP timeouts:** each server entry accepts `timeout` (ms for listing tools,
+default 5000; unchanged meaning) and `connect_timeout` (ms for starting the
+server and finishing the `initialize` handshake, default
+`--mcp-connect-timeout`, 30000, or `timeout` if larger; `0` disables the
+bound). A server that does not connect in time is reported as `failed`
+instead of blocking the session.
+
 **Available Playwright Tools:**
 
 Once configured, the agent gains access to 22+ browser automation tools:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",
@@ -51,65 +51,65 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@agentclientprotocol/sdk": "^2.0.1",
-    "@ai-sdk/alibaba": "^2.0.74",
-    "@ai-sdk/amazon-bedrock": "^5.0.122",
-    "@ai-sdk/anthropic": "^4.0.86",
-    "@ai-sdk/azure": "^4.0.108",
-    "@ai-sdk/cerebras": "^3.0.76",
-    "@ai-sdk/cohere": "^4.0.67",
-    "@ai-sdk/deepinfra": "^3.0.76",
-    "@ai-sdk/deepseek": "^3.0.71",
-    "@ai-sdk/fireworks": "^3.0.79",
-    "@ai-sdk/gateway": "^4.0.122",
-    "@ai-sdk/google": "^4.0.103",
-    "@ai-sdk/google-vertex": "^5.0.120",
-    "@ai-sdk/groq": "^4.0.68",
-    "@ai-sdk/mcp": "^2.0.82",
-    "@ai-sdk/mistral": "^4.0.70",
-    "@ai-sdk/openai": "^4.0.100",
-    "@ai-sdk/openai-compatible": "^3.0.76",
-    "@ai-sdk/perplexity": "^5.0.18",
-    "@ai-sdk/provider": "^4.0.32",
-    "@ai-sdk/togetherai": "^3.0.77",
-    "@ai-sdk/xai": "^5.0.28",
+    "@agentclientprotocol/sdk": "^2.4.0",
+    "@ai-sdk/alibaba": "^2.0.81",
+    "@ai-sdk/amazon-bedrock": "^5.0.131",
+    "@ai-sdk/anthropic": "^4.0.95",
+    "@ai-sdk/azure": "^4.0.115",
+    "@ai-sdk/cerebras": "^3.0.83",
+    "@ai-sdk/cohere": "^4.0.74",
+    "@ai-sdk/deepinfra": "^3.0.83",
+    "@ai-sdk/deepseek": "^3.0.78",
+    "@ai-sdk/fireworks": "^3.0.86",
+    "@ai-sdk/gateway": "^4.0.134",
+    "@ai-sdk/google": "^4.0.110",
+    "@ai-sdk/google-vertex": "^5.0.130",
+    "@ai-sdk/groq": "^4.0.75",
+    "@ai-sdk/mcp": "^2.0.89",
+    "@ai-sdk/mistral": "^4.0.78",
+    "@ai-sdk/openai": "^4.0.107",
+    "@ai-sdk/openai-compatible": "^3.0.83",
+    "@ai-sdk/perplexity": "^5.0.25",
+    "@ai-sdk/provider": "^4.0.35",
+    "@ai-sdk/togetherai": "^3.0.84",
+    "@ai-sdk/xai": "^5.0.37",
     "@clack/prompts": "^1.8.1",
-    "@hono/standard-validator": "^0.4.0",
+    "@hono/standard-validator": "^0.4.1",
     "@hono/zod-validator": "^0.9.1",
-    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@modelcontextprotocol/sdk": "^1.32.2",
     "@octokit/graphql": "^9.0.5",
     "@octokit/rest": "^22.0.1",
     "@openauthjs/openauth": "^0.4.3",
-    "@opencode-ai/sdk": "^1.19.4",
+    "@opencode-ai/sdk": "^1.19.5",
     "@openrouter/ai-sdk-provider": "^3.1.0",
-    "@opentui/core": "^0.6.6",
-    "@opentui/solid": "^0.6.6",
+    "@opentui/core": "^0.8.1",
+    "@opentui/solid": "^0.8.1",
     "@parcel/watcher": "^2.6.0",
     "@solid-primitives/event-bus": "^1.1.4",
-    "@standard-community/standard-json": "^0.3.7",
+    "@standard-community/standard-json": "^0.4.0",
     "@standard-community/standard-openapi": "^0.2.11",
     "@zip.js/zip.js": "^2.24.0",
-    "ai": "^7.0.149",
+    "ai": "^7.0.161",
     "chokidar": "^6.0.0",
     "clipboardy": "^5.3.2",
-    "command-stream": "^2.4.0",
+    "command-stream": "^2.6.0",
     "decimal.js": "^10.6.0",
     "diff": "^9.0.0",
     "fuzzysort": "^4.0.2",
-    "glob": "^13.0.6",
-    "google-auth-library": "^11.3.1",
+    "glob": "^14.0.3",
+    "google-auth-library": "^11.3.2",
     "gpt-tokenizer": "^4.1.0",
     "gray-matter": "^4.0.3",
-    "hono": "^4.13.13",
+    "hono": "^4.13.16",
     "hono-openapi": "^1.5.0",
-    "ignore": "^7.0.13",
+    "ignore": "^7.0.14",
     "jsonc-parser": "^3.3.1",
     "lino-arguments": "^0.3.0",
-    "lino-objects-codec": "^0.9.2",
+    "lino-objects-codec": "^0.9.5",
     "log-lazy": "^1.0.4",
-    "minimatch": "^10.2.6",
-    "remeda": "^2.53.0",
-    "solid-js": "1.9.12",
+    "minimatch": "^11.0.4",
+    "remeda": "^2.58.0",
+    "solid-js": "^1.9.18",
     "strip-ansi": "^7.2.0",
     "test-anywhere": "^0.9.1",
     "tree-sitter-bash": "^0.25.1",
@@ -125,7 +125,7 @@
   "devDependencies": {
     "@changesets/cli": "^3.0.3",
     "@eslint/js": "^10.0.1",
-    "eslint": "^10.13.0",
+    "eslint": "^10.14.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.7",
     "eslint-plugin-promise": "^7.3.0",
@@ -151,11 +151,10 @@
     "node-pty@1.1.0": true
   },
   "overrides": {
-    "seroval": "^1.6.9",
     "undici": "^7.16.0"
   },
   "dependencyPins": {
-    "solid-js": "https://github.com/anomalyco/opentui/issues/689",
+    "lino-arguments": "https://github.com/link-foundation/lino-arguments/issues/50",
     "web-tree-sitter": "https://github.com/anomalyco/opentui/issues/1550"
   }
 }

package/src/cli/argv.ts

@@ -105,7 +105,7 @@ export function getCompactionSafetyMarginFromProcessArgv(): string | null {
 /**
  * Extract --compaction-models argument directly from process.argv
  * The value is a links notation references sequence, e.g.:
- *   "(kilo/nemotron-3-super-free kilo/nemotron-3-ultra-free kilo/nemotron-3.5-lightning-free same)"
+ *   "(kilo/nemotron-3-ultra-free kilo/nemotron-3.5-lightning-free same)"
  * @returns The compaction models argument from CLI or null if not found
  * @see https://github.com/link-assistant/agent/issues/232
  */

package/src/cli/cmd/run.ts

@@ -9,6 +9,7 @@ import { EOL } from 'os';
 import { select } from '@clack/prompts';
 import { createOpencodeClient, type OpencodeClient } from '@opencode-ai/sdk';
 import { Provider } from '../../provider/provider';
+import { legacyErrorObject } from '../../util/legacy-error-names';
 
 const TOOL: Record<string, [string, string]> = {
   todowrite: ['Todo', UI.Style.TEXT_WARNING_BOLD],
@@ -267,7 +268,12 @@ export const RunCommand = cmd({
             // Always include the human-readable string alongside the
             // machine-readable object so consumers never print
             // "[object Object]" (#289).
-            if (outputJsonEvent('error', { message: err, error: props.error }))
+            if (
+              outputJsonEvent('error', {
+                message: err,
+                error: legacyErrorObject(props.error),
+              })
+            )
               continue;
             UI.error(err);
           }

package/src/cli/continuous-mode.js

@@ -356,6 +356,10 @@ export async function runContinuousServerMode(
       const parts = [{ type: 'text', text: messageText }];
 
       // Create a promise to wait for this message to complete
+      // `stopIdleWait` ends the wait when the prompt settles without ever
+      // going idle (it can throw before the loop starts); otherwise the
+      // subscription leaked and the input queue hung (issue #335).
+      let stopIdleWait = () => {};
       const messagePromise = new Promise((resolve) => {
         const checkIdle = Bus.subscribeAll((event) => {
           if (
@@ -366,6 +370,10 @@ export async function runContinuousServerMode(
             resolve();
           }
         });
+        stopIdleWait = () => {
+          checkIdle();
+          resolve();
+        };
       });
 
       // Send message
@@ -383,21 +391,28 @@ export async function runContinuousServerMode(
             temperature,
           }),
         }
-      ).catch((error) => {
-        hasError = true;
-        eventHandler.output({
-          type: 'error',
-          timestamp: Date.now(),
-          sessionID,
-          message: errorText(error),
-          error: error instanceof Error ? error.message : String(error),
+      )
+        // Read the reply to the end: it completes only after the prompt has
+        // returned (and released the connection), successful or not.
+        .then((response) => response.text())
+        .catch((error) => {
+          hasError = true;
+          eventHandler.output({
+            type: 'error',
+            timestamp: Date.now(),
+            sessionID,
+            message: errorText(error),
+            error: error instanceof Error ? error.message : String(error),
+          });
         });
-      });
 
       // See the direct-mode comment below: the request rejection must be
-      // observed before the process can exit (#290).
-      await messagePromise;
+      // observed before the process can exit (#290). `session.idle` is
+      // published before the reply is written, so once the reply is complete
+      // the idle wait can stop.
       await requestPromise;
+      stopIdleWait();
+      await messagePromise;
       isProcessing = false;
 
       // Process next pending message if any
@@ -582,6 +597,10 @@ export async function runContinuousDirectMode(
       const parts = [{ type: 'text', text: messageText }];
 
       // Create a promise to wait for this message to complete
+      // `stopIdleWait` ends the wait when the prompt settles without ever
+      // going idle (it can throw before the loop starts); otherwise the
+      // subscription leaked and the input queue hung (issue #335).
+      let stopIdleWait = () => {};
       const messagePromise = new Promise((resolve) => {
         const checkIdle = Bus.subscribeAll((event) => {
           if (
@@ -592,6 +611,10 @@ export async function runContinuousDirectMode(
             resolve();
           }
         });
+        stopIdleWait = () => {
+          checkIdle();
+          resolve();
+        };
       });
 
       // Send message directly
@@ -618,8 +641,11 @@ export async function runContinuousDirectMode(
       // publishes `session.idle` while unwinding, so waiting only on the idle
       // event let the process exit before the rejection handler above ran —
       // no error record, exit code 0 (#290).
-      await messagePromise;
+      // `session.idle` is published synchronously before `prompt` settles,
+      // so after it settles the idle wait can stop.
       await promptPromise;
+      stopIdleWait();
+      await messagePromise;
       isProcessing = false;
 
       // Process next pending message if any

package/src/cli/event-handler.js

@@ -5,6 +5,7 @@
 
 import { Bus } from '../bus/index.ts';
 import { errorText } from '../util/error-text.ts';
+import { legacyErrorObject } from '../util/legacy-error-names.ts';
 
 /**
  * Create a subscription for session bus events that outputs events in the selected JSON format.
@@ -142,7 +143,8 @@ export function outputBusEvent({
       timestamp: Date.now(),
       sessionID,
       message: errorText(props.error),
-      error: props.error,
+      // --legacy-error-names maps new error names to the previous ones.
+      error: legacyErrorObject(props.error),
     });
   }
 }

package/src/cli/model-config.js

@@ -6,6 +6,7 @@ import {
 } from './argv.ts';
 import { Log } from '../util/log.ts';
 import { ExtraProviders } from '../provider/extra-providers.ts';
+import { resolveKiloDeprecatedAlias } from '../provider/kilo-deprecation.ts';
 import {
   DEFAULT_PROVIDER_ID,
   DEFAULT_MODEL_ID,
@@ -31,6 +32,17 @@ export class ModelResolutionError extends Error {
   }
 }
 
+/**
+ * Map a withdrawn built-in Kilo alias to its replacement, with a warning (#335).
+ * Other providers and model IDs are returned unchanged.
+ * @param {string} providerID
+ * @param {string} modelID
+ * @returns {string}
+ */
+function replaceDeprecatedModel(providerID, modelID) {
+  return providerID === 'kilo' ? resolveKiloDeprecatedAlias(modelID) : modelID;
+}
+
 /**
  * Parse model config from argv. Supports "provider/model" or short "model" format.
  * @param {object} argv - Parsed command line arguments
@@ -127,7 +139,7 @@ export async function parseModelConfig(
     const modelParts = modelArg.split('/');
     // Accept alternative spellings such as `g4f/...` for `gpt4free/...` (#334)
     providerID = ExtraProviders.canonicalID(modelParts[0]);
-    modelID = modelParts.slice(1).join('/');
+    modelID = replaceDeprecatedModel(providerID, modelParts.slice(1).join('/'));
 
     // Validate that providerID and modelID are not empty
     // Do NOT fall back to defaults - if the user provided an invalid format, fail clearly (#196)
@@ -347,7 +359,7 @@ async function resolveCompactionModelEntry(
     const parts = modelArg.split('/');
     return {
       providerID: parts[0],
-      modelID: parts.slice(1).join('/'),
+      modelID: replaceDeprecatedModel(parts[0], parts.slice(1).join('/')),
       useSameModel: false,
     };
   }
@@ -399,7 +411,7 @@ async function resolveEntryWithinProvider(
     }
     return {
       providerID: parts[0],
-      modelID: parts.slice(1).join('/'),
+      modelID: replaceDeprecatedModel(parts[0], parts.slice(1).join('/')),
       useSameModel: false,
     };
   }
@@ -408,7 +420,11 @@ async function resolveEntryWithinProvider(
   if (!(await Provider.hasModel(baseProviderID, modelArg))) {
     return null;
   }
-  return { providerID: baseProviderID, modelID: modelArg, useSameModel: false };
+  return {
+    providerID: baseProviderID,
+    modelID: replaceDeprecatedModel(baseProviderID, modelArg),
+    useSameModel: false,
+  };
 }
 
 /**