opencodespaces 1.2.0 → 1.8.0

package/dist/BUILD_TEST.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Build Test File
+ *
+ * This file exists to trigger CI/CD builds for testing purposes.
+ * Modify the timestamp below to trigger a new build.
+ *
+ * Last modified: 2026-01-19T00:30:00Z
+ */
+export declare const BUILD_TEST_TIMESTAMP = "2026-01-19T00:30:00Z";

package/dist/BUILD_TEST.js

@@ -0,0 +1,9 @@
+/**
+ * Build Test File
+ *
+ * This file exists to trigger CI/CD builds for testing purposes.
+ * Modify the timestamp below to trigger a new build.
+ *
+ * Last modified: 2026-01-19T00:30:00Z
+ */
+export const BUILD_TEST_TIMESTAMP = '2026-01-19T00:30:00Z';

package/dist/commands/sync.js

@@ -116,33 +116,18 @@ async function startSync(sessionId, localDir) {
     const spinner = ora('Initializing sync...').start();
     try {
         // Initialize sync on server (get SSH credentials)
+        // The API auto-cleans stale connections, but handle 409 as fallback
         let syncInfo;
         try {
             syncInfo = await api.initSync(sessionId);
         }
         catch (initError) {
-            // Handle "Sync already active" error (409)
             if (initError instanceof ApiError && initError.statusCode === 409) {
-                spinner.stop();
-                logger.warn('A previous sync connection exists on the server.');
-                const { cleanup } = await inquirer.prompt([
-                    {
-                        type: 'confirm',
-                        name: 'cleanup',
-                        message: 'Clean up stale connection and retry?',
-                        default: true,
-                    },
-                ]);
-                if (cleanup) {
-                    spinner.start('Cleaning up stale connection...');
-                    await api.stopSync(sessionId);
-                    spinner.text = 'Initializing sync...';
-                    syncInfo = await api.initSync(sessionId);
-                }
-                else {
-                    logger.info('Run "opencodespaces sync stop" to manually clean up.');
-                    process.exit(0);
-                }
+                // Fallback: force cleanup and retry (API should auto-clean, but just in case)
+                spinner.text = 'Cleaning up stale connection...';
+                await api.stopSync(sessionId);
+                spinner.text = 'Initializing sync...';
+                syncInfo = await api.initSync(sessionId);
             }
             else {
                 throw initError;
@@ -176,7 +161,20 @@ async function startSync(sessionId, localDir) {
             'two-way-resolved',
             ...ignoreArgs,
         ];
-        execFileSync('mutagen', mutagenArgs, { stdio: 'pipe' });
+        try {
+            execFileSync('mutagen', mutagenArgs, { stdio: 'pipe' });
+        }
+        catch (mutagenError) {
+            const errorMsg = mutagenError?.stderr?.toString() ||
+                mutagenError.message;
+            if (errorMsg.includes('unable to locate agent bundle') ||
+                errorMsg.includes('unable to install agent')) {
+                throw new Error('Mutagen agent installation failed. Your mutagen installation may be missing agent bundles.\n' +
+                    'Fix: Download the full mutagen release from https://github.com/mutagen-io/mutagen/releases\n' +
+                    'and ensure mutagen-agents.tar.gz is next to the mutagen binary.');
+            }
+            throw mutagenError;
+        }
         spinner.succeed(`Syncing ${localPath} ↔ ${hostAlias}:${remotePath}`);
         logger.log('');
         logger.warn('Note: node_modules and other large directories are excluded by default.');
@@ -366,18 +364,36 @@ async function ensureSshConfigIncludes() {
     }
 }
 /**
- * Check if Mutagen is installed
+ * Check if Mutagen is installed and warn about missing agent bundles on Linux
  */
 function checkDependencies() {
     try {
         execSync('mutagen version', { stdio: 'pipe' });
+        // Warn about missing agent bundles (common Linux issue)
+        if (process.platform === 'linux') {
+            try {
+                const mutagenPath = execSync('which mutagen', { encoding: 'utf-8' }).trim();
+                const mutagenDir = path.dirname(mutagenPath);
+                const bundlePaths = [
+                    path.join(mutagenDir, 'mutagen-agents.tar.gz'),
+                    '/usr/local/libexec/mutagen-agents.tar.gz',
+                ];
+                if (!bundlePaths.some(p => fs.existsSync(p))) {
+                    logger.warn('mutagen-agents.tar.gz not found. Sync relies on the container\'s pre-installed agent.');
+                    logger.dim('For best compatibility, download the full mutagen release archive.');
+                }
+            }
+            catch {
+                // Non-critical, continue
+            }
+        }
     }
     catch {
         logger.error('Mutagen not found. Please install it:');
         logger.log('');
         logger.log('  macOS:   brew install mutagen-io/mutagen/mutagen');
-        logger.log('  Linux:   Download from https://mutagen.io/documentation/introduction/installation');
-        logger.log('  Windows: Download from https://mutagen.io/documentation/introduction/installation');
+        logger.log('  Linux:   Download FULL archive from https://github.com/mutagen-io/mutagen/releases');
+        logger.log('           (must include mutagen-agents.tar.gz)');
         logger.log('');
         process.exit(1);
     }

package/dist/index.js

@@ -36,6 +36,3 @@ sessionsCommand(program);
 syncCommand(program);
 sshCommand(program);
 program.parse();
-// test
-// v2
-// Workflow test 2026-01-18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencodespaces",
-  "version": "1.2.0",
+  "version": "1.8.0",
   "description": "CLI for OpenCodeSpaces - Connect your local IDE to cloud sessions",
   "type": "module",
   "bin": {