@link-assistant/agent 0.8.10 → 0.8.13

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 --model opencode/grok-code`
 - ✅ **Plain Text Input**: Also accepts plain text messages (auto-converted to JSON format)
-- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen Grok Code Fast 1, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Claude OAuth](../docs/claude-oauth.md), and [Groq](../docs/groq.md) providers
+- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen Grok Code Fast 1, 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
@@ -59,6 +59,38 @@ bun add @link-assistant/agent
 
 After installation, the `agent` command will be available globally.
 
+## Uninstallation
+
+### Uninstalling the Agent
+
+```bash
+# Remove the globally installed package
+bun remove -g @link-assistant/agent
+
+# Or if installed locally in your project
+bun remove @link-assistant/agent
+```
+
+### Uninstalling Bun
+
+If you need to completely remove Bun from your system:
+
+```bash
+# Remove the Bun binary and installation directory
+rm -rf ~/.bun
+
+# Remove the Bun cache (optional)
+rm -rf ~/.bun/install/cache
+```
+
+After removing the `~/.bun` directory, you may also need to remove Bun from your shell configuration. Check and remove lines referencing `~/.bun/bin` from:
+
+- `~/.bashrc`
+- `~/.zshrc`
+- `~/.config/fish/config.fish`
+
+Or the corresponding configuration file for your shell.
+
 ## Usage
 
 ### Simplest Examples
@@ -116,6 +148,11 @@ echo "hi" | agent --model opencode/gemini-3-pro  # Gemini 3 Pro
 echo "hi" | agent --model groq/llama-3.3-70b-versatile  # Llama 3.3 70B
 echo "hi" | agent --model groq/llama-3.1-8b-instant     # Llama 3.1 8B (fast)
 
+# OpenRouter models (requires OPENROUTER_API_KEY)
+echo "hi" | agent --model openrouter/anthropic/claude-sonnet-4  # Claude via OpenRouter
+echo "hi" | agent --model openrouter/openai/gpt-4o              # GPT-4o via OpenRouter
+echo "hi" | agent --model openrouter/meta-llama/llama-3.3-70b   # Llama via OpenRouter
+
 # Anthropic direct (requires ANTHROPIC_API_KEY)
 echo "hi" | agent --model anthropic/claude-sonnet-4-5  # Claude Sonnet 4.5
 echo "hi" | agent --model anthropic/claude-opus-4-1    # Claude Opus 4.1
@@ -138,6 +175,7 @@ echo "hi" | agent --model github-copilot/gpt-4o        # Uses Copilot
 
 See [MODELS.md](../MODELS.md) for complete list of available models and pricing.
 See [docs/groq.md](../docs/groq.md) for Groq provider documentation.
+See [docs/openrouter.md](../docs/openrouter.md) for OpenRouter provider documentation.
 See [docs/claude-oauth.md](../docs/claude-oauth.md) for Claude OAuth provider documentation.
 
 ### Direct Prompt Mode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.8.10",
+  "version": "0.8.13",
   "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/session/message-v2.ts

@@ -58,6 +58,21 @@ export namespace MessageV2 {
     typeof SocketConnectionError.Schema
   >;
 
+  /**
+   * Timeout error - caused by AbortSignal.timeout() firing when an API request
+   * takes too long. These are DOMException with name === 'TimeoutError'.
+   * These errors are transient and should be retried with increasing intervals.
+   * See: https://github.com/link-assistant/agent/issues/142
+   */
+  export const TimeoutError = NamedError.create(
+    'TimeoutError',
+    z.object({
+      message: z.string(),
+      isRetryable: z.literal(true),
+    })
+  );
+  export type TimeoutError = z.infer<typeof TimeoutError.Schema>;
+
   const PartBase = z.object({
     id: z.string(),
     sessionID: z.string(),
@@ -782,6 +797,11 @@ export namespace MessageV2 {
             cause: e,
           }
         ).toObject();
+      case e instanceof DOMException && e.name === 'TimeoutError':
+        return new MessageV2.TimeoutError(
+          { message: e.message, isRetryable: true },
+          { cause: e }
+        ).toObject();
       case MessageV2.OutputLengthError.isInstance(e):
         return e;
       case LoadAPIKeyError.isInstance(e):
@@ -816,6 +836,18 @@ export namespace MessageV2 {
             { cause: e }
           ).toObject();
         }
+        // Detect timeout errors from various sources
+        // See: https://github.com/link-assistant/agent/issues/142
+        const isTimeoutError =
+          message.includes('The operation timed out') ||
+          message.includes('timed out') ||
+          e.name === 'TimeoutError';
+        if (isTimeoutError) {
+          return new MessageV2.TimeoutError(
+            { message, isRetryable: true },
+            { cause: e }
+          ).toObject();
+        }
         return new NamedError.Unknown(
           { message: e.toString() },
           { cause: e }

package/src/session/processor.ts

@@ -326,21 +326,31 @@ export namespace SessionProcessor {
               providerID: input.providerID,
             });
 
-            // Check if error is retryable (APIError or SocketConnectionError)
+            // Check if error is retryable (APIError, SocketConnectionError, or TimeoutError)
             const isRetryableAPIError =
               error?.name === 'APIError' && error.data.isRetryable;
             const isRetryableSocketError =
               error?.name === 'SocketConnectionError' &&
               error.data.isRetryable &&
               attempt < SessionRetry.SOCKET_ERROR_MAX_RETRIES;
+            const isRetryableTimeoutError =
+              error?.name === 'TimeoutError' &&
+              error.data.isRetryable &&
+              attempt < SessionRetry.TIMEOUT_MAX_RETRIES;
 
-            if (isRetryableAPIError || isRetryableSocketError) {
+            if (
+              isRetryableAPIError ||
+              isRetryableSocketError ||
+              isRetryableTimeoutError
+            ) {
               attempt++;
-              // Use socket-specific delay for socket errors
+              // Use error-specific delay calculation
               const delay =
                 error?.name === 'SocketConnectionError'
                   ? SessionRetry.socketErrorDelay(attempt)
-                  : SessionRetry.delay(error, attempt);
+                  : error?.name === 'TimeoutError'
+                    ? SessionRetry.timeoutDelay(attempt)
+                    : SessionRetry.delay(error, attempt);
               log.info(() => ({
                 message: 'retrying',
                 errorType: error?.name,

package/src/session/retry.ts

@@ -13,6 +13,12 @@ export namespace SessionRetry {
   export const SOCKET_ERROR_INITIAL_DELAY = 1000; // 1 second
   export const SOCKET_ERROR_BACKOFF_FACTOR = 2;
 
+  // Timeout error retry configuration
+  // When API requests time out (AbortSignal.timeout), retry with increasing intervals
+  // See: https://github.com/link-assistant/agent/issues/142
+  export const TIMEOUT_MAX_RETRIES = 3;
+  export const TIMEOUT_DELAYS = [30_000, 60_000, 120_000]; // 30s, 60s, 120s
+
   export async function sleep(ms: number, signal: AbortSignal): Promise<void> {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(resolve, ms);
@@ -71,4 +77,14 @@ export namespace SessionRetry {
       Math.pow(SOCKET_ERROR_BACKOFF_FACTOR, attempt - 1)
     );
   }
+
+  /**
+   * Calculate delay for timeout error retries.
+   * Uses fixed intervals: 30s, 60s, 120s.
+   * See: https://github.com/link-assistant/agent/issues/142
+   */
+  export function timeoutDelay(attempt: number): number {
+    const index = Math.min(attempt - 1, TIMEOUT_DELAYS.length - 1);
+    return TIMEOUT_DELAYS[index];
+  }
 }