@agentuity/cli 0.1.25 → 0.1.27

package/dist/version-check.js

@@ -4,10 +4,12 @@ import * as tui from './tui';
 import { saveConfig } from './config';
 import { $ } from 'bun';
 const ONE_HOUR_MS = 60 * 60 * 1000;
+// Tags that indicate a command should skip the upgrade prompt
+const SKIP_UPGRADE_TAGS = ['read-only', 'fast'];
 /**
  * Check if we should skip the version check based on environment and config
  */
-function shouldSkipCheck(config, options, commandDef, args) {
+function shouldSkipCheck(config, options, commandDef, subcommandDef, args) {
     // Skip if running via bun/bunx (not installed executable)
     if (!isRunningFromExecutable()) {
         return true;
@@ -42,6 +44,19 @@ function shouldSkipCheck(config, options, commandDef, args) {
     if (commandDef && commandDef.skipUpgradeCheck === true) {
         return true;
     }
+    // Skip if subcommand explicitly opts out of upgrade check
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (subcommandDef && subcommandDef.skipUpgradeCheck === true) {
+        return true;
+    }
+    // Skip if command or subcommand has tags indicating it's read-only or fast
+    // These commands shouldn't be interrupted with upgrade prompts
+    const commandTags = commandDef?.tags ?? [];
+    const subcommandTags = subcommandDef?.tags ?? [];
+    const allTags = [...commandTags, ...subcommandTags];
+    if (allTags.some((tag) => SKIP_UPGRADE_TAGS.includes(tag))) {
+        return true;
+    }
     // Skip for help commands
     const helpFlags = ['--help', '-h', 'help'];
     if (args.some((arg) => helpFlags.includes(arg))) {
@@ -140,9 +155,9 @@ async function performUpgrade(logger) {
  * 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) {
+export async function checkForUpdates(config, logger, options, commandDef, subcommandDef, args) {
     // Determine if we should skip the check
-    if (shouldSkipCheck(config, options, commandDef, args)) {
+    if (shouldSkipCheck(config, options, commandDef, subcommandDef, args)) {
         logger.trace('Skipping version check (disabled or not applicable)');
         return;
     }

package/dist/version-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"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"}
+{"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.1.25",
+	"version": "0.1.27",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -40,9 +40,9 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/auth": "0.1.25",
-		"@agentuity/core": "0.1.25",
-		"@agentuity/server": "0.1.25",
+		"@agentuity/auth": "0.1.27",
+		"@agentuity/core": "0.1.27",
+		"@agentuity/server": "0.1.27",
 		"@datasert/cronjs-parser": "^1.4.0",
 		"@terascope/fetch-github-release": "^2.2.1",
 		"@vitejs/plugin-react": "^5.1.2",
@@ -60,10 +60,10 @@
 		"typescript": "^5.9.0",
 		"vite": "^7.2.7",
 		"zod": "^4.3.5",
-		"@agentuity/frontend": "0.1.25"
+		"@agentuity/frontend": "0.1.27"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.1.25",
+		"@agentuity/test-utils": "0.1.27",
 		"@types/adm-zip": "^0.5.7",
 		"@types/bun": "latest",
 		"@types/tar-fs": "^2.0.4",

package/src/auth.ts

@@ -72,12 +72,13 @@ export async function requireAuth(ctx: CommandContext<undefined>): Promise<AuthD
 	// Import and run login flow
 	const { loginCommand } = await import('./cmd/auth/login');
 
-	// Ensure apiClient is available for login handler
+	// Ensure apiClient and opts are available for login handler
 	const loginCtx = ctx as unknown as Record<string, unknown>;
 	if (!loginCtx.apiClient) {
 		const apiUrl = getAPIBaseURL(ctx.config ?? null);
 		loginCtx.apiClient = new APIClient(apiUrl, ctx.logger, ctx.config ?? null);
 	}
+	loginCtx.opts ??= {};
 
 	if (loginCommand.handler) {
 		await loginCommand.handler(loginCtx as CommandContext);
@@ -165,12 +166,13 @@ export async function optionalAuth(
 			// Import and run login flow
 			const { loginCommand } = await import('./cmd/auth/login');
 
-			// Ensure apiClient is available for login handler
+			// Ensure apiClient and opts are available for login handler
 			const loginCtx1 = ctx as unknown as Record<string, unknown>;
 			if (!loginCtx1.apiClient) {
 				const apiUrl = getAPIBaseURL(ctx.config ?? null);
 				loginCtx1.apiClient = new APIClient(apiUrl, ctx.logger, ctx.config ?? null);
 			}
+			loginCtx1.opts ??= {};
 
 			if (loginCommand.handler) {
 				await loginCommand.handler(loginCtx1 as CommandContext);
@@ -207,12 +209,13 @@ export async function optionalAuth(
 			// Import and run login flow
 			const { loginCommand } = await import('./cmd/auth/login');
 
-			// Ensure apiClient is available for login handler
+			// Ensure apiClient and opts are available for login handler
 			const loginCtx2 = ctx as unknown as Record<string, unknown>;
 			if (!loginCtx2.apiClient) {
 				const apiUrl = getAPIBaseURL(ctx.config ?? null);
 				loginCtx2.apiClient = new APIClient(apiUrl, ctx.logger, ctx.config ?? null);
 			}
+			loginCtx2.opts ??= {};
 
 			if (loginCommand.handler) {
 				await loginCommand.handler(loginCtx2 as CommandContext);

package/src/cmd/auth/login.ts

@@ -25,7 +25,8 @@ export const loginCommand = createSubcommand({
 		response: z.object({ success: z.boolean() }),
 	},
 	async handler(ctx) {
-		const { logger, config, apiClient, opts, options } = ctx;
+		const { logger, config, apiClient, options } = ctx;
+		const opts = ctx.opts ?? {};
 
 		if (opts.setupToken) {
 			const url = getAPIBaseURL(config);

package/src/cmd/build/ast.ts

@@ -11,6 +11,11 @@ import type { LogLevel } from '../../types';
 import { existsSync, mkdirSync } from 'node:fs';
 import JSON5 from 'json5';
 import { formatSchemaCode } from './format-schema';
+import {
+	computeApiMountPath,
+	joinMountAndRoute,
+	extractRelativeApiPath,
+} from './vite/api-mount-path';
 
 const logger = createLogger((process.env.AGENTUITY_LOG_LEVEL || 'info') as LogLevel);
 
@@ -1492,26 +1497,18 @@ export async function parseRoute(
 
 	const rel = relative(rootDir, filename);
 
-	// For src/api/index.ts, we don't want to add the folder name since it's the root API router
-	const isRootApi = filename.includes('src/api/index.ts');
-
-	// For nested routes, use the full path from src/api/ instead of just the immediate parent
-	// e.g., src/api/v1/users/route.ts -> routeName = "v1/users"
-	//       src/api/auth/route.ts -> routeName = "auth"
-	//       src/api/test.ts -> routeName = "" (file directly in src/api/)
-	let routeName = '';
-	if (!isRootApi) {
-		const apiMatch = filename.match(/src\/api\/(.+?)\/[^/]+\.ts$/);
-		if (apiMatch) {
-			// File in subdirectory: src/api/auth/route.ts -> "auth"
-			routeName = apiMatch[1];
-		}
-		// For files directly in src/api/ (e.g., test.ts), routeName stays empty
-		// This prevents double /api prefix since these files often define full paths
-	}
+	// Compute the API mount path using the shared helper
+	// This ensures consistency between route type generation (here) and runtime mounting (entry-generator.ts)
+	// Examples:
+	//   src/api/index.ts           -> basePath = '/api'
+	//   src/api/sessions.ts        -> basePath = '/api/sessions'
+	//   src/api/auth/route.ts      -> basePath = '/api/auth'
+	//   src/api/users/profile/route.ts -> basePath = '/api/users/profile'
+	const srcDir = join(rootDir, 'src');
+	const relativeApiPath = extractRelativeApiPath(filename, srcDir);
+	const basePath = computeApiMountPath(relativeApiPath);
 
 	const routes: RouteDefinition = [];
-	const routePrefix = '/api';
 
 	try {
 		for (const body of ast.body) {
@@ -1593,9 +1590,7 @@ export async function parseRoute(
 
 								// Create a route entry for each method
 								for (const httpMethod of methods) {
-									const thepath = `${routePrefix}/${routeName}/${pathSuffix}`
-										.replaceAll(/\/{2,}/g, '/')
-										.replaceAll(/\/$/g, '');
+									const thepath = joinMountAndRoute(basePath, pathSuffix);
 									const id = generateRouteId(
 										projectId,
 										deploymentId,
@@ -1692,9 +1687,7 @@ export async function parseRoute(
 
 								// Create a route entry for each supported method
 								for (const httpMethod of SUPPORTED_HTTP_METHODS) {
-									const thepath = `${routePrefix}/${routeName}/${pathSuffix}`
-										.replaceAll(/\/{2,}/g, '/')
-										.replaceAll(/\/$/g, '');
+									const thepath = joinMountAndRoute(basePath, pathSuffix);
 									const id = generateRouteId(
 										projectId,
 										deploymentId,
@@ -1888,9 +1881,7 @@ export async function parseRoute(
 								});
 							}
 						}
-						const thepath = `${routePrefix}/${routeName}/${suffix}`
-							.replaceAll(/\/{2,}/g, '/')
-							.replaceAll(/\/$/g, '');
+						const thepath = joinMountAndRoute(basePath, suffix);
 						const id = generateRouteId(
 							projectId,
 							deploymentId,

package/src/cmd/build/entry-generator.ts

@@ -7,6 +7,7 @@ import { join } from 'node:path';
 import type { Logger, WorkbenchConfig, AnalyticsConfig } from '../../types';
 import { discoverRoutes } from './vite/route-discovery';
 import { generateWebAnalyticsFile } from './webanalytics-generator';
+import { computeApiMountPath } from './vite/api-mount-path';
 
 interface GenerateEntryOptions {
 	rootDir: string;
@@ -107,21 +108,14 @@ export async function generateEntryFile(options: GenerateEntryOptions): Promise<
 	let routeIndex = 0;
 
 	for (const routeFile of sortedRouteFiles) {
+		// Normalize path separators for cross-platform compatibility (Windows uses backslashes)
+		const normalizedRouteFile = routeFile.replace(/\\/g, '/');
 		// Convert src/api/auth/route.ts -> auth/route
-		const relativePath = routeFile.replace(/^src\/api\//, '').replace(/\.tsx?$/, '');
-
-		// Determine the mount path
-		// src/api/index.ts -> /api
-		// src/api/auth/route.ts -> /api/auth
-		// src/api/users/profile/route.ts -> /api/users/profile
-		let mountPath = '/api';
-		if (relativePath !== 'index') {
-			// Remove 'route' or 'index' from the end
-			const cleanPath = relativePath.replace(/\/(route|index)$/, '');
-			if (cleanPath) {
-				mountPath = `/api/${cleanPath}`;
-			}
-		}
+		const relativePath = normalizedRouteFile.replace(/^src\/api\//, '').replace(/\.tsx?$/, '');
+
+		// Determine the mount path using the shared helper
+		// This ensures consistency with route type generation in ast.ts
+		const mountPath = computeApiMountPath(relativePath);
 
 		const importName = `router_${routeIndex++}`;
 		routeImportsAndMounts.push(

package/src/cmd/build/vite/api-mount-path.ts

@@ -0,0 +1,87 @@
+/**
+ * API Mount Path Utilities
+ *
+ * Shared helpers for computing API route mount paths from file paths.
+ * Used by both entry-generator.ts (runtime mounting) and ast.ts (type generation)
+ * to ensure consistent path calculation.
+ */
+
+/**
+ * Compute the API mount path from a route file's relative path.
+ * This is the path used in app.route(mountPath, router).
+ *
+ * The mount path is based on the DIRECTORY containing the file, not the filename.
+ * Files directly in src/api/ (regardless of their name) mount at /api.
+ * Files in subdirectories mount at /api/{subdirectory}.
+ *
+ * @param relativePath - Path relative to src/api/ without extension
+ *                       e.g., 'index', 'sessions', 'auth/route', 'users/profile/route'
+ * @returns Mount path like '/api', '/api/auth', '/api/users/profile'
+ *
+ * @example
+ * computeApiMountPath('index')              // '/api' (file in src/api/)
+ * computeApiMountPath('sessions')           // '/api' (file in src/api/)
+ * computeApiMountPath('route')              // '/api' (file in src/api/)
+ * computeApiMountPath('auth/route')         // '/api/auth' (file in src/api/auth/)
+ * computeApiMountPath('auth/index')         // '/api/auth' (file in src/api/auth/)
+ * computeApiMountPath('users/profile/route') // '/api/users/profile' (file in src/api/users/profile/)
+ */
+export function computeApiMountPath(relativePath: string): string {
+	// Extract the directory path (everything before the last /)
+	const lastSlashIndex = relativePath.lastIndexOf('/');
+	if (lastSlashIndex === -1) {
+		// File is directly in src/api/ (e.g., 'index', 'sessions', 'route')
+		return '/api';
+	}
+
+	// File is in a subdirectory (e.g., 'auth/route' -> 'auth')
+	const dirPath = relativePath.substring(0, lastSlashIndex);
+	return `/api/${dirPath}`;
+}
+
+/**
+ * Join a mount base path with a route's local path.
+ * Handles normalization of slashes and empty/root paths.
+ *
+ * @param base - The mount base path (e.g., '/api/sessions')
+ * @param route - The local route path (e.g., '/', '/users', ':id')
+ * @returns The combined full path
+ *
+ * @example
+ * joinMountAndRoute('/api/sessions', '/')      // '/api/sessions'
+ * joinMountAndRoute('/api/sessions', '/users') // '/api/sessions/users'
+ * joinMountAndRoute('/api', '/health')         // '/api/health'
+ * joinMountAndRoute('/api/users', ':id')       // '/api/users/:id'
+ */
+export function joinMountAndRoute(base: string, route: string): string {
+	if (!route || route === '/') {
+		return base;
+	}
+	const normalized = route.startsWith('/') ? route : `/${route}`;
+	return `${base}${normalized}`.replace(/\/{2,}/g, '/').replace(/\/$/, '');
+}
+
+import { join, relative } from 'node:path';
+
+/**
+ * Extract the relative path from a full file path to src/api/.
+ * Normalizes path separators for cross-platform compatibility.
+ *
+ * @param filename - Full path to the route file
+ * @param srcDir - Path to the src directory
+ * @returns Path relative to src/api/ without extension
+ *
+ * @example
+ * // Given srcDir = '/project/src'
+ * extractRelativeApiPath('/project/src/api/sessions.ts', '/project/src')
+ * // Returns: 'sessions'
+ *
+ * extractRelativeApiPath('/project/src/api/auth/route.ts', '/project/src')
+ * // Returns: 'auth/route'
+ */
+export function extractRelativeApiPath(filename: string, srcDir: string): string {
+	const apiDir = join(srcDir, 'api');
+	return relative(apiDir, filename)
+		.replace(/\\/g, '/') // Normalize Windows paths
+		.replace(/\.tsx?$/, ''); // Remove extension
+}

package/src/cmd/cloud/deploy.ts

@@ -13,6 +13,7 @@ import {
 	getDefaultConfigDir,
 	loadProjectSDKKey,
 	updateProjectConfig,
+	getGlobalCatalystAPIClient,
 } from '../../config';
 import { getProjectGithubStatus } from '../git/api';
 import { runGitLink } from '../git/link';
@@ -341,8 +342,10 @@ export const deploySubcommand = createSubcommand({
 						return null;
 					}
 					logger.debug('Checking %d packages for malware', packages.length);
+					// Use Catalyst client directly for malware check (security routes are on Catalyst)
+					const catalystClient = await getGlobalCatalystAPIClient(logger, auth, config?.name);
 					const result = await projectDeploymentMalwareCheck(
-						apiClient,
+						catalystClient,
 						deployment!.id,
 						packages
 					);

package/src/cmd/cloud/sandbox/snapshot/build.ts

@@ -165,7 +165,7 @@ function substituteVariables(
 }
 
 // Default patterns that are always excluded from snapshot builds
-const DEFAULT_EXCLUSIONS = ['.git/**', 'node_modules/**', '.agentuity/**', '.env*'];
+const DEFAULT_EXCLUSIONS = ['.git', '.git/**', 'node_modules/**', '.agentuity/**', '.env*'];
 
 async function resolveFileGlobs(
 	directory: string,
@@ -203,6 +203,8 @@ async function resolveFileGlobs(
 		}
 	}
 
+	// Expand exclusion patterns to include nested variants
+	const expandedExclusions: string[] = [];
 	for (let pattern of exclusions) {
 		// If pattern already contains glob wildcards, use it as-is
 		// Otherwise, check if it refers to a directory and auto-append /** to exclude all contents
@@ -219,6 +221,16 @@ async function resolveFileGlobs(
 			}
 		}
 
+		expandedExclusions.push(pattern);
+
+		// Add **/ prefix variant to match nested occurrences (e.g., .agentuity/** -> **/.agentuity/**)
+		// Skip if pattern already starts with **/ or is just a wildcard pattern
+		if (!pattern.startsWith('**/')) {
+			expandedExclusions.push(`**/${pattern}`);
+		}
+	}
+
+	for (const pattern of expandedExclusions) {
 		const glob = new Bun.Glob(pattern);
 		for await (const file of glob.scan({ cwd: directory, dot: true })) {
 			files.delete(file);

package/src/version-check.ts

@@ -1,4 +1,4 @@
-import type { Config, Logger, CommandDefinition } from './types';
+import type { Config, Logger, CommandDefinition, SubcommandDefinition } from './types';
 import { isRunningFromExecutable, fetchLatestVersion } from './cmd/upgrade';
 import { getVersion, getCompareUrl, getReleaseUrl, toTag } from './version';
 import * as tui from './tui';
@@ -7,6 +7,9 @@ import { $ } from 'bun';
 
 const ONE_HOUR_MS = 60 * 60 * 1000;
 
+// Tags that indicate a command should skip the upgrade prompt
+const SKIP_UPGRADE_TAGS = ['read-only', 'fast'];
+
 /**
  * Check if we should skip the version check based on environment and config
  */
@@ -20,6 +23,7 @@ function shouldSkipCheck(
 		skipVersionCheck?: boolean;
 	},
 	commandDef: CommandDefinition | undefined,
+	subcommandDef: SubcommandDefinition | undefined,
 	args: string[]
 ): boolean {
 	// Skip if running via bun/bunx (not installed executable)
@@ -64,6 +68,21 @@ function shouldSkipCheck(
 		return true;
 	}
 
+	// Skip if subcommand explicitly opts out of upgrade check
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	if (subcommandDef && (subcommandDef as any).skipUpgradeCheck === true) {
+		return true;
+	}
+
+	// Skip if command or subcommand has tags indicating it's read-only or fast
+	// These commands shouldn't be interrupted with upgrade prompts
+	const commandTags = commandDef?.tags ?? [];
+	const subcommandTags = subcommandDef?.tags ?? [];
+	const allTags = [...commandTags, ...subcommandTags];
+	if (allTags.some((tag) => SKIP_UPGRADE_TAGS.includes(tag))) {
+		return true;
+	}
+
 	// Skip for help commands
 	const helpFlags = ['--help', '-h', 'help'];
 	if (args.some((arg) => helpFlags.includes(arg))) {
@@ -187,10 +206,11 @@ export async function checkForUpdates(
 		skipVersionCheck?: boolean;
 	},
 	commandDef: CommandDefinition | undefined,
+	subcommandDef: SubcommandDefinition | undefined,
 	args: string[]
 ): Promise<void> {
 	// Determine if we should skip the check
-	if (shouldSkipCheck(config, options, commandDef, args)) {
+	if (shouldSkipCheck(config, options, commandDef, subcommandDef, args)) {
 		logger.trace('Skipping version check (disabled or not applicable)');
 		return;
 	}