@multiplayer-app/sandbox 0.0.37 → 2.0.0-wip-yjs-state-changes.0

package/dist/executor/fargate-executor.js

@@ -0,0 +1,293 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FargateExecutor = void 0;
+exports.fargateResources = fargateResources;
+const http_1 = __importDefault(require("http"));
+const client_ecs_1 = require("@aws-sdk/client-ecs");
+const logger_1 = __importDefault(require("@multiplayer-app/logger"));
+// Valid Fargate cpu (units) → [min, max] task memory (MiB).
+const FARGATE_MEM_RANGES = {
+    256: [512, 2048],
+    512: [1024, 4096],
+    1024: [2048, 8192],
+    2048: [4096, 16384],
+    4096: [8192, 30720],
+};
+/** Snap requested VM resources to a valid Fargate cpu/memory combination. */
+function fargateResources(vcpuCount, memMib) {
+    const cpu = Math.min(4096, Math.max(256, vcpuCount * 1024));
+    const [min, max] = FARGATE_MEM_RANGES[cpu];
+    let memory = Math.min(max, Math.max(min, memMib));
+    // Above 512 MiB, Fargate only accepts 1 GiB increments
+    if (memory > 512)
+        memory = Math.ceil(memory / 1024) * 1024;
+    return { cpu: String(cpu), memory: String(Math.min(max, memory)) };
+}
+/**
+ * Runs VMs as AWS Fargate tasks (one task per VM). No VNC or serial console and no
+ * pause/resume — HTTP(S) into the container only, via the task's IP on the guest port.
+ * Slower to start than Lambda MicroVMs (image pull + task provisioning), but supports
+ * arbitrary container images via standard ECS task definitions.
+ */
+class FargateExecutor {
+    constructor(config) {
+        this.config = config;
+        this.vms = new Map();
+        this.containerNames = new Map();
+        this.client = new client_ecs_1.ECSClient(config.region ? { region: config.region } : {});
+    }
+    /** First container of the task definition — the target for env overrides. Cached per definition. */
+    async resolveContainerName(taskDefinition) {
+        var _a, _b, _c;
+        const cached = this.containerNames.get(taskDefinition);
+        if (cached)
+            return cached;
+        const described = await this.client.send(new client_ecs_1.DescribeTaskDefinitionCommand({ taskDefinition }));
+        const name = (_c = (_b = (_a = described.taskDefinition) === null || _a === void 0 ? void 0 : _a.containerDefinitions) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.name;
+        if (!name)
+            throw new Error(`task definition ${taskDefinition} has no containers`);
+        this.containerNames.set(taskDefinition, name);
+        return name;
+    }
+    async waitForRunning(taskArn) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const timeoutMs = (_a = this.config.startTimeoutMs) !== null && _a !== void 0 ? _a : 180000;
+        const deadline = Date.now() + timeoutMs;
+        for (;;) {
+            const described = await this.client.send(new client_ecs_1.DescribeTasksCommand({ cluster: this.config.cluster, tasks: [taskArn] }));
+            const task = (_b = described.tasks) === null || _b === void 0 ? void 0 : _b[0];
+            if (!task)
+                throw new Error(`task ${taskArn} not found`);
+            if (task.lastStatus === 'STOPPED') {
+                throw new Error(`fargate task stopped: ${(_c = task.stoppedReason) !== null && _c !== void 0 ? _c : 'unknown reason'}`);
+            }
+            if (task.lastStatus === 'RUNNING') {
+                const ip = this.config.assignPublicIp
+                    ? await this.resolvePublicIp(task.attachments)
+                    : (_g = (_f = (_e = (_d = task.containers) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.networkInterfaces) === null || _f === void 0 ? void 0 : _f[0]) === null || _g === void 0 ? void 0 : _g.privateIpv4Address;
+                if (!ip)
+                    throw new Error(`fargate task ${taskArn} is RUNNING but has no ${this.config.assignPublicIp ? 'public' : 'private'} IP`);
+                return ip;
+            }
+            if (Date.now() > deadline) {
+                throw new Error(`fargate task did not reach RUNNING within ${timeoutMs}ms (last status: ${task.lastStatus})`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+        }
+    }
+    async resolvePublicIp(attachments) {
+        var _a, _b, _c, _d, _e, _f;
+        const eniId = (_c = (_b = (_a = attachments === null || attachments === void 0 ? void 0 : attachments.find((a) => a.type === 'ElasticNetworkInterface')) === null || _a === void 0 ? void 0 : _a.details) === null || _b === void 0 ? void 0 : _b.find((d) => d.name === 'networkInterfaceId')) === null || _c === void 0 ? void 0 : _c.value;
+        if (!eniId)
+            return undefined;
+        const { EC2Client, DescribeNetworkInterfacesCommand } = await Promise.resolve().then(() => __importStar(require('@aws-sdk/client-ec2')));
+        const ec2 = new EC2Client(this.config.region ? { region: this.config.region } : {});
+        const described = await ec2.send(new DescribeNetworkInterfacesCommand({ NetworkInterfaceIds: [eniId] }));
+        return (_f = (_e = (_d = described.NetworkInterfaces) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.Association) === null || _f === void 0 ? void 0 : _f.PublicIp;
+    }
+    async create(spec) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const taskDefinition = (_b = (_a = this.config.stackTaskDefinitions) === null || _a === void 0 ? void 0 : _a[spec.stack]) !== null && _b !== void 0 ? _b : this.config.taskDefinition;
+        if (!taskDefinition) {
+            throw new Error(`no Fargate task definition configured for stack "${spec.stack}"`);
+        }
+        const containerName = await this.resolveContainerName(taskDefinition);
+        const { cpu, memory } = fargateResources(spec.resources.vcpuCount, spec.resources.memMib);
+        const run = await this.client.send(new client_ecs_1.RunTaskCommand({
+            cluster: this.config.cluster,
+            taskDefinition,
+            launchType: 'FARGATE',
+            count: 1,
+            networkConfiguration: {
+                awsvpcConfiguration: {
+                    subnets: this.config.subnets,
+                    securityGroups: this.config.securityGroups,
+                    assignPublicIp: this.config.assignPublicIp ? 'ENABLED' : 'DISABLED',
+                },
+            },
+            overrides: {
+                cpu,
+                memory,
+                containerOverrides: [
+                    {
+                        name: containerName,
+                        environment: [
+                            { name: 'VM_ID', value: spec.vmId },
+                            ...(spec.sessionId ? [{ name: 'SESSION_ID', value: spec.sessionId }] : []),
+                            { name: 'STACK', value: spec.stack },
+                            // Release artifact: the container agent pulls, unzips, and starts it
+                            ...(spec.appUrl ? [{ name: 'APP_URL', value: spec.appUrl }] : []),
+                        ],
+                    },
+                ],
+            },
+            tags: [
+                { key: 'vmId', value: spec.vmId },
+                ...(spec.sessionId ? [{ key: 'sessionId', value: spec.sessionId }] : []),
+            ],
+        }));
+        const taskArn = (_d = (_c = run.tasks) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.taskArn;
+        if (!taskArn) {
+            throw new Error(`RunTask failed: ${(_g = (_f = (_e = run.failures) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.reason) !== null && _g !== void 0 ? _g : 'no task returned'}`);
+        }
+        logger_1.default.info({ vmId: spec.vmId, taskArn, taskDefinition, cpu, memory }, 'fargate task started');
+        try {
+            const ip = await this.waitForRunning(taskArn);
+            const handle = {
+                vmId: spec.vmId,
+                sessionId: spec.sessionId,
+                stack: spec.stack,
+                resources: spec.resources,
+                running: true,
+                metadata: { taskArn, ip },
+            };
+            this.vms.set(spec.vmId, { handle, taskArn, ip });
+            logger_1.default.info({ vmId: spec.vmId, ip }, 'fargate task running');
+            return handle;
+        }
+        catch (error) {
+            await this.client
+                .send(new client_ecs_1.StopTaskCommand({ cluster: this.config.cluster, task: taskArn, reason: 'startup failed' }))
+                .catch(() => { });
+            throw error;
+        }
+    }
+    async pause(vmId) {
+        throw new Error(`fargate tasks cannot be paused (vm ${vmId})`);
+    }
+    async resume(vmId) {
+        throw new Error(`fargate tasks cannot be resumed (vm ${vmId})`);
+    }
+    async restore(vmId) {
+        throw new Error(`fargate tasks cannot be restored (vm ${vmId})`);
+    }
+    async stop(vmId) {
+        const vm = this.mustGet(vmId);
+        await this.client.send(new client_ecs_1.StopTaskCommand({ cluster: this.config.cluster, task: vm.taskArn, reason: 'stopped via API' }));
+        vm.handle.running = false;
+        return vm.handle;
+    }
+    async destroy(vmId) {
+        const vm = this.vms.get(vmId);
+        if (!vm)
+            return;
+        await this.client
+            .send(new client_ecs_1.StopTaskCommand({ cluster: this.config.cluster, task: vm.taskArn, reason: 'destroyed via API' }))
+            .catch((error) => logger_1.default.warn({ vmId, err: error }, 'fargate stop on destroy failed'));
+        this.vms.delete(vmId);
+    }
+    get(vmId) {
+        var _a;
+        return (_a = this.vms.get(vmId)) === null || _a === void 0 ? void 0 : _a.handle;
+    }
+    list() {
+        return [...this.vms.values()].map((vm) => vm.handle);
+    }
+    async proxyHttp(vmId, request) {
+        const vm = this.mustGet(vmId);
+        if (!vm.handle.running)
+            throw new Error(`vm ${vmId} is not running`);
+        return new Promise((resolve, reject) => {
+            var _a;
+            const req = http_1.default.request({
+                host: vm.ip,
+                port: (_a = this.config.guestPort) !== null && _a !== void 0 ? _a : 8080,
+                method: request.method,
+                path: request.path,
+                headers: request.headers,
+            }, (res) => {
+                const chunks = [];
+                res.on('data', (c) => chunks.push(c));
+                res.on('end', () => {
+                    var _a;
+                    return resolve({
+                        statusCode: (_a = res.statusCode) !== null && _a !== void 0 ? _a : 502,
+                        headers: Object.fromEntries(Object.entries(res.headers).map(([k, v]) => [k, Array.isArray(v) ? v.join(', ') : (v !== null && v !== void 0 ? v : '')])),
+                        body: Buffer.concat(chunks),
+                    });
+                });
+            });
+            req.on('error', reject);
+            if (request.body)
+                req.write(request.body);
+            req.end();
+        });
+    }
+    /**
+     * Recover a Fargate task after a worker restart. The task is an independent AWS resource
+     * that outlives this process — just re-describe it by ARN and, if it's still RUNNING,
+     * rebuild the local handle.
+     */
+    async reattach(record) {
+        var _a, _b, _c, _d, _e;
+        const meta = record.runtimeMetadata;
+        if (!(meta === null || meta === void 0 ? void 0 : meta.taskArn))
+            return undefined;
+        const described = await this.client
+            .send(new client_ecs_1.DescribeTasksCommand({ cluster: this.config.cluster, tasks: [meta.taskArn] }))
+            .catch(() => undefined);
+        const task = (_a = described === null || described === void 0 ? void 0 : described.tasks) === null || _a === void 0 ? void 0 : _a[0];
+        if (!task || task.lastStatus !== 'RUNNING')
+            return undefined;
+        const ip = this.config.assignPublicIp
+            ? await this.resolvePublicIp(task.attachments)
+            : (_e = (_d = (_c = (_b = task.containers) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.networkInterfaces) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.privateIpv4Address;
+        if (!ip)
+            return undefined;
+        const handle = {
+            vmId: record.vmId,
+            sessionId: record.sessionId,
+            stack: record.stack,
+            resources: record.resources,
+            running: true,
+            metadata: { taskArn: meta.taskArn, ip },
+        };
+        this.vms.set(record.vmId, { handle, taskArn: meta.taskArn, ip });
+        logger_1.default.info({ vmId: record.vmId, taskArn: meta.taskArn, ip }, 'fargate task reattached');
+        return handle;
+    }
+    mustGet(vmId) {
+        const vm = this.vms.get(vmId);
+        if (!vm)
+            throw new Error(`vm ${vmId} not found`);
+        return vm;
+    }
+}
+exports.FargateExecutor = FargateExecutor;
+//# sourceMappingURL=fargate-executor.js.map

package/dist/executor/fargate-executor.js.map

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

package/dist/executor/firecracker-executor.d.ts

@@ -0,0 +1,45 @@
+import type { ProxyRequestDescriptor, ProxyResponseDescriptor, VmRecord } from '@multiplayer-app/builder-types';
+import type { Executor, SerialSource, VmHandle, VmSpec } from './types';
+export interface FirecrackerConfig {
+    bin?: string;
+    /** Root of per-stack base images: <imagesDir>/<stack>/{vmlinuz,initramfs.img}. */
+    imagesDir?: string;
+    /** Explicit single-image override (vmlinux/bzImage + cpio.gz); used for every stack when both are set. */
+    kernelPath?: string;
+    initrdPath?: string;
+    vmDataPath?: string;
+}
+export declare class FirecrackerExecutor implements Executor {
+    private readonly config;
+    private readonly vms;
+    private readonly usedSubnets;
+    private tapCounter;
+    private readonly bin;
+    private readonly vmDataPath;
+    private networkReady;
+    constructor(config: FirecrackerConfig);
+    private allocateSubnet;
+    private ensureNetworking;
+    /** Explicit kernel/initrd override wins; otherwise the stack's base image, falling back to generic. */
+    private resolveImages;
+    create(spec: VmSpec): Promise<VmHandle>;
+    pause(vmId: string): Promise<VmHandle>;
+    resume(vmId: string): Promise<VmHandle>;
+    stop(vmId: string): Promise<VmHandle>;
+    restore(vmId: string): Promise<VmHandle>;
+    destroy(vmId: string): Promise<void>;
+    get(vmId: string): VmHandle | undefined;
+    getSerialSource(vmId: string): SerialSource | undefined;
+    list(): VmHandle[];
+    /**
+     * Recover a Firecracker VM after a worker restart: the process may well have survived, so
+     * probe its API socket — if it answers, lifecycle control and HTTP proxying resume
+     * normally. There's no live ChildProcess to reattach to, so destroy() falls back to
+     * killing the stored pid, and the serial console is unavailable (see getSerialSource).
+     */
+    reattach(record: VmRecord): Promise<VmHandle | undefined>;
+    proxyHttp(vmId: string, request: ProxyRequestDescriptor): Promise<ProxyResponseDescriptor>;
+    private patchVmState;
+    private setRunning;
+}
+//# sourceMappingURL=firecracker-executor.d.ts.map

package/dist/executor/firecracker-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firecracker-executor.d.ts","sourceRoot":"","sources":["../../src/executor/firecracker-executor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAE/G,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAKvE,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAeD,qBAAa,mBAAoB,YAAW,QAAQ;IAQtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,YAAY,CAAQ;gBAEC,MAAM,EAAE,iBAAiB;IAKtD,OAAO,CAAC,cAAc;YAWR,gBAAgB;IAY9B,uGAAuG;IACvG,OAAO,CAAC,aAAa;IAaf,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqFvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IASvD,IAAI,IAAI,QAAQ,EAAE;IAIlB;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAyCzD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;YAiClF,YAAY;IAM1B,OAAO,CAAC,UAAU;CAMnB"}