fix: run dynamic app actors inside AgentOS

Author: NathanFlurry

Dockerfile

@@ -9,6 +9,7 @@ WORKDIR /app
 
 COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
 COPY packages/dynamic-apps/package.json packages/dynamic-apps/package.json
+COPY packages/dynamic-apps-core/package.json packages/dynamic-apps-core/package.json
 COPY packages/dynamic-apps-builder/package.json packages/dynamic-apps-builder/package.json
 COPY benchmarks/dynamic-apps/package.json benchmarks/dynamic-apps/package.json
 COPY examples/apps-ai-builder/package.json examples/apps-ai-builder/package.json

benchmarks/dynamic-apps/package.json

@@ -4,15 +4,15 @@
 	"private": true,
 	"type": "module",
 	"scripts": {
-		"benchmark:local": "node --import tsx src/local.ts --host 0.0.0.0",
-		"benchmark:cloud-stress": "node --import tsx src/cloud-stress.ts",
-		"benchmark:stress": "node --expose-gc --import tsx src/runtime-stress.ts",
-		"benchmark:suite": "node --import tsx src/suite.ts",
-		"deploy:fixture": "node --import tsx src/deploy-fixture.ts",
-		"load": "node --import tsx src/load.ts",
-		"start": "node --import tsx src/server.ts --host 0.0.0.0",
+		"benchmark:local": "npx tsx src/local.ts --host 0.0.0.0",
+		"benchmark:cloud-stress": "npx tsx src/cloud-stress.ts",
+		"benchmark:stress": "npx tsx --expose-gc src/runtime-stress.ts",
+		"benchmark:suite": "npx tsx src/suite.ts",
+		"deploy:fixture": "npx tsx src/deploy-fixture.ts",
+		"load": "npx tsx src/load.ts",
+		"start": "npx tsx src/server.ts --host 0.0.0.0",
 		"check-types": "tsc --noEmit",
-		"test": "node --import tsx --test src/load.test.ts"
+		"test": "npx tsx --test src/load.test.ts"
 	},
 	"dependencies": {
 		"@hono/node-server": "^2.0.11",

benchmarks/dynamic-apps/src/edge.ts

@@ -101,12 +101,7 @@ export function createBenchmarkApplication(): Hono {
 		) as unknown as ActorApplicationClient;
 		return actorApplicationClient;
 	};
-	const privateRegistry = (request: Request) => {
-		const headers = new Headers(request.headers);
-		headers.set("x-agentos-app-registry-dispatch", "1");
-		return appsRouter.fetch(new Request(request, { headers }));
-	};
-	app.all("/api/rivet/*", (c) => privateRegistry(c.req.raw));
+	app.all("/api/rivet/*", (c) => appsRouter.fetch(c.req.raw));
 
 	app.all("/bench/noop", () => {
 		const startedAt = performance.now();

docs/content/docs/quickstart-core.mdx

@@ -59,7 +59,7 @@ disposes the instance during shutdown.
 Pass the listening host on the command line:
 
 ```sh
-node --import tsx src/server.ts --host 0.0.0.0
+npx tsx src/server.ts --host 0.0.0.0
 ```
 
 </Step>

docs/content/docs/quickstart.mdx

@@ -33,7 +33,7 @@ served by `appsRouter` through a cached agentOS VM.
 Run the server normally:
 
 ```sh
-node --import tsx src/server.ts
+npx tsx src/server.ts
 ```
 
 </Step>
@@ -46,7 +46,7 @@ agent, an upload endpoint, or another trusted control-plane process.
 <CodeSnippet file="examples/apps-hello-world/src/deploy.ts" title="src/deploy.ts" />
 
 ```sh
-node --import tsx src/deploy.ts
+npx tsx src/deploy.ts
 ```
 
 </Step>

docs/content/docs/reference.mdx

@@ -9,11 +9,13 @@ Give an agent the app requirements, let it generate the project files, and pass
 those files to `deployApp()`. If the build returns TypeScript diagnostics, give
 them back to the agent and deploy its repaired files again.
 
+Import `webServerSkill` and `rivetActorsSkill` from
+`@rivet-dev/dynamic-apps` and include them in the model prompt. They describe
+the supported TypeScript server layout and Rivet actor integration.
+
 [View the complete AI App Builder example](https://github.com/rivet-dev/dynamic-apps/tree/main/examples/apps-ai-builder).
 
 ## Planned Improvements
 
-- Automatically include agent skills based on the
-  [Actors Learn guides](https://rivet.dev/actors/learn/) for better app generation.
 - Billing API for tracking and charging for app usage.
 - Built-in error reporting for generated apps.

docs/content/docs/routing.mdx

@@ -5,23 +5,15 @@ skill: true
 ---
 
 The package root exports one router. Mount ordinary application traffic at any
-prefix and explicitly dispatch the private `/api/rivet` callback to the same
-router:
+prefix and forward the private `/api/rivet/*` callback to the same router:
 
 ```ts
 import { appsRouter } from "@rivet-dev/dynamic-apps";
 import { Hono } from "hono";
 
 const server = new Hono();
 
-const dispatchRegistry = (request: Request) => {
-  const headers = new Headers(request.headers);
-  headers.set("x-agentos-app-registry-dispatch", "1");
-  return appsRouter.fetch(new Request(request, { headers }));
-};
-
-server.all("/api/rivet", (c) => dispatchRegistry(c.req.raw));
-server.all("/api/rivet/*", (c) => dispatchRegistry(c.req.raw));
+server.all("/api/rivet/*", (c) => appsRouter.fetch(c.req.raw));
 server.route("/apps", appsRouter);
 ```
 
@@ -30,7 +22,3 @@ This serves `/:appId/*` relative to the mount. For example,
 `/api/items?q=1`. A bare `/apps/example` request redirects to
 `/apps/example/`.
 
-There is no `createAppsRouter` or router-specific client option in the default
-adapter. `appsRouter` creates and reuses its private control client lazily. Once
-an active artifact is prepared, warm requests use only the local runtime and
-isolate caches: they do not call release storage or a Rivet actor.

examples/apps-ai-builder/fixtures/app/package.json

@@ -8,7 +8,12 @@
 		"build": "tsc",
 		"check-types": "tsc --noEmit"
 	},
+	"dependencies": {
+		"@hono/node-server": "2.0.11",
+		"hono": "4.12.9"
+	},
 	"devDependencies": {
+		"@types/node": "22.19.15",
 		"typescript": "5.7.3"
 	}
 }

examples/apps-ai-builder/fixtures/app/src/index.ts

@@ -1,8 +1,15 @@
-export default {
-	fetch(request: Request) {
-		return Response.json({
-			message: "Replace this seed with the generated application.",
-			path: new URL(request.url).pathname,
-		});
-	},
-};
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+
+const app = new Hono();
+
+app.get("/", (context) =>
+	context.json({
+		message: "Replace this seed with the generated application.",
+	}),
+);
+
+serve({
+	fetch: app.fetch,
+	port: Number(process.env.PORT ?? 3000),
+});

examples/apps-ai-builder/package.json

@@ -4,7 +4,7 @@
 	"private": true,
 	"type": "module",
 	"scripts": {
-		"start": "node --import tsx src/server.ts",
+		"start": "npx tsx src/server.ts",
 		"check-types": "tsc --noEmit"
 	},
 	"dependencies": {