@agentuity/server 0.0.110 → 0.0.112

package/src/api/sandbox/get.ts

@@ -3,6 +3,14 @@ import { APIClient, APIResponseSchema } from '../api';
 import { SandboxResponseError, API_VERSION } from './util';
 import type { SandboxInfo, SandboxStatus } from '@agentuity/core';
 
+const SandboxResourcesSchema = z
+	.object({
+		memory: z.string().optional().describe('Memory limit (e.g., "512Mi", "1Gi")'),
+		cpu: z.string().optional().describe('CPU limit in millicores (e.g., "500m", "1000m")'),
+		disk: z.string().optional().describe('Disk limit (e.g., "1Gi", "10Gi")'),
+	})
+	.describe('Resource limits for the sandbox');
+
 const SandboxInfoDataSchema = z
 	.object({
 		sandboxId: z.string().describe('Unique identifier for the sandbox'),
@@ -20,6 +28,11 @@ const SandboxInfoDataSchema = z
 			.array(z.string())
 			.optional()
 			.describe('Apt packages installed in the sandbox'),
+		metadata: z
+			.record(z.string(), z.unknown())
+			.optional()
+			.describe('User-defined metadata associated with the sandbox'),
+		resources: SandboxResourcesSchema.optional().describe('Resource limits for this sandbox'),
 	})
 	.describe('Detailed information about a sandbox');
 
@@ -67,6 +80,8 @@ export async function sandboxGet(
 			stdoutStreamUrl: resp.data.stdoutStreamUrl,
 			stderrStreamUrl: resp.data.stderrStreamUrl,
 			dependencies: resp.data.dependencies,
+			metadata: resp.data.metadata as Record<string, unknown> | undefined,
+			resources: resp.data.resources,
 		};
 	}
 

package/src/api/sandbox/index.ts

