@agentuity/cli 2.0.10 → 3.0.0-alpha.0

package/src/cmd/cloud/deploy.ts

@@ -69,7 +69,12 @@ import { validateAptDependencies } from '../../utils/apt-validator';
 import { extractDependencies } from '../../utils/deps';
 import { zipDir } from '../../utils/zip';
 import { typecheck } from '../build/typecheck';
-import { viteBundle } from '../build/vite-bundler';
+import { detectFrameworkWithPackageJson } from '../build/detect';
+import { getAdapter } from '../build/adapters';
+import { packageBuildOutput } from '../build/package';
+import type { BuildResult } from '../build/adapters/types';
+import type { PackageResult } from '../build/package';
+import { generateDeployMetadata } from '../../deploy-metadata';
 import { getProjectGithubStatus } from '../git/api';
 import { runGitLink } from '../git/link';
 import { runForkedDeploy } from './deploy-fork';
@@ -276,6 +281,7 @@ export const deploySubcommand = createSubcommand({
 
 		let deployment: Deployment | undefined;
 		let build: BuildMetadata | undefined;
+		let buildOutputDir: string | undefined;
 		let instructions: DeploymentInstructions | undefined;
 		let complete: DeploymentComplete | undefined;
 		let statusResult: DeploymentStatusResult | undefined;
@@ -631,7 +637,7 @@ export const deploySubcommand = createSubcommand({
 							if (!deployment) {
 								return stepError('deployment was null');
 							}
-							let capturedOutput: string[] = [];
+							const capturedOutput: string[] = [];
 							const rootDir = resolve(projectDir);
 
 							// Run typecheck with collector for error reporting
@@ -653,20 +659,85 @@ export const deploySubcommand = createSubcommand({
 								return stepError('Typecheck failed\n\n' + typeResult.output);
 							}
 							try {
-								const bundleResult = await viteBundle({
-									rootDir,
+								// Step 1: Detect framework
+								const { framework, packageJson } =
+									await detectFrameworkWithPackageJson(rootDir);
+
+								if (!framework) {
+									return stepError(
+										'Could not detect a JS framework. Ensure package.json exists with a build script.'
+									);
+								}
+
+								const frameworkLabel = framework.version
+									? `${framework.name} v${framework.version}`
+									: framework.name;
+								capturedOutput.push(
+									tui.muted(`✓ Detected ${frameworkLabel} (${framework.runtime})`)
+								);
+
+								// Step 2: Get adapter and build
+								const outDir = join(rootDir, '.agentuity');
+								const adapter = getAdapter(framework.name);
+
+								const endBuildDiagnostic = collector.startDiagnostic('build');
+								const buildResult: BuildResult = await adapter.build({
+									projectDir: rootDir,
+									framework,
+									packageJson: packageJson!,
+									outputDir: outDir,
+									logger: ctx.logger,
+									collector,
 									dev: false,
-									deploymentId: deployment.id,
-									orgId: deployment.orgId,
 									projectId: project.projectId,
+									orgId: deployment.orgId,
 									region: project.region,
-									logger: ctx.logger,
+									deploymentId: deployment.id,
 									deploymentOptions: opts,
 									deploymentConfig: project.deployment,
-									collector,
 								});
-								capturedOutput = [...capturedOutput, ...bundleResult.output];
-								build = await loadBuildMetadata(join(projectDir, '.agentuity'));
+								endBuildDiagnostic();
+
+								capturedOutput.push(...buildResult.logs);
+								buildOutputDir = buildResult.outputDir;
+
+								// Step 3: Package output (launch.json, Procfile, .agentuity-build)
+								const packageResult: PackageResult = packageBuildOutput(
+									framework,
+									buildResult,
+									buildResult.outputDir
+								);
+
+								// Step 4: Generate deploy metadata
+								const isAgentuity = framework.name === 'agentuity';
+
+								if (isAgentuity) {
+									// Agentuity native: the Vite pipeline writes agentuity.metadata.json
+									// with full routes, agents, and assets — load it and add launch metadata
+									build = await loadBuildMetadata(buildResult.outputDir);
+									build.launch = packageResult.launch;
+								} else {
+									// Non-Agentuity: generate metadata from build result
+									build = await generateDeployMetadata({
+										buildResult,
+										packageResult,
+										projectDir: rootDir,
+										projectId: project.projectId,
+										orgId: deployment.orgId,
+										region: project.region,
+										deploymentId: deployment.id,
+										deploymentConfig: project.deployment,
+										deploymentOptions: opts,
+										logger: ctx.logger,
+									});
+								}
+
+								ctx.logger.debug(
+									'Launch metadata: %s',
+									JSON.stringify(build.launch, null, 2)
+								);
+
+								// Step 5: Send metadata to API to get upload URLs
 								instructions = await projectDeploymentUpdate(
 									apiClient,
 									deployment.id,
@@ -746,9 +817,10 @@ export const deploySubcommand = createSubcommand({
 							const endZipDiagnostic = collector.startDiagnostic('zip-package');
 							progress(5);
 							ctx.logger.trace('Starting deployment zip creation');
-							// zip up the assets folder
+							// zip up the build output directory
+							const zipSourceDir = buildOutputDir ?? join(projectDir, '.agentuity');
 							const deploymentZip = join(tmpdir(), `${deployment.id}.zip`);
-							await zipDir(join(projectDir, '.agentuity'), deploymentZip, {
+							await zipDir(zipSourceDir, deploymentZip, {
 								filter: (_filename: string, relative: string) => {
 									if (relative.startsWith('.vite/')) {
 										return false;
@@ -878,7 +950,8 @@ export const deploySubcommand = createSubcommand({
 										}
 
 										// Asset filename already includes the subdirectory (e.g., "client/assets/main-abc123.js")
-										const filePath = join(projectDir, '.agentuity', asset.filename);
+										const assetBaseDir = buildOutputDir ?? join(projectDir, '.agentuity');
+										const filePath = join(assetBaseDir, asset.filename);
 
 										const headers: Record<string, string> = {
 											'Content-Type': asset.contentType,

package/src/cmd/coder/create.ts

@@ -44,6 +44,12 @@ export const createCoderSubcommand = createSubcommand({
 			),
 			description: 'Create with label and tags, return JSON',
 		},
+		{
+			command: getCommand(
+				'coder create "Review this change" --default-agent code-review --enabled-agents code-review'
+			),
+			description: 'Create with a selected agent roster and a custom default route target',
+		},
 	],
 	schema: {
 		args: z.object({
@@ -61,6 +67,10 @@ export const createCoderSubcommand = createSubcommand({
 			// Session config
 			label: z.string().optional().describe('Human-readable session label'),
 			agent: z.string().optional().describe('Default agent role (e.g. lead, scout)'),
+			defaultAgent: z
+				.string()
+				.optional()
+				.describe('Preferred default agent slug or built-in route target'),
 			visibility: z
 				.string()
 				.optional()
@@ -86,6 +96,10 @@ export const createCoderSubcommand = createSubcommand({
 			// Resources
 			workspaceId: z.string().optional().describe('Workspace ID to use'),
 			tags: z.string().optional().describe('Comma-separated tags'),
+			enabledAgents: z
+				.string()
+				.optional()
+				.describe('Comma-separated built-in/custom agents to include'),
 			env: z
 				.string()
 				.optional()
@@ -105,10 +119,14 @@ export const createCoderSubcommand = createSubcommand({
 		});
 
 		// Build the create session request body from flags
-		const body: CoderCreateSessionRequest = {
+		const body: CoderCreateSessionRequest & {
+			defaultAgent?: string;
+			enabledAgents?: string[];
+		} = {
 			task: args.task,
 			...(opts?.label && { label: opts.label }),
 			...(opts?.agent && { agent: opts.agent }),
+			...(opts?.defaultAgent && { defaultAgent: opts.defaultAgent }),
 			...(opts?.visibility && { visibility: normalizeVisibility(opts.visibility) }),
 			...(opts?.workflowMode && { workflowMode: opts.workflowMode as 'standard' | 'loop' }),
 		};
@@ -149,6 +167,11 @@ export const createCoderSubcommand = createSubcommand({
 				.split(',')
 				.map((t) => t.trim())
 				.filter(Boolean);
+		if (opts?.enabledAgents)
+			body.enabledAgents = opts.enabledAgents
+				.split(',')
+				.map((name) => name.trim())
+				.filter(Boolean);
 		if (opts?.savedSkillIds)
 			body.savedSkillIds = opts.savedSkillIds
 				.split(',')

package/src/cmd/coder/index.ts

@@ -24,6 +24,10 @@ export const command = createCommand({
 			command: getCommand('coder start'),
 			description: 'Start a coding session connected to Coder',
 		},
+		{
+			command: getCommand('coder start --dir ~/path/to/my/project'),
+			description: 'Start a coding session from a specific local project directory',
+		},
 		{
 			command: getCommand('coder create "Build a REST API"'),
 			description: 'Create a new Coder session with a task',

package/src/cmd/coder/start.ts

@@ -1,4 +1,6 @@
 import { dirname, resolve } from 'node:path';
+import { stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
 import { z } from 'zod';
 import { CoderClient, type CoderSessionListItem } from '@agentuity/core/coder';
 import { ValidationOutputError } from '@agentuity/core';
@@ -64,6 +66,10 @@ export const startSubcommand = createSubcommand({
 			command: getCommand('coder start'),
 			description: 'Start Pi with auto-detected Hub and extension',
 		},
+		{
+			command: getCommand('coder start --dir ~/path/to/my/project'),
+			description: 'Start from a specific local project directory',
+		},
 		{
 			command: getCommand('coder start --url ws://127.0.0.1:3500/api/ws'),
 			description: 'Start with explicit Coder URL',
@@ -97,6 +103,7 @@ export const startSubcommand = createSubcommand({
 	],
 	schema: {
 		options: z.object({
+			dir: z.string().optional().describe('Local project directory to start from'),
 			url: z.string().optional().describe('Coder API URL override'),
 			extension: z.string().optional().describe('Coder extension path override'),
 			pi: z.string().optional().describe('Path to pi binary'),
@@ -121,6 +128,30 @@ export const startSubcommand = createSubcommand({
 	},
 	async handler(ctx) {
 		const { opts, options } = ctx;
+
+		// Resolve working directory from optional --dir option
+		let cwd = process.cwd();
+		if (opts?.dir) {
+			// Warn if --dir is provided with --remote or --sandbox (dir is ignored in those modes)
+			if (opts?.remote !== undefined || opts?.sandbox !== undefined) {
+				tui.warning('--dir is ignored in remote/sandbox mode');
+			} else {
+				const raw = opts.dir.trim();
+				cwd =
+					raw === '~' || raw.startsWith('~/')
+						? resolve(homedir(), raw.slice(2))
+						: resolve(raw);
+
+				const st = await stat(cwd).catch(() => null);
+				if (!st?.isDirectory()) {
+					tui.fatal(
+						`The specified path is not a valid directory: ${cwd}`,
+						ErrorCode.CONFIG_INVALID
+					);
+					return;
+				}
+			}
+		}
 		const client = new CoderClient({
 			apiKey: ctx.auth.apiKey,
 			url: opts?.url,
@@ -216,6 +247,33 @@ export const startSubcommand = createSubcommand({
 		// with the coder extension loaded for Hub UI (footer, /hub, commands).
 		// Agent.emit() drives native rendering — no [remote_message] blocks.
 		if (remoteSessionId) {
+			try {
+				const session = await tui.spinner({
+					message: 'Preparing remote session…',
+					callback: async () => client.prepareSessionForRemoteAttach(remoteSessionId!),
+				});
+
+				if (session.historyOnly === true) {
+					tui.fatal(
+						`Session ${remoteSessionId} is history-only and cannot be attached remotely.`,
+						ErrorCode.CONFIG_INVALID
+					);
+					return;
+				}
+
+				if (session.runtimeAvailable === false) {
+					tui.fatal(
+						`Session ${remoteSessionId} is offline and could not be resumed for remote attach.`,
+						ErrorCode.NETWORK_ERROR
+					);
+					return;
+				}
+			} catch (err) {
+				const msg = err instanceof Error ? err.message : String(err);
+				tui.fatal(`Failed to prepare remote session: ${msg}`, ErrorCode.NETWORK_ERROR);
+				return;
+			}
+
 			if (!options.json) {
 				tui.newline();
 				tui.output(`  Hub:       ${tui.bold(hubWsUrl)}`);
@@ -343,6 +401,7 @@ export const startSubcommand = createSubcommand({
 			tui.output(`  Hub:       ${tui.bold(hubWsUrl)}`);
 			tui.output(`  Extension: ${tui.bold(extensionPath)}`);
 			tui.output(`  Pi:        ${tui.bold(piBinary)}`);
+			if (opts?.dir) tui.output(`  Dir:       ${tui.bold(cwd)}`);
 			if (opts?.agent) tui.output(`  Agent:     ${tui.bold(opts.agent)}`);
 			tui.newline();
 		}
@@ -351,7 +410,7 @@ export const startSubcommand = createSubcommand({
 		try {
 			const proc = Bun.spawn([piBinary, ...piArgs], {
 				env,
-				cwd: process.cwd(),
+				cwd,
 				stdin: 'inherit',
 				stdout: 'inherit',
 				stderr: 'inherit',

package/src/cmd/coder/update.ts

@@ -40,6 +40,10 @@ export const updateSubcommand = createSubcommand({
 			url: z.string().optional().describe('Coder API URL override'),
 			label: z.string().optional().describe('Updated session label'),
 			agent: z.string().optional().describe('Updated default agent role'),
+			defaultAgent: z
+				.string()
+				.optional()
+				.describe('Updated preferred default agent slug or built-in route target'),
 			visibility: z
 				.string()
 				.optional()
@@ -50,6 +54,10 @@ export const updateSubcommand = createSubcommand({
 			loopAutoContinue: z.boolean().optional().describe('Auto-continue loop'),
 			loopAllowDetached: z.boolean().optional().describe('Allow detached loop execution'),
 			tags: z.string().optional().describe('Comma-separated tags (replaces existing)'),
+			enabledAgents: z
+				.string()
+				.optional()
+				.describe('Comma-separated built-in/custom agents (replaces existing)'),
 		}),
 	},
 	async handler(ctx) {
@@ -64,6 +72,7 @@ export const updateSubcommand = createSubcommand({
 
 		if (opts?.label) body.label = opts.label;
 		if (opts?.agent) body.agent = opts.agent;
+		if (opts?.defaultAgent) body.defaultAgent = opts.defaultAgent;
 		if (opts?.visibility) body.visibility = normalizeVisibility(opts.visibility);
 		if (opts?.workflowMode) body.workflowMode = opts.workflowMode;
 		if (opts?.tags) {
@@ -72,6 +81,12 @@ export const updateSubcommand = createSubcommand({
 				.map((t) => t.trim())
 				.filter(Boolean);
 		}
+		if (opts?.enabledAgents) {
+			body.enabledAgents = opts.enabledAgents
+				.split(',')
+				.map((name) => name.trim())
+				.filter(Boolean);
+		}
 
 		if (
 			opts?.loopGoal ||
@@ -90,7 +105,7 @@ export const updateSubcommand = createSubcommand({
 
 		if (Object.keys(body).length === 0) {
 			tui.fatal(
-				'No update fields provided. Use --label, --visibility, --tags, --agent, --workflow-mode, or loop options.',
+				'No update fields provided. Use --label, --visibility, --tags, --agent, --default-agent, --enabled-agents, --workflow-mode, or loop options.',
 				ErrorCode.VALIDATION_FAILED
 			);
 		}
@@ -109,6 +124,8 @@ export const updateSubcommand = createSubcommand({
 			if (opts?.visibility) fields.push(`Visibility: ${body.visibility}`);
 			if (opts?.tags) fields.push(`Tags: ${(body.tags as string[]).join(', ')}`);
 			if (opts?.agent) fields.push(`Agent: ${opts.agent}`);
+			if (opts?.defaultAgent) fields.push(`Default agent: ${opts.defaultAgent}`);
+			if (opts?.enabledAgents) fields.push(`Enabled agents: ${opts.enabledAgents}`);
 			if (opts?.workflowMode || body.loop) fields.push(`Workflow: ${body.workflowMode}`);
 
 			for (const f of fields) {

package/src/cmd/coder/workspace/create.ts

@@ -45,6 +45,10 @@ export const createWorkspaceSubcommand = createSubcommand({
 			scope: z.string().optional().describe('Workspace scope: user or org'),
 			repo: z.string().optional().describe('Repository URL to add'),
 			repoBranch: z.string().optional().describe('Branch for the repository'),
+			enabledAgents: z
+				.string()
+				.optional()
+				.describe('Comma-separated built-in/custom agents to include'),
 		}),
 	},
 	async handler(ctx) {
@@ -55,7 +59,9 @@ export const createWorkspaceSubcommand = createSubcommand({
 			orgId: ctx.orgId,
 		});
 
-		const body: CoderCreateWorkspaceRequest = {
+		const body: CoderCreateWorkspaceRequest & {
+			enabledAgents?: string[];
+		} = {
 			name: args.name,
 			...(opts?.description && { description: opts.description }),
 			...(opts?.scope && { scope: opts.scope as 'user' | 'org' }),
@@ -72,9 +78,18 @@ export const createWorkspaceSubcommand = createSubcommand({
 				return;
 			}
 		}
+		if (opts?.enabledAgents) {
+			body.enabledAgents = opts.enabledAgents
+				.split(',')
+				.map((name) => name.trim())
+				.filter(Boolean);
+		}
 
 		try {
 			const created = await client.createWorkspace(body);
+			const createdEnabledAgents = Array.isArray(created.enabledAgents)
+				? created.enabledAgents.filter((name): name is string => typeof name === 'string')
+				: [];
 
 			if (options.json) {
 				return created;
@@ -88,7 +103,10 @@ export const createWorkspaceSubcommand = createSubcommand({
 			}
 			tui.output(`  Scope:       ${created.scope}`);
 			tui.output(`  Repos:       ${created.repoCount}`);
-			tui.output(`  Skills:      ${created.selectionCount}`);
+			tui.output(`  Selections:  ${created.selectionCount}`);
+			if (createdEnabledAgents.length > 0) {
+				tui.output(`  Agents:      ${createdEnabledAgents.join(', ')}`);
+			}
 
 			return created;
 		} catch (err) {

package/src/cmd/coder/workspace/list.ts

@@ -83,7 +83,7 @@ export const listSubcommand = createSubcommand({
 				Name: w.name,
 				Scope: w.scope,
 				Repos: String(w.repoCount),
-				Skills: String(w.selectionCount),
+				Selections: String(w.selectionCount),
 				Created: formatRelativeTime(w.createdAt),
 			})),
 			[
@@ -91,7 +91,7 @@ export const listSubcommand = createSubcommand({
 				{ name: 'Name', alignment: 'left' },
 				{ name: 'Scope', alignment: 'center' },
 				{ name: 'Repos', alignment: 'right' },
-				{ name: 'Skills', alignment: 'right' },
+				{ name: 'Selections', alignment: 'right' },
 				{ name: 'Created', alignment: 'right' },
 			]
 		);