@alwaysmeticulous/cli 2.278.0 → 2.280.0

package/dist/commands/agent/screenshot-image-files.command.js

@@ -1,17 +1,42 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="eddc9a2a-df30-52e9-9a53-256bfdbd3541")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9277f775-c52a-556c-99d0-389c4257c25c")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.imageFilesCommand = void 0;
 const promises_1 = require("fs/promises");
-const os_1 = require("os");
 const path_1 = require("path");
 const client_1 = require("@alwaysmeticulous/client");
 const common_1 = require("@alwaysmeticulous/common");
 const downloading_helpers_1 = require("@alwaysmeticulous/downloading-helpers");
 const sentry_utils_1 = require("../../command-utils/sentry.utils");
-const downloadImageToTmpDir = async (tmpDir, label, url) => {
-    const filePath = (0, path_1.join)(tmpDir, `${label}.png`);
+const AGENT_IMAGES_SUBDIR = "agent-images";
+const MAX_AGE_MS = 24 * 60 * 60 * 1000;
+const getAgentImagesDir = () => (0, path_1.join)((0, common_1.getMeticulousLocalDataDir)(), AGENT_IMAGES_SUBDIR);
+const cleanupOldImages = async (dir) => {
+    const logger = (0, common_1.initLogger)();
+    let entries;
+    try {
+        entries = await (0, promises_1.readdir)(dir);
+    }
+    catch {
+        return;
+    }
+    const cutoff = Date.now() - MAX_AGE_MS;
+    await Promise.all(entries.map(async (entry) => {
+        const entryPath = (0, path_1.join)(dir, entry);
+        try {
+            const stats = await (0, promises_1.stat)(entryPath);
+            if (stats.isFile() && stats.mtimeMs < cutoff) {
+                await (0, promises_1.unlink)(entryPath);
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to inspect/remove ${entryPath}: ${error}`);
+        }
+    }));
+};
+const downloadImage = async (dir, fileName, url) => {
+    const filePath = (0, path_1.join)(dir, fileName);
     await (0, downloading_helpers_1.downloadFile)(url, filePath);
     return filePath;
 };
@@ -19,8 +44,9 @@ const handler = async ({ apiToken, replayDiffId, screenshotName, }) => {
     (0, common_1.initLogger)();
     const client = (0, client_1.createClient)({ apiToken });
     const urls = await (0, client_1.getScreenshotUrls)(client, replayDiffId, screenshotName);
-    const tmpDir = (0, path_1.join)((0, os_1.tmpdir)(), "meticulous-screenshots", `${replayDiffId}_${screenshotName}`);
-    await (0, promises_1.mkdir)(tmpDir, { recursive: true });
+    const dir = getAgentImagesDir();
+    await (0, promises_1.mkdir)(dir, { recursive: true });
+    await cleanupOldImages(dir);
     console.log(`outcome: ${urls.outcome}`);
     const downloads = [];
     if (urls.screenshot) {
@@ -35,14 +61,16 @@ const handler = async ({ apiToken, replayDiffId, screenshotName, }) => {
     if (urls.diffImage) {
         downloads.push({ label: "diffImage", url: urls.diffImage });
     }
-    const results = await Promise.all(downloads.map(({ label, url }) => downloadImageToTmpDir(tmpDir, label, url)));
+    const timestamp = Date.now();
+    const prefix = `${timestamp}_${replayDiffId}_${screenshotName}`;
+    const results = await Promise.all(downloads.map(({ label, url }) => downloadImage(dir, `${prefix}_${label}.png`, url)));
     for (let i = 0; i < downloads.length; i++) {
         console.log(`${downloads[i].label}: ${results[i]}`);
     }
 };
 exports.imageFilesCommand = {
     command: "image-files",
-    describe: "Download screenshot images for a replay diff screenshot to local tmp files",
+    describe: "Download screenshot images for a replay diff screenshot to local files under ~/.meticulous/agent-images",
     builder: {
         apiToken: { string: true, description: "Meticulous API token" },
         replayDiffId: {
@@ -59,4 +87,4 @@ exports.imageFilesCommand = {
     handler: (0, sentry_utils_1.wrapHandler)(handler),
 };
 //# sourceMappingURL=screenshot-image-files.command.js.map
-//# debugId=eddc9a2a-df30-52e9-9a53-256bfdbd3541
+//# debugId=9277f775-c52a-556c-99d0-389c4257c25c

package/dist/commands/agent/screenshot-image-files.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot-image-files.command.js","sources":["../../../src/commands/agent/screenshot-image-files.command.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAA,0CAAoC;AACpC,2BAA4B;AAC5B,+BAA4B;AAC5B,qDAA2E;AAC3E,qDAAsD;AACtD,+EAAqE;AAErE,mEAA+D;AAQ/D,MAAM,qBAAqB,GAAG,KAAK,EACjC,MAAc,EACd,KAAa,EACb,GAAW,EACM,EAAE;IACnB,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAA,kCAAY,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,KAAK,EAAE,EACrB,QAAQ,EACR,YAAY,EACZ,cAAc,GACN,EAAiB,EAAE;IAC3B,IAAA,mBAAU,GAAE,CAAC;IACb,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,MAAM,IAAA,0BAAiB,EAAC,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,IAAA,WAAI,EACjB,IAAA,WAAM,GAAE,EACR,wBAAwB,EACxB,GAAG,YAAY,IAAI,cAAc,EAAE,CACpC,CAAC;IACF,MAAM,IAAA,gBAAK,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAExC,MAAM,SAAS,GAA0C,EAAE,CAAC;IAC5D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAC/B,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAC1C,CACF,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC;AAEW,QAAA,iBAAiB,GAAoC;IAChE,OAAO,EAAE,aAAa;IACtB,QAAQ,EACN,4EAA4E;IAC9E,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE;QAC/D,YAAY,EAAE;YACZ,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,oBAAoB;YACjC,YAAY,EAAE,IAAI;SACnB;QACD,cAAc,EAAE;YACd,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,uDAAuD;YACpE,YAAY,EAAE,IAAI;SACnB;KACF;IACD,OAAO,EAAE,IAAA,0BAAW,EAAC,OAAO,CAAC;CAC9B,CAAC","debugId":"eddc9a2a-df30-52e9-9a53-256bfdbd3541"}
+{"version":3,"file":"screenshot-image-files.command.js","sources":["../../../src/commands/agent/screenshot-image-files.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"9277f775-c52a-556c-99d0-389c4257c25c"}

package/dist/commands/project/index.js

@@ -1,16 +1,17 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="be4c1da8-74d9-5650-845c-0adc017abafe")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="55f684ba-706c-5f96-aff2-b198119381aa")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectCommand = void 0;
 const show_command_1 = require("./show.command");
+const upload_source_command_1 = require("./upload-source.command");
 exports.projectCommand = {
     command: "project",
     describe: "Project commands",
-    builder: (yargs) => yargs.command(show_command_1.showCommand).demandCommand().help(),
+    builder: (yargs) => yargs.command(show_command_1.showCommand).command(upload_source_command_1.uploadSourceCommand).demandCommand().help(),
     handler: () => {
         // subcommand handles this
     },
 };
 //# sourceMappingURL=index.js.map
-//# debugId=be4c1da8-74d9-5650-845c-0adc017abafe
+//# debugId=55f684ba-706c-5f96-aff2-b198119381aa

package/dist/commands/project/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/commands/project/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,iDAA6C;AAEhC,QAAA,cAAc,GAAkB;IAC3C,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,0BAAW,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE;IACrE,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"be4c1da8-74d9-5650-845c-0adc017abafe"}
+{"version":3,"file":"index.js","sources":["../../../src/commands/project/index.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AACA,iDAA6C;AAC7C,mEAA8D;AAEjD,QAAA,cAAc,GAAkB;IAC3C,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC,0BAAW,CAAC,CAAC,OAAO,CAAC,2CAAmB,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE;IAChF,OAAO,EAAE,GAAG,EAAE;QACZ,0BAA0B;IAC5B,CAAC;CACF,CAAC","debugId":"55f684ba-706c-5f96-aff2-b198119381aa"}

package/dist/commands/project/upload-source.command.d.ts

@@ -0,0 +1,31 @@
+import { CommandModule } from "yargs";
+interface Options {
+    apiToken?: string | null | undefined;
+    commitSha: string;
+    sourceDir: string;
+}
+/**
+ * Packages `--sourceDir` as a `source.tar.gz` archive and uploads it to
+ * Meticulous so it can be used in place of `git clone` for projects that
+ * have source-code uploads enabled.
+ *
+ * The contents of the archive are exactly the contents of `--sourceDir` —
+ * we do not parse `.gitignore` or apply any filtering, so it is the
+ * caller's responsibility to point at a directory that contains only what
+ * Meticulous needs (i.e. exclude `.git/`, `node_modules/`, `dist/`, build
+ * artefacts, secrets, etc.). The recommended pattern is to invoke this
+ * after a fresh `git checkout` into a clean directory, or after a
+ * `git archive`/`rsync --exclude` step in CI.
+ *
+ * Usage (typically from the customer's CI on every commit):
+ *
+ *   meticulous project upload-source \
+ *     --commitSha "$(git rev-parse HEAD)" \
+ *     --sourceDir ./checkout
+ *
+ * Requires a project API token (env `METICULOUS_API_TOKEN` or
+ * `--apiToken`). Calls from projects that don't have source-code uploads
+ * enabled are rejected with a 403.
+ */
+export declare const uploadSourceCommand: CommandModule<unknown, Options>;
+export {};

package/dist/commands/project/upload-source.command.js

@@ -0,0 +1,109 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="80bf9498-6e60-5fd3-8e7a-5798f20c3eed")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadSourceCommand = void 0;
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const os_1 = require("os");
+const path_1 = require("path");
+const promises_2 = require("stream/promises");
+const client_1 = require("@alwaysmeticulous/client");
+const common_1 = require("@alwaysmeticulous/common");
+const tar_1 = require("tar");
+const sentry_utils_1 = require("../../command-utils/sentry.utils");
+/**
+ * Packages `--sourceDir` as a `source.tar.gz` archive and uploads it to
+ * Meticulous so it can be used in place of `git clone` for projects that
+ * have source-code uploads enabled.
+ *
+ * The contents of the archive are exactly the contents of `--sourceDir` —
+ * we do not parse `.gitignore` or apply any filtering, so it is the
+ * caller's responsibility to point at a directory that contains only what
+ * Meticulous needs (i.e. exclude `.git/`, `node_modules/`, `dist/`, build
+ * artefacts, secrets, etc.). The recommended pattern is to invoke this
+ * after a fresh `git checkout` into a clean directory, or after a
+ * `git archive`/`rsync --exclude` step in CI.
+ *
+ * Usage (typically from the customer's CI on every commit):
+ *
+ *   meticulous project upload-source \
+ *     --commitSha "$(git rev-parse HEAD)" \
+ *     --sourceDir ./checkout
+ *
+ * Requires a project API token (env `METICULOUS_API_TOKEN` or
+ * `--apiToken`). Calls from projects that don't have source-code uploads
+ * enabled are rejected with a 403.
+ */
+exports.uploadSourceCommand = {
+    command: "upload-source",
+    describe: "Upload a source-code archive for a given commit to Meticulous",
+    builder: {
+        apiToken: {
+            string: true,
+            description: "Meticulous project API token. Defaults to METICULOUS_API_TOKEN.",
+        },
+        commitSha: {
+            string: true,
+            demandOption: true,
+            description: "Commit SHA the uploaded archive corresponds to",
+        },
+        sourceDir: {
+            string: true,
+            demandOption: true,
+            description: "Directory to package into source.tar.gz. The directory's contents " +
+                "are uploaded verbatim — exclude `.git`, `node_modules`, build " +
+                "artefacts and any other paths you don't want sent to Meticulous " +
+                "before invoking this command.",
+        },
+    },
+    handler: (0, sentry_utils_1.wrapHandler)(async ({ apiToken, commitSha, sourceDir }) => {
+        const logger = (0, common_1.initLogger)();
+        const client = (0, client_1.createClient)({ apiToken });
+        const tmpDir = await (0, promises_1.mkdtemp)((0, path_1.join)((0, os_1.tmpdir)(), "meticulous-source-"));
+        const archivePath = (0, path_1.join)(tmpDir, "source.tar.gz");
+        try {
+            logger.info(`Packaging ${sourceDir} into ${archivePath}...`);
+            // We package `sourceDir` verbatim: no `.gitignore` parsing, no
+            // filtering. The caller is responsible for pointing at a directory
+            // that contains only what Meticulous needs — see the JSDoc above.
+            // `portable` produces reproducible archives across platforms; `gzip`
+            // gives us the `.gz` wire format the cloud worker decompresses with
+            // `streamDownloadAndExtractTarGz`.
+            await (0, promises_2.pipeline)((0, tar_1.create)({
+                cwd: sourceDir,
+                gzip: true,
+                portable: true,
+            }, ["."]), (0, fs_1.createWriteStream)(archivePath));
+            const { size } = (0, fs_1.statSync)(archivePath);
+            logger.info(`Archive ready: ${(size / (1024 * 1024)).toFixed(2)} MiB. Requesting upload URL...`);
+            const { uploadUrl } = await (0, client_1.requestSourceCodeUploadUrl)({
+                client,
+                commitSha,
+                size,
+            });
+            logger.info(`Uploading source archive for commit ${commitSha}...`);
+            await (0, client_1.retryTransientUploadErrors)(() => (0, client_1.putFileToSignedUrl)({
+                filePath: archivePath,
+                signedUrl: uploadUrl,
+                size,
+                contentType: "application/gzip",
+            }), {
+                onRetry: (attempt, error) => {
+                    const reason = error instanceof client_1.UploadError
+                        ? `HTTP ${error.statusCode}`
+                        : error instanceof Error
+                            ? error.message
+                            : String(error);
+                    logger.warn(`Transient upload error on attempt ${attempt} (${reason}); will retry...`);
+                },
+            });
+            logger.info(`Successfully uploaded source archive for commit ${commitSha}.`);
+        }
+        finally {
+            await (0, promises_1.rm)(tmpDir, { recursive: true, force: true });
+        }
+    }),
+};
+//# sourceMappingURL=upload-source.command.js.map
+//# debugId=80bf9498-6e60-5fd3-8e7a-5798f20c3eed

package/dist/commands/project/upload-source.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-source.command.js","sources":["../../../src/commands/project/upload-source.command.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"80bf9498-6e60-5fd3-8e7a-5798f20c3eed"}

package/dist/utils/constants.d.ts

@@ -1 +1,2 @@
 export declare const RECORDING_SNIPPET_PATH = "v1/meticulous.js";
+export declare const BACKEND_RECORDING_SNIPPET_PATH = "backend-record-js/v1/manual-init.bundle.js";

package/dist/utils/constants.js

@@ -1,8 +1,9 @@
 "use strict";
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="07ec876f-a641-5fc6-b375-8f126b6afe4a")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="797d4326-b2e4-560d-8e44-4dc471c92cac")}catch(e){}}();
 
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECORDING_SNIPPET_PATH = void 0;
+exports.BACKEND_RECORDING_SNIPPET_PATH = exports.RECORDING_SNIPPET_PATH = void 0;
 exports.RECORDING_SNIPPET_PATH = "v1/meticulous.js";
+exports.BACKEND_RECORDING_SNIPPET_PATH = "backend-record-js/v1/manual-init.bundle.js";
 //# sourceMappingURL=constants.js.map
-//# debugId=07ec876f-a641-5fc6-b375-8f126b6afe4a
+//# debugId=797d4326-b2e4-560d-8e44-4dc471c92cac

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sources":["../../src/utils/constants.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAa,QAAA,sBAAsB,GAAG,kBAAkB,CAAC","debugId":"07ec876f-a641-5fc6-b375-8f126b6afe4a"}
+{"version":3,"file":"constants.js","sources":["../../src/utils/constants.ts"],"sourceRoot":"","names":[],"mappings":";;;;;AAAa,QAAA,sBAAsB,GAAG,kBAAkB,CAAC;AAC5C,QAAA,8BAA8B,GACzC,4CAA4C,CAAC","debugId":"797d4326-b2e4-560d-8e44-4dc471c92cac"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwaysmeticulous/cli",
-  "version": "2.278.0",
+  "version": "2.280.0",
   "description": "The Meticulous CLI",
   "license": "ISC",
   "main": "dist/index.js",
@@ -29,18 +29,18 @@
     "depcheck": "depcheck --ignore-patterns=dist"
   },
   "dependencies": {
-    "@alwaysmeticulous/api": "2.276.2",
-    "@alwaysmeticulous/client": "2.277.0",
-    "@alwaysmeticulous/common": "2.277.0",
-    "@alwaysmeticulous/debug-workspace": "2.278.0",
-    "@alwaysmeticulous/downloading-helpers": "2.277.0",
-    "@alwaysmeticulous/record": "2.277.0",
-    "@alwaysmeticulous/remote-replay-launcher": "2.277.0",
-    "@alwaysmeticulous/replay-debugger-ui": "2.277.0",
-    "@alwaysmeticulous/replay-orchestrator-launcher": "2.277.0",
-    "@alwaysmeticulous/sdk-bundles-api": "2.277.0",
-    "@alwaysmeticulous/sentry": "2.277.0",
-    "@alwaysmeticulous/tunnels-client": "2.277.0",
+    "@alwaysmeticulous/api": "2.280.0",
+    "@alwaysmeticulous/client": "2.280.0",
+    "@alwaysmeticulous/common": "2.280.0",
+    "@alwaysmeticulous/debug-workspace": "2.280.0",
+    "@alwaysmeticulous/downloading-helpers": "2.280.0",
+    "@alwaysmeticulous/record": "2.280.0",
+    "@alwaysmeticulous/remote-replay-launcher": "2.280.0",
+    "@alwaysmeticulous/replay-debugger-ui": "2.280.0",
+    "@alwaysmeticulous/replay-orchestrator-launcher": "2.280.0",
+    "@alwaysmeticulous/sdk-bundles-api": "2.280.0",
+    "@alwaysmeticulous/sentry": "2.280.0",
+    "@alwaysmeticulous/tunnels-client": "2.280.0",
     "@sentry/node": "^10.3.0",
     "chalk": "^4.1.2",
     "ci-info": "^4.0.0",
@@ -49,6 +49,7 @@
     "ora": "^5.4.1",
     "parse-diff": "^0.11.1",
     "puppeteer-core": "24.14.0",
+    "tar": "^7.5.8",
     "yargs": "^17.5.1"
   },
   "devDependencies": {
@@ -75,5 +76,5 @@
   "bugs": {
     "url": "https://github.com/alwaysmeticulous/meticulous-sdk/issues"
   },
-  "gitHead": "018a659c723bb2c0be6de995357e974d2e7b8c3a"
+  "gitHead": "87ca975a232d16ea878caa5649a8b21221ebca02"
 }