@agentuity/server 1.0.31 → 1.0.33

package/src/api/sandbox/get.ts

@@ -1,249 +0,0 @@
-import type {
-	SandboxInfo,
-	SandboxRuntimeInfo,
-	SandboxSnapshotInfo,
-	SandboxStatus,
-} from '@agentuity/core';
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import { API_VERSION, throwSandboxError } from './util.ts';
-
-export 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');
-
-export const SandboxUserInfoSchema = 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"),
-	})
-	.describe('User who created the sandbox');
-
-export const SandboxAgentInfoSchema = z
-	.object({
-		id: z.string().describe('Agent ID'),
-		name: z.string().describe('Agent name'),
-	})
-	.describe('Agent associated with the sandbox');
-
-export const SandboxProjectInfoSchema = z
-	.object({
-		id: z.string().describe('Project ID'),
-		name: z.string().describe('Project name'),
-	})
-	.describe('Project associated with the sandbox');
-
-export const SandboxOrgInfoSchema = z
-	.object({
-		id: z.string().describe('Organization ID'),
-		name: z.string().describe('Organization name'),
-	})
-	.describe('Organization associated with the sandbox');
-
-export const SandboxRuntimeInfoSchema = z
-	.object({
-		id: z.string().describe('Runtime ID'),
-		name: z.string().describe('Runtime name (e.g., "bun:1")'),
-		iconUrl: z.string().optional().describe('URL for runtime icon'),
-		brandColor: z.string().optional().describe('Brand color for the runtime (hex color code)'),
-		tags: z.array(z.string()).optional().describe('Optional tags for categorization'),
-	})
-	.describe('Runtime information');
-
-export 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"),
-	})
-	.describe('Snapshot user information');
-
-export const SandboxSnapshotOrgInfoSchema = z
-	.object({
-		id: z.string().describe('Organization ID'),
-		name: z.string().describe('Organization name'),
-		slug: z.string().optional().describe('Organization slug'),
-	})
-	.describe('Snapshot organization information');
-
-export const SandboxSnapshotInfoSchema = z
-	.union([
-		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 (@slug/name:tag)'),
-				public: z.literal(true).describe('Public snapshot'),
-				org: SandboxSnapshotOrgInfoSchema.describe(
-					'Organization that owns the public snapshot'
-				),
-			})
-			.describe('Public snapshot'),
-		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 (@slug/name:tag)'),
-				public: z.literal(false).describe('Private snapshot'),
-				user: SandboxSnapshotUserInfoSchema.describe('User who created the private snapshot'),
-			})
-			.describe('Private snapshot'),
-	])
-	.describe('Snapshot information (discriminated union)');
-
-export const SandboxInfoDataSchema = z
-	.object({
-		sandboxId: z.string().describe('Unique identifier for the sandbox'),
-		identifier: z.string().optional().describe('Short identifier for DNS hostname'),
-		name: z.string().optional().describe('Sandbox name'),
-		description: z.string().optional().describe('Sandbox description'),
-		status: z
-			.enum([
-				'creating',
-				'idle',
-				'running',
-				'paused',
-				'stopping',
-				'suspended',
-				'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'),
-		runtime: SandboxRuntimeInfoSchema.optional().describe('Runtime information'),
-		snapshot: SandboxSnapshotInfoSchema.optional().describe('Snapshot information'),
-		executions: z.number().describe('Total number of executions in this sandbox'),
-		exitCode: z
-			.number()
-			.optional()
-			.describe('Exit code from the last execution (only for terminated/failed sandboxes)'),
-		stdoutStreamUrl: z.string().optional().describe('URL for streaming stdout output'),
-		stderrStreamUrl: z.string().optional().describe('URL for streaming stderr output'),
-		auditStreamId: z.string().optional().describe('ID of the audit event stream'),
-		auditStreamUrl: z.string().optional().describe('URL for streaming audit events'),
-		dependencies: z
-			.array(z.string())
-			.optional()
-			.describe('Apt packages installed in the sandbox'),
-		packages: z
-			.array(z.string())
-			.optional()
-			.describe('npm/bun packages installed globally 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'),
-		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'),
-		networkPort: z.number().optional().describe('Network port exposed from the sandbox'),
-		url: z
-			.string()
-			.optional()
-			.describe('Public URL for the sandbox (only set if networkPort is configured)'),
-		user: SandboxUserInfoSchema.optional().describe('User who created the sandbox'),
-		agent: SandboxAgentInfoSchema.optional().describe('Agent associated with the sandbox'),
-		project: SandboxProjectInfoSchema.optional().describe('Project associated with the sandbox'),
-		org: SandboxOrgInfoSchema.describe('Organization associated with the sandbox'),
-		timeout: z
-			.object({
-				idle: z.string().optional(),
-				execution: z.string().optional(),
-			})
-			.optional(),
-		command: z
-			.object({
-				exec: z.array(z.string()),
-				mode: z.enum(['oneshot', 'interactive']).optional(),
-			})
-			.optional(),
-	})
-	.describe('Detailed information about a sandbox');
-
-export const SandboxGetResponseSchema = APIResponseSchema(SandboxInfoDataSchema);
-
-export interface SandboxGetParams {
-	sandboxId: string;
-	orgId?: string;
-	includeDeleted?: boolean;
-}
-
-/**
- * Retrieves information about a specific sandbox.
- *
- * @param client - The API client to use for the request
- * @param params - Parameters including the sandbox ID
- * @returns Sandbox information including status, creation time, and execution count
- * @throws {SandboxResponseError} If the sandbox is not found or request fails
- */
-export async function sandboxGet(
-	client: APIClient,
-	params: SandboxGetParams
-): Promise<SandboxInfo> {
-	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}` : ''}`;
-
-	const resp = await client.get<z.infer<typeof SandboxGetResponseSchema>>(
-		url,
-		SandboxGetResponseSchema
-	);
-
-	if (resp.success) {
-		return {
-			sandboxId: resp.data.sandboxId,
-			identifier: resp.data.identifier,
-			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,
-			runtime: resp.data.runtime as SandboxRuntimeInfo | undefined,
-			snapshot: resp.data.snapshot as SandboxSnapshotInfo | undefined,
-			executions: resp.data.executions,
-			exitCode: resp.data.exitCode,
-			stdoutStreamUrl: resp.data.stdoutStreamUrl,
-			stderrStreamUrl: resp.data.stderrStreamUrl,
-			auditStreamId: resp.data.auditStreamId,
-			auditStreamUrl: resp.data.auditStreamUrl,
-			dependencies: resp.data.dependencies,
-			packages: resp.data.packages,
-			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,
-			networkPort: resp.data.networkPort,
-			url: resp.data.url,
-			user: resp.data.user,
-			agent: resp.data.agent,
-			project: resp.data.project,
-			org: resp.data.org,
-			timeout: resp.data.timeout,
-			command: resp.data.command,
-		};
-	}
-
-	throwSandboxError(resp, { sandboxId });
-}

