@agentuity/cli 2.0.9 → 2.0.11

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';
@@ -54,9 +56,9 @@ function logValidationIssues(
 }
 
 export const startSubcommand = createSubcommand({
-	name: 'start',
-	aliases: ['run'],
-	description: 'Start a Pi coding session connected to the Coder Hub',
+	name: 'tui',
+	aliases: ['run', 'start'],
+	description: 'Start a coding session connected to Coder',
 	tags: ['fast', 'requires-auth'],
 	requires: { auth: true, org: true },
 	examples: [
@@ -64,9 +66,13 @@ 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 Hub URL',
+			description: 'Start with explicit Coder URL',
 		},
 		{
 			command: getCommand('coder start --extension ~/repos/agentuity/sdk/packages/coder-tui'),
@@ -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,
@@ -132,10 +163,11 @@ export const startSubcommand = createSubcommand({
 
 		const initProbe = await probeHubInitAccess(hubHttpUrl, {
 			apiKey: ctx.auth.apiKey,
+			orgId: ctx.orgId,
 		});
 		if (!initProbe.ok) {
 			tui.fatal(
-				`Could not bootstrap the Coder Hub at ${hubHttpUrl}: ${initProbe.message}`,
+				`Could not bootstrap the Coder at ${hubHttpUrl}: ${initProbe.message}`,
 				ErrorCode.NETWORK_ERROR
 			);
 			return;
@@ -215,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)}`);
@@ -342,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();
 		}
@@ -350,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/tui-init.ts

@@ -21,6 +21,7 @@ export async function probeHubInitAccess(
 	hubHttpUrl: string,
 	options?: {
 		apiKey?: string | null;
+		orgId?: string | null;
 		fetchImpl?: typeof fetch;
 	}
 ): Promise<HubInitProbeResult> {
@@ -29,7 +30,14 @@ export async function probeHubInitAccess(
 		accept: 'application/json',
 	};
 	if (options?.apiKey) {
-		headers['x-agentuity-auth-api-key'] = options.apiKey;
+		if (options.apiKey.startsWith('agc_')) {
+			headers['x-agentuity-auth-api-key'] = options.apiKey;
+		} else {
+			headers['authorization'] = `Bearer ${options.apiKey}`;
+		}
+	}
+	if (options?.orgId) {
+		headers['x-agentuity-orgid'] = options.orgId;
 	}
 
 	try {

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)'),
+			agentSlugs: z
+				.string()
+				.optional()
+				.describe('Comma-separated published custom agent slugs (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?.agentSlugs) {
+			body.agentSlugs = opts.agentSlugs
+				.split(',')
+				.map((slug) => slug.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, --agent-slugs, --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?.agentSlugs) fields.push(`Custom agents: ${opts.agentSlugs}`);
 			if (opts?.workflowMode || body.loop) fields.push(`Workflow: ${body.workflowMode}`);
 
 			for (const f of fields) {

package/src/cmd/coder/users.ts

@@ -23,7 +23,7 @@ function formatRelativeTime(isoDate: string): string {
 export const usersSubcommand = createSubcommand({
 	name: 'users',
 	aliases: ['user'],
-	description: 'List known Coder Hub users',
+	description: 'List known Coder users',
 	tags: ['read-only', 'fast', 'requires-auth'],
 	idempotent: true,
 	requires: { auth: true, org: true },

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'),
+			agentSlugs: z
+				.string()
+				.optional()
+				.describe('Comma-separated published custom agent slugs to add'),
 		}),
 	},
 	async handler(ctx) {
@@ -55,7 +59,9 @@ export const createWorkspaceSubcommand = createSubcommand({
 			orgId: ctx.orgId,
 		});
 
-		const body: CoderCreateWorkspaceRequest = {
+		const body: CoderCreateWorkspaceRequest & {
+			agentSlugs?: 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?.agentSlugs) {
+			body.agentSlugs = opts.agentSlugs
+				.split(',')
+				.map((slug) => slug.trim())
+				.filter(Boolean);
+		}
 
 		try {
 			const created = await client.createWorkspace(body);
+			const createdAgentSlugs = Array.isArray(created.agentSlugs)
+				? created.agentSlugs.filter((slug): slug is string => typeof slug === '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 (createdAgentSlugs.length > 0) {
+				tui.output(`  Agents:      ${createdAgentSlugs.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' },
 			]
 		);