rivetkit 2.3.12-rc.4 → 2.3.12

package/dist/tsup/test/mod.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-var _chunkXDYECGCTcjs = require('../chunk-XDYECGCT.cjs');
+var _chunkSSPTEGTXcjs = require('../chunk-SSPTEGTX.cjs');
 
 
-var _chunkF7G5WHODcjs = require('../chunk-F7G5WHOD.cjs');
+var _chunkTZPNSOG2cjs = require('../chunk-TZPNSOG2.cjs');
 require('../chunk-MYWZCDML.cjs');
+require('../chunk-TXUHVBKH.cjs');
 require('../chunk-KVFIONKQ.cjs');
-require('../chunk-OCXHNHGQ.cjs');
-require('../chunk-ARFTQ5HY.cjs');
-require('../chunk-SPJORZMM.cjs');
+require('../chunk-TAG6UEL5.cjs');
+require('../chunk-2JSYYH6P.cjs');
 
 // src/test/ready.ts
 var _pretry = require('p-retry'); var _pretry2 = _interopRequireDefault(_pretry);
@@ -36,8 +36,8 @@ async function setupTest(c, registry) {
   registry.config.noWelcome = true;
   registry.start();
   await waitForRegistryReady(registry);
-  const client = _chunkXDYECGCTcjs.createClient.call(void 0, {
-    ..._chunkF7G5WHODcjs.convertRegistryConfigToClientConfig.call(void 0, registry.parseConfig()),
+  const client = _chunkSSPTEGTXcjs.createClient.call(void 0, {
+    ..._chunkTZPNSOG2cjs.convertRegistryConfigToClientConfig.call(void 0, registry.parseConfig()),
     disableMetadataLookup: false
   });
   c.onTestFinished(async () => {

package/dist/tsup/test/mod.d.cts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { aG as Registry, a3 as Client } from '../config-VxDc6yMu.cjs';
+import { aF as Registry, a3 as Client } from '../config-NHz6oMb9.cjs';
 import 'zod/v4';
 import '../config-ey2I2zz5.cjs';
 import '@rivetkit/rivetkit-wasm';

package/dist/tsup/test/mod.d.ts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { aG as Registry, a3 as Client } from '../config-DzaddF-j.js';
+import { aF as Registry, a3 as Client } from '../config-BGTanB_3.js';
 import 'zod/v4';
 import '../config-ey2I2zz5.js';
 import '@rivetkit/rivetkit-wasm';

package/dist/tsup/test/mod.js

@@ -1,14 +1,14 @@
 import {
   createClient
-} from "../chunk-GMBCKV6C.js";
+} from "../chunk-RBXJWAJB.js";
 import {
   convertRegistryConfigToClientConfig
-} from "../chunk-O74736N5.js";
+} from "../chunk-VOYNLY57.js";
 import "../chunk-JI6GZ2C2.js";
+import "../chunk-JYTXOMM7.js";
 import "../chunk-JTHHCZCZ.js";
-import "../chunk-NVMHEG5J.js";
-import "../chunk-64DT44V2.js";
-import "../chunk-IXBD7BXC.js";
+import "../chunk-MF42PRF2.js";
+import "../chunk-OUQUIBVW.js";
 
 // src/test/ready.ts
 import pRetry from "p-retry";

package/dist/tsup/utils.cjs

@@ -19,8 +19,8 @@
 
 
 
-var _chunkARFTQ5HYcjs = require('./chunk-ARFTQ5HY.cjs');
-require('./chunk-SPJORZMM.cjs');
+var _chunkTAG6UEL5cjs = require('./chunk-TAG6UEL5.cjs');
+require('./chunk-2JSYYH6P.cjs');
 
 
 
@@ -42,5 +42,5 @@ require('./chunk-SPJORZMM.cjs');
 
 
 
-exports.EXTRA_ERROR_LOG = _chunkARFTQ5HYcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkARFTQ5HYcjs.SinglePromiseQueue; exports.VERSION = _chunkARFTQ5HYcjs.VERSION; exports.arrayBuffersEqual = _chunkARFTQ5HYcjs.arrayBuffersEqual; exports.assertUnreachable = _chunkARFTQ5HYcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkARFTQ5HYcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkARFTQ5HYcjs.combineUrlPath; exports.dbg = _chunkARFTQ5HYcjs.dbg; exports.detectRuntime = _chunkARFTQ5HYcjs.detectRuntime; exports.getEnvUniversal = _chunkARFTQ5HYcjs.getEnvUniversal; exports.httpUserAgent = _chunkARFTQ5HYcjs.httpUserAgent; exports.interval = _chunkARFTQ5HYcjs.interval; exports.joinSignals = _chunkARFTQ5HYcjs.joinSignals; exports.jsonParseCompat = _chunkARFTQ5HYcjs.jsonParseCompat; exports.jsonStringifyCompat = _chunkARFTQ5HYcjs.jsonStringifyCompat; exports.promiseWithResolvers = _chunkARFTQ5HYcjs.promiseWithResolvers; exports.setLongTimeout = _chunkARFTQ5HYcjs.setLongTimeout; exports.sleep = _chunkARFTQ5HYcjs.sleep; exports.stringifyError = _chunkARFTQ5HYcjs.stringifyError; exports.toUint8Array = _chunkARFTQ5HYcjs.toUint8Array;
+exports.EXTRA_ERROR_LOG = _chunkTAG6UEL5cjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkTAG6UEL5cjs.SinglePromiseQueue; exports.VERSION = _chunkTAG6UEL5cjs.VERSION; exports.arrayBuffersEqual = _chunkTAG6UEL5cjs.arrayBuffersEqual; exports.assertUnreachable = _chunkTAG6UEL5cjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkTAG6UEL5cjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkTAG6UEL5cjs.combineUrlPath; exports.dbg = _chunkTAG6UEL5cjs.dbg; exports.detectRuntime = _chunkTAG6UEL5cjs.detectRuntime; exports.getEnvUniversal = _chunkTAG6UEL5cjs.getEnvUniversal; exports.httpUserAgent = _chunkTAG6UEL5cjs.httpUserAgent; exports.interval = _chunkTAG6UEL5cjs.interval; exports.joinSignals = _chunkTAG6UEL5cjs.joinSignals; exports.jsonParseCompat = _chunkTAG6UEL5cjs.jsonParseCompat; exports.jsonStringifyCompat = _chunkTAG6UEL5cjs.jsonStringifyCompat; exports.promiseWithResolvers = _chunkTAG6UEL5cjs.promiseWithResolvers; exports.setLongTimeout = _chunkTAG6UEL5cjs.setLongTimeout; exports.sleep = _chunkTAG6UEL5cjs.sleep; exports.stringifyError = _chunkTAG6UEL5cjs.stringifyError; exports.toUint8Array = _chunkTAG6UEL5cjs.toUint8Array;
 //# sourceMappingURL=utils.cjs.map

package/dist/tsup/utils.js

@@ -19,8 +19,8 @@ import {
   sleep,
   stringifyError,
   toUint8Array
-} from "./chunk-64DT44V2.js";
-import "./chunk-IXBD7BXC.js";
+} from "./chunk-MF42PRF2.js";
+import "./chunk-OUQUIBVW.js";
 export {
   EXTRA_ERROR_LOG,
   SinglePromiseQueue,

package/dist/tsup/workflow/mod.cjs

@@ -1,23 +1,23 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } var _class; var _class2;
 
-var _chunkNKLM6C5Acjs = require('../chunk-NKLM6C5A.cjs');
-require('../chunk-JIOLC5I2.cjs');
-require('../chunk-S3GXVCIM.cjs');
+var _chunkMEF7RVQ7cjs = require('../chunk-MEF7RVQ7.cjs');
+require('../chunk-AN7WO7BM.cjs');
+require('../chunk-PW2VSGUR.cjs');
 
 
 
-var _chunkIAH47VDZcjs = require('../chunk-IAH47VDZ.cjs');
+var _chunk4KGXFC6Mcjs = require('../chunk-4KGXFC6M.cjs');
 
 
 
 var _chunkMYWZCDMLcjs = require('../chunk-MYWZCDML.cjs');
 
 
-var _chunkARFTQ5HYcjs = require('../chunk-ARFTQ5HY.cjs');
+var _chunkTAG6UEL5cjs = require('../chunk-TAG6UEL5.cjs');
 
 
 
-var _chunkSPJORZMMcjs = require('../chunk-SPJORZMM.cjs');
+var _chunk2JSYYH6Pcjs = require('../chunk-2JSYYH6P.cjs');
 
 // src/workflow/mod.ts
 
@@ -705,7 +705,7 @@ function shouldRethrowWorkflowError(error) {
   return true;
 }
 function workflowReplayInFlightError() {
-  return new (0, _chunkSPJORZMMcjs.RivetError)(
+  return new (0, _chunk2JSYYH6Pcjs.RivetError)(
     "actor",
     "workflow_in_flight",
     "Workflow replay is unavailable while the workflow is currently in flight.",
@@ -719,7 +719,7 @@ function isWorkflowReplayBlockedByRunningEntry(error) {
   return error instanceof Error && error.message === "Cannot replay a workflow while a step is currently running";
 }
 function isRunHandlerUnavailable(error) {
-  return error instanceof _chunkSPJORZMMcjs.RivetError && error.group === "actor" && error.code === "run_handler_unavailable";
+  return error instanceof _chunk2JSYYH6Pcjs.RivetError && error.group === "actor" && error.code === "run_handler_unavailable";
 }
 function workflow(fn, options = {}) {
   const onError = options.onError;
@@ -727,13 +727,13 @@ function workflow(fn, options = {}) {
   function getWorkflowInspector(actorId) {
     let workflowInspector = workflowInspectors.get(actorId);
     if (!workflowInspector) {
-      workflowInspector = _chunkNKLM6C5Acjs.createWorkflowInspectorAdapter.call(void 0, );
+      workflowInspector = _chunkMEF7RVQ7cjs.createWorkflowInspectorAdapter.call(void 0, );
       workflowInspectors.set(actorId, workflowInspector);
     }
     return workflowInspector;
   }
   async function run(runCtx) {
-    const actor = runCtx[_chunkIAH47VDZcjs.ACTOR_CONTEXT_INTERNAL_SYMBOL];
+    const actor = runCtx[_chunk4KGXFC6Mcjs.ACTOR_CONTEXT_INTERNAL_SYMBOL];
     _invariant2.default.call(void 0, actor, "workflow() requires an actor instance");
     const workflowInspector = getWorkflowInspector(actor.id);
     const driver = new ActorWorkflowDriver(actor, runCtx);
@@ -794,25 +794,25 @@ function workflow(fn, options = {}) {
     try {
       await handle.result;
     } catch (error) {
-      if (runCtx.abortSignal.aborted || _chunkSPJORZMMcjs.isActorAbortedError.call(void 0, error)) {
+      if (runCtx.abortSignal.aborted || _chunk2JSYYH6Pcjs.isActorAbortedError.call(void 0, error)) {
         return;
       }
       if (shouldRethrowWorkflowError(error)) {
         runCtx.log.error({
           msg: "workflow run failed",
-          error: _chunkARFTQ5HYcjs.stringifyError.call(void 0, error)
+          error: _chunkTAG6UEL5cjs.stringifyError.call(void 0, error)
         });
         throw error;
       }
       runCtx.log.warn({
         msg: "workflow failed and will sleep until woken",
-        error: _chunkARFTQ5HYcjs.stringifyError.call(void 0, error)
+        error: _chunkTAG6UEL5cjs.stringifyError.call(void 0, error)
       });
     } finally {
       runCtx.abortSignal.removeEventListener("abort", onAbort);
     }
   }
-  return _chunkIAH47VDZcjs.defineRunHandler.call(void 0, run, {
+  return _chunk4KGXFC6Mcjs.defineRunHandler.call(void 0, run, {
     icon: "diagram-project",
     inspectorKind: "workflow",
     createInspector: ({ actorId, control }) => {

package/dist/tsup/workflow/mod.d.cts

@@ -1,9 +1,9 @@
 import { WorkflowErrorEvent } from '@rivetkit/workflow-engine';
 export { Loop, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowError, WorkflowErrorEvent } from '@rivetkit/workflow-engine';
-import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-VxDc6yMu.cjs';
+import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-NHz6oMb9.cjs';
 import { A as AnyDatabaseProvider } from '../config-ey2I2zz5.cjs';
-import { d as WorkflowContext } from '../context-Cn8CIrOR.cjs';
-export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-Cn8CIrOR.cjs';
+import { d as WorkflowContext } from '../context-DB8zG_Ib.cjs';
+export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-DB8zG_Ib.cjs';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';

package/dist/tsup/workflow/mod.d.ts

@@ -1,9 +1,9 @@
 import { WorkflowErrorEvent } from '@rivetkit/workflow-engine';
 export { Loop, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowError, WorkflowErrorEvent } from '@rivetkit/workflow-engine';
-import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-DzaddF-j.js';
+import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-BGTanB_3.js';
 import { A as AnyDatabaseProvider } from '../config-ey2I2zz5.js';
-import { d as WorkflowContext } from '../context-B6HYokje.js';
-export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-B6HYokje.js';
+import { d as WorkflowContext } from '../context-SHomdVV8.js';
+export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-SHomdVV8.js';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';

package/dist/tsup/workflow/mod.js

@@ -1,23 +1,23 @@
 import {
   createWorkflowInspectorAdapter
-} from "../chunk-3CBQIP37.js";
-import "../chunk-P5JJG4KY.js";
-import "../chunk-BQ7YJ3PG.js";
+} from "../chunk-XUODFCRJ.js";
+import "../chunk-ZIPXAVKR.js";
+import "../chunk-GEN4NHXM.js";
 import {
   ACTOR_CONTEXT_INTERNAL_SYMBOL,
   defineRunHandler
-} from "../chunk-DLQSZ6Q7.js";
+} from "../chunk-6W5VGLFT.js";
 import {
   makeWorkflowKey,
   workflowStoragePrefix
 } from "../chunk-JI6GZ2C2.js";
 import {
   stringifyError
-} from "../chunk-64DT44V2.js";
+} from "../chunk-MF42PRF2.js";
 import {
   RivetError,
   isActorAbortedError
-} from "../chunk-IXBD7BXC.js";
+} from "../chunk-OUQUIBVW.js";
 
 // src/workflow/mod.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rivetkit",
-	"version": "2.3.12-rc.4",
+	"version": "2.3.12",
 	"description": "Lightweight libraries for building stateful actors on edge platforms",
 	"license": "Apache-2.0",
 	"keywords": [
@@ -210,15 +210,16 @@
 	"dependencies": {
 		"@hono/zod-openapi": "^1.1.5",
 		"@rivet-dev/agent-os-core": "^0.1.1",
+		"@rivet-dev/services": "^0.1.3",
 		"@rivetkit/bare-ts": "^0.6.2",
-		"@rivetkit/engine-cli": "2.3.12-rc.4",
-		"@rivetkit/engine-envoy-protocol": "2.3.12-rc.4",
+		"@rivetkit/engine-cli": "2.3.12",
+		"@rivetkit/engine-envoy-protocol": "2.3.12",
 		"@rivetkit/on-change": "6.0.1",
-		"@rivetkit/rivetkit-napi": "2.3.12-rc.4",
-		"@rivetkit/rivetkit-wasm": "2.3.12-rc.4",
-		"@rivetkit/traces": "2.3.12-rc.4",
-		"@rivetkit/virtual-websocket": "2.3.12-rc.4",
-		"@rivetkit/workflow-engine": "2.3.12-rc.4",
+		"@rivetkit/rivetkit-napi": "2.3.12",
+		"@rivetkit/rivetkit-wasm": "2.3.12",
+		"@rivetkit/traces": "2.3.12",
+		"@rivetkit/virtual-websocket": "2.3.12",
+		"@rivetkit/workflow-engine": "2.3.12",
 		"cbor-x": "^1.6.0",
 		"drizzle-orm": "^0.44.2",
 		"hono": "^4.7.0",

package/src/actor/config.test.ts

@@ -18,14 +18,6 @@ describe("ActorOptionsSchema", () => {
 				.enableActorRuntimeSocket,
 		).toBe(true);
 	});
-
-	test("defaults the action limit to 128 and accepts overrides", () => {
-		expect(ActorOptionsSchema.parse({}).maxActions).toBe(128);
-		expect(ActorOptionsSchema.parse({ maxActions: 256 }).maxActions).toBe(
-			256,
-		);
-		expect(() => ActorOptionsSchema.parse({ maxActions: -1 })).toThrow();
-	});
 });
 
 describe("defineRunHandler", () => {

package/src/actor/config.ts

@@ -18,7 +18,6 @@ import type {
 } from "./schema";
 
 export const DEFAULT_SLEEP_GRACE_PERIOD = 15_000;
-export const DEFAULT_MAX_ACTIONS = 128;
 
 export const ACTOR_CONTEXT_INTERNAL_SYMBOL = Symbol(
 	"rivetkit.actor_context_internal",
@@ -1230,8 +1229,6 @@ const GlobalActorOptionsBaseSchema = z
 		name: z.string().optional(),
 		/** Icon for the actor in the Inspector UI. Can be an emoji or FontAwesome icon name. */
 		icon: z.string().optional(),
-		/** Maximum number of action handlers that may be defined on this actor. */
-		maxActions: z.number().int().nonnegative().default(DEFAULT_MAX_ACTIONS),
 		/** Enables the experimental Actor Runtime Socket for this actor. */
 		enableActorRuntimeSocket: z.boolean().default(false),
 		/**
@@ -1362,19 +1359,7 @@ export const ActorConfigSchema = z
 			message: "Cannot define both 'vars' and 'createVars'",
 			path: ["vars"],
 		},
-	)
-	.superRefine((data, ctx) => {
-		const actionCount = Object.keys(
-			flattenActionHandlers(data.actions),
-		).length;
-		if (actionCount > data.options.maxActions) {
-			ctx.addIssue({
-				code: "custom",
-				message: `Actor defines ${actionCount} actions, but maxActions is ${data.options.maxActions}`,
-				path: ["actions"],
-			});
-		}
-	});
+	);
 
 // Creates state config
 //
@@ -2175,14 +2160,6 @@ export const DocActorOptionsSchema = z
 			.describe(
 				"Icon for the actor in the Inspector UI. Can be an emoji (e.g., '🚀') or FontAwesome icon name (e.g., 'rocket').",
 			),
-		maxActions: z
-			.number()
-			.int()
-			.nonnegative()
-			.optional()
-			.describe(
-				`Maximum number of action handlers that may be defined on this actor. Default: ${DEFAULT_MAX_ACTIONS}`,
-			),
 		enableActorRuntimeSocket: z
 			.boolean()
 			.optional()

package/src/actor/errors.ts

@@ -45,7 +45,8 @@ export interface BridgeRivetErrorPayload extends RivetErrorLike {}
  * Shape as it arrives from the native bridge, where an absent ray ID serializes
  * to null. Normalized to a BridgeRivetErrorPayload before validation.
  */
-interface NativeBridgeErrorPayload extends Omit<BridgeRivetErrorPayload, "rayId"> {
+interface NativeBridgeErrorPayload
+	extends Omit<BridgeRivetErrorPayload, "rayId"> {
 	rayId?: string | null;
 }
 

package/src/client/actor-handle.ts

@@ -4,6 +4,7 @@ import {
 	HEADER_CONN_PARAMS,
 	HEADER_ENCODING,
 } from "@/common/actor-router-consts";
+import { isRequestLike } from "@/common/fetch-like";
 import type * as protocol from "@/common/client-protocol";
 import {
 	CURRENT_VERSION as CLIENT_PROTOCOL_CURRENT_VERSION,
@@ -142,7 +143,9 @@ export class ActorHandleRaw {
 			// Dynamic (get/getOrCreate) handles resolve at the gateway per
 			// request so cross-datacenter queries forward to the reserved dc,
 			// rather than pre-resolving via the non-forwarding PUT /actors path.
-			let useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
+			let useQueryTarget = isDynamicActorQuery(
+				this.#actorResolutionState,
+			);
 
 			for (let attempt = 0; attempt < maxAttempts; attempt++) {
 				let actorId: string | undefined;
@@ -651,9 +654,13 @@ export class ActorHandleRaw {
 		input: string | URL | Request,
 		init?: ActorFetchInit,
 	) {
-		const maxAttempts = this.#getDynamicQueryMaxAttempts();
-		let useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
 		const { skipReadyWait, ...requestInit } = init ?? {};
+		const hasBody =
+			requestInit.body !== undefined
+				? requestInit.body !== null
+				: isRequestLike(input) && input.body !== null;
+		const maxAttempts = hasBody ? 1 : this.#getDynamicQueryMaxAttempts();
+		let useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
 		const gatewayOptions = resolveActorGatewayOptions(
 			this.#gatewayOptions,
 			{

package/src/client/raw-utils.ts

@@ -1,5 +1,6 @@
 import {
 	HEADER_CONN_PARAMS,
+	HEADER_ORIGINAL_REQUEST_URL,
 	PATH_WEBSOCKET_PREFIX,
 } from "@/common/actor-router-consts";
 import { deconstructError } from "@/common/utils";
@@ -25,16 +26,19 @@ export async function rawHttpFetch(
 ): Promise<Response> {
 	// Extract path and merge init options
 	let path: string;
+	let originalUrl: string | undefined;
 	let mergedInit: RequestInit = init || {};
 
 	if (typeof input === "string") {
 		path = input;
 	} else if (isUrlLike(input)) {
 		path = input.pathname + input.search;
+		originalUrl = input.toString();
 	} else if (isRequestLike(input)) {
 		// Extract path from Request URL
 		const url = new URL(input.url);
 		path = url.pathname + url.search;
+		originalUrl = url.toString();
 		// Merge Request properties with init
 		const requestHeaders = new Headers(input.headers);
 		const initHeaders = new Headers(init?.headers || {});
@@ -86,6 +90,10 @@ export async function rawHttpFetch(
 
 		// Forward conn params if provided
 		const proxyRequestHeaders = new Headers(mergedInit.headers);
+		proxyRequestHeaders.delete(HEADER_ORIGINAL_REQUEST_URL);
+		if (originalUrl) {
+			proxyRequestHeaders.set(HEADER_ORIGINAL_REQUEST_URL, originalUrl);
+		}
 		if (params) {
 			proxyRequestHeaders.set(HEADER_CONN_PARAMS, JSON.stringify(params));
 		}

package/src/common/actor-router-consts.ts

@@ -12,6 +12,8 @@ export const HEADER_ENCODING = "x-rivet-encoding";
 
 // IMPORTANT: Params must be in headers or in an E2EE part of the request (i.e. NOT the URL or query string) in order to ensure that tokens can be securely passed in params.
 export const HEADER_CONN_PARAMS = "x-rivet-conn-params";
+export const HEADER_ORIGINAL_REQUEST_URL =
+	"x-rivet-internal-original-request-url";
 
 export const HEADER_ACTOR_ID = "x-rivet-actor";
 export const HEADER_ACTOR_GENERATION = "x-rivet-actor-generation";

package/src/engine-client/actor-http-client.ts

@@ -17,8 +17,7 @@ export async function sendHttpRequestToGateway(
 	actorRequest: Request,
 	options: HttpGatewayRequestOptions = {},
 ): Promise<Response> {
-	// Handle body properly based on method and presence
-	let bodyToSend: ArrayBuffer | null = null;
+	let bodyToSend: ReadableStream<Uint8Array> | null = null;
 	const guardHeaders = buildGuardHeaders(runConfig, actorRequest, options);
 
 	if (actorRequest.method !== "GET" && actorRequest.method !== "HEAD") {
@@ -26,35 +25,20 @@ export async function sendHttpRequestToGateway(
 			throw new Error("Request body has already been consumed");
 		}
 
-		// TODO: This buffers the entire request in memory every time. We
-		// need to properly implement streaming bodies.
-		const reqBody = await actorRequest.arrayBuffer();
-
-		if (reqBody.byteLength !== 0) {
-			bodyToSend = reqBody;
-
-			// If this is a streaming request, we need to convert the headers
-			// for the basic array buffer.
+		if (actorRequest.body) {
+			bodyToSend = actorRequest.body;
 			guardHeaders.delete("transfer-encoding");
 			guardHeaders.delete("content-length");
 		}
 	}
 
-	const guardRequest = new Request(gatewayUrl, {
+	return fetch(gatewayUrl, {
 		method: actorRequest.method,
 		headers: guardHeaders,
 		body: bodyToSend,
 		signal: actorRequest.signal,
-	});
-
-	return mutableResponse(await fetch(guardRequest));
-}
-
-function mutableResponse(fetchRes: Response): Response {
-	// We cannot return the raw response from `fetch` since the response type is not mutable.
-	//
-	// In order for middleware to be able to mutate the response, we need to build a new Response object that is mutable.
-	return new Response(fetchRes.body, fetchRes);
+		...(bodyToSend ? { duplex: "half" } : {}),
+	} as RequestInit);
 }
 
 function buildGuardHeaders(

package/src/engine-client/mod.ts

@@ -462,7 +462,7 @@ export class RemoteEngineControlClient implements EngineControlClient {
 				undefined,
 				"getOrCreateForKey" in target
 					? (target.getOrCreateForKey.poolName ??
-						this.#config.poolName)
+							this.#config.poolName)
 					: undefined,
 				options,
 			);

package/src/registry/config/index.ts

@@ -1,7 +1,12 @@
 import { z } from "zod";
 import { getRunMetadata } from "@/actor/config";
 import type { AnyActorDefinition } from "@/actor/definition";
-import { buildEngineEndpoint, ENGINE_HOST, ENGINE_PORT } from "@/common/engine";
+import {
+	buildEngineEndpoint,
+	ENGINE_HOST,
+	ENGINE_PORT,
+	isLocalEngineEndpoint,
+} from "@/common/engine";
 import { type Logger, LogLevelSchema } from "@/common/log";
 import { VERSION } from "@/utils";
 import { tryParseEndpoint } from "@/utils/endpoint-parser";
@@ -14,6 +19,7 @@ import {
 	getRivetRunEngineHost,
 	getRivetRunEnginePort,
 	getRivetRunEngineVersion,
+	getRivetRunServices,
 	getRivetToken,
 	isDev,
 } from "@/utils/env-vars";
@@ -243,6 +249,12 @@ export const RegistryConfigSchema = z
 			.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.
+		 */
+		startServices: z.boolean().optional(),
 		/**
 		 * @experimental
 		 *
@@ -354,6 +366,13 @@ export const RegistryConfigSchema = z
 			? localEngineEndpoint
 			: (parsedEndpoint?.endpoint ??
 				(isDevEnv ? localEngineEndpoint : undefined));
+		// Services is another local development actor host. Its default
+		// follows the same local-endpoint decision that causes core to manage the
+		// Engine, while explicit config and RIVET_RUN_SERVICES take precedence.
+		const startServices =
+			config.startServices ??
+			getRivetRunServices() ??
+			Boolean(endpoint && isLocalEngineEndpoint(endpoint));
 		const validateServerlessEndpoint = Boolean(
 			config.startEngine || parsedEndpoint,
 		);
@@ -398,6 +417,7 @@ export const RegistryConfigSchema = z
 			...config,
 			sqlite,
 			endpoint,
+			startServices,
 			namespace,
 			token,
 			publicEndpoint,
@@ -629,6 +649,12 @@ export const DocRegistryConfigSchema = z
 			.describe(
 				"Version of the local engine package to use. Defaults to the current RivetKit version.",
 			),
+		startServices: z
+			.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.",
+			),
 		configurePool: DocConfigurePoolSchema.describe(
 			"Automatically configure serverless runners in the engine.",
 		),