package/src/api/sandbox/getStatus.ts

@@ -1,54 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import { API_VERSION, throwSandboxError } from './util.ts';
-
-const SandboxStatusDataSchema = z.object({
-	sandboxId: z.string(),
-	status: z.string(),
-	exitCode: z.number().optional(),
-});
-
-const SandboxStatusResponseSchema = APIResponseSchema(SandboxStatusDataSchema);
-
-export interface SandboxGetStatusParams {
-	sandboxId: string;
-	orgId?: string;
-}
-
-export interface SandboxStatusResult {
-	sandboxId: string;
-	status: string;
-	exitCode?: number;
-}
-
-/**
- * Retrieves lightweight sandbox status (status + exitCode only).
- * Optimized for the sandbox run flow — backed by Redis for ~1ms response time.
- */
-export async function sandboxGetStatus(
-	client: APIClient,
-	params: SandboxGetStatusParams
-): Promise<SandboxStatusResult> {
-	const { sandboxId, orgId } = params;
-	const queryParams = new URLSearchParams();
-	if (orgId) {
-		queryParams.set('orgId', orgId);
-	}
-	const queryString = queryParams.toString();
-	const url = `/sandbox/${API_VERSION}/status/${sandboxId}${queryString ? `?${queryString}` : ''}`;
-
-	const resp = await client.get<z.infer<typeof SandboxStatusResponseSchema>>(
-		url,
-		SandboxStatusResponseSchema
-	);
-
-	if (resp.success) {
-		return {
-			sandboxId: resp.data.sandboxId,
-			status: resp.data.status,
-			exitCode: resp.data.exitCode,
-		};
-	}
-
-	throwSandboxError(resp, { sandboxId });
-}

