@agentuity/cli 0.1.19 → 0.1.21

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

@@ -6,6 +6,45 @@ import { sandboxList } from '@agentuity/server';
 import { getGlobalCatalystAPIClient } from '../../../config';
 import type { SandboxStatus } from '@agentuity/core';
 
+const SandboxRuntimeInfoSchema = z.object({
+	id: z.string().describe('Runtime ID'),
+	name: z.string().describe('Runtime name'),
+	iconUrl: z.string().optional().describe('URL for runtime icon'),
+	brandColor: z.string().optional().describe('Brand color for the runtime'),
+	tags: z.array(z.string()).optional().describe('Runtime tags'),
+});
+
+const SandboxSnapshotUserInfoSchema = z.object({
+	id: z.string().describe('User ID'),
+	firstName: z.string().optional().describe("User's first name"),
+	lastName: z.string().optional().describe("User's last name"),
+});
+
+const SandboxSnapshotOrgInfoSchema = z.object({
+	id: z.string().describe('Organization ID'),
+	name: z.string().describe('Organization name'),
+	slug: z.string().optional().describe('Organization slug'),
+});
+
+const SandboxSnapshotInfoSchema = z.discriminatedUnion('public', [
+	z.object({
+		id: z.string().describe('Snapshot ID'),
+		name: z.string().optional().describe('Snapshot name'),
+		tag: z.string().nullable().optional().describe('Snapshot tag'),
+		fullName: z.string().optional().describe('Full name with org slug'),
+		public: z.literal(true).describe('Public snapshot'),
+		org: SandboxSnapshotOrgInfoSchema.describe('Organization that owns the public snapshot'),
+	}),
+	z.object({
+		id: z.string().describe('Snapshot ID'),
+		name: z.string().optional().describe('Snapshot name'),
+		tag: z.string().nullable().optional().describe('Snapshot tag'),
+		fullName: z.string().optional().describe('Full name with org slug'),
+		public: z.literal(false).describe('Private snapshot'),
+		user: SandboxSnapshotUserInfoSchema.describe('User who created the private snapshot'),
+	}),
+]);
+
 const SandboxInfoSchema = z.object({
 	sandboxId: z.string().describe('Sandbox ID'),
 	name: z.string().optional().describe('Sandbox name'),
@@ -13,10 +52,8 @@ const SandboxInfoSchema = z.object({
 	status: z.string().describe('Current status'),
 	createdAt: z.string().describe('Creation timestamp'),
 	region: z.string().optional().describe('Region where sandbox is running'),
-	runtimeId: z.string().optional().describe('Runtime ID'),
-	runtimeName: z.string().optional().describe('Runtime name'),
-	snapshotId: z.string().optional().describe('Snapshot ID sandbox was created from'),
-	snapshotTag: z.string().optional().describe('Snapshot tag sandbox was created from'),
+	runtime: SandboxRuntimeInfoSchema.optional().describe('Runtime information'),
+	snapshot: SandboxSnapshotInfoSchema.optional().describe('Snapshot information'),
 	executions: z.number().describe('Number of executions'),
 });
 
@@ -100,7 +137,7 @@ export const listSubcommand = createCommand({
 					return {
 						ID: sandbox.sandboxId,
 						Name: sandbox.name || '-',
-						Runtime: sandbox.runtimeName || '-',
+						Runtime: sandbox.runtime?.name || '-',
 						Status: sandbox.status,
 						'Created At': sandbox.createdAt,
 						Executions: sandbox.executions,
@@ -127,10 +164,8 @@ export const listSubcommand = createCommand({
 				status: s.status,
 				createdAt: s.createdAt,
 				region: s.region,
-				runtimeId: s.runtimeId,
-				runtimeName: s.runtimeName,
-				snapshotId: s.snapshotId,
-				snapshotTag: s.snapshotTag,
+				runtime: s.runtime,
+				snapshot: s.snapshot,
 				executions: s.executions,
 			})),
 			total: result.total,

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

@@ -15,11 +15,29 @@ const SnapshotFileSchema = z.object({
 	mode: z.number(),
 });
 
+const SandboxRuntimeInfoSchema = z.object({
+	id: z.string().describe('Runtime ID'),
+	name: z.string().describe('Runtime name'),
+	iconUrl: z.string().optional().describe('URL for runtime icon'),
+	brandColor: z.string().optional().describe('Brand color for the runtime'),
+	tags: z.array(z.string()).optional().describe('Runtime tags'),
+});
+
+const SandboxSnapshotInfoSchema = z.object({
+	id: z.string().describe('Snapshot ID'),
+	name: z.string().optional().describe('Snapshot name'),
+	tag: z.string().optional().describe('Snapshot tag'),
+	fullName: z.string().optional().describe('Full name with org slug'),
+	public: z.boolean().describe('Whether snapshot is public'),
+});
+
 const SandboxInfoSchema = z.object({
 	sandboxId: z.string().describe('Sandbox ID'),
 	status: z.string().describe('Current status'),
 	createdAt: z.string().describe('Creation timestamp'),
 	executions: z.number().describe('Number of executions'),
+	runtime: SandboxRuntimeInfoSchema.optional().describe('Runtime information'),
+	snapshot: SandboxSnapshotInfoSchema.optional().describe('Snapshot information'),
 });
 
 const SnapshotGetResponseSchema = z.object({

package/src/cmd/cloud/storage/index.ts

@@ -10,7 +10,7 @@ import { getCommand } from '../../../command-prefix';
 export const storageCommand = createCommand({
 	name: 'storage',
 	aliases: ['s3'],
-	description: 'Manage storage resources',
+	description: 'Manage S3 compatible managed storage resources',
 	tags: ['slow', 'requires-auth', 'requires-deployment'],
 	examples: [
 		{ command: getCommand('cloud storage list'), description: 'List all storage resources' },

package/src/cmd/cloud/stream/index.ts

@@ -7,7 +7,7 @@ import { getCommand } from '../../../command-prefix';
 export const streamCommand = createCommand({
 	name: 'stream',
 	aliases: ['streams'],
-	description: 'Manage streams',
+	description: 'Manage durable streams',
 	tags: ['slow', 'requires-auth'],
 	examples: [
 		{ command: getCommand('cloud stream list'), description: 'List all streams' },

package/src/cmd/cloud/vector/delete-namespace.ts

@@ -11,7 +11,8 @@ export const deleteNamespaceSubcommand = createCommand({
 	description: 'Delete a vector namespace and all its vectors',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
 	idempotent: true,
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	examples: [
 		{
 			command: getCommand('vector delete-namespace staging'),

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

@@ -18,7 +18,8 @@ export const deleteSubcommand = createCommand({
 	aliases: ['del', 'rm'],
 	description: 'Delete one or more vectors by key',
 	tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	idempotent: true,
 	examples: [
 		{

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

@@ -16,7 +16,8 @@ export const getSubcommand = createCommand({
 	name: 'get',
 	description: 'Get a specific vector entry by key',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	idempotent: true,
 	examples: [
 		{

package/src/cmd/cloud/vector/index.ts

@@ -34,7 +34,7 @@ export const vectorCommand = createCommand({
 		listNamespacesSubcommand,
 		deleteNamespaceSubcommand,
 	],
-	requires: { auth: true, project: true },
+	requires: { auth: true },
 });
 
 export default vectorCommand;

package/src/cmd/cloud/vector/list-namespaces.ts

@@ -11,7 +11,8 @@ export const listNamespacesSubcommand = createCommand({
 	aliases: ['namespaces', 'ns'],
 	description: 'List all vector namespaces',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	examples: [
 		{ command: getCommand('vector list-namespaces'), description: 'List all namespaces' },
 		{ command: getCommand('vector namespaces'), description: 'List namespaces (using alias)' },

package/src/cmd/cloud/vector/search.ts

@@ -22,7 +22,8 @@ export const searchSubcommand = createCommand({
 	aliases: ['list', 'ls'],
 	description: 'Search for vectors using semantic similarity',
 	tags: ['read-only', 'slow', 'requires-auth'],
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	idempotent: true,
 	examples: [
 		{

package/src/cmd/cloud/vector/stats.ts

@@ -42,7 +42,8 @@ export const statsSubcommand = createCommand({
 	name: 'stats',
 	description: 'Get statistics for vector storage',
 	tags: ['read-only', 'fast', 'requires-auth'],
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	idempotent: true,
 	examples: [
 		{ command: getCommand('vector stats'), description: 'Show stats for all namespaces' },

package/src/cmd/cloud/vector/upsert.ts

@@ -26,7 +26,8 @@ export const upsertSubcommand = createCommand({
 	description: 'Add or update vectors in the vector storage',
 	tags: ['mutating', 'updates-resource', 'slow', 'requires-auth'],
 	idempotent: true,
-	requires: { auth: true, project: true },
+	requires: { auth: true, region: true },
+	optional: { project: true },
 	examples: [
 		{
 			command: getCommand('vector upsert products doc1 --document "Comfortable office chair"'),

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

@@ -1,30 +1,33 @@
-import { Logger, VectorStorageService } from '@agentuity/core';
+import { type Logger, VectorStorageService } from '@agentuity/core';
 import { createServerFetchAdapter, getServiceUrls } from '@agentuity/server';
-import { loadProjectSDKKey } from '../../../config';
-import type { Config } from '../../../types';
+import type { AuthData, GlobalOptions, ProjectConfig } from '../../../types';
 import * as tui from '../../../tui';
 
-export async function createStorageAdapter(ctx: {
+export function createStorageAdapter(ctx: {
 	logger: Logger;
-	projectDir: string;
-	config: Config | null;
-	project: { region: string };
+	auth: AuthData;
+	region: string;
+	project?: ProjectConfig;
+	options: GlobalOptions;
 }) {
-	const sdkKey = await loadProjectSDKKey(ctx.logger, ctx.projectDir);
-	if (!sdkKey) {
-		tui.fatal(`Couldn't find the AGENTUITY_SDK_KEY in ${ctx.projectDir} .env file`);
+	const orgId = ctx.project?.orgId ?? ctx.options.orgId;
+	if (!orgId) {
+		tui.fatal(
+			'Organization ID is required. Either run from a project directory or use --org-id flag.'
+		);
 	}
 
 	const adapter = createServerFetchAdapter(
 		{
 			headers: {
-				Authorization: `Bearer ${sdkKey}`,
+				Authorization: `Bearer ${ctx.auth.apiKey}`,
+				'x-agentuity-orgid': orgId,
 			},
 		},
 		ctx.logger
 	);
 
-	const urls = getServiceUrls(ctx.project.region);
+	const urls = getServiceUrls(ctx.region);
 	const baseUrl = urls.catalyst;
 	return new VectorStorageService(baseUrl, adapter);
 }

package/src/cmd/setup/index.ts

@@ -37,9 +37,14 @@ export const command = createCommand({
 						message: 'Validating your identity',
 						clearOnSuccess: true,
 						callback: async () => {
-							const newargs = process.argv.map((x) => (x === 'setup' ? 'login' : x));
+							// For compiled binaries, process.argv contains virtual paths (/$bunfs/root/...)
+							// Use process.execPath which has the actual binary path
+							const isCompiledBinary = process.argv[1]?.startsWith('/$bunfs/');
+							const cmd = isCompiledBinary
+								? [process.execPath, ...process.argv.slice(2).map((x) => (x === 'setup' ? 'login' : x))]
+								: process.argv.map((x) => (x === 'setup' ? 'login' : x));
 							const r = Bun.spawn({
-								cmd: newargs.concat('--json'),
+								cmd: cmd.concat('--json'),
 								stdout: 'pipe',
 								stderr: 'inherit',
 							});

package/src/config.ts

@@ -733,10 +733,19 @@ export async function loadProjectSDKKey(
 	logger.trace(`[SDK_KEY] AGENTUITY_SDK_KEY not found in any file`);
 }
 
-export function getCatalystAPIClient(logger: Logger, auth: AuthData, region: string) {
+export function getCatalystAPIClient(
+	logger: Logger,
+	auth: AuthData,
+	region: string,
+	orgId?: string
+) {
 	const serviceUrls = getServiceUrls(region);
 	const catalystUrl = serviceUrls.catalyst;
-	return new ServerAPIClient(catalystUrl, logger, auth.apiKey);
+	const headers: Record<string, string> = {};
+	if (orgId) {
+		headers['x-agentuity-orgid'] = orgId;
+	}
+	return new ServerAPIClient(catalystUrl, logger, auth.apiKey, { headers });
 }
 
 interface RegionsCacheData {
@@ -795,14 +804,20 @@ export async function getDefaultRegion(
 /**
  * Get a Catalyst API client for global database operations.
  * Uses the default region since the admin DB is global.
+ *
+ * @param logger - Logger instance
+ * @param auth - Authentication data
+ * @param profileName - Profile name (default: 'production')
+ * @param orgId - Optional organization ID for CLI key authentication
  */
 export async function getGlobalCatalystAPIClient(
 	logger: Logger,
 	auth: AuthData,
-	profileName = 'production'
+	profileName = 'production',
+	orgId?: string
 ) {
 	const region = await getDefaultRegion(profileName);
-	return getCatalystAPIClient(logger, auth, region);
+	return getCatalystAPIClient(logger, auth, region, orgId);
 }
 
 export function getIONHost(config: Config | null, region: string) {

package/src/env-util.ts

@@ -17,7 +17,7 @@ export const PUBLIC_VAR_PREFIXES = ['VITE_', 'AGENTUITY_PUBLIC_', 'PUBLIC_'] as
  * Specific AGENTUITY_ keys that are allowed to be set by users.
  * Note: There is also a whitelist in the API that must be kept in sync.
  */
-export const AGENTUITY_ALLOWED_KEYS = ['AGENTUITY_AUTH_SECRET'] as const;
+export const AGENTUITY_ALLOWED_KEYS = ['AGENTUITY_AUTH_SECRET', 'AGENTUITY_CLOUD_BASE_URL'] as const;
 
 /**
  * Check if a key is a public variable (exposed to frontend)