Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Watch sandbox helpers during development.

debajyoti-truefoundrya16ae77ef6df
diff --git a/README.md b/README.md
index db51bb50c..17f1d89eb 100644
--- a/README.md
+++ b/README.md
@@ -40,12 +40,12 @@ Open `http://localhost:3000`. Frontend changes update through Vite HMR; server c
The workspace utils package is ESM so the host server and source schemas share one ESM dependency graph. `NODE_OPTIONS=--conditions=development` selects `src/` at runtime, and TypeScript uses the same condition for source-based static analysis. Development, lint, typecheck, tests, OpenAPI generation, and migrations do not read or recreate `packages/harness/dist`; release builds, package checks, and Docker smoke tests create it intentionally.
-Server dev scripts regenerate the embedded sandbox Python helpers before startup. This writes a generated TypeScript source module and does not build `dist`.
+Server dev scripts regenerate the embedded sandbox Python helpers before startup. Root `pnpm dev` also watches those Python files, regenerates the TypeScript source module after edits, and lets the server watcher restart normally. Neither path builds `dist`.
| Script | Runs |
| ------------------- | ---------------------------------------------------------------------------------- |
| `pnpm dev:infra` | Postgres + Redis in the foreground |
-| `pnpm dev` | Server (`tsx watch`) + Vite |
+| `pnpm dev` | Sandbox helper generator + server (`tsx watch`) + Vite |
| `pnpm dev:no-watch` | Same, but API without hot reload (`NODE_ENV=production`) so Ctrl+C exercises drain |
| `pnpm clean` | Workspace build outputs and the ESLint cache |
| `pnpm clean:all` | The same outputs plus all workspace `node_modules` directories |
diff --git a/package.json b/package.json
index d4d16e898..8458289df 100644
--- a/package.json
+++ b/package.json
@@ -14,7 +14,7 @@
"format:fix": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\" --cache --config .prettierrc",
"test": "pnpm --filter @truefoundry/utils test && pnpm --filter @truefoundry/server test && pnpm --filter frontend test",
"test:store:local": "bash scripts/test-store-local.sh",
- "dev": "pnpm --parallel --filter @truefoundry/server --filter frontend dev",
+ "dev": "pnpm --parallel --filter @truefoundry/utils --filter @truefoundry/server --filter frontend dev",
"dev:no-watch": "pnpm --parallel --filter @truefoundry/server --filter frontend dev:no-watch",
"dev:infra": "docker compose -f docker-compose.dev.yml up",
"dev:server": "pnpm --filter @truefoundry/server dev",
diff --git a/packages/harness/package.json b/packages/harness/package.json
index 93e87488e..01416eb3a 100644
--- a/packages/harness/package.json
+++ b/packages/harness/package.json
@@ -71,6 +71,8 @@
"scripts": {
"build": "pnpm run build:gen && tsc --noEmit && pnpm run build:js && pnpm run build:dts && pnpm run build:pkg && pnpm run build:check",
"build:gen": "node scripts/generate-sandbox-scripts.mjs",
+ "build:gen:watch": "node --watch-path=src/core/sandbox/scripts scripts/generate-sandbox-scripts.mjs",
+ "dev": "pnpm run build:gen:watch",
"build:js": "tsup",
"build:dts": "tsc -p tsconfig.build.json --emitDeclarationOnly",
"build:pkg": "node scripts/make-dist-package-json.mjs",