@solar_orb/agent_orb 0.1.0 → 0.1.3

package/README.md

@@ -23,7 +23,15 @@ npm --prefix packages/agent_orb run package-runtime
 npx --yes ./packages/agent_orb setup --yes
 ```
 
-If `packages/agent_orb/releases` contains a matching native bundle, setup installs that bundle directly with SHA256 verification. Otherwise it falls back to source build.
+If `packages/agent_orb/releases` contains a matching native bundle, setup installs that bundle directly with SHA256 verification. Otherwise it falls back to source build. On Windows, setup also adds the runtime bin directory to the user PATH so a new terminal can run `agent_orb-codex`, `agent_orb-claude`, `agent_orb`, `codex-orb`, and `claude-orb` directly. The adapter launchers start the orb UI if needed before running the target CLI.
+
+Upgrade or repair an existing install:
+
+```bash
+npx @solar_orb/agent_orb upgrade --yes
+```
+
+The upgrade flow verifies the new bundle before stopping the old daemon/orb UI and removing old runtime files.
 
 ## Windows local path
 
@@ -55,5 +63,5 @@ For Windows-host testing, prefer either:
 
 ```powershell
 cd $env:TEMP\agent-orb-npx
-npx --yes .\agent_orb-0.1.0.tgz --help
+npx --yes .\solar_orb-agent_orb-0.1.3.tgz --help
 ```

package/dist/adapter.js

@@ -5,6 +5,7 @@ export const adapters = [
         displayName: 'Codex CLI',
         binaryCandidates: process.platform === 'win32' ? ['codex.exe', 'codex'] : ['codex'],
         wrapperCommand: process.platform === 'win32' ? 'codex-orb.cmd' : 'codex-orb',
+        launcherCommand: process.platform === 'win32' ? 'agent_orb-codex.cmd' : 'agent_orb-codex',
         promptPatterns: ['approve', 'permission', 'continue?', 'yes/no'],
     },
     {
@@ -12,6 +13,7 @@ export const adapters = [
         displayName: 'Claude Code CLI',
         binaryCandidates: process.platform === 'win32' ? ['claude.exe', 'claude'] : ['claude'],
         wrapperCommand: process.platform === 'win32' ? 'claude-orb.cmd' : 'claude-orb',
+        launcherCommand: process.platform === 'win32' ? 'agent_orb-claude.cmd' : 'agent_orb-claude',
         promptPatterns: ['continue?', 'permission', 'press enter', 'approve'],
     },
 ];

package/dist/config.js

@@ -14,7 +14,7 @@ export function writeConfig(configDir, selectedAdapters, runtime = runtimeConfig
     fs.mkdirSync(configDir, { recursive: true });
     const configPath = path.join(configDir, 'config.toml');
     const enabled = new Set(selectedAdapters.map((adapter) => adapter.name));
-    const content = `# Generated by npx agent_orb\n\n[install]\nmethod = "npx"\nversion = "0.1.0"\n\n[adapters.codex]\nenabled = ${enabled.has('codex')}\nbinary = "codex"\nwrapper = "codex-orb"\n\n[adapters.claude]\nenabled = ${enabled.has('claude')}\nbinary = "claude"\nwrapper = "claude-orb"\n\n[daemon]\nhost = "${runtime.daemonHost}"\nport = ${runtime.daemonPort}\nauto_start = true\n\n[orb]\nposition = "top-right"\nsize = 36\nopacity = 0.88\nalways_on_top = true\nclick_through = false\n\n[colors]\ndisconnected = "#6B7280"\nidle = "#9CA3AF"\nstarting = "#60A5FA"\nactive = "#3B82F6"\nthinking_like = "#8B5CF6"\nwaiting_input = "#FBBF24"\ncompleted = "#22C55E"\nerror = "#EF4444"\nwarning = "#F97316"\n\n[behavior]\nsilent_threshold_seconds = 20\nstuck_threshold_seconds = 180\ncompleted_hold_seconds = 10\nerror_requires_click_to_clear = true\n\n[privacy]\ninclude_output_sample = false\nmax_sample_chars = 512\n`;
+    const content = `# Generated by npx agent_orb\n\n[install]\nmethod = "npx"\nversion = "0.1.3"\n\n[adapters.codex]\nenabled = ${enabled.has('codex')}\nbinary = "codex"\nwrapper = "agent_orb-codex"\n\n[adapters.claude]\nenabled = ${enabled.has('claude')}\nbinary = "claude"\nwrapper = "agent_orb-claude"\n\n[daemon]\nhost = "${runtime.daemonHost}"\nport = ${runtime.daemonPort}\nauto_start = true\n\n[orb]\nposition = "top-right"\nsize = 36\nopacity = 0.88\nalways_on_top = true\nclick_through = false\n\n[colors]\ndisconnected = "#6B7280"\nidle = "#9CA3AF"\nstarting = "#60A5FA"\nactive = "#3B82F6"\nthinking_like = "#8B5CF6"\nwaiting_input = "#FBBF24"\ncompleted = "#22C55E"\nerror = "#EF4444"\nwarning = "#F97316"\n\n[behavior]\nsilent_threshold_seconds = 20\nstuck_threshold_seconds = 180\ncompleted_hold_seconds = 10\nerror_requires_click_to_clear = true\n\n[privacy]\ninclude_output_sample = false\nmax_sample_chars = 512\n`;
     fs.writeFileSync(configPath, content, 'utf8');
     return configPath;
 }

