OptionaldebugDefaults to undefined. If true, we introduce logging to the console.
OptionaldisposeShutdown disposal configuration.
OptionaldryDefaults to false.
Dry run mode. When true, the runner will setup the system, ensure there are no errors, but will not start the system. Your resources will not be initialized, and no events will be emitted. This is useful for testing and debugging.
Note: this cannot catch init() errors that happen within resources.
OptionalerrorWhen true (default), installs a central error boundary that catches uncaught errors
from process-level events and routes them to onUnhandledError.
OptionalexecutionEnables built-in execution tracing and cycle detection for this runtime.
OptionalidentityOverrides which async context Runner reads for identity-aware framework features such as identity-scoped cache, rate limits, and temporal policies.
App code should continue using this context directly for provide(),
use(), and require(). Runner also auto-registers the configured
context inside the runtime so it can be used as a dependency.
OptionallazyDefaults to false.
When true, startup skips initializing resources that are not used during bootstrap.
Such resources can be initialized on-demand via runResult.getLazyResourceValue(...).
OptionallifecycleDefaults to sequential.
Controls startup and disposal scheduling behavior.
OptionallogsConfigure logging settings.
OptionalbufferLogs?: booleanDefaults to false. If true, we buffer logs until the root resource is ready. This provides you with the chance to see the logs before the root resource is ready.
OptionalprintStrategy?: PrintStrategyDefaults to PRETTY. How to print the logs.
OptionalprintThreshold?: null | LogLevelsDefaults to info. Use null to disable logging.
OptionalmodeSpecify in which mode to run "dev", "prod" or "test". If inside Node this is automatically detected from the NODE_ENV environment variable if not provided.
OptionalonCustom handler for any unhandled error caught by Runner. Defaults to logging via the created logger.
OptionalshutdownWhen true (default), installs SIGINT/SIGTERM handlers that trigger graceful shutdown. Signals received during bootstrap will cancel startup, rollback initialized resources, and exit cleanly once teardown completes.
OptionalsignalExternal shutdown trigger for the runtime lifecycle. Aborting this signal cancels bootstrap before readiness (rolling back any initialized resources) or starts graceful disposal after the runtime is ready, without affecting ambient execution signals.
Public runtime options accepted by
run(app, options).