@agentuity/cli 0.0.94 → 0.0.96

package/src/cmd/dev/sync.ts

@@ -365,12 +365,16 @@ export function createDevmodeSyncService({
 	mock = false,
 }: {
 	logger: Logger;
-	apiClient: APIClient;
+	apiClient: APIClient | null;
 	mock?: boolean;
 }): IDevmodeSyncService {
 	if (mock) {
 		return new MockDevmodeSyncService(logger);
 	}
 
+	if (!apiClient) {
+		throw new Error('apiClient is required when not in mock mode');
+	}
+
 	return new DevmodeSyncService(logger, apiClient);
 }

package/src/cmd/profile/show.ts

@@ -1,6 +1,6 @@
 import { createSubcommand, ConfigSchema } from '../../types';
 import { z } from 'zod';
-import { fetchProfiles, loadConfig } from '../../config';
+import { fetchProfiles } from '../../config';
 import { readFile } from 'node:fs/promises';
 import * as tui from '../../tui';
 import { getCommand } from '../../command-prefix';
@@ -34,7 +34,6 @@ export const showCommand = createSubcommand({
 		const { logger, args, options } = ctx;
 
 		try {
-			let current = false;
 			let name = args.name;
 
 			const profiles = await fetchProfiles();
@@ -53,9 +52,9 @@ export const showCommand = createSubcommand({
 			}
 
 			const profilePath = profile.filename;
-			current = profile.selected;
 
-			const content = await loadConfig(current ? undefined : profilePath);
+			// Use already-loaded config from context (respects --config flag)
+			const content = ctx.config;
 			if (!content) {
 				return logger.fatal(
 					`Failed to load profile configuration`,

package/src/cmd/project/create.ts

@@ -16,13 +16,12 @@ const ProjectCreateResponseSchema = z.object({
 export const createProjectSubcommand = createSubcommand({
 	name: 'create',
 	description: 'Create a new project',
-	tags: ['mutating', 'creates-resource', 'slow', 'api-intensive', 'requires-auth'],
+	tags: ['mutating', 'creates-resource', 'slow'],
 	aliases: ['new', 'init'],
 	banner: true,
 	toplevel: true,
 	idempotent: false,
-	optional: { auth: true, org: true, region: true },
-	requires: { apiClient: true },
+	optional: { auth: true, org: true, region: true, apiClient: true },
 	examples: [
 		{ command: getCommand('project create'), description: 'Create new item' },
 		{ command: getCommand('project create --name my-ai-agent'), description: 'Create new item' },
@@ -85,7 +84,7 @@ export const createProjectSubcommand = createSubcommand({
 			auth: opts.register === true ? auth : undefined,
 			config: config!,
 			apiClient,
-			orgId,
+			orgId: opts.register === true ? orgId : undefined,
 			region,
 		});
 

package/src/cmd/project/list.ts

@@ -31,6 +31,7 @@ export const listSubcommand = createSubcommand({
 			description: 'Alias for "project list" — list projects (human-readable)',
 		},
 	],
+	webUrl: '/projects',
 
 	async handler(ctx) {
 		const { apiClient, options } = ctx;

package/src/cmd/project/show.ts

@@ -34,6 +34,7 @@ export const showSubcommand = createSubcommand({
 		}),
 		response: ProjectShowResponseSchema,
 	},
+	webUrl: (ctx) => `/projects/${encodeURIComponent(ctx.args.id)}`,
 	idempotent: true,
 
 	async handler(ctx) {

package/src/cmd/upgrade/index.ts

@@ -298,8 +298,8 @@ export const command = createCommand({
 
 			// Confirm upgrade
 			if (!force) {
-				tui.info(`Current version: ${tui.muted(currentVersion)}`);
-				tui.info(`Latest version:  ${tui.bold(latestVersion)}`);
+				tui.info(`Current version: ${tui.muted(normalizedCurrent)}`);
+				tui.info(`Latest version:  ${tui.bold(normalizedLatest)}`);
 				tui.newline();
 				if (toTag(currentVersion) !== toTag(latestVersion)) {
 					tui.warning(
@@ -350,7 +350,10 @@ export const command = createCommand({
 				await $`rm ${tmpBinaryPath}`.quiet();
 			}
 
-			const message = `Successfully upgraded from ${currentVersion} to ${latestVersion}`;
+			const message =
+				normalizedCurrent === normalizedLatest
+					? `Successfully upgraded to ${normalizedLatest}`
+					: `Successfully upgraded from ${normalizedCurrent} to ${normalizedLatest}`;
 			tui.success(message);
 
 			return {

package/src/config.ts

@@ -126,8 +126,9 @@ function expandTilde(path: string): string {
 
 let cachedConfig: Config | null | undefined;
 
-export async function loadConfig(customPath?: string): Promise<Config | null> {
-	if (cachedConfig !== undefined) {
+export async function loadConfig(customPath?: string, skipCache = false): Promise<Config | null> {
+	// Use cache if available and not skipped
+	if (!skipCache && cachedConfig !== undefined) {
 		return cachedConfig;
 	}
 	const configPath = customPath ? expandTilde(customPath) : await getProfile();
@@ -189,13 +190,21 @@ export async function loadConfig(customPath?: string): Promise<Config | null> {
 			result.data.overrides = overrides;
 		}
 
-		cachedConfig = result.data;
+		// Cache the loaded config (whether default or custom path)
+		// This ensures --config flag is respected across all commands
+		if (!skipCache) {
+			cachedConfig = result.data;
+		}
 		return result.data;
 	} catch (error) {
-		if (error instanceof Error) {
-			console.error(`Error loading config from ${configPath}:`, error.message);
+		tui.error(`Error loading config from ${configPath}: ${error}`);
+
+		// Cache null on error to prevent retry attempts.
+		// This is acceptable for CLI context where process typically exits on config errors.
+		// Note: For long-running processes, consider time-based cache expiry for transient failures.
+		if (!skipCache) {
+			cachedConfig = null;
 		}
-		cachedConfig = null;
 		return null;
 	}
 }
@@ -250,7 +259,14 @@ export async function saveConfig(config: Config, customPath?: string): Promise<v
 	await writeFile(configPath, content + '\n', { mode: 0o600 });
 	// Ensure existing files get correct permissions on upgrade
 	await chmod(configPath, 0o600);
-	cachedConfig = config;
+
+	// Only cache the default profile, not custom path saves.
+	// Note: This creates potential cache staleness - if a custom path is saved then later
+	// loaded without skipCache, it will use the cached default profile instead.
+	// Consider clearing cache on custom path saves: if (customPath) { cachedConfig = undefined; }
+	if (!customPath) {
+		cachedConfig = config;
+	}
 }
 
 export async function getOrInitConfig(): Promise<Config> {
@@ -286,7 +302,7 @@ export async function saveAuth(auth: AuthData): Promise<void> {
 			return;
 		} catch (error) {
 			// Keychain failed, fall back to config file
-			console.warn('Failed to store auth in keychain, falling back to config file:', error);
+			tui.warning(`Failed to store auth in keychain, falling back to config file: ${error}`);
 		}
 	}
 
@@ -428,10 +444,14 @@ export function generateYAMLTemplate(name: string): string {
 
 		const schema = value as z.ZodTypeAny;
 
-		// Unwrap optional to get to the inner schema
+		// Unwrap optional and nullable to get to the inner schema
+		// Note: .optional().nullable() creates ZodNullable(ZodOptional(ZodObject))
 		let innerSchema = schema;
-		if (schema instanceof z.ZodOptional) {
-			innerSchema = (schema._def as unknown as { innerType: z.ZodTypeAny }).innerType;
+		if (innerSchema instanceof z.ZodNullable) {
+			innerSchema = (innerSchema._def as unknown as { innerType: z.ZodTypeAny }).innerType;
+		}
+		if (innerSchema instanceof z.ZodOptional) {
+			innerSchema = (innerSchema._def as unknown as { innerType: z.ZodTypeAny }).innerType;
 		}
 
 		const description = getSchemaDescription(schema);

package/src/index.ts

@@ -113,6 +113,8 @@ export type {
 	BuildContext,
 	BuildConfig,
 	BuildConfigFunction,
+	AgentuityConfig,
+	WorkbenchConfig,
 } from './types';
 export { createSubcommand, createCommand } from './types';
 export type { ColorScheme } from './terminal';

package/src/runtime-bootstrap.ts

@@ -41,9 +41,10 @@ export interface RuntimeBootstrapResult {
  * This function:
  * 1. Resolves the active profile (from AGENTUITY_PROFILE env or profile config)
  * 2. Loads .env.{profile}, .env.development, or .env based on profile
- * 3. Sets AGENTUITY_REGION=local for local profile
+ * 3. Sets AGENTUITY_REGION=local for local profile (overrides project config for infrastructure)
  * 4. Loads agentuity.{profile}.json if it exists
- * 5. Does NOT override environment variables already set
+ * 5. Sets AGENTUITY_REGION from project config if not already set (non-local profiles only)
+ * 6. Does NOT override environment variables already set
  *
  * Call this BEFORE createApp() in your app.ts:
  *
@@ -114,6 +115,11 @@ export async function bootstrapRuntimeEnv(
 	let projectConfig: ProjectConfig | null = null;
 	try {
 		projectConfig = await loadProjectConfig(projectDir, cfg ?? undefined);
+
+		// Set AGENTUITY_REGION from project config if not already set
+		if (projectConfig?.region && !process.env.AGENTUITY_REGION) {
+			process.env.AGENTUITY_REGION = projectConfig.region;
+		}
 	} catch {
 		// OK for tests that don't need project config
 	}

package/src/types.ts

@@ -107,7 +107,41 @@ export interface BuildContext {
 }
 
 /**
- * User-provided build configuration for a specific phase
+ * Workbench configuration
+ *
+ * Presence of this config object implicitly enables workbench in dev mode.
+ * To disable workbench, omit this config entirely.
+ */
+export interface WorkbenchConfig {
+	/**
+	 * Route where the workbench UI will be served
+	 * @default '/workbench'
+	 */
+	route?: string;
+	/**
+	 * Custom headers to send with workbench requests
+	 */
+	headers?: Record<string, string>;
+}
+
+/**
+ * Agentuity project configuration (declarative)
+ */
+export interface AgentuityConfig {
+	/**
+	 * Workbench configuration
+	 */
+	workbench?: WorkbenchConfig;
+	/**
+	 * Vite plugins to add to the client build
+	 * These are added AFTER Agentuity's built-in plugins
+	 */
+	plugins?: Array<import('vite').Plugin>;
+}
+
+/**
+ * User-provided build configuration for a specific phase (legacy Bun bundler)
+ * @deprecated Use AgentuityConfig instead
  */
 export interface BuildConfig {
 	/**
@@ -303,6 +337,13 @@ export type CommandContext<
 	Op extends z.ZodType | undefined = undefined,
 > = CommandContextFromSpecs<R, O, A, Op>;
 
+export type WebUrl<
+	R extends Requires | undefined = undefined,
+	O extends Optional | undefined = undefined,
+	A extends z.ZodType | undefined = undefined,
+	Op extends z.ZodType | undefined = undefined,
+> = string | ((ctx: CommandContext<R, O, A, Op>) => string | undefined | null);
+
 export function createSubcommand<
 	R extends Requires | undefined = undefined,
 	O extends Optional | undefined = undefined,
@@ -322,6 +363,7 @@ export function createSubcommand<
 	prerequisites?: string[];
 	pagination?: PaginationInfo;
 	tags?: string[];
+	webUrl?: WebUrl<R, O, A, Op>;
 	schema?: A extends z.ZodType
 		? Op extends z.ZodType
 			? Res extends z.ZodType
@@ -365,6 +407,7 @@ export function createCommand<
 	prerequisites?: string[];
 	pagination?: PaginationInfo;
 	tags?: string[];
+	webUrl?: WebUrl<R, O, A, Op>;
 	schema?: A extends z.ZodType
 		? Op extends z.ZodType
 			? Res extends z.ZodType
@@ -402,6 +445,7 @@ type CommandDefBase =
 			pagination?: PaginationInfo;
 			tags?: string[];
 			schema?: CommandSchemas;
+			webUrl?: string | ((ctx: CommandContext) => string | undefined | null);
 			handler(ctx: CommandContext): unknown | Promise<unknown>;
 			subcommands?: SubcommandDefinition[];
 	  }
@@ -418,6 +462,7 @@ type CommandDefBase =
 			pagination?: PaginationInfo;
 			tags?: string[];
 			schema?: CommandSchemas;
+			webUrl?: string | ((ctx: CommandContext) => string | undefined | null);
 			handler?: undefined;
 			subcommands: SubcommandDefinition[];
 	  };
@@ -435,6 +480,7 @@ type SubcommandDefBase =
 			pagination?: PaginationInfo;
 			tags?: string[];
 			schema?: CommandSchemas;
+			webUrl?: string | ((ctx: CommandContext) => string | undefined | null);
 			handler(ctx: CommandContext): unknown | Promise<unknown>;
 			subcommands?: SubcommandDefinition[];
 	  }
@@ -450,6 +496,7 @@ type SubcommandDefBase =
 			pagination?: PaginationInfo;
 			tags?: string[];
 			schema?: CommandSchemas;
+			webUrl?: string | ((ctx: CommandContext) => string | undefined | null);
 			handler?: undefined;
 			subcommands: SubcommandDefinition[];
 	  };

package/src/utils/bun-version-checker.ts

@@ -0,0 +1,70 @@
+import { $, semver } from 'bun';
+import { StructuredError } from '@agentuity/core';
+import * as tui from '../tui';
+import { pauseStepUI } from '../steps';
+
+const InvalidBunVersion = StructuredError('InvalidBunVersion')<{
+	current: string;
+	required: string;
+	message: string;
+}>();
+
+const MIN_BUN_VERSION = '>=1.3.3';
+
+/**
+ * Check if Bun version meets minimum requirements and optionally upgrade
+ * @returns Array of output messages (empty if version OK, success message if upgraded)
+ * @throws InvalidBunVersion if version check fails
+ */
+export async function checkBunVersion(): Promise<string[]> {
+	if (semver.satisfies(Bun.version, MIN_BUN_VERSION)) {
+		return []; // Version is OK, no output needed
+	}
+
+	const message = `Bun is using version ${Bun.version}. This project requires Bun version ${MIN_BUN_VERSION} to build.`;
+
+	if (process.stdin.isTTY && process.stdout.isTTY) {
+		// Pause the step UI for interactive prompt
+		const resume = pauseStepUI();
+
+		tui.warning(message);
+		const ok = await tui.confirm('Would you like to upgrade now?');
+
+		// Small delay to ensure console.log('') in confirm completes
+		await new Promise((resolve) => setTimeout(resolve, 10));
+
+		resume(); // Resume step UI
+
+		if (ok) {
+			await $`bun upgrade`.quiet();
+			const upgradedVersion = (await $`bun -v`.quiet().text()).trim();
+
+			// Verify the upgraded version meets minimum requirements
+			if (semver.satisfies(upgradedVersion, MIN_BUN_VERSION)) {
+				// Return success message to show in output box
+				return [tui.colorSuccess(`Upgraded Bun to ${upgradedVersion}`)];
+			} else {
+				// Upgrade completed but still doesn't meet minimum version
+				throw new InvalidBunVersion({
+					current: upgradedVersion,
+					required: MIN_BUN_VERSION,
+					message: `Bun upgraded to ${upgradedVersion}, but still does not meet minimum requirement ${MIN_BUN_VERSION}`,
+				});
+			}
+		}
+	}
+
+	// Failed to upgrade or user declined
+	throw new InvalidBunVersion({
+		current: Bun.version,
+		required: MIN_BUN_VERSION,
+		message,
+	});
+}
+
+/**
+ * Get minimum required Bun version
+ */
+export function getMinBunVersion(): string {
+	return MIN_BUN_VERSION;
+}

package/src/version-check.ts

@@ -92,10 +92,14 @@ function shouldCheckNow(config: Config | null): boolean {
  * Returns true if user wants to upgrade, false otherwise
  */
 async function promptUpgrade(currentVersion: string, latestVersion: string): Promise<boolean> {
+	// Strip 'v' prefix for display
+	const displayCurrent = currentVersion.replace(/^v/, '');
+	const displayLatest = latestVersion.replace(/^v/, '');
+
 	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.info(`Current version: ${tui.muted(displayCurrent)}`);
+	tui.info(`Latest version:  ${tui.bold(displayLatest)}`);
 	tui.newline();
 	if (toTag(currentVersion) !== toTag(latestVersion)) {
 		tui.warning(`What's changed:  ${tui.link(getCompareUrl(currentVersion, latestVersion))}`);

package/dist/cmd/build/bundler.d.ts

@@ -1,22 +0,0 @@
-import type { Project } from '../../types';
-import type { Logger } from '../../types';
-import { type WorkbenchAnalysis } from './ast';
-import { type DeployOptions } from '../../schemas/deploy';
-export interface BundleOptions extends DeployOptions {
-    rootDir: string;
-    dev?: boolean;
-    env?: Map<string, string>;
-    orgId?: string;
-    projectId?: string;
-    deploymentId?: string;
-    project?: Project;
-    port?: number;
-    outDir?: string;
-    region: string;
-    logger: Logger;
-    workbench?: WorkbenchAnalysis;
-}
-export declare function bundle({ orgId, projectId, deploymentId, dev, rootDir, project, outDir: customOutDir, tag, logsUrl, commitUrl, provider, trigger, event, pullRequestNumber, pullRequestCommentId, pullRequestURL, message, env, region, logger, workbench, }: BundleOptions): Promise<{
-    output: string[];
-}>;
-//# sourceMappingURL=bundler.d.ts.map

package/dist/cmd/build/bundler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../src/cmd/build/bundler.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AAExD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAyC1D,MAAM,WAAW,aAAc,SAAQ,aAAa;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAqGD,wBAAsB,MAAM,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,YAAY,EACZ,GAAW,EACX,OAAO,EACP,OAAO,EACP,MAAM,EAAE,YAAY,EACpB,GAAG,EACH,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,OAAO,EACP,GAAG,EACH,MAAM,EACN,MAAM,EACN,SAAS,GACT,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8tB/C"}