rivetkit 2.0.39 → 2.0.41

package/dist/tsup/{chunk-7E3RWMR6.cjs → chunk-4UHJ3ADW.cjs}

@@ -10,7 +10,7 @@
 
 
 
-var _chunkDY4H3ASEcjs = require('./chunk-DY4H3ASE.cjs');
+var _chunkGTQKDCM4cjs = require('./chunk-GTQKDCM4.cjs');
 
 
 
@@ -23,7 +23,7 @@ var _chunkDY4H3ASEcjs = require('./chunk-DY4H3ASE.cjs');
 
 
 
-var _chunkUAX5E3EUcjs = require('./chunk-UAX5E3EU.cjs');
+var _chunkWYZLRPQMcjs = require('./chunk-WYZLRPQM.cjs');
 
 
 
@@ -47,7 +47,7 @@ var _chunkUAX5E3EUcjs = require('./chunk-UAX5E3EU.cjs');
 
 
 
-var _chunkKMYFL3OLcjs = require('./chunk-KMYFL3OL.cjs');
+var _chunkB5UXC4QVcjs = require('./chunk-B5UXC4QV.cjs');
 
 
 
@@ -65,7 +65,7 @@ var _chunkKMYFL3OLcjs = require('./chunk-KMYFL3OL.cjs');
 
 
 
-var _chunkX72X7I7Tcjs = require('./chunk-X72X7I7T.cjs');
+var _chunkS6F7EKC7cjs = require('./chunk-S6F7EKC7.cjs');
 
 
 
