@agentuity/cli 0.0.86 → 0.0.87

package/dist/utils/dependency-checker.js

@@ -0,0 +1,161 @@
+import { $ } from 'bun';
+import { join } from 'node:path';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { getVersion } from '../version';
+/**
+ * Checks if a version specifier should be upgraded
+ * @param specifier - The version specifier from package.json (e.g., "latest", "^1.0.0", "1.2.3")
+ * @returns true if the package should be upgraded
+ */
+export function shouldUpgradeVersion(specifier) {
+    // Always upgrade "latest" and "*"
+    if (specifier === 'latest' || specifier === '*') {
+        return true;
+    }
+    // Skip pinned versions (exact semver like "1.2.3")
+    if (/^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/.test(specifier)) {
+        return false;
+    }
+    // Upgrade ranges (^1.0.0, ~1.0.0, >=1.0.0, etc.)
+    // Check if the specifier is a range pattern
+    if (/^[~^>=<]/.test(specifier)) {
+        return true;
+    }
+    // Default to not upgrading if we can't determine
+    return false;
+}
+/**
+ * Check and upgrade @agentuity/* dependencies to match CLI version
+ * @param projectDir - Root directory of the user's project
+ * @param logger - Logger instance
+ * @returns Result of the upgrade operation
+ */
+export async function checkAndUpgradeDependencies(projectDir, logger) {
+    const result = {
+        upgraded: [],
+        skipped: [],
+        failed: [],
+    };
+    // Skip in CI/non-interactive environments
+    if (!process.stdin.isTTY) {
+        logger.debug('Skipping dependency check in non-interactive environment');
+        return result;
+    }
+    const packageJsonPath = join(projectDir, 'package.json');
+    const cliVersion = getVersion();
+    logger.debug('CLI version: %s', cliVersion);
+    // Read package.json
+    let packageJson;
+    try {
+        packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    }
+    catch (error) {
+        logger.debug('Failed to read package.json: %s', error);
+        return result;
+    }
+    // Collect all @agentuity/* packages and their original specifiers
+    const allDeps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies,
+    };
+    const agentuitPackages = Object.entries(allDeps)
+        .filter(([name]) => name.startsWith('@agentuity/'))
+        .map(([name, specifier]) => ({ name, specifier }));
+    if (agentuitPackages.length === 0) {
+        logger.debug('No @agentuity/* packages found in package.json');
+        return result;
+    }
+    // Check which packages need upgrading
+    const packagesToUpgrade = agentuitPackages.filter(({ specifier }) => shouldUpgradeVersion(specifier));
+    if (packagesToUpgrade.length === 0) {
+        logger.debug('All @agentuity/* packages are pinned, skipping upgrade');
+        for (const pkg of agentuitPackages) {
+            result.skipped.push(pkg.name);
+        }
+        return result;
+    }
+    // Check if CLI version is different from installed packages
+    let needsUpgrade = false;
+    for (const { name } of packagesToUpgrade) {
+        try {
+            const installedPackageJson = JSON.parse(readFileSync(join(projectDir, 'node_modules', name, 'package.json'), 'utf-8'));
+            const installedVersion = installedPackageJson.version;
+            if (installedVersion !== cliVersion) {
+                logger.debug('%s: installed=%s, cli=%s (needs upgrade)', name, installedVersion, cliVersion);
+                needsUpgrade = true;
+            }
+            else {
+                logger.debug('%s: already at correct version %s', name, installedVersion);
+            }
+        }
+        catch {
+            // Package not installed or can't read version - needs upgrade
+            logger.debug('%s: not installed or unreadable, needs upgrade', name);
+            needsUpgrade = true;
+        }
+    }
+    if (!needsUpgrade) {
+        logger.debug('All @agentuity/* packages are already at CLI version');
+        for (const pkg of packagesToUpgrade) {
+            result.skipped.push(pkg.name);
+        }
+        return result;
+    }
+    // Upgrade packages
+    logger.debug('Upgrading %d @agentuity/* package(s) to %s', packagesToUpgrade.length, cliVersion);
+    for (const { name } of packagesToUpgrade) {
+        try {
+            logger.debug('Installing %s@%s', name, cliVersion);
+            const installResult = await $ `bun add ${name}@${cliVersion}`
+                .cwd(projectDir)
+                .quiet()
+                .nothrow();
+            if (installResult.exitCode !== 0) {
+                logger.error('Failed to install %s@%s: %s', name, cliVersion, installResult.stderr.toString());
+                result.failed.push(name);
+            }
+            else {
+                logger.debug('Successfully installed %s@%s', name, cliVersion);
+                result.upgraded.push(name);
+            }
+        }
+        catch (_error) {
+            logger.error('Error installing %s: %s', name, _error);
+            result.failed.push(name);
+        }
+    }
+    // Restore original version specifiers in package.json
+    // (bun add replaces them with specific versions)
+    if (result.upgraded.length > 0) {
+        try {
+            const updatedPackageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            let modified = false;
+            for (const { name, specifier } of packagesToUpgrade) {
+                // Only restore if we successfully upgraded
+                if (!result.upgraded.includes(name)) {
+                    continue;
+                }
+                // Check both dependencies and devDependencies
+                if (updatedPackageJson.dependencies?.[name]) {
+                    updatedPackageJson.dependencies[name] = specifier;
+                    modified = true;
+                    logger.debug('Restored %s to "%s" in dependencies', name, specifier);
+                }
+                if (updatedPackageJson.devDependencies?.[name]) {
+                    updatedPackageJson.devDependencies[name] = specifier;
+                    modified = true;
+                    logger.debug('Restored %s to "%s" in devDependencies', name, specifier);
+                }
+            }
+            if (modified) {
+                writeFileSync(packageJsonPath, JSON.stringify(updatedPackageJson, null, 2) + '\n');
+                logger.debug('Restored original version specifiers in package.json');
+            }
+        }
+        catch (_error) {
+            logger.warn('Failed to restore version specifiers in package.json: %s', _error);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=dependency-checker.js.map

package/dist/utils/dependency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.js","sourceRoot":"","sources":["../../src/utils/dependency-checker.ts"],"names":[],"mappings":"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"}

package/dist/version-check.d.ts

@@ -0,0 +1,13 @@
+import type { Config, Logger, CommandDefinition } from './types';
+/**
+ * Check for updates and optionally prompt to upgrade
+ * Should be called early in the CLI initialization, before commands execute
+ */
+export declare function checkForUpdates(config: Config | null, logger: Logger, options: {
+    json?: boolean;
+    quiet?: boolean;
+    validate?: boolean;
+    dryRun?: boolean;
+    skipVersionCheck?: boolean;
+}, commandDef: CommandDefinition | undefined, args: string[]): Promise<void>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAqKjE;;;GAGG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IACR,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,EACD,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,IAAI,CAAC,CAoDf"}

package/dist/version-check.js

@@ -0,0 +1,177 @@
+import { isRunningFromExecutable, fetchLatestVersion } from './cmd/upgrade';
+import { getVersion } from './version';
+import * as tui from './tui';
+import { saveConfig } from './config';
+import { $ } from 'bun';
+const ONE_HOUR_MS = 60 * 60 * 1000;
+/**
+ * Check if we should skip the version check based on environment and config
+ */
+function shouldSkipCheck(config, options, commandDef, args) {
+    // Skip if running via bun/bunx (not installed executable)
+    if (!isRunningFromExecutable()) {
+        return true;
+    }
+    // Skip if no TTY (CI, redirected output, etc.)
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return true;
+    }
+    // Skip if any of these flags are set
+    if (options.json || options.quiet || options.validate || options.dryRun) {
+        return true;
+    }
+    // Skip if explicitly disabled via flag
+    if (options.skipVersionCheck) {
+        return true;
+    }
+    // Skip if explicitly disabled via environment variable
+    if (process.env.AGENTUITY_SKIP_VERSION_CHECK === '1') {
+        return true;
+    }
+    // Skip if explicitly disabled via config
+    if (config?.overrides?.skip_version_check) {
+        return true;
+    }
+    // Skip if development version (0.0.x or 'dev')
+    const currentVersion = getVersion();
+    if (currentVersion.startsWith('0.0.') || currentVersion === 'dev') {
+        return true;
+    }
+    // Skip if command explicitly opts out of upgrade check
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (commandDef && commandDef.skipUpgradeCheck === true) {
+        return true;
+    }
+    // Skip for help commands
+    const helpFlags = ['--help', '-h', 'help'];
+    if (args.some((arg) => helpFlags.includes(arg))) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if enough time has passed since last check (at least 1 hour)
+ */
+function shouldCheckNow(config) {
+    const lastCheck = config?.preferences?.last_update_check;
+    if (!lastCheck) {
+        return true;
+    }
+    const now = Date.now();
+    const elapsed = now - lastCheck;
+    return elapsed >= ONE_HOUR_MS;
+}
+/**
+ * Prompt user to upgrade to a new version
+ * Returns true if user wants to upgrade, false otherwise
+ */
+async function promptUpgrade(currentVersion, latestVersion) {
+    tui.newline();
+    tui.info(`${tui.bold('A new version of the CLI is available!')}`);
+    tui.info(`Current version: ${tui.muted(currentVersion)}`);
+    tui.info(`Latest version:  ${tui.bold(latestVersion)}`);
+    tui.newline();
+    return await tui.confirm('Would you like to upgrade now?', true);
+}
+/**
+ * Update the last check timestamp in config
+ */
+async function updateCheckTimestamp(config, logger) {
+    if (!config) {
+        return;
+    }
+    const updatedConfig = {
+        ...config,
+        preferences: {
+            ...config.preferences,
+            last_update_check: Date.now(),
+        },
+    };
+    try {
+        await saveConfig(updatedConfig);
+    }
+    catch (error) {
+        // Non-fatal - log but continue
+        logger.debug('Failed to save config after version check: %s', error);
+    }
+}
+/**
+ * Perform the upgrade and re-run the command
+ */
+async function performUpgrade(logger) {
+    try {
+        // Run upgrade command (it will validate, download, install, etc.)
+        // Use process.execPath to get the actual binary path (not Bun.main which is virtual)
+        logger.info('Starting upgrade...');
+        await $ `${process.execPath} upgrade`.quiet();
+        // If we got here, the upgrade succeeded
+        // Re-run the original command with the new binary
+        const args = process.argv.slice(2);
+        const newBinaryPath = process.execPath;
+        logger.info('Upgrade successful! Restarting with new version...');
+        tui.info('');
+        // Spawn new process with same arguments
+        const proc = Bun.spawn([newBinaryPath, ...args], {
+            stdin: 'inherit',
+            stdout: 'inherit',
+            stderr: 'inherit',
+        });
+        // Wait for the new process to complete
+        await proc.exited;
+        // Exit with the same exit code as the new process
+        process.exit(proc.exitCode ?? 0);
+    }
+    catch (error) {
+        // Upgrade failed - log and continue with original command
+        logger.error('Upgrade failed: %s', error instanceof Error ? error.message : 'Unknown error');
+        tui.warning('Continuing with current version...');
+        tui.info('');
+    }
+}
+/**
+ * Check for updates and optionally prompt to upgrade
+ * Should be called early in the CLI initialization, before commands execute
+ */
+export async function checkForUpdates(config, logger, options, commandDef, args) {
+    // Determine if we should skip the check
+    if (shouldSkipCheck(config, options, commandDef, args)) {
+        logger.trace('Skipping version check (disabled or not applicable)');
+        return;
+    }
+    // Check if enough time has passed
+    if (!shouldCheckNow(config)) {
+        logger.trace('Skipping version check (checked recently)');
+        return;
+    }
+    // Perform the actual version check
+    logger.trace('Checking for updates...');
+    try {
+        const currentVersion = getVersion();
+        const latestVersion = await fetchLatestVersion();
+        // Update the timestamp since we successfully checked
+        await updateCheckTimestamp(config, logger);
+        // Compare versions
+        const normalizedCurrent = currentVersion.replace(/^v/, '');
+        const normalizedLatest = latestVersion.replace(/^v/, '');
+        if (normalizedCurrent === normalizedLatest) {
+            logger.trace('Already on latest version: %s', currentVersion);
+            return;
+        }
+        // New version available - prompt user
+        const shouldUpgrade = await promptUpgrade(currentVersion, latestVersion);
+        if (!shouldUpgrade) {
+            // User declined - just continue
+            tui.info('You can upgrade later by running: agentuity upgrade');
+            tui.newline();
+            return;
+        }
+        // User wants to upgrade - perform it
+        await performUpgrade(logger);
+    }
+    catch (error) {
+        // Non-fatal - if we can't fetch the latest version (network error, timeout, etc.),
+        // just log at debug level and continue without interrupting the user's command
+        logger.debug('Version check failed: %s', error instanceof Error ? error.message : 'Unknown error');
+    }
+}
+//# sourceMappingURL=version-check.js.map

package/dist/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/cli",
-	"version": "0.0.86",
+	"version": "0.0.87",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -35,8 +35,8 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.86",
-		"@agentuity/server": "0.0.86",
+		"@agentuity/core": "0.0.87",
+		"@agentuity/server": "0.0.87",
 		"@datasert/cronjs-parser": "^1.4.0",
 		"@terascope/fetch-github-release": "^2.2.1",
 		"acorn-loose": "^8.5.2",

package/src/bun-path.ts

@@ -21,8 +21,6 @@ export async function ensureBunOnPath(): Promise<void> {
 	// Check if bun exists in $HOME/.bun/bin
 	if (await Bun.file(bunPath).exists()) {
 		// Add to PATH for this process
-		process.env.PATH = process.env.PATH
-			? `${bunBinDir}:${process.env.PATH}`
-			: bunBinDir;
+		process.env.PATH = process.env.PATH ? `${bunBinDir}:${process.env.PATH}` : bunBinDir;
 	}
 }

package/src/cmd/ai/index.ts

@@ -7,6 +7,7 @@ import { getCommand } from '../../command-prefix';
 export const command = createCommand({
 	name: 'ai',
 	description: 'AI coding agent related commands',
+	skipUpgradeCheck: true,
 	tags: ['fast'],
 	examples: [
 		{

package/src/cmd/build/ast.ts

@@ -465,6 +465,13 @@ export async function parseEvalMetadata(
 		| 'error';
 	const logger = createLogger(logLevel);
 	logger.trace(`Parsing evals from ${filename}`);
+
+	// Quick string search optimization - skip AST parsing if no createEval call
+	if (!contents.includes('createEval')) {
+		logger.trace(`Skipping ${filename}: no createEval found`);
+		return [contents, []];
+	}
+
 	const ast = acornLoose.parse(contents, {
 		locations: true,
 		ecmaVersion: 'latest',

package/src/cmd/build/bundler.ts

@@ -14,6 +14,7 @@ import type { Logger } from '../../types';
 import { generateWorkbenchMainTsx, generateWorkbenchIndexHtml } from './workbench';
 import { analyzeWorkbench, type WorkbenchAnalysis } from './ast';
 import { type DeployOptions } from '../../schemas/deploy';
+import { checkAndUpgradeDependencies } from '../../utils/dependency-checker';
 
 const minBunVersion = '>=1.3.3';
 
@@ -130,6 +131,14 @@ export async function bundle({
 	const versionOutput = await checkBunVersion();
 	output.push(...versionOutput);
 
+	// Check and upgrade @agentuity/* dependencies if needed
+	const upgradeResult = await checkAndUpgradeDependencies(rootDir, logger);
+	if (upgradeResult.failed.length > 0 && process.stdin.isTTY) {
+		throw new BuildFailedError({
+			message: `Failed to upgrade dependencies: ${upgradeResult.failed.join(', ')}`,
+		});
+	}
+
 	const outDir = customOutDir ?? join(rootDir, '.agentuity');
 	const srcDir = join(rootDir, 'src');
 
@@ -376,6 +385,9 @@ export async function bundle({
 		}
 	}
 
+	// must always set for the template always
+	define['process.env.AGENTUITY_PUBLIC_WORKBENCH_PATH'] = JSON.stringify('');
+
 	// Analyze workbench config early to set environment variables for web build
 	if (existsSync(appFile)) {
 		if (!workbench) {

package/src/cmd/build/patch/_util.ts

@@ -44,13 +44,13 @@ export function generateGatewayEnvGuard(
 	provider: string
 ): string {
 	return `{
-    const apikey = process.env.AGENTUITY_SDK_KEY;
-    const url = process.env.AGENTUITY_AIGATEWAY_URL || process.env.AGENTUITY_TRANSPORT_URL || (apikey ? 'https://agentuity.ai' : '');
-    if (url && apikey) {
-        process.env.${apikey} = ${apikeyval};
-        process.env.${apibase} = url + '/gateway/${provider}';
+    const _agentuity_sdk_key = process.env.AGENTUITY_SDK_KEY;
+    const _agentuity_url = process.env.AGENTUITY_AIGATEWAY_URL || process.env.AGENTUITY_TRANSPORT_URL || (_agentuity_sdk_key ? 'https://agentuity.ai' : '');
+    if (_agentuity_url && _agentuity_sdk_key) {
+        process.env.${apikey} = _agentuity_sdk_key;
+        process.env.${apibase} = _agentuity_url + '/gateway/${provider}';
         console.debug('Enabled Agentuity AI Gateway for ${provider}');
-    } else {
+    } else if (!process.env.${apikey}) {
      ${generateEnvWarning(apikey)}
     }
 }

package/src/cmd/build/patch/llm.ts

@@ -24,7 +24,7 @@ export function generatePatches(): Map<string, PatchModule> {
 	const patches = new Map<string, PatchModule>();
 	registerLLMPatch(
 		patches,
-		'@anthropic-ai',
+		'@anthropic-ai/sdk',
 		'index',
 		'ANTHROPIC_API_KEY',
 		'ANTHROPIC_BASE_URL',

package/src/cmd/build/plugin.ts

@@ -375,6 +375,8 @@ import { readFileSync, existsSync } from 'node:fs';
 			index += html;
 		}
 	}
+	// make paths absolute
+	index = index.replaceAll('./web/', '/web/');
 	const webstatic = serveStatic({ root: import.meta.dir + '/web' });
 	// In dev mode, serve from source; in prod, serve from build output
 	const publicRoot = ${isDevMode} ? ${JSON.stringify(join(srcDir, 'web', 'public'))} : import.meta.dir + '/web/public';
@@ -389,16 +391,8 @@ import { readFileSync, existsSync } from 'node:fs';
 		if (path.includes('..') || path.includes('%2e%2e')) {
 			return c.notFound();
 		}
-		// Only serve from public folder at root (skip /web/* routes and /)
-		if (path !== '/' && !path.startsWith('/web/')) {
-			try {
-				// serveStatic calls next() internally if file not found
-				return await publicstatic(c, next);
-			} catch (err) {
-				return next();
-			}
-		}
-		return next();
+		// serve default for any path not explicitly matched
+		return c.html(index);
 	});
 })();`);
 				}
@@ -495,6 +489,14 @@ import { readFileSync, existsSync } from 'node:fs';
 					}
 
 					for (const apiFile of apiFiles) {
+						// Quick check: skip files that don't contain createRouter or Hono
+						// This avoids expensive AST parsing for utility files
+						const fileContent = await Bun.file(apiFile).text();
+						if (!fileContent.includes('createRouter') && !fileContent.includes('new Hono')) {
+							logger.trace(`Skipping ${apiFile}: no createRouter or Hono found`);
+							continue;
+						}
+
 						try {
 							const routes = await parseRoute(rootDir, apiFile, projectId, deploymentId);
 
@@ -574,12 +576,17 @@ import { readFileSync, existsSync } from 'node:fs';
 								});
 							}
 						} catch (error) {
-							// Skip files that don't have createRouter (they might be utilities)
-							if (
-								error instanceof Error &&
-								error.message.includes('could not find an proper createRouter')
-							) {
-								logger.trace(`Skipping ${apiFile}: no createRouter found`);
+							// Skip files that don't have proper router setup despite containing createRouter/Hono
+							// (e.g., files that import but don't use them, or have syntax errors)
+							if (error instanceof Error) {
+								if (
+									error.message.includes('could not find default export') ||
+									error.message.includes('could not find an proper createRouter')
+								) {
+									logger.trace(`Skipping ${apiFile}: ${error.message}`);
+								} else {
+									throw error;
+								}
 							} else {
 								throw error;
 							}

package/src/cmd/build/route-discovery.ts

@@ -19,17 +19,21 @@ export interface DiscoveredRouteFile {
 }
 
 /**
- * Recursively discover all TypeScript route files in an API directory
+ * Recursively discover all TypeScript files in an API directory.
+ * Any .ts file CAN be a route if it exports a router, but not all files MUST be routes.
+ * Files without router exports (utility files, types, helpers) are discovered but gracefully skipped during processing.
+ *
  * Supports nested structures like:
- * - src/api/index.ts (root API router)
+ * - src/api/index.ts (root API router - handled separately)
  * - src/api/auth/route.ts -> mounted at /api/auth
+ * - src/api/auth/login.ts -> mounted at /api/auth
  * - src/api/v1/users/route.ts -> mounted at /api/v1/users
- * - src/api/admin/users/login.ts -> mounted at /api/admin/users (any .ts file works)
+ * - src/api/auth/helpers.ts -> discovered but skipped if no router export
  *
  * @param apiDir - Absolute path to the src/api directory
  * @param currentDir - Current directory being scanned (used for recursion)
  * @param results - Accumulated results (used for recursion)
- * @returns Array of discovered route files with mount information
+ * @returns Array of discovered TypeScript files with mount information
  */
 export function discoverRouteFiles(
 	apiDir: string,
@@ -63,8 +67,9 @@ export function discoverRouteFiles(
 
 			// For subdirectory files, determine mount path
 			// src/api/auth/route.ts -> /api/auth
+			// src/api/auth/login.ts -> /api/auth
 			// src/api/v1/users/route.ts -> /api/v1/users
-			// src/api/admin/login.ts -> /api/admin
+			// src/api/admin/helpers.ts -> /api/admin (discovered but may be skipped during processing)
 			const pathParts = relativePath.split('/');
 			pathParts.pop(); // Remove filename
 

package/src/cmd/cloud/scp/download.ts

@@ -36,7 +36,7 @@ export const downloadCommand = createSubcommand({
 			description: 'Download multiple files',
 		},
 	],
-	requires: { apiClient: true, auth: true },
+	requires: { apiClient: true, auth: true, region: true },
 	optional: { project: true },
 	prerequisites: ['cloud deploy'],
 	schema: {
@@ -51,7 +51,7 @@ export const downloadCommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { apiClient, args, opts, project, projectDir, config } = ctx;
+		const { apiClient, args, opts, project, projectDir, config, region } = ctx;
 
 		let identifier = opts?.identifier ?? project?.projectId;
 
@@ -59,7 +59,7 @@ export const downloadCommand = createSubcommand({
 			identifier = await tui.showProjectList(apiClient, true);
 		}
 
-		const hostname = getIONHost(config);
+		const hostname = getIONHost(config, region);
 		const destination = args.destination ?? projectDir;
 
 		try {

package/src/cmd/cloud/scp/upload.ts

@@ -39,7 +39,7 @@ export const uploadCommand = createSubcommand({
 			description: 'Upload multiple files',
 		},
 	],
-	requires: { apiClient: true, auth: true },
+	requires: { apiClient: true, auth: true, region: true },
 	schema: {
 		args,
 		options,
@@ -54,7 +54,7 @@ export const uploadCommand = createSubcommand({
 	prerequisites: ['cloud deploy'],
 
 	async handler(ctx) {
-		const { apiClient, args, opts, project, projectDir, config } = ctx;
+		const { apiClient, args, opts, project, projectDir, config, region } = ctx;
 
 		let identifier = opts?.identifier ?? project?.projectId;
 
@@ -62,7 +62,7 @@ export const uploadCommand = createSubcommand({
 			identifier = await tui.showProjectList(apiClient, true);
 		}
 
-		const hostname = getIONHost(config);
+		const hostname = getIONHost(config, region);
 		const destination = args.destination ?? '.';
 
 		try {