@agentuity/cli 0.1.17 → 0.1.19

package/dist/utils/git.d.ts

@@ -0,0 +1,63 @@
+import type { Logger } from '@agentuity/core';
+/**
+ * Git information detected from the repository
+ */
+export interface GitInfo {
+    branch?: string;
+    repo?: string;
+    provider?: string;
+    tags?: string[];
+    commit?: string;
+    message?: string;
+}
+/**
+ * Git options that can be provided via CLI flags to override auto-detected values
+ */
+export interface GitOptions {
+    message?: string;
+    commit?: string;
+    branch?: string;
+    repo?: string;
+    provider?: string;
+    commitUrl?: string;
+}
+/**
+ * Extended git info that includes CI-related fields
+ */
+export interface GitInfoExtended extends GitInfo {
+    commitUrl?: string;
+    logsUrl?: string;
+    trigger?: string;
+    event?: string;
+    pull_request?: {
+        number: number;
+        url?: string;
+    };
+}
+/**
+ * Detect git information from the repository at the given root directory.
+ * Walks up parent directories to find .git directory (supports monorepos).
+ *
+ * @param rootDir - The root directory to start searching for .git
+ * @param logger - Logger instance for trace output
+ * @returns Git information or undefined if not in a git repository
+ */
+export declare function getGitInfo(rootDir: string, logger: Logger): Promise<GitInfo | undefined>;
+/**
+ * Merge auto-detected git info with CLI-provided overrides.
+ * CLI options take precedence over auto-detected values.
+ *
+ * @param autoDetected - Git info auto-detected from the repository
+ * @param overrides - CLI options that override auto-detected values
+ * @returns Merged git info
+ */
+export declare function mergeGitInfo(autoDetected: GitInfo | undefined, overrides: GitOptions): GitInfoExtended;
+/**
+ * Build an array of tags from git info, including branch and short commit.
+ * Used for deployment tagging.
+ *
+ * @param gitInfo - Git information
+ * @returns Array of tags
+ */
+export declare function buildGitTags(gitInfo: GitInfo | undefined): string[];
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAsG9F;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,YAAY,EAAE,OAAO,GAAG,SAAS,EACjC,SAAS,EAAE,UAAU,GACnB,eAAe,CAwBjB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,EAAE,CAUnE"}

package/dist/utils/git.js

