feat(engine): add engine driver

Author: NathanFlurry

.gitattributes

@@ -7,4 +7,5 @@
 
 *.png binary
 *.jpg binary
+*.tgz binary
 

NEW_SPEC.md

@@ -158,20 +158,21 @@
   },
   "dependencies": {
     "@hono/standard-validator": "^0.1.3",
-    "cbor-x": "^1.6.0",
+    "@hono/zod-openapi": "^0.19.10",
     "@rivetkit/fast-json-patch": "^3.1.2",
+    "cbor-x": "^1.6.0",
+    "hono": "^4.7.0",
     "invariant": "^2.2.4",
     "nanoevents": "^9.1.0",
     "on-change": "^5.0.1",
     "p-retry": "^6.2.1",
-    "zod": "^3.25.76",
-    "@hono/zod-openapi": "^0.19.10",
-    "hono": "^4.7.0"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.14.0",
+    "@hono/node-server": "^1.18.2",
     "@hono/node-ws": "^1.1.1",
     "@rivet-gg/actor-core": "^25.1.0",
+    "@rivetkit/engine-runner": "https://pkg.pr.new/rivet-gg/engine/@rivetkit/engine-runner@435",
     "@types/invariant": "^2",
     "@types/node": "^22.13.1",
     "@types/ws": "^8",

NEW_SPEC2.md

@@ -149,14 +149,25 @@ export class ActorHandleRaw {
 			"getOrCreateForKey" in this.#actorQuery
 		) {
 			// TODO:
+			let name: string;
+			if ("getForKey" in this.#actorQuery) {
+				name = this.#actorQuery.getForKey.name;
+			} else if ("getOrCreateForKey" in this.#actorQuery) {
+				name = this.#actorQuery.getOrCreateForKey.name;
+			} else {
+				assertUnreachable(this.#actorQuery);
+			}
+
 			const actorId = await this.#driver.resolveActorId(
 				undefined,
 				this.#actorQuery,
 				this.#encodingKind,
 				this.#params,
 				signal ? { signal } : undefined,
 			);
-			this.#actorQuery = { getForId: { actorId } };
+
+			this.#actorQuery = { getForId: { actorId, name } };
+
 			return actorId;
 		} else if ("getForId" in this.#actorQuery) {
 			// SKip since it's already resolved

packages/core/package.json

@@ -268,8 +268,9 @@ export class ClientRaw {
 			params: opts?.params,
 		});
 
-		const actorQuery = {
+		const actorQuery: ActorQuery = {
 			getForId: {
+				name,
 				actorId,
 			},
 		};
@@ -400,6 +401,7 @@ export class ClientRaw {
 		// Create handle with actor ID
 		const getForIdQuery = {
 			getForId: {
+				name,
 				actorId,
 			},
 		} satisfies ActorQuery;

packages/core/src/client/actor-handle.ts

@@ -1,6 +1,7 @@
+import { UserError } from "@/actor/errors";
 import { logger } from "@/actor/log";
 import { createFileSystemOrMemoryDriver } from "@/drivers/file-system/mod";
-import { type DriverConfig, UserError } from "@/mod";
+import type { DriverConfig } from "@/registry/run-config";
 import { getEnvUniversal } from "@/utils";
 
 /**