package/dist/download.js

@@ -3,7 +3,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { parseChecksums, verifyChecksum } from './checksum.js';
-import { run } from './shell.js';
+import { commandExists, run } from './shell.js';
 export async function installRuntimeBundle(platform, options = {}) {
     if (!options.force && runtimeLooksInstalled(platform)) {
         console.log('\n==> Runtime bundle');
@@ -28,6 +28,7 @@ export async function installRuntimeBundle(platform, options = {}) {
         }
         verifyChecksum(bundlePath, expected);
         console.log(`✓ checksum verified: ${platform.bundleName}`);
+        cleanupInstalledRuntime(platform);
         extractBundle(bundlePath, tempDir, platform);
         writeInstallManifest(platform, {
             bundle: platform.bundleName,
@@ -45,6 +46,55 @@ export function runtimeLooksInstalled(platform) {
     const required = ['agent_orb', 'agent_orbd'].map((name) => path.join(platform.runtimeDir, `${name}${platform.exeSuffix}`));
     return required.every((file) => fs.existsSync(file));
 }
+export function cleanupInstalledRuntime(platform) {
+    if (!fs.existsSync(platform.runtimeDir))
+        return;
+    console.log('\n==> Cleaning previous runtime files');
+    stopRuntimeProcesses(platform);
+    for (const filename of knownRuntimeFiles(platform)) {
+        const filePath = path.join(platform.runtimeDir, filename);
+        if (!fs.existsSync(filePath))
+            continue;
+        fs.rmSync(filePath, { force: true });
+        console.log(`✓ removed ${filePath}`);
+    }
+}
+function stopRuntimeProcesses(platform) {
+    if (platform.platform === 'windows') {
+        for (const imageName of ['agent_orbd.exe', 'agent-orb-ui.exe']) {
+            run('taskkill', ['/F', '/T', '/IM', imageName], {
+                allowFailure: true,
+            });
+        }
+        return;
+    }
+    if (!commandExists('pkill'))
+        return;
+    for (const processName of ['agent_orbd', 'agent-orb-ui']) {
+        run('pkill', ['-x', processName], {
+            allowFailure: true,
+        });
+    }
+}
+function knownRuntimeFiles(platform) {
+    const executableNames = [
+        `agent_orb${platform.exeSuffix}`,
+        `agent_orbd${platform.exeSuffix}`,
+        `agent-orb-ui${platform.exeSuffix}`,
+    ];
+    return [
+        ...executableNames,
+        'agent-orb-runtime.json',
+        'agent_orb-codex',
+        'agent_orb-claude',
+        'codex-orb',
+        'claude-orb',
+        'agent_orb-codex.cmd',
+        'agent_orb-claude.cmd',
+        'codex-orb.cmd',
+        'claude-orb.cmd',
+    ];
+}
 function releaseBaseUrl(platform, options) {
     if (options.releaseDir) {
         return pathToFileURL(path.resolve(options.releaseDir)).href;
@@ -61,12 +111,18 @@ function releaseBaseUrl(platform, options) {
     const bundled = bundledReleaseBaseUrl(platform);
     if (bundled)
         return bundled;
-    const version = process.env.AGENT_ORB_VERSION ?? 'v0.1.0';
+    const version = process.env.AGENT_ORB_VERSION ?? defaultReleaseVersion() ?? 'v0.1.0';
     const repo = githubRepository();
     if (repo)
         return `https://github.com/${repo}/releases/download/${version}`;
     return undefined;
 }
+function defaultReleaseVersion() {
+    const version = readPackageVersion();
+    if (!version)
+        return undefined;
+    return version.startsWith('v') ? version : `v${version}`;
+}
 function githubRepository() {
     const configured = process.env.AGENT_ORB_GITHUB_REPOSITORY;
     if (configured?.trim())
@@ -80,11 +136,18 @@ function githubRepository() {
     return undefined;
 }
 function readPackageGithubRepository() {
+    const packageJson = readPackageJson();
+    const repo = packageJson?.config?.github_repository;
+    return typeof repo === 'string' && repo.trim() ? repo.trim() : undefined;
+}
+function readPackageVersion() {
+    const version = readPackageJson()?.version;
+    return typeof version === 'string' && version.trim() ? version.trim() : undefined;
+}
+function readPackageJson() {
     try {
         const packageJsonPath = fileURLToPath(new URL('../package.json', import.meta.url));
-        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-        const repo = packageJson.config?.github_repository;
-        return typeof repo === 'string' && repo.trim() ? repo.trim() : undefined;
+        return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
     }
     catch {
         return undefined;

package/dist/index.js

@@ -21,10 +21,20 @@ async function main() {
         case 'doctor':
             await doctor();
             break;
+        case 'upgrade':
+            await setup({
+                yes: flags.has('--yes') || flags.has('-y'),
+                smoke: !flags.has('--no-smoke'),
+                force: true,
+                buildFromSource: flags.has('--build-from-source'),
+                releaseBaseUrl: flagValue(args, '--release-base-url'),
+                releaseDir: flagValue(args, '--release-dir'),
+            });
+            break;
         case 'version':
         case '--version':
         case '-v':
-            console.log('agent_orb bootstrapper 0.1.0');
+            console.log('agent_orb bootstrapper 0.1.3');
             break;
         case 'help':
         case '--help':
@@ -65,6 +75,7 @@ Usage:
             [--release-dir <dir> | --release-base-url <url>]
             [--build-from-source]
   agent_orb doctor
+  agent_orb upgrade [--yes] [--no-smoke]
   agent_orb version
 
 Local development:

package/dist/setup.js

@@ -5,9 +5,9 @@ import { stdin as input, stdout as output } from 'node:process';
 import { fileURLToPath } from 'node:url';
 import { detectAdapters } from './adapter.js';
 import { runtimeConfigFromEnv, writeConfig } from './config.js';
-import { installRuntimeBundle } from './download.js';
+import { cleanupInstalledRuntime, installRuntimeBundle } from './download.js';
 import { detectPlatform } from './platform.js';
-import { commandExists, run, spawnDetached } from './shell.js';
+import { commandExists, getPathEnv, run, setPathEnv, spawnDetached } from './shell.js';
 export async function setup(options = {}) {
     const platform = detectPlatform();
     const runtime = runtimeConfigFromEnv();
@@ -39,17 +39,24 @@ export async function setup(options = {}) {
     }
     const configPath = writeConfig(platform.configDir, selectedAdapters, runtime);
     createAdapterShims(platform, selectedAdapters);
-    ensurePathHint(platform);
+    ensurePathConfigured(platform);
     await ensureDaemon(platform, runtime);
+    const orbStarted = startOrbUiIfAvailable(platform);
     if (options.smoke ?? true) {
         smokeTest(platform);
     }
     console.log('\n✓ Agent Orb setup complete');
     console.log(`Config: ${configPath}`);
-    console.log(`Try:    ${runtimeExe(platform, 'agent_orb')} run -- ${platform.platform === 'windows' ? 'cmd /C echo hello' : 'echo hello'}`);
+    console.log(`Try:    agent_orb run -- ${platform.platform === 'windows' ? 'cmd /C echo hello' : 'echo hello'}`);
+    if (selectedAdapters.some((adapter) => adapter.name === 'codex')) {
+        console.log('Codex:  agent_orb-codex');
+    }
+    if (selectedAdapters.some((adapter) => adapter.name === 'claude')) {
+        console.log('Claude: agent_orb-claude');
+    }
     const orb = runtimeExe(platform, 'agent-orb-ui');
     if (fs.existsSync(orb)) {
-        console.log(`Orb:    ${orb}`);
+        console.log(`Orb:    ${orbStarted ? 'started' : orb}`);
     }
 }
 function installRuntimeFromSource(platform) {
@@ -58,6 +65,7 @@ function installRuntimeFromSource(platform) {
     const repoRoot = findRepoRoot();
     console.log(`Repository: ${repoRoot}`);
     buildRuntime(repoRoot);
+    cleanupInstalledRuntime(platform);
     installRuntime(repoRoot, platform);
 }
 export async function doctor(platform = detectPlatform(), runtime = runtimeConfigFromEnv()) {
@@ -188,32 +196,128 @@ function createAdapterShims(platform, adapters) {
         return;
     console.log('\n==> Creating adapter shims');
     for (const adapter of adapters) {
-        const shimPath = path.join(platform.runtimeDir, adapter.wrapperCommand);
-        if (platform.platform === 'windows') {
-            const target = adapter.name;
-            fs.writeFileSync(shimPath, `@echo off\r\n"%~dp0agent_orb.exe" run -- ${target} %*\r\n`, 'ascii');
+        const commands = uniqueStrings([adapter.launcherCommand, adapter.wrapperCommand]);
+        for (const command of commands) {
+            const shimPath = path.join(platform.runtimeDir, command);
+            if (platform.platform === 'windows') {
+                fs.writeFileSync(shimPath, windowsAdapterShim(adapter.name), 'ascii');
+            }
+            else {
+                fs.writeFileSync(shimPath, unixAdapterShim(adapter.name), 'utf8');
+                fs.chmodSync(shimPath, 0o755);
+            }
+            console.log(`✓ ${shimPath}`);
         }
-        else {
-            fs.writeFileSync(shimPath, `#!/usr/bin/env sh\n"$(dirname "$0")/agent_orb" run -- ${adapter.name} "$@"\n`, 'utf8');
-            fs.chmodSync(shimPath, 0o755);
-        }
-        console.log(`✓ ${shimPath}`);
     }
 }
-function ensurePathHint(platform) {
-    const currentPath = process.env.PATH ?? '';
+function uniqueStrings(values) {
+    return [...new Set(values)];
+}
+function windowsAdapterShim(adapterName) {
+    return `@echo off\r\nsetlocal\r\nset "ORB_UI=%~dp0agent-orb-ui.exe"\r\nif exist "%ORB_UI%" (\r\n  tasklist /FI "IMAGENAME eq agent-orb-ui.exe" 2>NUL | find /I "agent-orb-ui.exe" >NUL\r\n  if errorlevel 1 start "" "%ORB_UI%"\r\n)\r\n"%~dp0agent_orb.exe" run -- ${adapterName} %*\r\nexit /b %ERRORLEVEL%\r\n`;
+}
+function unixAdapterShim(adapterName) {
+    return `#!/usr/bin/env sh\nset -eu\nDIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)\nORB_UI="$DIR/agent-orb-ui"\nif [ -x "$ORB_UI" ] && { [ -n "\${DISPLAY:-}" ] || [ -n "\${WAYLAND_DISPLAY:-}" ]; }; then\n  running=0\n  if command -v pgrep >/dev/null 2>&1 && pgrep -x agent-orb-ui >/dev/null 2>&1; then\n    running=1\n  fi\n  if [ "$running" = "0" ]; then\n    "$ORB_UI" >/dev/null 2>&1 &\n  fi\nfi\nexec "$DIR/agent_orb" run -- ${adapterName} "$@"\n`;
+}
+function ensurePathConfigured(platform) {
+    const currentPath = getPathEnv();
     const parts = currentPath.split(platform.pathDelimiter).filter(Boolean);
-    if (parts.includes(platform.runtimeDir))
+    if (pathPartsContain(parts, platform.runtimeDir, platform)) {
+        console.log(`✓ runtime dir already on PATH: ${platform.runtimeDir}`);
         return;
+    }
+    setPathEnv(`${platform.runtimeDir}${platform.pathDelimiter}${currentPath}`);
     console.log('\nPATH note:');
     if (platform.platform === 'windows') {
-        console.log(`  Add to user PATH if needed: ${platform.runtimeDir}`);
-        console.log('  Or open a new terminal if installer/script already added it.');
+        if (addWindowsUserPath(platform.runtimeDir)) {
+            console.log(`  ✓ added runtime dir to user PATH: ${platform.runtimeDir}`);
+            console.log('  Open a new terminal to use agent_orb-codex, agent_orb-claude, and agent_orb globally.');
+        }
+        else {
+            console.log(`  Could not update user PATH automatically. Add manually if needed: ${platform.runtimeDir}`);
+        }
     }
     else {
         console.log(`  export PATH="${platform.runtimeDir}:$PATH"`);
     }
 }
+function pathPartsContain(parts, target, platform) {
+    const normalizedTarget = normalizePathForCompare(target, platform);
+    return parts.some((part) => normalizePathForCompare(part, platform) === normalizedTarget);
+}
+function normalizePathForCompare(value, platform) {
+    const trimmed = value.trim().replace(/[\\/]+$/, '');
+    return platform.platform === 'windows' ? trimmed.toLowerCase() : trimmed;
+}
+function addWindowsUserPath(targetDir) {
+    const script = [
+        '$target = $env:AGENT_ORB_TARGET_PATH',
+        "$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')",
+        '$parts = @()',
+        'if ($userPath) { $parts = $userPath -split \';\' | Where-Object { $_ } }',
+        '$normalizedTarget = $target.TrimEnd("\\").ToLowerInvariant()',
+        '$exists = $false',
+        'foreach ($part in $parts) {',
+        '  if ($part.TrimEnd("\\").ToLowerInvariant() -eq $normalizedTarget) { $exists = $true; break }',
+        '}',
+        'if (-not $exists) {',
+        "  [Environment]::SetEnvironmentVariable('Path', (($parts + $target) -join ';'), 'User')",
+        '}',
+    ].join('; ');
+    try {
+        run('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', script], {
+            env: {
+                ...process.env,
+                AGENT_ORB_TARGET_PATH: targetDir,
+            },
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function startOrbUiIfAvailable(platform) {
+    const orb = runtimeExe(platform, 'agent-orb-ui');
+    if (!fs.existsSync(orb))
+        return false;
+    if (platform.platform === 'windows') {
+        if (isWindowsProcessRunning('agent-orb-ui.exe'))
+            return true;
+        spawnDetached(orb, []);
+        return true;
+    }
+    if (!process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
+        return false;
+    if (isUnixProcessRunning('agent-orb-ui'))
+        return true;
+    spawnDetached(orb, []);
+    return true;
+}
+function isWindowsProcessRunning(imageName) {
+    try {
+        const result = run('tasklist', ['/FI', `IMAGENAME eq ${imageName}`], {
+            allowFailure: true,
+        });
+        return result.stdout.toLowerCase().includes(imageName.toLowerCase());
+    }
+    catch {
+        return false;
+    }
+}
+function isUnixProcessRunning(processName) {
+    if (!commandExists('pgrep'))
+        return false;
+    try {
+        const result = run('pgrep', ['-x', processName], {
+            allowFailure: true,
+        });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
 async function ensureDaemon(platform, runtime) {
     console.log('\n==> Starting daemon');
     const tokenPath = path.join(platform.configDir, 'token');

package/dist/shell.js

@@ -5,7 +5,7 @@ export function commandExists(command) {
     return findCommand(command) !== undefined;
 }
 export function findCommand(command) {
-    const pathEnv = process.env.PATH ?? '';
+    const pathEnv = getPathEnv();
     const searchDirs = pathEnv.split(process.platform === 'win32' ? ';' : ':').filter(Boolean);
     const candidates = process.platform === 'win32'
         ? commandCandidates(command)
@@ -19,6 +19,21 @@ export function findCommand(command) {
     }
     return undefined;
 }
+export function getPathEnv() {
+    if (process.platform !== 'win32')
+        return process.env.PATH ?? '';
+    const pathKey = Object.keys(process.env).find((key) => key.toLowerCase() === 'path');
+    return pathKey ? process.env[pathKey] ?? '' : process.env.PATH ?? '';
+}
+export function setPathEnv(value) {
+    if (process.platform !== 'win32') {
+        process.env.PATH = value;
+        return;
+    }
+    const pathKey = Object.keys(process.env).find((key) => key.toLowerCase() === 'path') ?? 'Path';
+    process.env[pathKey] = value;
+    process.env.PATH = value;
+}
 export function run(command, args, options = {}) {
     const result = spawnSync(command, args, {
         cwd: options.cwd,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solar_orb/agent_orb",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Agent Orb local bootstrapper",
   "type": "module",
   "config": {