@@ -20,8 +20,33 @@ export type {
 export { SandboxResponseError, writeAndDrain } from './util';
 export { SandboxClient } from './client';
 export type { SandboxClientOptions, SandboxInstance, ExecuteOptions } from './client';
-export { sandboxWriteFiles, sandboxReadFile } from './files';
-export type { WriteFilesParams, WriteFilesResult, ReadFileParams } from './files';
+export {
+	sandboxWriteFiles,
+	sandboxReadFile,
+	sandboxMkDir,
+	sandboxRmDir,
+	sandboxRmFile,
+	sandboxListFiles,
+	sandboxDownloadArchive,
+	sandboxUploadArchive,
+	sandboxSetEnv,
+} from './files';
+export type {
+	WriteFilesParams,
+	WriteFilesResult,
+	ReadFileParams,
+	MkDirParams,
+	RmDirParams,
+	RmFileParams,
+	ListFilesParams,
+	ListFilesResult,
+	FileInfo,
+	ArchiveFormat,
+	DownloadArchiveParams,
+	UploadArchiveParams,
+	SetEnvParams,
+	SetEnvResult,
+} from './files';
 export { snapshotCreate, snapshotGet, snapshotList, snapshotDelete, snapshotTag } from './snapshot';
 export type {
 	SnapshotInfo,

package/src/api/sandbox/snapshot.ts

@@ -1,8 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema, APIResponseSchemaNoData } from '../api';
-import { SandboxResponseError } from './util';
-
-const SNAPSHOT_API_VERSION = '2025-06-26';
+import { SandboxResponseError, API_VERSION } from './util';
 
 const SnapshotFileInfoSchema = z
 	.object({
@@ -14,7 +12,6 @@ const SnapshotFileInfoSchema = z
 const SnapshotInfoSchema = z
 	.object({
 		snapshotId: z.string().describe('Unique identifier for the snapshot'),
-		sandboxId: z.string().describe('ID of the sandbox this snapshot was created from'),
 		tag: z.string().nullable().optional().describe('User-defined tag for the snapshot'),
 		sizeBytes: z.number().describe('Total size of the snapshot in bytes'),
 		fileCount: z.number().describe('Number of files in the snapshot'),
@@ -47,7 +44,6 @@ export interface SnapshotFileInfo {
 
 export interface SnapshotInfo {
 	snapshotId: string;
-	sandboxId: string;
 	tag?: string | null;
 	sizeBytes: number;
 	fileCount: number;
@@ -116,7 +112,7 @@ export async function snapshotCreate(
 ): Promise<SnapshotInfo> {
 	const { sandboxId, tag, orgId } = params;
 	const queryString = buildQueryString({ orgId });
-	const url = `/sandbox/${SNAPSHOT_API_VERSION}/${sandboxId}/snapshot${queryString}`;
+	const url = `/sandbox/${API_VERSION}/${sandboxId}/snapshot${queryString}`;
 
 	const body: Record<string, string> = {};
 	if (tag) {
@@ -150,7 +146,7 @@ export async function snapshotGet(
 ): Promise<SnapshotInfo> {
 	const { snapshotId, orgId } = params;
 	const queryString = buildQueryString({ orgId });
-	const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots/${snapshotId}${queryString}`;
+	const url = `/sandbox/${API_VERSION}/snapshots/${snapshotId}${queryString}`;
 
 	const resp = await client.get<z.infer<typeof SnapshotGetResponseSchema>>(
 		url,
@@ -178,7 +174,7 @@ export async function snapshotList(
 ): Promise<SnapshotListResponse> {
 	const { sandboxId, limit, offset, orgId } = params;
 	const queryString = buildQueryString({ sandboxId, limit, offset, orgId });
-	const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots${queryString}`;
+	const url = `/sandbox/${API_VERSION}/snapshots${queryString}`;
 
 	const resp = await client.get<z.infer<typeof SnapshotListResponseSchema>>(
 		url,
@@ -205,7 +201,7 @@ export async function snapshotDelete(
 ): Promise<void> {
 	const { snapshotId, orgId } = params;
 	const queryString = buildQueryString({ orgId });
-	const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots/${snapshotId}${queryString}`;
+	const url = `/sandbox/${API_VERSION}/snapshots/${snapshotId}${queryString}`;
 
 	const resp = await client.delete<z.infer<typeof SnapshotDeleteResponseSchema>>(
 		url,
@@ -231,7 +227,7 @@ export async function snapshotTag(
 ): Promise<SnapshotInfo> {
 	const { snapshotId, tag, orgId } = params;
 	const queryString = buildQueryString({ orgId });
-	const url = `/sandbox/${SNAPSHOT_API_VERSION}/snapshots/${snapshotId}${queryString}`;
+	const url = `/sandbox/${API_VERSION}/snapshots/${snapshotId}${queryString}`;
 
 	const resp = await client.patch<z.infer<typeof SnapshotGetResponseSchema>>(
 		url,

package/src/config.ts

@@ -8,17 +8,34 @@ export interface ServiceUrls {
 }
 
 /**
- * Get service URLs from environment variables with fallback defaults
+ * Resolve the region from the provided value or AGENTUITY_REGION environment variable.
+ * Throws an error if no region can be resolved.
+ */
+export function resolveRegion(region?: string): string {
+	const resolved = region ?? process.env.AGENTUITY_REGION;
+	if (!resolved) {
+		throw new Error(
+			'Region is required but not provided. Set the AGENTUITY_REGION environment variable or pass region as a parameter.'
+		);
+	}
+	return resolved;
+}
+
+/**
+ * Get service URLs from environment variables with fallback defaults.
+ * Throws an error if region cannot be resolved (neither passed as parameter nor set via AGENTUITY_REGION).
  */
 export function getServiceUrls(region?: string): ServiceUrls {
-	const transportUrl = process.env.AGENTUITY_TRANSPORT_URL || buildRegionalURL(region, 'catalyst');
+	const resolvedRegion = resolveRegion(region);
+	const transportUrl =
+		process.env.AGENTUITY_TRANSPORT_URL || buildRegionalURL(resolvedRegion, 'catalyst');
 
 	return {
 		keyvalue: process.env.AGENTUITY_KEYVALUE_URL || transportUrl,
-		stream: process.env.AGENTUITY_STREAM_URL || buildRegionalURL(region, 'streams'),
+		stream: process.env.AGENTUITY_STREAM_URL || buildRegionalURL(resolvedRegion, 'streams'),
 		vector: process.env.AGENTUITY_VECTOR_URL || transportUrl,
 		catalyst: process.env.AGENTUITY_CATALYST_URL || transportUrl,
-		otel: process.env.AGENTUITY_OTLP_URL || buildRegionalURL(region, 'otel'),
+		otel: process.env.AGENTUITY_OTLP_URL || buildRegionalURL(resolvedRegion, 'otel'),
 		sandbox: process.env.AGENTUITY_SANDBOX_URL || transportUrl,
 	};
 }

package/src/index.ts

@@ -2,7 +2,7 @@
 export * from './api';
 
 // config.ts exports
-export { type ServiceUrls, getServiceUrls } from './config';
+export { type ServiceUrls, getServiceUrls, resolveRegion } from './config';
 
 // logger.ts exports
 export { type ColorScheme, ConsoleLogger, createLogger } from './logger';

package/src/schema.ts

@@ -13,7 +13,9 @@ export const toJSONSchema = (schema: any): JSONSchema => {
 		return agentuityToJSONSchema(schema);
 	}
 	// Check if it's a Zod schema
-	if (schema?._def?.typeName) {
+	// Zod 3 uses _def.typeName (e.g., "ZodObject")
+	// Zod 4 uses _def.type (e.g., "object")
+	if (schema?._def?.typeName || schema?._def?.type) {
 		try {
 			return z.toJSONSchema(schema) as JSONSchema;
 		} catch {