@multiplayer-app/agent 0.1.20 → 0.1.22

package/dist/tools/exec-tools.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIVE_PREVIEW_GUIDANCE = void 0;
 exports.createExecTools = createExecTools;
 // Local equivalent of app-vm.tools.ts's runAppCommandTool — a direct child_process.exec
 // against the workspace, no RPC/session bridge (the agent already runs inside the VM).
@@ -11,7 +12,16 @@ const path_1 = __importDefault(require("path"));
 const ai_1 = require("ai");
 const zod_1 = require("zod");
 const tool_call_repair_1 = require("../tool-call-repair");
+const protocol_1 = require("../transport/protocol");
+const app_host_1 = require("../app/app-host");
+const env_1 = require("../app/env");
+const workload_1 = require("../runtime/workload");
+const runner_1 = require("../app/runner");
 const MAX_OUTPUT_BYTES = 1024 * 1024;
+/** How to run an app so the user can open it; shared by every coding prompt and these tools. */
+exports.LIVE_PREVIEW_GUIDANCE = `To give the user a running web app or API, build an ordinary project that the platform detects the way Vercel does. Put every service in its own folder under packages/, even when there is only one, so another can be added beside it later: packages/web for the site or frontend (even a single page: packages/web/index.html), packages/api for the server, packages/<name> for anything else. Any backend, even a single endpoint, is its own service in packages/api: a small server with a start script, never code inside a frontend's folder. Each holds its own source, dependencies and lockfile and installs on its own, with no app or package.json at the workspace root. A script, document or data file that nothing serves needs no package. In a workspace that already has its own layout, keep to that layout. A service is a package.json with a framework (Next.js, Vite, Astro, SvelteKit, Nuxt, Create React App, Express, Fastify, Hono, Koa, NestJS) or with dev/build/start scripts, a Python app (main.py or app.py with FastAPI or Flask, and a requirements.txt), or static files with an index.html (in its folder or its public/). The web service answers at /, the api service at /api (give its routes that prefix, and call them from the frontend as /api/...), and any other at /<name>. Static files and a Vite app work below that name as they are, with relative links; another server gets the whole path, so its routes include /<name>, and any other framework needs its base path set (Next.js's basePath). Only when the user asks for serverless functions, a static site or Vite app can have them in an api/ folder of its own with no server, as on Vercel: packages/web/api/hello.js answers /api/hello, packages/web/api/users/[id].js answers /api/users/:id, each exporting \`default function handler(req, res)\` (with req.query, req.body, res.status, res.json) or a named \`GET\`/\`POST\` taking a Request and returning a Response; files and folders starting with _ are helpers. A server listens on 0.0.0.0 and the port in $PORT. Read configuration and secrets from environment variables and never write their values into a file: the user sets them on the project, a deployment gets them when it is built and when it runs, and this session's VM does not have them, so say which ones the app needs and give it a clear behaviour when one is missing. Building belongs in a build script and migrations in the server's own startup, never in a prestart script or a start script: a deployment builds once, then runs what was built with its start script alone. The platform installs and starts it after your turn and on every boot of the VM, serves it at the session's own URL (opening that URL wakes a stopped VM), and writes ${protocol_1.APP_CONFIG_FILE} with what it detected. That file then alone decides what runs. Never create or edit it unless the user asks to change how the app runs or the app lives where it is not detected; it has \`services\` (each with \`root\`, \`framework\`, \`installCommand\`, \`devCommand\`, \`buildCommand\`, \`startCommand\`, \`outputDirectory\`, or \`functions: { directory, path }\`), \`rewrites\` that send a path to a service (\`{ "source": "/api/(.*)", "destination": { "service": "api" } }\`, first match first) and \`daemons\`. Never start the app yourself in the background; call run_app instead to start it now, to restart it after installing packages, or to see why it fails. For a one-off process that is not the app, run it in the background with its output in a file, e.g. \`node worker.js > worker.log 2>&1 &\` (a bare \`nohup … &\` keeps the call open until it times out); any port works except 8080, 2222 and 8022, and every listening port gets a live preview URL of its own.`;
+/** How long run_app waits for every service to listen or fail. */
+const RUN_APP_WAIT_MS = 60000;
 /** Output kept in the conversation per stream; every later step re-sends it, so the rest belongs in a file. */
 const MAX_INLINE_OUTPUT_CHARS = 8000;
 const DEFAULT_TIMEOUT_MS = 60000;
