Interface SandboxExecutor

Sandbox executor interface - must be implemented by platform-specific sandboxes

interface SandboxExecutor {
    destroy(): void;
    execute(code: string, context: Record<string, any>, timeout: number): Promise<common.apis.cortex.SandboxResult<any>>;
    initializePersistent(): Promise<void>;
    reset(): Promise<void>;
    setupEventStream?(handler: ((event: common.apis.cortex.SandboxRuntimeEvent) => void)): (() => void);
}

Index

Methods

destroy execute initializePersistent reset setupEventStream?

Methods

destroy

destroy(): void
Destroy sandbox completely

Returns void
- Defined in packages/ts_common/src/apis/cortex/sandbox_interface.ts:36

execute

execute(code, context, timeout): Promise<common.apis.cortex.SandboxResult<any>>
Execute JavaScript code in isolated environment
Parameters
- code: string
  JavaScript code to execute
- context: Record<string, any>
  Variables and functions to inject
- timeout: number
  Execution timeout in milliseconds
Returns Promise<common.apis.cortex.SandboxResult<any>>
Promise with execution result
- Defined in packages/ts_common/src/apis/cortex/sandbox_interface.ts:17

initializePersistent

initializePersistent(): Promise<void>
Initialize persistent sandbox environment

Returns Promise<void>
- Defined in packages/ts_common/src/apis/cortex/sandbox_interface.ts:26

reset

reset(): Promise<void>
Reset sandbox environment, clearing all state

Returns Promise<void>
- Defined in packages/ts_common/src/apis/cortex/sandbox_interface.ts:31

`Optional`setupEventStream

setupEventStream(handler): (() => void)
Setup real-time event stream listener (optional) Only implemented by sandboxes that support real-time streaming (e.g., IframeSandbox) NodeSandbox uses synchronous execution and doesn't implement this.
Parameters
- handler: ((event: common.apis.cortex.SandboxRuntimeEvent) => void)
  Callback to receive real-time log/event messages
  - - (event): void
    - Parameters
      event: common.apis.cortex.SandboxRuntimeEvent
      Returns void
Returns (() => void)
Cleanup function to remove the listener
- - (): void
  - Returns void
- Defined in packages/ts_common/src/apis/cortex/sandbox_interface.ts:46