rivetkit 2.3.30 → 3.0.0-preview.2

package/dist/tsup/mod.d.cts

@@ -1,12 +1,12 @@
-import { A as AnyActorDefinition, B as BaseActorDefinition, E as EventSchemaConfig, Q as QueueSchemaConfig, a as ActionContext, b as BeforeActionResponseContext, c as BeforeConnectContext, C as ConnectContext, d as CreateConnStateContext, e as CreateContext, f as CreateVarsContext, D as DestroyContext, g as DisconnectContext, M as MigrateContext, R as RequestContext, h as RunContext, S as SleepContext, i as StateChangeContext, W as WakeContext, j as WebSocketContext } from './config-osdJqQwX.cjs';
-export { k as ACTOR_CONTEXT_INTERNAL_SYMBOL, l as ActionInputSchemas, m as ActionSampleRates, n as ActionTraceSamplers, o as Actions, p as ActorConfig, q as ActorConfigInput, r as ActorConfigSchema, s as ActorContext, t as ActorContextOf, u as ActorCron, v as ActorCronEveryOptions, w as ActorCronSetOptions, x as ActorDefinition, y as ActorInspectorConfig, z as ActorInspectorConfigSchema, F as ActorKey, G as ActorKv, H as ActorLogger, I as ActorOptions, J as ActorOptionsInput, K as ActorOptionsSchema, L as ActorQuery, N as ActorQueue, O as ActorRun, P as ActorSchedule, T as ActorTracingOptions, U as ActorTypes, V as ActorsSchema, X as AnyActorInstance, Y as AnyClient, Z as AnyConn, _ as AnyStaticActorDefinition, $ as AnyStaticActorInstance, a0 as AuthIntent, a1 as BUILTIN_INSPECTOR_TAB_IDS, a2 as BaseActorInstance, a3 as BuiltinInspectorTabIdSchema, a4 as CONN_DRIVER_SYMBOL, a5 as CONN_STATE_MANAGER_SYMBOL, a6 as Client, a7 as Conn, a8 as CronFire, a9 as CronJobInfo, aa as CustomInspectorTabEntrySchema, ab as DEFAULT_SLEEP_GRACE_PERIOD, ac as DefineRunHandlerOptions, ad as DocActorConfigSchema, ae as DocActorOptionsSchema, af as DocConfigurePoolSchema, ag as DocEnvoyConfigSchema, ah as DocRegistryConfigSchema, ai as DocServerlessConfigSchema, aj as DocSqliteConfigSchema, ak as FetchHandler, al as GlobalActorOptions, am as GlobalActorOptionsInput, an as GlobalActorOptionsSchema, ao as HideInspectorTabEntrySchema, ap as InferEventArgs, aq as InferSchemaMap, ar as InspectorTabEntrySchema, as as InspectorUnsubscribe, at as InstanceActorOptions, au as InstanceActorOptionsInput, av as InstanceActorOptionsSchema, aw as QueueEnqueueAndWaitOptions, ax as QueueFilterName, ay as QueueIterOptions, az as QueueMessageOf, aA as QueueName, aB as QueueNextBatchOptions, aC as QueueNextOptions, aD as QueueResultMessageForName, aE as QueueTryNextBatchOptions, aF as QueueTryNextOptions, aG as QueueWaitOptions, aH as RAW_STATE_SYMBOL, aI as Registry, aJ as RegistryActors, aK as RegistryApplication, aL as RegistryConfig, aM as RegistryConfigInput, aN as RegistryConfigSchema, aO as RegistryDeps, aP as RegistryListenOptions, aQ as RegistryRoutes, aR as RunConfig, aS as RunConfigSchema, aT as RunControl, aU as RunInspectorConfig, aV as RunInspectorFactoryContext, aW as RunInspectorFactoryResult, aX as RunInspectorKind, aY as RunWithInactiveOptions, aZ as RuntimeKind, a_ as RuntimeKindSchema, a$ as ScheduledEventInfo, b0 as ScheduledFireInfo, b1 as ServerlessHandler, b2 as SqliteBackend, b3 as SqliteBackendSchema, b4 as SqliteConfig, b5 as SqliteConfigSchema, b6 as TestConfig, b7 as TestConfigSchema, b8 as Type, b9 as WasmRuntimeBindings, ba as WasmRuntimeConfig, bb as WasmRuntimeConfigSchema, bc as WasmRuntimeInitInput, bd as WorkflowInspectorConfig, be as WorkflowOutcome, bf as WorkflowSpan, bg as WorkflowStepOutcome, bh as WorkflowStepSpan, bi as actor, bj as buildActorNames, bk as createClientWithDriver, bl as defineRunHandler, bm as disposeRunInspector, bn as event, bo as getRunFunction, bp as getRunInspectorConfig, bq as getRunMetadata, br as isStaticActorDefinition, bs as isStaticActorInstance, bt as lookupInRegistry, bu as queue, bv as setup, bw as test } from './config-osdJqQwX.cjs';
+import { A as AnyActorDefinition, B as BaseActorDefinition, E as EventSchemaConfig, Q as QueueSchemaConfig, a as ActionContext, b as BeforeActionResponseContext, c as BeforeConnectContext, C as ConnectContext, d as CreateConnStateContext, e as CreateContext, f as CreateVarsContext, D as DestroyContext, g as DisconnectContext, M as MigrateContext, R as RequestContext, h as RunContext, S as SleepContext, i as StateChangeContext, W as WakeContext, j as WebSocketContext } from './config-8NgsxIcT.cjs';
+export { k as ACTOR_CONTEXT_INTERNAL_SYMBOL, l as ActionInputSchemas, m as ActionSampleRates, n as ActionTraceSamplers, o as Actions, p as ActorConfig, q as ActorConfigInput, r as ActorConfigSchema, s as ActorContext, t as ActorContextOf, u as ActorCron, v as ActorCronEveryOptions, w as ActorCronSetOptions, x as ActorDefinition, y as ActorInspectorConfig, z as ActorInspectorConfigSchema, F as ActorKey, G as ActorKv, H as ActorLogger, I as ActorOptions, J as ActorOptionsInput, K as ActorOptionsSchema, L as ActorQuery, N as ActorQueue, O as ActorRun, P as ActorSchedule, T as ActorTracingOptions, U as ActorTypes, V as ActorsSchema, X as AnyActorInstance, Y as AnyClient, Z as AnyConn, _ as AnyStaticActorDefinition, $ as AnyStaticActorInstance, a0 as AuthIntent, a1 as BUILTIN_INSPECTOR_TAB_IDS, a2 as BaseActorInstance, a3 as BuiltinInspectorTabIdSchema, a4 as CONN_DRIVER_SYMBOL, a5 as CONN_STATE_MANAGER_SYMBOL, a6 as Client, a7 as Conn, a8 as CronFire, a9 as CronJobInfo, aa as CustomInspectorTabEntrySchema, ab as DEFAULT_SLEEP_GRACE_PERIOD, ac as DefineRunHandlerOptions, ad as DocActorConfigSchema, ae as DocActorOptionsSchema, af as DocConfigurePoolSchema, ag as DocEnvoyConfigSchema, ah as DocRegistryConfigSchema, ai as DocServerlessConfigSchema, aj as DocSqliteConfigSchema, ak as FetchHandler, al as GlobalActorOptions, am as GlobalActorOptionsInput, an as GlobalActorOptionsSchema, ao as HideInspectorTabEntrySchema, ap as InferEventArgs, aq as InferSchemaMap, ar as InspectorTabEntrySchema, as as InspectorUnsubscribe, at as InstanceActorOptions, au as InstanceActorOptionsInput, av as InstanceActorOptionsSchema, aw as QueueEnqueueAndWaitOptions, ax as QueueFilterName, ay as QueueIterOptions, az as QueueMessageOf, aA as QueueName, aB as QueueNextBatchOptions, aC as QueueNextOptions, aD as QueueResultMessageForName, aE as QueueTryNextBatchOptions, aF as QueueTryNextOptions, aG as QueueWaitOptions, aH as RAW_STATE_SYMBOL, aI as Registry, aJ as RegistryActors, aK as RegistryApplication, aL as RegistryConfig, aM as RegistryConfigInput, aN as RegistryConfigSchema, aO as RegistryDeps, aP as RegistryListenOptions, aQ as RegistryRoutes, aR as RunConfig, aS as RunConfigSchema, aT as RunControl, aU as RunInspectorConfig, aV as RunInspectorFactoryContext, aW as RunInspectorFactoryResult, aX as RunInspectorKind, aY as RunWithInactiveOptions, aZ as RuntimeKind, a_ as RuntimeKindSchema, a$ as ScheduledEventInfo, b0 as ScheduledFireInfo, b1 as ServerlessHandler, b2 as SqliteBackend, b3 as SqliteBackendSchema, b4 as SqliteConfig, b5 as SqliteConfigSchema, b6 as TestConfig, b7 as TestConfigSchema, b8 as Type, b9 as WasmRuntimeBindings, ba as WasmRuntimeConfig, bb as WasmRuntimeConfigSchema, bc as WasmRuntimeInitInput, bd as WorkflowInspectorConfig, be as WorkflowOutcome, bf as WorkflowSpan, bg as WorkflowStepOutcome, bh as WorkflowStepSpan, bi as actor, bj as buildActorNames, bk as createClientWithDriver, bl as defineRunHandler, bm as disposeRunInspector, bn as event, bo as getRunFunction, bp as getRunInspectorConfig, bq as getRunMetadata, br as isStaticActorDefinition, bs as isStaticActorInstance, bt as lookupInRegistry, bu as queue, bv as setup, bw as test } from './config-8NgsxIcT.cjs';
 export { E as Encoding, t as toUint8Array } from './utils-C6b0aYUM.cjs';
 import { UniversalWebSocket } from '@rivetkit/virtual-websocket';
 export { RivetCloseEvent, RivetEvent, RivetMessageEvent, UniversalWebSocket } from '@rivetkit/virtual-websocket';