@@ -28,7 +38,7 @@ function truncate(text) {
 }
 function createExecTools(workspaceDir) {
     const runCommandTool = (0, ai_1.tool)({
-        description: "Run a shell command inside the session's workspace (npm install, build steps, starting a dev server). Returns exit code and captured output. For a long-lived process (a dev server), background it (e.g. `nohup npm run dev &`) so this call returns promptly — the live preview picks it up once it's listening on $PORT.",
+        description: `Run a shell command inside the session's workspace (npm install, build steps, starting a dev server). Returns exit code and captured output. Commands run as an unprivileged user: install dependencies inside the project (npm install, a Python venv), since system packages and global installs aren't available. ${exports.LIVE_PREVIEW_GUIDANCE}`,
         inputSchema: zod_1.z.object({
             // The chat shows this line instead of the command: users read what is being done, not shell syntax.
             description: zod_1.z
@@ -45,7 +55,17 @@ function createExecTools(workspaceDir) {
             const startedAt = Date.now();
             return new Promise((resolve) => {
                 var _a;
-                const child = (0, child_process_1.exec)(input.command, { cwd, timeout: (_a = input.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT_MS, maxBuffer: MAX_OUTPUT_BYTES * 2 }, (error, stdout, stderr) => {
+                const child = (0, child_process_1.exec)(input.command, {
+                    cwd,
+                    // As the unprivileged user, with what the session's app gets: none of the agent's own
+                    // settings, so no model keys, FilingRamp credentials or VM token in a command the model wrote.
+                    // $PORT for commands: the guest's own $PORT (8080) is the hook and preview server
+                    // (runtime/preview-proxy.ts), so an app started on it would fail to bind.
+                    ...(0, workload_1.workloadIdentity)(),
+                    env: (0, workload_1.workloadEnv)({ ...(0, env_1.sessionAppEnv)(process.env), PORT: String(protocol_1.DEFAULT_APP_PORT) }),
+                    timeout: (_a = input.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT_MS,
+                    maxBuffer: MAX_OUTPUT_BYTES * 2,
+                }, (error, stdout, stderr) => {
                     const durationMs = Date.now() - startedAt;
                     const timedOut = Boolean((error === null || error === void 0 ? void 0 : error.killed) && error.signal === 'SIGTERM');
                     const out = truncate(stdout);
@@ -68,6 +88,29 @@ function createExecTools(workspaceDir) {
             });
         },
     });
-    return { run_command: runCommandTool };
+    const runAppTool = (0, ai_1.tool)({
+        description: `Start (or restart) the workspace's app as the platform detects it, with any overrides in ${protocol_1.APP_CONFIG_FILE}: installs its dependencies, then runs its dev server (a static site is served as it is). Waits up to a minute for it to listen or fail, and returns the detected framework, its status and the end of the log of anything that failed. ${exports.LIVE_PREVIEW_GUIDANCE}`,
+        inputSchema: zod_1.z.object({}),
+        execute: async () => {
+            var _a, _b;
+            const app = (0, app_host_1.appHostFor)(workspaceDir, () => ({ dir: workspaceDir, mode: 'dev', env: (0, env_1.sessionAppEnv)(process.env), schemaUrl: process.env[protocol_1.AGENT_ENV.APP_SCHEMA_URL] }));
+            const noApp = {
+                error: 'No app found in the workspace: add a package.json with a framework or a dev/start script, a Python app (main.py or app.py with FastAPI or Flask), or an index.html.',
+            };
+            if (!(await app.start()))
+                return noApp;
+            const status = await app.settled(RUN_APP_WAIT_MS);
+            if (!status)
+                return noApp;
+            const failedLogs = status.processes.filter((process) => process.state === 'crashed' && process.log).map((process) => process.log);
+            // An install or build failure names its log in the error.
+            const stepLog = (_b = /see (\S+\.log)$/.exec((_a = status.error) !== null && _a !== void 0 ? _a : '')) === null || _b === void 0 ? void 0 : _b[1];
+            const logs = {};
+            for (const log of stepLog ? [stepLog, ...failedLogs] : failedLogs)
+                logs[log] = await (0, runner_1.logTail)(workspaceDir, log);
+            return { ...status, ...(Object.keys(logs).length ? { logs } : {}) };
+        },
+    });
+    return { run_command: runCommandTool, run_app: runAppTool };
 }
 //# sourceMappingURL=exec-tools.js.map

package/dist/tools/exec-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec-tools.js","sourceRoot":"","sources":["../../src/tools/exec-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exec-tools.js","sourceRoot":"","sources":["../../src/tools/exec-tools.ts"],"names":[],"mappings":";;;;;;AAkCA,0CA8EC;AAhHD,wFAAwF;AACxF,uFAAuF;AACvF,iDAAoC;AACpC,gDAAuB;AACvB,2BAAyB;AACzB,6BAAuB;AACvB,0DAAyD;AACzD,oDAAoF;AACpF,8CAA4C;AAC5C,oCAA0C;AAC1C,kDAAmE;AACnE,0CAAuC;AAEvC,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAA;AACpC,gGAAgG;AACnF,QAAA,qBAAqB,GAChC,0pFAA0pF,0BAAe,88BAA88B,CAAA;AACznH,kEAAkE;AAClE,MAAM,eAAe,GAAG,KAAM,CAAA;AAC9B,+GAA+G;AAC/G,MAAM,uBAAuB,GAAG,IAAK,CAAA;AACrC,MAAM,kBAAkB,GAAG,KAAM,CAAA;AAEjC,wFAAwF;AACxF,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,IAAI,CAAC,MAAM,IAAI,uBAAuB;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7E,MAAM,IAAI,GAAG,uBAAuB,GAAG,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,uBAAuB,CAAA;IACrD,OAAO;QACL,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,CAAC,cAAc,EAAE,iEAAiE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE;QAC/I,SAAS,EAAE,IAAI;KAChB,CAAA;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,YAAoB;IAClD,MAAM,cAAc,GAAG,IAAA,SAAI,EAAC;QAC1B,WAAW,EACT,wTAAwT,6BAAqB,EAAE;QACjV,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,oGAAoG;YACpG,WAAW,EAAE,OAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,kJAAkJ,CAAC;YAC/J,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAM,CAAC,CAAC,QAAQ,CAAC,6GAA6G,CAAC;YAC9J,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACpF,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAC3G,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAA;YAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;;gBAC7B,MAAM,KAAK,GAAG,IAAA,oBAAI,EAChB,KAAK,CAAC,OAAO,EACb;oBACE,GAAG;oBACH,sFAAsF;oBACtF,+FAA+F;oBAC/F,kFAAkF;oBAClF,0EAA0E;oBAC1E,GAAG,IAAA,2BAAgB,GAAE;oBACrB,GAAG,EAAE,IAAA,sBAAW,EAAC,EAAE,GAAG,IAAA,mBAAa,EAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,2BAAgB,CAAC,EAAE,CAAC;oBACnF,OAAO,EAAE,MAAA,KAAK,CAAC,SAAS,mCAAI,kBAAkB;oBAC9C,SAAS,EAAE,gBAAgB,GAAG,CAAC;iBAChC,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBACxB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;oBACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,KAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;oBACrE,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;oBAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;oBAC5B,OAAO,CAAC;wBACN,QAAQ,EAAE,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC9E,MAAM,EAAE,GAAG,CAAC,IAAI;wBAChB,MAAM,EAAE,GAAG,CAAC,IAAI;wBAChB,UAAU;wBACV,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;wBACzC,QAAQ;wBACR,yFAAyF;wBACzF,wFAAwF;wBACxF,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,sCAAmB;4BAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,gGAAgG,EAAE;4BAC5G,CAAC,CAAC,EAAE,CAAC;qBACR,CAAC,CAAA;gBACJ,CAAC,CACF,CAAA;gBACD,KAAK,KAAK,CAAA;YACZ,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;IAEF,MAAM,UAAU,GAAG,IAAA,SAAI,EAAC;QACtB,WAAW,EAAE,4FAA4F,0BAAe,2OAA2O,6BAAqB,EAAE;QAC1X,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,IAAI,EAAE;;YAClB,MAAM,GAAG,GAAG,IAAA,qBAAU,EAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAA,mBAAa,EAAC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAS,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAA;YACnK,MAAM,KAAK,GAAG;gBACZ,KAAK,EAAE,qKAAqK;aAC7K,CAAA;YACD,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;gBAAE,OAAO,KAAK,CAAA;YACtC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;YACjD,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAA;YACzB,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAI,CAAC,CAAA;YAClI,0DAA0D;YAC1D,MAAM,OAAO,GAAG,MAAA,iBAAiB,CAAC,IAAI,CAAC,MAAA,MAAM,CAAC,KAAK,mCAAI,EAAE,CAAC,0CAAG,CAAC,CAAC,CAAA;YAC/D,MAAM,IAAI,GAA2B,EAAE,CAAA;YACvC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,IAAA,gBAAO,EAAC,YAAY,EAAE,GAAG,CAAC,CAAA;YAC/G,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QACrE,CAAC;KACF,CAAC,CAAA;IAEF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAC7D,CAAC"}

package/dist/tools/exec-tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exec-tools.test.d.ts.map

package/dist/tools/exec-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-tools.test.d.ts","sourceRoot":"","sources":["../../src/tools/exec-tools.test.ts"],"names":[],"mappings":""}

package/dist/tools/exec-tools.test.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = require("node:fs");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const protocol_1 = require("../transport/protocol");
+const exec_tools_1 = require("./exec-tools");
+const AGENT_SETTINGS = [...Object.values(protocol_1.AGENT_ENV), 'AGENT_SSH_PUBLIC_KEYS_B64'];
+(0, node_test_1.describe)('a command the model runs', () => {
+    const saved = { ...process.env };
+    let dir;
+    (0, node_test_1.beforeEach)(async () => {
+        dir = await node_fs_1.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'exec-tools-'));
+        for (const name of AGENT_SETTINGS)
+            process.env[name] = `secret-of-${name}`;
+        process.env.MY_SETTING = 'kept';
+    });
+    (0, node_test_1.afterEach)(async () => {
+        process.env = { ...saved };
+        await node_fs_1.promises.rm(dir, { recursive: true, force: true });
+    });
+    const environment = async () => {
+        const run = (0, exec_tools_1.createExecTools)(dir).run_command.execute;
+        strict_1.default.ok(run);
+        const result = (await run({ description: 'List the environment', command: 'env' }, { toolCallId: 't', messages: [] }));
+        return result.stdout;
+    };
+    (0, node_test_1.it)('sees no model key, credential or VM token, though the runtime keeps them', async () => {
+        const output = await environment();
+        const names = output.split('\n').map((line) => line.split('=')[0]);
+        for (const name of AGENT_SETTINGS)
+            strict_1.default.ok(!names.includes(name), `${name} reached the command`);
+        strict_1.default.doesNotMatch(output, /secret-of-/);
+        strict_1.default.equal(process.env[protocol_1.AGENT_ENV.ACCESS_TOKEN], `secret-of-${protocol_1.AGENT_ENV.ACCESS_TOKEN}`);
+    });
+    (0, node_test_1.it)('still has what any command needs, and the port an app should bind', async () => {
+        const lines = (await environment()).split('\n');
+        strict_1.default.ok(lines.some((line) => line.startsWith('PATH=')));
+        strict_1.default.ok(lines.includes('MY_SETTING=kept'));
+        strict_1.default.ok(lines.includes(`PORT=${protocol_1.DEFAULT_APP_PORT}`));
+    });
+});
+//# sourceMappingURL=exec-tools.test.js.map

package/dist/tools/exec-tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-tools.test.js","sourceRoot":"","sources":["../../src/tools/exec-tools.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/fs-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-tools.d.ts","sourceRoot":"","sources":["../../src/tools/fs-tools.ts"],"names":[],"mappings":"AAmBA,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM;;;;;;;;;kBAiBf,MAAM;mBAAS,MAAM;;;;;;;;;;;;;;;;;;;EAmDvD"}
+{"version":3,"file":"fs-tools.d.ts","sourceRoot":"","sources":["../../src/tools/fs-tools.ts"],"names":[],"mappings":"AAoBA,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM;;;;;;;;;kBAiBf,MAAM;mBAAS,MAAM;;;;;;;;;;;;;;;;;;;EAkDvD"}

package/dist/tools/fs-tools.js

@@ -11,12 +11,13 @@ const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const ai_1 = require("ai");
 const zod_1 = require("zod");
+const workload_1 = require("../runtime/workload");
 /** Resolves a workspace-relative path, rejecting anything that would escape workspaceDir (../, absolute paths). */
 function resolveWorkspacePath(workspaceDir, relativePath) {
     const normalized = path_1.default.normalize(relativePath).replace(/^(\.\.(\/|\\|$))+/, '');
     const resolved = path_1.default.resolve(workspaceDir, normalized);
     const workspaceRoot = path_1.default.resolve(workspaceDir);
-    if (resolved !== workspaceRoot && !resolved.startsWith(`${workspaceRoot}${path_1.default.sep}`)) {
+    if (!(0, workload_1.isInsideDir)(workspaceRoot, resolved)) {
         throw new Error(`path "${relativePath}" escapes the workspace directory`);
     }
     return resolved;
@@ -38,9 +39,8 @@ function createFsTools(workspaceDir) {
             const written = [];
             for (const file of input.files) {
                 const target = resolveWorkspacePath(workspaceDir, file.path);
-                await fs_1.promises.mkdir(path_1.default.dirname(target), { recursive: true });
                 const buffer = Buffer.from(file.content, file.encoding === 'base64' ? 'base64' : 'utf8');
-                await fs_1.promises.writeFile(target, buffer);
+                await (0, workload_1.writeWorkloadFile)(target, buffer);
                 written.push({ path: file.path, bytes: buffer.byteLength });
             }
             return { written };
@@ -54,7 +54,7 @@ function createFsTools(workspaceDir) {
         }),
         execute: async (input) => {
             const target = resolveWorkspacePath(workspaceDir, input.path);
-            const buffer = await fs_1.promises.readFile(target);
+            const buffer = await (0, workload_1.readInside)(workspaceDir, target);
             return { content: buffer.toString(input.encoding === 'base64' ? 'base64' : 'utf8'), bytes: buffer.byteLength };
         },
     });
@@ -68,7 +68,7 @@ function createFsTools(workspaceDir) {
             const target = resolveWorkspacePath(workspaceDir, (_a = input.path) !== null && _a !== void 0 ? _a : '.');
             let entries;
             try {
-                entries = await fs_1.promises.readdir(target, { withFileTypes: true });
+                entries = await fs_1.promises.readdir(await (0, workload_1.realDirInside)(workspaceDir, target), { withFileTypes: true });
             }
             catch (error) {
                 if (error.code === 'ENOENT')

package/dist/tools/fs-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-tools.js","sourceRoot":"","sources":["../../src/tools/fs-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs-tools.js","sourceRoot":"","sources":["../../src/tools/fs-tools.ts"],"names":[],"mappings":"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"}

package/dist/transport/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/transport/link.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,EAAE,IAAI,QAAQ,EAAe,MAAM,kBAAkB,CAAA;AAE9D,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAA;AAMnB,MAAM,MAAM,aAAa,GAAG,iBAAiB,SAAS,MAAM,CAAC,GACzD,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/D,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,WAAW,CAAC,GAC1C,KAAK,GACL,KAAK,CAAA;AAET,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEnF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAChC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,2FAA2F;IAC3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAMD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,OAAO,QAAmB,GAClC,WAAW,CA0Fb"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/transport/link.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,EAAE,IAAI,QAAQ,EAAe,MAAM,kBAAkB,CAAA;AAE9D,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAA;AAMnB,MAAM,MAAM,aAAa,GAAG,iBAAiB,SAAS,MAAM,CAAC,GACzD,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/D,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,WAAW,CAAC,GAC1C,KAAK,GACL,KAAK,CAAA;AAET,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEnF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAChC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,2FAA2F;IAC3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAMD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,OAAO,QAAmB,GAClC,WAAW,CAkGb"}

package/dist/transport/link.js

@@ -61,11 +61,17 @@ function createSessionLink(sessionId, socketUrl, socketToken, connect = socket_i
     // `ready` tells the platform this guest is live. It is sent once at startup, but the socket may
     // be down then (ready() also resolves on a connect error) or drop later and reconnect — a
     // fresh connection must re-announce it, or the platform keeps waiting. A new seq each time, so
-    // the api's per-event de-duplication doesn't swallow the re-announcement.
+    // the api's per-event de-duplication doesn't swallow the re-announcement. The latest `ports`
+    // is re-announced after it the same way: the platform drops a session's ports with its VM state.
+    // So is the latest `app` status, which routes the session URL.
     let readyEvent;
+    let portsEvent;
+    let appEvent;
     socket.on('connect', () => {
-        if (readyEvent)
-            socket.emit(protocol_1.AGENT_SESSION_EVENT, stamp(sessionId, instanceId, ++seq, readyEvent));
+        for (const event of [readyEvent, portsEvent, appEvent]) {
+            if (event)
+                socket.emit(protocol_1.AGENT_SESSION_EVENT, stamp(sessionId, instanceId, ++seq, event));
+        }
     });
     socket.on('connect_error', (error) => console.error('[link] connect error:', error.message));
     socket.on('disconnect', (reason) => console.warn('[link] disconnected:', reason));
@@ -85,8 +91,13 @@ function createSessionLink(sessionId, socketUrl, socketToken, connect = socket_i
     });
     return {
         send(event) {
-            if (event.type === 'ready') {
-                readyEvent = event;
+            if (event.type === 'ready' || event.type === 'ports' || event.type === 'app') {
+                if (event.type === 'ready')
+                    readyEvent = event;
+                else if (event.type === 'ports')
+                    portsEvent = event;
+                else
+                    appEvent = event;
                 if (!socket.connected)
                     return; // The next 'connect' announces it.
             }

package/dist/transport/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/transport/link.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/transport/link.ts"],"names":[],"mappings":"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"}

package/dist/transport/link.test.js

@@ -60,4 +60,28 @@ const READY = { type: 'ready', mode: 'session', profile: 'research', restored: f
     link.send({ type: 'text_delta', messageId: 'm', text: 'hi' });
     strict_1.default.deepEqual(sent.map((event) => event.type), ['ready', 'text_delta']);
 });
+(0, node_test_1.it)('re-announces the latest app status after ready, for the session URL', () => {
+    const { socket, sent, connect } = fakeSocket();
+    const link = (0, link_1.createSessionLink)('session-1', 'https://gw.example/v0/gapi/agent-sessions/ws', 'mp_tok_x', connect);
+    link.send(READY);
+    link.send({ type: 'app', app: { phase: 'installing', processes: [] } });
+    link.send({ type: 'app', app: { phase: 'running', processes: [] } });
+    socket.connectNow();
+    socket.drop();
+    socket.connectNow();
+    strict_1.default.deepEqual(sent.map((event) => event.type), ['ready', 'app', 'ready', 'app']);
+    strict_1.default.equal(sent[3].app.phase, 'running');
+});
+(0, node_test_1.it)('re-announces only the latest ports after ready on every reconnect', () => {
+    const { socket, sent, connect } = fakeSocket();
+    const link = (0, link_1.createSessionLink)('session-1', 'https://gw.example/v0/gapi/agent-sessions/ws', 'mp_tok_x', connect);
+    link.send(READY);
+    link.send({ type: 'ports', ports: [3000] });
+    link.send({ type: 'ports', ports: [3000, 5173] });
+    socket.connectNow();
+    socket.drop();
+    socket.connectNow();
+    strict_1.default.deepEqual(sent.map((event) => event.type), ['ready', 'ports', 'ready', 'ports']);
+    strict_1.default.deepEqual(sent[3].ports, [3000, 5173]);
+});
 //# sourceMappingURL=link.test.js.map

package/dist/transport/link.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.test.js","sourceRoot":"","sources":["../../src/transport/link.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"link.test.js","sourceRoot":"","sources":["../../src/transport/link.test.ts"],"names":[],"mappings":"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"}

package/dist/transport/protocol.d.ts

@@ -32,12 +32,17 @@ export interface AgentSessionFile {
     content: string;
 }
 export type AgentSessionCommand = 
-/** A new user turn. `messageId` is the chat message id the platform already persisted. */
+/**
+ * A new user turn. `messageId` is the chat message id the platform already persisted. `profile`
+ * is the kind of work it is — deep research, or building apps and code; without one the turn
+ * continues the previous turn's (an answer to its question, a "continue").
+ */
 {
     type: 'message';
     messageId: string;
     text: string;
     attachments?: AgentSessionAttachment[];
+    profile?: 'research' | 'coding';
 }
 /** Stop the running turn (the user pressed stop, or the session is being shut down). */
  | {
@@ -49,6 +54,22 @@ export type AgentSessionCommand =
     requestId?: string;
     waitForTurn?: boolean;
     onlyIfIdleForMs?: number;
+}
+/**
+ * Workspace live sync: the session's copy of `path` is now `content` (people edited it, or the
+ * guest's change was built on an older version), which the guest merges into its file. Without
+ * `content`, the session took the guest's own version `hash` as-is.
+ */
+ | {
+    type: 'file_state';
+    path: string;
+    hash: string;
+    content?: string;
+}
+/** Someone deleted `path` in the session. */
+ | {
+    type: 'file_delete';
+    path: string;
 };
 export interface AgentSessionCommandAck {
     ok: boolean;
@@ -117,12 +138,58 @@ export type AgentSessionEvent = BaseEvent & (
     messageId: string;
     usage: AgentUsage;
 }
-/** Text files to store as session artifacts. */
+/** Text files to store as session artifacts (guests without workspace live sync). */
  | {
     type: 'files';
     messageId?: string;
     files: AgentSessionFile[];
 }
+/**
+ * Workspace live sync (src/workspace-sync): a workspace text file changed. `base` is the
+ * workspaceFileHash of the session's version this content was built on — absent when the
+ * guest has none (a new file, or any file right after a restart). `final` ends a draft: the
+ * content replaces the drafted text as-is.
+ */
+ | {
+    type: 'file_changed';
+    path: string;
+    content: string;
+    base?: string;
+    final?: boolean;
+} | {
+    type: 'file_deleted';
+    path: string;
+}
+/** What the model has written so far of a file it is still writing: shown live, not yet on disk. */
+ | {
+    type: 'file_draft';
+    path: string;
+    content: string;
+}
+/** The guest wrote the session's version `hash` of `path` (a file_state) to disk unchanged. */
+ | {
+    type: 'file_synced';
+    path: string;
+    hash: string;
+}
+/**
+ * Every TCP port something in the guest listens on, ascending (minus the guest's own
+ * GUEST_RESERVED_PORTS). Sent on startup, on every change and after a reconnect; the
+ * platform offers each one as a live preview.
+ */
+ | {
+    type: 'ports';
+    ports: number[];
+}
+/**
+ * The workspace's app (detected, with builder.json's overrides), as the guest runs it
+ * (src/app): sent on every change and after a reconnect; null once no app runs. Its URL
+ * routes through it.
+ */
+ | {
+    type: 'app';
+    app: AgentAppStatus | null;
+}
 /** Conversation + workspace persisted (project Git commit or session snapshot). */
  | {
     type: 'checkpointed';
@@ -150,11 +217,152 @@ export type AgentSessionEvent = BaseEvent & (
 export type AgentSessionEventType = AgentSessionEvent['type'];
 export declare function agentSessionEventKey(event: AgentSessionEvent): string;
 export declare const AGENT_SESSION_EVENT_TYPES: readonly AgentSessionEventType[];
+export declare const PREVIEW_PORT_HEADER: "x-builder-preview-port";
+/**
+ * On what the gateway asks the api about a session's URL. A browser can't set it on a navigation, so
+ * a link to the api's route for that never runs a session's page on the api's own origin.
+ */
+export declare const SESSION_SITE_HEADER: "x-builder-session-site";
+/**
+ * Whether a URL path holds a dotfile or dot-folder at any depth (.env, .git, the platform's own
+ * .builder), or a `.`/`..` segment. An app's URL never serves one from its files; .well-known is
+ * the exception.
+ */
+/**
+ * A request's target as a URL, to read its path and query. Anyone can send any target, and
+ * `new URL(target, base)` throws on `//` and reads `//host/path` as a host: this does neither,
+ * so leading slashes collapse as most servers treat them.
+ */
+export declare function requestUrl(target: string | undefined): URL;
+export declare function isHiddenSitePath(pathname: string): boolean;
+/** The guest's own listeners: the hook/preview server, dropbear, and Lambda's shell agent. */
+export declare const GUEST_RESERVED_PORTS: readonly number[];
+/**
+ * The port apps are told to listen on ($PORT for the agent's commands). A session's own URL
+ * (<sessionId>.apps.<domain>) opens this one when it listens, else the lowest port that does.
+ */
+export declare const DEFAULT_APP_PORT = 3000;
+/**
+ * PREVIEW_PORT_HEADER's value for a session's own URL (no port in it): the guest picks the target
+ * itself, by the app's rewrites when the workspace holds one, else DEFAULT_APP_PORT or the
+ * lowest listening port. Never parsed from a hostname.
+ */
+export declare const APP_PREVIEW_TARGET: "app";
+/** A header value as a previewable port, or undefined. */
+export declare function parsePreviewPort(value: unknown): number | undefined;
+/** A PREVIEW_PORT_HEADER value: a previewable port, APP_PREVIEW_TARGET, or undefined. */
+export declare function parsePreviewTarget(value: unknown): number | typeof APP_PREVIEW_TARGET | undefined;
+/** The port a session's own URL opens without an app: DEFAULT_APP_PORT when it listens, else the lowest. */
+export declare function defaultAppPort(ports: readonly number[]): number | undefined;
+/**
+ * The app manifest, in the workspace's .builder folder; a session VM
+ * writes it. The one file of .builder that people see and edit as a session file.
+ */
+export declare const APP_CONFIG_FILE: ".builder/builder.json";
+/** Which of a session's stored files are executable: object storage keeps no mode. */
+/**
+ * Where a session's conversation used to be saved, in its workspace and so in its branch. It's kept
+ * in the runtime's state directory now (persistence/conversation-store.ts), but repos still hold old
+ * copies: they stay off main when a session merges, and out of what a new session starts from.
+ */
+export declare const SESSION_CONVERSATION_FILE = ".builder/conversation.json";
+export declare const WORKSPACE_EXECUTABLES_FILE: ".builder/executables.json";
+/** Dependencies and build output: saved with a workspace, but not files people open. */
+export declare const WORKSPACE_GENERATED_DIRECTORIES: readonly string[];
+/** Guest-only: a deployment's app status as JSON. `/internal/*` is never routed publicly. */
+export declare const APP_STATUS_PATH: "/internal/app/status";
+/** Asked of a build VM's APP_STATUS_PATH to get the end of its latest log too. */
+export declare const APP_STATUS_WITH_LOG: "log=1";
+/** What a running build has logged, on a build VM: `?cursor=` for what came after that. Answers AgentBuildLog. */
+export declare const APP_BUILD_LOG_PATH: "/internal/app/build-log";
+/** How much of each step's log a person gets: its end, where a failure is. The web app uses builder-types' copy. */
+export declare const BUILD_LOG_BYTES: number;
+/** How much of its latest log a release's record keeps, in case its VM dies before uploading them. */
+export declare const BUILD_LOG_TAIL_BYTES: number;
+/** The longest cursor the API accepts. readBuildLogs keeps every cursor it makes under this. */
+export declare const MAX_BUILD_LOG_CURSOR_CHARS = 8192;
+/** A build's logs in the order they ran: installing comes before any service's build, whatever it's called. */
+export declare function compareBuildLogs(a: string, b: string): number;
+/** A built release's record of what it holds; written last, so a release that has one is complete. */
+export declare const RELEASE_MANIFEST_FILE: "manifest.json";
+/** The compressed copies of a built release's static files, best first. */
+export declare const SITE_ENCODINGS: readonly ["br", "gzip"];
+export type SiteEncoding = (typeof SITE_ENCODINGS)[number];
+/** What a built release's VM runs: its folders as they were built, dependencies and all. */
+export declare const RELEASE_ARCHIVE_FILE: "run.tar.zst";
+/** How far a release's build has got, on a build VM's APP_STATUS_PATH as `{ build }`. */
+export type AgentBuildPhase = 'fetching' | 'installing' | 'building' | 'uploading' | 'done' | 'failed';
+export interface BuildLogChunk {
+    /** The step's log file, such as install.log. */
+    name: string;
+    text: string;
+}
+/** What a running build logged since the cursor it was asked with. */
+export interface AgentBuildLog {
+    logs: BuildLogChunk[];
+    /** Hand this back to get what comes after. Means nothing to anyone else. */
+    cursor: string;
+    /** There's more ready now: no need to wait before asking again. */
+    more: boolean;
+}
+export interface AgentBuildStatus {
+    phase: AgentBuildPhase;
+    /** Why it failed. */
+    error?: string;
+    /** The end of the latest log: of the one that failed, or of the step running when asked for it. */
+    log?: string;
+    /** What the finished release answers with: files from storage, processes on a VM, or some of each. */
+    serves?: 'files' | 'processes' | 'both';
+}
+/** Where the app is: installing and building come before its processes start. */
+export type AgentAppPhase = 'installing' | 'building' | 'starting' | 'running' | 'failed';
+export interface AgentAppProcess {
+    name: string;
+    kind: 'service' | 'daemon';
+    /** A static service is served by the guest itself and always 'running'. */
+    state: 'starting' | 'running' | 'crashed' | 'stopped';
+    port?: number;
+    restarts: number;
+    exitCode?: number | null;
+    signal?: string | null;
+    /** Workspace-relative log file. */
+    log?: string;
+}
+export interface AgentAppStatus {
+    phase: AgentAppPhase;
+    /** Why the app can't run: an invalid builder.json, or the install or build that failed. */
+    error?: string;
+    processes: AgentAppProcess[];
+    /** The framework it runs as (a Vercel slug); null for none: a package's own scripts, static files. */
+    framework?: string | null;
+    /** Whether builder.json said how it runs, or it was only detected. */
+    source?: 'detected' | 'builder.json';
+}
+/** How both sides of workspace live sync name a version of a file. */
+export declare function workspaceFileHash(content: string): string;
 export declare function isAgentSessionEvent(value: unknown): value is AgentSessionEvent;
 export declare const AGENT_ENV: {
     readonly SESSION_ID: "SESSION_ID";
-    /** 'task' (one AGENT_TASK run, then exit) or 'session' (stay up, serve chat turns). */
+    /**
+     * 'task' (one AGENT_TASK run, then exit), 'session' (stay up, serve chat turns), 'app' (a
+     * deployment: run the release's app on GUEST_HTTP_PORT, no agent) or 'build' (build a release
+     * and upload its output, no agent).
+     */
     readonly AGENT_MODE: "AGENT_MODE";
+    /** 'build' mode: where the release's output goes (the git service's route for that release). */
+    readonly RELEASE_UPLOAD_URL: "RELEASE_UPLOAD_URL";
+    /** secret, 'build' mode: may write only that release's output. */
+    readonly RELEASE_UPLOAD_TOKEN: "RELEASE_UPLOAD_TOKEN";
+    /** 'app' mode: a release built ahead of time: where the files its VM runs are, read with ACCESS_TOKEN. */
+    readonly RELEASE_ARTIFACTS_URL: "RELEASE_ARTIFACTS_URL";
+    /** 'app' mode: the release being run, so a VM restarted on its own disk skips install and build. */
+    readonly APP_RELEASE_ID: "APP_RELEASE_ID";
+    /** 'app' and build modes: the app's directory in the release's repository. */
+    readonly APP_ROOT_DIR: "APP_ROOT_DIR";
+    /** 'app' and build modes: the commit to check out. */
+    readonly GIT_COMMIT: "GIT_COMMIT";
+    /** The JSON schema the builder.json a session VM writes names as its `$schema`; written down, never fetched. */
+    readonly APP_SCHEMA_URL: "APP_SCHEMA_URL";
     /** 'coding' (default) or 'research'. */
     readonly AGENT_PROFILE: "AGENT_PROFILE";
     readonly AGENT_TASK: "AGENT_TASK";
@@ -164,6 +372,8 @@ export declare const AGENT_ENV: {
     /** Total tokens the session may spend before it pauses and asks whether to continue. */
     readonly AGENT_TOKEN_BUDGET: "AGENT_TOKEN_BUDGET";
     readonly AGENT_WORKSPACE_DIR: "AGENT_WORKSPACE_DIR";
+    /** The runtime's own files (its conversation, its git data), which nothing it runs can read. */
+    readonly AGENT_STATE_DIR: "AGENT_STATE_DIR";
     /** The gateway's agent socket; the guest authenticates to it with ACCESS_TOKEN (session-scoped). */
     readonly AGENT_SOCKET_URL: "AGENT_SOCKET_URL";
     /** secret: model provider keys (one of them) */
@@ -194,6 +404,8 @@ export declare const AGENT_ENV: {
      */
     readonly ACCESS_TOKEN: "ACCESS_TOKEN";
 };
+/** The settings that deliver a release to its VM; the rest of a deployed VM's env is the app's own. */
+export declare const RELEASE_DELIVERY_ENV: readonly string[];
 export declare const AGENT_SECRET_ENV_KEYS: readonly string[];
 export {};
 //# sourceMappingURL=protocol.d.ts.map