process readiness

packages/sandbox/src/errors/classes.ts

@@ -25,7 +25,9 @@ import type {
   PortErrorContext,
   PortNotExposedContext,
   ProcessErrorContext,
+  ProcessExitedBeforeReadyContext,
   ProcessNotFoundContext,
+  ProcessReadyTimeoutContext,
   ValidationFailedContext
 } from '@repo/shared/errors';
 
@@ -592,3 +594,55 @@ export class ValidationFailedError extends SandboxError<ValidationFailedContext>
     return this.context.validationErrors;
   }
 }
+
+// ============================================================================
+// Process Readiness Errors
+// ============================================================================
+
+/**
+ * Error thrown when a process does not become ready within the timeout period
+ */
+export class ProcessReadyTimeoutError extends SandboxError<ProcessReadyTimeoutContext> {
+  constructor(errorResponse: ErrorResponse<ProcessReadyTimeoutContext>) {
+    super(errorResponse);
+    this.name = 'ProcessReadyTimeoutError';
+  }
+
+  // Type-safe accessors
+  get processId() {
+    return this.context.processId;
+  }
+  get command() {
+    return this.context.command;
+  }
+  get condition() {
+    return this.context.condition;
+  }
+  get timeout() {
+    return this.context.timeout;
+  }
+}
+
+/**
+ * Error thrown when a process exits before becoming ready
+ */
+export class ProcessExitedBeforeReadyError extends SandboxError<ProcessExitedBeforeReadyContext> {
+  constructor(errorResponse: ErrorResponse<ProcessExitedBeforeReadyContext>) {
+    super(errorResponse);
+    this.name = 'ProcessExitedBeforeReadyError';
+  }
+
+  // Type-safe accessors
+  get processId() {
+    return this.context.processId;
+  }
+  get command() {
+    return this.context.command;
+  }
+  get condition() {
+    return this.context.condition;
+  }
+  get exitCode() {
+    return this.context.exitCode;
+  }
+}

packages/sandbox/src/errors/index.ts

@@ -61,7 +61,9 @@ export type {
   PortErrorContext,
   PortNotExposedContext,
   ProcessErrorContext,
+  ProcessExitedBeforeReadyContext,
   ProcessNotFoundContext,
+  ProcessReadyTimeoutContext,
   ValidationFailedContext
 } from '@repo/shared/errors';
 // Re-export shared types and constants
@@ -100,8 +102,11 @@ export {
   PortInUseError,
   PortNotExposedError,
   ProcessError,
+  // Process Readiness Errors
+  ProcessExitedBeforeReadyError,
   // Process Errors
   ProcessNotFoundError,
+  ProcessReadyTimeoutError,
   SandboxError,
   ServiceNotRespondingError,
   // Validation Errors

packages/sandbox/src/index.ts

@@ -40,7 +40,9 @@ export type {
   RunCodeOptions,
   SandboxOptions,
   SessionOptions,
-  StreamOptions
+  StreamOptions,
+  // Process readiness types
+  WaitForLogResult
 } from '@repo/shared';
 // Export type guards for runtime validation
 export { isExecResult, isProcess, isProcessStatus } from '@repo/shared';
@@ -96,6 +98,15 @@ export type {
   ExecutionCallbacks,
   InterpreterClient
 } from './clients/interpreter-client.js';
+export type {
+  ProcessExitedBeforeReadyContext,
+  ProcessReadyTimeoutContext
+} from './errors';
+// Export process readiness errors
+export {
+  ProcessExitedBeforeReadyError,
+  ProcessReadyTimeoutError
+} from './errors';
 // Export file streaming utilities for binary file support
 export { collectFile, streamFile } from './file-stream';
 // Export interpreter functionality