@agentuity/cli 1.0.42 → 1.0.44

package/src/cmd/build/vite/server-bundler.ts

@@ -7,7 +7,7 @@ import { join } from 'node:path';
 import { readdir, stat } from 'node:fs/promises';
 import type { Logger } from '../../../types';
 import type { BunPlugin, BuildOutput } from 'bun';
-import { generatePatches, applyPatch } from '../patch';
+import { generatePatches, applyPatch, buildPatchFilter } from '../patch';
 import { getLoaderForPath, rewriteBunImports, rewritePgImports } from './db-rewrite';
 
 /**
@@ -291,13 +291,9 @@ export async function installExternalsAndBuild(options: ServerBundleOptions): Pr
 		name: 'agentuity:patch',
 		setup(build) {
 			for (const [, patch] of patches) {
-				let modulePath = join('node_modules', patch.module, '.*');
-				if (patch.filename) {
-					modulePath = join('node_modules', patch.module, patch.filename + '.*');
-				}
 				build.onLoad(
 					{
-						filter: new RegExp(modulePath),
+						filter: buildPatchFilter(patch.module, patch.filename),
 						namespace: 'file',
 					},
 					async (args) => {

package/src/cmd/cloud/oidc/activity.ts

@@ -1,8 +1,9 @@
-import { oauthClientActivity, type APIClient } from '@agentuity/core';
+import { oauthClientActivity } from '@agentuity/core';
 import { z } from 'zod';
 import { getCommand } from '../../../command-prefix';
 import * as tui from '../../../tui';
 import { createSubcommand } from '../../../types';
+import { createOAuthClient } from './util';
 
 const OAuthClientActivityResponseSchema = z.array(
 	z.object({
@@ -23,8 +24,9 @@ export const activitySubcommand = createSubcommand({
 			description: 'Show OAuth activity for last 30 days',
 		},
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
 	idempotent: true,
+	webUrl: (ctx) => `/settings/oauth-apps/${encodeURIComponent(ctx.args.id)}`,
 	schema: {
 		args: z.object({
 			id: z.string().describe('the OAuth client id'),
@@ -36,10 +38,11 @@ export const activitySubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { args, opts, apiClient, options } = ctx;
+		const { args, opts, options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		const activity = await tui.spinner('Fetching OAuth activity', () => {
-			return oauthClientActivity(apiClient as APIClient, args.id, opts.days);
+			return oauthClientActivity(catalystClient, args.id, opts.days);
 		});
 
 		if (!options.json) {

package/src/cmd/cloud/oidc/create.ts

@@ -1,14 +1,10 @@
-import {
-	oauthClientCreate,
-	oauthScopes,
-	type APIClient,
-	type OAuthClientCreateRequest,
-} from '@agentuity/core';
+import { oauthClientCreate, oauthScopes, type OAuthClientCreateRequest } from '@agentuity/core';
 import enquirer from 'enquirer';
 import { z } from 'zod';
 import { getCommand } from '../../../command-prefix';
 import * as tui from '../../../tui';
 import { createSubcommand as createSubcommandHelper } from '../../../types';
+import { createOAuthClient } from './util';
 
 const OAuthClientCreateResponseSchema = z.object({
 	client: z.object({
@@ -50,8 +46,9 @@ export const createSubcommand = createSubcommandHelper({
 			description: 'Create OAuth application interactively',
 		},
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
 	idempotent: false,
+	webUrl: '/settings/oauth-apps',
 	schema: {
 		options: z.object({
 			name: z.string().optional().describe('the OAuth application name'),
@@ -74,10 +71,11 @@ export const createSubcommand = createSubcommandHelper({
 	},
 
 	async handler(ctx) {
-		const { opts, apiClient, options } = ctx;
+		const { opts, options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		const availableScopes = await tui.spinner('Fetching available OAuth scopes', () => {
-			return oauthScopes(apiClient as APIClient);
+			return oauthScopes(catalystClient);
 		});
 
 		const nonInteractive = !process.stdin.isTTY || !process.stdout.isTTY;
@@ -201,7 +199,7 @@ export const createSubcommand = createSubcommandHelper({
 		};
 
 		const result = await tui.spinner('Creating OAuth application', () => {
-			return oauthClientCreate(apiClient as APIClient, request);
+			return oauthClientCreate(catalystClient, request);
 		});
 
 		if (!options.json) {

package/src/cmd/cloud/oidc/delete.ts

@@ -1,9 +1,10 @@
-import { oauthClientDelete, type APIClient } from '@agentuity/core';
+import { oauthClientDelete } from '@agentuity/core';
 import { z } from 'zod';
 import { getCommand } from '../../../command-prefix';
 import { ErrorCode } from '../../../errors';
 import * as tui from '../../../tui';
 import { createSubcommand } from '../../../types';
+import { createOAuthClient } from './util';
 
 const OAuthClientDeleteResponseSchema = z.object({
 	success: z.boolean().describe('Whether the operation succeeded'),
@@ -23,7 +24,8 @@ export const deleteSubcommand = createSubcommand({
 			description: 'Delete OAuth application without confirmation',
 		},
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
+	webUrl: '/settings/oauth-apps',
 	schema: {
 		args: z.object({
 			id: z.string().describe('the OAuth client id to delete'),
@@ -36,7 +38,8 @@ export const deleteSubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { args, opts, apiClient, options } = ctx;
+		const { args, opts, options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		const skipConfirm = opts.force || opts.yes;
 
@@ -48,7 +51,7 @@ export const deleteSubcommand = createSubcommand({
 		}
 
 		await tui.spinner('Deleting OAuth application', () => {
-			return oauthClientDelete(apiClient as APIClient, args.id);
+			return oauthClientDelete(catalystClient, args.id);
 		});
 
 		if (!options.json) {

package/src/cmd/cloud/oidc/get.ts

@@ -1,9 +1,10 @@
-import { oauthClientGet, type APIClient } from '@agentuity/core';
+import { oauthClientGet } from '@agentuity/core';
 import { z } from 'zod';
 import { getCommand } from '../../../command-prefix';
 import { ErrorCode } from '../../../errors';
 import * as tui from '../../../tui';
 import { createSubcommand } from '../../../types';
+import { createOAuthClient } from './util';
 
 export const getSubcommand = createSubcommand({
 	name: 'get',
@@ -12,8 +13,9 @@ export const getSubcommand = createSubcommand({
 	examples: [
 		{ command: getCommand('cloud oidc get <id>'), description: 'Get OAuth application details' },
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
 	idempotent: true,
+	webUrl: (ctx) => `/settings/oauth-apps/${encodeURIComponent(ctx.args.id)}`,
 	schema: {
 		args: z.object({
 			id: z.string().describe('the OAuth client id'),
@@ -21,12 +23,13 @@ export const getSubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { args, apiClient, options } = ctx;
+		const { args, options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		let client: Awaited<ReturnType<typeof oauthClientGet>>;
 		try {
 			client = await tui.spinner('Fetching OAuth application', () => {
-				return oauthClientGet(apiClient as APIClient, args.id);
+				return oauthClientGet(catalystClient, args.id);
 			});
 		} catch (error) {
 			if (error instanceof Error && error.message.includes('not found')) {

package/src/cmd/cloud/oidc/list.ts

@@ -1,7 +1,8 @@
-import { oauthClientList, type APIClient } from '@agentuity/core';
+import { oauthClientList } from '@agentuity/core';
 import { getCommand } from '../../../command-prefix';
 import * as tui from '../../../tui';
 import { createSubcommand } from '../../../types';
+import { createOAuthClient } from './util';
 
 export const listSubcommand = createSubcommand({
 	name: 'list',
@@ -12,14 +13,16 @@ export const listSubcommand = createSubcommand({
 		{ command: getCommand('cloud oidc list'), description: 'List OAuth applications' },
 		{ command: getCommand('cloud oidc ls'), description: 'List OAuth applications' },
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
 	idempotent: true,
+	webUrl: '/settings/oauth-apps',
 
 	async handler(ctx) {
-		const { apiClient, options } = ctx;
+		const { options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		const clients = await tui.spinner('Fetching OAuth applications', () => {
-			return oauthClientList(apiClient as APIClient);
+			return oauthClientList(catalystClient);
 		});
 
 		if (!options.json) {

package/src/cmd/cloud/oidc/rotate-secret.ts

@@ -1,9 +1,10 @@
-import { oauthClientRotateSecret, type APIClient } from '@agentuity/core';
+import { oauthClientRotateSecret } from '@agentuity/core';
 import { z } from 'zod';
 import { getCommand } from '../../../command-prefix';
 import { ErrorCode } from '../../../errors';
 import * as tui from '../../../tui';
 import { createSubcommand } from '../../../types';
+import { createOAuthClient } from './util';
 
 const OAuthClientRotateSecretResponseSchema = z.object({
 	client_id: z.string(),
@@ -24,8 +25,9 @@ export const rotateSecretSubcommand = createSubcommand({
 			description: 'Rotate OAuth client secret without confirmation',
 		},
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
 	idempotent: false,
+	webUrl: (ctx) => `/settings/oauth-apps/${encodeURIComponent(ctx.args.id)}`,
 	schema: {
 		args: z.object({
 			id: z.string().describe('the OAuth client id'),
@@ -37,7 +39,8 @@ export const rotateSecretSubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { args, opts, apiClient, options } = ctx;
+		const { args, opts, options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		if (!opts.force) {
 			const confirmed = await tui.confirm(
@@ -50,7 +53,7 @@ export const rotateSecretSubcommand = createSubcommand({
 		}
 
 		const result = await tui.spinner('Rotating OAuth client secret', () => {
-			return oauthClientRotateSecret(apiClient as APIClient, args.id);
+			return oauthClientRotateSecret(catalystClient, args.id);
 		});
 
 		if (!options.json) {

package/src/cmd/cloud/oidc/users.ts

@@ -1,8 +1,9 @@
-import { oauthClientUsers, type APIClient } from '@agentuity/core';
+import { oauthClientUsers } from '@agentuity/core';
 import { z } from 'zod';
 import { getCommand } from '../../../command-prefix';
 import * as tui from '../../../tui';
 import { createSubcommand } from '../../../types';
+import { createOAuthClient } from './util';
 
 const OAuthClientUsersResponseSchema = z.array(
 	z.object({
@@ -22,8 +23,9 @@ export const usersSubcommand = createSubcommand({
 			description: 'List connected users for OAuth application',
 		},
 	],
-	requires: { auth: true, apiClient: true },
+	requires: { auth: true },
 	idempotent: true,
+	webUrl: (ctx) => `/settings/oauth-apps/${encodeURIComponent(ctx.args.id)}`,
 	schema: {
 		args: z.object({
 			id: z.string().describe('the OAuth client id'),
@@ -32,10 +34,11 @@ export const usersSubcommand = createSubcommand({
 	},
 
 	async handler(ctx) {
-		const { args, apiClient, options } = ctx;
+		const { args, options } = ctx;
+		const catalystClient = await createOAuthClient(ctx);
 
 		const users = await tui.spinner('Fetching connected OAuth users', () => {
-			return oauthClientUsers(apiClient as APIClient, args.id);
+			return oauthClientUsers(catalystClient, args.id);
 		});
 
 		if (!options.json) {

package/src/cmd/cloud/oidc/util.ts

@@ -0,0 +1,28 @@
+import type { Logger } from '@agentuity/core';
+import { getGlobalCatalystAPIClient } from '../../../config';
+import * as tui from '../../../tui';
+import type { AuthData, Config, GlobalOptions, ProjectConfig } from '../../../types';
+
+export async function createOAuthClient(
+	ctx: {
+		logger: Logger;
+		auth: AuthData;
+		project?: ProjectConfig;
+		config: Config | null;
+		options: GlobalOptions;
+	},
+	explicitOrgId?: string
+) {
+	const orgId =
+		explicitOrgId ??
+		ctx.project?.orgId ??
+		ctx.options.orgId ??
+		(process.env.AGENTUITY_CLOUD_ORG_ID || ctx.config?.preferences?.orgId);
+	if (!orgId) {
+		tui.fatal(
+			'Organization ID is required. Either run from a project directory or use --org-id flag.'
+		);
+	}
+
+	return getGlobalCatalystAPIClient(ctx.logger, ctx.auth, ctx.config?.name, orgId, ctx.config);
+}

package/src/cmd/coder/hub-url.ts

@@ -41,7 +41,11 @@ export async function resolveHubUrl(flagUrl?: string): Promise<string | null> {
 export async function resolveHubWsUrl(flagUrl?: string): Promise<string | null> {
 	const httpUrl = await resolveHubUrl(flagUrl);
 	if (!httpUrl) return null;
-	return normalizeToWs(httpUrl);
+	return toHubWsUrl(httpUrl);
+}
+
+export function toHubWsUrl(hubHttpUrl: string): string {
+	return normalizeToWs(hubHttpUrl);
 }
 
 /**

package/src/cmd/coder/start.ts

@@ -5,7 +5,8 @@ import { createSubcommand } from '../../types';
 import * as tui from '../../tui';
 import { getCommand } from '../../command-prefix';
 import { ErrorCode } from '../../errors';
-import { resolveHubWsUrl, resolveHubUrl, hubFetchHeaders } from './hub-url';
+import { toHubWsUrl, resolveHubUrl, hubFetchHeaders } from './hub-url';
+import { probeTuiInitAccess } from './tui-init';
 
 /**
  * Resolve the Coder extension path.
@@ -129,14 +130,32 @@ export const startSubcommand = createSubcommand({
 		const { opts, options } = ctx;
 
 		// Resolve Hub URL
-		const hubWsUrl = await resolveHubWsUrl(opts?.hubUrl);
-		if (!hubWsUrl) {
+		const hubHttpUrl = await resolveHubUrl(opts?.hubUrl);
+		if (!hubHttpUrl) {
 			tui.fatal(
 				'Could not find a running Coder Hub.\n\nEither:\n  - Start the Hub with: bun run dev\n  - Set AGENTUITY_CODER_HUB_URL environment variable\n  - Pass --hub-url flag',
 				ErrorCode.NETWORK_ERROR
 			);
 			return;
 		}
+		const hubWsUrl = toHubWsUrl(hubHttpUrl);
+
+		const tuiInitProbe = await probeTuiInitAccess(hubHttpUrl);
+		if (!tuiInitProbe.ok) {
+			if (tuiInitProbe.code === 'unauthorized') {
+				tui.fatal(
+					`Coder Hub at ${hubHttpUrl} requires authentication.\n\nSet AGENTUITY_CODER_API_KEY in your shell and retry.\n\nServer said: ${tuiInitProbe.message}`,
+					ErrorCode.NETWORK_ERROR
+				);
+				return;
+			}
+
+			tui.fatal(
+				`Could not bootstrap the Coder Hub at ${hubHttpUrl}: ${tuiInitProbe.message}`,
+				ErrorCode.NETWORK_ERROR
+			);
+			return;
+		}
 
 		// Resolve extension path
 		const extensionPath = resolveExtensionPath(opts?.extension);
@@ -160,11 +179,6 @@ export const startSubcommand = createSubcommand({
 				remoteSessionId = remoteValue;
 			} else {
 				// No session ID — fetch connectable sessions and show picker
-				const hubHttpUrl = await resolveHubUrl(opts?.hubUrl);
-				if (!hubHttpUrl) {
-					tui.fatal('Could not find Hub URL for session picker.', ErrorCode.NETWORK_ERROR);
-					return;
-				}
 				try {
 					type SessionInfo = {
 						id: string;

package/src/cmd/coder/tui-init.ts

@@ -0,0 +1,75 @@
+import { hubFetchHeaders } from './hub-url';
+
+export type TuiInitProbeResult =
+	| { ok: true }
+	| {
+			ok: false;
+			code: 'unauthorized' | 'http_error' | 'invalid_response' | 'network_error';
+			message: string;
+	  };
+
+function normalizeErrorMessage(payload: unknown, fallback: string): string {
+	if (
+		payload &&
+		typeof payload === 'object' &&
+		typeof (payload as { error?: unknown }).error === 'string'
+	) {
+		return (payload as { error: string }).error;
+	}
+	return fallback;
+}
+
+export async function probeTuiInitAccess(
+	hubHttpUrl: string,
+	fetchImpl: typeof fetch = fetch
+): Promise<TuiInitProbeResult> {
+	try {
+		const response = await fetchImpl(`${hubHttpUrl}/api/hub/tui/init`, {
+			headers: hubFetchHeaders({ accept: 'application/json' }),
+			signal: AbortSignal.timeout(5_000),
+		});
+
+		let payload: unknown;
+		try {
+			payload = await response.json();
+		} catch {
+			payload = undefined;
+		}
+
+		if (response.status === 401 || response.status === 403) {
+			return {
+				ok: false,
+				code: 'unauthorized',
+				message: normalizeErrorMessage(payload, `${response.status} ${response.statusText}`),
+			};
+		}
+
+		if (!response.ok) {
+			return {
+				ok: false,
+				code: 'http_error',
+				message: normalizeErrorMessage(payload, `${response.status} ${response.statusText}`),
+			};
+		}
+
+		if (
+			!payload ||
+			typeof payload !== 'object' ||
+			(payload as { type?: unknown }).type !== 'init'
+		) {
+			return {
+				ok: false,
+				code: 'invalid_response',
+				message: 'Hub init endpoint did not return an init payload',
+			};
+		}
+
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			code: 'network_error',
+			message: error instanceof Error ? error.message : String(error),
+		};
+	}
+}

package/src/cmd/profile/create.ts

@@ -84,7 +84,7 @@ export const createCommand = createSubcommand({
 					vector_url: 'https://catalyst.agentuity.io',
 					catalyst_url: 'https://catalyst.agentuity.io',
 					ion_url: 'https://ion.agentuity.io',
-					gravity_url: 'grpc://gravity.agentuity.io:8443',
+					gravity_url: 'grpc://gravity.agentuity.io:443',
 				};
 				await saveConfig(localConfig, filename);
 			}

package/src/utils/route-migration.ts

@@ -697,19 +697,19 @@ export function performMigration(rootDir: string, routeFiles: string[]): Migrati
  * Show the migration notice and optionally perform migration.
  *
  * Called during `dev` and `build` after dependency upgrades.
- * Only prompts in interactive TTY sessions and only once — if the user
- * dismisses the prompt, it won't be shown again.
+ * Shows an informational banner with instructions — never blocks on
+ * interactive prompts (which would hang agents and CI pipelines).
  *
  * @returns true if migration was performed, false otherwise
  */
 export async function promptRouteMigration(
 	rootDir: string,
-	logger: Logger,
+	_logger: Logger,
 	options?: { interactive?: boolean }
 ): Promise<boolean> {
 	const interactive = options?.interactive ?? process.stdin.isTTY;
 
-	// Only show the interactive migration prompt in TTY sessions
+	// Only show the migration notice in TTY sessions
 	if (!interactive) {
 		return false;
 	}
@@ -722,7 +722,7 @@ export async function promptRouteMigration(
 
 	const { routeFiles, alreadyNotified } = eligibility;
 
-	// Only prompt once — if the user has already been notified or dismissed, don't ask again
+	// Only notify once — if the user has already been notified or dismissed, don't show again
 	if (alreadyNotified) {
 		return false;
 	}
@@ -748,35 +748,10 @@ export async function promptRouteMigration(
 	);
 
 	tui.newline();
-
-	const action = await tui.confirm('Would you like to migrate to explicit routing now?', false);
-
-	if (!action) {
-		writeMigrationState(rootDir, 'dismissed');
-		tui.info(`You can migrate later by running: ${tui.muted('agentuity dev --migrate-routes')}`);
-		tui.newline();
-		return false;
-	}
-
-	// Perform migration
+	tui.info(`Migrate by running: ${tui.muted('agentuity dev --migrate-routes')}`);
 	tui.newline();
-	const result = performMigration(rootDir, routeFiles);
 
-	if (result.success) {
-		tui.success(result.message);
-		if (result.filesCreated.length > 0) {
-			tui.info(`Created: ${result.filesCreated.map((f) => tui.muted(f)).join(', ')}`);
-		}
-		if (result.filesModified.length > 0) {
-			tui.info(`Modified: ${result.filesModified.map((f) => tui.muted(f)).join(', ')}`);
-		}
-		tui.newline();
-		tui.info('Your existing route files were not changed — they already export routers.');
-		tui.newline();
-	} else {
-		tui.warning(result.message);
-		tui.newline();
-	}
+	writeMigrationState(rootDir, 'notified');
 
-	return result.success;
+	return false;
 }