@link-assistant/agent 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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/bun/index.ts

@@ -4,6 +4,7 @@ import { Log } from '../util/log';
 import path from 'path';
 import { NamedError } from '../util/error';
 import { readableStreamToText } from 'bun';
+import { Flag } from '../flag/flag';
 
 export namespace BunProc {
   const log = Log.create({ service: 'bun' });
@@ -43,7 +44,10 @@ export namespace BunProc {
       stderr,
     });
     if (code !== 0) {
-      throw new Error(`Command failed with exit code ${result.exitCode}`);
+      const parts = [`Command failed with exit code ${result.exitCode}`];
+      if (stderr) parts.push(`stderr: ${stderr}`);
+      if (stdout) parts.push(`stdout: ${stdout}`);
+      throw new Error(parts.join('\n'));
     }
     return result;
   }
@@ -57,6 +61,7 @@ export namespace BunProc {
     z.object({
       pkg: z.string(),
       version: z.string(),
+      details: z.string().optional(),
     })
   );
 
@@ -70,6 +75,20 @@ export namespace BunProc {
     });
     if (parsed.dependencies[pkg] === version) return mod;
 
+    // Check for dry-run mode
+    if (Flag.OPENCODE_DRY_RUN) {
+      log.info(
+        '[DRY RUN] Would install package (skipping actual installation)',
+        {
+          pkg,
+          version,
+          targetPath: mod,
+        }
+      );
+      // In dry-run mode, pretend the package is installed
+      return mod;
+    }
+
     // Build command arguments
     const args = [
       'add',
@@ -92,13 +111,20 @@ export namespace BunProc {
     await BunProc.run(args, {
       cwd: Global.Path.cache,
     }).catch((e) => {
+      log.error('package installation failed', {
+        pkg,
+        version,
+        error: e instanceof Error ? e.message : String(e),
+        stack: e instanceof Error ? e.stack : undefined,
+      });
       throw new InstallFailedError(
-        { pkg, version },
+        { pkg, version, details: e instanceof Error ? e.message : String(e) },
         {
           cause: e,
         }
       );
     });
+    log.info('package installed successfully', { pkg, version });
     parsed.dependencies[pkg] = version;
     await Bun.write(pkgjson.name!, JSON.stringify(parsed, null, 2));
     return mod;

package/src/flag/flag.ts

@@ -22,11 +22,19 @@ export namespace Flag {
   // Verbose mode - enables detailed logging of API requests
   export let OPENCODE_VERBOSE = truthy('OPENCODE_VERBOSE');
 
+  // Dry run mode - simulate operations without making actual API calls or changes
+  export let OPENCODE_DRY_RUN = truthy('OPENCODE_DRY_RUN');
+
   // Allow setting verbose mode programmatically (e.g., from CLI --verbose flag)
   export function setVerbose(value: boolean) {
     OPENCODE_VERBOSE = value;
   }
 
+  // Allow setting dry run mode programmatically (e.g., from CLI --dry-run flag)
+  export function setDryRun(value: boolean) {
+    OPENCODE_DRY_RUN = value;
+  }
+
   function truthy(key: string) {
     const value = process.env[key]?.toLowerCase();
     return value === 'true' || value === '1';

package/src/global/index.ts

@@ -24,6 +24,7 @@ export namespace Global {
 
 await Promise.all([
   fs.mkdir(Global.Path.data, { recursive: true }),
+  fs.mkdir(Global.Path.cache, { recursive: true }),
   fs.mkdir(Global.Path.config, { recursive: true }),
   fs.mkdir(Global.Path.state, { recursive: true }),
   fs.mkdir(Global.Path.log, { recursive: true }),

package/src/index.js

@@ -110,6 +110,13 @@ async function runAgentMode(argv) {
     console.error(`Script path: ${import.meta.path}`);
   }
 
+  // Log dry-run mode if enabled
+  if (Flag.OPENCODE_DRY_RUN) {
+    console.error(
+      `[DRY RUN MODE] No actual API calls or package installations will be made`
+    );
+  }
+
   // Parse model argument (handle model IDs with slashes like groq/qwen/qwen3-32b)
   const modelParts = argv.model.split('/');
   let providerID = modelParts[0] || 'opencode';
@@ -574,6 +581,12 @@ async function main() {
           'Enable verbose mode to debug API requests (shows system prompt, token counts, etc.)',
         default: false,
       })
+      .option('dry-run', {
+        type: 'boolean',
+        description:
+          'Simulate operations without making actual API calls or package installations (useful for testing)',
+        default: false,
+      })
       .option('use-existing-claude-oauth', {
         type: 'boolean',
         description:
@@ -588,6 +601,11 @@ async function main() {
           Flag.setVerbose(true);
         }
 
+        // Set dry-run flag if requested
+        if (argv['dry-run']) {
+          Flag.setDryRun(true);
+        }
+
         // Initialize logging system
         // - If verbose: print logs to stderr for debugging
         // - Otherwise: write logs to file to keep CLI output clean

package/src/provider/provider.ts

@@ -721,7 +721,17 @@ export namespace Provider {
 
       let installedPath: string;
       if (!pkg.startsWith('file://')) {
+        log.info('installing provider package', {
+          providerID: provider.id,
+          pkg,
+          version: 'latest',
+        });
         installedPath = await BunProc.install(pkg, 'latest');
+        log.info('provider package installed successfully', {
+          providerID: provider.id,
+          pkg,
+          installedPath,
+        });
       } else {
         log.info('loading local provider', { pkg });
         installedPath = pkg;
@@ -769,6 +779,13 @@ export namespace Provider {
       s.sdk.set(key, loaded);
       return loaded as SDK;
     })().catch((e) => {
+      log.error('provider initialization failed', {
+        providerID: provider.id,
+        pkg: model.provider?.npm ?? provider.npm ?? provider.id,
+        error: e instanceof Error ? e.message : String(e),
+        stack: e instanceof Error ? e.stack : undefined,
+        cause: e instanceof Error && e.cause ? String(e.cause) : undefined,
+      });
       throw new InitError({ providerID: provider.id }, { cause: e });
     });
   }