import { mkdtemp, mkdir, readFile, rm, writeFile } from "node:fs/promises"; import { tmpdir } from "node:os"; import path from "node:path"; import { describe, expect, it } from "vitest"; import { computeDaytonaImageContentId, DAYTONA_IMAGE_DOCKERFILE_PATH, DAYTONA_IMAGE_INPUT_PATHS, extractDaytonaBaseImages, extractDaytonaDockerfileFrontendDigest, } from "./daytona-image-content.js"; const repositoryRoot = path.resolve(import.meta.dirname, "../.."); describe("runner E2E Daytona image contract", () => { it("builds runnerd and the provider pack and verifies every required transport", async () => { const [dockerfile, dockerignore, workflow] = await Promise.all([ readFile( path.join(repositoryRoot, "docker/daytona-runner/Dockerfile"), "utf8", ), readFile(path.join(repositoryRoot, ".dockerignore"), "utf8"), readFile( path.join( repositoryRoot, ".github/workflows/runner-full-stack-e2e.yml", ), "utf8", ), ]); expect(dockerfile).toContain("--bin paperclip-runnerd"); expect(dockerfile).toContain("build-provider-pack.mjs /provider-pack"); expect(dockerfile).toContain( "/opt/paperclip-runner/provider-pack/provider-pack.json", ); expect(dockerfile).toContain( "${PAPERCLIP_RUNNER_PROVIDER_PACK_ROOT}/node_modules/.bin", ); for (const command of ["acpx", "claude-agent-acp", "codex-acp"]) { expect(dockerfile).toContain(command); } for (const transport of ["dial_ws_loopback", "dial_wss", "listen_ws"]) { expect(dockerfile).toContain(transport); } expect(dockerfile).toContain( 'metadata="$(paperclip-runnerd --build-metadata)"', ); expect(dockerfile).toContain("provider-pack.json"); expect(dockerfile).toContain("io.paperclip.runner.content-id"); expect(dockerfile).toContain("org.opencontainers.image.revision"); expect(extractDaytonaDockerfileFrontendDigest(dockerfile)).toBe( "sha256:a57df69d0ea827fb7266491f2813635de6f17269be881f696fbfdf2d83dda33e", ); expect(extractDaytonaBaseImages(dockerfile)).toEqual([ "rust:1.97-bookworm@sha256:408fe88047cef61a2087653b0c5255fa51c0f2d6d94ddedd7a2562a9b91a46f6", "node:24-bookworm@sha256:9137a20e25879e0b557227b57e3ee4e9af4bde29eb3db66134cd1723e84f830b", "daytonaio/sandbox:0.8.0@sha256:eadf88e4391072b7ad4bed27d9cadfc9fe9d8ed375d9219d34c2ccb518f213e3", ]); expect(dockerignore).toContain("**/node_modules"); expect(dockerignore).toContain("packages/paperclip-runner/dist"); expect(dockerignore).toContain("packages/paperclip-runner/runner/target"); expect(workflow).toContain("--platform linux/amd64"); expect(workflow).toContain( "Compute Daytona image content ID with pinned bases", ); expect(workflow).toContain( "e2e-content-${{ needs.catalog.outputs.daytona_image_content_id }}", ); expect(workflow).toContain( '--build-arg "PAPERCLIP_RUNNER_CONTENT_ID=${IMAGE_CONTENT_ID}"', ); expect(workflow).not.toContain("e2e-git-${{ github.sha }}"); expect(workflow).toContain("cosign sign --yes"); expect(workflow).toContain("docker image inspect"); expect(workflow).toContain('.Config.User == "daytona"'); expect(workflow).toContain("PAPERCLIP_RUNNER_PROVIDER_PACK_ROOT="); expect(workflow).toContain( "pnpm --filter @paperclipai/paperclip-runner build:provider-pack", ); expect(workflow).toContain( "PAPERCLIP_RUNNER_REMOTE_PROVIDER_PACK_PATH: ${{ github.workspace }}/packages/paperclip-runner/provider-pack", ); expect(workflow).toContain( "PAPERCLIP_RUNNER_SOURCE_REVISION: ${{ needs.daytona_image.outputs.source_revision }}", ); expect(workflow).toContain("anonymous_config"); }); it("hashes the audited image dependency closure rather than the repository revision", async () => { for (const requiredPath of [ ".dockerignore", "docker/daytona-runner/Dockerfile", "pnpm-lock.yaml", "patches", "packages/paperclip-eval-kernel", "packages/paperclip-runner", ]) { expect(DAYTONA_IMAGE_INPUT_PATHS).toContain(requiredPath); } expect(DAYTONA_IMAGE_DOCKERFILE_PATH).toBe( "docker/daytona-runner/Dockerfile", ); const contentId = await computeDaytonaImageContentId(); expect(contentId).toMatch(/^[0-9a-f]{64}$/); }); it("changes only when an image input, frontend, base, or platform changes", async () => { const root = await mkdtemp( path.join(tmpdir(), "paperclip-daytona-image-id-"), ); try { await mkdir(path.join(root, "image-input")); await writeFile( path.join(root, "image-input", "runner.ts"), "version one\n", ); const baseline = await computeDaytonaImageContentId({ repositoryRoot: root, inputPaths: ["image-input"], baseImages: [`example.test/base:1@sha256:${"a".repeat(64)}`], frontendDigest: `sha256:${"c".repeat(64)}`, }); expect( await computeDaytonaImageContentId({ repositoryRoot: root, inputPaths: ["image-input"], baseImages: [`example.test/base:1@sha256:${"b".repeat(64)}`], frontendDigest: `sha256:${"c".repeat(64)}`, }), ).not.toBe(baseline); expect( await computeDaytonaImageContentId({ repositoryRoot: root, inputPaths: ["image-input"], baseImages: [`example.test/base:1@sha256:${"a".repeat(64)}`], frontendDigest: `sha256:${"d".repeat(64)}`, }), ).not.toBe(baseline); await writeFile( path.join(root, "unrelated.txt"), "does not enter the image\n", ); expect( await computeDaytonaImageContentId({ repositoryRoot: root, inputPaths: ["image-input"], baseImages: [`example.test/base:1@sha256:${"a".repeat(64)}`], frontendDigest: `sha256:${"c".repeat(64)}`, }), ).toBe(baseline); await writeFile( path.join(root, "image-input", "runner.ts"), "version two\n", ); expect( await computeDaytonaImageContentId({ repositoryRoot: root, inputPaths: ["image-input"], baseImages: [`example.test/base:1@sha256:${"a".repeat(64)}`], frontendDigest: `sha256:${"c".repeat(64)}`, }), ).not.toBe(baseline); expect( await computeDaytonaImageContentId({ repositoryRoot: root, inputPaths: ["image-input"], platform: "linux/arm64", baseImages: [`example.test/base:1@sha256:${"a".repeat(64)}`], frontendDigest: `sha256:${"c".repeat(64)}`, }), ).not.toBe(baseline); } finally { await rm(root, { recursive: true, force: true }); } }); it("rejects mutable Docker base references", () => { expect(() => extractDaytonaBaseImages("FROM node:24-bookworm\n")).toThrow( "must use an immutable sha256 digest", ); }); it("rejects a mutable or missing Dockerfile syntax frontend", async () => { expect(() => extractDaytonaDockerfileFrontendDigest( "# syntax=docker/dockerfile:1.7\nFROM scratch\n", ), ).toThrow("must pin its syntax frontend"); expect(() => extractDaytonaDockerfileFrontendDigest("FROM scratch\n"), ).toThrow("must pin its syntax frontend"); await expect( computeDaytonaImageContentId({ inputPaths: [], baseImages: [`example.test/base:1@sha256:${"a".repeat(64)}`], frontendDigest: "sha256:mutable", }), ).rejects.toThrow("must use an immutable sha256 digest"); }); });