package/src/api/sandbox/index.ts

@@ -1,211 +0,0 @@
-export type { CLISandboxInfo, CLISandboxListData, CLISandboxListOptions } from './cli-list.ts';
-export { cliSandboxList, SandboxListDataSchema, SandboxListResponseSchema } from './cli-list.ts';
-export type {
-	ExecuteOptions,
-	SandboxClientOptions,
-	SandboxClientRunIO,
-	SandboxInstance,
-} from './client.ts';
-export { SandboxClient } from './client.ts';
-export type { SandboxCreateParams, SandboxCreateResponse } from './create.ts';
-export {
-	SandboxCreateDataSchema,
-	SandboxCreateRequestSchema,
-	SandboxCreateResponseSchema,
-	sandboxCreate,
-} from './create.ts';
-export type { SandboxDestroyParams } from './destroy.ts';
-export { DestroyResponseSchema, sandboxDestroy } from './destroy.ts';
-export type {
-	DiskCheckpointInfo,
-	DiskCheckpointCreateParams,
-	DiskCheckpointListParams,
-	DiskCheckpointRestoreParams,
-	DiskCheckpointDeleteParams,
-} from './disk-checkpoint.ts';
-export {
-	DiskCheckpointInfoSchema,
-	CreateDiskCheckpointResponseSchema,
-	ListDiskCheckpointsResponseSchema,
-	RestoreDiskCheckpointResponseSchema,
-	DeleteDiskCheckpointResponseSchema,
-	diskCheckpointCreate,
-	diskCheckpointList,
-	diskCheckpointRestore,
-	diskCheckpointDelete,
-} from './disk-checkpoint.ts';
-export type { SandboxPauseParams } from './pause.ts';
-export { PauseResponseSchema, sandboxPause } from './pause.ts';
-export type { SandboxResumeParams } from './resume.ts';
-export { ResumeResponseSchema, sandboxResume } from './resume.ts';
-export type { SandboxExecuteParams } from './execute.ts';
-export {
-	ExecuteDataSchema,
-	ExecuteRequestSchema,
-	ExecuteResponseSchema,
-	sandboxExecute,
-} from './execute.ts';
-export type {
-	ExecutionGetParams,
-	ExecutionInfo,
-	ExecutionListParams,
-	ExecutionListResponse,
-} from './execution.ts';
-export {
-	ExecutionGetResponseSchema,
-	ExecutionInfoSchema,
-	ExecutionListDataSchema,
-	ExecutionListResponseSchema,
-	executionGet,
-	executionList,
-} from './execution.ts';
-export type {
-	ArchiveFormat,
-	DownloadArchiveParams,
-	FileInfo,
-	ListFilesParams,
-	ListFilesResult,
-	MkDirParams,
-	ReadFileParams,
-	RmDirParams,
-	RmFileParams,
-	SetEnvParams,
-	SetEnvResult,
-	UploadArchiveParams,
-	WriteFilesParams,
-	WriteFilesResult,
-} from './files.ts';
-export {
-	FileInfoSchema,
-	FileToWriteSchema,
-	ListFilesDataSchema,
-	ListFilesResponseSchema,
-	MkDirRequestSchema,
-	MkDirResponseSchema,
-	RmDirRequestSchema,
-	RmDirResponseSchema,
-	RmFileRequestSchema,
-	RmFileResponseSchema,
-	SetEnvDataSchema,
-	SetEnvRequestSchema,
-	SetEnvResponseSchema,
-	sandboxDownloadArchive,
-	sandboxListFiles,
-	sandboxMkDir,
-	sandboxReadFile,
-	sandboxRmDir,
-	sandboxRmFile,
-	sandboxSetEnv,
-	sandboxUploadArchive,
-	sandboxWriteFiles,
-	UploadArchiveResponseSchema,
-	WriteFilesDataSchema,
-	WriteFilesRequestSchema,
-	WriteFilesResponseSchema,
-} from './files.ts';
-export type { SandboxGetParams } from './get.ts';
-export {
-	SandboxAgentInfoSchema,
-	SandboxGetResponseSchema,
-	SandboxInfoDataSchema,
-	SandboxProjectInfoSchema,
-	SandboxResourcesSchema,
-	SandboxUserInfoSchema,
-	sandboxGet,
-} from './get.ts';
-export type { SandboxGetStatusParams, SandboxStatusResult } from './getStatus.ts';
-export { sandboxGetStatus } from './getStatus.ts';
-export type { SandboxListParams } from './list.ts';
-export {
-	ListSandboxesDataSchema,
-	ListSandboxesResponseSchema,
-	SandboxInfoSchema,
-	SandboxOrgInfoSchema,
-	SandboxRuntimeInfoSchema,
-	SandboxSnapshotInfoSchema,
-	SandboxSnapshotOrgInfoSchema,
-	SandboxSnapshotUserInfoSchema,
-	sandboxList,
-} from './list.ts';
-export type { ResolvedSandboxInfo } from './resolve.ts';
-export {
-	SandboxResolveDataSchema,
-	SandboxResolveError,
-	SandboxResolveResponseSchema,
-	sandboxResolve,
-} from './resolve.ts';
-export type { SandboxRunParams } from './run.ts';
-export { sandboxRun } from './run.ts';
-export type { RuntimeListParams } from './runtime.ts';
-export {
-	ListRuntimesDataSchema,
-	ListRuntimesResponseSchema,
-	RuntimeInfoSchema,
-	RuntimeRequirementsSchema,
-	runtimeList,
-} from './runtime.ts';
-export type {
-	SnapshotBuildFinalizeParams,
-	SnapshotBuildGitInfo,
-	SnapshotBuildInitParams,
-	SnapshotBuildInitResponse,
-	SnapshotCreateParams,
-	SnapshotDeleteParams,
-	SnapshotFileInfo,
-	SnapshotGetParams,
-	SnapshotInfo,
-	SnapshotLineageEntry,
-	SnapshotLineageParams,
-	SnapshotLineageResponse,
-	SnapshotListParams,
-	SnapshotListResponse,
-	SnapshotPublicGetParams,
-	SnapshotPublicListParams,
-	SnapshotTagParams,
-	SnapshotUploadParams,
-	SnapshotUploadResponse,
-} from './snapshot.ts';
-export {
-	SnapshotBuildGitInfoSchema,
-	SnapshotBuildInitAPIResponseSchema,
-	SnapshotBuildInitResponseSchema,
-	SnapshotCreateResponseSchema,
-	SnapshotDeleteResponseSchema,
-	SnapshotFileInfoSchema,
-	SnapshotGetResponseSchema,
-	SnapshotInfoSchema,
-	SnapshotLineageDataSchema,
-	SnapshotLineageEntrySchema,
-	SnapshotLineageResponseSchema,
-	SnapshotListDataSchema,
-	SnapshotListResponseSchema,
-	SnapshotOrgInfoSchema,
-	SnapshotUploadResponseSchema,
-	SnapshotUserInfoSchema,
-	snapshotBuildFinalize,
-	snapshotBuildInit,
-	snapshotCreate,
-	snapshotDelete,
-	snapshotGet,
-	snapshotLineage,
-	snapshotList,
-	snapshotPublicGet,
-	snapshotPublicList,
-	snapshotTag,
-	snapshotUpload,
-} from './snapshot.ts';
-export type { SnapshotBuildFile } from './snapshot-build.ts';
-export { SnapshotBuildFileSchema, NPM_PACKAGE_NAME_PATTERN } from './snapshot-build.ts';
-export type { SandboxErrorCode, SandboxErrorContext } from './util.ts';
-export {
-	ExecutionCancelledError,
-	ExecutionNotFoundError,
-	ExecutionTimeoutError,
-	SandboxBusyError,
-	SandboxNotFoundError,
-	SandboxResponseError,
-	SandboxTerminatedError,
-	SnapshotNotFoundError,
-	throwSandboxError,
-	writeAndDrain,
-} from './util.ts';