-import { A as AnyDatabaseProvider } from './config-ey2I2zz5.cjs';
+import { A as AnyDatabaseProvider } from './config-B2wlj9wx.cjs';
 export { R as ActorError, R as RivetError, a as RivetErrorLike, b as RivetErrorOptions, U as UserError, c as UserErrorOptions, n as noopNext } from './utils-3rsE0JvI.cjs';
 import { WSContext } from 'hono/ws';
-export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from './context-DpjrM7n7.cjs';
+export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from './context-_RoE_YHL.cjs';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';

package/dist/tsup/mod.d.ts

@@ -1,12 +1,12 @@
-import { A as AnyActorDefinition, B as BaseActorDefinition, E as EventSchemaConfig, Q as QueueSchemaConfig, a as ActionContext, b as BeforeActionResponseContext, c as BeforeConnectContext, C as ConnectContext, d as CreateConnStateContext, e as CreateContext, f as CreateVarsContext, D as DestroyContext, g as DisconnectContext, M as MigrateContext, R as RequestContext, h as RunContext, S as SleepContext, i as StateChangeContext, W as WakeContext, j as WebSocketContext } from './config-Cv6pjCt-.js';
-export { k as ACTOR_CONTEXT_INTERNAL_SYMBOL, l as ActionInputSchemas, m as ActionSampleRates, n as ActionTraceSamplers, o as Actions, p as ActorConfig, q as ActorConfigInput, r as ActorConfigSchema, s as ActorContext, t as ActorContextOf, u as ActorCron, v as ActorCronEveryOptions, w as ActorCronSetOptions, x as ActorDefinition, y as ActorInspectorConfig, z as ActorInspectorConfigSchema, F as ActorKey, G as ActorKv, H as ActorLogger, I as ActorOptions, J as ActorOptionsInput, K as ActorOptionsSchema, L as ActorQuery, N as ActorQueue, O as ActorRun, P as ActorSchedule, T as ActorTracingOptions, U as ActorTypes, V as ActorsSchema, X as AnyActorInstance, Y as AnyClient, Z as AnyConn, _ as AnyStaticActorDefinition, $ as AnyStaticActorInstance, a0 as AuthIntent, a1 as BUILTIN_INSPECTOR_TAB_IDS, a2 as BaseActorInstance, a3 as BuiltinInspectorTabIdSchema, a4 as CONN_DRIVER_SYMBOL, a5 as CONN_STATE_MANAGER_SYMBOL, a6 as Client, a7 as Conn, a8 as CronFire, a9 as CronJobInfo, aa as CustomInspectorTabEntrySchema, ab as DEFAULT_SLEEP_GRACE_PERIOD, ac as DefineRunHandlerOptions, ad as DocActorConfigSchema, ae as DocActorOptionsSchema, af as DocConfigurePoolSchema, ag as DocEnvoyConfigSchema, ah as DocRegistryConfigSchema, ai as DocServerlessConfigSchema, aj as DocSqliteConfigSchema, ak as FetchHandler, al as GlobalActorOptions, am as GlobalActorOptionsInput, an as GlobalActorOptionsSchema, ao as HideInspectorTabEntrySchema, ap as InferEventArgs, aq as InferSchemaMap, ar as InspectorTabEntrySchema, as as InspectorUnsubscribe, at as InstanceActorOptions, au as InstanceActorOptionsInput, av as InstanceActorOptionsSchema, aw as QueueEnqueueAndWaitOptions, ax as QueueFilterName, ay as QueueIterOptions, az as QueueMessageOf, aA as QueueName, aB as QueueNextBatchOptions, aC as QueueNextOptions, aD as QueueResultMessageForName, aE as QueueTryNextBatchOptions, aF as QueueTryNextOptions, aG as QueueWaitOptions, aH as RAW_STATE_SYMBOL, aI as Registry, aJ as RegistryActors, aK as RegistryApplication, aL as RegistryConfig, aM as RegistryConfigInput, aN as RegistryConfigSchema, aO as RegistryDeps, aP as RegistryListenOptions, aQ as RegistryRoutes, aR as RunConfig, aS as RunConfigSchema, aT as RunControl, aU as RunInspectorConfig, aV as RunInspectorFactoryContext, aW as RunInspectorFactoryResult, aX as RunInspectorKind, aY as RunWithInactiveOptions, aZ as RuntimeKind, a_ as RuntimeKindSchema, a$ as ScheduledEventInfo, b0 as ScheduledFireInfo, b1 as ServerlessHandler, b2 as SqliteBackend, b3 as SqliteBackendSchema, b4 as SqliteConfig, b5 as SqliteConfigSchema, b6 as TestConfig, b7 as TestConfigSchema, b8 as Type, b9 as WasmRuntimeBindings, ba as WasmRuntimeConfig, bb as WasmRuntimeConfigSchema, bc as WasmRuntimeInitInput, bd as WorkflowInspectorConfig, be as WorkflowOutcome, bf as WorkflowSpan, bg as WorkflowStepOutcome, bh as WorkflowStepSpan, bi as actor, bj as buildActorNames, bk as createClientWithDriver, bl as defineRunHandler, bm as disposeRunInspector, bn as event, bo as getRunFunction, bp as getRunInspectorConfig, bq as getRunMetadata, br as isStaticActorDefinition, bs as isStaticActorInstance, bt as lookupInRegistry, bu as queue, bv as setup, bw as test } from './config-Cv6pjCt-.js';
+import { A as AnyActorDefinition, B as BaseActorDefinition, E as EventSchemaConfig, Q as QueueSchemaConfig, a as ActionContext, b as BeforeActionResponseContext, c as BeforeConnectContext, C as ConnectContext, d as CreateConnStateContext, e as CreateContext, f as CreateVarsContext, D as DestroyContext, g as DisconnectContext, M as MigrateContext, R as RequestContext, h as RunContext, S as SleepContext, i as StateChangeContext, W as WakeContext, j as WebSocketContext } from './config-DJ3KW-fe.js';
+export { k as ACTOR_CONTEXT_INTERNAL_SYMBOL, l as ActionInputSchemas, m as ActionSampleRates, n as ActionTraceSamplers, o as Actions, p as ActorConfig, q as ActorConfigInput, r as ActorConfigSchema, s as ActorContext, t as ActorContextOf, u as ActorCron, v as ActorCronEveryOptions, w as ActorCronSetOptions, x as ActorDefinition, y as ActorInspectorConfig, z as ActorInspectorConfigSchema, F as ActorKey, G as ActorKv, H as ActorLogger, I as ActorOptions, J as ActorOptionsInput, K as ActorOptionsSchema, L as ActorQuery, N as ActorQueue, O as ActorRun, P as ActorSchedule, T as ActorTracingOptions, U as ActorTypes, V as ActorsSchema, X as AnyActorInstance, Y as AnyClient, Z as AnyConn, _ as AnyStaticActorDefinition, $ as AnyStaticActorInstance, a0 as AuthIntent, a1 as BUILTIN_INSPECTOR_TAB_IDS, a2 as BaseActorInstance, a3 as BuiltinInspectorTabIdSchema, a4 as CONN_DRIVER_SYMBOL, a5 as CONN_STATE_MANAGER_SYMBOL, a6 as Client, a7 as Conn, a8 as CronFire, a9 as CronJobInfo, aa as CustomInspectorTabEntrySchema, ab as DEFAULT_SLEEP_GRACE_PERIOD, ac as DefineRunHandlerOptions, ad as DocActorConfigSchema, ae as DocActorOptionsSchema, af as DocConfigurePoolSchema, ag as DocEnvoyConfigSchema, ah as DocRegistryConfigSchema, ai as DocServerlessConfigSchema, aj as DocSqliteConfigSchema, ak as FetchHandler, al as GlobalActorOptions, am as GlobalActorOptionsInput, an as GlobalActorOptionsSchema, ao as HideInspectorTabEntrySchema, ap as InferEventArgs, aq as InferSchemaMap, ar as InspectorTabEntrySchema, as as InspectorUnsubscribe, at as InstanceActorOptions, au as InstanceActorOptionsInput, av as InstanceActorOptionsSchema, aw as QueueEnqueueAndWaitOptions, ax as QueueFilterName, ay as QueueIterOptions, az as QueueMessageOf, aA as QueueName, aB as QueueNextBatchOptions, aC as QueueNextOptions, aD as QueueResultMessageForName, aE as QueueTryNextBatchOptions, aF as QueueTryNextOptions, aG as QueueWaitOptions, aH as RAW_STATE_SYMBOL, aI as Registry, aJ as RegistryActors, aK as RegistryApplication, aL as RegistryConfig, aM as RegistryConfigInput, aN as RegistryConfigSchema, aO as RegistryDeps, aP as RegistryListenOptions, aQ as RegistryRoutes, aR as RunConfig, aS as RunConfigSchema, aT as RunControl, aU as RunInspectorConfig, aV as RunInspectorFactoryContext, aW as RunInspectorFactoryResult, aX as RunInspectorKind, aY as RunWithInactiveOptions, aZ as RuntimeKind, a_ as RuntimeKindSchema, a$ as ScheduledEventInfo, b0 as ScheduledFireInfo, b1 as ServerlessHandler, b2 as SqliteBackend, b3 as SqliteBackendSchema, b4 as SqliteConfig, b5 as SqliteConfigSchema, b6 as TestConfig, b7 as TestConfigSchema, b8 as Type, b9 as WasmRuntimeBindings, ba as WasmRuntimeConfig, bb as WasmRuntimeConfigSchema, bc as WasmRuntimeInitInput, bd as WorkflowInspectorConfig, be as WorkflowOutcome, bf as WorkflowSpan, bg as WorkflowStepOutcome, bh as WorkflowStepSpan, bi as actor, bj as buildActorNames, bk as createClientWithDriver, bl as defineRunHandler, bm as disposeRunInspector, bn as event, bo as getRunFunction, bp as getRunInspectorConfig, bq as getRunMetadata, br as isStaticActorDefinition, bs as isStaticActorInstance, bt as lookupInRegistry, bu as queue, bv as setup, bw as test } from './config-DJ3KW-fe.js';
 export { E as Encoding, t as toUint8Array } from './utils-C1O-SklO.js';
 import { UniversalWebSocket } from '@rivetkit/virtual-websocket';
 export { RivetCloseEvent, RivetEvent, RivetMessageEvent, UniversalWebSocket } from '@rivetkit/virtual-websocket';
