@agentuity/server 1.0.16 → 1.0.18

package/src/api/sandbox/index.ts

@@ -1,34 +1,38 @@
-export type { CLISandboxInfo, CLISandboxListData, CLISandboxListOptions } from './cli-list';
-export { cliSandboxList, SandboxListDataSchema, SandboxListResponseSchema } from './cli-list';
+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';
-export { SandboxClient } from './client';
-export type { SandboxCreateParams, SandboxCreateResponse } from './create';
+} from './client.ts';
+export { SandboxClient } from './client.ts';
+export type { SandboxCreateParams, SandboxCreateResponse } from './create.ts';
 export {
 	SandboxCreateDataSchema,
 	SandboxCreateRequestSchema,
 	SandboxCreateResponseSchema,
 	sandboxCreate,
-} from './create';
-export type { SandboxDestroyParams } from './destroy';
-export { DestroyResponseSchema, sandboxDestroy } from './destroy';
-export type { SandboxExecuteParams } from './execute';
+} from './create.ts';
+export type { SandboxDestroyParams } from './destroy.ts';
+export { DestroyResponseSchema, sandboxDestroy } from './destroy.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';
+} from './execute.ts';
 export type {
 	ExecutionGetParams,
 	ExecutionInfo,
 	ExecutionListParams,
 	ExecutionListResponse,
-} from './execution';
+} from './execution.ts';
 export {
 	ExecutionGetResponseSchema,
 	ExecutionInfoSchema,
@@ -36,7 +40,7 @@ export {
 	ExecutionListResponseSchema,
 	executionGet,
 	executionList,
-} from './execution';
+} from './execution.ts';
 export type {
 	ArchiveFormat,
 	DownloadArchiveParams,
@@ -52,7 +56,7 @@ export type {
 	UploadArchiveParams,
 	WriteFilesParams,
 	WriteFilesResult,
-} from './files';
+} from './files.ts';
 export {
 	FileInfoSchema,
 	FileToWriteSchema,
@@ -80,8 +84,8 @@ export {
 	WriteFilesDataSchema,
 	WriteFilesRequestSchema,
 	WriteFilesResponseSchema,
-} from './files';
-export type { SandboxGetParams } from './get';
+} from './files.ts';
+export type { SandboxGetParams } from './get.ts';
 export {
 	SandboxAgentInfoSchema,
 	SandboxGetResponseSchema,
@@ -90,8 +94,8 @@ export {
 	SandboxResourcesSchema,
 	SandboxUserInfoSchema,
 	sandboxGet,
-} from './get';
-export type { SandboxListParams } from './list';
+} from './get.ts';
+export type { SandboxListParams } from './list.ts';
 export {
 	ListSandboxesDataSchema,
 	ListSandboxesResponseSchema,
@@ -102,24 +106,24 @@ export {
 	SandboxSnapshotOrgInfoSchema,
 	SandboxSnapshotUserInfoSchema,
 	sandboxList,
-} from './list';
-export type { ResolvedSandboxInfo } from './resolve';
+} from './list.ts';
+export type { ResolvedSandboxInfo } from './resolve.ts';
 export {
 	SandboxResolveDataSchema,
 	SandboxResolveError,
 	SandboxResolveResponseSchema,
 	sandboxResolve,
-} from './resolve';
-export type { SandboxRunParams } from './run';
-export { sandboxRun } from './run';
-export type { RuntimeListParams } from './runtime';
+} 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';
+} from './runtime.ts';
 export type {
 	SnapshotBuildFinalizeParams,
 	SnapshotBuildGitInfo,
@@ -140,7 +144,7 @@ export type {
 	SnapshotTagParams,
 	SnapshotUploadParams,
 	SnapshotUploadResponse,
-} from './snapshot';
+} from './snapshot.ts';
 export {
 	SnapshotBuildGitInfoSchema,
 	SnapshotBuildInitAPIResponseSchema,
@@ -169,10 +173,10 @@ export {
 	snapshotPublicList,
 	snapshotTag,
 	snapshotUpload,
-} from './snapshot';
-export type { SnapshotBuildFile } from './snapshot-build';
-export { SnapshotBuildFileSchema, NPM_PACKAGE_NAME_PATTERN } from './snapshot-build';
-export type { SandboxErrorCode, SandboxErrorContext } from './util';
+} 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,
@@ -184,4 +188,4 @@ export {
 	SnapshotNotFoundError,
 	throwSandboxError,
 	writeAndDrain,
-} from './util';
+} from './util.ts';

