@multiplayer-app/agent 0.1.19 → 0.1.21

package/dist/runtime/index.d.ts

@@ -1,12 +1,17 @@
-import { type AgentRuntimeConfig } from './config';
-import { type SessionAgent } from '../session';
+import type { SessionAgent } from '../session';
+import type { AgentRuntimeConfig } from './config';
 export interface RunningAgent {
-    config: AgentRuntimeConfig;
+    /** Absent in app mode, which runs no agent. */
+    config?: AgentRuntimeConfig;
     /** Present in session mode only. */
     session?: SessionAgent;
+    /** App mode: a deployment, which stays up serving its app. */
+    app?: boolean;
     close(): Promise<void>;
 }
 /** A lifecycle request can race startup; never acknowledge a freeze before restore finishes. */
 export declare function checkpointBeforeFreeze(starting: Promise<RunningAgent> | undefined, reason: string): Promise<void>;
 export declare function startAgent(env?: NodeJS.ProcessEnv): Promise<RunningAgent>;
+/** Loads what this image runs ahead of any VM (GUEST_IMAGE, set by its Dockerfile), so that's in its snapshot. */
+export declare function loadImageCode(env?: NodeJS.ProcessEnv): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAIrE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,oCAAoC;IACpC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,gGAAgG;AAChG,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvH;AAED,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B5F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,oCAAoC;IACpC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,gGAAgG;AAChG,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvH;AAED,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB5F;AAED,kHAAkH;AAClH,wBAAsB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF"}

package/dist/runtime/index.js

@@ -1,15 +1,42 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkpointBeforeFreeze = checkpointBeforeFreeze;
 exports.startAgent = startAgent;