@@ -0,0 +1,157 @@
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * Detect git information from the repository at the given root directory.
+ * Walks up parent directories to find .git directory (supports monorepos).
+ *
+ * @param rootDir - The root directory to start searching for .git
+ * @param logger - Logger instance for trace output
+ * @returns Git information or undefined if not in a git repository
+ */
+export async function getGitInfo(rootDir, logger) {
+    if (!Bun.which('git')) {
+        logger.trace('git not found in PATH');
+        return undefined;
+    }
+    try {
+        // Find .git directory (may be in parent directories for monorepos)
+        let gitDir = join(rootDir, '.git');
+        let parentDir = dirname(dirname(gitDir));
+        while (!existsSync(gitDir) && parentDir !== dirname(parentDir) && gitDir !== '/') {
+            gitDir = join(parentDir, '.git');
+            parentDir = dirname(parentDir);
+        }
+        if (!existsSync(gitDir)) {
+            logger.trace('No .git directory found');
+            return undefined;
+        }
+        const $ = Bun.$;
+        const gitInfo = {
+            provider: 'git',
+        };
+        // Get git tags pointing to HEAD
+        const tagResult = $ `git tag -l --points-at HEAD`.nothrow().quiet();
+        if (tagResult) {
+            const tagText = await tagResult.text();
+            if (tagText) {
+                gitInfo.tags = tagText
+                    .trim()
+                    .split(/\n/)
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+            }
+        }
+        // Get current branch
+        const branchResult = $ `git branch --show-current`.nothrow().quiet();
+        if (branchResult) {
+            const branchText = await branchResult.text();
+            if (branchText) {
+                gitInfo.branch = branchText.trim();
+            }
+        }
+        // Get commit SHA
+        const commitResult = $ `git rev-parse HEAD`.nothrow().quiet();
+        if (commitResult) {
+            const commitText = await commitResult.text();
+            if (commitText) {
+                gitInfo.commit = commitText.trim();
+                // Get commit message
+                const msgResult = $ `git log --pretty=format:%s -n1 ${gitInfo.commit}`.nothrow().quiet();
+                if (msgResult) {
+                    const msgText = await msgResult.text();
+                    if (msgText) {
+                        gitInfo.message = msgText.trim();
+                    }
+                }
+            }
+        }
+        // Get remote origin URL and parse
+        const originResult = $ `git config --get remote.origin.url`.nothrow().quiet();
+        if (originResult) {
+            const originText = await originResult.text();
+            if (originText) {
+                const remoteUrl = originText.trim();
+                // Parse provider and repo from URL
+                if (remoteUrl.includes('github.com')) {
+                    gitInfo.provider = 'github';
+                    const match = remoteUrl.match(/github\.com[:/](.+?)(?:\.git)?$/);
+                    if (match) {
+                        gitInfo.repo = `https://github.com/${match[1]}`;
+                    }
+                }
+                else if (remoteUrl.includes('gitlab.com')) {
+                    gitInfo.provider = 'gitlab';
+                    const match = remoteUrl.match(/gitlab\.com[:/](.+?)(?:\.git)?$/);
+                    if (match) {
+                        gitInfo.repo = `https://gitlab.com/${match[1]}`;
+                    }
+                }
+                else if (remoteUrl.includes('bitbucket.org')) {
+                    gitInfo.provider = 'bitbucket';
+                    const match = remoteUrl.match(/bitbucket\.org[:/](.+?)(?:\.git)?$/);
+                    if (match) {
+                        gitInfo.repo = `https://bitbucket.org/${match[1]}`;
+                    }
+                }
+                else {
+                    gitInfo.repo = remoteUrl;
+                }
+            }
+        }
+        return gitInfo;
+    }
+    catch (error) {
+        logger.trace(`Failed to get git info: ${error}`);
+        return undefined;
+    }
+}
+/**
+ * Merge auto-detected git info with CLI-provided overrides.
+ * CLI options take precedence over auto-detected values.
+ *
+ * @param autoDetected - Git info auto-detected from the repository
+ * @param overrides - CLI options that override auto-detected values
+ * @returns Merged git info
+ */
+export function mergeGitInfo(autoDetected, overrides) {
+    const result = { ...(autoDetected ?? {}) };
+    // CLI overrides take precedence
+    if (overrides.message !== undefined) {
+        result.message = overrides.message;
+    }
+    if (overrides.commit !== undefined) {
+        result.commit = overrides.commit;
+    }
+    if (overrides.branch !== undefined) {
+        result.branch = overrides.branch;
+    }
+    if (overrides.repo !== undefined) {
+        result.repo = overrides.repo;
+    }
+    if (overrides.provider !== undefined) {
+        result.provider = overrides.provider;
+    }
+    if (overrides.commitUrl !== undefined) {
+        result.commitUrl = overrides.commitUrl;
+    }
+    return result;
+}
+/**
+ * Build an array of tags from git info, including branch and short commit.
+ * Used for deployment tagging.
+ *
+ * @param gitInfo - Git information
+ * @returns Array of tags
+ */
+export function buildGitTags(gitInfo) {
+    const tags = new Set(gitInfo?.tags ?? []);
+    tags.add('latest');
+    if (gitInfo?.branch) {
+        tags.add(gitInfo.branch);
+    }
+    if (gitInfo?.commit) {
+        tags.add(gitInfo.commit.substring(0, 7));
+    }
+    return Array.from(tags);
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/cli",
-	"version": "0.1.17",
+	"version": "0.1.19",
 	"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.17",
-		"@agentuity/core": "0.1.17",
-		"@agentuity/server": "0.1.17",
+		"@agentuity/auth": "0.1.19",
+		"@agentuity/core": "0.1.19",
+		"@agentuity/server": "0.1.19",
 		"@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.17"
+		"@agentuity/frontend": "0.1.19"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.1.17",
+		"@agentuity/test-utils": "0.1.19",
 		"@types/adm-zip": "^0.5.7",
 		"@types/bun": "latest",
 		"@types/tar-fs": "^2.0.4",

package/src/cmd/build/vite/metadata-generator.ts

@@ -4,13 +4,14 @@
  * Generates agentuity.metadata.json and .routemapping.json from discovered agents and routes
  */
 
-import { join, dirname } from 'node:path';
+import { join } from 'node:path';
 import { writeFileSync, mkdirSync, existsSync, readFileSync, statSync, readdirSync } from 'node:fs';
 import type { BuildMetadata } from '@agentuity/server';
 import type { AgentMetadata } from './agent-discovery';
 import type { RouteMetadata } from './route-discovery';
 import type { Logger, DeployOptions } from '../../../types';
 import { getVersion } from '../../../version';
+import { getGitInfo, buildGitTags } from '../../../utils/git';
 
 interface ViteManifestEntry {
 	file: string;
@@ -473,6 +474,12 @@ export async function generateMetadata(options: MetadataGeneratorOptions): Promi
 		},
 	};
 
