@link-assistant/agent 0.8.14 → 0.8.16

package/README.md

@@ -46,18 +46,77 @@ This is an MVP implementation of an OpenCode-compatible CLI agent, focused on ma
 
 ## Installation
 
+### Step-by-step (recommended for first-time users)
+
 ```bash
-# Install Bun first if you haven't already
+# Step 1: Install Bun (skip if already installed)
 curl -fsSL https://bun.sh/install | bash
 
-# Install the package globally
+# Step 2: Apply PATH changes (IMPORTANT — required before using bun)
+source ~/.bashrc  # For Bash (default on most Linux systems)
+# source ~/.zshrc  # For Zsh (default on macOS)
+
+# Step 3: Verify Bun is installed
+bun --version
+
+# Step 4: Install the agent globally
+bun install -g @link-assistant/agent
+
+# Step 5: Verify the agent is installed
+agent --version
+
+# Step 6: Run for a test
+echo "hi" | agent
+```
+
+### Quick install (if you already have Bun)
+
+```bash
 bun install -g @link-assistant/agent
+```
 
-# Or install locally in your project
+### Local install (in your project)
+
+```bash
 bun add @link-assistant/agent
 ```
 
-After installation, the `agent` command will be available globally.
+After global installation, the `agent` command will be available in any terminal session.
+
+### Troubleshooting
+
+**`bun: command not found` after installation:**
+
+The Bun installer adds `~/.bun/bin` to your shell configuration file, but the change only takes effect after reloading it. Run:
+
+```bash
+source ~/.bashrc  # or source ~/.zshrc for Zsh
+```
+
+Or restart your terminal.
+
+**`agent: command not found` after `bun install -g`:**
+
+Global packages installed by Bun are placed in `~/.bun/bin`. If this directory is not in your PATH, the `agent` command won't be found. Ensure your shell configuration includes:
+
+```bash
+export BUN_INSTALL="$HOME/.bun"
+export PATH="$BUN_INSTALL/bin:$PATH"
+```
+
+Then reload with `source ~/.bashrc` (or `~/.zshrc`), or restart your terminal.
+
+**Still not working?**
+
+Try reinstalling Bun from scratch:
+
+```bash
+rm -rf ~/.bun
+curl -fsSL https://bun.sh/install | bash
+source ~/.bashrc
+bun install -g @link-assistant/agent
+agent --version
+```
 
 ## Uninstallation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.8.14",
+  "version": "0.8.16",
   "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/continuous-mode.js

@@ -391,6 +391,8 @@ export async function runContinuousServerMode(
           waitForPending();
         }
       }, 100);
+      // Allow process to exit naturally when no other work remains
+      checkRunning.unref();
 
       // Also handle SIGINT
       process.on('SIGINT', () => {
@@ -608,6 +610,8 @@ export async function runContinuousDirectMode(
           waitForPending();
         }
       }, 100);
+      // Allow process to exit naturally when no other work remains
+      checkRunning.unref();
 
       // Also handle SIGINT
       process.on('SIGINT', () => {

package/src/flag/flag.ts

@@ -63,6 +63,25 @@ export namespace Flag {
     'OPENCODE_DRY_RUN'
   );
 
+  // Stream timeout configuration
+  // chunkMs: timeout between stream chunks - detects stalled streams (default: 2 minutes)
+  // stepMs: timeout for each individual LLM step (default: 10 minutes)
+  export function STREAM_CHUNK_TIMEOUT_MS(): number {
+    const val = getEnv(
+      'LINK_ASSISTANT_AGENT_STREAM_CHUNK_TIMEOUT_MS',
+      'AGENT_STREAM_CHUNK_TIMEOUT_MS'
+    );
+    return val ? parseInt(val, 10) : 120_000;
+  }
+
+  export function STREAM_STEP_TIMEOUT_MS(): number {
+    const val = getEnv(
+      'LINK_ASSISTANT_AGENT_STREAM_STEP_TIMEOUT_MS',
+      'AGENT_STREAM_STEP_TIMEOUT_MS'
+    );
+    return val ? parseInt(val, 10) : 600_000;
+  }
+
   // Compact JSON mode - output JSON on single lines (NDJSON format)
   // Enabled by AGENT_CLI_COMPACT env var or --compact-json flag
   // Uses getter to check env var at runtime for tests

package/src/session/prompt.ts

@@ -613,6 +613,10 @@ export namespace SessionPrompt {
 
       const result = await processor.process(() =>
         streamText({
+          timeout: {
+            chunkMs: Flag.STREAM_CHUNK_TIMEOUT_MS(),
+            stepMs: Flag.STREAM_STEP_TIMEOUT_MS(),
+          },
           onError(error) {
             log.error(() => ({ message: 'stream error', error }));
           },