-// Mode dispatch shared by both entrypoints (cli.ts for engines that materialize env before
-// start, lambda-microvm.ts for the /run hook): task mode runs once and resolves;
-// session mode stays up and resolves with the running agent so lifecycle hooks can reach it.
-const config_1 = require("./config");
-const link_1 = require("../transport/link");
-const loop_1 = require("../task/loop");
-const reporter_1 = require("../transport/reporter");
-const session_1 = require("../session");
+exports.loadImageCode = loadImageCode;
+const protocol_1 = require("../transport/protocol");
 /** A lifecycle request can race startup; never acknowledge a freeze before restore finishes. */
 async function checkpointBeforeFreeze(starting, reason) {
     var _a;
@@ -19,34 +46,25 @@ async function checkpointBeforeFreeze(starting, reason) {
     await ((_a = agent.session) === null || _a === void 0 ? void 0 : _a.checkpoint(reason));
 }
 async function startAgent(env = process.env) {
-    const config = (0, config_1.loadConfigFromEnv)(env);
-    if (config.mode === 'session') {
-        const link = (0, link_1.createSessionLink)(config.sessionId, config.socketUrl, config.socketToken);
-        const session = await (0, session_1.runSessionAgent)(config, link).catch(async (error) => {
-            link.send({ type: 'error', message: `Workspace restore failed: ${error instanceof Error ? error.message : String(error)}` });
-            await link.close();
-            throw error;
-        });
-        return {
-            config,
-            session,
-            async close() {
-                try {
-                    await session.stop();
-                }
-                finally {
-                    await link.close();
-                }
-            },
-        };
+    // A VM for a session's tools to write files and run commands in: nothing to start, only the guest
+    // to stay up.
+    if (env[protocol_1.AGENT_ENV.AGENT_MODE] === 'workspace')
+        return { app: true, close: async () => undefined };
+    if (env[protocol_1.AGENT_ENV.AGENT_MODE] === 'app') {
+        const { startDeployedApp } = await Promise.resolve().then(() => __importStar(require('./app-mode')));
+        const deployed = await startDeployedApp(env);
+        return { app: true, close: () => deployed.close() };
     }
-    const reporter = (0, reporter_1.createReporter)(config.socketUrl, config.socketToken, config.sessionId);
-    try {
-        await (0, loop_1.runAgentLoop)(config, reporter);
+    if (env[protocol_1.AGENT_ENV.AGENT_MODE] === 'build') {
+        const { startReleaseBuild } = await Promise.resolve().then(() => __importStar(require('./build-mode')));
+        const build = startReleaseBuild(env);
+        return { app: true, close: () => build.close() };
     }
-    finally {
-        await reporter.close();
-    }
-    return { config, async close() { } };
+    const { startSessionOrTask } = await Promise.resolve().then(() => __importStar(require('./session-mode')));
+    return startSessionOrTask(env);
+}
+/** Loads what this image runs ahead of any VM (GUEST_IMAGE, set by its Dockerfile), so that's in its snapshot. */
+async function loadImageCode(env = process.env) {
+    await (env.GUEST_IMAGE === 'app' ? Promise.resolve().then(() => __importStar(require('./app-mode'))) : Promise.resolve().then(() => __importStar(require('./session-mode'))));
 }
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;AAiBA,wDAIC;AAED,gCA6BC;AApDD,2FAA2F;AAC3F,iFAAiF;AACjF,6FAA6F;AAC7F,qCAAqE;AACrE,4CAAqD;AACrD,uCAA2C;AAC3C,oDAAsD;AACtD,wCAA+D;AAS/D,gGAAgG;AACzF,KAAK,UAAU,sBAAsB,CAAC,QAA2C,EAAE,MAAc;;IACtG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAA;IAC5B,MAAM,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,UAAU,CAAC,MAAM,CAAC,CAAA,CAAA;AACzC,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,MAAM,GAAG,IAAA,0BAAiB,EAAC,GAAG,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;QACtF,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAe,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YACjF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;YAC5H,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YAClB,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,OAAO;YACL,MAAM;YACN,OAAO;YACP,KAAK,CAAC,KAAK;gBACT,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;gBACtB,CAAC;wBAAS,CAAC;oBACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;gBACpB,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,yBAAc,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IACvF,IAAI,CAAC;QACH,MAAM,IAAA,mBAAY,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACtC,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,KAAI,CAAC,EAAE,CAAA;AACrC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,wDAIC;AAED,gCAgBC;AAGD,sCAEC;AAzCD,oDAAiD;AAajD,gGAAgG;AACzF,KAAK,UAAU,sBAAsB,CAAC,QAA2C,EAAE,MAAc;;IACtG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAA;IAC5B,MAAM,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,UAAU,CAAC,MAAM,CAAC,CAAA,CAAA;AACzC,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,kGAAkG;IAClG,cAAc;IACd,IAAI,GAAG,CAAC,oBAAS,CAAC,UAAU,CAAC,KAAK,WAAW;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,EAAE,CAAA;IACjG,IAAI,GAAG,CAAC,oBAAS,CAAC,UAAU,CAAC,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,EAAE,gBAAgB,EAAE,GAAG,wDAAa,YAAY,GAAC,CAAA;QACvD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAA;QAC5C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAA;IACrD,CAAC;IACD,IAAI,GAAG,CAAC,oBAAS,CAAC,UAAU,CAAC,KAAK,OAAO,EAAE,CAAC;QAC1C,MAAM,EAAE,iBAAiB,EAAE,GAAG,wDAAa,cAAc,GAAC,CAAA;QAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;QACpC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;IAClD,CAAC;IACD,MAAM,EAAE,kBAAkB,EAAE,GAAG,wDAAa,gBAAgB,GAAC,CAAA;IAC7D,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAED,kHAAkH;AAC3G,KAAK,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,CAAC,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,mDAAQ,YAAY,IAAE,CAAC,mDAAQ,gBAAgB,GAAC,CAAC,CAAA;AACrF,CAAC"}

package/dist/runtime/listening-ports.d.ts

@@ -0,0 +1,13 @@
+/** Listening, loopback-reachable ports in one /proc/net/tcp{,6} table. */
+export declare function parseListeningPorts(table: string): number[];
+/** Every previewable port, ascending. Empty off Linux, where there is no /proc to read. */
+export declare function listListeningPorts(tables?: readonly string[]): Promise<number[]>;
+/**
+ * Calls `onChange` with the current ports once, then whenever they change. Returns the stop.
+ * Polled, not watched: /proc files emit no change events.
+ */
+export declare function watchListeningPorts(onChange: (ports: number[]) => void, options?: {
+    intervalMs?: number;
+    list?: () => Promise<number[]>;
+}): () => void;
+//# sourceMappingURL=listening-ports.d.ts.map

package/dist/runtime/listening-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listening-ports.d.ts","sourceRoot":"","sources":["../../src/runtime/listening-ports.ts"],"names":[],"mappings":"AAoBA,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAW3D;AAED,2FAA2F;AAC3F,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,SAAS,MAAM,EAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOrG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,EACnC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAAO,GACpE,MAAM,IAAI,CAmBZ"}

package/dist/runtime/listening-ports.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseListeningPorts = parseListeningPorts;
+exports.listListeningPorts = listListeningPorts;
+exports.watchListeningPorts = watchListeningPorts;
+// Which ports the live preview can offer: every TCP listener the preview proxy can reach over
+// loopback, read from the kernel's socket tables, so a dev server shows up whether the model
+// started it, a script did, or the user did over SSH.
+const promises_1 = require("fs/promises");
+const protocol_1 = require("../transport/protocol");
+const LISTEN_STATE = '0A';
+const SOCKET_TABLES = ['/proc/net/tcp', '/proc/net/tcp6'];
+const POLL_INTERVAL_MS = 2000;
+/** A /proc/net/tcp{,6} local address the proxy reaches on loopback: any-address or loopback itself. */
+function reachableOverLoopback(addressHex) {
+    if (/^0+$/.test(addressHex))
+        return true; // 0.0.0.0 or ::
+    // IPv4 bytes are stored little-endian, so 127.x.y.z ends in 7F.
+    if (addressHex.length === 8)
+        return addressHex.slice(6).toUpperCase() === '7F';
+    const v6 = addressHex.toUpperCase();
+    return v6 === '00000000000000000000000001000000' // ::1
+        || (v6.startsWith('0000000000000000FFFF0000') && v6.slice(30) === '7F'); // ::ffff:127.x.y.z
+}
+/** Listening, loopback-reachable ports in one /proc/net/tcp{,6} table. */
+function parseListeningPorts(table) {
+    const ports = new Set();
+    for (const line of table.split('\n').slice(1)) {
+        const [, local, , state] = line.trim().split(/\s+/);
+        if (state !== LISTEN_STATE || !local)
+            continue;
+        const [addressHex, portHex] = local.split(':');
+        if (!portHex || !reachableOverLoopback(addressHex))
+            continue;
+        const port = parseInt(portHex, 16);
+        if (port > 0 && !protocol_1.GUEST_RESERVED_PORTS.includes(port))
+            ports.add(port);
+    }
+    return [...ports];
+}
+/** Every previewable port, ascending. Empty off Linux, where there is no /proc to read. */
+async function listListeningPorts(tables = SOCKET_TABLES) {
+    const ports = new Set();
+    for (const table of tables) {
+        const content = await (0, promises_1.readFile)(table, 'utf8').catch(() => '');
+        for (const port of parseListeningPorts(content))
+            ports.add(port);
+    }
+    return [...ports].sort((a, b) => a - b);
+}
+/**
+ * Calls `onChange` with the current ports once, then whenever they change. Returns the stop.
+ * Polled, not watched: /proc files emit no change events.
+ */
+function watchListeningPorts(onChange, options = {}) {
+    var _a, _b;
+    const list = (_a = options.list) !== null && _a !== void 0 ? _a : (() => listListeningPorts());
+    let last;
+    let stopped = false;
+    const scan = async () => {
+        const ports = await list().catch(() => undefined);
+        if (stopped || !ports)
+            return;
+        const key = ports.join(',');
+        if (key === last)
+            return;
+        last = key;
+        onChange(ports);
+    };
+    void scan();
+    const timer = setInterval(() => void scan(), (_b = options.intervalMs) !== null && _b !== void 0 ? _b : POLL_INTERVAL_MS);
+    timer.unref();
+    return () => {
+        stopped = true;
+        clearInterval(timer);
+    };
+}
+//# sourceMappingURL=listening-ports.js.map

package/dist/runtime/listening-ports.js.map

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

package/dist/runtime/listening-ports.test.d.ts

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

package/dist/runtime/listening-ports.test.d.ts.map

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

package/dist/runtime/listening-ports.test.js

@@ -0,0 +1,39 @@
+"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_test_1 = require("node:test");
+const listening_ports_1 = require("./listening-ports");
+const HEADER = '  sl  local_address rem_address   st tx_queue rx_queue tr tm->when retrnsmt   uid  timeout inode';
+(0, node_test_1.it)('lists loopback-reachable listeners and skips connections, other hosts and the guest\'s own ports', () => {
+    const tcp = [
+        HEADER,
+        '   0: 00000000:0BB8 00000000:0000 0A 00000000:00000000 00:00000000 00000000     0        0 1 1', // 0.0.0.0:3000
+        '   1: 0100007F:1435 00000000:0000 0A 00000000:00000000 00:00000000 00000000     0        0 2 1', // 127.0.0.1:5173
+        '   2: 0F02000A:0050 00000000:0000 0A 00000000:00000000 00:00000000 00000000     0        0 3 1', // 10.0.2.15:80
+        '   3: 00000000:1F90 00000000:0000 0A 00000000:00000000 00:00000000 00000000     0        0 4 1', // :8080 (preview proxy)
+        '   4: 0100007F:0BB8 0100007F:D431 01 00000000:00000000 00:00000000 00000000     0        0 5 1', // established
+    ].join('\n');
+    strict_1.default.deepEqual((0, listening_ports_1.parseListeningPorts)(tcp).sort(), [3000, 5173]);
+    const tcp6 = [
+        HEADER,
+        '   0: 00000000000000000000000001000000:22B8 00000000000000000000000000000000:0000 0A 0 0 0 0 0 6 1', // [::1]:8888
+        '   1: 00000000000000000000000000000000:0FA1 00000000000000000000000000000000:0000 0A 0 0 0 0 0 7 1', // [::]:4001
+        '   2: 0000000000000000FFFF00000100007F:0FA2 00000000000000000000000000000000:0000 0A 0 0 0 0 0 8 1', // [::ffff:127.0.0.1]:4002
+    ].join('\n');
+    strict_1.default.deepEqual((0, listening_ports_1.parseListeningPorts)(tcp6).sort(), [4001, 4002, 8888]);
+});
+(0, node_test_1.it)('reports the first scan, then only changes', async () => {
+    const scans = [[3000], [3000], [3000, 5173]];
+    const seen = [];
+    const stop = (0, listening_ports_1.watchListeningPorts)((ports) => seen.push(ports), {
+        intervalMs: 5,
+        list: async () => { var _a; return (_a = scans.shift()) !== null && _a !== void 0 ? _a : [3000, 5173]; },
+    });
+    await new Promise((resolve) => setTimeout(resolve, 40));
+    stop();
+    strict_1.default.deepEqual(seen, [[3000], [3000, 5173]]);
+});
+//# sourceMappingURL=listening-ports.test.js.map

package/dist/runtime/listening-ports.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listening-ports.test.js","sourceRoot":"","sources":["../../src/runtime/listening-ports.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAuC;AACvC,yCAA8B;AAC9B,uDAA4E;AAE5E,MAAM,MAAM,GAAG,kGAAkG,CAAA;AAEjH,IAAA,cAAE,EAAC,kGAAkG,EAAE,GAAG,EAAE;IAC1G,MAAM,GAAG,GAAG;QACV,MAAM;QACN,gGAAgG,EAAE,eAAe;QACjH,gGAAgG,EAAE,iBAAiB;QACnH,gGAAgG,EAAE,eAAe;QACjH,gGAAgG,EAAE,wBAAwB;QAC1H,gGAAgG,EAAE,cAAc;KACjH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,gBAAM,CAAC,SAAS,CAAC,IAAA,qCAAmB,EAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAE/D,MAAM,IAAI,GAAG;QACX,MAAM;QACN,oGAAoG,EAAE,aAAa;QACnH,oGAAoG,EAAE,YAAY;QAClH,oGAAoG,EAAE,0BAA0B;KACjI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,gBAAM,CAAC,SAAS,CAAC,IAAA,qCAAmB,EAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC,CAAC,CAAA;AAEF,IAAA,cAAE,EAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;IACzD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAe,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,IAAA,qCAAmB,EAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAC5D,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,KAAK,IAAI,EAAE,WAAC,OAAA,MAAA,KAAK,CAAC,KAAK,EAAE,mCAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA,EAAA;KAChD,CAAC,CAAA;IACF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IACvD,IAAI,EAAE,CAAA;IACN,gBAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAChD,CAAC,CAAC,CAAA"}

package/dist/runtime/preview-proxy.d.ts

@@ -0,0 +1,56 @@
+import http from 'http';
+import net from 'net';
+import type { Duplex } from 'stream';
+/** Where the guest serves its lifecycle hooks and this proxy. */
+export declare const GUEST_HTTP_PORT = 8080;
+/** A connected socket to whatever listens on loopback `port`. */
+export declare function connectLocal(port: number): Promise<net.Socket>;
+/** The request headers as the app expects them from a browser on the guest itself. */
+export declare function localRequestHeaders(headers: http.IncomingHttpHeaders, port: number): http.OutgoingHttpHeaders;
+/** A redirect to the app's own local address, pointed at the public preview instead. */
+export declare function publicLocation(location: string, port: number, origin: string): string;
+/** The app's side of the guest's port 8080: the router of the workspace's app (src/app). */
+export interface AppRequestHandler {
+    /** False when no app runs, so the request goes to the default port instead. */
+    handleRequest(req: http.IncomingMessage, res: http.ServerResponse): boolean;
+    handleUpgrade(req: http.IncomingMessage, socket: Duplex, head: Buffer): boolean;
+}
+export declare function setAppHandler(handler: AppRequestHandler | undefined): void;
+/**
+ * A deployment (AGENT_MODE=app) is its app: requests without PREVIEW_PORT_HEADER go to it too
+ * (proxyAppRequest), not only a session URL's.
+ */
+export declare function serveAppUnaddressed(): void;
+/**
+ * Forwards a request to whatever listens on loopback `port`, as from a browser on the guest.
+ * `extraHeaders` go on the answer, over any of the same name (the app's builder.json `headers`).
+ */
+export declare function proxyToPort(req: http.IncomingMessage, res: http.ServerResponse, port: number, extraHeaders?: ReadonlyArray<{
+    key: string;
+    value: string;
+}>): void;
+/**
+ * The guest's request handler, made safe: it runs the agent and serves the app, so a throw from one
+ * request, which nothing above would catch, must fail that request and not take all of it down.
+ */
+export declare function guardRequests(handler: http.RequestListener): http.RequestListener;
+/** The same for an upgrade request. */
+export declare function guardUpgrades(handler: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void;
+/** Handles a preview request; false when the request isn't one (no PREVIEW_PORT_HEADER). */
+export declare function proxyPreviewRequest(req: http.IncomingMessage, res: http.ServerResponse): boolean;
+/** In a deployment, any other request is the app's; false elsewhere (or until serveAppUnaddressed). */
+export declare function proxyAppRequest(req: http.IncomingMessage, res: http.ServerResponse): boolean;
+/**
+ * Handles a preview WebSocket upgrade by splicing the two connections together once the
+ * request reaches the app; false when the request isn't one. The app answers the handshake.
+ */
+export declare function proxyPreviewUpgrade(req: http.IncomingMessage, socket: Duplex, head: Buffer): boolean;
+/** Splices an upgrade request through to whatever listens on loopback `port`. */
+export declare function upgradeToPort(req: http.IncomingMessage, socket: Duplex, head: Buffer, port: number): void;
+/**
+ * The preview proxy on its own, for entrypoints with no lifecycle hook server holding
+ * GUEST_HTTP_PORT (cli.ts: QEMU, Firecracker). Anything but a preview (or, in a deployment, the
+ * app) gets a 404.
+ */
+export declare function startPreviewServer(port?: number): http.Server;
+//# sourceMappingURL=preview-proxy.d.ts.map

package/dist/runtime/preview-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-proxy.d.ts","sourceRoot":"","sources":["../../src/runtime/preview-proxy.ts"],"names":[],"mappings":"AAQA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,GAAG,MAAM,KAAK,CAAA;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAIpC,iEAAiE;AACjE,eAAO,MAAM,eAAe,OAAO,CAAA;AAOnC,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAiB9D;AAoBD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAW7G;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrF;AAkBD,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAA;IAC3E,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAChF;AAKD,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAE1E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,GAC/D,IAAI,CAyBN;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAUjF;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,IAC9F,KAAK,IAAI,CAAC,eAAe,EAAE,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,IAAI,CAQvE;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAYhG;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAO5F;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAqBpG;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAUzG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAkB,GAAG,IAAI,CAAC,MAAM,CAatE"}