@agentuity/cli 0.1.12 → 0.1.14

package/src/config.ts

@@ -359,6 +359,29 @@ export async function saveOrgId(orgId: string): Promise<void> {
 	await saveConfig(config);
 }
 
+export async function clearOrgId(): Promise<void> {
+	const config = await getOrInitConfig();
+	if (config.preferences) {
+		delete (config.preferences as Record<string, unknown>).orgId;
+		await saveConfig(config);
+	}
+}
+
+export async function saveRegion(region: string): Promise<void> {
+	const config = await getOrInitConfig();
+	config.preferences = config.preferences || {};
+	(config.preferences as Record<string, unknown>).region = region;
+	await saveConfig(config);
+}
+
+export async function clearRegion(): Promise<void> {
+	const config = await getOrInitConfig();
+	if (config.preferences) {
+		delete (config.preferences as Record<string, unknown>).region;
+		await saveConfig(config);
+	}
+}
+
 export async function getAuth(): Promise<AuthData | null> {
 	const config = await loadConfig();
 	const profileName = config?.name || defaultProfileName;
@@ -590,26 +613,29 @@ export async function createProjectConfig(dir: string, config: InitialProjectCon
 	await Bun.write(envPath, content);
 	await chmod(envPath, 0o600);
 
-	// generate the vscode settings
+	// generate the vscode settings (only if they don't already exist)
 	const vscodeDir = join(dir, '.vscode');
-	mkdirSync(vscodeDir);
-
-	const settings = {
-		'search.exclude': {
-			'**/.git/**': true,
-			'**/node_modules/**': true,
-			'**/bun.lock': true,
-			'**/.agentuity/**': true,
-		},
-		'json.schemas': [
-			{
-				fileMatch: ['agentuity.json'],
-				url: 'https://agentuity.dev/schema/cli/v1/agentuity.json',
+	const settingsPath = join(vscodeDir, 'settings.json');
+	if (!(await Bun.file(settingsPath).exists())) {
+		mkdirSync(vscodeDir, { recursive: true });
+
+		const settings = {
+			'search.exclude': {
+				'**/.git/**': true,
+				'**/node_modules/**': true,
+				'**/bun.lock': true,
+				'**/.agentuity/**': true,
 			},
-		],
-	};
+			'json.schemas': [
+				{
+					fileMatch: ['agentuity.json'],
+					url: 'https://agentuity.dev/schema/cli/v1/agentuity.json',
+				},
+			],
+		};
 
-	await Bun.write(join(vscodeDir, 'settings.json'), JSON.stringify(settings, null, 2));
+		await Bun.write(settingsPath, JSON.stringify(settings, null, 2));
+	}
 }
 
 export async function updateProjectConfig(
@@ -721,13 +747,18 @@ interface RegionsCacheData {
 /**
  * Get the default region using priority ordering:
  * 1. AGENTUITY_REGION environment variable
- * 2. First entry in region-{profile}.json (nearest region, sorted by distance)
- * 3. 'local' for local profile, 'usc' otherwise
+ * 2. 'local' for local profile
+ * 3. Saved region preference (config.preferences.region)
+ * 4. First entry in region-{profile}.json (nearest region, sorted by distance)
+ * 5. 'usc' fallback
  *
  * Used for API calls that can hit any Catalyst instance (global database operations).
  * Note: This is NOT called when --region flag is provided (handled at command level).
  */
-export async function getDefaultRegion(profileName = 'production'): Promise<string> {
+export async function getDefaultRegion(
+	profileName = 'production',
+	config?: Config | null
+): Promise<string> {
 	// 1. Check environment variable first
 	if (process.env.AGENTUITY_REGION) {
 		return process.env.AGENTUITY_REGION;
@@ -738,7 +769,12 @@ export async function getDefaultRegion(profileName = 'production'): Promise<stri
 		return 'local';
 	}
 
-	// 3. Check cached regions file (sorted by distance)
+	// 3. Check saved region preference
+	if (config?.preferences?.region) {
+		return config.preferences.region;
+	}
+
+	// 4. Check cached regions file (sorted by distance)
 	try {
 		const cachePath = join(getDefaultConfigDir(), `regions-${profileName}.json`);
 		const file = Bun.file(cachePath);
@@ -752,7 +788,7 @@ export async function getDefaultRegion(profileName = 'production'): Promise<stri
 		// Fall through to default
 	}
 
-	// 4. Final fallback
+	// 5. Final fallback
 	return 'usc';
 }
 

package/src/legacy-check.ts

@@ -23,6 +23,11 @@ export async function checkLegacyCLI(): Promise<void> {
 		join(homeDir, '.local/bin/agentuity'), // XDG user bin
 	];
 
+	// Exclude the currently running executable from the legacy check
+	// This prevents the new CLI from detecting itself as legacy when installed
+	// in standard system locations like /usr/local/bin
+	const currentExecutable = process.execPath;
+
 	const foundInstalls: LegacyInstall[] = [];
 
 	// Check if Homebrew manages the agentuity package
@@ -40,6 +45,11 @@ export async function checkLegacyCLI(): Promise<void> {
 
 	// Check file system locations
 	for (const location of legacyLocations) {
+		// Skip if this is the currently running executable
+		if (location === currentExecutable) {
+			continue;
+		}
+
 		const file = Bun.file(location);
 		if (await file.exists()) {
 			try {

package/src/program-ref.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+
+let programRef: Command | null = null;
+
+export function setProgram(program: Command): void {
+	programRef = program;
+}
+
+export function getProgram(): Command | null {
+	return programRef;
+}

package/src/regions.ts

@@ -0,0 +1,95 @@
+/**
+ * Region caching utilities for avoiding repeated API calls
+ */
+import { join } from 'node:path';
+import { mkdir, unlink } from 'node:fs/promises';
+import type { Logger } from '@agentuity/core';
+import { listRegions, type RegionList } from '@agentuity/server';
+import { getDefaultConfigDir } from './config';
+import type { APIClient } from './api';
+
+const REGIONS_CACHE_MAX_AGE_MS = 5 * 24 * 60 * 60 * 1000; // 5 days
+const LEGACY_REGIONS_CACHE_FILE = 'regions.json';
+
+function getRegionsCacheFile(profileName: string): string {
+	return `regions-${profileName}.json`;
+}
+
+async function removeLegacyRegionsCache(logger: Logger): Promise<void> {
+	try {
+		const legacyPath = join(getDefaultConfigDir(), LEGACY_REGIONS_CACHE_FILE);
+		const file = Bun.file(legacyPath);
+		if (await file.exists()) {
+			await unlink(legacyPath);
+			logger.trace('removed legacy regions cache file');
+		}
+	} catch {
+		// Ignore errors when removing legacy file
+	}
+}
+
+interface RegionsCacheData {
+	timestamp: number;
+	regions: RegionList;
+}
+
+async function getCachedRegions(profileName: string, logger: Logger): Promise<RegionList | null> {
+	try {
+		// Clean up legacy single-file cache from older versions
+		await removeLegacyRegionsCache(logger);
+
+		const cachePath = join(getDefaultConfigDir(), getRegionsCacheFile(profileName));
+		const file = Bun.file(cachePath);
+		if (!(await file.exists())) {
+			return null;
+		}
+		const data: RegionsCacheData = await file.json();
+		const age = Date.now() - data.timestamp;
+		if (age > REGIONS_CACHE_MAX_AGE_MS) {
+			logger.trace('regions cache expired for profile %s (age: %dms)', profileName, age);
+			return null;
+		}
+		logger.trace('using cached regions for profile %s (age: %dms)', profileName, age);
+		return data.regions;
+	} catch (error) {
+		logger.trace('failed to read regions cache for profile %s: %s', profileName, error);
+		return null;
+	}
+}
+
+async function saveRegionsCache(
+	profileName: string,
+	regions: RegionList,
+	logger: Logger
+): Promise<void> {
+	try {
+		const cacheDir = getDefaultConfigDir();
+		await mkdir(cacheDir, { recursive: true });
+		const cachePath = join(cacheDir, getRegionsCacheFile(profileName));
+		const data: RegionsCacheData = {
+			timestamp: Date.now(),
+			regions,
+		};
+		await Bun.write(cachePath, JSON.stringify(data));
+		logger.trace('saved regions cache for profile %s', profileName);
+	} catch (error) {
+		logger.trace('failed to save regions cache for profile %s: %s', profileName, error);
+	}
+}
+
+/**
+ * Fetch regions from API with caching
+ */
+export async function fetchRegionsWithCache(
+	profileName: string,
+	apiClient: APIClient,
+	logger: Logger
+): Promise<RegionList> {
+	const cached = await getCachedRegions(profileName, logger);
+	if (cached) {
+		return cached;
+	}
+	const regions = await listRegions(apiClient);
+	await saveRegionsCache(profileName, regions, logger);
+	return regions;
+}

package/src/tui.ts

@@ -348,6 +348,11 @@ export function link(url: string, title?: string, color = getColor('link')): str
  * Check if terminal supports OSC 8 hyperlinks
  */
 export function supportsHyperlinks(): boolean {
+	// No hyperlink support without a TTY
+	if (!process.stdout.isTTY) {
+		return false;
+	}
+
 	const term = process.env.TERM || '';
 	const termProgram = process.env.TERM_PROGRAM || '';
 	const wtSession = process.env.WT_SESSION || '';
@@ -360,7 +365,6 @@ export function supportsHyperlinks(): boolean {
 		termProgram.includes('Apple_Terminal') ||
 		termProgram.includes('Hyper') ||
 		term.includes('xterm-kitty') ||
-		term.includes('xterm-256color') ||
 		wtSession !== '' // Windows Terminal
 	);
 }
@@ -816,9 +820,7 @@ export function showLoggedOutMessage(appBaseUrl: string, hasProfile = false): vo
 	const RESET = '\x1b[0m';
 
 	const signupTitle = hasProfile ? 'Login' : 'Sign up / Login';
-	const signupURL = hasProfile
-		? `${appBaseUrl}/sign-in`
-		: `${appBaseUrl}/sign-up`;
+	const signupURL = hasProfile ? `${appBaseUrl}/sign-in` : `${appBaseUrl}/sign-up`;
 	const showInline = supportsHyperlinks();
 	const signupLink = showInline
 		? link(signupURL, signupTitle)

package/src/types.ts

@@ -50,6 +50,7 @@ export const ConfigSchema = zod.object({
 			last_legacy_warning: zod.number().optional().describe('Last legacy CLI warning timestamp'),
 			signup_banner_shown: zod.boolean().optional().describe('If the signup banner was shown'),
 			orgId: zod.string().optional().describe('Default organization ID'),
+			region: zod.string().optional().describe('Default cloud region'),
 			project_dir: zod.string().optional().describe('Last used project directory'),
 		})
 		.optional()