-import { A as AnyDatabaseProvider } from './config-ey2I2zz5.js';
+import { A as AnyDatabaseProvider } from './config-B2wlj9wx.js';
 export { R as ActorError, R as RivetError, a as RivetErrorLike, b as RivetErrorOptions, U as UserError, c as UserErrorOptions, n as noopNext } from './utils-3rsE0JvI.js';
 import { WSContext } from 'hono/ws';
-export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from './context-CoVbKBuk.js';
+export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from './context-BL8kUGjq.js';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';

package/dist/tsup/mod.js

@@ -1,6 +1,6 @@
 import {
   decodeWorkflowHistoryTransport
-} from "./chunk-4SNS3PYZ.js";
+} from "./chunk-3URL73AV.js";
 import {
   ACTOR_CONTEXT_INTERNAL_SYMBOL,
   ActorConfigSchema,
@@ -35,18 +35,18 @@ import {
   runWithActorInvocationSpan,
   tryParseEndpoint,
   updateRunnerConfig
-} from "./chunk-I472KTIC.js";
+} from "./chunk-6IGGYL2C.js";
 import {
   makePrefixedKey,
   removePrefixFromKey
-} from "./chunk-JI6GZ2C2.js";
+} from "./chunk-A2CF6PFH.js";
 import {
   bindNativeStateTransactionContext,
   db,
   registerNativeStateTransactionOpener
-} from "./chunk-OUB7SGSA.js";
+} from "./chunk-ANNVZW6B.js";
 import "./chunk-JTHHCZCZ.js";
