@multiplayer-app/sandbox 7.0.2 → 7.0.4

package/dist/microvm-guest-agents.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Guest-agent source for each stack's Lambda MicroVM base image, as a set of in-memory files
+ * (zipped and uploaded by microvm-images.ts — no disk/build step needed).
+ *
+ * Kept in sync BY HAND with scripts/base-images/{node,python,static}/build.sh, which the
+ * internal build-base-images.sh pipeline still uses for QEMU/Firecracker/Docker images (those
+ * need a real build host, so unifying the two isn't in scope here) — if you change one, change
+ * the other. The agent itself: an HTTP server on :8080 that answers the Lambda MicroVM
+ * lifecycle hooks (/aws/lambda-microvms/runtime/v1/*) and {"status":"ok"} elsewhere. The /run
+ * hook payload (vmId/sessionId/stack/env from the worker executor) is kept in memory and
+ * echoed back so the control plane can identify the VM.
+ */
+export declare const MICROVM_BASE_IMAGE_STACKS: readonly ["node", "python", "static"];
+export type MicrovmBaseImageStack = (typeof MICROVM_BASE_IMAGE_STACKS)[number];
+export declare function isMicrovmBaseImageStack(stack: string): stack is MicrovmBaseImageStack;
+/** Files to zip for `stack`'s base image, relative paths -> contents. */
+export declare function guestAgentFiles(stack: MicrovmBaseImageStack): Record<string, string>;
+//# sourceMappingURL=microvm-guest-agents.d.ts.map

package/dist/microvm-guest-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microvm-guest-agents.d.ts","sourceRoot":"","sources":["../src/microvm-guest-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,yBAAyB,uCAAwC,CAAA;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,qBAAqB,CAErF;AAoRD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASpF"}

package/dist/microvm-images.d.ts

@@ -0,0 +1,37 @@
+import { type MicrovmBaseImageStack } from './microvm-guest-agents';
+export interface CreateMicrovmImagesOptions {
+    region: string;
+    /** S3 bucket the built code artifact is uploaded to (must already exist). */
+    bucket: string;
+    /** AWS-managed base OS image ARN — discover one with listBaseMicrovmImages(). */
+    baseImageArn: string;
+    /** IAM role ARN the build assumes to read the artifact from `bucket` (needs s3:GetObject). */
+    buildRoleArn: string;
+    /** Stacks to build/register (default: all of MICROVM_BASE_IMAGE_STACKS). */
+    stacks?: MicrovmBaseImageStack[];
+    /** Minimum guest memory, MiB (default: 1024). */
+    minMemoryMib?: number;
+    /** MicroVM image name prefix, "<prefix>-<stack>" (default: 'sandbox'). */
+    imageNamePrefix?: string;
+    /** Image-build poll interval, ms (default: 5000). */
+    pollIntervalMs?: number;
+    /** Image-build poll timeout, ms (default: 600000 = 10 min). */
+    pollTimeoutMs?: number;
+    /** Called after each step so callers (CLI, CI) can report progress. Optional. */
+    onProgress?: (message: string) => void;
+}
+export interface CreateMicrovmImagesResult {
+    /** stack -> the image ARN that's now active, ready to use as MICROVM_STACK_IMAGE_ARNS. */
+    stackArns: Record<string, string>;
+}
+/** AWS-managed base OS images available as a `baseImageArn` candidate in this region. */
+export declare function listBaseMicrovmImages(options: {
+    region: string;
+}): Promise<string[]>;
+/**
+ * Builds and registers/updates the guest-agent base images for `options.stacks`, in the
+ * caller's own AWS account. Returns the stack -> image ARN map once every image's new version
+ * has finished building (polled).
+ */
+export declare function createMicrovmImages(options: CreateMicrovmImagesOptions): Promise<CreateMicrovmImagesResult>;
+//# sourceMappingURL=microvm-images.d.ts.map

package/dist/microvm-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microvm-images.d.ts","sourceRoot":"","sources":["../src/microvm-images.ts"],"names":[],"mappings":"AAuBA,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAA;IACpB,8FAA8F;IAC9F,YAAY,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAA;IAChC,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iFAAiF;IACjF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAqCD,yFAAyF;AACzF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAI1F;AAyCD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CA+EpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplayer-app/sandbox",
-  "version": "7.0.2",
+  "version": "7.0.4",
   "description": "Sandbox worker library and CLI (Docker, QEMU, Firecracker, AWS Lambda MicroVM, Fargate)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,6 +26,7 @@
     "@aws-sdk/client-ecs": "^3.1087.0",
     "@aws-sdk/client-lambda-microvms": "^3.1079.0",
     "@aws-sdk/client-s3": "^3.1079.0",
+    "archiver": "^8.0.0",
     "bunyan": "1.8.15",
     "commander": "^14.0.0",
     "dotenv": "^17.2.3",
@@ -34,6 +35,7 @@
     "ws": "^8.18.3"
   },
   "devDependencies": {
+    "@types/archiver": "^8.0.0",
     "@types/node": "^25.8.0",
     "@types/ws": "^8.18.1",
     "esbuild": "^0.25.12",
@@ -51,8 +53,6 @@
     "images:build": "bash scripts/build-base-images.sh",
     "images:publish:local": "bash scripts/publish-base-images-local.sh",
     "images:upload:local": "SKIP_BUILD=1 bash scripts/publish-base-images-local.sh",
-    "images:microvm:create": "node scripts/create-microvm-images.mjs",
-    "images:microvm:list-base-images": "node scripts/create-microvm-images.mjs --list-base-images",
     "docker:build": "docker build -f Dockerfile -t multiplayer-sandbox-worker:local ../..",
     "start": "node dist/cli.js",
     "worker:start": "node dist/cli.js start",