package/src/api/sandbox/list.ts

@@ -6,8 +6,8 @@ import type {
 	SandboxStatus,
 } from '@agentuity/core';
 import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api';
-import { API_VERSION, throwSandboxError } from './util';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+import { API_VERSION, throwSandboxError } from './util.ts';
 
 export const SandboxOrgInfoSchema = z
 	.object({
@@ -76,7 +76,7 @@ export const SandboxInfoSchema = z
 		name: z.string().optional().describe('Sandbox name'),
 		description: z.string().optional().describe('Sandbox description'),
 		status: z
-			.enum(['creating', 'idle', 'running', 'terminated', 'failed', 'deleted'])
+			.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'),

package/src/api/sandbox/pause.ts

@@ -0,0 +1,42 @@
+import type { z } from 'zod';
+import { type APIClient, APIResponseSchemaNoData } from '../api';
+import { API_VERSION, throwSandboxError } from './util';
+
+export const PauseResponseSchema = APIResponseSchemaNoData();
+
+export interface SandboxPauseParams {
+	sandboxId: string;
+	orgId?: string;
+}
+
+/**
+ * Pauses a running sandbox, creating a checkpoint of its current state.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID to pause
+ * @throws {SandboxResponseError} If the sandbox is not found or pause fails
+ */
+export async function sandboxPause(
+	client: APIClient,
+	params: SandboxPauseParams
+): Promise<void> {
+	const { sandboxId, orgId } = params;
+	const queryParams = new URLSearchParams();
+	if (orgId) {
+		queryParams.set('orgId', orgId);
+	}
+	const queryString = queryParams.toString();
+	const url = `/sandbox/${API_VERSION}/${sandboxId}/pause${queryString ? `?${queryString}` : ''}`;
+
+	const resp = await client.post<z.infer<typeof PauseResponseSchema>>(
+		url,
+		undefined,
+		PauseResponseSchema
+	);
+
+	if (resp.success) {
+		return;
+	}
+
+	throwSandboxError(resp, { sandboxId });
+}

package/src/api/sandbox/resolve.ts

@@ -1,6 +1,6 @@
 import { StructuredError } from '@agentuity/core';
 import { z } from 'zod';
-import { type APIClient, APIResponseSchemaOptionalData } from '../api';
+import { type APIClient, APIResponseSchemaOptionalData } from '../api.ts';
 
 /**
  * Data schema for sandbox resolve endpoint

package/src/api/sandbox/resume.ts

@@ -0,0 +1,42 @@
+import type { z } from 'zod';
+import { type APIClient, APIResponseSchemaNoData } from '../api';
+import { API_VERSION, throwSandboxError } from './util';
+
+export const ResumeResponseSchema = APIResponseSchemaNoData();
+
+export interface SandboxResumeParams {
+	sandboxId: string;
+	orgId?: string;
+}
+
+/**
+ * Resumes a paused sandbox from its checkpoint.
+ *
+ * @param client - The API client to use for the request
+ * @param params - Parameters including the sandbox ID to resume
+ * @throws {SandboxResponseError} If the sandbox is not found or resume fails
+ */
+export async function sandboxResume(
+	client: APIClient,
+	params: SandboxResumeParams
+): Promise<void> {
+	const { sandboxId, orgId } = params;
+	const queryParams = new URLSearchParams();
+	if (orgId) {
+		queryParams.set('orgId', orgId);
+	}
+	const queryString = queryParams.toString();
+	const url = `/sandbox/${API_VERSION}/${sandboxId}/resume${queryString ? `?${queryString}` : ''}`;
+
+	const resp = await client.post<z.infer<typeof ResumeResponseSchema>>(
+		url,
+		undefined,
+		ResumeResponseSchema
+	);
+
+	if (resp.success) {
+		return;
+	}
+
+	throwSandboxError(resp, { sandboxId });
+}

package/src/api/sandbox/run.ts

@@ -1,13 +1,13 @@
 import type { Logger } from '@agentuity/core';
 import type { Readable, Writable } from 'node:stream';
 import { PassThrough } from 'node:stream';
-import { APIClient, PaymentRequiredError } from '../api';
-import { sandboxCreate } from './create';
-import { sandboxDestroy } from './destroy';
-import { sandboxGet } from './get';
-import { ExecutionCancelledError, ExecutionTimeoutError, writeAndDrain } from './util';
+import { APIClient, PaymentRequiredError } from '../api.ts';
+import { sandboxCreate } from './create.ts';
+import { sandboxDestroy } from './destroy.ts';
+import { sandboxGet } from './get.ts';
+import { ExecutionCancelledError, ExecutionTimeoutError, writeAndDrain } from './util.ts';
 import type { SandboxRunOptions, SandboxRunResult } from '@agentuity/core';
-import { getServiceUrls } from '../../config';
+import { getServiceUrls } from '../../config.ts';
 
 /**
  * Creates a Writable stream that captures all chunks to a buffer array

package/src/api/sandbox/runtime.ts

@@ -1,7 +1,7 @@
 import type { ListRuntimesParams, ListRuntimesResponse, SandboxRuntime } from '@agentuity/core';
 import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api';
-import { API_VERSION, throwSandboxError } from './util';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+import { API_VERSION, throwSandboxError } from './util.ts';
 
 export const RuntimeRequirementsSchema = z
 	.object({

package/src/api/sandbox/snapshot.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { type APIClient, APIResponseSchema, APIResponseSchemaNoData } from '../api';
-import { NPM_PACKAGE_NAME_PATTERN } from './snapshot-build';
-import { API_VERSION, SandboxResponseError, throwSandboxError } from './util';
+import { type APIClient, APIResponseSchema, APIResponseSchemaNoData } from '../api.ts';
+import { NPM_PACKAGE_NAME_PATTERN } from './snapshot-build.ts';
+import { API_VERSION, SandboxResponseError, throwSandboxError } from './util.ts';
 
 export const SnapshotFileInfoSchema = z
 	.object({

package/src/api/sandbox/util.ts

@@ -184,6 +184,12 @@ export interface SandboxErrorContext {
  * when the backend returns a known error code, and falling back to
  * SandboxResponseError for unknown codes.
  *
+ * Note: Pause and resume operations use standard error codes. The backend
+ * returns SANDBOX_NOT_FOUND when the sandbox doesn't exist, and HTTP 409
+ * Conflict (handled by APIClient retries) for invalid state transitions
+ * (e.g. pausing a non-running sandbox, resuming a non-suspended sandbox).
+ * No additional error codes are needed for pause/resume.
+ *
  * @param resp - The API response containing message and optional code
  * @param context - Context about the operation (sandbox ID, execution ID, etc.)
  * @throws {SandboxNotFoundError} When code is 'SANDBOX_NOT_FOUND'

package/src/api/session/get.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api';
-import { SessionSchema, type Session } from './list';
-import { SessionResponseError } from './util';
+import { APIClient, APIResponseSchema } from '../api.ts';
+import { SessionSchema, type Session } from './list.ts';
+import { SessionResponseError } from './util.ts';
 
 export const _SessionGetRequestSchema = z.object({
 	id: z.string().describe('the session id'),

package/src/api/session/index.ts

@@ -1,3 +1,3 @@
-export * from './get';
-export * from './list';
-export * from './logs';
+export * from './get.ts';
+export * from './list.ts';
+export * from './logs.ts';

package/src/api/session/list.ts

@@ -1,7 +1,7 @@
 import type { SortDirection } from '@agentuity/core';
 import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api';
-import { SessionResponseError } from './util';
+import { APIClient, APIResponseSchema } from '../api.ts';
+import { SessionResponseError } from './util.ts';
 
 const SessionSchema = z.object({
 	id: z.string().describe('the session id'),

package/src/api/session/logs.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api';
-import { SessionResponseError } from './util';
+import { APIClient, APIResponseSchema } from '../api.ts';
+import { SessionResponseError } from './util.ts';
 
 export const _SessionLogsRequestSchema = z.object({
 	id: z.string().describe('the session id'),

package/src/api/stream/get.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api';
-import { StreamResponseError } from './util';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+import { StreamResponseError } from './util.ts';
 
 export const StreamDetailSchema = z.object({
 	id: z.string().describe('the stream id'),

package/src/api/stream/index.ts

@@ -1,3 +1,3 @@
-export * from './get';
-export * from './list';
-export * from './util';
+export * from './get.ts';
+export * from './list.ts';
+export * from './util.ts';

package/src/api/stream/list.ts

@@ -1,7 +1,7 @@
 import type { SortDirection } from '@agentuity/core';
 import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api';
-import { StreamResponseError } from './util';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+import { StreamResponseError } from './util.ts';
 
 export const StreamInfoSchema = z.object({
 	id: z.string().describe('the stream id'),

package/src/api/thread/delete.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { APIClient, APIResponseSchemaNoData } from '../api';
-import { ThreadResponseError } from './util';
+import { APIClient, APIResponseSchemaNoData } from '../api.ts';
+import { ThreadResponseError } from './util.ts';
 
 export const _ThreadDeleteRequestSchema = z.object({
 	id: z.string().describe('the thread id'),

package/src/api/thread/get.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api';
-import { ThreadSchema, type Thread } from './list';
-import { ThreadResponseError } from './util';
+import { APIClient, APIResponseSchema } from '../api.ts';
+import { ThreadSchema, type Thread } from './list.ts';
+import { ThreadResponseError } from './util.ts';
 
 export const _ThreadGetRequestSchema = z.object({
 	id: z.string().describe('the thread id'),

package/src/api/thread/index.ts

@@ -1,4 +1,4 @@
-export * from './get';
-export * from './list';
-export * from './delete';
-export * from './util';
+export * from './get.ts';
+export * from './list.ts';
+export * from './delete.ts';
+export * from './util.ts';

package/src/api/thread/list.ts

@@ -1,7 +1,7 @@
 import type { SortDirection } from '@agentuity/core';
 import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api';
-import { ThreadResponseError } from './util';
+import { APIClient, APIResponseSchema } from '../api.ts';
+import { ThreadResponseError } from './util.ts';
 
 export const ThreadSchema = z.object({
 	id: z.string().describe('the thread id'),

package/src/api/user/index.ts

@@ -1 +1 @@
-export * from './whoami';
+export * from './whoami.ts';

package/src/api/user/whoami.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { APIResponseSchema, APIClient } from '../api';
-import { UserResponseError } from './util';
+import { APIResponseSchema, APIClient } from '../api.ts';
+import { UserResponseError } from './util.ts';
 
 export const OrganizationSchema = z.object({
 	id: z.string().describe('the unique id for the organization'),

package/src/index.ts

@@ -1,20 +1,20 @@
 // api exports (from api/index.ts which has barrel exports)
-export * from './api';
+export * from './api/index.ts';
 
 // config.ts exports
-export { type ServiceUrls, getServiceUrls, resolveRegion } from './config';
+export { type ServiceUrls, getServiceUrls, resolveRegion } from './config.ts';
 
 // logger.ts exports
-export { type ColorScheme, ConsoleLogger, createLogger } from './logger';
+export { type ColorScheme, ConsoleLogger, createLogger } from './logger.ts';
 
 // server.ts exports
-export { createServerFetchAdapter } from './server';
+export { createServerFetchAdapter } from './server.ts';
 
 // schema.ts exports
-export { toJSONSchema } from './schema';
+export { toJSONSchema } from './schema.ts';
 
 // util/mime.ts exports
-export { getContentType, mimeTypes } from './util/mime';
+export { getContentType, mimeTypes } from './util/mime.ts';
 
 // util/resources.ts exports
 export {
@@ -24,10 +24,10 @@ export {
 	type ResourceValidationResult,
 	type ResourcesConfig,
 	type ValidatedResources,
-} from './util/resources';
+} from './util/resources.ts';
 
 // runtime-bootstrap.ts exports
-export { bootstrapRuntimeEnv, type RuntimeBootstrapOptions } from './runtime-bootstrap';
+export { bootstrapRuntimeEnv, type RuntimeBootstrapOptions } from './runtime-bootstrap.ts';
 
 // zod re-export
 export { z } from 'zod';

package/src/runtime-bootstrap.ts

@@ -5,7 +5,7 @@
  * Does not depend on CLI config files or .env file parsing.
  */
 
-import { getServiceUrls } from './config';
+import { getServiceUrls } from './config.ts';
 
 export interface RuntimeBootstrapOptions {
 	/**