@agentuity/server 0.1.7 → 0.1.9

package/dist/util/resources.d.ts

@@ -0,0 +1,47 @@
+export interface ResourceValidationSuccess {
+    valid: true;
+    value: number;
+}
+export interface ResourceValidationFailure {
+    valid: false;
+    error: string;
+}
+export type ResourceValidationResult = ResourceValidationSuccess | ResourceValidationFailure;
+/**
+ * Validates and parses a CPU spec string.
+ * Valid formats:
+ * - "500m" (millicores)
+ * - "1" or "2" (cores, converted to millicores)
+ * - "0.5" (fractional cores, converted to millicores)
+ */
+export declare function validateCPUSpec(input: string): ResourceValidationResult;
+/**
+ * Validates and parses a memory/disk spec string.
+ * Valid formats:
+ * - "500Mi", "1Gi", "2Ti" (binary units)
+ * - "500M", "1G", "2T" (decimal units)
+ * - "1.5Gi", "0.5G" (decimal fractions with units)
+ * - "1073741824" (raw bytes)
+ */
+export declare function validateMemorySpec(input: string, fieldName?: 'memory' | 'disk'): ResourceValidationResult;
+export interface ResourcesConfig {
+    cpu?: string;
+    memory?: string;
+    disk?: string;
+}
+export interface ValidatedResources {
+    cpuUnits?: number;
+    memoryUnits?: number;
+    diskUnits?: number;
+}
+/**
+ * Validates all resource specs and returns either validated values or an array of errors.
+ */
+export declare function validateResources(resources: ResourcesConfig): {
+    valid: true;
+    values: ValidatedResources;
+} | {
+    valid: false;
+    errors: string[];
+};
+//# sourceMappingURL=resources.d.ts.map

package/dist/util/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/util/resources.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,GAAG,yBAAyB,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAmCvE;AAmBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,QAAQ,GAAG,MAAiB,GACrC,wBAAwB,CA6D1B;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,eAAe,GACxB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgDlF"}

package/dist/util/resources.js

