@solar_orb/agent_orb 0.1.0 → 0.1.2

package/README.md

@@ -23,7 +23,7 @@ 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.
 
 ## Windows local path
 
@@ -55,5 +55,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.2.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.2"\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/index.js

@@ -24,7 +24,7 @@ async function main() {
         case 'version':
         case '--version':
         case '-v':
-            console.log('agent_orb bootstrapper 0.1.0');
+            console.log('agent_orb bootstrapper 0.1.2');
             break;
         case 'help':
         case '--help':

package/dist/setup.js

@@ -7,7 +7,7 @@ import { detectAdapters } from './adapter.js';
 import { runtimeConfigFromEnv, writeConfig } from './config.js';
 import { 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) {
@@ -188,32 +195,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.2",
   "description": "Agent Orb local bootstrapper",
   "type": "module",
   "config": {