+	// Build tags from git info (includes 'latest', branch, and short commit)
+	const gitInfo = metadata.deployment.git;
+	if (gitInfo) {
+		gitInfo.tags = buildGitTags(gitInfo);
+	}
+
 	if (options.deploymentOptions) {
 		const git = { ...(metadata.deployment.git ?? {}), ...options.deploymentOptions };
 		if (options.deploymentOptions.pullRequestNumber) {
@@ -489,144 +496,6 @@ export async function generateMetadata(options: MetadataGeneratorOptions): Promi
 	return metadata;
 }
 
-/**
- * Get git information (branch, repo, provider, tags)
- */
-async function getGitInfo(
-	rootDir: string,
-	logger: Logger
-): Promise<
-	| {
-			branch?: string;
-			repo?: string;
-			provider?: string;
-			tags?: string[];
-			commit?: string;
-			message?: string;
-	  }
-	| undefined
-> {
-	if (!Bun.which('git')) {
-		logger.trace('git not found in PATH');
-		return undefined;
-	}
-
-	try {
-		// Find .git directory (may be in parent directories for monorepos)
-		let gitDir = join(rootDir, '.git');
-		let parentDir = dirname(dirname(gitDir));
-		while (!existsSync(gitDir) && parentDir !== dirname(parentDir) && gitDir !== '/') {
-			gitDir = join(parentDir, '.git');
-			parentDir = dirname(parentDir);
-		}
-
-		if (!existsSync(gitDir)) {
-			logger.trace('No .git directory found');
-			return undefined;
-		}
-
-		const $ = Bun.$;
-		const gitInfo: {
-			branch?: string;
-			repo?: string;
-			provider?: string;
-			tags?: string[];
-			commit?: string;
-			message?: string;
-		} = {
-			provider: 'git',
-		};
-
-		// Get git tags pointing to HEAD
-		const tagResult = $`git tag -l --points-at HEAD`.nothrow().quiet();
-		if (tagResult) {
-			const tagText = await tagResult.text();
-			if (tagText) {
-				gitInfo.tags = tagText
-					.trim()
-					.split(/\n/)
-					.map((s) => s.trim())
-					.filter(Boolean);
-			}
-		}
-
-		// Get current branch
-		const branchResult = $`git branch --show-current`.nothrow().quiet();
-		if (branchResult) {
-			const branchText = await branchResult.text();
-			if (branchText) {
-				gitInfo.branch = branchText.trim();
-			}
-		}
-
-		// Get commit SHA
-		const commitResult = $`git rev-parse HEAD`.nothrow().quiet();
-		if (commitResult) {
-			const commitText = await commitResult.text();
-			if (commitText) {
-				gitInfo.commit = commitText.trim();
-
-				// Get commit message
-				const msgResult = $`git log --pretty=format:%s -n1 ${gitInfo.commit}`.nothrow().quiet();
-				if (msgResult) {
-					const msgText = await msgResult.text();
-					if (msgText) {
-						gitInfo.message = msgText.trim();
-					}
-				}
-			}
-		}
-
-		// Get remote origin URL and parse
-		const originResult = $`git config --get remote.origin.url`.nothrow().quiet();
-		if (originResult) {
-			const originText = await originResult.text();
-			if (originText) {
-				const remoteUrl = originText.trim();
-
-				// Parse provider and repo from URL
-				if (remoteUrl.includes('github.com')) {
-					gitInfo.provider = 'github';
-					const match = remoteUrl.match(/github\.com[:/](.+?)(?:\.git)?$/);
-					if (match) {
-						gitInfo.repo = `https://github.com/${match[1]}`;
-					}
-				} else if (remoteUrl.includes('gitlab.com')) {
-					gitInfo.provider = 'gitlab';
-					const match = remoteUrl.match(/gitlab\.com[:/](.+?)(?:\.git)?$/);
-					if (match) {
-						gitInfo.repo = `https://gitlab.com/${match[1]}`;
-					}
-				} else if (remoteUrl.includes('bitbucket.org')) {
-					gitInfo.provider = 'bitbucket';
-					const match = remoteUrl.match(/bitbucket\.org[:/](.+?)(?:\.git)?$/);
-					if (match) {
-						gitInfo.repo = `https://bitbucket.org/${match[1]}`;
-					}
-				} else {
-					gitInfo.repo = remoteUrl;
-				}
-			}
-		}
-
-		// Build tags array with defaults
-		const tags = new Set(gitInfo.tags ?? []);
-		tags.add('latest');
-		if (gitInfo.branch) {
-			tags.add(gitInfo.branch);
-		}
-		if (gitInfo.commit) {
-			tags.add(gitInfo.commit.substring(0, 7));
-		}
-		gitInfo.tags = Array.from(tags);
-
-		return gitInfo;
-	} catch (error) {
-		logger.trace(`Failed to get git info: ${error}`);
-		return undefined;
-	}
-}
-
 /**
  * Generate AGENTS.md content for AI coding agents
  */

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

@@ -13,9 +13,10 @@ import {
 	snapshotUpload,
 	SnapshotBuildFileSchema,
 } from '@agentuity/server';
-import type { SnapshotFileInfo } from '@agentuity/server';
+import type { SnapshotFileInfo, SnapshotBuildGitInfo } from '@agentuity/server';
 import { getCatalystAPIClient } from '../../../../config';
 import { validateAptDependencies } from '../../../../utils/apt-validator';
+import { getGitInfo, mergeGitInfo } from '../../../../utils/git';
 import { encryptFIPSKEMDEMStream } from '../../../../crypto/box';
 import { tmpdir } from 'node:os';
 import { randomUUID, createHash, createPublicKey } from 'node:crypto';
@@ -270,6 +271,7 @@ async function generateContentHash(params: {
 	files: SnapshotFileInfo[];
 	fileHashes: Map<string, string>;
 	env?: Record<string, string>;
+	isPublic?: boolean;
 }): Promise<string> {
 	const hash = createHash('sha256');
 
@@ -300,6 +302,8 @@ async function generateContentHash(params: {
 		}
 	}
 
+	hash.update(`access:${params.isPublic ? 'public' : 'private'}\n`);
+
 	return hash.digest('hex');
 }
 
@@ -348,12 +352,25 @@ export const buildSubcommand = createCommand({
 			name: z.string().optional().describe('Snapshot name (overrides build file)'),
 			tag: z.string().optional().describe('Snapshot tag (defaults to "latest")'),
 			description: z.string().optional().describe('Snapshot description (overrides build file)'),
+			message: z.string().optional().describe('Build message for this snapshot'),
+			commit: z.string().optional().describe('Git commit SHA (auto-detected if not provided)'),
+			branch: z.string().optional().describe('Git branch (auto-detected if not provided)'),
+			repo: z.string().optional().describe('Git repo URL (auto-detected if not provided)'),
+			provider: z
+				.string()
+				.optional()
+				.describe('Git provider (github, gitlab, bitbucket - auto-detected)'),
+			commitUrl: z.string().optional().describe('URL to the commit'),
 			metadata: z.array(z.string()).optional().describe('Metadata key-value pairs (KEY=VALUE)'),
 			force: z.boolean().optional().describe('Force rebuild even if content is unchanged'),
 			public: z
 				.boolean()
 				.optional()
 				.describe('Make snapshot public (enables virus scanning, no encryption)'),
+			confirm: z
+				.boolean()
+				.optional()
+				.describe('Confirm public snapshot publishing (required for --public)'),
 		}),
 		response: SnapshotBuildResponseSchema,
 	},