@@ -229,7 +229,7 @@ var DocActorConfigSchema = _zod.z.object({
 // src/actor/mod.ts
 function actor(input) {
   const config = ActorConfigSchema.parse(input);
-  return new (0, _chunkUAX5E3EUcjs.ActorDefinition)(config);
+  return new (0, _chunkWYZLRPQMcjs.ActorDefinition)(config);
 }
 
 // src/drivers/engine/actor-driver.ts
@@ -241,7 +241,7 @@ var _invariant = require('invariant'); var _invariant2 = _interopRequireDefault(
 
 // src/drivers/engine/log.ts
 function logger() {
-  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "driver-engine");
+  return _chunkS6F7EKC7cjs.getLogger.call(void 0, "driver-engine");
 }
 
 // src/drivers/engine/actor-driver.ts
@@ -255,8 +255,8 @@ var EngineActorDriver = class {
   #runner;
   #actors = /* @__PURE__ */ new Map();
   #actorRouter;
-  #runnerStarted = _chunkX72X7I7Tcjs.promiseWithResolvers.call(void 0, );
-  #runnerStopped = _chunkX72X7I7Tcjs.promiseWithResolvers.call(void 0, );
+  #runnerStarted = _chunkS6F7EKC7cjs.promiseWithResolvers.call(void 0, );
+  #runnerStopped = _chunkS6F7EKC7cjs.promiseWithResolvers.call(void 0, );
   #isRunnerStopped = false;
   // HACK: Track actor stop intent locally since the runner protocol doesn't
   // pass the stop reason to onActorStop. This will be fixed when the runner
@@ -280,7 +280,7 @@ var EngineActorDriver = class {
     this.#managerDriver = managerDriver;
     this.#inlineClient = inlineClient;
     const token = config.token;
-    this.#actorRouter = _chunkDY4H3ASEcjs.createActorRouter.call(void 0, 
+    this.#actorRouter = _chunkGTQKDCM4cjs.createActorRouter.call(void 0, 
       config,
       this,
       void 0,
@@ -288,16 +288,16 @@ var EngineActorDriver = class {
     );
     const engineRunnerConfig = {
       version: config.runner.version,
-      endpoint: _chunkUAX5E3EUcjs.getEndpoint.call(void 0, config),
+      endpoint: _chunkWYZLRPQMcjs.getEndpoint.call(void 0, config),
       token,
       namespace: config.namespace,
       totalSlots: config.runner.totalSlots,
       runnerName: config.runner.runnerName,
       runnerKey: _nullishCoalesce(config.runner.runnerKey, () => ( crypto.randomUUID())),
       metadata: {
-        rivetkit: { version: _chunkX72X7I7Tcjs.VERSION }
+        rivetkit: { version: _chunkS6F7EKC7cjs.VERSION }
       },
-      prepopulateActorNames: _chunkKMYFL3OLcjs.buildActorNames.call(void 0, config),
+      prepopulateActorNames: _chunkB5UXC4QVcjs.buildActorNames.call(void 0, config),
       onConnected: () => {
         this.#runnerStarted.resolve(void 0);
       },
@@ -314,7 +314,7 @@ var EngineActorDriver = class {
       },
       onActorStart: this.#runnerOnActorStart.bind(this),
       onActorStop: this.#runnerOnActorStop.bind(this),
-      logger: _chunkX72X7I7Tcjs.getLogger.call(void 0, "engine-runner")
+      logger: _chunkS6F7EKC7cjs.getLogger.call(void 0, "engine-runner")
     };
     this.#runner = new (0, _enginerunner.Runner)(engineRunnerConfig);
     this.#runner.start();
@@ -352,7 +352,7 @@ var EngineActorDriver = class {
       handler.alarmTimeout = void 0;
     }
     const delay = Math.max(0, timestamp - Date.now());
-    handler.alarmTimeout = _chunkX72X7I7Tcjs.setLongTimeout.call(void 0, () => {
+    handler.alarmTimeout = _chunkS6F7EKC7cjs.setLongTimeout.call(void 0, () => {
       actor2.onAlarm();
       handler.alarmTimeout = void 0;
     }, delay);
@@ -424,7 +424,7 @@ var EngineActorDriver = class {
             var _a;
             (_a = handler.actor) == null ? void 0 : _a.rLog.error({
               msg: "onStop errored",
-              error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
+              error: _chunkS6F7EKC7cjs.stringifyError.call(void 0, err)
             });
           })
         );
@@ -482,18 +482,18 @@ var EngineActorDriver = class {
     let handler = this.#actors.get(actorId);
     if (!handler) {
       handler = {
-        actorStartPromise: _chunkX72X7I7Tcjs.promiseWithResolvers.call(void 0, )
+        actorStartPromise: _chunkS6F7EKC7cjs.promiseWithResolvers.call(void 0, )
       };
       this.#actors.set(actorId, handler);
     }
     const name = actorConfig.name;
     _invariant2.default.call(void 0, actorConfig.key, "actor should have a key");
-    const key = _chunkKMYFL3OLcjs.deserializeActorKey.call(void 0, actorConfig.key);
+    const key = _chunkB5UXC4QVcjs.deserializeActorKey.call(void 0, actorConfig.key);
     const [persistDataBuffer] = await this.#runner.kvGet(actorId, [
-      _chunkKMYFL3OLcjs.KEYS.PERSIST_DATA
+      _chunkB5UXC4QVcjs.KEYS.PERSIST_DATA
     ]);
     if (persistDataBuffer === null) {
-      const initialKvState = _chunkKMYFL3OLcjs.getInitialActorKvState.call(void 0, input);
+      const initialKvState = _chunkB5UXC4QVcjs.getInitialActorKvState.call(void 0, input);
       await this.#runner.kvPut(actorId, initialKvState);
       logger().debug({
         msg: "initialized persist data for new actor",
@@ -506,7 +506,7 @@ var EngineActorDriver = class {
         dataSize: persistDataBuffer.byteLength
       });
     }
-    const definition = _chunkUAX5E3EUcjs.lookupInRegistry.call(void 0, this.#config, actorConfig.name);
+    const definition = _chunkWYZLRPQMcjs.lookupInRegistry.call(void 0, this.#config, actorConfig.name);
     handler.actor = definition.instantiate();
     await handler.actor.start(
       this,
@@ -530,7 +530,7 @@ var EngineActorDriver = class {
       } catch (err) {
         logger().error({
           msg: "error in onStop, proceeding with removing actor",
-          err: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
+          err: _chunkS6F7EKC7cjs.stringifyError.call(void 0, err)
         });
       }
       this.#actors.delete(actorId);
@@ -563,10 +563,10 @@ var EngineActorDriver = class {
       websocketProps: websocketRaw ? Object.keys(websocketRaw).join(", ") : "null"
     });
     const protocols = request.headers.get("sec-websocket-protocol");
-    const { encoding, connParams } = _chunkKMYFL3OLcjs.parseWebSocketProtocols.call(void 0, protocols);
+    const { encoding, connParams } = _chunkB5UXC4QVcjs.parseWebSocketProtocols.call(void 0, protocols);
     let wsHandler;
     try {
-      wsHandler = await _chunkKMYFL3OLcjs.routeWebSocket.call(void 0, 
+      wsHandler = await _chunkB5UXC4QVcjs.routeWebSocket.call(void 0, 
         request,
         requestPath,
         requestHeaders,
@@ -589,7 +589,7 @@ var EngineActorDriver = class {
     const wsContext = new (0, _ws.WSContext)(websocket);
     const conn = wsHandler.conn;
     const actor2 = wsHandler.actor;
-    const connStateManager = conn == null ? void 0 : conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
+    const connStateManager = conn == null ? void 0 : conn[_chunkB5UXC4QVcjs.CONN_STATE_MANAGER_SYMBOL];
     logger().debug({
       msg: "attaching websocket event listeners",
       actorId,
@@ -649,7 +649,7 @@ var EngineActorDriver = class {
         });
         const entry = this.#hwsMessageIndex.get(conn.id);
         if (entry) {
-          const messageLength = _chunkKMYFL3OLcjs.getValueLength.call(void 0, event.data);
+          const messageLength = _chunkB5UXC4QVcjs.getValueLength.call(void 0, event.data);
           entry.bufferedMessageSize += messageLength;
           if (entry.bufferedMessageSize >= CONN_BUFFERED_MESSAGE_SIZE_THRESHOLD) {
             entry.bufferedMessageSize = 0;
@@ -720,10 +720,10 @@ var EngineActorDriver = class {
       gatewayId: _enginerunner.idToStr.call(void 0, gatewayId),
       requestId: _enginerunner.idToStr.call(void 0, requestId)
     });
-    if (path === _chunkKMYFL3OLcjs.PATH_CONNECT) {
+    if (path === _chunkB5UXC4QVcjs.PATH_CONNECT) {
       return true;
-    } else if (path === _chunkKMYFL3OLcjs.PATH_WEBSOCKET_BASE || path.startsWith(_chunkKMYFL3OLcjs.PATH_WEBSOCKET_PREFIX)) {
-      const definition = _chunkUAX5E3EUcjs.lookupInRegistry.call(void 0, 
+    } else if (path === _chunkB5UXC4QVcjs.PATH_WEBSOCKET_BASE || path.startsWith(_chunkB5UXC4QVcjs.PATH_WEBSOCKET_PREFIX)) {
+      const definition = _chunkWYZLRPQMcjs.lookupInRegistry.call(void 0, 
         this.#config,
         actorInstance.config.name
       );
@@ -732,7 +732,7 @@ var EngineActorDriver = class {
         return true;
       } else if (typeof canHibernateWebSocket === "function") {
         try {
-          const newPath = _chunkKMYFL3OLcjs.truncateRawWebSocketPathPrefix.call(void 0, 
+          const newPath = _chunkB5UXC4QVcjs.truncateRawWebSocketPathPrefix.call(void 0, 
             url.pathname
           );
           const truncatedRequest = new Request(
@@ -751,7 +751,7 @@ var EngineActorDriver = class {
       } else {
         return false;
       }
-    } else if (path === _chunkKMYFL3OLcjs.PATH_INSPECTOR_CONNECT) {
+    } else if (path === _chunkB5UXC4QVcjs.PATH_INSPECTOR_CONNECT) {
       return false;
     } else {
       logger().warn({
@@ -764,7 +764,7 @@ var EngineActorDriver = class {
   async #hwsLoadAll(actorId) {
     const actor2 = await this.loadActor(actorId);
     return actor2.conns.values().map((conn) => {
-      const connStateManager = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
+      const connStateManager = conn[_chunkB5UXC4QVcjs.CONN_STATE_MANAGER_SYMBOL];
       const hibernatable = connStateManager.hibernatableData;
       if (!hibernatable) return void 0;
       return {
@@ -787,7 +787,7 @@ var EngineActorDriver = class {
     await this.#runner.restoreHibernatingRequests(actor2.id, metaEntries);
   }
   onCreateConn(conn) {
-    const hibernatable = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL].hibernatableData;
+    const hibernatable = conn[_chunkB5UXC4QVcjs.CONN_STATE_MANAGER_SYMBOL].hibernatableData;
     if (!hibernatable) return;
     this.#hwsMessageIndex.set(conn.id, {
       serverMessageIndex: hibernatable.serverMessageIndex,
@@ -809,7 +809,7 @@ var EngineActorDriver = class {
     });
   }
   onBeforePersistConn(conn) {
-    const stateManager = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
+    const stateManager = conn[_chunkB5UXC4QVcjs.CONN_STATE_MANAGER_SYMBOL];
     const hibernatable = stateManager.hibernatableDataOrError();
     const entry = this.#hwsMessageIndex.get(conn.id);
     if (!entry) {
@@ -823,7 +823,7 @@ var EngineActorDriver = class {
     entry.serverMessageIndex = hibernatable.serverMessageIndex;
   }
   onAfterPersistConn(conn) {
-    const stateManager = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
+    const stateManager = conn[_chunkB5UXC4QVcjs.CONN_STATE_MANAGER_SYMBOL];
     const hibernatable = stateManager.hibernatableDataOrError();
     const entry = this.#hwsMessageIndex.get(conn.id);
     if (!entry) {
@@ -848,9 +848,9 @@ var EngineActorDriver = class {
 
 // src/drivers/engine/config.ts
 
-var EngineConfigSchemaBase = _chunkUAX5E3EUcjs.ClientConfigSchemaBase.extend({
+var EngineConfigSchemaBase = _chunkWYZLRPQMcjs.ClientConfigSchemaBase.extend({
   /** Unique key for this runner. Runners connecting a given key will replace any other runner connected with the same key. */
-  runnerKey: _zod.z.string().optional().transform((val) => _nullishCoalesce(val, () => ( _chunkX72X7I7Tcjs.getRivetRunnerKey.call(void 0, )))),
+  runnerKey: _zod.z.string().optional().transform((val) => _nullishCoalesce(val, () => ( _chunkS6F7EKC7cjs.getRivetRunnerKey.call(void 0, )))),
   /** How many actors this runner can run. */
   totalSlots: _zod.z.number().default(1e5)
 });
@@ -862,7 +862,7 @@ var EngineConfigSchema = EngineConfigSchemaTransformed.default(
 );
 function transformEngineConfig(config, ctx) {
   return {
-    ..._chunkUAX5E3EUcjs.transformClientConfig.call(void 0, config, ctx),
+    ..._chunkWYZLRPQMcjs.transformClientConfig.call(void 0, config, ctx),
     runnerKey: config.runnerKey
   };
 }
@@ -873,8 +873,8 @@ function createEngineDriver() {
     name: "engine",
     displayName: "Engine",
     manager: (config) => {
-      const clientConfig = _chunkUAX5E3EUcjs.convertRegistryConfigToClientConfig.call(void 0, config);
-      return new (0, _chunkUAX5E3EUcjs.RemoteManagerDriver)(clientConfig);
+      const clientConfig = _chunkWYZLRPQMcjs.convertRegistryConfigToClientConfig.call(void 0, config);
+      return new (0, _chunkWYZLRPQMcjs.RemoteManagerDriver)(clientConfig);
     },
     actor: (config, managerDriver, inlineClient) => {
       return new EngineActorDriver(
@@ -902,15 +902,15 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
   /** @experimental */
   maxOutgoingMessageSize: _zod.z.number().optional().default(1048576),
   /** @experimental */
-  inspector: _chunkKMYFL3OLcjs.InspectorConfigSchema,
+  inspector: _chunkB5UXC4QVcjs.InspectorConfigSchema,
   /** @experimental */
   disableDefaultServer: _zod.z.boolean().optional().default(false),
   /** @experimental */
   defaultServerPort: _zod.z.number().default(6420),
   /** @experimental */
-  runEngine: _zod.z.boolean().optional().default(() => _chunkX72X7I7Tcjs.getRivetRunEngine.call(void 0, )),
+  runEngine: _zod.z.boolean().optional().default(() => _chunkS6F7EKC7cjs.getRivetRunEngine.call(void 0, )),
   /** @experimental */
-  runEngineVersion: _zod.z.string().optional().default(() => _nullishCoalesce(_chunkX72X7I7Tcjs.getRivetRunEngineVersion.call(void 0, ), () => ( _chunkX72X7I7Tcjs.VERSION))),
+  runEngineVersion: _zod.z.string().optional().default(() => _nullishCoalesce(_chunkS6F7EKC7cjs.getRivetRunEngineVersion.call(void 0, ), () => ( _chunkS6F7EKC7cjs.VERSION))),
   /** @experimental */
   overrideServerAddress: _zod.z.string().optional(),
   /** @experimental */
@@ -922,7 +922,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
    * serverlessly (by the Rivet Engine for example).
    */
   runnerKind: _zod.z.enum(["serverless", "normal"]).optional().default(
-    () => _chunkX72X7I7Tcjs.getRivetRunnerKind.call(void 0, ) === "serverless" ? "serverless" : "normal"
+    () => _chunkS6F7EKC7cjs.getRivetRunnerKind.call(void 0, ) === "serverless" ? "serverless" : "normal"
   ),
   totalSlots: _zod.z.number().optional(),
   /**
@@ -944,7 +944,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
    * */
   logging: _zod.z.object({
     baseLogger: _zod.z.custom().optional(),
-    level: _chunkX72X7I7Tcjs.LogLevelSchema.optional()
+    level: _chunkS6F7EKC7cjs.LogLevelSchema.optional()
   }).optional().default(() => ({})),
   /**
    * @experimental
@@ -972,7 +972,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
   // created or must be imported async using `await import(...)`
   getUpgradeWebSocket: _zod.z.custom().optional(),
   /** @experimental */
-  token: _zod.z.string().optional().transform((v) => v || _chunkX72X7I7Tcjs.getRivetToken.call(void 0, ))
+  token: _zod.z.string().optional().transform((v) => v || _chunkS6F7EKC7cjs.getRivetToken.call(void 0, ))
 }).merge(EngineConfigSchemaBase);
 var LegacyRunnerConfigSchemaTransformed = LegacyRunnerConfigSchemaUnmerged.transform((config, ctx) => ({
   ...config,
@@ -996,38 +996,38 @@ function chooseDefaultDriver(config) {
     return config.driver;
   }
   if (config.endpoint || config.token) {
-    _chunkKMYFL3OLcjs.loggerWithoutContext.call(void 0, ).debug({
+    _chunkB5UXC4QVcjs.loggerWithoutContext.call(void 0, ).debug({
       msg: "using rivet engine driver",
       endpoint: config.endpoint
     });
     return createEngineDriver();
   }
-  _chunkKMYFL3OLcjs.loggerWithoutContext.call(void 0, ).debug({ msg: "using default file system driver" });
-  return _chunkDY4H3ASEcjs.createFileSystemOrMemoryDriver.call(void 0, true);
+  _chunkB5UXC4QVcjs.loggerWithoutContext.call(void 0, ).debug({ msg: "using default file system driver" });
+  return _chunkGTQKDCM4cjs.createFileSystemOrMemoryDriver.call(void 0, true);
 }
 
 // src/engine-process/log.ts
 function logger2() {
-  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "engine-process");
+  return _chunkS6F7EKC7cjs.getLogger.call(void 0, "engine-process");
 }
 
 // src/engine-process/mod.ts
 var ENGINE_BASE_URL = "https://releases.rivet.dev/rivet";
 var ENGINE_BINARY_NAME = "rivet-engine";
 async function ensureEngineProcess(options) {
-  _chunkDY4H3ASEcjs.importNodeDependencies.call(void 0, );
+  _chunkGTQKDCM4cjs.importNodeDependencies.call(void 0, );
   logger2().debug({
     msg: "ensuring engine process",
     version: options.version
   });
-  const path = _chunkDY4H3ASEcjs.getNodePath.call(void 0, );
-  const storageRoot = _chunkDY4H3ASEcjs.getStoragePath.call(void 0, );
+  const path = _chunkGTQKDCM4cjs.getNodePath.call(void 0, );
+  const storageRoot = _chunkGTQKDCM4cjs.getStoragePath.call(void 0, );
   const binDir = path.join(storageRoot, "bin");
   const varDir = path.join(storageRoot, "var");
   const logsDir = path.join(varDir, "logs", "rivet-engine");
-  await _chunkDY4H3ASEcjs.ensureDirectoryExists.call(void 0, binDir);
-  await _chunkDY4H3ASEcjs.ensureDirectoryExists.call(void 0, varDir);
-  await _chunkDY4H3ASEcjs.ensureDirectoryExists.call(void 0, logsDir);
+  await _chunkGTQKDCM4cjs.ensureDirectoryExists.call(void 0, binDir);
+  await _chunkGTQKDCM4cjs.ensureDirectoryExists.call(void 0, varDir);
+  await _chunkGTQKDCM4cjs.ensureDirectoryExists.call(void 0, logsDir);
   if (await isEngineRunning()) {
     try {
       const health = await waitForEngineHealth();
@@ -1052,7 +1052,7 @@ async function ensureEngineProcess(options) {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\./g, "-");
   const stdoutLogPath = path.join(logsDir, `engine-${timestamp}-stdout.log`);
   const stderrLogPath = path.join(logsDir, `engine-${timestamp}-stderr.log`);
-  const fsSync = _chunkDY4H3ASEcjs.getNodeFsSync.call(void 0, );
+  const fsSync = _chunkGTQKDCM4cjs.getNodeFsSync.call(void 0, );
   const stdoutStream = fsSync.createWriteStream(stdoutLogPath, {
     flags: "a"
   });
@@ -1064,12 +1064,43 @@ async function ensureEngineProcess(options) {
     stdout: stdoutLogPath,
     stderr: stderrLogPath
   });
-  const childProcess = _chunkDY4H3ASEcjs.getNodeChildProcess.call(void 0, );
+  const childProcess = _chunkGTQKDCM4cjs.getNodeChildProcess.call(void 0, );
   const child = childProcess.spawn(binaryPath, ["start"], {
     cwd: path.dirname(binaryPath),
     stdio: ["inherit", "pipe", "pipe"],
     env: {
-      ...process.env
+      ...process.env,
+      // Development environment overrides for Rivet Engine.
+      //
+      // NOTE: When modifying these env vars, also update scripts/run/dev-env.sh
+      // to keep them in sync for manual engine runs.
+      //
+      // In development, runners can be terminated without a graceful
+      // shutdown (i.e. SIGKILL instead of SIGTERM). This is treated as a
+      // crash by Rivet Engine in production and implements a backoff for
+      // rescheduling actors in case of a crash loop.
+      //
+      // This is problematic in development since this will cause actors
+      // to become unresponsive if frequently killing your dev server.
+      //
+      // We reduce the timeouts for resetting a runner as healthy in
+      // order to account for this.
+      RIVET__PEGBOARD__RETRY_RESET_DURATION: "100",
+      RIVET__PEGBOARD__BASE_RETRY_TIMEOUT: "100",
+      // Set max exponent to 1 to have a maximum of base_retry_timeout
+      RIVET__PEGBOARD__RESCHEDULE_BACKOFF_MAX_EXPONENT: "1",
+      // Reduce thresholds for faster development iteration
+      //
+      // Default ping interval is 3s, this gives a 2s & 4s grace
+      RIVET__PEGBOARD__RUNNER_ELIGIBLE_THRESHOLD: "5000",
+      RIVET__PEGBOARD__RUNNER_LOST_THRESHOLD: "7000",
+      // Allow faster metadata polling for hot-reload in development (in milliseconds)
+      RIVET__PEGBOARD__MIN_METADATA_POLL_INTERVAL: "1000",
+      // Reduce shutdown durations for faster development iteration (in seconds)
+      RIVET__RUNTIME__WORKER_SHUTDOWN_DURATION: "1",
+      RIVET__RUNTIME__GUARD_SHUTDOWN_DURATION: "1",
+      // Force exit after this duration (must be > worker and guard shutdown durations)
+      RIVET__RUNTIME__FORCE_SHUTDOWN_DURATION: "2"
     }
   });
   if (!child.pid) {
@@ -1078,7 +1109,11 @@ async function ensureEngineProcess(options) {
   if (child.stdout) {
     child.stdout.pipe(stdoutStream);
   }
+  const stderrChunks = [];
   if (child.stderr) {
+    child.stderr.on("data", (chunk) => {
+      stderrChunks.push(chunk);
+    });
     child.stderr.pipe(stderrStream);
   }
   logger2().debug({
@@ -1087,13 +1122,37 @@ async function ensureEngineProcess(options) {
     cwd: path.dirname(binaryPath)
   });
   child.once("exit", (code, signal) => {
-    logger2().warn({
-      msg: "engine process exited, please report this error",
-      code,
-      signal,
-      issues: "https://github.com/rivet-dev/rivetkit/issues",
-      support: "https://rivet.dev/discord"
-    });
+    const stderrOutput = Buffer.concat(stderrChunks).toString("utf-8");
+    if (stderrOutput.includes("LOCK: Resource temporarily unavailable")) {
+      logger2().error({
+        msg: "another instance of rivet engine is unexpectedly running, this is an internal error",
+        code,
+        signal,
+        stdoutLog: stdoutLogPath,
+        stderrLog: stderrLogPath,
+        issues: "https://github.com/rivet-dev/rivetkit/issues",
+        support: "https://rivet.dev/discord"
+      });
+    } else if (stderrOutput.includes("Rivet Engine has been rolled back to a previous version")) {
+      logger2().error({
+        msg: "rivet engine version downgrade detected",
+        hint: `You attempted to downgrade the RivetKit version in development. To fix this, nuke the database by running: '${binaryPath}' database nuke --yes`,
+        code,
+        signal,
+        stdoutLog: stdoutLogPath,
+        stderrLog: stderrLogPath
+      });
+    } else {
+      logger2().warn({
+        msg: "engine process exited, please report this error",
+        code,
+        signal,
+        stdoutLog: stdoutLogPath,
+        stderrLog: stderrLogPath,
+        issues: "https://github.com/rivet-dev/rivetkit/issues",
+        support: "https://rivet.dev/discord"
+      });
+    }
     stdoutStream.end();
     stderrStream.end();
   });
@@ -1141,7 +1200,7 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
       `failed to download rivet engine binary from ${downloadUrl}: ${response.status} ${response.statusText}`
     );
   }
-  const crypto2 = _chunkDY4H3ASEcjs.getNodeCrypto.call(void 0, );
+  const crypto2 = _chunkGTQKDCM4cjs.getNodeCrypto.call(void 0, );
   const tempPath = `${binaryPath}.${crypto2.randomUUID()}.tmp`;
   const startTime = Date.now();
   logger2().debug({
@@ -1156,14 +1215,14 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
     });
   }, 5e3);
   try {
-    const stream = _chunkDY4H3ASEcjs.getNodeStream.call(void 0, );
-    const fsSync = _chunkDY4H3ASEcjs.getNodeFsSync.call(void 0, );
+    const stream = _chunkGTQKDCM4cjs.getNodeStream.call(void 0, );
+    const fsSync = _chunkGTQKDCM4cjs.getNodeFsSync.call(void 0, );
     await stream.pipeline(
       response.body,
       fsSync.createWriteStream(tempPath)
     );
     clearTimeout(slowDownloadWarning);
-    const fs = _chunkDY4H3ASEcjs.getNodeFs.call(void 0, );
+    const fs = _chunkGTQKDCM4cjs.getNodeFs.call(void 0, );
     const stats = await fs.stat(tempPath);
     const downloadDuration = Date.now() - startTime;
     if (process.platform !== "win32") {
@@ -1192,7 +1251,7 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
       support: "https://rivet.dev/discord"
     });
     try {
-      const fs = _chunkDY4H3ASEcjs.getNodeFs.call(void 0, );
+      const fs = _chunkGTQKDCM4cjs.getNodeFs.call(void 0, );
       await fs.unlink(tempPath);
     } catch (unlinkError) {
     }
@@ -1234,7 +1293,7 @@ function resolveTargetTripletFor(platform, arch) {
   );
 }
 async function isEngineRunning() {
-  return await checkIfEngineAlreadyRunningOnPort(_chunkKMYFL3OLcjs.ENGINE_PORT);
+  return await checkIfEngineAlreadyRunningOnPort(_chunkB5UXC4QVcjs.ENGINE_PORT);
 }
 async function checkIfEngineAlreadyRunningOnPort(port) {
   let response;
@@ -1269,7 +1328,7 @@ async function checkIfEngineAlreadyRunningOnPort(port) {
 }
 async function fileExists(filePath) {
   try {
-    const fs = _chunkDY4H3ASEcjs.getNodeFs.call(void 0, );
+    const fs = _chunkGTQKDCM4cjs.getNodeFs.call(void 0, );
     await fs.access(filePath);
     return true;
   } catch (e) {
@@ -1283,7 +1342,7 @@ async function waitForEngineHealth() {
   logger2().debug({ msg: "waiting for engine health check" });
   for (let i = 0; i < maxRetries; i++) {
     try {
-      const response = await fetch(`${_chunkKMYFL3OLcjs.ENGINE_ENDPOINT}/health`, {
+      const response = await fetch(`${_chunkB5UXC4QVcjs.ENGINE_ENDPOINT}/health`, {
         signal: AbortSignal.timeout(1e3)
       });
       if (response.ok) {
@@ -1327,7 +1386,7 @@ function getInspectorUrl(config, managerPort) {
 
 // src/serverless/log.ts
 function logger3() {
-  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "serverless");
+  return _chunkS6F7EKC7cjs.getLogger.call(void 0, "serverless");
 }
 
 // src/serverless/configure.ts
@@ -1347,12 +1406,12 @@ async function configureServerlessRunner(config) {
     }
     const customConfig = config.serverless.configureRunnerPool;
     _invariant2.default.call(void 0, customConfig, "configureRunnerPool should exist");
-    const clientConfig = _chunkUAX5E3EUcjs.convertRegistryConfigToClientConfig.call(void 0, config);
+    const clientConfig = _chunkWYZLRPQMcjs.convertRegistryConfigToClientConfig.call(void 0, config);
     logger3().debug({
       msg: "fetching datacenters",
       endpoint: config.endpoint
     });
-    const dcsRes = await _chunkUAX5E3EUcjs.getDatacenters.call(void 0, clientConfig);
+    const dcsRes = await _chunkWYZLRPQMcjs.getDatacenters.call(void 0, clientConfig);
     const runnerName = _nullishCoalesce(customConfig.name, () => ( "default"));
     logger3().debug({
       msg: "configuring serverless runner",
@@ -1367,11 +1426,14 @@ async function configureServerlessRunner(config) {
         min_runners: _nullishCoalesce(customConfig.minRunners, () => ( 0)),
         request_lifespan: _nullishCoalesce(customConfig.requestLifespan, () => ( 15 * 60)),
         runners_margin: _nullishCoalesce(customConfig.runnersMargin, () => ( 0)),
-        slots_per_runner: _nullishCoalesce(customConfig.slotsPerRunner, () => ( 1))
+        slots_per_runner: _nullishCoalesce(customConfig.slotsPerRunner, () => ( 1)),
+        metadata_poll_interval: _nullishCoalesce(customConfig.metadataPollInterval, () => ( 1e3))
       },
-      metadata: _nullishCoalesce(customConfig.metadata, () => ( {}))
+      metadata: _nullishCoalesce(customConfig.metadata, () => ( {})),
+      drain_on_version_upgrade: _nullishCoalesce(customConfig.drainOnVersionUpgrade, () => ( true)),
+      metadataPollInterval: _nullishCoalesce(customConfig.metadataPollInterval, () => ( 1e3))
     };
-    await _chunkUAX5E3EUcjs.updateRunnerConfig.call(void 0, clientConfig, runnerName, {
+    await _chunkWYZLRPQMcjs.updateRunnerConfig.call(void 0, clientConfig, runnerName, {
       datacenters: Object.fromEntries(
         dcsRes.datacenters.map((dc) => [dc.name, serverlessConfig])
       )
@@ -1391,7 +1453,7 @@ async function configureServerlessRunner(config) {
 
 // src/registry/log.ts
 function logger4() {
-  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "registry");
+  return _chunkS6F7EKC7cjs.getLogger.call(void 0, "registry");
 }
 
 // src/registry/serve.ts
@@ -1406,7 +1468,7 @@ async function findFreePort(startPort = DEFAULT_PORT) {
   return _getport2.default.call(void 0, { port: portRange(startPort) });
 }
 async function crossPlatformServe(config, managerPort, app) {
-  const runtime = _chunkX72X7I7Tcjs.detectRuntime.call(void 0, );
+  const runtime = _chunkS6F7EKC7cjs.detectRuntime.call(void 0, );
   logger4().debug({ msg: "detected runtime for serve", runtime });
   switch (runtime) {
     case "deno":
@@ -1431,7 +1493,7 @@ async function serveNode(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import @hono/node-server. please run 'npm install @hono/node-server @hono/node-ws'",
-      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
+      error: _chunkS6F7EKC7cjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1446,7 +1508,7 @@ async function serveNode(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import @hono/node-ws. please run 'npm install @hono/node-server @hono/node-ws'",
-      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
+      error: _chunkS6F7EKC7cjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1454,9 +1516,10 @@ async function serveNode(config, managerPort, app) {
     app
   });
   const port = managerPort;
+  const hostname = config.managerHost;
   const server = serve(
-    { fetch: app.fetch, port },
-    () => logger4().info({ msg: "server listening", port })
+    { fetch: app.fetch, port, hostname },
+    () => logger4().info({ msg: "server listening", port, hostname })
   );
   injectWebSocket(server);
   return { upgradeWebSocket };
@@ -1473,13 +1536,14 @@ async function serveDeno(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import hono/deno",
-      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
+      error: _chunkS6F7EKC7cjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
   const port = config.managerPort;
-  Deno.serve({ port }, app.fetch);
-  logger4().info({ msg: "server listening", port });
+  const hostname = config.managerHost;
+  Deno.serve({ port, hostname }, app.fetch);
+  logger4().info({ msg: "server listening", port, hostname });
   return { upgradeWebSocket };
 }
 async function serveBun(config, managerPort, app) {
@@ -1494,18 +1558,20 @@ async function serveBun(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import hono/bun",
-      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
+      error: _chunkS6F7EKC7cjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
   const { websocket, upgradeWebSocket } = createBunWebSocket();
   const port = config.managerPort;
+  const hostname = config.managerHost;
   Bun.serve({
     fetch: app.fetch,
     port,
+    hostname,
     websocket
   });
-  logger4().info({ msg: "server listening", port });
+  logger4().info({ msg: "server listening", port, hostname });
   return { upgradeWebSocket };
 }
 
@@ -1532,7 +1598,7 @@ var ServerlessStartHeadersSchema = _zod.z.object({
 
 // src/serverless/router.ts
 function buildServerlessRouter(driverConfig, config) {
-  return _chunkKMYFL3OLcjs.createRouter.call(void 0, config.serverless.basePath, (router) => {
+  return _chunkB5UXC4QVcjs.createRouter.call(void 0, config.serverless.basePath, (router) => {
     router.get("/", (c) => {
       return c.text(
         "This is a RivetKit server.\n\nLearn more at https://rivetkit.org"
@@ -1581,10 +1647,10 @@ function buildServerlessRouter(driverConfig, config) {
           runnerKey: void 0
         }
       };
-      const managerDriver = new (0, _chunkUAX5E3EUcjs.RemoteManagerDriver)(
-        _chunkUAX5E3EUcjs.convertRegistryConfigToClientConfig.call(void 0, newConfig)
+      const managerDriver = new (0, _chunkWYZLRPQMcjs.RemoteManagerDriver)(
+        _chunkWYZLRPQMcjs.convertRegistryConfigToClientConfig.call(void 0, newConfig)
       );
-      const client = _chunkUAX5E3EUcjs.createClientWithDriver.call(void 0, managerDriver);
+      const client = _chunkWYZLRPQMcjs.createClientWithDriver.call(void 0, managerDriver);
       const actorDriver = driverConfig.actor(
         newConfig,
         managerDriver,
@@ -1596,10 +1662,10 @@ function buildServerlessRouter(driverConfig, config) {
       );
       return await actorDriver.serverlessHandleStart(c);
     });
-    router.get("/health", (c) => _chunkKMYFL3OLcjs.handleHealthRequest.call(void 0, c));
+    router.get("/health", (c) => _chunkB5UXC4QVcjs.handleHealthRequest.call(void 0, c));
     router.get(
       "/metadata",
-      (c) => _chunkKMYFL3OLcjs.handleMetadataRequest.call(void 0, 
+      (c) => _chunkB5UXC4QVcjs.handleMetadataRequest.call(void 0, 
         c,
         config,
         { serverless: {} },
@@ -1684,9 +1750,9 @@ var Runtime = class _Runtime {
     logger4().info("rivetkit starting");
     const config = registry.parseConfig();
     if ((_a = config.logging) == null ? void 0 : _a.baseLogger) {
-      _chunkX72X7I7Tcjs.configureBaseLogger.call(void 0, config.logging.baseLogger);
+      _chunkS6F7EKC7cjs.configureBaseLogger.call(void 0, config.logging.baseLogger);
     } else {
-      _chunkX72X7I7Tcjs.configureDefaultLogger.call(void 0, (_b = config.logging) == null ? void 0 : _b.level);
+      _chunkS6F7EKC7cjs.configureDefaultLogger.call(void 0, (_b = config.logging) == null ? void 0 : _b.level);
     }
     _invariant2.default.call(void 0, 
       !(config.serverless.spawnEngine && config.serveManager),
@@ -1696,7 +1762,7 @@ var Runtime = class _Runtime {
     const managerDriver = driver.manager(config);
     let managerPort;
     if (config.serverless.spawnEngine) {
-      managerPort = _chunkKMYFL3OLcjs.ENGINE_PORT;
+      managerPort = _chunkB5UXC4QVcjs.ENGINE_PORT;
       logger4().debug({
         msg: "spawning engine",
         version: config.serverless.engineVersion
@@ -1708,7 +1774,7 @@ var Runtime = class _Runtime {
       let upgradeWebSocket;
       const getUpgradeWebSocket = () => upgradeWebSocket;
       managerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);
-      const { router: managerRouter } = _chunkKMYFL3OLcjs.buildManagerRouter.call(void 0, 
+      const { router: managerRouter } = _chunkB5UXC4QVcjs.buildManagerRouter.call(void 0, 
         config,
         managerDriver,
         getUpgradeWebSocket
@@ -1760,7 +1826,7 @@ var Runtime = class _Runtime {
     this.#startKind = "runner";
     if (this.#config.runner && this.#driver.autoStartActorDriver) {
       logger4().debug("starting actor driver");
-      const inlineClient = _chunkUAX5E3EUcjs.createClientWithDriver.call(void 0, 
+      const inlineClient = _chunkWYZLRPQMcjs.createClientWithDriver.call(void 0, 
         this.#managerDriver
       );
       this.#driver.actor(this.#config, this.#managerDriver, inlineClient);
@@ -1772,7 +1838,7 @@ var Runtime = class _Runtime {
     const inspectorUrl = this.managerPort ? getInspectorUrl(this.#config, this.managerPort) : void 0;
     console.log();
     console.log(
-      `  RivetKit ${_chunkX72X7I7Tcjs.package_default.version} (${this.#driver.displayName} - ${this.#startKind === "serverless" ? "Serverless" : "Runner"})`
+      `  RivetKit ${_chunkS6F7EKC7cjs.package_default.version} (${this.#driver.displayName} - ${this.#startKind === "serverless" ? "Serverless" : "Runner"})`
     );
     if (this.#config.namespace !== "default") {
       logLine("Namespace", this.#config.namespace);
@@ -1813,7 +1879,7 @@ var Registry = class {
     return this.#config;
   }
   parseConfig() {
-    return _chunkKMYFL3OLcjs.RegistryConfigSchema.parse(this.#config);
+    return _chunkB5UXC4QVcjs.RegistryConfigSchema.parse(this.#config);
   }
   // Shared runtime instance
   #runtime;
@@ -1879,7 +1945,7 @@ var Registry = class {
         "autoConfigureServerless can only be configured when runnerKind is 'serverless'"
       );
     }
-    const isDevEnv = _chunkX72X7I7Tcjs.isDev.call(void 0, );
+    const isDevEnv = _chunkS6F7EKC7cjs.isDev.call(void 0, );
     if (isDevEnv && config.runnerKind === "serverless") {
       if ((inputConfig == null ? void 0 : inputConfig.runEngine) === void 0) config.runEngine = true;
       if ((inputConfig == null ? void 0 : inputConfig.autoConfigureServerless) === void 0)
@@ -1892,7 +1958,7 @@ var Registry = class {
     }
   }
   #legacyStartServerless(config, _inputConfig) {
-    const client = _chunkUAX5E3EUcjs.createClient.call(void 0, {
+    const client = _chunkWYZLRPQMcjs.createClient.call(void 0, {
       endpoint: config.endpoint,
       token: config.token,
       namespace: config.namespace,
@@ -1905,7 +1971,7 @@ var Registry = class {
   }
   #legacyStartNormal(config) {
     this.#ensureRuntime().then((runtime) => runtime.startRunner());
-    const client = _chunkUAX5E3EUcjs.createClient.call(void 0, {
+    const client = _chunkWYZLRPQMcjs.createClient.call(void 0, {
       endpoint: config.endpoint,
       token: config.token,
       namespace: config.namespace,
@@ -1927,4 +1993,4 @@ function setup(input) {
 
 
 exports.actor = actor; exports.createEngineDriver = createEngineDriver; exports.Registry = Registry; exports.setup = setup;
-//# sourceMappingURL=chunk-7E3RWMR6.cjs.map
+//# sourceMappingURL=chunk-4UHJ3ADW.cjs.map