@agentuity/cli 0.1.10 → 0.1.11

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

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+import { createCommand } from '../../../../types';
+import { getCommand } from '../../../../command-prefix';
+
+const TEMPLATE_YAML = `# yaml-language-server: $schema=https://agentuity.dev/schema/cli/v1/agentuity-snapshot.json
+#
+# Agentuity Snapshot Build File
+# =============================
+# This file defines a reproducible sandbox environment.
+# Build with: agentuity cloud sandbox snapshot build <directory>
+#
+# For documentation, see: https://agentuity.dev/Services/Sandbox
+
+# Required: Schema version (must be 1)
+version: 1
+
+# Required: Runtime environment
+# Format: name:tag (e.g., bun:1, node:20, python:3.12)
+# Run 'agentuity cloud sandbox runtime list' to see available runtimes
+runtime: bun:1
+
+# Optional: Snapshot name (alphanumeric, underscores, dashes only)
+# If not provided, a unique name will be auto-generated
+# name: my-snapshot
+
+# Optional: Human-readable description
+# Can be overridden with --description flag
+description: My sandbox snapshot
+
+# Optional: Apt packages to install
+# Packages are validated against Debian stable repositories
+# Supports version pinning: package=version or package=version* (prefix match)
+# dependencies:
+#   - curl
+#   - ffmpeg
+#   - imagemagick=8:6.9*
+
+# Optional: Files to include from the build context directory
+# Supports glob patterns and negative patterns (prefix with !)
+# Files are placed in /home/agentuity/ in the sandbox
+# files:
+#   - "*.js"              # All JS files in root
+#   - src/**              # All files in src/ recursively
+#   - config/*.json       # All JSON files in config/
+#   - "!**/*.test.js"     # Exclude test files
+#   - "!node_modules/**"  # Exclude node_modules
+
+# Optional: Environment variables
+# Use \${VAR} syntax for build-time substitution via --env flag
+# env:
+#   NODE_ENV: production
+#   API_URL: https://api.example.com
+#   SECRET_KEY: \${SECRET_KEY}  # Substituted from: --env SECRET_KEY=value
+
+# Optional: Custom metadata
+# Use \${VAR} syntax for build-time substitution via --metadata flag
+# Stored with the snapshot for reference
+# metadata:
+#   version: \${VERSION}   # Substituted from: --metadata VERSION=1.0.0
+#   author: team-name
+#   build_date: \${BUILD_DATE}
+`;
+
+const TEMPLATE_JSON = {
+	$schema: 'https://agentuity.dev/schema/cli/v1/agentuity-snapshot.json',
+	version: 1,
+	runtime: 'bun:1',
+	name: 'my-snapshot',
+	description: 'My sandbox snapshot',
+	dependencies: ['curl'],
+	files: ['src/**', '*.js', '!**/*.test.js'],
+	env: {
+		NODE_ENV: 'production',
+	},
+	metadata: {
+		version: '1.0.0',
+	},
+};
+
+const GenerateResponseSchema = z.object({
+	format: z.enum(['yaml', 'json']).describe('Output format'),
+	content: z.string().describe('Generated template content'),
+});
+
+export const generateSubcommand = createCommand({
+	name: 'generate',
+	aliases: ['gen', 'init'],
+	description: 'Generate a template snapshot build file',
+	tags: [],
+	requires: {},
+	examples: [
+		{
+			command: getCommand('cloud sandbox snapshot generate'),
+			description: 'Generate a YAML template (default)',
+		},
+		{
+			command: getCommand('cloud sandbox snapshot generate --format json'),
+			description: 'Generate a JSON template',
+		},
+		{
+			command: getCommand('cloud sandbox snapshot generate > agentuity-snapshot.yaml'),
+			description: 'Save template to a file',
+		},
+	],
+	schema: {
+		options: z.object({
+			format: z.enum(['yaml', 'json']).default('yaml').describe('Output format (yaml or json)'),
+		}),
+		response: GenerateResponseSchema,
+	},
+
+	async handler(ctx) {
+		const { opts, options } = ctx;
+		const format = opts.format;
+
+		let content: string;
+		if (format === 'json') {
+			content = JSON.stringify(TEMPLATE_JSON, null, 2);
+		} else {
+			content = TEMPLATE_YAML;
+		}
+
+		if (!options.json) {
+			console.log(content);
+		}
+
+		return {
+			format,
+			content,
+		};
+	},
+});
+
+export default generateSubcommand;

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