@@ -0,0 +1,171 @@
+/**
+ * Validates and parses a CPU spec string.
+ * Valid formats:
+ * - "500m" (millicores)
+ * - "1" or "2" (cores, converted to millicores)
+ * - "0.5" (fractional cores, converted to millicores)
+ */
+export function validateCPUSpec(input) {
+    if (!input || typeof input !== 'string') {
+        return { valid: false, error: 'CPU value is required' };
+    }
+    const trimmed = input.trim();
+    // Match millicores format: "500m", "1000m"
+    const milliMatch = trimmed.match(/^([0-9]+)m$/);
+    if (milliMatch) {
+        const value = parseInt(milliMatch[1], 10);
+        if (value <= 0) {
+            return { valid: false, error: `Invalid CPU value "${input}": must be greater than 0` };
+        }
+        return { valid: true, value };
+    }
+    // Match cores format: "1", "2", "0.5"
+    const coreMatch = trimmed.match(/^([0-9]*\.?[0-9]+)$/);
+    if (coreMatch) {
+        const cores = parseFloat(coreMatch[1]);
+        const millicores = Math.round(cores * 1000);
+        if (isNaN(millicores) || millicores <= 0) {
+            return {
+                valid: false,
+                error: `Invalid CPU value "${input}": must be at least 1m (0.001 cores)`,
+            };
+        }
+        return { valid: true, value: millicores };
+    }
+    return {
+        valid: false,
+        error: `Invalid CPU format "${input}". Use millicores (e.g., "500m", "1000m") or cores (e.g., "1", "2", "0.5")`,
+    };
+}
+const memoryMultipliers = {
+    k: 1000,
+    M: 1000 ** 2,
+    G: 1000 ** 3,
+    T: 1000 ** 4,
+    P: 1000 ** 5,
+    E: 1000 ** 6,
+    Ki: 1024,
+    Mi: 1024 ** 2,
+    Gi: 1024 ** 3,
+    Ti: 1024 ** 4,
+    Pi: 1024 ** 5,
+    Ei: 1024 ** 6,
+};
+const validMemoryUnits = Object.keys(memoryMultipliers).join(', ');
+/**
+ * Validates and parses a memory/disk spec string.
+ * Valid formats:
+ * - "500Mi", "1Gi", "2Ti" (binary units)
+ * - "500M", "1G", "2T" (decimal units)
+ * - "1.5Gi", "0.5G" (decimal fractions with units)
+ * - "1073741824" (raw bytes)
+ */
+export function validateMemorySpec(input, fieldName = 'memory') {
+    if (!input || typeof input !== 'string') {
+        return { valid: false, error: `${fieldName} value is required` };
+    }
+    const trimmed = input.trim();
+    // Match unit format: "500Mi", "1Gi", "2G", "1.5Gi", "0.5G"
+    const unitMatch = trimmed.match(/^([0-9]*\.?[0-9]+)([A-Za-z]{1,2})$/);
+    if (unitMatch) {
+        const amount = parseFloat(unitMatch[1]);
+        const unit = unitMatch[2];
+        if (isNaN(amount) || amount <= 0) {
+            return {
+                valid: false,
+                error: `Invalid ${fieldName} value "${input}": must be greater than 0`,
+            };
+        }
+        const multiplier = memoryMultipliers[unit];
+        if (multiplier === undefined) {
+            return {
+                valid: false,
+                error: `Invalid ${fieldName} unit "${unit}" in "${input}". Valid units: ${validMemoryUnits}`,
+            };
+        }
+        const value = Math.round(amount * multiplier);
+        if (!Number.isSafeInteger(value)) {
+            return {
+                valid: false,
+                error: `Invalid ${fieldName} value "${input}": exceeds maximum safe integer (value too large)`,
+            };
+        }
+        return { valid: true, value };
+    }
+    // Match raw bytes: "1073741824"
+    const bytesMatch = trimmed.match(/^([0-9]+)$/);
+    if (bytesMatch) {
+        const value = parseInt(bytesMatch[1], 10);
+        if (value <= 0) {
+            return {
+                valid: false,
+                error: `Invalid ${fieldName} value "${input}": must be greater than 0`,
+            };
+        }
+        if (!Number.isSafeInteger(value)) {
+            return {
+                valid: false,
+                error: `Invalid ${fieldName} value "${input}": exceeds maximum safe integer (value too large)`,
+            };
+        }
+        return { valid: true, value };
+    }
+    return {
+        valid: false,
+        error: `Invalid ${fieldName} format "${input}". Use units (e.g., "500Mi", "1Gi", "1.5Gi") or bytes (e.g., "1073741824")`,
+    };
+}
+/**
+ * Validates all resource specs and returns either validated values or an array of errors.
+ */
+export function validateResources(resources) {
+    const errors = [];
+    const values = {};
+    if (resources.cpu !== undefined && resources.cpu !== null) {
+        const result = validateCPUSpec(resources.cpu);
+        if (result.valid) {
+            if (!Number.isFinite(result.value)) {
+                errors.push(`Invalid CPU value "${resources.cpu}": parsed to non-finite number`);
+            }
+            else {
+                values.cpuUnits = result.value;
+            }
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    if (resources.memory !== undefined && resources.memory !== null) {
+        const result = validateMemorySpec(resources.memory, 'memory');
+        if (result.valid) {
+            if (!Number.isFinite(result.value)) {
+                errors.push(`Invalid memory value "${resources.memory}": parsed to non-finite number`);
+            }
+            else {
+                values.memoryUnits = result.value;
+            }
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    if (resources.disk !== undefined && resources.disk !== null) {
+        const result = validateMemorySpec(resources.disk, 'disk');
+        if (result.valid) {
+            if (!Number.isFinite(result.value)) {
+                errors.push(`Invalid disk value "${resources.disk}": parsed to non-finite number`);
+            }
+            else {
+                values.diskUnits = result.value;
+            }
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return { valid: true, values };
+}
+//# sourceMappingURL=resources.js.map

package/dist/util/resources.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/server",
-	"version": "0.1.7",
+	"version": "0.1.9",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -25,12 +25,12 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.1.7",
-		"@agentuity/schema": "0.1.7",
+		"@agentuity/core": "0.1.9",
+		"@agentuity/schema": "0.1.9",
 		"zod": "^4.3.5"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.1.7",
+		"@agentuity/test-utils": "0.1.9",
 		"@types/bun": "latest",
 		"@types/node": "^22.0.0",
 		"bun-types": "latest",

package/src/api/sandbox/create.ts

@@ -5,6 +5,13 @@ import type { SandboxCreateOptions, SandboxStatus } from '@agentuity/core';
 
 const SandboxCreateRequestSchema = z
 	.object({
+		runtime: z
+			.string()
+			.optional()
+			.describe('Runtime name (e.g., "bun:1", "python:3.14")'),
+		runtimeId: z.string().optional().describe('Runtime ID (e.g., "srt_xxx")'),
+		name: z.string().optional().describe('Optional sandbox name'),
+		description: z.string().optional().describe('Optional sandbox description'),
 		resources: z
 			.object({
 				memory: z.string().optional().describe('Memory limit (e.g., "512Mi", "1Gi")'),
@@ -116,6 +123,18 @@ export async function sandboxCreate(
 	const { options = {}, orgId } = params;
 	const body: z.infer<typeof SandboxCreateRequestSchema> = {};
 
+	if (options.runtime) {
+		body.runtime = options.runtime;
+	}
+	if (options.runtimeId) {
+		body.runtimeId = options.runtimeId;
+	}
+	if (options.name) {
+		body.name = options.name;
+	}
+	if (options.description) {
+		body.description = options.description;
+	}
 	if (options.resources) {
 		body.resources = options.resources;
 	}

package/src/api/sandbox/execution.ts

@@ -7,6 +7,7 @@ const ExecutionInfoSchema = z
 	.object({
 		executionId: z.string().describe('Unique identifier for the execution'),
 		sandboxId: z.string().describe('ID of the sandbox where the execution ran'),
+		type: z.string().optional().describe('Type of execution (e.g., exec, write_files, read_file)'),
 		status: z
 			.enum(['queued', 'running', 'completed', 'failed', 'timeout', 'cancelled'])
 			.describe('Current status of the execution'),
@@ -34,6 +35,7 @@ const ExecutionListResponseSchema = APIResponseSchema(ExecutionListDataSchema);
 export interface ExecutionInfo {
 	executionId: string;
 	sandboxId: string;
+	type?: string;
 	status: ExecutionStatus;
 	command?: string[];
 	exitCode?: number;
@@ -79,6 +81,7 @@ export async function executionGet(
 		return {
 			executionId: resp.data.executionId,
 			sandboxId: resp.data.sandboxId,
+			type: resp.data.type,
 			status: resp.data.status as ExecutionStatus,
 			command: resp.data.command,
 			exitCode: resp.data.exitCode,
@@ -137,6 +140,7 @@ export async function executionList(
 			executions: resp.data.executions.map((exec) => ({
 				executionId: exec.executionId,
 				sandboxId: exec.sandboxId,
+				type: exec.type,
 				status: exec.status as ExecutionStatus,
 				command: exec.command,
 				exitCode: exec.exitCode,

package/src/api/sandbox/get.ts

@@ -14,11 +14,17 @@ const SandboxResourcesSchema = z
 const SandboxInfoDataSchema = z
 	.object({
 		sandboxId: z.string().describe('Unique identifier for the sandbox'),
+		name: z.string().optional().describe('Sandbox name'),
+		description: z.string().optional().describe('Sandbox description'),
 		status: z
-			.enum(['creating', 'idle', 'running', 'terminated', 'failed'])
+			.enum(['creating', 'idle', 'running', 'terminated', 'failed', 'deleted'])
 			.describe('Current status of the sandbox'),
+		mode: z.string().optional().describe('Sandbox mode (interactive or oneshot)'),
 		createdAt: z.string().describe('ISO timestamp when the sandbox was created'),
 		region: z.string().optional().describe('Region where the sandbox is running'),
+		runtimeId: z.string().optional().describe('Runtime ID'),
+		runtimeName: z.string().optional().describe('Runtime name (e.g., "bun:1")'),
+		runtimeIconUrl: z.string().optional().describe('URL for runtime icon'),
 		snapshotId: z.string().optional().describe('Snapshot ID this sandbox was created from'),
 		snapshotTag: z.string().optional().describe('Snapshot tag this sandbox was created from'),
 		executions: z.number().describe('Total number of executions in this sandbox'),
@@ -33,6 +39,10 @@ const SandboxInfoDataSchema = z
 			.optional()
 			.describe('User-defined metadata associated with the sandbox'),
 		resources: SandboxResourcesSchema.optional().describe('Resource limits for this sandbox'),
+		cpuTimeMs: z.number().optional().describe('Total CPU time consumed in milliseconds'),
+		memoryByteSec: z.number().optional().describe('Total memory usage in byte-seconds'),
+		networkEgressBytes: z.number().optional().describe('Total network egress in bytes'),
+		networkEnabled: z.boolean().optional().describe('Whether network access is enabled'),
 	})
 	.describe('Detailed information about a sandbox');
 
@@ -41,6 +51,7 @@ const SandboxGetResponseSchema = APIResponseSchema(SandboxInfoDataSchema);
 export interface SandboxGetParams {
 	sandboxId: string;
 	orgId?: string;
+	includeDeleted?: boolean;
 }
 
 /**
@@ -55,11 +66,14 @@ export async function sandboxGet(
 	client: APIClient,
 	params: SandboxGetParams
 ): Promise<SandboxInfo> {
-	const { sandboxId, orgId } = params;
+	const { sandboxId, orgId, includeDeleted } = params;
 	const queryParams = new URLSearchParams();
 	if (orgId) {
 		queryParams.set('orgId', orgId);
 	}
+	if (includeDeleted) {
+		queryParams.set('includeDeleted', 'true');
+	}
 	const queryString = queryParams.toString();
 	const url = `/sandbox/${API_VERSION}/${sandboxId}${queryString ? `?${queryString}` : ''}`;
 
@@ -71,9 +85,15 @@ export async function sandboxGet(
 	if (resp.success) {
 		return {
 			sandboxId: resp.data.sandboxId,
+			name: resp.data.name,
+			description: resp.data.description,
 			status: resp.data.status as SandboxStatus,
+			mode: resp.data.mode,
 			createdAt: resp.data.createdAt,
 			region: resp.data.region,
+			runtimeId: resp.data.runtimeId,
+			runtimeName: resp.data.runtimeName,
+			runtimeIconUrl: resp.data.runtimeIconUrl,
 			snapshotId: resp.data.snapshotId,
 			snapshotTag: resp.data.snapshotTag,
 			executions: resp.data.executions,
@@ -82,6 +102,10 @@ export async function sandboxGet(
 			dependencies: resp.data.dependencies,
 			metadata: resp.data.metadata as Record<string, unknown> | undefined,
 			resources: resp.data.resources,
+			cpuTimeMs: resp.data.cpuTimeMs,
+			memoryByteSec: resp.data.memoryByteSec,
+			networkEgressBytes: resp.data.networkEgressBytes,
+			networkEnabled: resp.data.networkEnabled,
 		};
 	}
 

package/src/api/sandbox/index.ts

@@ -6,6 +6,8 @@ export { sandboxGet } from './get';
 export type { SandboxGetParams } from './get';
 export { sandboxList } from './list';
 export type { SandboxListParams } from './list';
+export { runtimeList } from './runtime';
+export type { RuntimeListParams } from './runtime';
 export { sandboxDestroy } from './destroy';
 export type { SandboxDestroyParams } from './destroy';
 export { sandboxRun } from './run';

package/src/api/sandbox/list.ts

@@ -6,16 +6,23 @@ import type { ListSandboxesParams, ListSandboxesResponse, SandboxStatus } from '
 const SandboxInfoSchema = z
 	.object({
 		sandboxId: z.string().describe('Unique identifier for the sandbox'),
+		name: z.string().optional().describe('Sandbox name'),
+		description: z.string().optional().describe('Sandbox description'),
 		status: z
-			.enum(['creating', 'idle', 'running', 'terminated', 'failed'])
+			.enum(['creating', 'idle', 'running', 'terminated', 'failed', 'deleted'])
 			.describe('Current status of the sandbox'),
+		mode: z.string().optional().describe('Sandbox mode (interactive or oneshot)'),
 		createdAt: z.string().describe('ISO timestamp when the sandbox was created'),
 		region: z.string().optional().describe('Region where the sandbox is running'),
+		runtimeId: z.string().optional().describe('Runtime ID'),
+		runtimeName: z.string().optional().describe('Runtime name (e.g., "bun:1")'),
+		runtimeIconUrl: z.string().optional().describe('URL for runtime icon'),
 		snapshotId: z.string().optional().describe('Snapshot ID this sandbox was created from'),
 		snapshotTag: z.string().optional().describe('Snapshot tag this sandbox was created from'),
 		executions: z.number().describe('Total number of executions in this sandbox'),
 		stdoutStreamUrl: z.string().optional().describe('URL for streaming stdout output'),
 		stderrStreamUrl: z.string().optional().describe('URL for streaming stderr output'),
+		networkEnabled: z.boolean().optional().describe('Whether network access is enabled'),
 	})
 	.describe('Summary information about a sandbox');
 
@@ -30,6 +37,7 @@ const ListSandboxesResponseSchema = APIResponseSchema(ListSandboxesDataSchema);
 
 export interface SandboxListParams extends ListSandboxesParams {
 	orgId?: string;
+	deletedOnly?: boolean;
 }
 
 /**
@@ -64,6 +72,9 @@ export async function sandboxList(
 	if (params?.offset !== undefined) {
 		queryParams.set('offset', params.offset.toString());
 	}
+	if (params?.deletedOnly) {
+		queryParams.set('deletedOnly', 'true');
+	}
 
 	const queryString = queryParams.toString();
 	const url = `/sandbox/${API_VERSION}${queryString ? `?${queryString}` : ''}`;
@@ -77,14 +88,21 @@ export async function sandboxList(
 		return {
 			sandboxes: resp.data.sandboxes.map((s) => ({
 				sandboxId: s.sandboxId,
+				name: s.name,
+				description: s.description,
 				status: s.status as SandboxStatus,
+				mode: s.mode,
 				createdAt: s.createdAt,
 				region: s.region,
+				runtimeId: s.runtimeId,
+				runtimeName: s.runtimeName,
+				runtimeIconUrl: s.runtimeIconUrl,
 				snapshotId: s.snapshotId,
 				snapshotTag: s.snapshotTag,
 				executions: s.executions,
 				stdoutStreamUrl: s.stdoutStreamUrl,
 				stderrStreamUrl: s.stderrStreamUrl,
+				networkEnabled: s.networkEnabled,
 			})),
 			total: resp.data.total,
 		};

package/src/api/sandbox/runtime.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+import { SandboxResponseError, API_VERSION } from './util';
+import type { ListRuntimesParams, ListRuntimesResponse, SandboxRuntime } from '@agentuity/core';
+
+const RuntimeInfoSchema = z
+	.object({
+		id: z.string().describe('Unique runtime identifier'),
+		name: z.string().describe('Runtime name (e.g., "bun:1", "python:3.14")'),
+		description: z.string().optional().describe('Optional description'),
+		iconUrl: z.string().optional().describe('URL for runtime icon'),
+		url: z.string().optional().describe('URL for runtime documentation or homepage'),
+		tags: z.array(z.string()).optional().describe('Optional tags for categorization'),
+	})
+	.describe('Information about a sandbox runtime');
+
+const ListRuntimesDataSchema = z
+	.object({
+		runtimes: z.array(RuntimeInfoSchema).describe('List of runtime entries'),
+		total: z.number().describe('Total number of runtimes'),
+	})
+	.describe('List of sandbox runtimes');
+
+const ListRuntimesResponseSchema = APIResponseSchema(ListRuntimesDataSchema);
+
+export interface RuntimeListParams extends ListRuntimesParams {
+	orgId?: string;
+}
+
+/**
+ * Lists available sandbox runtimes with optional pagination.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Optional parameters for pagination
+ * @returns List of runtimes with total count
+ * @throws {SandboxResponseError} If the request fails
+ */
+export async function runtimeList(
+	client: APIClient,
+	params?: RuntimeListParams
+): Promise<ListRuntimesResponse> {
+	const queryParams = new URLSearchParams();
+
+	if (params?.orgId) {
+		queryParams.set('orgId', params.orgId);
+	}
+	if (params?.limit !== undefined) {
+		queryParams.set('limit', params.limit.toString());
+	}
+	if (params?.offset !== undefined) {
+		queryParams.set('offset', params.offset.toString());
+	}
+
+	const queryString = queryParams.toString();
+	const url = `/sandbox/${API_VERSION}/runtimes${queryString ? `?${queryString}` : ''}`;
+
+	const resp = await client.get<z.infer<typeof ListRuntimesResponseSchema>>(
+		url,
+		ListRuntimesResponseSchema
+	);
+
+	if (resp.success) {
+		return {
+			runtimes: resp.data.runtimes.map((r): SandboxRuntime => ({
+				id: r.id,
+				name: r.name,
+				description: r.description,
+				iconUrl: r.iconUrl,
+				url: r.url,
+				tags: r.tags,
+			})),
+			total: resp.data.total,
+		};
+	}
+
+	throw new SandboxResponseError({ message: resp.message });
+}

package/src/api/sandbox/snapshot.ts

@@ -12,7 +12,10 @@ const SnapshotFileInfoSchema = z
 const SnapshotInfoSchema = z
 	.object({
 		snapshotId: z.string().describe('Unique identifier for the snapshot'),
-		tag: z.string().nullable().optional().describe('User-defined tag for the snapshot'),
+		runtimeId: z.string().nullable().optional().describe('Runtime ID associated with this snapshot'),
+		name: z.string().describe('Display name for the snapshot (URL-safe: letters, numbers, underscores, dashes)'),
+		description: z.string().nullable().optional().describe('Description of the snapshot'),
+		tag: z.string().nullable().optional().describe('Tag for the snapshot (defaults to "latest")'),
 		sizeBytes: z.number().describe('Total size of the snapshot in bytes'),
 		fileCount: z.number().describe('Number of files in the snapshot'),
 		parentSnapshotId: z
@@ -22,7 +25,7 @@ const SnapshotInfoSchema = z
 			.describe('ID of the parent snapshot (for incremental snapshots)'),
 		createdAt: z.string().describe('ISO timestamp when the snapshot was created'),
 		downloadUrl: z.string().optional().describe('URL to download the snapshot archive'),
-		files: z.array(SnapshotFileInfoSchema).optional().describe('List of files in the snapshot'),
+		files: z.array(SnapshotFileInfoSchema).nullable().optional().describe('List of files in the snapshot'),
 	})
 	.describe('Detailed information about a snapshot');
 
@@ -44,17 +47,22 @@ export interface SnapshotFileInfo {
 
 export interface SnapshotInfo {
 	snapshotId: string;
+	runtimeId?: string | null;
+	name: string;
+	description?: string | null;
 	tag?: string | null;
 	sizeBytes: number;
 	fileCount: number;
 	parentSnapshotId?: string | null;
 	createdAt: string;
 	downloadUrl?: string;
-	files?: SnapshotFileInfo[];
+	files?: SnapshotFileInfo[] | null;
 }
 
 export interface SnapshotCreateParams {
 	sandboxId: string;
+	name?: string;
+	description?: string;
 	tag?: string;
 	orgId?: string;
 }
@@ -110,11 +118,17 @@ export async function snapshotCreate(
 	client: APIClient,
 	params: SnapshotCreateParams
 ): Promise<SnapshotInfo> {
-	const { sandboxId, tag, orgId } = params;
+	const { sandboxId, name, description, tag, orgId } = params;
 	const queryString = buildQueryString({ orgId });
 	const url = `/sandbox/${API_VERSION}/${sandboxId}/snapshot${queryString}`;
 
 	const body: Record<string, string> = {};
+	if (name) {
+		body.name = name;
+	}
+	if (description) {
+		body.description = description;
+	}
 	if (tag) {
 		body.tag = tag;
 	}

package/src/index.ts

@@ -13,6 +13,16 @@ export { createServerFetchAdapter } from './server';
 // schema.ts exports
 export { toJSONSchema } from './schema';
 
+// util/resources.ts exports
+export {
+	validateCPUSpec,
+	validateMemorySpec,
+	validateResources,
+	type ResourceValidationResult,
+	type ResourcesConfig,
+	type ValidatedResources,
+} from './util/resources';
+
 // runtime-bootstrap.ts exports
 export { bootstrapRuntimeEnv, type RuntimeBootstrapOptions } from './runtime-bootstrap';