@agentuity/server 1.0.17 → 1.0.18

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 {
 	/**