rivetkit 2.1.1 → 2.1.2

package/dist/tsup/{chunk-65RINRXE.cjs.map → chunk-772NPMTY.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/rivet/rivet/rivetkit-typescript/packages/rivetkit/dist/tsup/chunk-65RINRXE.cjs","../../src/actor/mod.ts","../../src/drivers/engine/actor-driver.ts","../../src/drivers/engine/log.ts","../../src/drivers/engine/config.ts","../../src/drivers/engine/mod.ts","../../src/registry/config/legacy-runner.ts","../../runtime/index.ts","../../src/drivers/default.ts","../../src/engine-process/log.ts","../../src/engine-process/mod.ts","../../src/inspector/utils.ts","../../src/serverless/log.ts","../../src/serverless/configure.ts","../../src/registry/log.ts","../../src/registry/serve.ts","../../src/serverless/router.ts","../../src/manager/router-schema.ts","../../src/registry/index.ts"],"names":["event","queue","_b","invariant"],"mappings":"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","file":"/home/runner/work/rivet/rivet/rivetkit-typescript/packages/rivetkit/dist/tsup/chunk-65RINRXE.cjs","sourcesContent":[null,"import {\n\ttype Actions,\n\ttype ActorConfig,\n\ttype ActorConfigInput,\n\tActorConfigSchema,\n\tActorTypes,\n} from \"./config\";\nimport type { AnyDatabaseProvider } from \"./database\";\nimport { ActorDefinition } from \"./definition\";\nimport { event as schemaEvent, queue as schemaQueue } from \"./schema\";\nimport type { EventSchemaConfig, QueueSchemaConfig } from \"./schema\";\n\nexport function actor<\n\tTState,\n\tTConnParams,\n\tTConnState,\n\tTVars,\n\tTInput,\n\tTDatabase extends AnyDatabaseProvider,\n\tTEvents extends EventSchemaConfig = Record<never, never>,\n\tTQueues extends QueueSchemaConfig = Record<never, never>,\n\tTActions extends Actions<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues\n\t> = Actions<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues\n\t>,\n>(\n\tinput: ActorConfigInput<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues,\n\t\tTActions\n\t>,\n): ActorDefinition<\n\tTState,\n\tTConnParams,\n\tTConnState,\n\tTVars,\n\tTInput,\n\tTDatabase,\n\tTEvents,\n\tTQueues,\n\tTActions\n> {\n\tconst config = ActorConfigSchema.parse(input) as ActorConfig<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues\n\t>;\n\treturn new ActorDefinition(config);\n}\nexport type { Encoding } from \"@/actor/protocol/serde\";\nexport {\n\tALLOWED_PUBLIC_HEADERS,\n\tPATH_CONNECT,\n\tPATH_WEBSOCKET_PREFIX,\n} from \"@/common/actor-router-consts\";\nexport type {\n\tUniversalErrorEvent,\n\tUniversalEvent,\n\tUniversalEventSource,\n\tUniversalMessageEvent,\n} from \"@/common/eventsource-interface\";\nexport type {\n\tRivetCloseEvent,\n\tRivetEvent,\n\tRivetMessageEvent,\n\tUniversalWebSocket,\n} from \"@/common/websocket-interface\";\nexport type { ActorKey } from \"@/manager/protocol/query\";\nexport type * from \"./config\";\nexport type { AnyConn, Conn } from \"./conn/mod\";\nexport type { ActorDefinition, AnyActorDefinition } from \"./definition\";\nexport { lookupInRegistry } from \"./definition\";\nexport { UserError, type UserErrorOptions } from \"./errors\";\nexport { KEYS as KV_KEYS } from \"./instance/keys\";\nexport { ActorKv } from \"./instance/kv\";\nexport type { AnyActorInstance } from \"./instance/mod\";\nexport {\n\ttype ActorRouter,\n\tcreateActorRouter,\n} from \"./router\";\nexport { routeWebSocket } from \"./router-websocket-endpoints\";\nexport type { Type } from \"./schema\";\nexport const event = schemaEvent;\nexport const queue = schemaQueue;\n","import type {\n\tActorConfig as EngineActorConfig,\n\tRunnerConfig as EngineRunnerConfig,\n\tHibernatingWebSocketMetadata,\n} from \"@rivetkit/engine-runner\";\nimport { idToStr, Runner } from \"@rivetkit/engine-runner\";\nimport * as cbor from \"cbor-x\";\nimport type { Context as HonoContext } from \"hono\";\nimport { streamSSE } from \"hono/streaming\";\nimport { WSContext, type WSContextInit } from \"hono/ws\";\nimport invariant from \"invariant\";\nimport { type AnyConn, CONN_STATE_MANAGER_SYMBOL } from \"@/actor/conn/mod\";\nimport { lookupInRegistry } from \"@/actor/definition\";\nimport { KEYS } from \"@/actor/instance/keys\";\nimport { deserializeActorKey } from \"@/actor/keys\";\nimport { getValueLength } from \"@/actor/protocol/old\";\nimport { type ActorRouter, createActorRouter } from \"@/actor/router\";\nimport {\n\tparseWebSocketProtocols,\n\trouteWebSocket,\n\ttruncateRawWebSocketPathPrefix,\n\ttype UpgradeWebSocketArgs,\n} from \"@/actor/router-websocket-endpoints\";\nimport type { Client } from \"@/client/client\";\nimport {\n\tPATH_CONNECT,\n\tPATH_INSPECTOR_CONNECT,\n\tPATH_WEBSOCKET_BASE,\n\tPATH_WEBSOCKET_PREFIX,\n} from \"@/common/actor-router-consts\";\nimport { getLogger } from \"@/common/log\";\nimport type {\n\tRivetMessageEvent,\n\tUniversalWebSocket,\n} from \"@/common/websocket-interface\";\nimport {\n\ttype ActorDriver,\n\ttype AnyActorInstance,\n\tgetInitialActorKvState,\n\ttype ManagerDriver,\n} from \"@/driver-helpers/mod\";\nimport { buildActorNames, type RegistryConfig } from \"@/registry/config\";\nimport { getEndpoint } from \"@/remote-manager-driver/api-utils\";\nimport {\n\ttype LongTimeoutHandle,\n\tpromiseWithResolvers,\n\tsetLongTimeout,\n\tstringifyError,\n\tVERSION,\n} from \"@/utils\";\nimport { logger } from \"./log\";\n\nconst RUNNER_SSE_PING_INTERVAL = 1000;\n\n// Message ack deadline is 30s on the gateway, but we will ack more frequently\n// in order to minimize the message buffer size on the gateway and to give\n// generous breathing room for the timeout.\n//\n// See engine/packages/pegboard-gateway/src/shared_state.rs\n// (HWS_MESSAGE_ACK_TIMEOUT)\nconst CONN_MESSAGE_ACK_DEADLINE = 5_000;\n\n// Force saveState when cumulative message size reaches this threshold (0.5 MB)\n//\n// See engine/packages/pegboard-gateway/src/shared_state.rs\n// (HWS_MAX_PENDING_MSGS_SIZE_PER_REQ)\nconst CONN_BUFFERED_MESSAGE_SIZE_THRESHOLD = 500_000;\n\ninterface ActorHandler {\n\tactor?: AnyActorInstance;\n\tactorStartPromise?: ReturnType<typeof promiseWithResolvers<void>>;\n\talarmTimeout?: LongTimeoutHandle;\n}\n\nexport type DriverContext = {};\n\nexport class EngineActorDriver implements ActorDriver {\n\t#config: RegistryConfig;\n\t#managerDriver: ManagerDriver;\n\t#inlineClient: Client<any>;\n\t#runner: Runner;\n\t#actors: Map<string, ActorHandler> = new Map();\n\t#actorRouter: ActorRouter;\n\n\t#runnerStarted: PromiseWithResolvers<undefined> = promiseWithResolvers((reason) => logger().warn({ msg: \"unhandled runner started promise rejection\", reason }));\n\t#runnerStopped: PromiseWithResolvers<undefined> = promiseWithResolvers((reason) => logger().warn({ msg: \"unhandled runner stopped promise rejection\", reason }));\n\t#isRunnerStopped: boolean = false;\n\n\t// HACK: Track actor stop intent locally since the runner protocol doesn't\n\t// pass the stop reason to onActorStop. This will be fixed when the runner\n\t// protocol is updated to send the intent directly (see RVT-5284)\n\t#actorStopIntent: Map<string, \"sleep\" | \"destroy\"> = new Map();\n\n\t// Map of conn IDs to message index waiting to be persisted before sending\n\t// an ack\n\t//\n\t// serverMessageIndex is updated and pendingAck is flagged in needed in\n\t// onBeforePersistConnect, then the HWS ack message is sent in\n\t// onAfterPersistConn. This allows us to track what's about to be written\n\t// to storage to prevent race conditions with the serverMessageIndex being\n\t// updated while writing the existing state.\n\t//\n\t// bufferedMessageSize tracks the total bytes received since last persist\n\t// to force a saveState when threshold is reached. This is the amount of\n\t// data currently buffered on the gateway.\n\t#hwsMessageIndex = new Map<\n\t\tstring,\n\t\t{\n\t\t\tserverMessageIndex: number;\n\t\t\tbufferedMessageSize: number;\n\t\t\tpendingAckFromMessageIndex: boolean;\n\t\t\tpendingAckFromBufferSize: boolean;\n\t\t}\n\t>();\n\n\tconstructor(\n\t\tconfig: RegistryConfig,\n\t\tmanagerDriver: ManagerDriver,\n\t\tinlineClient: Client<any>,\n\t) {\n\t\tthis.#config = config;\n\t\tthis.#managerDriver = managerDriver;\n\t\tthis.#inlineClient = inlineClient;\n\n\t\t// HACK: Override inspector token (which are likely to be\n\t\t// removed later on) with token from x-rivet-token header\n\t\tconst token = config.token;\n\t\t// TODO:\n\t\t// if (token && runConfig.inspector && runConfig.inspector.enabled) {\n\t\t// \trunConfig.inspector.token = () => token;\n\t\t// }\n\n\t\tthis.#actorRouter = createActorRouter(\n\t\t\tconfig,\n\t\t\tthis,\n\t\t\tundefined,\n\t\t\tconfig.test.enabled,\n\t\t);\n\n\t\t// Create runner configuration\n\t\tconst engineRunnerConfig: EngineRunnerConfig = {\n\t\t\tversion: config.runner.version,\n\t\t\tendpoint: getEndpoint(config),\n\t\t\ttoken,\n\t\t\tnamespace: config.namespace,\n\t\t\ttotalSlots: config.runner.totalSlots,\n\t\t\trunnerName: config.runner.runnerName,\n\t\t\trunnerKey: config.runner.runnerKey ?? crypto.randomUUID(),\n\t\t\tmetadata: {\n\t\t\t\trivetkit: { version: VERSION },\n\t\t\t},\n\t\t\tprepopulateActorNames: buildActorNames(config),\n\t\t\tonConnected: () => {\n\t\t\t\tthis.#runnerStarted.resolve(undefined);\n\t\t\t},\n\t\t\tonDisconnected: (_code, _reason) => {},\n\t\t\tonShutdown: () => {\n\t\t\t\tthis.#runnerStopped.resolve(undefined);\n\t\t\t\tthis.#isRunnerStopped = true;\n\t\t\t},\n\t\t\tfetch: this.#runnerFetch.bind(this),\n\t\t\twebsocket: this.#runnerWebSocket.bind(this),\n\t\t\thibernatableWebSocket: {\n\t\t\t\tcanHibernate: this.#hwsCanHibernate.bind(this),\n\t\t\t},\n\t\t\tonActorStart: this.#runnerOnActorStart.bind(this),\n\t\t\tonActorStop: this.#runnerOnActorStop.bind(this),\n\t\t\tlogger: getLogger(\"engine-runner\"),\n\t\t};\n\n\t\t// Create and start runner\n\t\tthis.#runner = new Runner(engineRunnerConfig);\n\t\tthis.#runner.start();\n\t\tlogger().debug({\n\t\t\tmsg: \"engine runner started\",\n\t\t\tendpoint: config.endpoint,\n\t\t\tnamespace: config.namespace,\n\t\t\trunnerName: config.runner.runnerName,\n\t\t});\n\t}\n\n\tgetExtraActorLogParams(): Record<string, string> {\n\t\treturn { runnerId: this.#runner.runnerId ?? \"-\" };\n\t}\n\n\tasync #loadActorHandler(actorId: string): Promise<ActorHandler> {\n\t\t// Check if actor is already loaded\n\t\tconst handler = this.#actors.get(actorId);\n\t\tif (!handler)\n\t\t\tthrow new Error(`Actor handler does not exist ${actorId}`);\n\t\tif (handler.actorStartPromise) await handler.actorStartPromise.promise;\n\t\tif (!handler.actor) throw new Error(\"Actor should be loaded\");\n\t\treturn handler;\n\t}\n\n\tgetContext(actorId: string): DriverContext {\n\t\treturn {};\n\t}\n\n\tasync setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void> {\n\t\tconst handler = this.#actors.get(actor.id);\n\t\tif (!handler) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"no handler for actor to set alarm\",\n\t\t\t});\n\n\t\t\treturn;\n\t\t}\n\n\t\t// Clear prev timeout\n\t\tif (handler.alarmTimeout) {\n\t\t\thandler.alarmTimeout.abort();\n\t\t\thandler.alarmTimeout = undefined;\n\t\t}\n\n\t\t// Set alarm\n\t\tconst delay = Math.max(0, timestamp - Date.now());\n\t\thandler.alarmTimeout = setLongTimeout(() => {\n\t\t\tactor.onAlarm();\n\t\t\thandler.alarmTimeout = undefined;\n\t\t}, delay);\n\n\t\t// TODO: This call may not be needed on ActorInstance.start, but it does help ensure that the local state is synced with the alarm state\n\t\t// Set alarm on Rivet\n\t\t//\n\t\t// This does not call an \"alarm\" event like Durable Objects.\n\t\t// Instead, it just wakes the actor on the alarm (if not\n\t\t// already awake).\n\t\t//\n\t\t// onAlarm is automatically called on `ActorInstance.start` when waking\n\t\t// again.\n\t\tthis.#runner.setAlarm(actor.id, timestamp);\n\t}\n\n\t// No database overrides - will use KV-backed implementation from rivetkit/db\n\n\t// MARK: - Batch KV operations\n\tasync kvBatchPut(\n\t\tactorId: string,\n\t\tentries: [Uint8Array, Uint8Array][],\n\t): Promise<void> {\n\t\tawait this.#runner.kvPut(actorId, entries);\n\t}\n\n\tasync kvBatchGet(\n\t\tactorId: string,\n\t\tkeys: Uint8Array[],\n\t): Promise<(Uint8Array | null)[]> {\n\t\treturn await this.#runner.kvGet(actorId, keys);\n\t}\n\n\tasync kvBatchDelete(actorId: string, keys: Uint8Array[]): Promise<void> {\n\t\tawait this.#runner.kvDelete(actorId, keys);\n\t}\n\n\tasync kvList(actorId: string): Promise<Uint8Array[]> {\n\t\tconst entries = await this.#runner.kvListPrefix(\n\t\t\tactorId,\n\t\t\tnew Uint8Array(),\n\t\t);\n\t\tconst keys = entries.map(([key]) => key);\n\t\tlogger().info({\n\t\t\tmsg: \"kvList called\",\n\t\t\tactorId,\n\t\t\tkeysCount: keys.length,\n\t\t\tkeys: keys.map((k) => new TextDecoder().decode(k)),\n\t\t});\n\t\treturn keys;\n\t}\n\n\tasync kvListPrefix(\n\t\tactorId: string,\n\t\tprefix: Uint8Array,\n\t): Promise<[Uint8Array, Uint8Array][]> {\n\t\tconst result = await this.#runner.kvListPrefix(actorId, prefix);\n\t\tlogger().info({\n\t\t\tmsg: \"kvListPrefix called\",\n\t\t\tactorId,\n\t\t\tprefixStr: new TextDecoder().decode(prefix),\n\t\t\tentriesCount: result.length,\n\t\t\tkeys: result.map(([key]) => new TextDecoder().decode(key)),\n\t\t});\n\t\treturn result;\n\t}\n\n\t// MARK: - Actor Lifecycle\n\tasync loadActor(actorId: string): Promise<AnyActorInstance> {\n\t\tconst handler = await this.#loadActorHandler(actorId);\n\t\tif (!handler.actor) throw new Error(`Actor ${actorId} failed to load`);\n\t\treturn handler.actor;\n\t}\n\n\tstartSleep(actorId: string) {\n\t\t// HACK: Track intent for onActorStop (see RVT-5284)\n\t\tthis.#actorStopIntent.set(actorId, \"sleep\");\n\t\tthis.#runner.sleepActor(actorId);\n\t}\n\n\tstartDestroy(actorId: string) {\n\t\t// HACK: Track intent for onActorStop (see RVT-5284)\n\t\tthis.#actorStopIntent.set(actorId, \"destroy\");\n\t\tthis.#runner.stopActor(actorId);\n\t}\n\n\tasync shutdownRunner(immediate: boolean): Promise<void> {\n\t\tlogger().info({ msg: \"stopping engine actor driver\", immediate });\n\n\t\t// TODO: We need to update the runner to have a draining state so:\n\t\t// 1. Send ToServerDraining\n\t\t//\t\t- This causes Pegboard to stop allocating actors to this runner\n\t\t// 2. Pegboard sends ToClientStopActor for all actors on this runner which handles the graceful migration of each actor independently\n\t\t// 3. Send ToServerStopping once all actors have successfully stopped\n\t\t//\n\t\t// What's happening right now is:\n\t\t// 1. All actors enter stopped state\n\t\t// 2. Actors still respond to requests because only RivetKit knows it's\n\t\t//    stopping, this causes all requests to issue errors that the actor is\n\t\t//    stopping. (This will NOT return a 503 bc the runner has no idea the\n\t\t//    actors are stopping.)\n\t\t// 3. Once the last actor stops, then the runner finally stops + actors\n\t\t//    reschedule\n\t\t//\n\t\t// This means that:\n\t\t// - All actors on this runner are bricked until the slowest onStop finishes\n\t\t// - Guard will not gracefully handle requests bc it's not receiving a 503\n\t\t// - Actors can still be scheduled to this runner while the other\n\t\t//   actors are stopping, meaning that those actors will NOT get onStop\n\t\t//   and will potentiall corrupt their state\n\t\t//\n\t\t// HACK: Stop all actors to allow state to be saved\n\t\t// NOTE: onStop is only supposed to be called by the runner, we're\n\t\t// abusing it here\n\t\tlogger().debug({\n\t\t\tmsg: \"stopping all actors before shutdown\",\n\t\t\tactorCount: this.#actors.size,\n\t\t});\n\t\tconst stopPromises: Promise<void>[] = [];\n\t\tfor (const [_actorId, handler] of this.#actors.entries()) {\n\t\t\tif (handler.actor) {\n\t\t\t\tstopPromises.push(\n\t\t\t\t\thandler.actor.onStop(\"sleep\").catch((err) => {\n\t\t\t\t\t\thandler.actor?.rLog.error({\n\t\t\t\t\t\t\tmsg: \"onStop errored\",\n\t\t\t\t\t\t\terror: stringifyError(err),\n\t\t\t\t\t\t});\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tawait Promise.all(stopPromises);\n\t\tlogger().debug({ msg: \"all actors stopped\" });\n\n\t\tawait this.#runner.shutdown(immediate);\n\t}\n\n\tasync serverlessHandleStart(c: HonoContext): Promise<Response> {\n\t\treturn streamSSE(c, async (stream) => {\n\t\t\t// NOTE: onAbort does not work reliably\n\t\t\tstream.onAbort(() => {});\n\t\t\tc.req.raw.signal.addEventListener(\"abort\", () => {\n\t\t\t\tlogger().debug(\"SSE aborted, shutting down runner\");\n\n\t\t\t\t// We cannot assume that the request will always be closed gracefully by Rivet. We always proceed with a graceful shutdown in case the request was terminated for any other reason.\n\t\t\t\t//\n\t\t\t\t// If we did not use a graceful shutdown, the runner would\n\t\t\t\tthis.shutdownRunner(false);\n\t\t\t});\n\n\t\t\tawait this.#runnerStarted.promise;\n\n\t\t\t// Runner id should be set if the runner started\n\t\t\tconst payload = this.#runner.getServerlessInitPacket();\n\t\t\tinvariant(payload, \"runnerId not set\");\n\t\t\tawait stream.writeSSE({ data: payload });\n\n\t\t\t// Send ping every second to keep the connection alive\n\t\t\twhile (true) {\n\t\t\t\tif (this.#isRunnerStopped) {\n\t\t\t\t\tlogger().debug({\n\t\t\t\t\t\tmsg: \"runner is stopped\",\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (stream.closed || stream.aborted) {\n\t\t\t\t\tlogger().debug({\n\t\t\t\t\t\tmsg: \"runner sse stream closed\",\n\t\t\t\t\t\tclosed: stream.closed,\n\t\t\t\t\t\taborted: stream.aborted,\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tawait stream.writeSSE({ event: \"ping\", data: \"\" });\n\t\t\t\tawait stream.sleep(RUNNER_SSE_PING_INTERVAL);\n\t\t\t}\n\n\t\t\t// Wait for the runner to stop if the SSE stream aborted early for any reason\n\t\t\tawait this.#runnerStopped.promise;\n\t\t});\n\t}\n\n\tasync #runnerOnActorStart(\n\t\tactorId: string,\n\t\tgeneration: number,\n\t\tactorConfig: EngineActorConfig,\n\t): Promise<void> {\n\t\tlogger().debug({\n\t\t\tmsg: \"runner actor starting\",\n\t\t\tactorId,\n\t\t\tname: actorConfig.name,\n\t\t\tkey: actorConfig.key,\n\t\t\tgeneration,\n\t\t});\n\n\t\t// Deserialize input\n\t\tlet input: any;\n\t\tif (actorConfig.input) {\n\t\t\tinput = cbor.decode(actorConfig.input);\n\t\t}\n\n\t\t// Get or create handler\n\t\tlet handler = this.#actors.get(actorId);\n\t\tif (!handler) {\n\t\t\t// IMPORTANT: We must set the handler in the map synchronously before doing any\n\t\t\t// async operations to avoid race conditions where multiple calls might try to\n\t\t\t// create the same handler simultaneously.\n\t\t\thandler = {\n\t\t\t\tactorStartPromise: promiseWithResolvers((reason) => logger().warn({ msg: \"unhandled actor start promise rejection\", reason })),\n\t\t\t};\n\t\t\tthis.#actors.set(actorId, handler);\n\t\t}\n\n\t\tconst name = actorConfig.name as string;\n\t\tinvariant(actorConfig.key, \"actor should have a key\");\n\t\tconst key = deserializeActorKey(actorConfig.key);\n\n\t\ttry {\n\t\t\t// Initialize storage\n\t\t\tconst [persistDataBuffer] = await this.#runner.kvGet(actorId, [\n\t\t\t\tKEYS.PERSIST_DATA,\n\t\t\t]);\n\t\t\tif (persistDataBuffer === null) {\n\t\t\t\tconst initialKvState = getInitialActorKvState(input);\n\t\t\t\tawait this.#runner.kvPut(actorId, initialKvState);\n\t\t\t\tlogger().debug({\n\t\t\t\t\tmsg: \"initialized persist data for new actor\",\n\t\t\t\t\tactorId,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tlogger().debug({\n\t\t\t\t\tmsg: \"found existing persist data for actor\",\n\t\t\t\t\tactorId,\n\t\t\t\t\tdataSize: persistDataBuffer.byteLength,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Create actor instance\n\t\t\tconst definition = lookupInRegistry(this.#config, actorConfig.name);\n\t\t\thandler.actor = await definition.instantiate();\n\n\t\t\t// Start actor\n\t\t\tawait handler.actor.start(\n\t\t\t\tthis,\n\t\t\t\tthis.#inlineClient,\n\t\t\t\tactorId,\n\t\t\t\tname,\n\t\t\t\tkey,\n\t\t\t\t\"unknown\", // TODO: Add regions\n\t\t\t);\n\n\t\t\tlogger().debug({ msg: \"runner actor started\", actorId, name, key });\n\t\t} catch (innerError) {\n\t\t\tconst error = new Error(\n\t\t\t\t`Failed to start actor ${actorId}: ${innerError}`,\n\t\t\t\t{ cause: innerError },\n\t\t\t);\n\t\t\thandler.actorStartPromise?.reject(error);\n\t\t\thandler.actorStartPromise = undefined;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync #runnerOnActorStop(\n\t\tactorId: string,\n\t\tgeneration: number,\n\t): Promise<void> {\n\t\tlogger().debug({ msg: \"runner actor stopping\", actorId, generation });\n\n\t\t// HACK: Retrieve the stop intent we tracked locally (see RVT-5284)\n\t\t// Default to \"sleep\" if no intent was recorded (e.g., if the runner\n\t\t// initiated the stop)\n\t\t//\n\t\t// TODO: This will not work if the actor is destroyed from the API\n\t\t// correctly. Currently, it will use the sleep intent, but it's\n\t\t// actually a destroy intent.\n\t\tconst reason = this.#actorStopIntent.get(actorId) ?? \"sleep\";\n\t\tthis.#actorStopIntent.delete(actorId);\n\n\t\tconst handler = this.#actors.get(actorId);\n\t\tif (handler?.actor) {\n\t\t\ttry {\n\t\t\t\tawait handler.actor.onStop(reason);\n\t\t\t} catch (err) {\n\t\t\t\tlogger().error({\n\t\t\t\t\tmsg: \"error in onStop, proceeding with removing actor\",\n\t\t\t\t\terr: stringifyError(err),\n\t\t\t\t});\n\t\t\t}\n\t\t\tthis.#actors.delete(actorId);\n\t\t}\n\n\t\tlogger().debug({ msg: \"runner actor stopped\", actorId, reason });\n\t}\n\n\t// MARK: - Runner Networking\n\tasync #runnerFetch(\n\t\t_runner: Runner,\n\t\tactorId: string,\n\t\t_gatewayIdBuf: ArrayBuffer,\n\t\t_requestIdBuf: ArrayBuffer,\n\t\trequest: Request,\n\t): Promise<Response> {\n\t\tlogger().debug({\n\t\t\tmsg: \"runner fetch\",\n\t\t\tactorId,\n\t\t\turl: request.url,\n\t\t\tmethod: request.method,\n\t\t});\n\t\treturn await this.#actorRouter.fetch(request, { actorId });\n\t}\n\n\tasync #runnerWebSocket(\n\t\t_runner: Runner,\n\t\tactorId: string,\n\t\twebsocketRaw: any,\n\t\tgatewayIdBuf: ArrayBuffer,\n\t\trequestIdBuf: ArrayBuffer,\n\t\trequest: Request,\n\t\trequestPath: string,\n\t\trequestHeaders: Record<string, string>,\n\t\tisHibernatable: boolean,\n\t\tisRestoringHibernatable: boolean,\n\t): Promise<void> {\n\t\tconst websocket = websocketRaw as UniversalWebSocket;\n\n\t\t// Add a unique ID to track this WebSocket object\n\t\tconst wsUniqueId = `ws_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n\t\t(websocket as any).__rivet_ws_id = wsUniqueId;\n\n\t\tlogger().debug({\n\t\t\tmsg: \"runner websocket\",\n\t\t\tactorId,\n\t\t\turl: request.url,\n\t\t\tisRestoringHibernatable,\n\t\t\twebsocketObjectId: websocketRaw\n\t\t\t\t? Object.prototype.toString.call(websocketRaw)\n\t\t\t\t: \"null\",\n\t\t\twebsocketType: websocketRaw?.constructor?.name,\n\t\t\twsUniqueId,\n\t\t\twebsocketProps: websocketRaw\n\t\t\t\t? Object.keys(websocketRaw).join(\", \")\n\t\t\t\t: \"null\",\n\t\t});\n\n\t\t// Parse configuration from Sec-WebSocket-Protocol header (optional for path-based routing)\n\t\tconst protocols = request.headers.get(\"sec-websocket-protocol\");\n\t\tconst { encoding, connParams } = parseWebSocketProtocols(protocols);\n\n\t\t// Fetch WS handler\n\t\t//\n\t\t// We store the promise since we need to add WebSocket event listeners immediately that will wait for the promise to resolve\n\t\tlet wsHandler: UpgradeWebSocketArgs;\n\t\ttry {\n\t\t\twsHandler = await routeWebSocket(\n\t\t\t\trequest,\n\t\t\t\trequestPath,\n\t\t\t\trequestHeaders,\n\t\t\t\tthis.#config,\n\t\t\t\tthis,\n\t\t\t\tactorId,\n\t\t\t\tencoding,\n\t\t\t\tconnParams,\n\t\t\t\tgatewayIdBuf,\n\t\t\t\trequestIdBuf,\n\t\t\t\tisHibernatable,\n\t\t\t\tisRestoringHibernatable,\n\t\t\t);\n\t\t} catch (err) {\n\t\t\tlogger().error({ msg: \"building websocket handlers errored\", err });\n\t\t\twebsocketRaw.close(1011, \"ws.route_error\");\n\t\t\treturn;\n\t\t}\n\n\t\t// Connect the Hono WS hook to the adapter\n\t\t//\n\t\t// We need to assign to `raw` in order for WSContext to expose it on\n\t\t// `ws.raw`\n\t\t(websocket as WSContextInit).raw = websocket;\n\t\tconst wsContext = new WSContext(websocket);\n\n\t\t// Get connection and actor from wsHandler (may be undefined for inspector endpoint)\n\t\tconst conn = wsHandler.conn;\n\t\tconst actor = wsHandler.actor;\n\t\tconst connStateManager = conn?.[CONN_STATE_MANAGER_SYMBOL];\n\n\t\t// Bind event listeners to Hono WebSocket handlers\n\t\t//\n\t\t// We update the HWS data after calling handlers in order to ensure\n\t\t// that the handler ran successfully. By doing this, we ensure at least\n\t\t// once delivery of events to the event handlers.\n\n\t\t// Log when attaching event listeners\n\t\tlogger().debug({\n\t\t\tmsg: \"attaching websocket event listeners\",\n\t\t\tactorId,\n\t\t\tconnId: conn?.id,\n\t\t\twsUniqueId: (websocket as any).__rivet_ws_id,\n\t\t\tisRestoringHibernatable,\n\t\t\twebsocketType: websocket?.constructor?.name,\n\t\t});\n\n\t\tif (isRestoringHibernatable) {\n\t\t\twsHandler.onRestore?.(wsContext);\n\t\t}\n\n\t\twebsocket.addEventListener(\"open\", (event) => {\n\t\t\twsHandler.onOpen(event, wsContext);\n\t\t});\n\n\t\twebsocket.addEventListener(\"message\", (event: RivetMessageEvent) => {\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"websocket message event listener triggered\",\n\t\t\t\tconnId: conn?.id,\n\t\t\t\tactorId: actor?.id,\n\t\t\t\tmessageIndex: event.rivetMessageIndex,\n\t\t\t\thasWsHandler: !!wsHandler,\n\t\t\t\thasOnMessage: !!wsHandler?.onMessage,\n\t\t\t\tactorIsStopping: actor?.isStopping,\n\t\t\t\twebsocketType: websocket?.constructor?.name,\n\t\t\t\twsUniqueId: (websocket as any).__rivet_ws_id,\n\t\t\t\teventTargetWsId: (event.target as any)?.__rivet_ws_id,\n\t\t\t});\n\n\t\t\t// Check if actor is stopping - if so, don't process new messages.\n\t\t\t// These messages will be reprocessed when the actor wakes up from hibernation.\n\t\t\t// TODO: This will never retransmit the socket and the socket will close\n\t\t\tif (actor?.isStopping) {\n\t\t\t\tlogger().debug({\n\t\t\t\t\tmsg: \"ignoring ws message, actor is stopping\",\n\t\t\t\t\tconnId: conn?.id,\n\t\t\t\t\tactorId: actor?.id,\n\t\t\t\t\tmessageIndex: event.rivetMessageIndex,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Process message\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"calling wsHandler.onMessage\",\n\t\t\t\tconnId: conn?.id,\n\t\t\t\tmessageIndex: event.rivetMessageIndex,\n\t\t\t});\n\t\t\twsHandler.onMessage(event, wsContext);\n\n\t\t\t// Persist message index for hibernatable connections\n\t\t\tconst hibernate = connStateManager?.hibernatableData;\n\n\t\t\tif (hibernate && conn && actor) {\n\t\t\t\tinvariant(\n\t\t\t\t\ttypeof event.rivetMessageIndex === \"number\",\n\t\t\t\t\t\"missing event.rivetMessageIndex\",\n\t\t\t\t);\n\n\t\t\t\t// Persist message index\n\t\t\t\tconst previousMsgIndex = hibernate.serverMessageIndex;\n\t\t\t\thibernate.serverMessageIndex = event.rivetMessageIndex;\n\t\t\t\tlogger().info({\n\t\t\t\t\tmsg: \"persisting message index\",\n\t\t\t\t\tconnId: conn.id,\n\t\t\t\t\tpreviousMsgIndex,\n\t\t\t\t\tnewMsgIndex: event.rivetMessageIndex,\n\t\t\t\t});\n\n\t\t\t\t// Calculate message size and track cumulative size\n\t\t\t\tconst entry = this.#hwsMessageIndex.get(conn.id);\n\t\t\t\tif (entry) {\n\t\t\t\t\t// Track message length\n\t\t\t\t\tconst messageLength = getValueLength(event.data);\n\t\t\t\t\tentry.bufferedMessageSize += messageLength;\n\n\t\t\t\t\tif (\n\t\t\t\t\t\tentry.bufferedMessageSize >=\n\t\t\t\t\t\tCONN_BUFFERED_MESSAGE_SIZE_THRESHOLD\n\t\t\t\t\t) {\n\t\t\t\t\t\t// Reset buffered message size immeidatley (instead\n\t\t\t\t\t\t// of waiting for onAfterPersistConn) since we may\n\t\t\t\t\t\t// receive more messages before onAfterPersistConn\n\t\t\t\t\t\t// is called, which would called saveState\n\t\t\t\t\t\t// immediate multiple times\n\t\t\t\t\t\tentry.bufferedMessageSize = 0;\n\t\t\t\t\t\tentry.pendingAckFromBufferSize = true;\n\n\t\t\t\t\t\t// Save state immediately if approaching buffer threshold\n\t\t\t\t\t\tactor.stateManager.saveState({\n\t\t\t\t\t\t\timmediate: true,\n\t\t\t\t\t\t});\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// Save message index. The maxWait is set to the ack deadline\n\t\t\t\t\t\t// since we ack the message immediately after persisting the index.\n\t\t\t\t\t\t// If cumulative size exceeds threshold, force immediate persist.\n\t\t\t\t\t\t//\n\t\t\t\t\t\t// This will call EngineActorDriver.onAfterPersistConn after\n\t\t\t\t\t\t// persist to send the ack to the gateway.\n\t\t\t\t\t\tactor.stateManager.saveState({\n\t\t\t\t\t\t\tmaxWait: CONN_MESSAGE_ACK_DEADLINE,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// Fallback if entry missing\n\t\t\t\t\tactor.stateManager.saveState({\n\t\t\t\t\t\tmaxWait: CONN_MESSAGE_ACK_DEADLINE,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\n\t\twebsocket.addEventListener(\"close\", (event) => {\n\t\t\twsHandler.onClose(event, wsContext);\n\n\t\t\t// NOTE: Persisted connection is removed when `conn.disconnect`\n\t\t\t// is called by the WebSocket route\n\t\t});\n\n\t\twebsocket.addEventListener(\"error\", (event) => {\n\t\t\twsHandler.onError(event, wsContext);\n\t\t});\n\n\t\t// Log event listener attachment for restored connections\n\t\tif (isRestoringHibernatable) {\n\t\t\tlogger().info({\n\t\t\t\tmsg: \"event listeners attached to restored websocket\",\n\t\t\t\tactorId,\n\t\t\t\tconnId: conn?.id,\n\t\t\t\tgatewayId: idToStr(gatewayIdBuf),\n\t\t\t\trequestId: idToStr(requestIdBuf),\n\t\t\t\twebsocketType: websocket?.constructor?.name,\n\t\t\t\thasMessageListener: !!websocket.addEventListener,\n\t\t\t});\n\t\t}\n\t}\n\n\t// MARK: - Hibernating WebSockets\n\t#hwsCanHibernate(\n\t\tactorId: string,\n\t\tgatewayId: ArrayBuffer,\n\t\trequestId: ArrayBuffer,\n\t\trequest: Request,\n\t): boolean {\n\t\tconst url = new URL(request.url);\n\t\tconst path = url.pathname;\n\n\t\t// Get actor instance from runner to access actor name\n\t\tconst actorInstance = this.#runner.getActor(actorId);\n\t\tif (!actorInstance) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"actor not found in #hwsCanHibernate\",\n\t\t\t\tactorId,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\n\t\t// Load actor handler to access persisted data\n\t\tconst handler = this.#actors.get(actorId);\n\t\tif (!handler) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"actor handler not found in #hwsCanHibernate\",\n\t\t\t\tactorId,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\t\tif (!handler.actor) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"actor not found in #hwsCanHibernate\",\n\t\t\t\tactorId,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\n\t\t// Determine configuration for new WS\n\t\tlogger().debug({\n\t\t\tmsg: \"no existing hibernatable websocket found\",\n\t\t\tgatewayId: idToStr(gatewayId),\n\t\t\trequestId: idToStr(requestId),\n\t\t});\n\t\tif (path === PATH_CONNECT) {\n\t\t\treturn true;\n\t\t} else if (\n\t\t\tpath === PATH_WEBSOCKET_BASE ||\n\t\t\tpath.startsWith(PATH_WEBSOCKET_PREFIX)\n\t\t) {\n\t\t\t// Find actor config\n\t\t\tconst definition = lookupInRegistry(\n\t\t\t\tthis.#config,\n\t\t\t\tactorInstance.config.name,\n\t\t\t);\n\n\t\t\t// Check if can hibernate\n\t\t\tconst canHibernateWebSocket =\n\t\t\t\tdefinition.config.options?.canHibernateWebSocket;\n\t\t\tif (canHibernateWebSocket === true) {\n\t\t\t\treturn true;\n\t\t\t} else if (typeof canHibernateWebSocket === \"function\") {\n\t\t\t\ttry {\n\t\t\t\t\t// Truncate the path to match the behavior on onRawWebSocket\n\t\t\t\t\tconst newPath = truncateRawWebSocketPathPrefix(\n\t\t\t\t\t\turl.pathname,\n\t\t\t\t\t);\n\t\t\t\t\tconst truncatedRequest = new Request(\n\t\t\t\t\t\t`http://actor${newPath}`,\n\t\t\t\t\t\trequest,\n\t\t\t\t\t);\n\n\t\t\t\t\tconst canHibernate =\n\t\t\t\t\t\tcanHibernateWebSocket(truncatedRequest);\n\t\t\t\t\treturn canHibernate;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlogger().error({\n\t\t\t\t\t\tmsg: \"error calling canHibernateWebSocket\",\n\t\t\t\t\t\terror,\n\t\t\t\t\t});\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t} else if (path === PATH_INSPECTOR_CONNECT) {\n\t\t\treturn false;\n\t\t} else {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"unexpected path for getActorHibernationConfig\",\n\t\t\t\tpath,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync #hwsLoadAll(\n\t\tactorId: string,\n\t): Promise<HibernatingWebSocketMetadata[]> {\n\t\tconst actor = await this.loadActor(actorId);\n\t\treturn actor.conns\n\t\t\t.values()\n\t\t\t.map((conn) => {\n\t\t\t\tconst connStateManager = conn[CONN_STATE_MANAGER_SYMBOL];\n\t\t\t\tconst hibernatable = connStateManager.hibernatableData;\n\t\t\t\tif (!hibernatable) return undefined;\n\t\t\t\treturn {\n\t\t\t\t\tgatewayId: hibernatable.gatewayId,\n\t\t\t\t\trequestId: hibernatable.requestId,\n\t\t\t\t\tserverMessageIndex: hibernatable.serverMessageIndex,\n\t\t\t\t\tclientMessageIndex: hibernatable.clientMessageIndex,\n\t\t\t\t\tpath: hibernatable.requestPath,\n\t\t\t\t\theaders: hibernatable.requestHeaders,\n\t\t\t\t} satisfies HibernatingWebSocketMetadata;\n\t\t\t})\n\t\t\t.filter((x) => x !== undefined)\n\t\t\t.toArray();\n\t}\n\n\tasync onBeforeActorStart(actor: AnyActorInstance): Promise<void> {\n\t\t// Resolve promise if waiting\n\t\tconst handler = this.#actors.get(actor.id);\n\t\tinvariant(handler, \"missing actor handler in onBeforeActorReady\");\n\t\thandler.actorStartPromise?.resolve();\n\t\thandler.actorStartPromise = undefined;\n\n\t\t// Restore hibernating requests\n\t\tconst metaEntries = await this.#hwsLoadAll(actor.id);\n\t\tawait this.#runner.restoreHibernatingRequests(actor.id, metaEntries);\n\t}\n\n\tonCreateConn(conn: AnyConn) {\n\t\tconst hibernatable = conn[CONN_STATE_MANAGER_SYMBOL].hibernatableData;\n\t\tif (!hibernatable) return;\n\n\t\tthis.#hwsMessageIndex.set(conn.id, {\n\t\t\tserverMessageIndex: hibernatable.serverMessageIndex,\n\t\t\tbufferedMessageSize: 0,\n\t\t\tpendingAckFromMessageIndex: false,\n\t\t\tpendingAckFromBufferSize: false,\n\t\t});\n\n\t\tlogger().debug({\n\t\t\tmsg: \"created #hwsMessageIndex entry\",\n\t\t\tconnId: conn.id,\n\t\t\tserverMessageIndex: hibernatable.serverMessageIndex,\n\t\t});\n\t}\n\n\tonDestroyConn(conn: AnyConn) {\n\t\tthis.#hwsMessageIndex.delete(conn.id);\n\n\t\tlogger().debug({\n\t\t\tmsg: \"removed #hwsMessageIndex entry\",\n\t\t\tconnId: conn.id,\n\t\t});\n\t}\n\n\tonBeforePersistConn(conn: AnyConn) {\n\t\tconst stateManager = conn[CONN_STATE_MANAGER_SYMBOL];\n\t\tconst hibernatable = stateManager.hibernatableDataOrError();\n\n\t\tconst entry = this.#hwsMessageIndex.get(conn.id);\n\t\tif (!entry) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"missing EngineActorDriver.#hwsMessageIndex entry for conn\",\n\t\t\t\tconnId: conn.id,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\t// There is a newer message index\n\t\tentry.pendingAckFromMessageIndex =\n\t\t\thibernatable.serverMessageIndex > entry.serverMessageIndex;\n\t\tentry.serverMessageIndex = hibernatable.serverMessageIndex;\n\t}\n\n\tonAfterPersistConn(conn: AnyConn) {\n\t\tconst stateManager = conn[CONN_STATE_MANAGER_SYMBOL];\n\t\tconst hibernatable = stateManager.hibernatableDataOrError();\n\n\t\tconst entry = this.#hwsMessageIndex.get(conn.id);\n\t\tif (!entry) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"missing EngineActorDriver.#hwsMessageIndex entry for conn\",\n\t\t\t\tconnId: conn.id,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\t// Ack entry\n\t\tif (\n\t\t\tentry.pendingAckFromMessageIndex ||\n\t\t\tentry.pendingAckFromBufferSize\n\t\t) {\n\t\t\tthis.#runner.sendHibernatableWebSocketMessageAck(\n\t\t\t\thibernatable.gatewayId,\n\t\t\t\thibernatable.requestId,\n\t\t\t\tentry.serverMessageIndex,\n\t\t\t);\n\t\t\tentry.pendingAckFromMessageIndex = false;\n\t\t\tentry.pendingAckFromBufferSize = false;\n\t\t\tentry.bufferedMessageSize = 0;\n\t\t}\n\t}\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"driver-engine\");\n}\n","import { z } from \"zod/v4\";\nimport {\n\tClientConfigSchemaBase,\n\ttransformClientConfig,\n} from \"@/client/config\";\nimport { getRivetRunnerKey } from \"@/utils/env-vars\";\n\n/**\n * Base engine config schema without transforms so it can be merged in to other schemas.\n *\n * We include the client config since this includes the common properties like endpoint, namespace, etc.\n */\nexport const EngineConfigSchemaBase = ClientConfigSchemaBase.extend({\n\t/** Unique key for this runner. Runners connecting a given key will replace any other runner connected with the same key. */\n\trunnerKey: z\n\t\t.string()\n\t\t.optional()\n\t\t.transform((val) => val ?? getRivetRunnerKey()),\n\n\t/** How many actors this runner can run. */\n\ttotalSlots: z.number().default(100_000),\n});\n\nconst EngineConfigSchemaTransformed = EngineConfigSchemaBase.transform(\n\t(config, ctx) => transformEngineConfig(config, ctx),\n);\n\nexport const EngineConfigSchema = EngineConfigSchemaTransformed.default(() =>\n\tEngineConfigSchemaTransformed.parse({}),\n);\n\nexport type EngineConfig = z.infer<typeof EngineConfigSchema>;\nexport type EngineConfigInput = z.input<typeof EngineConfigSchema>;\n\nexport function transformEngineConfig(\n\tconfig: z.infer<typeof EngineConfigSchemaBase>,\n\tctx: z.RefinementCtx,\n) {\n\treturn {\n\t\t...transformClientConfig(config, ctx),\n\t\trunnerKey: config.runnerKey,\n\t};\n}\n","import type { Client } from \"@/client/client\";\nimport { convertRegistryConfigToClientConfig } from \"@/client/config\";\nimport type { ManagerDriver } from \"@/manager/driver\";\nimport { RemoteManagerDriver } from \"@/remote-manager-driver/mod\";\nimport { EngineActorDriver } from \"./actor-driver\";\nimport { RegistryConfig, DriverConfig } from \"@/registry/config\";\n\nexport { EngineActorDriver } from \"./actor-driver\";\nexport {\n\ttype EngineConfig as Config,\n\ttype EngineConfigInput as InputConfig,\n\tEngineConfigSchema as ConfigSchema,\n} from \"./config\";\n\nexport function createEngineDriver(): DriverConfig {\n\treturn {\n\t\tname: \"engine\",\n\t\tdisplayName: \"Engine\",\n\t\tmanager: (config: RegistryConfig) => {\n\t\t\tconst clientConfig = convertRegistryConfigToClientConfig(config);\n\t\t\treturn new RemoteManagerDriver(clientConfig);\n\t\t},\n\t\tactor: (\n\t\t\tconfig: RegistryConfig,\n\t\t\tmanagerDriver: ManagerDriver,\n\t\t\tinlineClient: Client<any>,\n\t\t) => {\n\t\t\treturn new EngineActorDriver(\n\t\t\t\tconfig,\n\t\t\t\tmanagerDriver,\n\t\t\t\tinlineClient,\n\t\t\t);\n\t\t},\n\t\tautoStartActorDriver: true,\n\t};\n}\n","import type { Logger } from \"pino\";\nimport { z } from \"zod/v4\";\nimport type { ActorDriverBuilder } from \"@/actor/driver\";\nimport { LogLevelSchema } from \"@/common/log\";\nimport {\n\tEngineConfigSchemaBase,\n\ttransformEngineConfig,\n} from \"@/drivers/engine/config\";\nimport { InspectorConfigSchema } from \"@/inspector/config\";\nimport type { ManagerDriverBuilder } from \"@/manager/driver\";\nimport type { GetUpgradeWebSocket } from \"@/utils\";\nimport { getEnvUniversal, VERSION } from \"@/utils\";\nimport {\n\tgetRivetRunEngine,\n\tgetRivetRunEngineVersion,\n\tgetRivetRunnerKind,\n\tgetRivetToken,\n} from \"@/utils/env-vars\";\n\nexport const LegacyDriverConfigSchema = z.object({\n\t/** Machine-readable name to identify this driver by. */\n\tname: z.string(),\n\tmanager: z.custom<ManagerDriverBuilder>(),\n\tactor: z.custom<ActorDriverBuilder>(),\n});\n\nexport type LegacyDriverConfig = z.infer<typeof LegacyDriverConfigSchema>;\n\n/** Base config used for the actor config across all platforms. */\nconst LegacyRunnerConfigSchemaUnmerged = z\n\t.object({\n\t\tdriver: LegacyDriverConfigSchema.optional(),\n\n\t\t/** @experimental */\n\t\tmaxIncomingMessageSize: z.number().optional().default(65_536),\n\n\t\t/** @experimental */\n\t\tmaxOutgoingMessageSize: z.number().optional().default(1_048_576),\n\n\t\t/** @experimental */\n\t\tinspector: InspectorConfigSchema,\n\n\t\t/** @experimental */\n\t\tdisableDefaultServer: z.boolean().optional().default(false),\n\n\t\t/** @experimental */\n\t\tdefaultServerPort: z.number().default(6420),\n\n\t\t/** @experimental */\n\t\trunEngine: z\n\t\t\t.boolean()\n\t\t\t.optional()\n\t\t\t.default(() => getRivetRunEngine()),\n\n\t\t/** @experimental */\n\t\trunEngineVersion: z\n\t\t\t.string()\n\t\t\t.optional()\n\t\t\t.default(() => getRivetRunEngineVersion() ?? VERSION),\n\n\t\t/** @experimental */\n\t\toverrideServerAddress: z.string().optional(),\n\n\t\t/** @experimental */\n\t\tdisableActorDriver: z.boolean().optional().default(false),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Whether to run runners normally or have them managed\n\t\t * serverlessly (by the Rivet Engine for example).\n\t\t */\n\t\trunnerKind: z\n\t\t\t.enum([\"serverless\", \"normal\"])\n\t\t\t.optional()\n\t\t\t.default(() =>\n\t\t\t\tgetRivetRunnerKind() === \"serverless\" ? \"serverless\" : \"normal\",\n\t\t\t),\n\t\ttotalSlots: z.number().optional(),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Base path for the router. This is used to prefix all routes.\n\t\t * For example, if the base path is `/api`, then the route `/actors` will be\n\t\t * available at `/api/actors`.\n\t\t */\n\t\tbasePath: z.string().optional().default(\"/\"),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Disable welcome message.\n\t\t * */\n\t\tnoWelcome: z.boolean().optional().default(false),\n\n\t\t/**\n\t\t * @experimental\n\t\t * */\n\t\tlogging: z\n\t\t\t.object({\n\t\t\t\tbaseLogger: z.custom<Logger>().optional(),\n\t\t\t\tlevel: LogLevelSchema.optional(),\n\t\t\t})\n\t\t\t.optional()\n\t\t\t.default(() => ({})),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Automatically configure serverless runners in the engine.\n\t\t * Can only be used when runnerKind is \"serverless\".\n\t\t * If true, uses default configuration. Can also provide custom configuration.\n\t\t */\n\t\tautoConfigureServerless: z\n\t\t\t.union([\n\t\t\t\tz.boolean(),\n\t\t\t\tz.object({\n\t\t\t\t\turl: z.string().optional(),\n\t\t\t\t\theaders: z.record(z.string(), z.string()).optional(),\n\t\t\t\t\tmaxRunners: z.number().optional(),\n\t\t\t\t\tminRunners: z.number().optional(),\n\t\t\t\t\trequestLifespan: z.number().optional(),\n\t\t\t\t\trunnersMargin: z.number().optional(),\n\t\t\t\t\tslotsPerRunner: z.number().optional(),\n\t\t\t\t\tmetadata: z.record(z.string(), z.unknown()).optional(),\n\t\t\t\t}),\n\t\t\t])\n\t\t\t.optional(),\n\n\t\t// This is a function to allow for lazy configuration of upgradeWebSocket on the\n\t\t// fly. This is required since the dependencies that upgradeWebSocket\n\t\t// (specifically Node.js) can sometimes only be specified after the router is\n\t\t// created or must be imported async using `await import(...)`\n\t\tgetUpgradeWebSocket: z.custom<GetUpgradeWebSocket>().optional(),\n\n\t\t/** @experimental */\n\t\ttoken: z\n\t\t\t.string()\n\t\t\t.optional()\n\t\t\t.transform((v) => v || getRivetToken()),\n\t})\n\t.merge(EngineConfigSchemaBase);\n\nconst LegacyRunnerConfigSchemaTransformed =\n\tLegacyRunnerConfigSchemaUnmerged.transform((config, ctx) => ({\n\t\t...config,\n\t\t...transformEngineConfig(config, ctx),\n\t}));\n\nexport const LegacyRunnerConfigSchema =\n\tLegacyRunnerConfigSchemaTransformed.default(() =>\n\t\tLegacyRunnerConfigSchemaTransformed.parse({}),\n\t);\n\nexport type LegacyRunnerConfig = z.infer<typeof LegacyRunnerConfigSchema>;\nexport type LegacyRunnerConfigInput = z.input<typeof LegacyRunnerConfigSchema>;\n","import invariant from \"invariant\";\nimport { createClientWithDriver } from \"@/client/client\";\nimport { configureBaseLogger, configureDefaultLogger } from \"@/common/log\";\nimport { chooseDefaultDriver } from \"@/drivers/default\";\nimport { ENGINE_PORT, ensureEngineProcess } from \"@/engine-process/mod\";\nimport { getInspectorUrl } from \"@/inspector/utils\";\nimport { buildManagerRouter } from \"@/manager/router\";\nimport { configureServerlessRunner } from \"@/serverless/configure\";\nimport type { GetUpgradeWebSocket } from \"@/utils\";\nimport pkg from \"../package.json\" with { type: \"json\" };\nimport {\n\ttype DriverConfig,\n\ttype RegistryActors,\n\ttype RegistryConfig,\n} from \"@/registry/config\";\nimport { logger } from \"../src/registry/log\";\nimport { crossPlatformServe, findFreePort } from \"@/registry/serve\";\nimport { ManagerDriver } from \"@/manager/driver\";\nimport { buildServerlessRouter } from \"@/serverless/router\";\nimport type { Registry } from \"@/registry\";\n\n/** Tracks whether the runtime was started as serverless or runner. */\nexport type StartKind = \"serverless\" | \"runner\";\n\nfunction logLine(label: string, value: string): void {\n\tconst padding = \" \".repeat(Math.max(0, 13 - label.length));\n\tconsole.log(`  - ${label}:${padding}${value}`);\n}\n\n/**\n * Manages the lifecycle of RivetKit.\n *\n * Startup happens in two phases:\n * 1. `Runtime.create()` initializes shared infrastructure like the manager\n *    server and engine process. This runs before we know the deployment mode.\n * 2. `startServerless()` or `startRunner()` configures mode-specific behavior.\n *    These are idempotent and called lazily when the first request arrives\n *    or when explicitly starting a runner.\n */\nexport class Runtime<A extends RegistryActors> {\n\t#registry: Registry<A>;\n\t#config: RegistryConfig;\n\t#driver: DriverConfig;\n\t#managerDriver: ManagerDriver;\n\t#startKind?: StartKind;\n\n\tmanagerPort?: number;\n\t#serverlessRouter?: ReturnType<typeof buildServerlessRouter>[\"router\"];\n\n\tget config() {\n\t\treturn this.#config;\n\t}\n\n\tget driver() {\n\t\treturn this.#driver;\n\t}\n\n\tget managerDriver() {\n\t\treturn this.#managerDriver;\n\t}\n\n\t/** Use Runtime.create() instead */\n\tprivate constructor(\n\t\tregistry: Registry<A>,\n\t\tconfig: RegistryConfig,\n\t\tdriver: DriverConfig,\n\t\tmanagerDriver: ManagerDriver,\n\t\tmanagerPort?: number,\n\t) {\n\t\tthis.#registry = registry;\n\t\tthis.#config = config;\n\t\tthis.#driver = driver;\n\t\tthis.#managerDriver = managerDriver;\n\t\tthis.managerPort = managerPort;\n\t}\n\n\tstatic async create<A extends RegistryActors>(\n\t\tregistry: Registry<A>,\n\t): Promise<Runtime<A>> {\n\t\tlogger().info(\"rivetkit starting\");\n\n\t\tconst config = registry.parseConfig();\n\n\t\tif (config.logging?.baseLogger) {\n\t\t\tconfigureBaseLogger(config.logging.baseLogger);\n\t\t} else {\n\t\t\tconfigureDefaultLogger(config.logging?.level);\n\t\t}\n\n\t\t// This should be unreachable: Zod defaults serveManager to false when\n\t\t// spawnEngine is enabled (since endpoint gets set to ENGINE_ENDPOINT).\n\t\t// We check anyway as a safety net for explicit misconfiguration.\n\t\tinvariant(\n\t\t\t!(config.serverless.spawnEngine && config.serveManager),\n\t\t\t\"cannot specify both spawnEngine and serveManager\",\n\t\t);\n\n\t\tconst driver = chooseDefaultDriver(config);\n\t\tconst managerDriver = driver.manager(config);\n\n\t\t// Start main server. This is either:\n\t\t// - Manager: Run a server in-process on port 6420 that mimics the\n\t\t//   engine's API for development.\n\t\t// - Engine: Download and run the full Rivet engine binary on port\n\t\t//   6420. This is a fallback for platforms that cannot use the manager\n\t\t//   like Next.js.\n\t\t//\n\t\t// We do this before startServerless or startRunner has been called\n\t\t// since the engine API needs to be available on port 6420 before\n\t\t// anything else happens. For example, serverless platforms use\n\t\t// `registry.handler(req)` so `startServerless` is called lazily.\n\t\t// Starting the server preemptively allows for clients to reach 6420\n\t\t// BEFORE `startServerless` is called.\n\t\tlet managerPort: number | undefined;\n\t\tif (config.serverless.spawnEngine) {\n\t\t\tmanagerPort = ENGINE_PORT;\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"spawning engine\",\n\t\t\t\tversion: config.serverless.engineVersion,\n\t\t\t});\n\t\t\tawait ensureEngineProcess({\n\t\t\t\tversion: config.serverless.engineVersion,\n\t\t\t});\n\t\t} else if (config.serveManager) {\n\t\t\tconst configuredManagerPort = config.managerPort;\n\t\t\tlet upgradeWebSocket: any;\n\t\t\tconst getUpgradeWebSocket: GetUpgradeWebSocket = () =>\n\t\t\t\tupgradeWebSocket;\n\t\t\tmanagerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);\n\n\t\t\tconst { router: managerRouter } = buildManagerRouter(\n\t\t\t\tconfig,\n\t\t\t\tmanagerDriver,\n\t\t\t\tgetUpgradeWebSocket,\n\t\t\t);\n\n\t\t\tmanagerPort = await findFreePort(config.managerPort);\n\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"serving manager\",\n\t\t\t\tport: managerPort,\n\t\t\t});\n\n\t\t\t// `publicEndpoint` is derived from `config.managerPort` during config parsing,\n\t\t\t// but we may have chosen a different free port at runtime. Keep them in sync\n\t\t\t// so browser clients that rely on `/metadata` connect to the correct manager.\n\t\t\t//\n\t\t\t// Only rewrite when `publicEndpoint` is still on the default localhost pattern,\n\t\t\t// to avoid clobbering explicitly-configured public endpoints.\n\t\t\tif (\n\t\t\t\tconfig.publicEndpoint ===\n\t\t\t\t`http://127.0.0.1:${configuredManagerPort}`\n\t\t\t) {\n\t\t\t\tconfig.publicEndpoint = `http://127.0.0.1:${managerPort}`;\n\t\t\t\tconfig.serverless.publicEndpoint = config.publicEndpoint;\n\t\t\t}\n\t\t\tconfig.managerPort = managerPort;\n\n\t\t\tconst out = await crossPlatformServe(\n\t\t\t\tconfig,\n\t\t\t\tmanagerPort,\n\t\t\t\tmanagerRouter,\n\t\t\t);\n\t\t\tupgradeWebSocket = out.upgradeWebSocket;\n\t\t}\n\n\t\t// Create runtime\n\t\tconst runtime = new Runtime(\n\t\t\tregistry,\n\t\t\tconfig,\n\t\t\tdriver,\n\t\t\tmanagerDriver,\n\t\t\tmanagerPort,\n\t\t);\n\n\t\t// Log ready\n\t\tconst driverLog = managerDriver.extraStartupLog?.() ?? {};\n\t\tlogger().info({\n\t\t\tmsg: \"rivetkit ready\",\n\t\t\tdriver: driver.name,\n\t\t\tdefinitions: Object.keys(config.use).length,\n\t\t\t...driverLog,\n\t\t});\n\n\t\treturn runtime;\n\t}\n\n\tstartServerless(): void {\n\t\tif (this.#startKind === \"serverless\") return;\n\t\tinvariant(!this.#startKind, \"Runtime already started as runner\");\n\t\tthis.#startKind = \"serverless\";\n\n\t\tthis.#serverlessRouter = buildServerlessRouter(\n\t\t\tthis.#driver,\n\t\t\tthis.#config,\n\t\t).router;\n\n\t\tthis.#printWelcome();\n\n\t\tif (this.#config.serverless.configureRunnerPool) {\n\t\t\t// biome-ignore lint/nursery/noFloatingPromises: intentional\n\t\t\tconfigureServerlessRunner(this.#config);\n\t\t}\n\t}\n\n\tstartRunner(): void {\n\t\tif (this.#startKind === \"runner\") return;\n\t\tinvariant(!this.#startKind, \"Runtime already started as serverless\");\n\t\tthis.#startKind = \"runner\";\n\n\t\tif (this.#config.runner && this.#driver.autoStartActorDriver) {\n\t\t\tlogger().debug(\"starting actor driver\");\n\t\t\tconst inlineClient = createClientWithDriver<Registry<A>>(\n\t\t\t\tthis.#managerDriver,\n\t\t\t);\n\t\t\tthis.#driver.actor(this.#config, this.#managerDriver, inlineClient);\n\t\t}\n\n\t\tthis.#printWelcome();\n\t}\n\n\t#printWelcome(): void {\n\t\tif (this.#config.noWelcome) return;\n\n\t\tconst inspectorUrl = this.managerPort\n\t\t\t? getInspectorUrl(this.#config, this.managerPort)\n\t\t\t: undefined;\n\n\t\tconsole.log();\n\t\tconsole.log(\n\t\t\t`  RivetKit ${pkg.version} (${this.#driver.displayName} - ${this.#startKind === \"serverless\" ? \"Serverless\" : \"Runner\"})`,\n\t\t);\n\n\t\t// Show namespace\n\t\tif (this.#config.namespace !== \"default\") {\n\t\t\tlogLine(\"Namespace\", this.#config.namespace);\n\t\t}\n\n\t\t// Show backend endpoint (where we connect to engine)\n\t\tif (this.#config.endpoint) {\n\t\t\tconst endpointType = this.#config.serverless.spawnEngine\n\t\t\t\t? \"local native\"\n\t\t\t\t: this.#config.serveManager\n\t\t\t\t\t? \"local manager\"\n\t\t\t\t\t: \"remote\";\n\t\t\tlogLine(\"Endpoint\", `${this.#config.endpoint} (${endpointType})`);\n\t\t}\n\n\t\t// Show public endpoint (where clients connect)\n\t\tif (this.#startKind === \"serverless\" && this.#config.publicEndpoint) {\n\t\t\tlogLine(\"Client\", this.#config.publicEndpoint);\n\t\t}\n\n\t\t// Show inspector\n\t\tif (inspectorUrl && this.#config.inspector.enabled) {\n\t\t\tlogLine(\"Inspector\", inspectorUrl);\n\t\t}\n\n\t\t// Show actor count\n\t\tconst actorCount = Object.keys(this.#config.use).length;\n\t\tlogLine(\"Actors\", actorCount.toString());\n\n\t\t// Show driver-specific info\n\t\tconst displayInfo = this.#managerDriver.displayInformation();\n\t\tfor (const [k, v] of Object.entries(displayInfo.properties)) {\n\t\t\tlogLine(k, v);\n\t\t}\n\n\t\tconsole.log();\n\t}\n\n\t/** Handle serverless request */\n\thandleServerlessRequest(request: Request): Response | Promise<Response> {\n\t\tinvariant(\n\t\t\tthis.#startKind === \"serverless\",\n\t\t\t\"not started as serverless\",\n\t\t);\n\t\tinvariant(this.#serverlessRouter, \"serverless router not initialized\");\n\t\treturn this.#serverlessRouter.fetch(request);\n\t}\n}\n","import { UserError } from \"@/actor/errors\";\nimport { loggerWithoutContext } from \"@/actor/log\";\nimport { createEngineDriver } from \"@/drivers/engine/mod\";\nimport { createFileSystemOrMemoryDriver } from \"@/drivers/file-system/mod\";\nimport { DriverConfig, RegistryConfig } from \"@/registry/config\";\n\n/**\n * Chooses the appropriate driver based on the run configuration.\n */\nexport function chooseDefaultDriver(\n\tconfig: RegistryConfig,\n): DriverConfig {\n\tif (config.endpoint && config.driver) {\n\t\tthrow new UserError(\n\t\t\t\"Cannot specify both 'endpoint' and 'driver' in configuration\",\n\t\t);\n\t}\n\n\tif (config.driver) {\n\t\treturn config.driver;\n\t}\n\n\tif (config.endpoint || config.token) {\n\t\tloggerWithoutContext().debug({\n\t\t\tmsg: \"using rivet engine driver\",\n\t\t\tendpoint: config.endpoint,\n\t\t});\n\t\treturn createEngineDriver();\n\t}\n\n\tloggerWithoutContext().debug({\n\t\tmsg: \"using default file system driver\",\n\t\tstoragePath: config.storagePath,\n\t});\n\treturn createFileSystemOrMemoryDriver(true, {\n\t\tpath: config.storagePath,\n\t});\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"engine-process\");\n}\n","import {\n\tensureDirectoryExists,\n\tgetStoragePath,\n} from \"@/drivers/file-system/utils\";\nimport {\n\tgetNodeChildProcess,\n\tgetNodeCrypto,\n\tgetNodeFs,\n\tgetNodeFsSync,\n\tgetNodePath,\n\tgetNodeStream,\n\timportNodeDependencies,\n} from \"@/utils/node\";\nimport { logger } from \"./log\";\nimport { ENGINE_ENDPOINT, ENGINE_PORT } from \"./constants\";\n\nexport { ENGINE_ENDPOINT, ENGINE_PORT };\n\nconst ENGINE_BASE_URL = \"https://releases.rivet.dev/rivet\";\nconst ENGINE_BINARY_NAME = \"rivet-engine\";\n\ninterface EnsureEngineProcessOptions {\n\tversion: string;\n}\n\nexport async function ensureEngineProcess(\n\toptions: EnsureEngineProcessOptions,\n): Promise<void> {\n\timportNodeDependencies();\n\n\tlogger().debug({\n\t\tmsg: \"ensuring engine process\",\n\t\tversion: options.version,\n\t});\n\n\tconst path = getNodePath();\n\tconst storageRoot = getStoragePath();\n\tconst binDir = path.join(storageRoot, \"bin\");\n\tconst varDir = path.join(storageRoot, \"var\");\n\tconst logsDir = path.join(varDir, \"logs\", \"rivet-engine\");\n\tawait ensureDirectoryExists(binDir);\n\tawait ensureDirectoryExists(varDir);\n\tawait ensureDirectoryExists(logsDir);\n\n\t// Check if the engine is already running on the port before downloading\n\tif (await isEngineRunning()) {\n\t\ttry {\n\t\t\tconst health = await waitForEngineHealth();\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"engine already running and healthy\",\n\t\t\t\tversion: health.version,\n\t\t\t});\n\t\t\treturn;\n\t\t} catch (error) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"existing engine process not healthy, cannot restart automatically\",\n\t\t\t\terror,\n\t\t\t});\n\t\t\tthrow new Error(\n\t\t\t\t\"Engine process exists but is not healthy. Please manually stop the process on port 6420 and retry.\",\n\t\t\t);\n\t\t}\n\t}\n\n\tconst executableName =\n\t\tprocess.platform === \"win32\"\n\t\t\t? `${ENGINE_BINARY_NAME}-${options.version}.exe`\n\t\t\t: `${ENGINE_BINARY_NAME}-${options.version}`;\n\tconst binaryPath = path.join(binDir, executableName);\n\tawait downloadEngineBinaryIfNeeded(binaryPath, options.version, varDir);\n\t// Create log file streams with timestamp in the filename\n\tconst timestamp = new Date()\n\t\t.toISOString()\n\t\t.replace(/:/g, \"-\")\n\t\t.replace(/\\./g, \"-\");\n\tconst stdoutLogPath = path.join(logsDir, `engine-${timestamp}-stdout.log`);\n\tconst stderrLogPath = path.join(logsDir, `engine-${timestamp}-stderr.log`);\n\n\tconst fsSync = getNodeFsSync();\n\tconst stdoutStream = fsSync.createWriteStream(stdoutLogPath, {\n\t\tflags: \"a\",\n\t});\n\tconst stderrStream = fsSync.createWriteStream(stderrLogPath, {\n\t\tflags: \"a\",\n\t});\n\n\tlogger().debug({\n\t\tmsg: \"creating engine log files\",\n\t\tstdout: stdoutLogPath,\n\t\tstderr: stderrLogPath,\n\t});\n\n\tconst childProcess = getNodeChildProcess();\n\tconst child = childProcess.spawn(binaryPath, [\"start\"], {\n\t\tcwd: path.dirname(binaryPath),\n\t\tstdio: [\"inherit\", \"pipe\", \"pipe\"],\n\t\tenv: {\n\t\t\t...process.env,\n\t\t\t// Development environment overrides for Rivet Engine.\n\t\t\t//\n\t\t\t// NOTE: When modifying these env vars, also update scripts/run/dev-env.sh\n\t\t\t// to keep them in sync for manual engine runs.\n\t\t\t//\n\t\t\t// In development, runners can be terminated without a graceful\n\t\t\t// shutdown (i.e. SIGKILL instead of SIGTERM). This is treated as a\n\t\t\t// crash by Rivet Engine in production and implements a backoff for\n\t\t\t// rescheduling actors in case of a crash loop.\n\t\t\t//\n\t\t\t// This is problematic in development since this will cause actors\n\t\t\t// to become unresponsive if frequently killing your dev server.\n\t\t\t//\n\t\t\t// We reduce the timeouts for resetting a runner as healthy in\n\t\t\t// order to account for this.\n\t\t\tRIVET__PEGBOARD__RETRY_RESET_DURATION: \"100\",\n\t\t\tRIVET__PEGBOARD__BASE_RETRY_TIMEOUT: \"100\",\n\t\t\t// Set max exponent to 1 to have a maximum of base_retry_timeout\n\t\t\tRIVET__PEGBOARD__RESCHEDULE_BACKOFF_MAX_EXPONENT: \"1\",\n\t\t\t// Reduce thresholds for faster development iteration\n\t\t\t//\n\t\t\t// Default ping interval is 3s, this gives a 2s & 4s grace\n\t\t\tRIVET__PEGBOARD__RUNNER_ELIGIBLE_THRESHOLD: \"5000\",\n\t\t\tRIVET__PEGBOARD__RUNNER_LOST_THRESHOLD: \"7000\",\n\t\t\t// Allow faster metadata polling for hot-reload in development (in milliseconds)\n\t\t\tRIVET__PEGBOARD__MIN_METADATA_POLL_INTERVAL: \"1000\",\n\t\t\t// Reduce shutdown durations for faster development iteration (in seconds)\n\t\t\tRIVET__RUNTIME__WORKER_SHUTDOWN_DURATION: \"1\",\n\t\t\tRIVET__RUNTIME__GUARD_SHUTDOWN_DURATION: \"1\",\n\t\t\t// Force exit after this duration (must be > worker and guard shutdown durations)\n\t\t\tRIVET__RUNTIME__FORCE_SHUTDOWN_DURATION: \"2\",\n\t\t},\n\t});\n\n\tif (!child.pid) {\n\t\tthrow new Error(\"failed to spawn rivet engine process\");\n\t}\n\n\t// Pipe stdout and stderr to log files\n\tif (child.stdout) {\n\t\tchild.stdout.pipe(stdoutStream);\n\t}\n\t// Collect stderr for error detection\n\tconst stderrChunks: Buffer[] = [];\n\tif (child.stderr) {\n\t\tchild.stderr.on(\"data\", (chunk: Buffer) => {\n\t\t\tstderrChunks.push(chunk);\n\t\t});\n\t\tchild.stderr.pipe(stderrStream);\n\t}\n\tlogger().debug({\n\t\tmsg: \"spawned engine process\",\n\t\tpid: child.pid,\n\t\tcwd: path.dirname(binaryPath),\n\t});\n\n\tchild.once(\"exit\", (code, signal) => {\n\t\tconst stderrOutput = Buffer.concat(stderrChunks).toString(\"utf-8\");\n\n\t\t// Check for specific error conditions\n\t\tif (stderrOutput.includes(\"LOCK: Resource temporarily unavailable\")) {\n\t\t\tlogger().error({\n\t\t\t\tmsg: \"another instance of rivet engine is unexpectedly running, this is an internal error\",\n\t\t\t\tcode,\n\t\t\t\tsignal,\n\t\t\t\tstdoutLog: stdoutLogPath,\n\t\t\t\tstderrLog: stderrLogPath,\n\t\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t});\n\t\t} else if (stderrOutput.includes(\"Rivet Engine has been rolled back to a previous version\")) {\n\t\t\tlogger().error({\n\t\t\t\tmsg: \"rivet engine version downgrade detected\",\n\t\t\t\thint: `You attempted to downgrade the RivetKit version in development. To fix this, nuke the database by running: '${binaryPath}' database nuke --yes`,\n\t\t\t\tcode,\n\t\t\t\tsignal,\n\t\t\t\tstdoutLog: stdoutLogPath,\n\t\t\t\tstderrLog: stderrLogPath,\n\t\t\t});\n\t\t} else {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"engine process exited, please report this error\",\n\t\t\t\tcode,\n\t\t\t\tsignal,\n\t\t\t\tstdoutLog: stdoutLogPath,\n\t\t\t\tstderrLog: stderrLogPath,\n\t\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t});\n\t\t}\n\t\t// Clean up log streams\n\t\tstdoutStream.end();\n\t\tstderrStream.end();\n\t});\n\n\tchild.once(\"error\", (error) => {\n\t\tlogger().error({\n\t\t\tmsg: \"engine process failed\",\n\t\t\terror,\n\t\t});\n\t\t// Clean up log streams on error\n\t\tstdoutStream.end();\n\t\tstderrStream.end();\n\t});\n\n\t// Wait for engine to be ready\n\tawait waitForEngineHealth();\n\n\tlogger().info({\n\t\tmsg: \"engine process started\",\n\t\tpid: child.pid,\n\t\tversion: options.version,\n\t\tlogs: {\n\t\t\tstdout: stdoutLogPath,\n\t\t\tstderr: stderrLogPath,\n\t\t},\n\t});\n}\n\nasync function downloadEngineBinaryIfNeeded(\n\tbinaryPath: string,\n\tversion: string,\n\tvarDir: string,\n): Promise<void> {\n\tconst binaryExists = await fileExists(binaryPath);\n\tif (binaryExists) {\n\t\tlogger().debug({\n\t\t\tmsg: \"engine binary already cached\",\n\t\t\tversion,\n\t\t\tpath: binaryPath,\n\t\t});\n\t\treturn;\n\t}\n\n\tconst { targetTriplet, extension } = resolveTargetTriplet();\n\tconst remoteFile = `${ENGINE_BINARY_NAME}-${targetTriplet}${extension}`;\n\tconst downloadUrl = `${ENGINE_BASE_URL}/${version}/engine/${remoteFile}`;\n\tlogger().info({\n\t\tmsg: \"downloading engine binary\",\n\t\turl: downloadUrl,\n\t\tpath: binaryPath,\n\t\tversion,\n\t});\n\n\tconst response = await fetch(downloadUrl);\n\tif (!response.ok || !response.body) {\n\t\tthrow new Error(\n\t\t\t`failed to download rivet engine binary from ${downloadUrl}: ${response.status} ${response.statusText}`,\n\t\t);\n\t}\n\n\t// Generate unique temp file name to prevent parallel download conflicts\n\tconst crypto = getNodeCrypto();\n\tconst tempPath = `${binaryPath}.${crypto.randomUUID()}.tmp`;\n\tconst startTime = Date.now();\n\n\tlogger().debug({\n\t\tmsg: \"starting binary download\",\n\t\ttempPath,\n\t\tcontentLength: response.headers.get(\"content-length\"),\n\t});\n\n\t// Warn user if download is taking a long time\n\tconst slowDownloadWarning = setTimeout(() => {\n\t\tlogger().warn({\n\t\t\tmsg: \"engine binary download is taking longer than expected, please be patient\",\n\t\t\tversion,\n\t\t});\n\t}, 5000);\n\n\ttry {\n\t\tconst stream = getNodeStream();\n\t\tconst fsSync = getNodeFsSync();\n\t\tawait stream.pipeline(\n\t\t\tresponse.body as any,\n\t\t\tfsSync.createWriteStream(tempPath),\n\t\t);\n\n\t\t// Clear the slow download warning\n\t\tclearTimeout(slowDownloadWarning);\n\n\t\t// Get file size to verify download\n\t\tconst fs = getNodeFs();\n\t\tconst stats = await fs.stat(tempPath);\n\t\tconst downloadDuration = Date.now() - startTime;\n\n\t\tif (process.platform !== \"win32\") {\n\t\t\tawait fs.chmod(tempPath, 0o755);\n\t\t}\n\t\tawait fs.rename(tempPath, binaryPath);\n\n\t\tlogger().debug({\n\t\t\tmsg: \"engine binary download complete\",\n\t\t\tversion,\n\t\t\tpath: binaryPath,\n\t\t\tsize: stats.size,\n\t\t\tdurationMs: downloadDuration,\n\t\t});\n\t\tlogger().info({\n\t\t\tmsg: \"engine binary downloaded\",\n\t\t\tversion,\n\t\t\tpath: binaryPath,\n\t\t});\n\t} catch (error) {\n\t\t// Clear the slow download warning\n\t\tclearTimeout(slowDownloadWarning);\n\n\t\t// Clean up partial temp file on error\n\t\tlogger().warn({\n\t\t\tmsg: \"engine download failed, please report this error\",\n\t\t\ttempPath,\n\t\t\terror,\n\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t});\n\t\ttry {\n\t\t\tconst fs = getNodeFs();\n\t\t\tawait fs.unlink(tempPath);\n\t\t} catch (unlinkError) {\n\t\t\t// Ignore errors when cleaning up (file may not exist)\n\t\t}\n\t\tthrow error;\n\t}\n}\n//\nfunction resolveTargetTriplet(): { targetTriplet: string; extension: string } {\n\treturn resolveTargetTripletFor(process.platform, process.arch);\n}\n\nexport function resolveTargetTripletFor(\n\tplatform: NodeJS.Platform,\n\tarch: typeof process.arch,\n): { targetTriplet: string; extension: string } {\n\tswitch (platform) {\n\t\tcase \"darwin\":\n\t\t\tif (arch === \"arm64\") {\n\t\t\t\treturn { targetTriplet: \"aarch64-apple-darwin\", extension: \"\" };\n\t\t\t}\n\t\t\tif (arch === \"x64\") {\n\t\t\t\treturn { targetTriplet: \"x86_64-apple-darwin\", extension: \"\" };\n\t\t\t}\n\t\t\tbreak;\n\t\tcase \"linux\":\n\t\t\tif (arch === \"x64\") {\n\t\t\t\treturn {\n\t\t\t\t\ttargetTriplet: \"x86_64-unknown-linux-musl\",\n\t\t\t\t\textension: \"\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tbreak;\n\t\tcase \"win32\":\n\t\t\tif (arch === \"x64\") {\n\t\t\t\treturn {\n\t\t\t\t\ttargetTriplet: \"x86_64-pc-windows-gnu\",\n\t\t\t\t\textension: \".exe\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tbreak;\n\t}\n\n\tthrow new Error(\n\t\t`unsupported platform for rivet engine binary: ${platform}/${arch}`,\n\t);\n}\nasync function isEngineRunning(): Promise<boolean> {\n\t// Check if the engine is running on the port\n\treturn await checkIfEngineAlreadyRunningOnPort(ENGINE_PORT);\n}\n\nasync function checkIfEngineAlreadyRunningOnPort(\n\tport: number,\n): Promise<boolean> {\n\tlet response: Response;\n\ttry {\n\t\tresponse = await fetch(`http://127.0.0.1:${port}/health`);\n\t} catch (err) {\n\t\t// Nothing is running on this port\n\t\treturn false;\n\t}\n\n\tif (response.ok) {\n\t\tconst health = (await response.json()) as EngineHealthResponse;\n\n\t\t// Check what's running on this port\n\t\tif (health.runtime === \"engine\") {\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"rivet engine already running on port\",\n\t\t\t\tport,\n\t\t\t});\n\t\t\treturn true;\n\t\t} else if (health.runtime === \"rivetkit\") {\n\t\t\tlogger().error({\n\t\t\t\tmsg: \"another rivetkit process is already running on port\",\n\t\t\t\tport,\n\t\t\t});\n\t\t\tthrow new Error(\n\t\t\t\t\"RivetKit process already running on port 6420, stop that process and restart this.\",\n\t\t\t);\n\t\t} else {\n\t\t\tthrow new Error(\n\t\t\t\t\"Unknown process running on port 6420, cannot identify what it is.\",\n\t\t\t);\n\t\t}\n\t}\n\n\t// Port responded but not with OK status\n\treturn false;\n}\nasync function fileExists(filePath: string): Promise<boolean> {\n\ttry {\n\t\tconst fs = getNodeFs();\n\t\tawait fs.access(filePath);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nconst HEALTH_MAX_WAIT = 10_000;\nconst HEALTH_INTERVAL = 100;\n\ninterface EngineHealthResponse {\n\tstatus?: string;\n\truntime?: string;\n\tversion?: string;\n}\n\nasync function waitForEngineHealth(): Promise<EngineHealthResponse> {\n\tconst maxRetries = Math.ceil(HEALTH_MAX_WAIT / HEALTH_INTERVAL);\n\n\tlogger().debug({ msg: \"waiting for engine health check\" });\n\n\tfor (let i = 0; i < maxRetries; i++) {\n\t\ttry {\n\t\t\tconst response = await fetch(`${ENGINE_ENDPOINT}/health`, {\n\t\t\t\tsignal: AbortSignal.timeout(1000),\n\t\t\t});\n\t\t\tif (response.ok) {\n\t\t\t\tconst health = (await response.json()) as EngineHealthResponse;\n\t\t\t\tlogger().debug({ msg: \"engine health check passed\" });\n\t\t\t\treturn health;\n\t\t\t}\n\t\t} catch (error) {\n\t\t\t// Expected to fail while engine is starting up\n\t\t\tlogger().debug({ msg: \"engine health check failed\", error });\n\t\t\tif (i === maxRetries - 1) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`engine health check failed after ${maxRetries} retries: ${error}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (i < maxRetries - 1) {\n\t\t\tlogger().trace({\n\t\t\t\tmsg: \"engine not ready, retrying\",\n\t\t\t\tattempt: i + 1,\n\t\t\t\tmaxRetries,\n\t\t\t});\n\t\t\tawait new Promise((resolve) =>\n\t\t\t\tsetTimeout(resolve, HEALTH_INTERVAL),\n\t\t\t);\n\t\t}\n\t}\n\n\tthrow new Error(`engine health check failed after ${maxRetries} retries`);\n}\n","import { createMiddleware } from \"hono/factory\";\nimport type { RegistryConfig } from \"@/registry/config\";\nimport { timingSafeEqual } from \"@/utils/crypto\";\n\nexport const secureInspector = (config: RegistryConfig) =>\n\tcreateMiddleware(async (c, next) => {\n\t\tconst userToken = c.req.header(\"Authorization\")?.replace(\"Bearer \", \"\");\n\t\tif (!userToken) {\n\t\t\treturn c.text(\"Unauthorized\", 401);\n\t\t}\n\n\t\tconst inspectorToken = config.inspector.token();\n\t\tif (!inspectorToken) {\n\t\t\treturn c.text(\"Unauthorized\", 401);\n\t\t}\n\n\t\tif (!timingSafeEqual(userToken, inspectorToken)) {\n\t\t\treturn c.text(\"Unauthorized\", 401);\n\t\t}\n\t\tawait next();\n\t});\n\nexport function getInspectorUrl(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n): string | undefined {\n\tif (!config.inspector.enabled) return undefined;\n\n\tconst base =\n\t\tconfig.inspector.defaultEndpoint ?? `http://127.0.0.1:${managerPort}`;\n\treturn new URL(\"/ui/\", base).href;\n}\n","import { getLogger } from \"@/common//log\";\n\nexport function logger() {\n\treturn getLogger(\"serverless\");\n}\n","import { RegistryConfig } from \"@/registry/config\";\nimport { logger } from \"./log\";\nimport invariant from \"invariant\";\nimport { convertRegistryConfigToClientConfig } from \"@/client/config\";\nimport {\n\tgetDatacenters,\n\tupdateRunnerConfig,\n} from \"@/remote-manager-driver/api-endpoints\";\n\nexport async function configureServerlessRunner(\n\tconfig: RegistryConfig,\n): Promise<void> {\n\tlogger().debug(\"configuring serverless runner\");\n\n\ttry {\n\t\t// Ensure we have required config values\n\t\tif (!config.namespace) {\n\t\t\tthrow new Error(\n\t\t\t\t\"namespace is required for serverless configuration\",\n\t\t\t);\n\t\t}\n\t\tif (!config.endpoint) {\n\t\t\tthrow new Error(\n\t\t\t\t\"endpoint is required for serverless configuration\",\n\t\t\t);\n\t\t}\n\n\t\t// Prepare the configuration\n\t\tconst customConfig = config.serverless.configureRunnerPool;\n\t\tinvariant(customConfig, \"configureRunnerPool should exist\");\n\n\t\tconst clientConfig = convertRegistryConfigToClientConfig(config);\n\n\t\t// Fetch all datacenters\n\t\tlogger().debug({\n\t\t\tmsg: \"fetching datacenters\",\n\t\t\tendpoint: config.endpoint,\n\t\t});\n\t\tconst dcsRes = await getDatacenters(clientConfig);\n\n\t\t// Build the request body\n\t\tconst runnerName = customConfig.name ?? \"default\";\n\t\tlogger().debug({\n\t\t\tmsg: \"configuring serverless runner\",\n\t\t\trunnerName,\n\t\t\tnamespace: config.namespace,\n\t\t});\n\t\tconst serverlessConfig = {\n\t\t\tserverless: {\n\t\t\t\turl: customConfig.url,\n\t\t\t\theaders: customConfig.headers ?? {},\n\t\t\t\tmax_runners: customConfig.maxRunners ?? 1000,\n\t\t\t\tmin_runners: customConfig.minRunners ?? 0,\n\t\t\t\trequest_lifespan: customConfig.requestLifespan ?? 15 * 60,\n\t\t\t\trunners_margin: customConfig.runnersMargin ?? 0,\n\t\t\t\tslots_per_runner: customConfig.slotsPerRunner ?? 1,\n\t\t\t\tmetadata_poll_interval: customConfig.metadataPollInterval ?? 1000,\n\t\t\t},\n\t\t\tmetadata: customConfig.metadata ?? {},\n\t\t\tdrain_on_version_upgrade: customConfig.drainOnVersionUpgrade ?? true,\n\t\t\tmetadataPollInterval: customConfig.metadataPollInterval ?? 1000,\n\t\t};\n\t\tawait updateRunnerConfig(clientConfig, runnerName, {\n\t\t\tdatacenters: Object.fromEntries(\n\t\t\t\tdcsRes.datacenters.map((dc) => [dc.name, serverlessConfig]),\n\t\t\t),\n\t\t});\n\n\t\tlogger().info({\n\t\t\tmsg: \"serverless runner configured successfully\",\n\t\t\trunnerName,\n\t\t\tnamespace: config.namespace,\n\t\t});\n\t} catch (error) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to configure serverless runner, validate endpoint is configured correctly then restart this process\",\n\t\t\terror,\n\t\t});\n\n\t\t// Don't throw, allow the runner to continue\n\t}\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"registry\");\n}\n","import type { Hono } from \"hono\";\nimport { detectRuntime, stringifyError } from \"../utils\";\nimport { logger } from \"./log\";\nimport { RegistryConfig } from \"./config\";\n\n// TODO: Go back to dynamic import for this\nimport getPort from \"get-port\";\n\nconst DEFAULT_PORT = 6420;\n\n/**\n * Finds a free port starting from the given port.\n *\n * Tries ports incrementally until a free one is found.\n */\nexport async function findFreePort(\n\tstartPort: number = DEFAULT_PORT,\n): Promise<number> {\n\t// TODO: Fix this\n\t// const getPortModule = \"get-port\";\n\t// const { default: getPort } = await import(/* webpackIgnore: true */ getPortModule);\n\n\t// Create an iterable of ports starting from startPort\n\tfunction* portRange(start: number, count: number = 100): Iterable<number> {\n\t\tfor (let i = 0; i < count; i++) {\n\t\t\tyield start + i;\n\t\t}\n\t}\n\n\treturn getPort({ port: portRange(startPort) });\n}\n\nexport async function crossPlatformServe(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\tconst runtime = detectRuntime();\n\tlogger().debug({ msg: \"detected runtime for serve\", runtime });\n\n\tswitch (runtime) {\n\t\tcase \"deno\":\n\t\t\treturn serveDeno(config, managerPort, app);\n\t\tcase \"bun\":\n\t\t\treturn serveBun(config, managerPort, app);\n\t\tcase \"node\":\n\t\t\treturn serveNode(config, managerPort, app);\n\t\tdefault:\n\t\t\treturn serveNode(config, managerPort, app);\n\t}\n}\n\nasync function serveNode(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\t// Import @hono/node-server using string variable to prevent static analysis\n\tconst nodeServerModule = \"@hono/node-server\";\n\tlet serve: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\tnodeServerModule\n\t\t);\n\t\tserve = dep.serve;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import @hono/node-server. please run 'npm install @hono/node-server @hono/node-ws'\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\t// Import @hono/node-ws using string variable to prevent static analysis\n\tconst nodeWsModule = \"@hono/node-ws\";\n\tlet createNodeWebSocket: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\tnodeWsModule\n\t\t);\n\t\tcreateNodeWebSocket = dep.createNodeWebSocket;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import @hono/node-ws. please run 'npm install @hono/node-server @hono/node-ws'\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\t// Inject WS\n\tconst { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({\n\t\tapp: app,\n\t});\n\n\t// Start server\n\tconst port = managerPort;\n\tconst hostname = config.managerHost;\n\tconst server = serve({ fetch: app.fetch, port, hostname }, () =>\n\t\tlogger().info({ msg: \"server listening\", port, hostname }),\n\t);\n\tinjectWebSocket(server);\n\n\treturn { upgradeWebSocket };\n}\n\nasync function serveDeno(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\t// Import hono/deno using string variable to prevent static analysis\n\tconst honoDenoModule = \"hono/deno\";\n\tlet upgradeWebSocket: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\thonoDenoModule\n\t\t);\n\t\tupgradeWebSocket = dep.upgradeWebSocket;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import hono/deno\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\tconst port = config.managerPort;\n\tconst hostname = config.managerHost;\n\n\t// Use Deno.serve\n\tDeno.serve({ port, hostname }, app.fetch);\n\tlogger().info({ msg: \"server listening\", port, hostname });\n\n\treturn { upgradeWebSocket };\n}\n\nasync function serveBun(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\t// Import hono/bun using string variable to prevent static analysis\n\tconst honoBunModule = \"hono/bun\";\n\tlet createBunWebSocket: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\thonoBunModule\n\t\t);\n\t\tcreateBunWebSocket = dep.createBunWebSocket;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import hono/bun\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\tconst { websocket, upgradeWebSocket } = createBunWebSocket();\n\n\tconst port = config.managerPort;\n\tconst hostname = config.managerHost;\n\n\t// Use Bun.serve\n\t// @ts-expect-error - Bun global\n\tBun.serve({\n\t\tfetch: app.fetch,\n\t\tport,\n\t\thostname,\n\t\twebsocket,\n\t});\n\tlogger().info({ msg: \"server listening\", port, hostname });\n\n\treturn { upgradeWebSocket };\n}\n","import invariant from \"invariant\";\nimport {\n\tEndpointMismatch,\n\tInvalidRequest,\n\tNamespaceMismatch,\n} from \"@/actor/errors\";\nimport { convertRegistryConfigToClientConfig } from \"@/client/config\";\nimport { handleHealthRequest, handleMetadataRequest } from \"@/common/router\";\nimport { ServerlessStartHeadersSchema } from \"@/manager/router-schema\";\nimport { createClientWithDriver } from \"@/mod\";\nimport type { DriverConfig, RegistryConfig } from \"@/registry/config\";\nimport { RemoteManagerDriver } from \"@/remote-manager-driver/mod\";\nimport { createRouter } from \"@/utils/router\";\nimport { logger } from \"./log\";\n\nexport function buildServerlessRouter(\n\tdriverConfig: DriverConfig,\n\tconfig: RegistryConfig,\n) {\n\treturn createRouter(config.serverless.basePath, (router) => {\n\t\t// GET /\n\t\trouter.get(\"/\", (c) => {\n\t\t\treturn c.text(\n\t\t\t\t\"This is a RivetKit server.\\n\\nLearn more at https://rivetkit.org\",\n\t\t\t);\n\t\t});\n\n\t\t// Serverless start endpoint\n\t\trouter.get(\"/start\", async (c) => {\n\t\t\t// Parse headers\n\t\t\tconst parseResult = ServerlessStartHeadersSchema.safeParse({\n\t\t\t\tendpoint: c.req.header(\"x-rivet-endpoint\"),\n\t\t\t\ttoken: c.req.header(\"x-rivet-token\") ?? undefined,\n\t\t\t\ttotalSlots: c.req.header(\"x-rivet-total-slots\"),\n\t\t\t\trunnerName: c.req.header(\"x-rivet-runner-name\"),\n\t\t\t\tnamespace: c.req.header(\"x-rivet-namespace-name\"),\n\t\t\t});\n\t\t\tif (!parseResult.success) {\n\t\t\t\tthrow new InvalidRequest(\n\t\t\t\t\tparseResult.error.issues[0]?.message ??\n\t\t\t\t\t\t\"invalid serverless start headers\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst { endpoint, token, totalSlots, runnerName, namespace } =\n\t\t\t\tparseResult.data;\n\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"received serverless runner start request\",\n\t\t\t\tendpoint,\n\t\t\t\ttotalSlots,\n\t\t\t\trunnerName,\n\t\t\t\tnamespace,\n\t\t\t});\n\n\t\t\t// Validate endpoint and namespace match config to catch\n\t\t\t// misconfiguration or malicious requests.\n\t\t\t//\n\t\t\t// Only verify if namespace matches if endpoint configured since\n\t\t\t// configuring an endpoint indicates you want to assert the\n\t\t\t// incoming serverless requests.\n\t\t\tif (config.endpoint) {\n\t\t\t\tif (!endpointsMatch(endpoint, config.endpoint)) {\n\t\t\t\t\tthrow new EndpointMismatch(config.endpoint, endpoint);\n\t\t\t\t}\n\n\t\t\t\tif (namespace !== config.namespace) {\n\t\t\t\t\tthrow new NamespaceMismatch(config.namespace, namespace);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Convert config to runner config\n\t\t\tconst newConfig: RegistryConfig = {\n\t\t\t\t...config,\n\t\t\t\tendpoint: endpoint,\n\t\t\t\tnamespace: namespace,\n\t\t\t\ttoken: token,\n\t\t\t\trunner: {\n\t\t\t\t\t...config.runner,\n\t\t\t\t\ttotalSlots: totalSlots,\n\t\t\t\t\trunnerName: runnerName,\n\t\t\t\t\t// Not supported on serverless\n\t\t\t\t\trunnerKey: undefined,\n\t\t\t\t},\n\t\t\t};\n\n\t\t\t// Create manager driver on demand based on the properties provided\n\t\t\t// by headers\n\t\t\t//\n\t\t\t// NOTE: This relies on the `newConfig.runner.runnerName` to\n\t\t\t// configure which runner to create actors on.\n\t\t\tconst managerDriver = new RemoteManagerDriver(\n\t\t\t\tconvertRegistryConfigToClientConfig(newConfig),\n\t\t\t);\n\t\t\tconst client = createClientWithDriver(managerDriver);\n\n\t\t\t// Create new actor driver with updated config\n\t\t\tconst actorDriver = driverConfig.actor(\n\t\t\t\tnewConfig,\n\t\t\t\tmanagerDriver,\n\t\t\t\tclient,\n\t\t\t);\n\t\t\tinvariant(\n\t\t\t\tactorDriver.serverlessHandleStart,\n\t\t\t\t\"missing serverlessHandleStart on ActorDriver\",\n\t\t\t);\n\n\t\t\treturn await actorDriver.serverlessHandleStart(c);\n\t\t});\n\n\t\trouter.get(\"/health\", (c) => handleHealthRequest(c));\n\n\t\trouter.get(\"/metadata\", (c) =>\n\t\t\thandleMetadataRequest(\n\t\t\t\tc,\n\t\t\t\tconfig,\n\t\t\t\t{ serverless: {} },\n\t\t\t\tconfig.publicEndpoint,\n\t\t\t\tconfig.publicNamespace,\n\t\t\t\tconfig.publicToken,\n\t\t\t),\n\t\t);\n\t});\n}\n\n/**\n * Normalizes a URL for comparison by extracting protocol, host, port, and pathname.\n * Normalizes loopback addresses (127.0.0.1, 0.0.0.0, ::1) to localhost for consistent comparison.\n * Normalizes regional endpoints (api-*.domain) to base endpoints (api.domain).\n * Returns null if the URL is invalid.\n */\nexport function normalizeEndpointUrl(url: string): string | null {\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\t// Normalize pathname by removing trailing slash (except for root)\n\t\tconst pathname =\n\t\t\tparsed.pathname === \"/\" ? \"/\" : parsed.pathname.replace(/\\/+$/, \"\");\n\n\t\t// Normalize loopback addresses to localhost\n\t\tlet hostname = isLoopbackAddress(parsed.hostname)\n\t\t\t? \"localhost\"\n\t\t\t: parsed.hostname;\n\n\t\t// Normalize regional endpoints (api-region.domain) to base endpoints (api.domain)\n\t\t// HACK: This is specific to Rivet Cloud and will not work for self-hosted\n\t\t// engines with different regional endpoint naming conventions.\n\t\thostname = normalizeRegionalHostname(hostname);\n\n\t\t// Reconstruct host with normalized hostname and port\n\t\tconst host = parsed.port ? `${hostname}:${parsed.port}` : hostname;\n\n\t\t// Reconstruct normalized URL with protocol, host, and pathname\n\t\treturn `${parsed.protocol}//${host}${pathname}`;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Normalizes regional hostnames (api-region.domain) to base hostnames (api.domain).\n * Only applies to rivet.dev domains.\n *\n * Examples:\n * - api-us-west-1.rivet.dev -> api.rivet.dev\n * - api-lax.staging.rivet.dev -> api.staging.rivet.dev\n * - api.rivet.dev -> api.rivet.dev (unchanged)\n * - api-us-west-1.example.com -> api-us-west-1.example.com (unchanged, not rivet.dev)\n * - foo-bar.rivet.dev -> foo-bar.rivet.dev (unchanged, not api- prefix)\n */\nfunction normalizeRegionalHostname(hostname: string): string {\n\t// Only apply to rivet.dev domains\n\tif (!hostname.endsWith(\".rivet.dev\")) {\n\t\treturn hostname;\n\t}\n\n\tif (!hostname.startsWith(\"api-\")) {\n\t\treturn hostname;\n\t}\n\n\t// Find the first dot after \"api-\"\n\tconst withoutPrefix = hostname.slice(4); // Remove \"api-\"\n\tconst firstDotIndex = withoutPrefix.indexOf(\".\");\n\tif (firstDotIndex === -1) {\n\t\treturn hostname;\n\t}\n\n\t// Extract the domain part and prepend \"api.\"\n\tconst domain = withoutPrefix.slice(firstDotIndex + 1);\n\treturn `api.${domain}`;\n}\n\n/**\n * Compares two endpoint URLs after normalization.\n * Returns true if they match (same protocol, host, port, and path).\n */\nexport function endpointsMatch(a: string, b: string): boolean {\n\tconst normalizedA = normalizeEndpointUrl(a);\n\tconst normalizedB = normalizeEndpointUrl(b);\n\tif (normalizedA === null || normalizedB === null) {\n\t\t// If either URL is invalid, fall back to string comparison\n\t\treturn a === b;\n\t}\n\treturn normalizedA === normalizedB;\n}\n\n/**\n * Checks if a hostname is a loopback address that should be normalized to localhost.\n */\nfunction isLoopbackAddress(hostname: string): boolean {\n\treturn (\n\t\thostname === \"127.0.0.1\" ||\n\t\thostname === \"0.0.0.0\" ||\n\t\thostname === \"::1\" ||\n\t\thostname === \"[::1]\"\n\t);\n}\n","import { z } from \"zod/v4\";\n\nexport const ServerlessStartHeadersSchema = z.object({\n\tendpoint: z.string({\n\t\terror: \"x-rivet-endpoint header is required\",\n\t}),\n\ttoken: z\n\t\t.string({ error: \"x-rivet-token header must be a string\" })\n\t\t.optional(),\n\ttotalSlots: z.coerce\n\t\t.number({\n\t\t\terror: \"x-rivet-total-slots header must be a number\",\n\t\t})\n\t\t.int({ error: \"x-rivet-total-slots header must be an integer\" })\n\t\t.gte(1, { error: \"x-rivet-total-slots header must be positive\" }),\n\trunnerName: z.string({\n\t\terror: \"x-rivet-runner-name header is required\",\n\t}),\n\tnamespace: z.string({\n\t\terror: \"x-rivet-namespace-name header is required\",\n\t}),\n});\n","import type { Client } from \"@/client/client\";\nimport { createClient } from \"@/client/mod\";\nimport { getNodeEnv, isDev } from \"@/utils/env-vars\";\nimport {\n\ttype RegistryActors,\n\ttype RegistryConfig,\n\ttype RegistryConfigInput,\n\tRegistryConfigSchema,\n} from \"./config\";\nimport {\n\ttype LegacyRunnerConfig,\n\ttype LegacyRunnerConfigInput,\n\tLegacyRunnerConfigSchema,\n} from \"./config/legacy-runner\";\nimport { Runtime } from \"../../runtime\";\n\nexport type FetchHandler = (\n\trequest: Request,\n\t...args: any\n) => Response | Promise<Response>;\n\nexport interface ServerlessHandler {\n\tfetch: FetchHandler;\n}\n\nexport interface LegacyStartServerOutput<A extends Registry<any>> {\n\t/** Client to communicate with the actors. */\n\tclient: Client<A>;\n\t/** Fetch handler to manually route requests to the Rivet manager API. */\n\tfetch: FetchHandler;\n}\n\nexport class Registry<A extends RegistryActors> {\n\t#config: RegistryConfigInput<A>;\n\n\tget config(): RegistryConfigInput<A> {\n\t\treturn this.#config;\n\t}\n\n\tparseConfig(): RegistryConfig {\n\t\treturn RegistryConfigSchema.parse(this.#config);\n\t}\n\n\t// Shared runtime instance\n\t#runtime?: Runtime<A>;\n\t#runtimePromise?: Promise<Runtime<A>>;\n\n\tconstructor(config: RegistryConfigInput<A>) {\n\t\tthis.#config = config;\n\n\t\t// Auto-prepare on next tick (gives time for sync config modification)\n\t\tif (getNodeEnv() !== \"test\") {\n\t\t\tsetTimeout(() => {\n\t\t\t\t// biome-ignore lint/nursery/noFloatingPromises: fire-and-forget auto-prepare\n\t\t\t\tthis.#ensureRuntime();\n\t\t\t}, 0);\n\t\t}\n\t}\n\n\t/** Creates runtime if not already created. Idempotent. */\n\t#ensureRuntime(): Promise<Runtime<A>> {\n\t\tif (!this.#runtimePromise) {\n\t\t\tthis.#runtimePromise = Runtime.create(this);\n\t\t\t// biome-ignore lint/nursery/noFloatingPromises: bg task\n\t\t\tthis.#runtimePromise.then((rt) => {\n\t\t\t\tthis.#runtime = rt;\n\t\t\t});\n\t\t}\n\t\treturn this.#runtimePromise;\n\t}\n\n\t/**\n\t * Handle an incoming HTTP request for serverless deployments.\n\t *\n\t * @example\n\t * ```ts\n\t * const app = new Hono();\n\t * app.all(\"/api/rivet/*\", (c) => registry.handler(c.req.raw));\n\t * export default app;\n\t * ```\n\t */\n\tpublic async handler(request: Request): Promise<Response> {\n\t\tconst runtime = await this.#ensureRuntime();\n\t\truntime.startServerless();\n\t\treturn await runtime.handleServerlessRequest(request);\n\t}\n\n\t/**\n\t * Returns a fetch handler for serverless deployments.\n\t *\n\t * @example\n\t * ```ts\n\t * export default registry.serve();\n\t * ```\n\t */\n\tpublic serve(): ServerlessHandler {\n\t\treturn { fetch: this.handler.bind(this) };\n\t}\n\n\t/**\n\t * Starts an actor runner for standalone server deployments.\n\t */\n\tpublic startRunner() {\n\t\t// biome-ignore lint/nursery/noFloatingPromises: bg task\n\t\tthis.#ensureRuntime().then((runtime) => runtime.startRunner());\n\t}\n\n\t// MARK: Legacy\n\t/**\n\t * Runs the registry for a server.\n\t *\n\t * @deprecated Use {@link Registry.startRunner} for long-running servers or {@link Registry.handler} for serverless deployments.\n\t */\n\tpublic start(\n\t\tinputConfig?: LegacyRunnerConfigInput,\n\t): LegacyStartServerOutput<this> {\n\t\tconst config = LegacyRunnerConfigSchema.parse(inputConfig);\n\n\t\t// Validate autoConfigureServerless is only used with serverless runner\n\t\tif (\n\t\t\tconfig.autoConfigureServerless &&\n\t\t\tconfig.runnerKind !== \"serverless\"\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t\"autoConfigureServerless can only be configured when runnerKind is 'serverless'\",\n\t\t\t);\n\t\t}\n\n\t\t// Auto-configure serverless runner if not in prod\n\t\tconst isDevEnv = isDev();\n\t\tif (isDevEnv && config.runnerKind === \"serverless\") {\n\t\t\tif (inputConfig?.runEngine === undefined) config.runEngine = true;\n\t\t\tif (inputConfig?.autoConfigureServerless === undefined)\n\t\t\t\tconfig.autoConfigureServerless = true;\n\t\t}\n\n\t\t// Convert to new config format and call appropriate handler\n\t\tif (config.runnerKind === \"serverless\") {\n\t\t\treturn this.#legacyStartServerless(config, inputConfig);\n\t\t} else {\n\t\t\treturn this.#legacyStartNormal(config);\n\t\t}\n\t}\n\n\t#legacyStartServerless(\n\t\tconfig: LegacyRunnerConfig,\n\t\t_inputConfig: LegacyRunnerConfigInput | undefined,\n\t): LegacyStartServerOutput<this> {\n\t\t// Create client for the legacy return value\n\t\t// For serverless, we don't have an endpoint until /start is called,\n\t\t// so we create a placeholder client\n\t\tconst client = createClient<this>({\n\t\t\tendpoint: config.endpoint,\n\t\t\ttoken: config.token,\n\t\t\tnamespace: config.namespace,\n\t\t\theaders: config.headers,\n\t\t});\n\n\t\treturn {\n\t\t\tclient,\n\t\t\tfetch: this.handler.bind(this),\n\t\t};\n\t}\n\n\t#legacyStartNormal(\n\t\tconfig: LegacyRunnerConfig,\n\t): LegacyStartServerOutput<this> {\n\t\t// Start the runner (fire-and-forget to maintain sync API)\n\t\t// biome-ignore lint/nursery/noFloatingPromises: legacy sync API\n\t\tthis.#ensureRuntime().then((runtime) => runtime.startRunner());\n\n\t\t// Create client for the legacy return value\n\t\tconst client = createClient<this>({\n\t\t\tendpoint: config.endpoint,\n\t\t\ttoken: config.token,\n\t\t\tnamespace: config.namespace,\n\t\t\theaders: config.headers,\n\t\t});\n\n\t\treturn {\n\t\t\tclient,\n\t\t\tfetch: this.handler.bind(this),\n\t\t};\n\t}\n}\n\nexport function setup<A extends RegistryActors>(\n\tinput: RegistryConfigInput<A>,\n): Registry<A> {\n\treturn new Registry(input);\n}\n\nexport type { RegistryConfig, RegistryActors };\nexport { RegistryConfigSchema };\n"]}
+{"version":3,"sources":["/home/runner/work/rivet/rivet/rivetkit-typescript/packages/rivetkit/dist/tsup/chunk-772NPMTY.cjs","../../src/actor/mod.ts","../../src/drivers/engine/actor-driver.ts","../../src/drivers/engine/log.ts","../../src/drivers/engine/config.ts","../../src/drivers/engine/mod.ts","../../src/registry/config/legacy-runner.ts","../../runtime/index.ts","../../src/drivers/default.ts","../../src/engine-process/log.ts","../../src/engine-process/mod.ts","../../src/inspector/utils.ts","../../src/serverless/log.ts","../../src/serverless/configure.ts","../../src/registry/log.ts","../../src/registry/serve.ts","../../src/serverless/router.ts","../../src/manager/router-schema.ts","../../src/registry/index.ts"],"names":["event","queue","_b","invariant"],"mappings":"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","file":"/home/runner/work/rivet/rivet/rivetkit-typescript/packages/rivetkit/dist/tsup/chunk-772NPMTY.cjs","sourcesContent":[null,"import {\n\ttype Actions,\n\ttype ActorConfig,\n\ttype ActorConfigInput,\n\tActorConfigSchema,\n\tActorTypes,\n} from \"./config\";\nimport type { AnyDatabaseProvider } from \"./database\";\nimport { ActorDefinition } from \"./definition\";\nimport { event as schemaEvent, queue as schemaQueue } from \"./schema\";\nimport type { EventSchemaConfig, QueueSchemaConfig } from \"./schema\";\n\nexport function actor<\n\tTState,\n\tTConnParams,\n\tTConnState,\n\tTVars,\n\tTInput,\n\tTDatabase extends AnyDatabaseProvider,\n\tTEvents extends EventSchemaConfig = Record<never, never>,\n\tTQueues extends QueueSchemaConfig = Record<never, never>,\n\tTActions extends Actions<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues\n\t> = Actions<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues\n\t>,\n>(\n\tinput: ActorConfigInput<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues,\n\t\tTActions\n\t>,\n): ActorDefinition<\n\tTState,\n\tTConnParams,\n\tTConnState,\n\tTVars,\n\tTInput,\n\tTDatabase,\n\tTEvents,\n\tTQueues,\n\tTActions\n> {\n\tconst config = ActorConfigSchema.parse(input) as ActorConfig<\n\t\tTState,\n\t\tTConnParams,\n\t\tTConnState,\n\t\tTVars,\n\t\tTInput,\n\t\tTDatabase,\n\t\tTEvents,\n\t\tTQueues\n\t>;\n\treturn new ActorDefinition(config);\n}\nexport type { Encoding } from \"@/actor/protocol/serde\";\nexport {\n\tALLOWED_PUBLIC_HEADERS,\n\tPATH_CONNECT,\n\tPATH_WEBSOCKET_PREFIX,\n} from \"@/common/actor-router-consts\";\nexport type {\n\tUniversalErrorEvent,\n\tUniversalEvent,\n\tUniversalEventSource,\n\tUniversalMessageEvent,\n} from \"@/common/eventsource-interface\";\nexport type {\n\tRivetCloseEvent,\n\tRivetEvent,\n\tRivetMessageEvent,\n\tUniversalWebSocket,\n} from \"@/common/websocket-interface\";\nexport type { ActorKey } from \"@/manager/protocol/query\";\nexport type * from \"./config\";\nexport type { AnyConn, Conn } from \"./conn/mod\";\nexport type { ActorDefinition, AnyActorDefinition } from \"./definition\";\nexport { lookupInRegistry } from \"./definition\";\nexport { UserError, type UserErrorOptions } from \"./errors\";\nexport { KEYS as KV_KEYS } from \"./instance/keys\";\nexport { ActorKv } from \"./instance/kv\";\nexport type { AnyActorInstance } from \"./instance/mod\";\nexport {\n\ttype ActorRouter,\n\tcreateActorRouter,\n} from \"./router\";\nexport { routeWebSocket } from \"./router-websocket-endpoints\";\nexport type { Type } from \"./schema\";\nexport const event = schemaEvent;\nexport const queue = schemaQueue;\n","import type {\n\tActorConfig as EngineActorConfig,\n\tRunnerConfig as EngineRunnerConfig,\n\tHibernatingWebSocketMetadata,\n} from \"@rivetkit/engine-runner\";\nimport { idToStr, Runner } from \"@rivetkit/engine-runner\";\nimport * as cbor from \"cbor-x\";\nimport type { Context as HonoContext } from \"hono\";\nimport { streamSSE } from \"hono/streaming\";\nimport { WSContext, type WSContextInit } from \"hono/ws\";\nimport invariant from \"invariant\";\nimport { type AnyConn, CONN_STATE_MANAGER_SYMBOL } from \"@/actor/conn/mod\";\nimport { lookupInRegistry } from \"@/actor/definition\";\nimport { KEYS } from \"@/actor/instance/keys\";\nimport { deserializeActorKey } from \"@/actor/keys\";\nimport { getValueLength } from \"@/actor/protocol/old\";\nimport { type ActorRouter, createActorRouter } from \"@/actor/router\";\nimport {\n\tparseWebSocketProtocols,\n\trouteWebSocket,\n\ttruncateRawWebSocketPathPrefix,\n\ttype UpgradeWebSocketArgs,\n} from \"@/actor/router-websocket-endpoints\";\nimport type { Client } from \"@/client/client\";\nimport {\n\tPATH_CONNECT,\n\tPATH_INSPECTOR_CONNECT,\n\tPATH_WEBSOCKET_BASE,\n\tPATH_WEBSOCKET_PREFIX,\n} from \"@/common/actor-router-consts\";\nimport { getLogger } from \"@/common/log\";\nimport type {\n\tRivetMessageEvent,\n\tUniversalWebSocket,\n} from \"@/common/websocket-interface\";\nimport {\n\ttype ActorDriver,\n\ttype AnyActorInstance,\n\tgetInitialActorKvState,\n\ttype ManagerDriver,\n} from \"@/driver-helpers/mod\";\nimport { buildActorNames, type RegistryConfig } from \"@/registry/config\";\nimport { getEndpoint } from \"@/remote-manager-driver/api-utils\";\nimport {\n\ttype LongTimeoutHandle,\n\tpromiseWithResolvers,\n\tsetLongTimeout,\n\tstringifyError,\n\tVERSION,\n} from \"@/utils\";\nimport { logger } from \"./log\";\n\nconst RUNNER_SSE_PING_INTERVAL = 1000;\n\n// Message ack deadline is 30s on the gateway, but we will ack more frequently\n// in order to minimize the message buffer size on the gateway and to give\n// generous breathing room for the timeout.\n//\n// See engine/packages/pegboard-gateway/src/shared_state.rs\n// (HWS_MESSAGE_ACK_TIMEOUT)\nconst CONN_MESSAGE_ACK_DEADLINE = 5_000;\n\n// Force saveState when cumulative message size reaches this threshold (0.5 MB)\n//\n// See engine/packages/pegboard-gateway/src/shared_state.rs\n// (HWS_MAX_PENDING_MSGS_SIZE_PER_REQ)\nconst CONN_BUFFERED_MESSAGE_SIZE_THRESHOLD = 500_000;\n\ninterface ActorHandler {\n\tactor?: AnyActorInstance;\n\tactorStartPromise?: ReturnType<typeof promiseWithResolvers<void>>;\n\talarmTimeout?: LongTimeoutHandle;\n}\n\nexport type DriverContext = {};\n\nexport class EngineActorDriver implements ActorDriver {\n\t#config: RegistryConfig;\n\t#managerDriver: ManagerDriver;\n\t#inlineClient: Client<any>;\n\t#runner: Runner;\n\t#actors: Map<string, ActorHandler> = new Map();\n\t#actorRouter: ActorRouter;\n\n\t#runnerStarted: PromiseWithResolvers<undefined> = promiseWithResolvers((reason) => logger().warn({ msg: \"unhandled runner started promise rejection\", reason }));\n\t#runnerStopped: PromiseWithResolvers<undefined> = promiseWithResolvers((reason) => logger().warn({ msg: \"unhandled runner stopped promise rejection\", reason }));\n\t#isRunnerStopped: boolean = false;\n\n\t// HACK: Track actor stop intent locally since the runner protocol doesn't\n\t// pass the stop reason to onActorStop. This will be fixed when the runner\n\t// protocol is updated to send the intent directly (see RVT-5284)\n\t#actorStopIntent: Map<string, \"sleep\" | \"destroy\"> = new Map();\n\n\t// Map of conn IDs to message index waiting to be persisted before sending\n\t// an ack\n\t//\n\t// serverMessageIndex is updated and pendingAck is flagged in needed in\n\t// onBeforePersistConnect, then the HWS ack message is sent in\n\t// onAfterPersistConn. This allows us to track what's about to be written\n\t// to storage to prevent race conditions with the serverMessageIndex being\n\t// updated while writing the existing state.\n\t//\n\t// bufferedMessageSize tracks the total bytes received since last persist\n\t// to force a saveState when threshold is reached. This is the amount of\n\t// data currently buffered on the gateway.\n\t#hwsMessageIndex = new Map<\n\t\tstring,\n\t\t{\n\t\t\tserverMessageIndex: number;\n\t\t\tbufferedMessageSize: number;\n\t\t\tpendingAckFromMessageIndex: boolean;\n\t\t\tpendingAckFromBufferSize: boolean;\n\t\t}\n\t>();\n\n\tconstructor(\n\t\tconfig: RegistryConfig,\n\t\tmanagerDriver: ManagerDriver,\n\t\tinlineClient: Client<any>,\n\t) {\n\t\tthis.#config = config;\n\t\tthis.#managerDriver = managerDriver;\n\t\tthis.#inlineClient = inlineClient;\n\n\t\t// HACK: Override inspector token (which are likely to be\n\t\t// removed later on) with token from x-rivet-token header\n\t\tconst token = config.token;\n\t\t// TODO:\n\t\t// if (token && runConfig.inspector && runConfig.inspector.enabled) {\n\t\t// \trunConfig.inspector.token = () => token;\n\t\t// }\n\n\t\tthis.#actorRouter = createActorRouter(\n\t\t\tconfig,\n\t\t\tthis,\n\t\t\tundefined,\n\t\t\tconfig.test.enabled,\n\t\t);\n\n\t\t// Create runner configuration\n\t\tconst engineRunnerConfig: EngineRunnerConfig = {\n\t\t\tversion: config.runner.version,\n\t\t\tendpoint: getEndpoint(config),\n\t\t\ttoken,\n\t\t\tnamespace: config.namespace,\n\t\t\ttotalSlots: config.runner.totalSlots,\n\t\t\trunnerName: config.runner.runnerName,\n\t\t\trunnerKey: config.runner.runnerKey ?? crypto.randomUUID(),\n\t\t\tmetadata: {\n\t\t\t\trivetkit: { version: VERSION },\n\t\t\t},\n\t\t\tprepopulateActorNames: buildActorNames(config),\n\t\t\tonConnected: () => {\n\t\t\t\tthis.#runnerStarted.resolve(undefined);\n\t\t\t},\n\t\t\tonDisconnected: (_code, _reason) => {},\n\t\t\tonShutdown: () => {\n\t\t\t\tthis.#runnerStopped.resolve(undefined);\n\t\t\t\tthis.#isRunnerStopped = true;\n\t\t\t},\n\t\t\tfetch: this.#runnerFetch.bind(this),\n\t\t\twebsocket: this.#runnerWebSocket.bind(this),\n\t\t\thibernatableWebSocket: {\n\t\t\t\tcanHibernate: this.#hwsCanHibernate.bind(this),\n\t\t\t},\n\t\t\tonActorStart: this.#runnerOnActorStart.bind(this),\n\t\t\tonActorStop: this.#runnerOnActorStop.bind(this),\n\t\t\tlogger: getLogger(\"engine-runner\"),\n\t\t};\n\n\t\t// Create and start runner\n\t\tthis.#runner = new Runner(engineRunnerConfig);\n\t\tthis.#runner.start();\n\t\tlogger().debug({\n\t\t\tmsg: \"engine runner started\",\n\t\t\tendpoint: config.endpoint,\n\t\t\tnamespace: config.namespace,\n\t\t\trunnerName: config.runner.runnerName,\n\t\t});\n\t}\n\n\tgetExtraActorLogParams(): Record<string, string> {\n\t\treturn { runnerId: this.#runner.runnerId ?? \"-\" };\n\t}\n\n\tasync #loadActorHandler(actorId: string): Promise<ActorHandler> {\n\t\t// Check if actor is already loaded\n\t\tconst handler = this.#actors.get(actorId);\n\t\tif (!handler)\n\t\t\tthrow new Error(`Actor handler does not exist ${actorId}`);\n\t\tif (handler.actorStartPromise) await handler.actorStartPromise.promise;\n\t\tif (!handler.actor) throw new Error(\"Actor should be loaded\");\n\t\treturn handler;\n\t}\n\n\tgetContext(actorId: string): DriverContext {\n\t\treturn {};\n\t}\n\n\tasync setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void> {\n\t\tconst handler = this.#actors.get(actor.id);\n\t\tif (!handler) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"no handler for actor to set alarm\",\n\t\t\t});\n\n\t\t\treturn;\n\t\t}\n\n\t\t// Clear prev timeout\n\t\tif (handler.alarmTimeout) {\n\t\t\thandler.alarmTimeout.abort();\n\t\t\thandler.alarmTimeout = undefined;\n\t\t}\n\n\t\t// Set alarm\n\t\tconst delay = Math.max(0, timestamp - Date.now());\n\t\thandler.alarmTimeout = setLongTimeout(() => {\n\t\t\tactor.onAlarm();\n\t\t\thandler.alarmTimeout = undefined;\n\t\t}, delay);\n\n\t\t// TODO: This call may not be needed on ActorInstance.start, but it does help ensure that the local state is synced with the alarm state\n\t\t// Set alarm on Rivet\n\t\t//\n\t\t// This does not call an \"alarm\" event like Durable Objects.\n\t\t// Instead, it just wakes the actor on the alarm (if not\n\t\t// already awake).\n\t\t//\n\t\t// onAlarm is automatically called on `ActorInstance.start` when waking\n\t\t// again.\n\t\tthis.#runner.setAlarm(actor.id, timestamp);\n\t}\n\n\t// No database overrides - will use KV-backed implementation from rivetkit/db\n\n\t// MARK: - Batch KV operations\n\tasync kvBatchPut(\n\t\tactorId: string,\n\t\tentries: [Uint8Array, Uint8Array][],\n\t): Promise<void> {\n\t\tawait this.#runner.kvPut(actorId, entries);\n\t}\n\n\tasync kvBatchGet(\n\t\tactorId: string,\n\t\tkeys: Uint8Array[],\n\t): Promise<(Uint8Array | null)[]> {\n\t\treturn await this.#runner.kvGet(actorId, keys);\n\t}\n\n\tasync kvBatchDelete(actorId: string, keys: Uint8Array[]): Promise<void> {\n\t\tawait this.#runner.kvDelete(actorId, keys);\n\t}\n\n\tasync kvList(actorId: string): Promise<Uint8Array[]> {\n\t\tconst entries = await this.#runner.kvListPrefix(\n\t\t\tactorId,\n\t\t\tnew Uint8Array(),\n\t\t);\n\t\tconst keys = entries.map(([key]) => key);\n\t\tlogger().info({\n\t\t\tmsg: \"kvList called\",\n\t\t\tactorId,\n\t\t\tkeysCount: keys.length,\n\t\t\tkeys: keys.map((k) => new TextDecoder().decode(k)),\n\t\t});\n\t\treturn keys;\n\t}\n\n\tasync kvListPrefix(\n\t\tactorId: string,\n\t\tprefix: Uint8Array,\n\t): Promise<[Uint8Array, Uint8Array][]> {\n\t\tconst result = await this.#runner.kvListPrefix(actorId, prefix);\n\t\tlogger().info({\n\t\t\tmsg: \"kvListPrefix called\",\n\t\t\tactorId,\n\t\t\tprefixStr: new TextDecoder().decode(prefix),\n\t\t\tentriesCount: result.length,\n\t\t\tkeys: result.map(([key]) => new TextDecoder().decode(key)),\n\t\t});\n\t\treturn result;\n\t}\n\n\t// MARK: - Actor Lifecycle\n\tasync loadActor(actorId: string): Promise<AnyActorInstance> {\n\t\tconst handler = await this.#loadActorHandler(actorId);\n\t\tif (!handler.actor) throw new Error(`Actor ${actorId} failed to load`);\n\t\treturn handler.actor;\n\t}\n\n\tstartSleep(actorId: string) {\n\t\t// HACK: Track intent for onActorStop (see RVT-5284)\n\t\tthis.#actorStopIntent.set(actorId, \"sleep\");\n\t\tthis.#runner.sleepActor(actorId);\n\t}\n\n\tstartDestroy(actorId: string) {\n\t\t// HACK: Track intent for onActorStop (see RVT-5284)\n\t\tthis.#actorStopIntent.set(actorId, \"destroy\");\n\t\tthis.#runner.stopActor(actorId);\n\t}\n\n\tasync shutdownRunner(immediate: boolean): Promise<void> {\n\t\tlogger().info({ msg: \"stopping engine actor driver\", immediate });\n\n\t\t// TODO: We need to update the runner to have a draining state so:\n\t\t// 1. Send ToServerDraining\n\t\t//\t\t- This causes Pegboard to stop allocating actors to this runner\n\t\t// 2. Pegboard sends ToClientStopActor for all actors on this runner which handles the graceful migration of each actor independently\n\t\t// 3. Send ToServerStopping once all actors have successfully stopped\n\t\t//\n\t\t// What's happening right now is:\n\t\t// 1. All actors enter stopped state\n\t\t// 2. Actors still respond to requests because only RivetKit knows it's\n\t\t//    stopping, this causes all requests to issue errors that the actor is\n\t\t//    stopping. (This will NOT return a 503 bc the runner has no idea the\n\t\t//    actors are stopping.)\n\t\t// 3. Once the last actor stops, then the runner finally stops + actors\n\t\t//    reschedule\n\t\t//\n\t\t// This means that:\n\t\t// - All actors on this runner are bricked until the slowest onStop finishes\n\t\t// - Guard will not gracefully handle requests bc it's not receiving a 503\n\t\t// - Actors can still be scheduled to this runner while the other\n\t\t//   actors are stopping, meaning that those actors will NOT get onStop\n\t\t//   and will potentiall corrupt their state\n\t\t//\n\t\t// HACK: Stop all actors to allow state to be saved\n\t\t// NOTE: onStop is only supposed to be called by the runner, we're\n\t\t// abusing it here\n\t\tlogger().debug({\n\t\t\tmsg: \"stopping all actors before shutdown\",\n\t\t\tactorCount: this.#actors.size,\n\t\t});\n\t\tconst stopPromises: Promise<void>[] = [];\n\t\tfor (const [_actorId, handler] of this.#actors.entries()) {\n\t\t\tif (handler.actor) {\n\t\t\t\tstopPromises.push(\n\t\t\t\t\thandler.actor.onStop(\"sleep\").catch((err) => {\n\t\t\t\t\t\thandler.actor?.rLog.error({\n\t\t\t\t\t\t\tmsg: \"onStop errored\",\n\t\t\t\t\t\t\terror: stringifyError(err),\n\t\t\t\t\t\t});\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tawait Promise.all(stopPromises);\n\t\tlogger().debug({ msg: \"all actors stopped\" });\n\n\t\tawait this.#runner.shutdown(immediate);\n\t}\n\n\tasync serverlessHandleStart(c: HonoContext): Promise<Response> {\n\t\treturn streamSSE(c, async (stream) => {\n\t\t\t// NOTE: onAbort does not work reliably\n\t\t\tstream.onAbort(() => {});\n\t\t\tc.req.raw.signal.addEventListener(\"abort\", () => {\n\t\t\t\tlogger().debug(\"SSE aborted, shutting down runner\");\n\n\t\t\t\t// We cannot assume that the request will always be closed gracefully by Rivet. We always proceed with a graceful shutdown in case the request was terminated for any other reason.\n\t\t\t\t//\n\t\t\t\t// If we did not use a graceful shutdown, the runner would\n\t\t\t\tthis.shutdownRunner(false);\n\t\t\t});\n\n\t\t\tawait this.#runnerStarted.promise;\n\n\t\t\t// Runner id should be set if the runner started\n\t\t\tconst payload = this.#runner.getServerlessInitPacket();\n\t\t\tinvariant(payload, \"runnerId not set\");\n\t\t\tawait stream.writeSSE({ data: payload });\n\n\t\t\t// Send ping every second to keep the connection alive\n\t\t\twhile (true) {\n\t\t\t\tif (this.#isRunnerStopped) {\n\t\t\t\t\tlogger().debug({\n\t\t\t\t\t\tmsg: \"runner is stopped\",\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (stream.closed || stream.aborted) {\n\t\t\t\t\tlogger().debug({\n\t\t\t\t\t\tmsg: \"runner sse stream closed\",\n\t\t\t\t\t\tclosed: stream.closed,\n\t\t\t\t\t\taborted: stream.aborted,\n\t\t\t\t\t});\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tawait stream.writeSSE({ event: \"ping\", data: \"\" });\n\t\t\t\tawait stream.sleep(RUNNER_SSE_PING_INTERVAL);\n\t\t\t}\n\n\t\t\t// Wait for the runner to stop if the SSE stream aborted early for any reason\n\t\t\tawait this.#runnerStopped.promise;\n\t\t});\n\t}\n\n\tasync #runnerOnActorStart(\n\t\tactorId: string,\n\t\tgeneration: number,\n\t\tactorConfig: EngineActorConfig,\n\t): Promise<void> {\n\t\tlogger().debug({\n\t\t\tmsg: \"runner actor starting\",\n\t\t\tactorId,\n\t\t\tname: actorConfig.name,\n\t\t\tkey: actorConfig.key,\n\t\t\tgeneration,\n\t\t});\n\n\t\t// Deserialize input\n\t\tlet input: any;\n\t\tif (actorConfig.input) {\n\t\t\tinput = cbor.decode(actorConfig.input);\n\t\t}\n\n\t\t// Get or create handler\n\t\tlet handler = this.#actors.get(actorId);\n\t\tif (!handler) {\n\t\t\t// IMPORTANT: We must set the handler in the map synchronously before doing any\n\t\t\t// async operations to avoid race conditions where multiple calls might try to\n\t\t\t// create the same handler simultaneously.\n\t\t\thandler = {\n\t\t\t\tactorStartPromise: promiseWithResolvers((reason) => logger().warn({ msg: \"unhandled actor start promise rejection\", reason })),\n\t\t\t};\n\t\t\tthis.#actors.set(actorId, handler);\n\t\t}\n\n\t\tconst name = actorConfig.name as string;\n\t\tinvariant(actorConfig.key, \"actor should have a key\");\n\t\tconst key = deserializeActorKey(actorConfig.key);\n\n\t\ttry {\n\t\t\t// Initialize storage\n\t\t\tconst [persistDataBuffer] = await this.#runner.kvGet(actorId, [\n\t\t\t\tKEYS.PERSIST_DATA,\n\t\t\t]);\n\t\t\tif (persistDataBuffer === null) {\n\t\t\t\tconst initialKvState = getInitialActorKvState(input);\n\t\t\t\tawait this.#runner.kvPut(actorId, initialKvState);\n\t\t\t\tlogger().debug({\n\t\t\t\t\tmsg: \"initialized persist data for new actor\",\n\t\t\t\t\tactorId,\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tlogger().debug({\n\t\t\t\t\tmsg: \"found existing persist data for actor\",\n\t\t\t\t\tactorId,\n\t\t\t\t\tdataSize: persistDataBuffer.byteLength,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Create actor instance\n\t\t\tconst definition = lookupInRegistry(this.#config, actorConfig.name);\n\t\t\thandler.actor = await definition.instantiate();\n\n\t\t\t// Start actor\n\t\t\tawait handler.actor.start(\n\t\t\t\tthis,\n\t\t\t\tthis.#inlineClient,\n\t\t\t\tactorId,\n\t\t\t\tname,\n\t\t\t\tkey,\n\t\t\t\t\"unknown\", // TODO: Add regions\n\t\t\t);\n\n\t\t\tlogger().debug({ msg: \"runner actor started\", actorId, name, key });\n\t\t} catch (innerError) {\n\t\t\tconst error = new Error(\n\t\t\t\t`Failed to start actor ${actorId}: ${innerError}`,\n\t\t\t\t{ cause: innerError },\n\t\t\t);\n\t\t\thandler.actorStartPromise?.reject(error);\n\t\t\thandler.actorStartPromise = undefined;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync #runnerOnActorStop(\n\t\tactorId: string,\n\t\tgeneration: number,\n\t): Promise<void> {\n\t\tlogger().debug({ msg: \"runner actor stopping\", actorId, generation });\n\n\t\t// HACK: Retrieve the stop intent we tracked locally (see RVT-5284)\n\t\t// Default to \"sleep\" if no intent was recorded (e.g., if the runner\n\t\t// initiated the stop)\n\t\t//\n\t\t// TODO: This will not work if the actor is destroyed from the API\n\t\t// correctly. Currently, it will use the sleep intent, but it's\n\t\t// actually a destroy intent.\n\t\tconst reason = this.#actorStopIntent.get(actorId) ?? \"sleep\";\n\t\tthis.#actorStopIntent.delete(actorId);\n\n\t\tconst handler = this.#actors.get(actorId);\n\t\tif (handler?.actor) {\n\t\t\ttry {\n\t\t\t\tawait handler.actor.onStop(reason);\n\t\t\t} catch (err) {\n\t\t\t\tlogger().error({\n\t\t\t\t\tmsg: \"error in onStop, proceeding with removing actor\",\n\t\t\t\t\terr: stringifyError(err),\n\t\t\t\t});\n\t\t\t}\n\t\t\tthis.#actors.delete(actorId);\n\t\t}\n\n\t\tlogger().debug({ msg: \"runner actor stopped\", actorId, reason });\n\t}\n\n\t// MARK: - Runner Networking\n\tasync #runnerFetch(\n\t\t_runner: Runner,\n\t\tactorId: string,\n\t\t_gatewayIdBuf: ArrayBuffer,\n\t\t_requestIdBuf: ArrayBuffer,\n\t\trequest: Request,\n\t): Promise<Response> {\n\t\tlogger().debug({\n\t\t\tmsg: \"runner fetch\",\n\t\t\tactorId,\n\t\t\turl: request.url,\n\t\t\tmethod: request.method,\n\t\t});\n\t\treturn await this.#actorRouter.fetch(request, { actorId });\n\t}\n\n\tasync #runnerWebSocket(\n\t\t_runner: Runner,\n\t\tactorId: string,\n\t\twebsocketRaw: any,\n\t\tgatewayIdBuf: ArrayBuffer,\n\t\trequestIdBuf: ArrayBuffer,\n\t\trequest: Request,\n\t\trequestPath: string,\n\t\trequestHeaders: Record<string, string>,\n\t\tisHibernatable: boolean,\n\t\tisRestoringHibernatable: boolean,\n\t): Promise<void> {\n\t\tconst websocket = websocketRaw as UniversalWebSocket;\n\n\t\t// Add a unique ID to track this WebSocket object\n\t\tconst wsUniqueId = `ws_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n\t\t(websocket as any).__rivet_ws_id = wsUniqueId;\n\n\t\tlogger().debug({\n\t\t\tmsg: \"runner websocket\",\n\t\t\tactorId,\n\t\t\turl: request.url,\n\t\t\tisRestoringHibernatable,\n\t\t\twebsocketObjectId: websocketRaw\n\t\t\t\t? Object.prototype.toString.call(websocketRaw)\n\t\t\t\t: \"null\",\n\t\t\twebsocketType: websocketRaw?.constructor?.name,\n\t\t\twsUniqueId,\n\t\t\twebsocketProps: websocketRaw\n\t\t\t\t? Object.keys(websocketRaw).join(\", \")\n\t\t\t\t: \"null\",\n\t\t});\n\n\t\t// Parse configuration from Sec-WebSocket-Protocol header (optional for path-based routing)\n\t\tconst protocols = request.headers.get(\"sec-websocket-protocol\");\n\t\tconst { encoding, connParams } = parseWebSocketProtocols(protocols);\n\n\t\t// Fetch WS handler\n\t\t//\n\t\t// We store the promise since we need to add WebSocket event listeners immediately that will wait for the promise to resolve\n\t\tlet wsHandler: UpgradeWebSocketArgs;\n\t\ttry {\n\t\t\twsHandler = await routeWebSocket(\n\t\t\t\trequest,\n\t\t\t\trequestPath,\n\t\t\t\trequestHeaders,\n\t\t\t\tthis.#config,\n\t\t\t\tthis,\n\t\t\t\tactorId,\n\t\t\t\tencoding,\n\t\t\t\tconnParams,\n\t\t\t\tgatewayIdBuf,\n\t\t\t\trequestIdBuf,\n\t\t\t\tisHibernatable,\n\t\t\t\tisRestoringHibernatable,\n\t\t\t);\n\t\t} catch (err) {\n\t\t\tlogger().error({ msg: \"building websocket handlers errored\", err });\n\t\t\twebsocketRaw.close(1011, \"ws.route_error\");\n\t\t\treturn;\n\t\t}\n\n\t\t// Connect the Hono WS hook to the adapter\n\t\t//\n\t\t// We need to assign to `raw` in order for WSContext to expose it on\n\t\t// `ws.raw`\n\t\t(websocket as WSContextInit).raw = websocket;\n\t\tconst wsContext = new WSContext(websocket);\n\n\t\t// Get connection and actor from wsHandler (may be undefined for inspector endpoint)\n\t\tconst conn = wsHandler.conn;\n\t\tconst actor = wsHandler.actor;\n\t\tconst connStateManager = conn?.[CONN_STATE_MANAGER_SYMBOL];\n\n\t\t// Bind event listeners to Hono WebSocket handlers\n\t\t//\n\t\t// We update the HWS data after calling handlers in order to ensure\n\t\t// that the handler ran successfully. By doing this, we ensure at least\n\t\t// once delivery of events to the event handlers.\n\n\t\t// Log when attaching event listeners\n\t\tlogger().debug({\n\t\t\tmsg: \"attaching websocket event listeners\",\n\t\t\tactorId,\n\t\t\tconnId: conn?.id,\n\t\t\twsUniqueId: (websocket as any).__rivet_ws_id,\n\t\t\tisRestoringHibernatable,\n\t\t\twebsocketType: websocket?.constructor?.name,\n\t\t});\n\n\t\tif (isRestoringHibernatable) {\n\t\t\twsHandler.onRestore?.(wsContext);\n\t\t}\n\n\t\twebsocket.addEventListener(\"open\", (event) => {\n\t\t\twsHandler.onOpen(event, wsContext);\n\t\t});\n\n\t\twebsocket.addEventListener(\"message\", (event: RivetMessageEvent) => {\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"websocket message event listener triggered\",\n\t\t\t\tconnId: conn?.id,\n\t\t\t\tactorId: actor?.id,\n\t\t\t\tmessageIndex: event.rivetMessageIndex,\n\t\t\t\thasWsHandler: !!wsHandler,\n\t\t\t\thasOnMessage: !!wsHandler?.onMessage,\n\t\t\t\tactorIsStopping: actor?.isStopping,\n\t\t\t\twebsocketType: websocket?.constructor?.name,\n\t\t\t\twsUniqueId: (websocket as any).__rivet_ws_id,\n\t\t\t\teventTargetWsId: (event.target as any)?.__rivet_ws_id,\n\t\t\t});\n\n\t\t\t// Check if actor is stopping - if so, don't process new messages.\n\t\t\t// These messages will be reprocessed when the actor wakes up from hibernation.\n\t\t\t// TODO: This will never retransmit the socket and the socket will close\n\t\t\tif (actor?.isStopping) {\n\t\t\t\tlogger().debug({\n\t\t\t\t\tmsg: \"ignoring ws message, actor is stopping\",\n\t\t\t\t\tconnId: conn?.id,\n\t\t\t\t\tactorId: actor?.id,\n\t\t\t\t\tmessageIndex: event.rivetMessageIndex,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Process message\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"calling wsHandler.onMessage\",\n\t\t\t\tconnId: conn?.id,\n\t\t\t\tmessageIndex: event.rivetMessageIndex,\n\t\t\t});\n\t\t\twsHandler.onMessage(event, wsContext);\n\n\t\t\t// Persist message index for hibernatable connections\n\t\t\tconst hibernate = connStateManager?.hibernatableData;\n\n\t\t\tif (hibernate && conn && actor) {\n\t\t\t\tinvariant(\n\t\t\t\t\ttypeof event.rivetMessageIndex === \"number\",\n\t\t\t\t\t\"missing event.rivetMessageIndex\",\n\t\t\t\t);\n\n\t\t\t\t// Persist message index\n\t\t\t\tconst previousMsgIndex = hibernate.serverMessageIndex;\n\t\t\t\thibernate.serverMessageIndex = event.rivetMessageIndex;\n\t\t\t\tlogger().info({\n\t\t\t\t\tmsg: \"persisting message index\",\n\t\t\t\t\tconnId: conn.id,\n\t\t\t\t\tpreviousMsgIndex,\n\t\t\t\t\tnewMsgIndex: event.rivetMessageIndex,\n\t\t\t\t});\n\n\t\t\t\t// Calculate message size and track cumulative size\n\t\t\t\tconst entry = this.#hwsMessageIndex.get(conn.id);\n\t\t\t\tif (entry) {\n\t\t\t\t\t// Track message length\n\t\t\t\t\tconst messageLength = getValueLength(event.data);\n\t\t\t\t\tentry.bufferedMessageSize += messageLength;\n\n\t\t\t\t\tif (\n\t\t\t\t\t\tentry.bufferedMessageSize >=\n\t\t\t\t\t\tCONN_BUFFERED_MESSAGE_SIZE_THRESHOLD\n\t\t\t\t\t) {\n\t\t\t\t\t\t// Reset buffered message size immeidatley (instead\n\t\t\t\t\t\t// of waiting for onAfterPersistConn) since we may\n\t\t\t\t\t\t// receive more messages before onAfterPersistConn\n\t\t\t\t\t\t// is called, which would called saveState\n\t\t\t\t\t\t// immediate multiple times\n\t\t\t\t\t\tentry.bufferedMessageSize = 0;\n\t\t\t\t\t\tentry.pendingAckFromBufferSize = true;\n\n\t\t\t\t\t\t// Save state immediately if approaching buffer threshold\n\t\t\t\t\t\tactor.stateManager.saveState({\n\t\t\t\t\t\t\timmediate: true,\n\t\t\t\t\t\t});\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// Save message index. The maxWait is set to the ack deadline\n\t\t\t\t\t\t// since we ack the message immediately after persisting the index.\n\t\t\t\t\t\t// If cumulative size exceeds threshold, force immediate persist.\n\t\t\t\t\t\t//\n\t\t\t\t\t\t// This will call EngineActorDriver.onAfterPersistConn after\n\t\t\t\t\t\t// persist to send the ack to the gateway.\n\t\t\t\t\t\tactor.stateManager.saveState({\n\t\t\t\t\t\t\tmaxWait: CONN_MESSAGE_ACK_DEADLINE,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// Fallback if entry missing\n\t\t\t\t\tactor.stateManager.saveState({\n\t\t\t\t\t\tmaxWait: CONN_MESSAGE_ACK_DEADLINE,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\n\t\twebsocket.addEventListener(\"close\", (event) => {\n\t\t\twsHandler.onClose(event, wsContext);\n\n\t\t\t// NOTE: Persisted connection is removed when `conn.disconnect`\n\t\t\t// is called by the WebSocket route\n\t\t});\n\n\t\twebsocket.addEventListener(\"error\", (event) => {\n\t\t\twsHandler.onError(event, wsContext);\n\t\t});\n\n\t\t// Log event listener attachment for restored connections\n\t\tif (isRestoringHibernatable) {\n\t\t\tlogger().info({\n\t\t\t\tmsg: \"event listeners attached to restored websocket\",\n\t\t\t\tactorId,\n\t\t\t\tconnId: conn?.id,\n\t\t\t\tgatewayId: idToStr(gatewayIdBuf),\n\t\t\t\trequestId: idToStr(requestIdBuf),\n\t\t\t\twebsocketType: websocket?.constructor?.name,\n\t\t\t\thasMessageListener: !!websocket.addEventListener,\n\t\t\t});\n\t\t}\n\t}\n\n\t// MARK: - Hibernating WebSockets\n\t#hwsCanHibernate(\n\t\tactorId: string,\n\t\tgatewayId: ArrayBuffer,\n\t\trequestId: ArrayBuffer,\n\t\trequest: Request,\n\t): boolean {\n\t\tconst url = new URL(request.url);\n\t\tconst path = url.pathname;\n\n\t\t// Get actor instance from runner to access actor name\n\t\tconst actorInstance = this.#runner.getActor(actorId);\n\t\tif (!actorInstance) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"actor not found in #hwsCanHibernate\",\n\t\t\t\tactorId,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\n\t\t// Load actor handler to access persisted data\n\t\tconst handler = this.#actors.get(actorId);\n\t\tif (!handler) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"actor handler not found in #hwsCanHibernate\",\n\t\t\t\tactorId,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\t\tif (!handler.actor) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"actor not found in #hwsCanHibernate\",\n\t\t\t\tactorId,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\n\t\t// Determine configuration for new WS\n\t\tlogger().debug({\n\t\t\tmsg: \"no existing hibernatable websocket found\",\n\t\t\tgatewayId: idToStr(gatewayId),\n\t\t\trequestId: idToStr(requestId),\n\t\t});\n\t\tif (path === PATH_CONNECT) {\n\t\t\treturn true;\n\t\t} else if (\n\t\t\tpath === PATH_WEBSOCKET_BASE ||\n\t\t\tpath.startsWith(PATH_WEBSOCKET_PREFIX)\n\t\t) {\n\t\t\t// Find actor config\n\t\t\tconst definition = lookupInRegistry(\n\t\t\t\tthis.#config,\n\t\t\t\tactorInstance.config.name,\n\t\t\t);\n\n\t\t\t// Check if can hibernate\n\t\t\tconst canHibernateWebSocket =\n\t\t\t\tdefinition.config.options?.canHibernateWebSocket;\n\t\t\tif (canHibernateWebSocket === true) {\n\t\t\t\treturn true;\n\t\t\t} else if (typeof canHibernateWebSocket === \"function\") {\n\t\t\t\ttry {\n\t\t\t\t\t// Truncate the path to match the behavior on onRawWebSocket\n\t\t\t\t\tconst newPath = truncateRawWebSocketPathPrefix(\n\t\t\t\t\t\turl.pathname,\n\t\t\t\t\t);\n\t\t\t\t\tconst truncatedRequest = new Request(\n\t\t\t\t\t\t`http://actor${newPath}`,\n\t\t\t\t\t\trequest,\n\t\t\t\t\t);\n\n\t\t\t\t\tconst canHibernate =\n\t\t\t\t\t\tcanHibernateWebSocket(truncatedRequest);\n\t\t\t\t\treturn canHibernate;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlogger().error({\n\t\t\t\t\t\tmsg: \"error calling canHibernateWebSocket\",\n\t\t\t\t\t\terror,\n\t\t\t\t\t});\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t} else if (path === PATH_INSPECTOR_CONNECT) {\n\t\t\treturn false;\n\t\t} else {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"unexpected path for getActorHibernationConfig\",\n\t\t\t\tpath,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync #hwsLoadAll(\n\t\tactorId: string,\n\t): Promise<HibernatingWebSocketMetadata[]> {\n\t\tconst actor = await this.loadActor(actorId);\n\t\treturn actor.conns\n\t\t\t.values()\n\t\t\t.map((conn) => {\n\t\t\t\tconst connStateManager = conn[CONN_STATE_MANAGER_SYMBOL];\n\t\t\t\tconst hibernatable = connStateManager.hibernatableData;\n\t\t\t\tif (!hibernatable) return undefined;\n\t\t\t\treturn {\n\t\t\t\t\tgatewayId: hibernatable.gatewayId,\n\t\t\t\t\trequestId: hibernatable.requestId,\n\t\t\t\t\tserverMessageIndex: hibernatable.serverMessageIndex,\n\t\t\t\t\tclientMessageIndex: hibernatable.clientMessageIndex,\n\t\t\t\t\tpath: hibernatable.requestPath,\n\t\t\t\t\theaders: hibernatable.requestHeaders,\n\t\t\t\t} satisfies HibernatingWebSocketMetadata;\n\t\t\t})\n\t\t\t.filter((x) => x !== undefined)\n\t\t\t.toArray();\n\t}\n\n\tasync onBeforeActorStart(actor: AnyActorInstance): Promise<void> {\n\t\t// Resolve promise if waiting\n\t\tconst handler = this.#actors.get(actor.id);\n\t\tinvariant(handler, \"missing actor handler in onBeforeActorReady\");\n\t\thandler.actorStartPromise?.resolve();\n\t\thandler.actorStartPromise = undefined;\n\n\t\t// Restore hibernating requests\n\t\tconst metaEntries = await this.#hwsLoadAll(actor.id);\n\t\tawait this.#runner.restoreHibernatingRequests(actor.id, metaEntries);\n\t}\n\n\tonCreateConn(conn: AnyConn) {\n\t\tconst hibernatable = conn[CONN_STATE_MANAGER_SYMBOL].hibernatableData;\n\t\tif (!hibernatable) return;\n\n\t\tthis.#hwsMessageIndex.set(conn.id, {\n\t\t\tserverMessageIndex: hibernatable.serverMessageIndex,\n\t\t\tbufferedMessageSize: 0,\n\t\t\tpendingAckFromMessageIndex: false,\n\t\t\tpendingAckFromBufferSize: false,\n\t\t});\n\n\t\tlogger().debug({\n\t\t\tmsg: \"created #hwsMessageIndex entry\",\n\t\t\tconnId: conn.id,\n\t\t\tserverMessageIndex: hibernatable.serverMessageIndex,\n\t\t});\n\t}\n\n\tonDestroyConn(conn: AnyConn) {\n\t\tthis.#hwsMessageIndex.delete(conn.id);\n\n\t\tlogger().debug({\n\t\t\tmsg: \"removed #hwsMessageIndex entry\",\n\t\t\tconnId: conn.id,\n\t\t});\n\t}\n\n\tonBeforePersistConn(conn: AnyConn) {\n\t\tconst stateManager = conn[CONN_STATE_MANAGER_SYMBOL];\n\t\tconst hibernatable = stateManager.hibernatableDataOrError();\n\n\t\tconst entry = this.#hwsMessageIndex.get(conn.id);\n\t\tif (!entry) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"missing EngineActorDriver.#hwsMessageIndex entry for conn\",\n\t\t\t\tconnId: conn.id,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\t// There is a newer message index\n\t\tentry.pendingAckFromMessageIndex =\n\t\t\thibernatable.serverMessageIndex > entry.serverMessageIndex;\n\t\tentry.serverMessageIndex = hibernatable.serverMessageIndex;\n\t}\n\n\tonAfterPersistConn(conn: AnyConn) {\n\t\tconst stateManager = conn[CONN_STATE_MANAGER_SYMBOL];\n\t\tconst hibernatable = stateManager.hibernatableDataOrError();\n\n\t\tconst entry = this.#hwsMessageIndex.get(conn.id);\n\t\tif (!entry) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"missing EngineActorDriver.#hwsMessageIndex entry for conn\",\n\t\t\t\tconnId: conn.id,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\t// Ack entry\n\t\tif (\n\t\t\tentry.pendingAckFromMessageIndex ||\n\t\t\tentry.pendingAckFromBufferSize\n\t\t) {\n\t\t\tthis.#runner.sendHibernatableWebSocketMessageAck(\n\t\t\t\thibernatable.gatewayId,\n\t\t\t\thibernatable.requestId,\n\t\t\t\tentry.serverMessageIndex,\n\t\t\t);\n\t\t\tentry.pendingAckFromMessageIndex = false;\n\t\t\tentry.pendingAckFromBufferSize = false;\n\t\t\tentry.bufferedMessageSize = 0;\n\t\t}\n\t}\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"driver-engine\");\n}\n","import { z } from \"zod/v4\";\nimport {\n\tClientConfigSchemaBase,\n\ttransformClientConfig,\n} from \"@/client/config\";\nimport { getRivetRunnerKey } from \"@/utils/env-vars\";\n\n/**\n * Base engine config schema without transforms so it can be merged in to other schemas.\n *\n * We include the client config since this includes the common properties like endpoint, namespace, etc.\n */\nexport const EngineConfigSchemaBase = ClientConfigSchemaBase.extend({\n\t/** Unique key for this runner. Runners connecting a given key will replace any other runner connected with the same key. */\n\trunnerKey: z\n\t\t.string()\n\t\t.optional()\n\t\t.transform((val) => val ?? getRivetRunnerKey()),\n\n\t/** How many actors this runner can run. */\n\ttotalSlots: z.number().default(100_000),\n});\n\nconst EngineConfigSchemaTransformed = EngineConfigSchemaBase.transform(\n\t(config, ctx) => transformEngineConfig(config, ctx),\n);\n\nexport const EngineConfigSchema = EngineConfigSchemaTransformed.default(() =>\n\tEngineConfigSchemaTransformed.parse({}),\n);\n\nexport type EngineConfig = z.infer<typeof EngineConfigSchema>;\nexport type EngineConfigInput = z.input<typeof EngineConfigSchema>;\n\nexport function transformEngineConfig(\n\tconfig: z.infer<typeof EngineConfigSchemaBase>,\n\tctx: z.RefinementCtx,\n) {\n\treturn {\n\t\t...transformClientConfig(config, ctx),\n\t\trunnerKey: config.runnerKey,\n\t};\n}\n","import type { Client } from \"@/client/client\";\nimport { convertRegistryConfigToClientConfig } from \"@/client/config\";\nimport type { ManagerDriver } from \"@/manager/driver\";\nimport { RemoteManagerDriver } from \"@/remote-manager-driver/mod\";\nimport { EngineActorDriver } from \"./actor-driver\";\nimport { RegistryConfig, DriverConfig } from \"@/registry/config\";\n\nexport { EngineActorDriver } from \"./actor-driver\";\nexport {\n\ttype EngineConfig as Config,\n\ttype EngineConfigInput as InputConfig,\n\tEngineConfigSchema as ConfigSchema,\n} from \"./config\";\n\nexport function createEngineDriver(): DriverConfig {\n\treturn {\n\t\tname: \"engine\",\n\t\tdisplayName: \"Engine\",\n\t\tmanager: (config: RegistryConfig) => {\n\t\t\tconst clientConfig = convertRegistryConfigToClientConfig(config);\n\t\t\treturn new RemoteManagerDriver(clientConfig);\n\t\t},\n\t\tactor: (\n\t\t\tconfig: RegistryConfig,\n\t\t\tmanagerDriver: ManagerDriver,\n\t\t\tinlineClient: Client<any>,\n\t\t) => {\n\t\t\treturn new EngineActorDriver(\n\t\t\t\tconfig,\n\t\t\t\tmanagerDriver,\n\t\t\t\tinlineClient,\n\t\t\t);\n\t\t},\n\t\tautoStartActorDriver: true,\n\t};\n}\n","import type { Logger } from \"pino\";\nimport { z } from \"zod/v4\";\nimport type { ActorDriverBuilder } from \"@/actor/driver\";\nimport { LogLevelSchema } from \"@/common/log\";\nimport {\n\tEngineConfigSchemaBase,\n\ttransformEngineConfig,\n} from \"@/drivers/engine/config\";\nimport { InspectorConfigSchema } from \"@/inspector/config\";\nimport type { ManagerDriverBuilder } from \"@/manager/driver\";\nimport type { GetUpgradeWebSocket } from \"@/utils\";\nimport { getEnvUniversal, VERSION } from \"@/utils\";\nimport {\n\tgetRivetRunEngine,\n\tgetRivetRunEngineVersion,\n\tgetRivetRunnerKind,\n\tgetRivetToken,\n} from \"@/utils/env-vars\";\n\nexport const LegacyDriverConfigSchema = z.object({\n\t/** Machine-readable name to identify this driver by. */\n\tname: z.string(),\n\tmanager: z.custom<ManagerDriverBuilder>(),\n\tactor: z.custom<ActorDriverBuilder>(),\n});\n\nexport type LegacyDriverConfig = z.infer<typeof LegacyDriverConfigSchema>;\n\n/** Base config used for the actor config across all platforms. */\nconst LegacyRunnerConfigSchemaUnmerged = z\n\t.object({\n\t\tdriver: LegacyDriverConfigSchema.optional(),\n\n\t\t/** @experimental */\n\t\tmaxIncomingMessageSize: z.number().optional().default(65_536),\n\n\t\t/** @experimental */\n\t\tmaxOutgoingMessageSize: z.number().optional().default(1_048_576),\n\n\t\t/** @experimental */\n\t\tinspector: InspectorConfigSchema,\n\n\t\t/** @experimental */\n\t\tdisableDefaultServer: z.boolean().optional().default(false),\n\n\t\t/** @experimental */\n\t\tdefaultServerPort: z.number().default(6420),\n\n\t\t/** @experimental */\n\t\trunEngine: z\n\t\t\t.boolean()\n\t\t\t.optional()\n\t\t\t.default(() => getRivetRunEngine()),\n\n\t\t/** @experimental */\n\t\trunEngineVersion: z\n\t\t\t.string()\n\t\t\t.optional()\n\t\t\t.default(() => getRivetRunEngineVersion() ?? VERSION),\n\n\t\t/** @experimental */\n\t\toverrideServerAddress: z.string().optional(),\n\n\t\t/** @experimental */\n\t\tdisableActorDriver: z.boolean().optional().default(false),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Whether to run runners normally or have them managed\n\t\t * serverlessly (by the Rivet Engine for example).\n\t\t */\n\t\trunnerKind: z\n\t\t\t.enum([\"serverless\", \"normal\"])\n\t\t\t.optional()\n\t\t\t.default(() =>\n\t\t\t\tgetRivetRunnerKind() === \"serverless\" ? \"serverless\" : \"normal\",\n\t\t\t),\n\t\ttotalSlots: z.number().optional(),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Base path for the router. This is used to prefix all routes.\n\t\t * For example, if the base path is `/api`, then the route `/actors` will be\n\t\t * available at `/api/actors`.\n\t\t */\n\t\tbasePath: z.string().optional().default(\"/\"),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Disable welcome message.\n\t\t * */\n\t\tnoWelcome: z.boolean().optional().default(false),\n\n\t\t/**\n\t\t * @experimental\n\t\t * */\n\t\tlogging: z\n\t\t\t.object({\n\t\t\t\tbaseLogger: z.custom<Logger>().optional(),\n\t\t\t\tlevel: LogLevelSchema.optional(),\n\t\t\t})\n\t\t\t.optional()\n\t\t\t.default(() => ({})),\n\n\t\t/**\n\t\t * @experimental\n\t\t *\n\t\t * Automatically configure serverless runners in the engine.\n\t\t * Can only be used when runnerKind is \"serverless\".\n\t\t * If true, uses default configuration. Can also provide custom configuration.\n\t\t */\n\t\tautoConfigureServerless: z\n\t\t\t.union([\n\t\t\t\tz.boolean(),\n\t\t\t\tz.object({\n\t\t\t\t\turl: z.string().optional(),\n\t\t\t\t\theaders: z.record(z.string(), z.string()).optional(),\n\t\t\t\t\tmaxRunners: z.number().optional(),\n\t\t\t\t\tminRunners: z.number().optional(),\n\t\t\t\t\trequestLifespan: z.number().optional(),\n\t\t\t\t\trunnersMargin: z.number().optional(),\n\t\t\t\t\tslotsPerRunner: z.number().optional(),\n\t\t\t\t\tmetadata: z.record(z.string(), z.unknown()).optional(),\n\t\t\t\t}),\n\t\t\t])\n\t\t\t.optional(),\n\n\t\t// This is a function to allow for lazy configuration of upgradeWebSocket on the\n\t\t// fly. This is required since the dependencies that upgradeWebSocket\n\t\t// (specifically Node.js) can sometimes only be specified after the router is\n\t\t// created or must be imported async using `await import(...)`\n\t\tgetUpgradeWebSocket: z.custom<GetUpgradeWebSocket>().optional(),\n\n\t\t/** @experimental */\n\t\ttoken: z\n\t\t\t.string()\n\t\t\t.optional()\n\t\t\t.transform((v) => v || getRivetToken()),\n\t})\n\t.merge(EngineConfigSchemaBase);\n\nconst LegacyRunnerConfigSchemaTransformed =\n\tLegacyRunnerConfigSchemaUnmerged.transform((config, ctx) => ({\n\t\t...config,\n\t\t...transformEngineConfig(config, ctx),\n\t}));\n\nexport const LegacyRunnerConfigSchema =\n\tLegacyRunnerConfigSchemaTransformed.default(() =>\n\t\tLegacyRunnerConfigSchemaTransformed.parse({}),\n\t);\n\nexport type LegacyRunnerConfig = z.infer<typeof LegacyRunnerConfigSchema>;\nexport type LegacyRunnerConfigInput = z.input<typeof LegacyRunnerConfigSchema>;\n","import invariant from \"invariant\";\nimport { createClientWithDriver } from \"@/client/client\";\nimport { configureBaseLogger, configureDefaultLogger } from \"@/common/log\";\nimport { chooseDefaultDriver } from \"@/drivers/default\";\nimport { ENGINE_PORT, ensureEngineProcess } from \"@/engine-process/mod\";\nimport { getInspectorUrl } from \"@/inspector/utils\";\nimport { buildManagerRouter } from \"@/manager/router\";\nimport { configureServerlessRunner } from \"@/serverless/configure\";\nimport type { GetUpgradeWebSocket } from \"@/utils\";\nimport pkg from \"../package.json\" with { type: \"json\" };\nimport {\n\ttype DriverConfig,\n\ttype RegistryActors,\n\ttype RegistryConfig,\n} from \"@/registry/config\";\nimport { logger } from \"../src/registry/log\";\nimport { crossPlatformServe, findFreePort } from \"@/registry/serve\";\nimport { ManagerDriver } from \"@/manager/driver\";\nimport { buildServerlessRouter } from \"@/serverless/router\";\nimport type { Registry } from \"@/registry\";\n\n/** Tracks whether the runtime was started as serverless or runner. */\nexport type StartKind = \"serverless\" | \"runner\";\n\nfunction logLine(label: string, value: string): void {\n\tconst padding = \" \".repeat(Math.max(0, 13 - label.length));\n\tconsole.log(`  - ${label}:${padding}${value}`);\n}\n\n/**\n * Manages the lifecycle of RivetKit.\n *\n * Startup happens in two phases:\n * 1. `Runtime.create()` initializes shared infrastructure like the manager\n *    server and engine process. This runs before we know the deployment mode.\n * 2. `startServerless()` or `startRunner()` configures mode-specific behavior.\n *    These are idempotent and called lazily when the first request arrives\n *    or when explicitly starting a runner.\n */\nexport class Runtime<A extends RegistryActors> {\n\t#registry: Registry<A>;\n\t#config: RegistryConfig;\n\t#driver: DriverConfig;\n\t#managerDriver: ManagerDriver;\n\t#startKind?: StartKind;\n\n\tmanagerPort?: number;\n\t#serverlessRouter?: ReturnType<typeof buildServerlessRouter>[\"router\"];\n\n\tget config() {\n\t\treturn this.#config;\n\t}\n\n\tget driver() {\n\t\treturn this.#driver;\n\t}\n\n\tget managerDriver() {\n\t\treturn this.#managerDriver;\n\t}\n\n\t/** Use Runtime.create() instead */\n\tprivate constructor(\n\t\tregistry: Registry<A>,\n\t\tconfig: RegistryConfig,\n\t\tdriver: DriverConfig,\n\t\tmanagerDriver: ManagerDriver,\n\t\tmanagerPort?: number,\n\t) {\n\t\tthis.#registry = registry;\n\t\tthis.#config = config;\n\t\tthis.#driver = driver;\n\t\tthis.#managerDriver = managerDriver;\n\t\tthis.managerPort = managerPort;\n\t}\n\n\tstatic async create<A extends RegistryActors>(\n\t\tregistry: Registry<A>,\n\t): Promise<Runtime<A>> {\n\t\tlogger().info(\"rivetkit starting\");\n\n\t\tconst config = registry.parseConfig();\n\n\t\tif (config.logging?.baseLogger) {\n\t\t\tconfigureBaseLogger(config.logging.baseLogger);\n\t\t} else {\n\t\t\tconfigureDefaultLogger(config.logging?.level);\n\t\t}\n\n\t\t// This should be unreachable: Zod defaults serveManager to false when\n\t\t// spawnEngine is enabled (since endpoint gets set to ENGINE_ENDPOINT).\n\t\t// We check anyway as a safety net for explicit misconfiguration.\n\t\tinvariant(\n\t\t\t!(config.serverless.spawnEngine && config.serveManager),\n\t\t\t\"cannot specify both spawnEngine and serveManager\",\n\t\t);\n\n\t\tconst driver = chooseDefaultDriver(config);\n\t\tconst managerDriver = driver.manager(config);\n\n\t\t// Start main server. This is either:\n\t\t// - Manager: Run a server in-process on port 6420 that mimics the\n\t\t//   engine's API for development.\n\t\t// - Engine: Download and run the full Rivet engine binary on port\n\t\t//   6420. This is a fallback for platforms that cannot use the manager\n\t\t//   like Next.js.\n\t\t//\n\t\t// We do this before startServerless or startRunner has been called\n\t\t// since the engine API needs to be available on port 6420 before\n\t\t// anything else happens. For example, serverless platforms use\n\t\t// `registry.handler(req)` so `startServerless` is called lazily.\n\t\t// Starting the server preemptively allows for clients to reach 6420\n\t\t// BEFORE `startServerless` is called.\n\t\tlet managerPort: number | undefined;\n\t\tif (config.serverless.spawnEngine) {\n\t\t\tmanagerPort = ENGINE_PORT;\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"spawning engine\",\n\t\t\t\tversion: config.serverless.engineVersion,\n\t\t\t});\n\t\t\tawait ensureEngineProcess({\n\t\t\t\tversion: config.serverless.engineVersion,\n\t\t\t});\n\t\t} else if (config.serveManager) {\n\t\t\tconst configuredManagerPort = config.managerPort;\n\t\t\tlet upgradeWebSocket: any;\n\t\t\tconst getUpgradeWebSocket: GetUpgradeWebSocket = () =>\n\t\t\t\tupgradeWebSocket;\n\t\t\tmanagerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);\n\n\t\t\tconst { router: managerRouter } = buildManagerRouter(\n\t\t\t\tconfig,\n\t\t\t\tmanagerDriver,\n\t\t\t\tgetUpgradeWebSocket,\n\t\t\t);\n\n\t\t\tmanagerPort = await findFreePort(config.managerPort);\n\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"serving manager\",\n\t\t\t\tport: managerPort,\n\t\t\t});\n\n\t\t\t// `publicEndpoint` is derived from `config.managerPort` during config parsing,\n\t\t\t// but we may have chosen a different free port at runtime. Keep them in sync\n\t\t\t// so browser clients that rely on `/metadata` connect to the correct manager.\n\t\t\t//\n\t\t\t// Only rewrite when `publicEndpoint` is still on the default localhost pattern,\n\t\t\t// to avoid clobbering explicitly-configured public endpoints.\n\t\t\tif (\n\t\t\t\tconfig.publicEndpoint ===\n\t\t\t\t`http://127.0.0.1:${configuredManagerPort}`\n\t\t\t) {\n\t\t\t\tconfig.publicEndpoint = `http://127.0.0.1:${managerPort}`;\n\t\t\t\tconfig.serverless.publicEndpoint = config.publicEndpoint;\n\t\t\t}\n\t\t\tconfig.managerPort = managerPort;\n\n\t\t\tconst out = await crossPlatformServe(\n\t\t\t\tconfig,\n\t\t\t\tmanagerPort,\n\t\t\t\tmanagerRouter,\n\t\t\t);\n\t\t\tupgradeWebSocket = out.upgradeWebSocket;\n\t\t}\n\n\t\t// Create runtime\n\t\tconst runtime = new Runtime(\n\t\t\tregistry,\n\t\t\tconfig,\n\t\t\tdriver,\n\t\t\tmanagerDriver,\n\t\t\tmanagerPort,\n\t\t);\n\n\t\t// Log ready\n\t\tconst driverLog = managerDriver.extraStartupLog?.() ?? {};\n\t\tlogger().info({\n\t\t\tmsg: \"rivetkit ready\",\n\t\t\tdriver: driver.name,\n\t\t\tdefinitions: Object.keys(config.use).length,\n\t\t\t...driverLog,\n\t\t});\n\n\t\treturn runtime;\n\t}\n\n\tstartServerless(): void {\n\t\tif (this.#startKind === \"serverless\") return;\n\t\tinvariant(!this.#startKind, \"Runtime already started as runner\");\n\t\tthis.#startKind = \"serverless\";\n\n\t\tthis.#serverlessRouter = buildServerlessRouter(\n\t\t\tthis.#driver,\n\t\t\tthis.#config,\n\t\t).router;\n\n\t\tthis.#printWelcome();\n\n\t\tif (this.#config.serverless.configureRunnerPool) {\n\t\t\t// biome-ignore lint/nursery/noFloatingPromises: intentional\n\t\t\tconfigureServerlessRunner(this.#config);\n\t\t}\n\t}\n\n\tstartRunner(): void {\n\t\tif (this.#startKind === \"runner\") return;\n\t\tinvariant(!this.#startKind, \"Runtime already started as serverless\");\n\t\tthis.#startKind = \"runner\";\n\n\t\tif (this.#config.runner && this.#driver.autoStartActorDriver) {\n\t\t\tlogger().debug(\"starting actor driver\");\n\t\t\tconst inlineClient = createClientWithDriver<Registry<A>>(\n\t\t\t\tthis.#managerDriver,\n\t\t\t);\n\t\t\tthis.#driver.actor(this.#config, this.#managerDriver, inlineClient);\n\t\t}\n\n\t\tthis.#printWelcome();\n\t}\n\n\t#printWelcome(): void {\n\t\tif (this.#config.noWelcome) return;\n\n\t\tconst inspectorUrl = this.managerPort\n\t\t\t? getInspectorUrl(this.#config, this.managerPort)\n\t\t\t: undefined;\n\n\t\tconsole.log();\n\t\tconsole.log(\n\t\t\t`  RivetKit ${pkg.version} (${this.#driver.displayName} - ${this.#startKind === \"serverless\" ? \"Serverless\" : \"Runner\"})`,\n\t\t);\n\n\t\t// Show namespace\n\t\tif (this.#config.namespace !== \"default\") {\n\t\t\tlogLine(\"Namespace\", this.#config.namespace);\n\t\t}\n\n\t\t// Show backend endpoint (where we connect to engine)\n\t\tif (this.#config.endpoint) {\n\t\t\tconst endpointType = this.#config.serverless.spawnEngine\n\t\t\t\t? \"local native\"\n\t\t\t\t: this.#config.serveManager\n\t\t\t\t\t? \"local manager\"\n\t\t\t\t\t: \"remote\";\n\t\t\tlogLine(\"Endpoint\", `${this.#config.endpoint} (${endpointType})`);\n\t\t}\n\n\t\t// Show public endpoint (where clients connect)\n\t\tif (this.#startKind === \"serverless\" && this.#config.publicEndpoint) {\n\t\t\tlogLine(\"Client\", this.#config.publicEndpoint);\n\t\t}\n\n\t\t// Show inspector\n\t\tif (inspectorUrl && this.#config.inspector.enabled) {\n\t\t\tlogLine(\"Inspector\", inspectorUrl);\n\t\t}\n\n\t\t// Show actor count\n\t\tconst actorCount = Object.keys(this.#config.use).length;\n\t\tlogLine(\"Actors\", actorCount.toString());\n\n\t\t// Show driver-specific info\n\t\tconst displayInfo = this.#managerDriver.displayInformation();\n\t\tfor (const [k, v] of Object.entries(displayInfo.properties)) {\n\t\t\tlogLine(k, v);\n\t\t}\n\n\t\tconsole.log();\n\t}\n\n\t/** Handle serverless request */\n\thandleServerlessRequest(request: Request): Response | Promise<Response> {\n\t\tinvariant(\n\t\t\tthis.#startKind === \"serverless\",\n\t\t\t\"not started as serverless\",\n\t\t);\n\t\tinvariant(this.#serverlessRouter, \"serverless router not initialized\");\n\t\treturn this.#serverlessRouter.fetch(request);\n\t}\n}\n","import { UserError } from \"@/actor/errors\";\nimport { loggerWithoutContext } from \"@/actor/log\";\nimport { createEngineDriver } from \"@/drivers/engine/mod\";\nimport { createFileSystemOrMemoryDriver } from \"@/drivers/file-system/mod\";\nimport { DriverConfig, RegistryConfig } from \"@/registry/config\";\n\n/**\n * Chooses the appropriate driver based on the run configuration.\n */\nexport function chooseDefaultDriver(\n\tconfig: RegistryConfig,\n): DriverConfig {\n\tif (config.endpoint && config.driver) {\n\t\tthrow new UserError(\n\t\t\t\"Cannot specify both 'endpoint' and 'driver' in configuration\",\n\t\t);\n\t}\n\n\tif (config.driver) {\n\t\treturn config.driver;\n\t}\n\n\tif (config.endpoint || config.token) {\n\t\tloggerWithoutContext().debug({\n\t\t\tmsg: \"using rivet engine driver\",\n\t\t\tendpoint: config.endpoint,\n\t\t});\n\t\treturn createEngineDriver();\n\t}\n\n\tloggerWithoutContext().debug({\n\t\tmsg: \"using default file system driver\",\n\t\tstoragePath: config.storagePath,\n\t});\n\treturn createFileSystemOrMemoryDriver(true, {\n\t\tpath: config.storagePath,\n\t});\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"engine-process\");\n}\n","import {\n\tensureDirectoryExists,\n\tgetStoragePath,\n} from \"@/drivers/file-system/utils\";\nimport {\n\tgetNodeChildProcess,\n\tgetNodeCrypto,\n\tgetNodeFs,\n\tgetNodeFsSync,\n\tgetNodePath,\n\tgetNodeStream,\n\timportNodeDependencies,\n} from \"@/utils/node\";\nimport { logger } from \"./log\";\nimport { ENGINE_ENDPOINT, ENGINE_PORT } from \"./constants\";\n\nexport { ENGINE_ENDPOINT, ENGINE_PORT };\n\nconst ENGINE_BASE_URL = \"https://releases.rivet.dev/rivet\";\nconst ENGINE_BINARY_NAME = \"rivet-engine\";\n\ninterface EnsureEngineProcessOptions {\n\tversion: string;\n}\n\nexport async function ensureEngineProcess(\n\toptions: EnsureEngineProcessOptions,\n): Promise<void> {\n\timportNodeDependencies();\n\n\tlogger().debug({\n\t\tmsg: \"ensuring engine process\",\n\t\tversion: options.version,\n\t});\n\n\tconst path = getNodePath();\n\tconst storageRoot = getStoragePath();\n\tconst binDir = path.join(storageRoot, \"bin\");\n\tconst varDir = path.join(storageRoot, \"var\");\n\tconst logsDir = path.join(varDir, \"logs\", \"rivet-engine\");\n\tawait ensureDirectoryExists(binDir);\n\tawait ensureDirectoryExists(varDir);\n\tawait ensureDirectoryExists(logsDir);\n\n\t// Check if the engine is already running on the port before downloading\n\tif (await isEngineRunning()) {\n\t\ttry {\n\t\t\tconst health = await waitForEngineHealth();\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"engine already running and healthy\",\n\t\t\t\tversion: health.version,\n\t\t\t});\n\t\t\treturn;\n\t\t} catch (error) {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"existing engine process not healthy, cannot restart automatically\",\n\t\t\t\terror,\n\t\t\t});\n\t\t\tthrow new Error(\n\t\t\t\t\"Engine process exists but is not healthy. Please manually stop the process on port 6420 and retry.\",\n\t\t\t);\n\t\t}\n\t}\n\n\tconst executableName =\n\t\tprocess.platform === \"win32\"\n\t\t\t? `${ENGINE_BINARY_NAME}-${options.version}.exe`\n\t\t\t: `${ENGINE_BINARY_NAME}-${options.version}`;\n\tconst binaryPath = path.join(binDir, executableName);\n\tawait downloadEngineBinaryIfNeeded(binaryPath, options.version, varDir);\n\t// Create log file streams with timestamp in the filename\n\tconst timestamp = new Date()\n\t\t.toISOString()\n\t\t.replace(/:/g, \"-\")\n\t\t.replace(/\\./g, \"-\");\n\tconst stdoutLogPath = path.join(logsDir, `engine-${timestamp}-stdout.log`);\n\tconst stderrLogPath = path.join(logsDir, `engine-${timestamp}-stderr.log`);\n\n\tconst fsSync = getNodeFsSync();\n\tconst stdoutStream = fsSync.createWriteStream(stdoutLogPath, {\n\t\tflags: \"a\",\n\t});\n\tconst stderrStream = fsSync.createWriteStream(stderrLogPath, {\n\t\tflags: \"a\",\n\t});\n\n\tlogger().debug({\n\t\tmsg: \"creating engine log files\",\n\t\tstdout: stdoutLogPath,\n\t\tstderr: stderrLogPath,\n\t});\n\n\tconst childProcess = getNodeChildProcess();\n\tconst child = childProcess.spawn(binaryPath, [\"start\"], {\n\t\tcwd: path.dirname(binaryPath),\n\t\tstdio: [\"inherit\", \"pipe\", \"pipe\"],\n\t\tenv: {\n\t\t\t...process.env,\n\t\t\t// Development environment overrides for Rivet Engine.\n\t\t\t//\n\t\t\t// NOTE: When modifying these env vars, also update scripts/run/dev-env.sh\n\t\t\t// to keep them in sync for manual engine runs.\n\t\t\t//\n\t\t\t// In development, runners can be terminated without a graceful\n\t\t\t// shutdown (i.e. SIGKILL instead of SIGTERM). This is treated as a\n\t\t\t// crash by Rivet Engine in production and implements a backoff for\n\t\t\t// rescheduling actors in case of a crash loop.\n\t\t\t//\n\t\t\t// This is problematic in development since this will cause actors\n\t\t\t// to become unresponsive if frequently killing your dev server.\n\t\t\t//\n\t\t\t// We reduce the timeouts for resetting a runner as healthy in\n\t\t\t// order to account for this.\n\t\t\tRIVET__PEGBOARD__RETRY_RESET_DURATION: \"100\",\n\t\t\tRIVET__PEGBOARD__BASE_RETRY_TIMEOUT: \"100\",\n\t\t\t// Set max exponent to 1 to have a maximum of base_retry_timeout\n\t\t\tRIVET__PEGBOARD__RESCHEDULE_BACKOFF_MAX_EXPONENT: \"1\",\n\t\t\t// Reduce thresholds for faster development iteration\n\t\t\t//\n\t\t\t// Default ping interval is 3s, this gives a 2s & 4s grace\n\t\t\tRIVET__PEGBOARD__RUNNER_ELIGIBLE_THRESHOLD: \"5000\",\n\t\t\tRIVET__PEGBOARD__RUNNER_LOST_THRESHOLD: \"7000\",\n\t\t\t// Allow faster metadata polling for hot-reload in development (in milliseconds)\n\t\t\tRIVET__PEGBOARD__MIN_METADATA_POLL_INTERVAL: \"1000\",\n\t\t\t// Reduce shutdown durations for faster development iteration (in seconds)\n\t\t\tRIVET__RUNTIME__WORKER__SHUTDOWN_DURATION: \"1\",\n\t\t\tRIVET__RUNTIME__GUARD_SHUTDOWN_DURATION: \"1\",\n\t\t\t// Force exit after this duration (must be > worker and guard shutdown durations)\n\t\t\tRIVET__RUNTIME__FORCE_SHUTDOWN_DURATION: \"2\",\n\t\t},\n\t});\n\n\tif (!child.pid) {\n\t\tthrow new Error(\"failed to spawn rivet engine process\");\n\t}\n\n\t// Pipe stdout and stderr to log files\n\tif (child.stdout) {\n\t\tchild.stdout.pipe(stdoutStream);\n\t}\n\t// Collect stderr for error detection\n\tconst stderrChunks: Buffer[] = [];\n\tif (child.stderr) {\n\t\tchild.stderr.on(\"data\", (chunk: Buffer) => {\n\t\t\tstderrChunks.push(chunk);\n\t\t});\n\t\tchild.stderr.pipe(stderrStream);\n\t}\n\tlogger().debug({\n\t\tmsg: \"spawned engine process\",\n\t\tpid: child.pid,\n\t\tcwd: path.dirname(binaryPath),\n\t});\n\n\tchild.once(\"exit\", (code, signal) => {\n\t\tconst stderrOutput = Buffer.concat(stderrChunks).toString(\"utf-8\");\n\n\t\t// Check for specific error conditions\n\t\tif (stderrOutput.includes(\"LOCK: Resource temporarily unavailable\")) {\n\t\t\tlogger().error({\n\t\t\t\tmsg: \"another instance of rivet engine is unexpectedly running, this is an internal error\",\n\t\t\t\tcode,\n\t\t\t\tsignal,\n\t\t\t\tstdoutLog: stdoutLogPath,\n\t\t\t\tstderrLog: stderrLogPath,\n\t\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t});\n\t\t} else if (stderrOutput.includes(\"Rivet Engine has been rolled back to a previous version\")) {\n\t\t\tlogger().error({\n\t\t\t\tmsg: \"rivet engine version downgrade detected\",\n\t\t\t\thint: `You attempted to downgrade the RivetKit version in development. To fix this, nuke the database by running: '${binaryPath}' database nuke --yes`,\n\t\t\t\tcode,\n\t\t\t\tsignal,\n\t\t\t\tstdoutLog: stdoutLogPath,\n\t\t\t\tstderrLog: stderrLogPath,\n\t\t\t});\n\t\t} else {\n\t\t\tlogger().warn({\n\t\t\t\tmsg: \"engine process exited, please report this error\",\n\t\t\t\tcode,\n\t\t\t\tsignal,\n\t\t\t\tstdoutLog: stdoutLogPath,\n\t\t\t\tstderrLog: stderrLogPath,\n\t\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t});\n\t\t}\n\t\t// Clean up log streams\n\t\tstdoutStream.end();\n\t\tstderrStream.end();\n\t});\n\n\tchild.once(\"error\", (error) => {\n\t\tlogger().error({\n\t\t\tmsg: \"engine process failed\",\n\t\t\terror,\n\t\t});\n\t\t// Clean up log streams on error\n\t\tstdoutStream.end();\n\t\tstderrStream.end();\n\t});\n\n\t// Wait for engine to be ready\n\tawait waitForEngineHealth();\n\n\tlogger().info({\n\t\tmsg: \"engine process started\",\n\t\tpid: child.pid,\n\t\tversion: options.version,\n\t\tlogs: {\n\t\t\tstdout: stdoutLogPath,\n\t\t\tstderr: stderrLogPath,\n\t\t},\n\t});\n}\n\nasync function downloadEngineBinaryIfNeeded(\n\tbinaryPath: string,\n\tversion: string,\n\tvarDir: string,\n): Promise<void> {\n\tconst binaryExists = await fileExists(binaryPath);\n\tif (binaryExists) {\n\t\tlogger().debug({\n\t\t\tmsg: \"engine binary already cached\",\n\t\t\tversion,\n\t\t\tpath: binaryPath,\n\t\t});\n\t\treturn;\n\t}\n\n\tconst { targetTriplet, extension } = resolveTargetTriplet();\n\tconst remoteFile = `${ENGINE_BINARY_NAME}-${targetTriplet}${extension}`;\n\tconst downloadUrl = `${ENGINE_BASE_URL}/${version}/engine/${remoteFile}`;\n\tlogger().info({\n\t\tmsg: \"downloading engine binary\",\n\t\turl: downloadUrl,\n\t\tpath: binaryPath,\n\t\tversion,\n\t});\n\n\tconst response = await fetch(downloadUrl);\n\tif (!response.ok || !response.body) {\n\t\tthrow new Error(\n\t\t\t`failed to download rivet engine binary from ${downloadUrl}: ${response.status} ${response.statusText}`,\n\t\t);\n\t}\n\n\t// Generate unique temp file name to prevent parallel download conflicts\n\tconst crypto = getNodeCrypto();\n\tconst tempPath = `${binaryPath}.${crypto.randomUUID()}.tmp`;\n\tconst startTime = Date.now();\n\n\tlogger().debug({\n\t\tmsg: \"starting binary download\",\n\t\ttempPath,\n\t\tcontentLength: response.headers.get(\"content-length\"),\n\t});\n\n\t// Warn user if download is taking a long time\n\tconst slowDownloadWarning = setTimeout(() => {\n\t\tlogger().warn({\n\t\t\tmsg: \"engine binary download is taking longer than expected, please be patient\",\n\t\t\tversion,\n\t\t});\n\t}, 5000);\n\n\ttry {\n\t\tconst stream = getNodeStream();\n\t\tconst fsSync = getNodeFsSync();\n\t\tawait stream.pipeline(\n\t\t\tresponse.body as any,\n\t\t\tfsSync.createWriteStream(tempPath),\n\t\t);\n\n\t\t// Clear the slow download warning\n\t\tclearTimeout(slowDownloadWarning);\n\n\t\t// Get file size to verify download\n\t\tconst fs = getNodeFs();\n\t\tconst stats = await fs.stat(tempPath);\n\t\tconst downloadDuration = Date.now() - startTime;\n\n\t\tif (process.platform !== \"win32\") {\n\t\t\tawait fs.chmod(tempPath, 0o755);\n\t\t}\n\t\tawait fs.rename(tempPath, binaryPath);\n\n\t\tlogger().debug({\n\t\t\tmsg: \"engine binary download complete\",\n\t\t\tversion,\n\t\t\tpath: binaryPath,\n\t\t\tsize: stats.size,\n\t\t\tdurationMs: downloadDuration,\n\t\t});\n\t\tlogger().info({\n\t\t\tmsg: \"engine binary downloaded\",\n\t\t\tversion,\n\t\t\tpath: binaryPath,\n\t\t});\n\t} catch (error) {\n\t\t// Clear the slow download warning\n\t\tclearTimeout(slowDownloadWarning);\n\n\t\t// Clean up partial temp file on error\n\t\tlogger().warn({\n\t\t\tmsg: \"engine download failed, please report this error\",\n\t\t\ttempPath,\n\t\t\terror,\n\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t});\n\t\ttry {\n\t\t\tconst fs = getNodeFs();\n\t\t\tawait fs.unlink(tempPath);\n\t\t} catch (unlinkError) {\n\t\t\t// Ignore errors when cleaning up (file may not exist)\n\t\t}\n\t\tthrow error;\n\t}\n}\n//\nfunction resolveTargetTriplet(): { targetTriplet: string; extension: string } {\n\treturn resolveTargetTripletFor(process.platform, process.arch);\n}\n\nexport function resolveTargetTripletFor(\n\tplatform: NodeJS.Platform,\n\tarch: typeof process.arch,\n): { targetTriplet: string; extension: string } {\n\tswitch (platform) {\n\t\tcase \"darwin\":\n\t\t\tif (arch === \"arm64\") {\n\t\t\t\treturn { targetTriplet: \"aarch64-apple-darwin\", extension: \"\" };\n\t\t\t}\n\t\t\tif (arch === \"x64\") {\n\t\t\t\treturn { targetTriplet: \"x86_64-apple-darwin\", extension: \"\" };\n\t\t\t}\n\t\t\tbreak;\n\t\tcase \"linux\":\n\t\t\tif (arch === \"x64\") {\n\t\t\t\treturn {\n\t\t\t\t\ttargetTriplet: \"x86_64-unknown-linux-musl\",\n\t\t\t\t\textension: \"\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tbreak;\n\t\tcase \"win32\":\n\t\t\tif (arch === \"x64\") {\n\t\t\t\treturn {\n\t\t\t\t\ttargetTriplet: \"x86_64-pc-windows-gnu\",\n\t\t\t\t\textension: \".exe\",\n\t\t\t\t};\n\t\t\t}\n\t\t\tbreak;\n\t}\n\n\tthrow new Error(\n\t\t`unsupported platform for rivet engine binary: ${platform}/${arch}`,\n\t);\n}\nasync function isEngineRunning(): Promise<boolean> {\n\t// Check if the engine is running on the port\n\treturn await checkIfEngineAlreadyRunningOnPort(ENGINE_PORT);\n}\n\nasync function checkIfEngineAlreadyRunningOnPort(\n\tport: number,\n): Promise<boolean> {\n\tlet response: Response;\n\ttry {\n\t\tresponse = await fetch(`http://127.0.0.1:${port}/health`);\n\t} catch (err) {\n\t\t// Nothing is running on this port\n\t\treturn false;\n\t}\n\n\tif (response.ok) {\n\t\tconst health = (await response.json()) as EngineHealthResponse;\n\n\t\t// Check what's running on this port\n\t\tif (health.runtime === \"engine\") {\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"rivet engine already running on port\",\n\t\t\t\tport,\n\t\t\t});\n\t\t\treturn true;\n\t\t} else if (health.runtime === \"rivetkit\") {\n\t\t\tlogger().error({\n\t\t\t\tmsg: \"another rivetkit process is already running on port\",\n\t\t\t\tport,\n\t\t\t});\n\t\t\tthrow new Error(\n\t\t\t\t\"RivetKit process already running on port 6420, stop that process and restart this.\",\n\t\t\t);\n\t\t} else {\n\t\t\tthrow new Error(\n\t\t\t\t\"Unknown process running on port 6420, cannot identify what it is.\",\n\t\t\t);\n\t\t}\n\t}\n\n\t// Port responded but not with OK status\n\treturn false;\n}\nasync function fileExists(filePath: string): Promise<boolean> {\n\ttry {\n\t\tconst fs = getNodeFs();\n\t\tawait fs.access(filePath);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nconst HEALTH_MAX_WAIT = 10_000;\nconst HEALTH_INTERVAL = 100;\n\ninterface EngineHealthResponse {\n\tstatus?: string;\n\truntime?: string;\n\tversion?: string;\n}\n\nasync function waitForEngineHealth(): Promise<EngineHealthResponse> {\n\tconst maxRetries = Math.ceil(HEALTH_MAX_WAIT / HEALTH_INTERVAL);\n\n\tlogger().debug({ msg: \"waiting for engine health check\" });\n\n\tfor (let i = 0; i < maxRetries; i++) {\n\t\ttry {\n\t\t\tconst response = await fetch(`${ENGINE_ENDPOINT}/health`, {\n\t\t\t\tsignal: AbortSignal.timeout(1000),\n\t\t\t});\n\t\t\tif (response.ok) {\n\t\t\t\tconst health = (await response.json()) as EngineHealthResponse;\n\t\t\t\tlogger().debug({ msg: \"engine health check passed\" });\n\t\t\t\treturn health;\n\t\t\t}\n\t\t} catch (error) {\n\t\t\t// Expected to fail while engine is starting up\n\t\t\tlogger().debug({ msg: \"engine health check failed\", error });\n\t\t\tif (i === maxRetries - 1) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`engine health check failed after ${maxRetries} retries: ${error}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (i < maxRetries - 1) {\n\t\t\tlogger().trace({\n\t\t\t\tmsg: \"engine not ready, retrying\",\n\t\t\t\tattempt: i + 1,\n\t\t\t\tmaxRetries,\n\t\t\t});\n\t\t\tawait new Promise((resolve) =>\n\t\t\t\tsetTimeout(resolve, HEALTH_INTERVAL),\n\t\t\t);\n\t\t}\n\t}\n\n\tthrow new Error(`engine health check failed after ${maxRetries} retries`);\n}\n","import { createMiddleware } from \"hono/factory\";\nimport type { RegistryConfig } from \"@/registry/config\";\nimport { timingSafeEqual } from \"@/utils/crypto\";\n\nexport const secureInspector = (config: RegistryConfig) =>\n\tcreateMiddleware(async (c, next) => {\n\t\tconst userToken = c.req.header(\"Authorization\")?.replace(\"Bearer \", \"\");\n\t\tif (!userToken) {\n\t\t\treturn c.text(\"Unauthorized\", 401);\n\t\t}\n\n\t\tconst inspectorToken = config.inspector.token();\n\t\tif (!inspectorToken) {\n\t\t\treturn c.text(\"Unauthorized\", 401);\n\t\t}\n\n\t\tif (!timingSafeEqual(userToken, inspectorToken)) {\n\t\t\treturn c.text(\"Unauthorized\", 401);\n\t\t}\n\t\tawait next();\n\t});\n\nexport function getInspectorUrl(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n): string | undefined {\n\tif (!config.inspector.enabled) return undefined;\n\n\tconst base =\n\t\tconfig.inspector.defaultEndpoint ?? `http://127.0.0.1:${managerPort}`;\n\treturn new URL(\"/ui/\", base).href;\n}\n","import { getLogger } from \"@/common//log\";\n\nexport function logger() {\n\treturn getLogger(\"serverless\");\n}\n","import { RegistryConfig } from \"@/registry/config\";\nimport { logger } from \"./log\";\nimport invariant from \"invariant\";\nimport { convertRegistryConfigToClientConfig } from \"@/client/config\";\nimport {\n\tgetDatacenters,\n\tupdateRunnerConfig,\n} from \"@/remote-manager-driver/api-endpoints\";\n\nexport async function configureServerlessRunner(\n\tconfig: RegistryConfig,\n): Promise<void> {\n\tlogger().debug(\"configuring serverless runner\");\n\n\ttry {\n\t\t// Ensure we have required config values\n\t\tif (!config.namespace) {\n\t\t\tthrow new Error(\n\t\t\t\t\"namespace is required for serverless configuration\",\n\t\t\t);\n\t\t}\n\t\tif (!config.endpoint) {\n\t\t\tthrow new Error(\n\t\t\t\t\"endpoint is required for serverless configuration\",\n\t\t\t);\n\t\t}\n\n\t\t// Prepare the configuration\n\t\tconst customConfig = config.serverless.configureRunnerPool;\n\t\tinvariant(customConfig, \"configureRunnerPool should exist\");\n\n\t\tconst clientConfig = convertRegistryConfigToClientConfig(config);\n\n\t\t// Fetch all datacenters\n\t\tlogger().debug({\n\t\t\tmsg: \"fetching datacenters\",\n\t\t\tendpoint: config.endpoint,\n\t\t});\n\t\tconst dcsRes = await getDatacenters(clientConfig);\n\n\t\t// Build the request body\n\t\tconst runnerName = customConfig.name ?? \"default\";\n\t\tlogger().debug({\n\t\t\tmsg: \"configuring serverless runner\",\n\t\t\trunnerName,\n\t\t\tnamespace: config.namespace,\n\t\t});\n\t\tconst serverlessConfig = {\n\t\t\tserverless: {\n\t\t\t\turl: customConfig.url,\n\t\t\t\theaders: customConfig.headers ?? {},\n\t\t\t\tmax_runners: customConfig.maxRunners ?? 1000,\n\t\t\t\tmin_runners: customConfig.minRunners ?? 0,\n\t\t\t\trequest_lifespan: customConfig.requestLifespan ?? 15 * 60,\n\t\t\t\trunners_margin: customConfig.runnersMargin ?? 0,\n\t\t\t\tslots_per_runner: customConfig.slotsPerRunner ?? 1,\n\t\t\t\tmetadata_poll_interval: customConfig.metadataPollInterval ?? 1000,\n\t\t\t},\n\t\t\tmetadata: customConfig.metadata ?? {},\n\t\t\tdrain_on_version_upgrade: customConfig.drainOnVersionUpgrade ?? true,\n\t\t\tmetadataPollInterval: customConfig.metadataPollInterval ?? 1000,\n\t\t};\n\t\tawait updateRunnerConfig(clientConfig, runnerName, {\n\t\t\tdatacenters: Object.fromEntries(\n\t\t\t\tdcsRes.datacenters.map((dc) => [dc.name, serverlessConfig]),\n\t\t\t),\n\t\t});\n\n\t\tlogger().info({\n\t\t\tmsg: \"serverless runner configured successfully\",\n\t\t\trunnerName,\n\t\t\tnamespace: config.namespace,\n\t\t});\n\t} catch (error) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to configure serverless runner, validate endpoint is configured correctly then restart this process\",\n\t\t\terror,\n\t\t});\n\n\t\t// Don't throw, allow the runner to continue\n\t}\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"registry\");\n}\n","import type { Hono } from \"hono\";\nimport { detectRuntime, stringifyError } from \"../utils\";\nimport { logger } from \"./log\";\nimport { RegistryConfig } from \"./config\";\n\n// TODO: Go back to dynamic import for this\nimport getPort from \"get-port\";\n\nconst DEFAULT_PORT = 6420;\n\n/**\n * Finds a free port starting from the given port.\n *\n * Tries ports incrementally until a free one is found.\n */\nexport async function findFreePort(\n\tstartPort: number = DEFAULT_PORT,\n): Promise<number> {\n\t// TODO: Fix this\n\t// const getPortModule = \"get-port\";\n\t// const { default: getPort } = await import(/* webpackIgnore: true */ getPortModule);\n\n\t// Create an iterable of ports starting from startPort\n\tfunction* portRange(start: number, count: number = 100): Iterable<number> {\n\t\tfor (let i = 0; i < count; i++) {\n\t\t\tyield start + i;\n\t\t}\n\t}\n\n\treturn getPort({ port: portRange(startPort) });\n}\n\nexport async function crossPlatformServe(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\tconst runtime = detectRuntime();\n\tlogger().debug({ msg: \"detected runtime for serve\", runtime });\n\n\tswitch (runtime) {\n\t\tcase \"deno\":\n\t\t\treturn serveDeno(config, managerPort, app);\n\t\tcase \"bun\":\n\t\t\treturn serveBun(config, managerPort, app);\n\t\tcase \"node\":\n\t\t\treturn serveNode(config, managerPort, app);\n\t\tdefault:\n\t\t\treturn serveNode(config, managerPort, app);\n\t}\n}\n\nasync function serveNode(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\t// Import @hono/node-server using string variable to prevent static analysis\n\tconst nodeServerModule = \"@hono/node-server\";\n\tlet serve: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\tnodeServerModule\n\t\t);\n\t\tserve = dep.serve;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import @hono/node-server. please run 'npm install @hono/node-server @hono/node-ws'\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\t// Import @hono/node-ws using string variable to prevent static analysis\n\tconst nodeWsModule = \"@hono/node-ws\";\n\tlet createNodeWebSocket: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\tnodeWsModule\n\t\t);\n\t\tcreateNodeWebSocket = dep.createNodeWebSocket;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import @hono/node-ws. please run 'npm install @hono/node-server @hono/node-ws'\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\t// Inject WS\n\tconst { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({\n\t\tapp: app,\n\t});\n\n\t// Start server\n\tconst port = managerPort;\n\tconst hostname = config.managerHost;\n\tconst server = serve({ fetch: app.fetch, port, hostname }, () =>\n\t\tlogger().info({ msg: \"server listening\", port, hostname }),\n\t);\n\tinjectWebSocket(server);\n\n\treturn { upgradeWebSocket };\n}\n\nasync function serveDeno(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\t// Import hono/deno using string variable to prevent static analysis\n\tconst honoDenoModule = \"hono/deno\";\n\tlet upgradeWebSocket: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\thonoDenoModule\n\t\t);\n\t\tupgradeWebSocket = dep.upgradeWebSocket;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import hono/deno\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\tconst port = config.managerPort;\n\tconst hostname = config.managerHost;\n\n\t// Use Deno.serve\n\tDeno.serve({ port, hostname }, app.fetch);\n\tlogger().info({ msg: \"server listening\", port, hostname });\n\n\treturn { upgradeWebSocket };\n}\n\nasync function serveBun(\n\tconfig: RegistryConfig,\n\tmanagerPort: number,\n\tapp: Hono<any>,\n): Promise<{ upgradeWebSocket: any }> {\n\t// Import hono/bun using string variable to prevent static analysis\n\tconst honoBunModule = \"hono/bun\";\n\tlet createBunWebSocket: any;\n\ttry {\n\t\tconst dep = await import(\n\t\t\t/* webpackIgnore: true */\n\t\t\thonoBunModule\n\t\t);\n\t\tcreateBunWebSocket = dep.createBunWebSocket;\n\t} catch (err) {\n\t\tlogger().error({\n\t\t\tmsg: \"failed to import hono/bun\",\n\t\t\terror: stringifyError(err),\n\t\t});\n\t\tprocess.exit(1);\n\t}\n\n\tconst { websocket, upgradeWebSocket } = createBunWebSocket();\n\n\tconst port = config.managerPort;\n\tconst hostname = config.managerHost;\n\n\t// Use Bun.serve\n\t// @ts-expect-error - Bun global\n\tBun.serve({\n\t\tfetch: app.fetch,\n\t\tport,\n\t\thostname,\n\t\twebsocket,\n\t});\n\tlogger().info({ msg: \"server listening\", port, hostname });\n\n\treturn { upgradeWebSocket };\n}\n","import invariant from \"invariant\";\nimport {\n\tEndpointMismatch,\n\tInvalidRequest,\n\tNamespaceMismatch,\n} from \"@/actor/errors\";\nimport { convertRegistryConfigToClientConfig } from \"@/client/config\";\nimport { handleHealthRequest, handleMetadataRequest } from \"@/common/router\";\nimport { ServerlessStartHeadersSchema } from \"@/manager/router-schema\";\nimport { createClientWithDriver } from \"@/mod\";\nimport type { DriverConfig, RegistryConfig } from \"@/registry/config\";\nimport { RemoteManagerDriver } from \"@/remote-manager-driver/mod\";\nimport { createRouter } from \"@/utils/router\";\nimport { logger } from \"./log\";\n\nexport function buildServerlessRouter(\n\tdriverConfig: DriverConfig,\n\tconfig: RegistryConfig,\n) {\n\treturn createRouter(config.serverless.basePath, (router) => {\n\t\t// GET /\n\t\trouter.get(\"/\", (c) => {\n\t\t\treturn c.text(\n\t\t\t\t\"This is a RivetKit server.\\n\\nLearn more at https://rivetkit.org\",\n\t\t\t);\n\t\t});\n\n\t\t// Serverless start endpoint\n\t\trouter.get(\"/start\", async (c) => {\n\t\t\t// Parse headers\n\t\t\tconst parseResult = ServerlessStartHeadersSchema.safeParse({\n\t\t\t\tendpoint: c.req.header(\"x-rivet-endpoint\"),\n\t\t\t\ttoken: c.req.header(\"x-rivet-token\") ?? undefined,\n\t\t\t\ttotalSlots: c.req.header(\"x-rivet-total-slots\"),\n\t\t\t\trunnerName: c.req.header(\"x-rivet-runner-name\"),\n\t\t\t\tnamespace: c.req.header(\"x-rivet-namespace-name\"),\n\t\t\t});\n\t\t\tif (!parseResult.success) {\n\t\t\t\tthrow new InvalidRequest(\n\t\t\t\t\tparseResult.error.issues[0]?.message ??\n\t\t\t\t\t\t\"invalid serverless start headers\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst { endpoint, token, totalSlots, runnerName, namespace } =\n\t\t\t\tparseResult.data;\n\n\t\t\tlogger().debug({\n\t\t\t\tmsg: \"received serverless runner start request\",\n\t\t\t\tendpoint,\n\t\t\t\ttotalSlots,\n\t\t\t\trunnerName,\n\t\t\t\tnamespace,\n\t\t\t});\n\n\t\t\t// Validate endpoint and namespace match config to catch\n\t\t\t// misconfiguration or malicious requests.\n\t\t\t//\n\t\t\t// Only verify if namespace matches if endpoint configured since\n\t\t\t// configuring an endpoint indicates you want to assert the\n\t\t\t// incoming serverless requests.\n\t\t\tif (config.endpoint) {\n\t\t\t\tif (!endpointsMatch(endpoint, config.endpoint)) {\n\t\t\t\t\tthrow new EndpointMismatch(config.endpoint, endpoint);\n\t\t\t\t}\n\n\t\t\t\tif (namespace !== config.namespace) {\n\t\t\t\t\tthrow new NamespaceMismatch(config.namespace, namespace);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Convert config to runner config\n\t\t\tconst newConfig: RegistryConfig = {\n\t\t\t\t...config,\n\t\t\t\tendpoint: endpoint,\n\t\t\t\tnamespace: namespace,\n\t\t\t\ttoken: token,\n\t\t\t\trunner: {\n\t\t\t\t\t...config.runner,\n\t\t\t\t\ttotalSlots: totalSlots,\n\t\t\t\t\trunnerName: runnerName,\n\t\t\t\t\t// Not supported on serverless\n\t\t\t\t\trunnerKey: undefined,\n\t\t\t\t},\n\t\t\t};\n\n\t\t\t// Create manager driver on demand based on the properties provided\n\t\t\t// by headers\n\t\t\t//\n\t\t\t// NOTE: This relies on the `newConfig.runner.runnerName` to\n\t\t\t// configure which runner to create actors on.\n\t\t\tconst managerDriver = new RemoteManagerDriver(\n\t\t\t\tconvertRegistryConfigToClientConfig(newConfig),\n\t\t\t);\n\t\t\tconst client = createClientWithDriver(managerDriver);\n\n\t\t\t// Create new actor driver with updated config\n\t\t\tconst actorDriver = driverConfig.actor(\n\t\t\t\tnewConfig,\n\t\t\t\tmanagerDriver,\n\t\t\t\tclient,\n\t\t\t);\n\t\t\tinvariant(\n\t\t\t\tactorDriver.serverlessHandleStart,\n\t\t\t\t\"missing serverlessHandleStart on ActorDriver\",\n\t\t\t);\n\n\t\t\treturn await actorDriver.serverlessHandleStart(c);\n\t\t});\n\n\t\trouter.get(\"/health\", (c) => handleHealthRequest(c));\n\n\t\trouter.get(\"/metadata\", (c) =>\n\t\t\thandleMetadataRequest(\n\t\t\t\tc,\n\t\t\t\tconfig,\n\t\t\t\t{ serverless: {} },\n\t\t\t\tconfig.publicEndpoint,\n\t\t\t\tconfig.publicNamespace,\n\t\t\t\tconfig.publicToken,\n\t\t\t),\n\t\t);\n\t});\n}\n\n/**\n * Normalizes a URL for comparison by extracting protocol, host, port, and pathname.\n * Normalizes loopback addresses (127.0.0.1, 0.0.0.0, ::1) to localhost for consistent comparison.\n * Normalizes regional endpoints (api-*.domain) to base endpoints (api.domain).\n * Returns null if the URL is invalid.\n */\nexport function normalizeEndpointUrl(url: string): string | null {\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\t// Normalize pathname by removing trailing slash (except for root)\n\t\tconst pathname =\n\t\t\tparsed.pathname === \"/\" ? \"/\" : parsed.pathname.replace(/\\/+$/, \"\");\n\n\t\t// Normalize loopback addresses to localhost\n\t\tlet hostname = isLoopbackAddress(parsed.hostname)\n\t\t\t? \"localhost\"\n\t\t\t: parsed.hostname;\n\n\t\t// Normalize regional endpoints (api-region.domain) to base endpoints (api.domain)\n\t\t// HACK: This is specific to Rivet Cloud and will not work for self-hosted\n\t\t// engines with different regional endpoint naming conventions.\n\t\thostname = normalizeRegionalHostname(hostname);\n\n\t\t// Reconstruct host with normalized hostname and port\n\t\tconst host = parsed.port ? `${hostname}:${parsed.port}` : hostname;\n\n\t\t// Reconstruct normalized URL with protocol, host, and pathname\n\t\treturn `${parsed.protocol}//${host}${pathname}`;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Normalizes regional hostnames (api-region.domain) to base hostnames (api.domain).\n * Only applies to rivet.dev domains.\n *\n * Examples:\n * - api-us-west-1.rivet.dev -> api.rivet.dev\n * - api-lax.staging.rivet.dev -> api.staging.rivet.dev\n * - api.rivet.dev -> api.rivet.dev (unchanged)\n * - api-us-west-1.example.com -> api-us-west-1.example.com (unchanged, not rivet.dev)\n * - foo-bar.rivet.dev -> foo-bar.rivet.dev (unchanged, not api- prefix)\n */\nfunction normalizeRegionalHostname(hostname: string): string {\n\t// Only apply to rivet.dev domains\n\tif (!hostname.endsWith(\".rivet.dev\")) {\n\t\treturn hostname;\n\t}\n\n\tif (!hostname.startsWith(\"api-\")) {\n\t\treturn hostname;\n\t}\n\n\t// Find the first dot after \"api-\"\n\tconst withoutPrefix = hostname.slice(4); // Remove \"api-\"\n\tconst firstDotIndex = withoutPrefix.indexOf(\".\");\n\tif (firstDotIndex === -1) {\n\t\treturn hostname;\n\t}\n\n\t// Extract the domain part and prepend \"api.\"\n\tconst domain = withoutPrefix.slice(firstDotIndex + 1);\n\treturn `api.${domain}`;\n}\n\n/**\n * Compares two endpoint URLs after normalization.\n * Returns true if they match (same protocol, host, port, and path).\n */\nexport function endpointsMatch(a: string, b: string): boolean {\n\tconst normalizedA = normalizeEndpointUrl(a);\n\tconst normalizedB = normalizeEndpointUrl(b);\n\tif (normalizedA === null || normalizedB === null) {\n\t\t// If either URL is invalid, fall back to string comparison\n\t\treturn a === b;\n\t}\n\treturn normalizedA === normalizedB;\n}\n\n/**\n * Checks if a hostname is a loopback address that should be normalized to localhost.\n */\nfunction isLoopbackAddress(hostname: string): boolean {\n\treturn (\n\t\thostname === \"127.0.0.1\" ||\n\t\thostname === \"0.0.0.0\" ||\n\t\thostname === \"::1\" ||\n\t\thostname === \"[::1]\"\n\t);\n}\n","import { z } from \"zod/v4\";\n\nexport const ServerlessStartHeadersSchema = z.object({\n\tendpoint: z.string({\n\t\terror: \"x-rivet-endpoint header is required\",\n\t}),\n\ttoken: z\n\t\t.string({ error: \"x-rivet-token header must be a string\" })\n\t\t.optional(),\n\ttotalSlots: z.coerce\n\t\t.number({\n\t\t\terror: \"x-rivet-total-slots header must be a number\",\n\t\t})\n\t\t.int({ error: \"x-rivet-total-slots header must be an integer\" })\n\t\t.gte(1, { error: \"x-rivet-total-slots header must be positive\" }),\n\trunnerName: z.string({\n\t\terror: \"x-rivet-runner-name header is required\",\n\t}),\n\tnamespace: z.string({\n\t\terror: \"x-rivet-namespace-name header is required\",\n\t}),\n});\n","import type { Client } from \"@/client/client\";\nimport { createClient } from \"@/client/mod\";\nimport { getNodeEnv, isDev } from \"@/utils/env-vars\";\nimport {\n\ttype RegistryActors,\n\ttype RegistryConfig,\n\ttype RegistryConfigInput,\n\tRegistryConfigSchema,\n} from \"./config\";\nimport {\n\ttype LegacyRunnerConfig,\n\ttype LegacyRunnerConfigInput,\n\tLegacyRunnerConfigSchema,\n} from \"./config/legacy-runner\";\nimport { Runtime } from \"../../runtime\";\n\nexport type FetchHandler = (\n\trequest: Request,\n\t...args: any\n) => Response | Promise<Response>;\n\nexport interface ServerlessHandler {\n\tfetch: FetchHandler;\n}\n\nexport interface LegacyStartServerOutput<A extends Registry<any>> {\n\t/** Client to communicate with the actors. */\n\tclient: Client<A>;\n\t/** Fetch handler to manually route requests to the Rivet manager API. */\n\tfetch: FetchHandler;\n}\n\nexport class Registry<A extends RegistryActors> {\n\t#config: RegistryConfigInput<A>;\n\n\tget config(): RegistryConfigInput<A> {\n\t\treturn this.#config;\n\t}\n\n\tparseConfig(): RegistryConfig {\n\t\treturn RegistryConfigSchema.parse(this.#config);\n\t}\n\n\t// Shared runtime instance\n\t#runtime?: Runtime<A>;\n\t#runtimePromise?: Promise<Runtime<A>>;\n\n\tconstructor(config: RegistryConfigInput<A>) {\n\t\tthis.#config = config;\n\n\t\t// Auto-prepare on next tick (gives time for sync config modification)\n\t\tif (getNodeEnv() !== \"test\") {\n\t\t\tsetTimeout(() => {\n\t\t\t\t// biome-ignore lint/nursery/noFloatingPromises: fire-and-forget auto-prepare\n\t\t\t\tthis.#ensureRuntime();\n\t\t\t}, 0);\n\t\t}\n\t}\n\n\t/** Creates runtime if not already created. Idempotent. */\n\t#ensureRuntime(): Promise<Runtime<A>> {\n\t\tif (!this.#runtimePromise) {\n\t\t\tthis.#runtimePromise = Runtime.create(this);\n\t\t\t// biome-ignore lint/nursery/noFloatingPromises: bg task\n\t\t\tthis.#runtimePromise.then((rt) => {\n\t\t\t\tthis.#runtime = rt;\n\t\t\t});\n\t\t}\n\t\treturn this.#runtimePromise;\n\t}\n\n\t/**\n\t * Handle an incoming HTTP request for serverless deployments.\n\t *\n\t * @example\n\t * ```ts\n\t * const app = new Hono();\n\t * app.all(\"/api/rivet/*\", (c) => registry.handler(c.req.raw));\n\t * export default app;\n\t * ```\n\t */\n\tpublic async handler(request: Request): Promise<Response> {\n\t\tconst runtime = await this.#ensureRuntime();\n\t\truntime.startServerless();\n\t\treturn await runtime.handleServerlessRequest(request);\n\t}\n\n\t/**\n\t * Returns a fetch handler for serverless deployments.\n\t *\n\t * @example\n\t * ```ts\n\t * export default registry.serve();\n\t * ```\n\t */\n\tpublic serve(): ServerlessHandler {\n\t\treturn { fetch: this.handler.bind(this) };\n\t}\n\n\t/**\n\t * Starts an actor runner for standalone server deployments.\n\t */\n\tpublic startRunner() {\n\t\t// biome-ignore lint/nursery/noFloatingPromises: bg task\n\t\tthis.#ensureRuntime().then((runtime) => runtime.startRunner());\n\t}\n\n\t// MARK: Legacy\n\t/**\n\t * Runs the registry for a server.\n\t *\n\t * @deprecated Use {@link Registry.startRunner} for long-running servers or {@link Registry.handler} for serverless deployments.\n\t */\n\tpublic start(\n\t\tinputConfig?: LegacyRunnerConfigInput,\n\t): LegacyStartServerOutput<this> {\n\t\tconst config = LegacyRunnerConfigSchema.parse(inputConfig);\n\n\t\t// Validate autoConfigureServerless is only used with serverless runner\n\t\tif (\n\t\t\tconfig.autoConfigureServerless &&\n\t\t\tconfig.runnerKind !== \"serverless\"\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t\"autoConfigureServerless can only be configured when runnerKind is 'serverless'\",\n\t\t\t);\n\t\t}\n\n\t\t// Auto-configure serverless runner if not in prod\n\t\tconst isDevEnv = isDev();\n\t\tif (isDevEnv && config.runnerKind === \"serverless\") {\n\t\t\tif (inputConfig?.runEngine === undefined) config.runEngine = true;\n\t\t\tif (inputConfig?.autoConfigureServerless === undefined)\n\t\t\t\tconfig.autoConfigureServerless = true;\n\t\t}\n\n\t\t// Convert to new config format and call appropriate handler\n\t\tif (config.runnerKind === \"serverless\") {\n\t\t\treturn this.#legacyStartServerless(config, inputConfig);\n\t\t} else {\n\t\t\treturn this.#legacyStartNormal(config);\n\t\t}\n\t}\n\n\t#legacyStartServerless(\n\t\tconfig: LegacyRunnerConfig,\n\t\t_inputConfig: LegacyRunnerConfigInput | undefined,\n\t): LegacyStartServerOutput<this> {\n\t\t// Create client for the legacy return value\n\t\t// For serverless, we don't have an endpoint until /start is called,\n\t\t// so we create a placeholder client\n\t\tconst client = createClient<this>({\n\t\t\tendpoint: config.endpoint,\n\t\t\ttoken: config.token,\n\t\t\tnamespace: config.namespace,\n\t\t\theaders: config.headers,\n\t\t});\n\n\t\treturn {\n\t\t\tclient,\n\t\t\tfetch: this.handler.bind(this),\n\t\t};\n\t}\n\n\t#legacyStartNormal(\n\t\tconfig: LegacyRunnerConfig,\n\t): LegacyStartServerOutput<this> {\n\t\t// Start the runner (fire-and-forget to maintain sync API)\n\t\t// biome-ignore lint/nursery/noFloatingPromises: legacy sync API\n\t\tthis.#ensureRuntime().then((runtime) => runtime.startRunner());\n\n\t\t// Create client for the legacy return value\n\t\tconst client = createClient<this>({\n\t\t\tendpoint: config.endpoint,\n\t\t\ttoken: config.token,\n\t\t\tnamespace: config.namespace,\n\t\t\theaders: config.headers,\n\t\t});\n\n\t\treturn {\n\t\t\tclient,\n\t\t\tfetch: this.handler.bind(this),\n\t\t};\n\t}\n}\n\nexport function setup<A extends RegistryActors>(\n\tinput: RegistryConfigInput<A>,\n): Registry<A> {\n\treturn new Registry(input);\n}\n\nexport type { RegistryConfig, RegistryActors };\nexport { RegistryConfigSchema };\n"]}

package/dist/tsup/{chunk-NAM3D5W5.js → chunk-BFI4LYS2.js}

@@ -1,18 +1,18 @@
 import {
   WORKFLOW_GUARD_KV_KEY,
   workflow
-} from "./chunk-74ER4FEE.js";
+} from "./chunk-YQ5P6KMN.js";
 import {
   actor,
   queue
-} from "./chunk-OONQLPOH.js";
+} from "./chunk-BSIJG3LG.js";
 import {
   db
 } from "./chunk-KJSYAUOM.js";
 import {
   getLogger,
   promiseWithResolvers
-} from "./chunk-IZ4M5TJU.js";
+} from "./chunk-WUXR722E.js";
 
 // src/driver-test-suite/log.ts
 function logger() {
@@ -329,8 +329,7 @@ var runWithQueueConsumer = actor({
     c.state.runStarted = true;
     c.log.info("run handler started, waiting for messages");
     while (!c.aborted) {
-      const messages = await c.queue.next({ names: ["messages"] });
-      const message = messages[0];
+      const message = await c.queue.next({ names: ["messages"] });
       if (message) {
         c.log.info({ msg: "received message", body: message.body });
         c.state.messagesReceived.push({
@@ -643,4 +642,4 @@ export {
   workflowSleepActor,
   workflowStopTeardownActor
 };
-//# sourceMappingURL=chunk-NAM3D5W5.js.map
+//# sourceMappingURL=chunk-BFI4LYS2.js.map