-import "./chunk-H3SGQEHZ.js";
+import "./chunk-WGKL7HMH.js";
 import {
   LogLevelSchema,
   VERSION,
@@ -80,11 +80,12 @@ import {
   parsePortEnv,
   stringifyError,
   toUint8Array
-} from "./chunk-CORYIKDC.js";
+} from "./chunk-5F7FWAJI.js";
 import {
   INTERNAL_ERROR_CODE,
   RivetError,
   UserError,
+  actorStopping,
   decodeBridgeRivetError,
   encodeBridgeRivetError,
   encodeErrorForBridge,
@@ -500,7 +501,7 @@ var EnvoyConfigSchema = z.object({
   version: z.number().default(() => getRivetEnvoyVersion() ?? 1),
   // Deprecated.
   totalSlots: z.number().default(() => getRivetTotalSlots() ?? 1e5),
-  envoyKey: z.string().optional()
+  nodeKey: z.string().optional()
 });
 
 // src/registry/config/serverless.ts
@@ -644,7 +645,7 @@ var RegistryConfigSchema = z3.object({
   // // (specifically Node.js) can sometimes only be specified after the router is
   // // created or must be imported async using `await import(...)`
   // getUpgradeWebSocket: z.custom<GetUpgradeWebSocket>().optional(),
-  // MARK: Runner Configuration
+  // MARK: Node Configuration
   /**
    * Endpoint to connect to for Rivet Engine.
    *
@@ -713,30 +714,30 @@ var RegistryConfigSchema = z3.object({
   engineVersion: z3.string().optional().default(() => getRivetRunEngineVersion() ?? VERSION),
   /**
    * Starts the first-party Services actor host when RivetKit manages
-   * a local engine. Defaults to the local-engine decision. Set
-   * RIVET_RUN_SERVICES=0 or 1 to override it.
+   * a local engine. Disabled by default. Set RIVET_RUN_SERVICES=1
+   * or startServices: true to enable it.
    */
   startServices: z3.boolean().optional(),
   /**
    * @experimental
    *
-   * Automatically configure serverless envoys in the engine.
+   * Automatically configure serverless nodes in the engine.
    */
   configurePool: ConfigurePoolSchema.optional(),
   // MARK: Runtime-specific
   serverless: ServerlessConfigSchema.optional().default(
     () => ServerlessConfigSchema.parse({})
   ),
-  envoy: EnvoyConfigSchema.optional().default(
+  node: EnvoyConfigSchema.optional().default(
     () => EnvoyConfigSchema.parse({})
   ),
   // MARK: Shutdown
   /**
    * Graceful shutdown configuration for SIGINT/SIGTERM.
    *
-   * When a persistent envoy is running (Mode A, started via `registry.start()`),
+   * When a persistent node is running (Mode A, started via `registry.start()`),
    * rivetkit installs Node SIGINT/SIGTERM handlers that call into core's
-   * `shutdown()` and wait up to `gracePeriodMs` for the envoy to drain
+   * `shutdown()` and wait up to `gracePeriodMs` for the node to drain
    * before re-raising the signal to let Node exit via its default path.
    *
    * Handlers are NOT installed when `handler(request)` is used alone
@@ -748,9 +749,11 @@ var RegistryConfigSchema = z3.object({
     /**
      * Wait this many milliseconds for the serve promise to resolve
      * after calling `CoreRegistry::shutdown()`. Defaults to the
-     * engine-provided actor stop threshold once the envoy connects.
+     * engine-provided actor stop threshold once the node connects. A
+     * signal-driven shutdown of a managed local development engine waits
+     * one second by default so a file watcher can restart promptly.
      *
-     * Must be long enough for rivetkit-core to drain the envoy.
+     * Set a longer period when a complete graceful node drain is required.
      */
     gracePeriodMs: z3.number().int().min(1e3).optional(),
     /**
@@ -786,10 +789,11 @@ var RegistryConfigSchema = z3.object({
       message: "cannot specify both startEngine and endpoint"
     });
   }
-  if (config.configurePool && !parsedEndpoint && !config.startEngine) {
+  if (config.configurePool) {
     ctx.addIssue({
       code: "custom",
-      message: "configurePool requires either endpoint or startEngine"
+      message: "serverless is disabled in this version",
+      path: ["configurePool"]
     });
   }
   const localEngineEndpoint = buildEngineEndpoint(
@@ -797,7 +801,7 @@ var RegistryConfigSchema = z3.object({
     config.enginePort
   );
   const endpoint = config.startEngine ? localEngineEndpoint : (parsedEndpoint == null ? void 0 : parsedEndpoint.endpoint) ?? (isDevEnv ? localEngineEndpoint : void 0);
-  const startServices = config.startServices ?? getRivetRunServices() ?? Boolean(endpoint && isLocalEngineEndpoint(endpoint));
+  const startServices = config.startServices ?? getRivetRunServices();
   const validateServerlessEndpoint = Boolean(
     config.startEngine || parsedEndpoint
   );
@@ -821,6 +825,7 @@ var RegistryConfigSchema = z3.object({
     ...config,
     sqlite,
     endpoint,
+    engineSpawn: !parsedEndpoint && Boolean(endpoint),
     startServices,
     namespace,
     token,
@@ -850,8 +855,8 @@ function buildActorNames(config) {
   );
 }
 var DocConfigurePoolSchema = z3.object({
-  name: z3.string().optional().describe("Name of the runner pool."),
-  url: z3.string().describe("URL of the serverless platform to configure runners."),
+  name: z3.string().optional().describe("Name of the node pool."),
+  url: z3.string().describe("URL of the serverless platform to configure nodes."),
   headers: z3.record(z3.string(), z3.string()).optional().describe(
     "Headers to include in requests to the serverless platform."
   ),
@@ -866,7 +871,7 @@ var DocConfigurePoolSchema = z3.object({
     "Interval in milliseconds between metadata polls from the engine. Defaults to 10000 milliseconds (10 seconds)."
   ),
   drainOnVersionUpgrade: z3.boolean().optional().describe(
-    "Drain runners when a new version is deployed. Defaults to true."
+    "Drain nodes when a new version is deployed. Defaults to true."
   )
 }).optional();
 var DocServerlessConfigSchema = z3.object({
@@ -885,10 +890,10 @@ var DocServerlessConfigSchema = z3.object({
 }).describe("Configuration for serverless deployment mode.");
 var DocEnvoyConfigSchema = z3.object({
   totalSlots: z3.number().optional().describe("Total number of actor slots available. Default: 100000"),
-  poolName: z3.string().optional().describe("Name of this envoy pool. Default: 'default'"),
-  envoyKey: z3.string().optional().describe("Deprecated. Authentication key for the envoy."),
-  version: z3.number().optional().describe("Version number of this envoy. Default: 1")
-}).describe("Configuration for envoy mode.");
+  poolName: z3.string().optional().describe("Name of this node pool. Default: 'default'"),
+  nodeKey: z3.string().optional().describe("Deprecated. Authentication key for the node."),
+  version: z3.number().optional().describe("Version number of this node. Default: 1")
+}).describe("Configuration for node mode.");
 var DocSqliteConfigSchema = z3.object({
   backend: SqliteBackendSchema.optional().describe(
     "SQLite backend to use. Native defaults to local. Wasm defaults to remote and cannot use local."
@@ -936,13 +941,13 @@ var DocRegistryConfigSchema = z3.object({
     "Version of the local engine package to use. Defaults to the current RivetKit version."
   ),
   startServices: z3.boolean().optional().describe(
-    "Starts Services when RivetKit manages a local Engine. Defaults to the local-Engine decision. Set RIVET_RUN_SERVICES=0 or 1 to override."
+    "Starts Services when RivetKit manages a local Engine. Disabled by default. Set RIVET_RUN_SERVICES=1 or startServices: true to enable."
   ),
   configurePool: DocConfigurePoolSchema.describe(
-    "Automatically configure serverless runners in the engine."
+    "Automatically configure serverless nodes in the engine."
   ),
   serverless: DocServerlessConfigSchema.optional(),
-  envoy: DocEnvoyConfigSchema.optional()
+  node: DocEnvoyConfigSchema.optional()
 }).describe("RivetKit registry configuration.");
 
 // src/registry/native.ts
@@ -1105,12 +1110,12 @@ var NativeCloseGate = class {
     if (this.#active > 0) {
       await new Promise((resolve) => this.#waiters.push(resolve));
     }
-    await callback();
+    await (callback == null ? void 0 : callback());
   }
 };
 function wrapJsNativeDatabase(database) {
   const gate = new NativeCloseGate();
-  let closePromise;
+  let terminalPromise;
   let lastInsertRowId = null;
   const executeNative = async (sql, params) => {
     const lastInsertRowIdColumn = lastInsertRowIdColumnName(sql);
@@ -1245,8 +1250,12 @@ function wrapJsNativeDatabase(database) {
       return normalizeNativeMetrics((_a = database.metrics) == null ? void 0 : _a.call(database));
     },
     async close() {
-      closePromise ??= gate.close(() => database.close());
-      await closePromise;
+      terminalPromise ??= gate.close(() => database.close());
+      await terminalPromise;
+    },
+    async detachForShutdown() {
+      terminalPromise ??= gate.close();
+      await terminalPromise;
     }
   };
 }
@@ -1392,6 +1401,12 @@ function getNodePath() {
 function normalizeRuntimeSqlExecuteResult(result) {
   return result;
 }
+function servicesBinaryUnavailable(cause) {
+  return new Error(
+    "services.binary_unavailable: Install @rivet-dev/services yourself to run local Services, or set RIVET_SERVICES_BINARY to its executable path.",
+    { cause }
+  );
+}
 
 // src/registry/napi-runtime.ts
 function asNativeRegistry(handle) {
@@ -1664,7 +1679,8 @@ var NapiCoreRuntime = class {
     asNativeCancellationToken(token).cancel();
   }
   onCancellationTokenCancelled(token, callback) {
-    asNativeCancellationToken(token).onCancelled(callback);
+    const listener = asNativeCancellationToken(token).onCancelled(callback);
+    return () => listener.release();
   }
   actorState(ctx) {
     return asNativeActorContext(ctx).state();
@@ -2703,9 +2719,10 @@ var WasmCoreRuntime = class {
     callWasmSync(() => asWasmCancellationToken(token).cancel());
   }
   onCancellationTokenCancelled(token, callback) {
-    callWasmSync(
+    const listener = callWasmSync(
       () => asWasmCancellationToken(token).onCancelled(callback)
     );
+    return () => callWasmSync(() => listener.release());
   }
   actorState(ctx) {
     return toBytes(
@@ -3498,9 +3515,10 @@ function normalizeRuntimeConfig(config, runtime) {
   return normalizeRuntimeConfigForKind(config, loadedRuntimeKind(runtime));
 }
 function getNativeRuntimeState(runtime, ctx) {
-  const runtimeState = callNativeSync(
-    () => runtime.actorRuntimeState(ctx)
-  );
+  const runtimeState = readNativeRuntimeStateBag(runtime, ctx);
+  if (runtimeState.cleared) {
+    throw actorStopping(callNativeSync(() => runtime.actorId(ctx)));
+  }
   if (!runtimeState.destroyGate) {
     runtimeState.destroyGate = {};
   }
@@ -3513,6 +3531,14 @@ function getNativeRuntimeState(runtime, ctx) {
   }
   return runtimeState;
 }
+function readNativeRuntimeStateBag(runtime, ctx) {
+  return callNativeSync(
+    () => runtime.actorRuntimeState(ctx)
+  );
+}
+function isNativeRuntimeStateCleared(runtime, ctx) {
+  return readNativeRuntimeStateBag(runtime, ctx).cleared === true;
+}
 function getNativePersistState(runtime, ctx) {
   const persistState = getNativeRuntimeState(runtime, ctx).persistState;
   if (!persistState) {
@@ -3623,13 +3649,18 @@ function resolveNativeDestroy(runtime, ctx) {
   gate.destroyCompletion = void 0;
 }
 function clearNativeRuntimeState(runtime, ctx) {
+  var _a;
+  const pendingSaveHandle = (_a = readNativeRuntimeStateBag(runtime, ctx).persistState) == null ? void 0 : _a.pendingSaveHandle;
+  if (pendingSaveHandle !== void 0) {
+    clearImmediate(pendingSaveHandle);
+  }
   callNativeSync(() => runtime.actorClearRuntimeState(ctx));
+  readNativeRuntimeStateBag(runtime, ctx).cleared = true;
 }
 async function cleanupNativeSleepRuntimeState(runtime, ctx, afterTrackedWorkDrained) {
   const drained = await runtime.actorWaitForTrackedShutdownWork(ctx);
   if (!drained) {
-    await closeNativeDatabaseClient(runtime, ctx);
-    await closeNativeSqlDatabase(runtime, ctx);
+    await detachNativeDatabaseForShutdown(runtime, ctx);
     void runtime.actorWaitForTrackedShutdownWorkUnbounded(ctx).then(async () => {
       await (afterTrackedWorkDrained == null ? void 0 : afterTrackedWorkDrained());
       clearNativeRuntimeState(runtime, ctx);
@@ -3642,10 +3673,19 @@ async function cleanupNativeSleepRuntimeState(runtime, ctx, afterTrackedWorkDrai
     return;
   }
   await (afterTrackedWorkDrained == null ? void 0 : afterTrackedWorkDrained());
-  await closeNativeDatabaseClient(runtime, ctx);
-  await closeNativeSqlDatabase(runtime, ctx);
+  await detachNativeDatabaseForShutdown(runtime, ctx);
   clearNativeRuntimeState(runtime, ctx);
 }
+async function detachNativeDatabaseForShutdown(runtime, ctx) {
+  var _a;
+  const runtimeState = getNativeRuntimeState(runtime, ctx);
+  await ((_a = runtimeState.sql) == null ? void 0 : _a.detachForShutdown());
+  try {
+    await closeNativeDatabaseClient(runtime, ctx);
+  } finally {
+    runtimeState.sql = void 0;
+  }
+}
 function closeNativeSqlDatabase(runtime, ctx) {
   const runtimeState = getNativeRuntimeState(runtime, ctx);
   const database = runtimeState.sql;
@@ -5386,12 +5426,14 @@ var ActorContextHandleAdapter = class {
   }
   get abortSignal() {
     if (!this.#abortSignal) {
-      const actorSignal = this.#createActorAbortSignal();
+      const actorAbort = this.#actorAbort();
+      const actorSignal = actorAbort.signal;
       if (this.#dispatchCancelToken === void 0) {
         this.#abortSignal = actorSignal;
       } else {
         const controller = new AbortController();
         let cleanedUp = false;
+        let releaseDispatchListener;
         const onActorAbort = () => {
           cleanup();
           controller.abort();
@@ -5401,7 +5443,9 @@ var ActorContextHandleAdapter = class {
             return;
           }
           cleanedUp = true;
-          actorSignal.removeEventListener("abort", onActorAbort);
+          actorAbort.listeners.delete(onActorAbort);
+          releaseDispatchListener == null ? void 0 : releaseDispatchListener();
+          releaseDispatchListener = void 0;
           this.#abortSignalCleanup = void 0;
         };
         if (actorSignal.aborted || this.#runtime.cancellationTokenAborted(
@@ -5411,10 +5455,8 @@ var ActorContextHandleAdapter = class {
         } else {
           const dispatchCancelToken = this.#dispatchCancelToken;
           this.#abortSignalCleanup = cleanup;
-          actorSignal.addEventListener("abort", onActorAbort, {
-            once: true
-          });
-          callNativeSync(
+          actorAbort.listeners.add(onActorAbort);
+          releaseDispatchListener = callNativeSync(
             () => this.#runtime.onCancellationTokenCancelled(
               dispatchCancelToken,
               () => {
@@ -5790,22 +5832,42 @@ var ActorContextHandleAdapter = class {
   }
   async dispose() {
     var _a;
-    this.#flushStateChange();
+    if (!isNativeRuntimeStateCleared(this.#runtime, this.#ctx)) {
+      this.#flushStateChange();
+    }
     (_a = this.#abortSignalCleanup) == null ? void 0 : _a.call(this);
   }
-  #createActorAbortSignal() {
+  #actorAbort() {
+    const runtimeState = readNativeRuntimeStateBag(
+      this.#runtime,
+      this.#ctx
+    );
+    const cached = runtimeState.actorAbort;
+    if (cached && !cached.signal.aborted) {
+      return cached;
+    }
     const nativeSignal = callNativeSync(
       () => this.#runtime.actorAbortSignal(this.#ctx)
     );
     const controller = new AbortController();
-    if (nativeSignal.aborted) {
+    const actorAbort = {
+      signal: controller.signal,
+      listeners: /* @__PURE__ */ new Set()
+    };
+    const abort = () => {
       controller.abort();
+      for (const listener of actorAbort.listeners) {
+        listener();
+      }
+      actorAbort.listeners.clear();
+    };
+    if (nativeSignal.aborted) {
+      abort();
     } else {
-      nativeSignal.addEventListener("abort", () => controller.abort(), {
-        once: true
-      });
+      nativeSignal.addEventListener("abort", abort, { once: true });
     }
-    return controller.signal;
+    runtimeState.actorAbort = actorAbort;
+    return actorAbort;
   }
   #readState() {
     const actorState = getNativePersistState(this.#runtime, this.#ctx);
@@ -6767,7 +6829,7 @@ function buildNativeFactory(runtime, registryConfig, definition) {
           }
         } finally {
           resolveNativeDestroy(runtime, ctx);
-          await actorCtx.closeDatabase();
+          await detachNativeDatabaseForShutdown(runtime, ctx);
           clearNativeRuntimeState(runtime, ctx);
           await actorCtx.dispose();
         }
@@ -7271,11 +7333,12 @@ async function buildServeConfig(config, resolveServicesBinary = true) {
     throw nativeEndpointNotConfiguredError();
   }
   const serveConfig = {
-    version: config.envoy.version,
+    version: config.node.version,
     endpoint: config.endpoint,
+    engineSpawn: config.engineSpawn,
     token: config.token,
     namespace: config.namespace,
-    poolName: config.envoy.poolName,
+    poolName: config.node.poolName,
     startServices: resolveServicesBinary && config.startServices,
     handleInspectorHttpInRuntime: true,
     serverlessBasePath: config.serverless.basePath,
@@ -7296,14 +7359,16 @@ async function buildServeConfig(config, resolveServicesBinary = true) {
     });
   }
   if (resolveServicesBinary && config.startServices) {
-    try {
-      const { getServicesPath } = await loadServices();
-      serveConfig.servicesBinaryPath = getServicesPath();
-    } catch (error) {
-      logger2().warn({
-        msg: "could not resolve the Services binary; a local engine will fail with services.binary_unavailable \u2014 set RIVET_RUN_SERVICES=0 to disable Services or RIVET_SERVICES_BINARY to a local rivet-services binary",
-        error: stringifyError(error)
-      });
+    const servicesBinary = getEnvUniversal("RIVET_SERVICES_BINARY");
+    if (servicesBinary) {
+      serveConfig.servicesBinaryPath = servicesBinary;
+    } else {
+      try {
+        const { getServicesPath } = await loadServices();
+        serveConfig.servicesBinaryPath = getServicesPath();
+      } catch (error) {
+        throw servicesBinaryUnavailable(error);
+      }
     }
   }
   serveConfig.engineHost = config.engineHost;
@@ -7345,6 +7410,9 @@ async function buildConfiguredRegistry(config) {
 
 // src/registry/index.ts
 var REGISTRY_READY_TIMEOUT_MS = 3e4;
+function rejectServerless() {
+  throw new Error("serverless is disabled in this version");
+}
 function signalExitCode(signal) {
   switch (signal) {
     case "SIGINT":
@@ -7449,6 +7517,7 @@ var Registry = class {
    */
   #ensureServerlessPoolConfigured(config) {
     if (!config.configurePool) return void 0;
+    rejectServerless();
     if (!this.#configureServerlessPoolPromise) {
       this.#configureServerlessPoolPromise = configureServerlessPool(
         config
@@ -7473,6 +7542,7 @@ var Registry = class {
    */
   async handler(request) {
     var _a;
+    rejectServerless();
     const config = this.parseConfig();
     this.#printWelcome(config, "serverless");
     if (!this.#runtimeServerlessPromise) {
@@ -7634,6 +7704,7 @@ var Registry = class {
    * ```
    */
   serve() {
+    rejectServerless();
     return {
       fetch: (request) => this.handler(request)
     };
@@ -7658,6 +7729,9 @@ var Registry = class {
    * ```
    */
   async listen(opts = {}) {
+    if (!opts.application) {
+      rejectServerless();
+    }
     const port = opts.port ?? parsePortEnv(process.env.RIVET_PORT) ?? 3e3;
     const publicDir = opts.publicDir ?? getRivetkitPublicDir();
     const config = this.parseConfig();
@@ -7758,6 +7832,7 @@ var Registry = class {
    * Returns serverless metadata suitable for mounting in a user-owned router.
    */
   async #metadataRoute() {
+    rejectServerless();
     const configured = await this.#activeConfiguredRegistry();
     if (!configured) {
       return new Response("registry not started\n", {
@@ -7818,18 +7893,18 @@ var Registry = class {
   #startEnvoy(config, printWelcome) {
     var _a;
     if (!this.#runtimeServePromise) {
-      const configuredEnvoyVersion = (_a = this.#config.envoy) == null ? void 0 : _a.version;
+      const configuredEnvoyVersion = (_a = this.#config.node) == null ? void 0 : _a.version;
       const envoyVersionSource = configuredEnvoyVersion !== void 0 ? "config" : getRivetEnvoyVersion() !== void 0 ? "environment" : "default";
       logger2().info({
         msg: "starting rivetkit envoy",
         rivetkitVersion: VERSION,
-        envoyVersion: config.envoy.version,
+        envoyVersion: config.node.version,
         envoyVersionSource
       });
       if (envoyVersionSource === "default" && getNodeEnv() === "production") {
         logger2().error({
-          msg: "envoy version defaulted because neither config.envoy.version nor RIVET_ENVOY_VERSION is set; actors will not drain automatically across deploys. See https://rivet.dev/docs/actors/versions",
-          envoyVersion: config.envoy.version,
+          msg: "node version defaulted because neither config.node.version nor RIVET_NODE_VERSION is set; actors will not drain automatically across deploys. See https://rivet.dev/docs/actors/versions",
+          envoyVersion: config.node.version,
           envoyVersionSource
         });
       }
@@ -7841,7 +7916,10 @@ var Registry = class {
         }
       );
       this.#runtimeServePromise = this.#runtimeServeLifecyclePromise.catch((error) => {
-        logger2().warn({ error }, "runtime registry serve errored");
+        logger2().error({ error }, "runtime registry serve errored");
+        if (typeof process !== "undefined" && typeof process.exit === "function") {
+          process.exit(1);
+        }
       });
       this.#installSignalHandlers(config);
     }
@@ -7871,7 +7949,7 @@ var Registry = class {
       finishShutdownSignal(signal);
       return;
     }
-    this.#shutdownInFlight = this.#drain(config).catch((err) => {
+    this.#shutdownInFlight = this.#drain(config, true).catch((err) => {
       logger2().warn({ err }, "shutdown error");
     }).then(() => {
       this.#removeSignalHandlers();
@@ -7907,12 +7985,18 @@ var Registry = class {
     });
     return this.#shutdownInFlight;
   }
-  async #drain(config) {
+  async #drain(config, signalDriven = false) {
     var _a;
     const modeAPromise = this.#runtimeServeConfiguredPromise;
     const modeBPromise = this.#runtimeServerlessPromise;
     const runtimes = /* @__PURE__ */ new Set();
-    const gracePeriodMs = ((_a = config.shutdown) == null ? void 0 : _a.gracePeriodMs) ?? await this.#actorStopThresholdMs(modeAPromise ?? modeBPromise) ?? 30 * 60 * 1e3;
+    const localDevSignal = signalDriven && getNodeEnv() !== "production" && config.engineSpawn && config.endpoint !== void 0 && isLocalEngineEndpoint(config.endpoint);
+    let gracePeriodMs = (_a = config.shutdown) == null ? void 0 : _a.gracePeriodMs;
+    if (gracePeriodMs === void 0) {
+      gracePeriodMs = localDevSignal ? 1e3 : await this.#actorStopThresholdMs(
+        modeAPromise ?? modeBPromise
+      ) ?? 30 * 60 * 1e3;
+    }
     const drain = async () => {
       const registries = [];
       if (modeAPromise !== void 0) {
@@ -8017,12 +8101,16 @@ var Registry = class {
       );
     }
     if (this.#runtimeReadyPromise) return this.#runtimeReadyPromise;
-    if (getRivetkitRuntimeMode() === "serverless") {
-      return Promise.reject(
-        new Error(
-          "registry.startAndWait() requires envoy runtime mode; serverless registries become ready per request"
-        )
-      );
+    try {
+      if (getRivetkitRuntimeMode() === "serverless") {
+        return Promise.reject(
+          new Error(
+            "registry.startAndWait() requires envoy runtime mode; serverless registries become ready per request"
+          )
+        );
+      }
+    } catch (error) {
+      return Promise.reject(error);
     }
     const config = this.parseConfig();
     if (config.runtime === "wasm") {