@@ -21,6 +21,7 @@ const SandboxInfoSchema = z.object({
 
 const SnapshotGetResponseSchema = z.object({
 	snapshotId: z.string().describe('Snapshot ID'),
+	name: z.string().describe('Snapshot name'),
 	tag: z.string().nullable().optional().describe('Snapshot tag'),
 	sizeBytes: z.number().describe('Snapshot size in bytes'),
 	fileCount: z.number().describe('Number of files'),
@@ -28,6 +29,11 @@ const SnapshotGetResponseSchema = z.object({
 	createdAt: z.string().describe('Creation timestamp'),
 	downloadUrl: z.string().optional().describe('Presigned download URL'),
 	files: z.array(SnapshotFileSchema).nullable().optional().describe('Files in snapshot'),
+	userMetadata: z
+		.record(z.string(), z.string())
+		.nullable()
+		.optional()
+		.describe('User-defined metadata'),
 	sandboxes: z
 		.array(SandboxInfoSchema)
 		.optional()
@@ -73,6 +79,7 @@ export const getSubcommand = createCommand({
 
 		if (!options.json) {
 			tui.info(`Snapshot: ${tui.bold(snapshot.snapshotId)}`);
+			console.log(`  ${tui.muted('Name:')}    ${snapshot.name}`);
 			if (snapshot.tag) {
 				console.log(`  ${tui.muted('Tag:')}     ${snapshot.tag}`);
 			}
@@ -83,6 +90,18 @@ export const getSubcommand = createCommand({
 				console.log(`  ${tui.muted('Parent:')}  ${snapshot.parentSnapshotId}`);
 			}
 
+			if (
+				snapshot.userMetadata &&
+				typeof snapshot.userMetadata === 'object' &&
+				Object.keys(snapshot.userMetadata).length > 0
+			) {
+				console.log('');
+				tui.info('Metadata:');
+				for (const [key, value] of Object.entries(snapshot.userMetadata)) {
+					console.log(`  ${tui.muted('•')} ${key}=${value}`);
+				}
+			}
+
 			if (snapshot.files && snapshot.files.length > 0) {
 				console.log('');
 				tui.info('Files:');

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

@@ -4,6 +4,8 @@ import { listSubcommand } from './list';
 import { getSubcommand } from './get';
 import { deleteSubcommand } from './delete';
 import { tagSubcommand } from './tag';
+import { buildSubcommand } from './build';
+import { generateSubcommand } from './generate';
 import { getCommand } from '../../../../command-prefix';
 
 export const snapshotCommand = createCommand({
@@ -20,8 +22,24 @@ export const snapshotCommand = createCommand({
 			command: getCommand('cloud sandbox snapshot list'),
 			description: 'List all snapshots',
 		},
+		{
+			command: getCommand('cloud sandbox snapshot build .'),
+			description: 'Build a snapshot from a declarative file',
+		},
+		{
+			command: getCommand('cloud sandbox snapshot generate > agentuity-snapshot.yaml'),
+			description: 'Generate a template build file',
+		},
+	],
+	subcommands: [
+		createSubcommand,
+		listSubcommand,
+		getSubcommand,
+		deleteSubcommand,
+		tagSubcommand,
+		buildSubcommand,
+		generateSubcommand,
 	],
-	subcommands: [createSubcommand, listSubcommand, getSubcommand, deleteSubcommand, tagSubcommand],
 	requires: { auth: true, org: true },
 });
 

package/src/cmd/project/auth/shared.ts

@@ -262,7 +262,7 @@ export async function detectOrmSetup(projectDir: string): Promise<OrmSetup> {
  * @returns SQL DDL statements for auth tables
  */
 export async function generateAuthSchemaSql(logger: Logger, projectDir: string): Promise<string> {
-	const schemaPath = path.join(projectDir, 'node_modules/@agentuity/auth/src/schema.ts');
+	const schemaPath = path.join(projectDir, 'node_modules/@agentuity/auth/dist/schema.js');
 
 	if (!(await Bun.file(schemaPath).exists())) {
 		throw new Error(

package/src/config.ts

@@ -732,7 +732,12 @@ export async function getDefaultRegion(profileName = 'production'): Promise<stri
 		return process.env.AGENTUITY_REGION;
 	}
 
-	// 2. Check cached regions file (sorted by distance)
+	// 2. Local profile always uses 'local' region
+	if (profileName === 'local') {
+		return 'local';
+	}
+
+	// 3. Check cached regions file (sorted by distance)
 	try {
 		const cachePath = join(getDefaultConfigDir(), `regions-${profileName}.json`);
 		const file = Bun.file(cachePath);
@@ -746,8 +751,8 @@ export async function getDefaultRegion(profileName = 'production'): Promise<stri
 		// Fall through to default
 	}
 
-	// 3. Final fallback - 'local' for local profile, 'usc' otherwise
-	return profileName === 'local' ? 'local' : 'usc';
+	// 4. Final fallback
+	return 'usc';
 }
 
 /**

package/src/utils/apt-validator.ts

@@ -1,6 +1,6 @@
 import { StructuredError, type Logger } from '@agentuity/core';
 import type { Config } from '../types';
-import { getAppBaseURL } from '@agentuity/server';
+import { getAPIBaseURL } from '@agentuity/server';
 import { getUserAgent } from '../api';
 import { getDefaultConfigDir } from '../config';
 import { join, dirname } from 'node:path';
@@ -145,8 +145,8 @@ export async function validateAptDependencies(
 		packages.length - uncachedPackages.length
 	);
 
-	const appBaseUrl = getAppBaseURL(region, config?.overrides);
-	const url = `${appBaseUrl}/api/cli/validate/apt-dependencies`;
+	const apiBaseUrl = getAPIBaseURL(region, config?.overrides ?? undefined);
+	const url = `${apiBaseUrl}/cli/validate/apt-dependencies`;
 
 	const response = await fetch(url, {
 		method: 'POST',