@@ -362,6 +379,37 @@ export const buildSubcommand = createCommand({
 		const { args, opts, options, auth, region, config, logger, orgId } = ctx;
 
 		const dryRun = options.dryRun === true;
+		const isPublic = opts.public === true;
+
+		if (isPublic && !dryRun) {
+			if (!opts.confirm) {
+				if (!tui.isTTYLike()) {
+					logger.fatal(
+						`Publishing a public snapshot requires confirmation.\n\n` +
+							`Public snapshots make all environment variables and files publicly accessible.\n\n` +
+							`To proceed, add the --confirm flag:\n` +
+							`  ${getCommand('cloud sandbox snapshot build . --public --confirm')}\n\n` +
+							`To preview what will be published, use --dry-run first:\n` +
+							`  ${getCommand('cloud sandbox snapshot build . --public --dry-run')}`
+					);
+				}
+
+				tui.warningBox(
+					'Public Snapshot',
+					`You are publishing a public snapshot.\n\n` +
+						`This will make all environment variables and\n` +
+						`files in the snapshot publicly accessible.\n\n` +
+						`Run with --dry-run to preview the contents.`
+				);
+				console.log('');
+
+				const confirmed = await tui.confirm('Proceed with public snapshot?', false);
+
+				if (!confirmed) {
+					logger.fatal('Aborted');
+				}
+			}
+		}
 
 		const directory = resolve(args.directory);
 		if (!existsSync(directory)) {
@@ -532,6 +580,7 @@ export const buildSubcommand = createCommand({
 			files: fileList,
 			fileHashes,
 			env: finalEnv,
+			isPublic,
 		});
 
 		if (dryRun) {
@@ -545,11 +594,12 @@ export const buildSubcommand = createCommand({
 							Description: finalDescription ?? '-',
 							Runtime: buildConfig.runtime,
 							Tag: opts.tag ?? 'latest',
+							Access: isPublic ? 'public' : 'private',
 							Size: tui.formatBytes(totalSize),
 							Files: fileList.length.toFixed(),
 						},
 					],
-					['Name', 'Description', 'Runtime', 'Tag', 'Size', 'Files'],
+					['Name', 'Description', 'Runtime', 'Tag', 'Access', 'Size', 'Files'],
 					{ layout: 'vertical', padStart: '  ' }
 				);
 
@@ -618,7 +668,33 @@ export const buildSubcommand = createCommand({
 
 			const client = getCatalystAPIClient(logger, auth, region);
 
-			const isPublic = opts.public === true;
+			// Auto-detect git info and merge with CLI overrides
+			const autoDetectedGit = await getGitInfo(directory, logger);
+			const mergedGitInfo = mergeGitInfo(autoDetectedGit, {
+				message: opts.message,
+				commit: opts.commit,
+				branch: opts.branch,
+				repo: opts.repo,
+				provider: opts.provider,
+				commitUrl: opts.commitUrl,
+			});
+
+			// Build git info for API (only include if we have any git data)
+			const hasGitInfo =
+				mergedGitInfo.branch ||
+				mergedGitInfo.commit ||
+				mergedGitInfo.repo ||
+				mergedGitInfo.provider ||
+				mergedGitInfo.commitUrl;
+			const gitInfo: SnapshotBuildGitInfo | undefined = hasGitInfo
+				? {
+						branch: mergedGitInfo.branch,
+						commit: mergedGitInfo.commit,
+						repo: mergedGitInfo.repo,
+						provider: mergedGitInfo.provider,
+						commitUrl: mergedGitInfo.commitUrl,
+					}
+				: undefined;
 
 			const initResult = await tui.spinner({
 				message: 'Initializing snapshot build...',
@@ -627,8 +703,10 @@ export const buildSubcommand = createCommand({
 					return await snapshotBuildInit(client, {
 						runtime: buildConfig.runtime,
 						name: finalName,
-						tag: opts.tag,
+						tag: opts.tag ?? 'latest',
 						description: finalDescription,
+						message: mergedGitInfo.message,
+						git: gitInfo,
 						contentHash,
 						force: opts.force,
 						encrypt: !isPublic,
@@ -755,7 +833,7 @@ export const buildSubcommand = createCommand({
 									{
 										snapshotId: '',
 										name: finalName ?? '',
-										tag: opts.tag,
+										tag: opts.tag ?? 'latest',
 										runtime: buildConfig.runtime,
 										sizeBytes: totalSize,
 										fileCount: fileList.length,

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

@@ -27,6 +27,7 @@ const SnapshotGetResponseSchema = z.object({
 	name: z.string().describe('Snapshot name'),
 	fullName: z.string().optional().describe('Full name with org slug (@slug/name:tag)'),
 	tag: z.string().nullable().optional().describe('Snapshot tag'),
+	message: z.string().nullable().optional().describe('Build message'),
 	sizeBytes: z.number().describe('Snapshot size in bytes'),
 	fileCount: z.number().describe('Number of files'),
 	parentSnapshotId: z.string().nullable().optional().describe('Parent snapshot ID'),
@@ -92,6 +93,9 @@ export const getSubcommand = createCommand({
 			if (snapshot.tag) {
 				tableData['Tag'] = snapshot.tag;
 			}
+			if (snapshot.message) {
+				tableData['Message'] = snapshot.message;
+			}
 			tableData['Size'] = tui.formatBytes(snapshot.sizeBytes);
 			tableData['Files'] = snapshot.fileCount;
 			if (snapshot.public) {

package/src/tui/box.ts

@@ -250,3 +250,55 @@ export function errorBox(title: string, message: string): void {
 
 	console.log(lines.join('\n'));
 }
+
+/**
+ * Draw a warning box with yellow border
+ */
+export function warningBox(title: string, message: string): void {
+	const termWidth = getTerminalWidth();
+	const maxWidth = termWidth - 3;
+	const boxWidth = Math.min(60, maxWidth);
+	const innerWidth = Math.max(boxWidth - 2, 1);
+	const contentWidth = Math.max(innerWidth - 1, 0);
+	const padding = 2;
+
+	const lines: string[] = [];
+
+	// Title line with warning symbol
+	const warnSymbol = colors.warning(symbols.warning);
+	const titleText = colors.warning(title);
+	const titleTextWidth = stringWidth(symbols.warning) + stringWidth(title);
+	const barsNeeded = Math.max(innerWidth - titleTextWidth - 3, 1);
+	const titleLine = `${warnSymbol}  ${titleText} ${colors.warning(symbols.barH.repeat(barsNeeded) + symbols.cornerTR)}`;
+
+	lines.push(colors.warning(symbols.bar));
+	lines.push(titleLine);
+
+	// Empty line
+	const emptyLine = `${colors.warning(symbols.bar)}${' '.repeat(contentWidth)}${colors.warning(symbols.bar)}`;
+	lines.push(emptyLine);
+
+	// Wrap and render content lines
+	const wrapWidth = Math.max(contentWidth - padding * 2, 0);
+	const contentLines = message.split('\n');
+	for (const line of contentLines) {
+		const wrapped = stringWidth(line) > wrapWidth ? wrapText(line, wrapWidth) : [line];
+		for (const wl of wrapped) {
+			const lineLen = stringWidth(wl);
+			const leftPad = padding;
+			const rightPad = Math.max(contentWidth - lineLen - leftPad, 0);
+			lines.push(
+				`${colors.warning(symbols.bar)}${' '.repeat(leftPad)}${wl}${' '.repeat(rightPad)}${colors.warning(symbols.bar)}`
+			);
+		}
+	}
+
+	lines.push(emptyLine);
+
+	// Bottom border
+	lines.push(
+		colors.warning(symbols.connect + symbols.barH.repeat(innerWidth - 1) + symbols.cornerBR)
+	);
+
+	console.log(lines.join('\n'));
+}